{"docs":[{"id":187,"title":"Designing Consumer IoT Devices for a Smooth Out-of-Box Experience","heading":"Designing Consumer IoT Devices for a Smooth Out-of-Box Experience","subheading":null,"category":"IoT","body":{"root":{"type":"root","children":[{"type":"heading","tag":"h3","version":1,"children":[{"type":"text","text":"SoftAP or Bluetooth","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"There are two common ways to pass Wi-Fi credentials to a new device. With SoftAP, the device runs a temporary access point and the phone joins it, which works on any phone but briefly cuts it off from the internet. With Bluetooth LE, the phone stays on its normal network and the device can report progress as it joins.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Bluetooth needs a radio on the device, but many Wi-Fi chips include one, and Matter commonly uses Bluetooth LE to commission Wi-Fi and Thread devices. Either way, the device should report exactly why a join failed, such as wrong password or network not found.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"tags":"IoT, Consumer Products, User Experience","cardCta":{"label":null,"link":null},"pageCta":{"label":"Talk to AAVICO engineering","link":"/contact"},"excerpt":"Setup is the first thing every customer does with a connected product. Much of how it goes is decided by the hardware and firmware, not the app.","featuredImage":null,"type":"Blog","readTime":"3 min read","publishedAt":"2026-11-15T15:18:00.000Z","heroImage":null,"introText":"A consumer connected device has to go from sealed box to working on an unfamiliar home network, operated by someone who has not read the manual. The companion app gets most of the design attention, but many setup outcomes are fixed by the device: how it shows its state, how it enters setup mode, how it receives network credentials and how it recovers from mistakes. This article covers those device-side decisions.","metrics":[{"id":"designing-consumer-iot-devices-for-a-smooth-out-metric-1","value":"One button","label":"A single, clearly defined action to enter setup or reset removes guesswork.","icon":null},{"id":"designing-consumer-iot-devices-for-a-smooth-out-metric-2","value":"2.4 GHz","label":"Many IoT Wi-Fi chips support only this band, which setup must account for.","icon":null},{"id":"designing-consumer-iot-devices-for-a-smooth-out-metric-3","value":"QR code","label":"A code on the device or box can carry identity and a setup secret, removing manual entry.","icon":null},{"id":"designing-consumer-iot-devices-for-a-smooth-out-metric-4","value":"Recovery","label":"A reliable factory reset turns a failed setup into a retry rather than a return.","icon":null}],"gallery":[],"challenge":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"Setup fails in predictable ways: the device was not in setup mode, the Wi-Fi password was mistyped, the network offers no band the device supports or needs a login page, or the phone lost internet while joined to the device. Each produces a stalled spinner unless device and app were designed to report it.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Status indication is the other weak point. A single LED with blink patterns only the manual explains leaves users unable to tell whether the device is starting, waiting, connecting or broken.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"blockquote":{"quote":"Design setup around the ways it fails. A user who knows what went wrong can usually fix it.","author":"","role":"AAVICO Engineering"},"supportImage1":null,"deliverables":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"List every way setup can fail on real home networks and decide how the device detects and reports each one.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Define device states and their indications: starting, ready for setup, connecting, connected, error and resetting. Keep them few and distinct.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Test with untrained users on a range of routers and phones, starting from a sealed box.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"results":[{"id":"designing-consumer-iot-devices-for-a-smooth-out-result-1","title":"Fewer Returns","description":"Users who can see what went wrong retry instead of giving up."},{"id":"designing-consumer-iot-devices-for-a-smooth-out-result-2","title":"Lower Support Load","description":"Specific error reports replace calls that start with a blinking light."},{"id":"designing-consumer-iot-devices-for-a-smooth-out-result-3","title":"Better Reviews","description":"The first experience of the product is the one customers write about."},{"id":"designing-consumer-iot-devices-for-a-smooth-out-result-4","title":"Faster Setup","description":"Scanning a code replaces typing serial numbers and setup keys."}],"lookingAhead":{"root":{"type":"root","children":[{"type":"paragraph","version":1,"children":[{"type":"text","text":"Ship firmware that works at first connection, and run any immediate update after setup completes rather than before.","version":1}]},{"type":"paragraph","version":1,"children":[{"type":"text","text":"Put the setup code where it stays readable after installation, or let users recover it; devices often need setting up again.","version":1}]}],"direction":"ltr","format":"","indent":0,"version":1}},"supportImage2":null,"testimonial":{"quote":null,"author":null,"role":null,"photo":null},"challengesSolved":[{"id":"designing-consumer-iot-devices-for-a-smooth-out-challenge-1","title":"Blink codes nobody can interpret","description":null,"icon":null},{"id":"designing-consumer-iot-devices-for-a-smooth-out-challenge-2","title":"Setup that stalls with no explanation","description":null,"icon":null},{"id":"designing-consumer-iot-devices-for-a-smooth-out-challenge-3","title":"Wi-Fi networks the device cannot join","description":null,"icon":null},{"id":"designing-consumer-iot-devices-for-a-smooth-out-challenge-4","title":"No reset short of a support call","description":null,"icon":null}],"relatedPosts":[],"contactUs":{"show":true},"updatedAt":"2026-11-15T17:32:32.682Z","createdAt":"2026-11-15T17:32:32.682Z"}],"hasNextPage":false,"hasPrevPage":false,"limit":10,"nextPage":null,"page":1,"pagingCounter":1,"prevPage":null,"totalDocs":1,"totalPages":1}