So you got yourself one of our new air quality monitoring kits and you are ready to do your part as a citizen scientist by contributing your data to the cloud. This guide will help you get your new kit online and connected to our cloud service to join all the other devices around the world. We tried to make this process easy so let’s get started!
What’s in the box:
Other things you will need:
Sign up at https://maker.allthingstalk.com/signup with your email address and a chosen username and password.
Note: The AllThingsTalk Cloud organizes members and devices into “Grounds”, a better way to manage things and data access. AllThingsTalk Cloud automatically creates a first Ground, called “Playground” after signing up.
To connect your Kit in your “Playground”, select the Ground and click “Connect a device”.
Select the Air Quality IoT Starter Kit to continue the device creation, a software defined representative of your physical Air Quality device will be created when this is done.
Connect the Grove sensors with the Wio Link board as indicated on the indicated the image below:
The next step is to install the hardware profile for the Wio Link board. The Wio Link board profile is available through the Arduino Boards Manager.
In the Arduino IDE, Go to File > Preferences for Windows and Arduino > Preferences on MacOS and add the following URL to Additional Board Manager URLs:
Open the Board Manager via Tools > Board > Board Manager. You can then search for and install the Wio Link board. Select and install the esp8266 by the ESP8266 Community.
The Arduino IDE will now have the Wio Link board added to the list found in the menu under Tools >Board: “Seeed Wio Link”. You simply need to select that hardware profile as the board that the Arduino IDE will use.
If your system does not automatically find the correct driver then it is advisable to download additional drivers from here.
The driver adds a communication port. In Windows this is COMx (so COM1, COM6, etc.). On Linux and Mac the port name starts with /dev/tty. You can find the list of available serial ports in the menu under Tools->Port:
You must select the communication port associated with the Wio Link board. The associated communication port is only visible in that list when the Wio Link board is connected.
Download the OKdo_AQ_IoT_starter_Kit-master.zip file.
To install, open your Arduino IDE
Under Sketch > Include library > Add .ZIP library and select the previously downloaded .zip file
Alternatively, you can unzip the file and copy the contents directly to the libraries folder of your Arduino IDE.
By default this can be found in
Now you can open the example code we created to help you out. In your Arduino IDE, open the example “OKdo_Air_Quality_IoT_Starter_Kit_V1″ under “File > okdo-aq-iot-starter-kit-master > examples > OKdo_Air_Quality_IoT_Starter_Kit_V1”
Select the tab ‘keys.h’.
In the AllThingsTalk Cloud application and your Playground, open the previously created device. You will now see the asset overview.
Click the Settings button in the top right section of the device screen and update the DEVICEID and DEVICE_TOKEN values in your keys.h tab with the values that can be found in Device Settings > Authentication section.
/**** * Enter your AllThingsTalk device credentials below */ #ifndef KEYS_h #define KEYS_h const char* DEVICE_ID = "LA1Sn4yuYx16YBAABqQQnSan"; const char* DEVICE_TOKEN = "maker:4VyRL0fr22kOm01qFyHqw3gE91MahfK1Q3zEfRg0"; const char* WIFI_SSID= "myWiFi"; const char* WIFI_PASSWORD = "MyWiFiPassword"; #endif
While you are here, go ahead and put your WiFi credentials (WIFI_SSID & WIFI_PASSWORD) so you can get your device online when you disconnect it from your computer.
If you’ve followed all the steps above, then uploading your code should be easy. Simply hit the upload icon in the Arduino IDE. This will save the sketch, compile it and upload it to your Arduino.
Now your device will start sending the sensor data to the AllThingsTalk Cloud every minute which can be visualized when you sign up and sign into the AllThingsTalk Cloud.
If you want to check to make sure everything is working locally, you can also open the Tools > Serial monitor of the Arduino IDE. This can be very useful when debugging your own sketches too.
If all goes well you should see sensor data of your device coming in. You can now share this data with the Air Quality Community.
In the AllThingsTalk Cloud select your newly configured device.
Set now your Location by clicking the location asset, and click “Use my location”. You can always fine-tune your location by clicking on the map.
Afterwards open the Settings dialog and select ‘Share Data’. Now activate the toggle to share with the Air Quality community.
Welcome to the Community! Now you can see other team members data also as we all work together to help monitor our planet.