Version 2 Setup
Setup has been considerably simplified.
To tell the Egg about your Wi-Fi network and password, you will need a desktop or laptop computer.
Connect your Egg to a Serial Port:
- Plug your Egg into your computer using the provided USB cable.
- Go to http://airqualityegg.com and scroll down to the bottom, “Configure your egg”.
- Under “Port” choose the port, or it will appear automatically. For speed choose 115200. Click Connect.
- You should see a bunch of information appear in the serial port monitor.
Add Wi-Fi settings:
- Enter the three letters
aqe <Enter>
to enter configuration mode. (See picture above)
You have 12 seconds from opening the serial port to enter configuration mode. If you do not respond in that time, the egg will enter operational mode. To restart the countdown, simply close and reopen the serial console. - Typessid <Your network name> <Enter>
pwd <Your network password> <Enter> - Type “Exit” and press enter. Watch your egg connect.
That’s it. Close the applications, unplug your egg and plug it into the supplied wall power supply.
Version 1 Setup
When you first open your Air Quality Egg box, you have to go through a few simple steps before your system gets up and running. If something goes wrong along the way, please send your Egg Serial Number to support AT wickeddevice DOT com and consider posting a question to our forum (if there’s not already a similar one there). Just follow along with these instructions and you should be up and running in no time. This fancy color-coded flow chart can also be handy if something goes wrong along the way.
- Go to http://airqualityegg.com and type in your the unique identifier for your Egg. You can find it stuck to the inside of the lid of the box the system was delivered in. Type it in as printed including colons and using all lowercase letters. It should look something like 00:04:a3:12:be:01.
- Click on the Add My Egg button, and fill out the “biographical data” about your Egg and click Save. At this point you have told Xively.com about your Egg, and they are ready to hook your egg up to the network. If you get Egg Not Found, please email us your serial number at support AT wickeddevice DOT com and we will make sure it has been registered on our end, which should help keep you moving forward. Sorry for the inconvenience!
- Plug your Base Egg’s Ethernet cable into your router or switch so that it is connected physically to your network (just like any other computer in your household / building).
- Plug your Base Egg into a power outlet. It should initially glow yellow and then once it registers itself with Xively, it should illuminate a solid green for about 10 seconds. It will then reset itself and start glowing yellow again. At this point Xively knows your Egg is connected to the internet and they are ready to start receiving data from your Egg to its own feed. If you don’t get the Green light, you may have been affected by this bug. You may also not get the solid Green state because we provision Eggs during testing “at the factory,” in which case the Egg will blink green three times rather than displaying a solid green state.
- Now it’s time to let your pair up your Eggs. With your Eggs in the same room (i.e. not too far apart), first plug in your Base Egg (unplug it and plug it back in if it was already plugged in). While it is glowing yellow (this lasts about 15 seconds), plug in your Remote Egg. After the glowing yellow period, the Base Egg will flash Blue three times to indicate pairing was successful, or magenta three times to indicate no pairing occurred. At this point your Remote Egg and your Base Egg have paired. Within 2 minutes, your Base Egg should glow through a pattern of colors changing every 5 seconds. This cycle will happen once a minute as your Base Egg receives sensor data from your Remote Egg and publishes it to Xively.com. If you don’t see any glowing colors after two minutes, try this step again as your Eggs did not pair successfully.
- Now that your Eggs and Cosm.com have all been acquainted with one another you can go ahead and install your Remote Egg in its intended location. It’s best to hang it from a string so that Remote Egg has good consistent airflow through the bottom of the enclosure. The next best option is to lay the Remote Egg flat on its side.
- Make sure your Base Egg glows through a cycle of colors about once every minute. If it doesn’t it’s most likely that your Eggs are out of range of each other or there is too much obstruction between them (e.g. concrete walls or large metal objects). Also make sure everything is powered on.
- You should be able to find your Egg on the map at http://airqualityegg.com and it will take you to a URL like http://airqualityegg.com/egg/86738, that shows a dashboard about your specific Egg. If you want to get to the “raw” data or do your own processing on the data, you can get to the corresponding feed by replacing the “http://airqualityegg.com/egg” part of the URL with “http://xively.com/feeds”. So in the case of the example, you would go to: http://xively.com/feeds/86738. There’s also a neat Excel spreadsheet you can use to extract data from Cosm.
Eventually there will be a way for you to “claim” your Egg so as to bind it to your Cosm account, but that has not yet been implemented. Stay tuned.
That’s all there is too it! Your Eggs should keep publishing data to Xively about once a minute so long as they remain powered on. They should also recover gracefully (without intervention) through power cycles.
Please do not post comments here. Post questions and comments on the forum.