hackAIR home v1: WiFi shield quick start guide

This guide is for users that own an assembled and programmed WiFi shield and are ready to connect their node to the Internet.

Step 1: Download the Arduino IDE and the hackAir library

The Arduino IDE is required to write and upload sketches to your Arduino board. The web editor is currently missing the hackAir library so for the moment it’s not supported.

The hackAir Arduino Library contains the support code for the various air quality sensors and internet connectivity using either the Ethernet Shield or the official WiFi shield. The latest release can be downloaded from here and installed accoarding to the instructions at Installation.

Step 2: Stack the shield on top of your Arduino and connect your sensors

The WiFi shield should be stacked on top of the Arduino board while making sure all pins are inserted without bending out of the way. The shield shouldn’t touch any of the Arduino’s components to avoid shorting.

Each sensor has a page in the Sensor Support section with details on how to connect it to the shield.

Step 3: Upload the WiFiSensor sketch

The WiFiSensor example is a prepared sketch to collect data from the sensors and send the average every 1 minute to the hackAir servers. Before uploading the correct sensor should be specified in line 13 and the authentication token in line 29.

Step 4: Connect to the hackAir node using a mobile device to setup WiFi

Using a mobile device, connect to the SetupGadget-XXXXXX Access Point (XXXXXX being the unique ID of the WiFi shield) and navigate to to set your SSID and password.


At this point the hackAir node should be ready to collect and transmit data.