Instructions For Activating imp Development Kit
This guide is intended to help you quickly get any item of imp-based development hardware online and running code. It refers to all such imp-enabled development products as ‘imp kits’.
Look out for the symbol — click it to drill down into more detailed information about the current topic.
We have a number of product-specific Getting Started Guides too. You can find them listed here.
When you have your imp kit, you are ready to begin.
Some imp kits ship with a separate imp module or card. Fit the card into its slot, or the module into its connector, now. imp kits with cellular imps will also require the connection of the supplied antenna.
If you already have an Electric Imp account, skip to Stage 3.
An Electric Imp account gives you access to impCentral™ , which you will use to program your imp kit. New and updated application code is deployed from impCentral to imps via the Internet.
In order to program your imp kit, you need to add it to your account. This process is called activation and is accomplished using Electric Imp’s BlinkUp™ technology .
Always run a BlinkUp with the mobile’s screen facing away from you and towards the imp kit being configured, especially if you suffer from a medical condition that makes you susceptible to strobing light. In the iOS app there are audio prompts both at the start and end, so you can close your eyes during the process. The Android app vibrates the handset after BlinkUp is done.
The imp kit will signal a successful BlinkUp by keeping the status LED lit green for three seconds. After that, various color combinations may be seen as the kit connects to the network and activates, culminating in a steady green blinking:
If your imp kit has connected, proceed to Stage 4.
If the LED doesn’t eventually blink green, the device has not been able to connect — you should check out Getting BlinkUp Right before proceeding.
If your imp kit connects to the server (green flash) but then flashes orange only, you’re experiencing an impCloud clash — see impCloud Selection Issues for assistance.
If the imp kit’s LED stays lit green for some time (no flashing), it is receiving an impOS™ update. This is normal; just wait a moment it will reconnect and you will be ready for the next stage.
Connected or not, after a short time the impC001 Breakout Board’s LED will turn off to save power. This is normal, and the device is still running.
Your imp kit is online and activated.
Connected Productas the Product’s name,
Hello Worldas the Device Group’s name, and then click Create. impCentral will now present its code editor:
server.log("Hello from your imp development device");
[Device] Hello from your imp development device
Your imp kit is ready for use and you have run your first (short) program. Here are the next steps you should take:
impCentral is Electric Imp’s online development environment. It is used to create imp applications and the agent and device code they are constructed from. impCentral allows developers to switch development and factory devices to different device groups for development and testing, and to log information posted by those devices while they are running.
impCentral also provides access to production functionality for those users with a commercial relationship with Electric Imp, including production management, and factory code development and testing.
BlinkUp uses a mobile device’s display to transmit activation data to the imp kit. You use the Electric Imp app to activate development devices. BlinkUp is also used to activate commercial devices based on the Electric Imp platform, but using their own mobile apps. By default, commercial products can’t be used for development.
This video shows BlinkUp in action:
If the impC001 Breakout Board still shows a slow flashing orange LED after BlinkUp, it wasn’t able to read the BlinkUp transmission — perhaps you held it too far from the phone’s screen. BlinkUp can also be adversely affected by unusual lighting conditions, especially very bright lighting such as direct sunlight. For best results, we recommend that you:
The pattern of colors and flashes presented by the status LED will tell you where any problem is occurring. Our troubleshooting guide can help you further.
All imps use 2.4GHz 802.11n WiFi. The imp005 can also connect 802.11n networks in the 5GHz band. The Electric Imp app defaults to the WiFi network your mobile device is connected to. This may not be a network that is compatible with your imp kit, but you can change the target network in the app by tapping the Network Name field.
If your imp kit was purchased in the US, it will only be able to connect to certain WiFi channels, eg. 2.4GHz channels 1-11, for regulatory reasons. Make sure your wireless router or access point is operating on a compatible channel. This is especially important if it chooses channels automatically.
All imps are able to detect what kind of security — WEP, WPA or WPA2 — a WiFi network uses, so just enter the correct password. However, the imp doesn’t support enterprise-level authentication (802.11x), which requires that you log in with a username as well as the customary SSID and password, or networks which require login via a web page. If you’re connecting to an unsecured network, leave the Password field blank.
Hint You can save your network settings in the Electric Imp app for future use. To retrieve them, tap the triangle in the Network Name field: you’ll be presented with a list of stored networks — just tap the one you want to use.
impOS is the device-side operating system which manages the imp kit’s Internet connectivity and mediates communication between the virtual machine-hosted Squirrel application code and external peripherals connected via GPIO and/or standard buses.
Electric Imp issues new versions of impOS on a regular basis. impOS updates typically add new features that developers can make use of in their applications, but they also incorporate fixes and, when required, important security updates. impOS updates are designed to be implemented transparently: a device’s owner needs do nothing to keep the unit up to date — it happens automatically, and usually takes just a few seconds.
impOS uses a smart upgrade process that won’t ‘brick’ the unit if the update fails. An imp will continue to run and simply re-download the update next time it’s power-cycled. When the update has been installed, the device will restart.