Essential Support Material For Your Connected Product
Connected products based on the Electric Imp Platform will employ Electric Imp’s BlinkUp™ technology to activate new end-user devices and possible, depending upon the type of imp embedded in your product, local network access credentialsd. The app may also be used subsequently to re-configure those devices for new networks, or if the end-user changes their network settings: for example, if they purchase a new wireless router or update their network password.
As an Electric Imp Customer, you will therefore need to provide your end-users with a mobile app which they will use to perform BlinkUp. You may choose to provide BlinkUp optically — the activation data and any network information is transmitted by flashing the mobile device’s screen — or wirelessly via Bluetooth LE (currently available to imp004m-based products only). Cellular or Ethernet-only may not require a BlinkUp-enabled app at all, if you choose to activate devices in the factory.
It is highly recommended that, in addition to your app, you also provide clear guidance to help your end-users perform BlinkUp successfully and safely, and to solve any problems they may encounter. The vast majority of issues that an end-user is likely to experience during device activation can be prevented by actively guiding the end-user through the activation process to ensure that they obtain the required network information, if any, and enter it into your app correctly; that they check their network is compatible with the imp in your product; and that align their mobile phone or tablet screen with your product’s BlinkUp photosensor correctly.
This guidance can be included in the app itself as part of the account creation and product setup flow, provided as separate instructions on your website or in the collateral included in your product package, or — ideally — all of these.
This guide will help you understand what information you should include within this material, and in what order.
Your BlinkUp documentation — whether in-app, on your website, in printed instructions, or all of these — will need to include the following:
Let's look all of these areas in more detail.
If your product is expected to connect to a WiFi network (this will be case for most products, and for all products based on the imp003 or imp004m), your end-users should be prompted to enter the following information into your mobile app:
In addition, you should inform your end-users that they must ensure their WiFi network is compatible with your connected product’s imp:
Note This section can be ignored if you are offering an Ethernet-only product.
BlinkUp transmits data by causing the mobile device’s screen to flash rapidly. Some of your end-users are susceptible to such strobing light because they are affected by medical conditions such as epilepsy. Your app and documentation must therefore make it very clear to all end-users that they should not look at the phone screen during BlinkUp. For example:
Always run BlinkUp with the screen facing away from you and towards the device being configured,
especially if you suffer from a medical condition that makes you susceptible to strobing light.
This warning should be presented before BlinkUp commences.
Some end-users may have visual or auditory disabilities; to assist such end-users through the BlinkUp process, you should incorporate visual, auditory and haptic indicators in your app to inform end-users that the BlinkUp process is about to begin and again when it has completed. This is especially helpful for end-users who may also be susceptible to flashing lights.
For example, the Electric Imp mobile app provides a three-second countdown before BlinkUp during which each second is signalled both with prominent visual cue and with an distinct audio tone. Once BlinkUp is complete, the app signals this with a further audio tone and by causing the host device to vibrate.
Other than password or SSID mismatches, and WiFi compatibility issues, physical device alignment is the cause of most other failed device activations. To avoid this, use clear diagrams and/or photographs to show the exact location of your product’s BlinkUp photosensor and to show how the end-user should position their mobile device relative to it — as close as possible, with the screen parallel to and facing the sensor window. For example:
End-users should also be encouraged to keep the mobile device is still as possible, and they should be instructed to avoid very bright ambient light (eg. outdoors) and flashing ambient light.
Note The BlinkUp status LED will be turned off by the product’s imp when it detects a BlinkUp signal. It can therefore be useful to position the status LED window where it will not be covered by the mobile device during BlinkUp. This allows the end-user to verify that the imp-enabled device has recognized that BlinkUp is taking place. If the product then fails to connect, you can be sure the problem relates to networking (password/SSID mismatch, or WiFi compatibility). Positioning the LED this way is also handy when you are tuning your product’s BlinkUp circuit and its housing.
Your product’s BlinkUp status LED will shows end-users the progress of the device’s attempt to connect and activate, and your app should show them what to expect: a series of red and orange flashes followed by slow green pulses. This can be presented in various ways, including animation, video or static images. For example:
In addition, it can be useful to warn users that after activation, the device may download an impOS update if one is available. This will cause the LED to go solid green (no flashing) while the update is downloaded and installed. This is normal behavior and no cause for concern, and the device will reconnect, ie. show the slow green flash, after installation is complete.
If the LED remains flashing orange, then your product was not configured — the end-user should attempt BlinkUp again, this time making sure they position the phone correctly under sensible lighting conditions.
If the LED remains flashing red, then your product is unable to connect in order to activate — the end-user should attempt BlinkUp again, this time making sure they have entered the network name and password correctly, and that the network is compatible with the product’s imp.