OKdo Air Quality IoT Starter Kit

This article explains how you can connect your OKdo Air Quality IoT Starter Kit to the OKdo Cloud, and collect, visualise and share your data.

You can buy the OKdo Air Quality IoT Starter Kit here.

Watch the video tutorials:

1. Connecting the Hardware

2. Connecting to the cloud

What will you need

  • An OKdo Cloud account
  • A Wio Link
  • Grove Temperature & Humidity sensor (DHT22)
  • Grove - VOC and eCO2 Gas Sensor (SGP30)
  • Your WiFi access credentials
  • Arduino IDE installed
  • Wio Link board support in your Arduino IDE. Please follow this guide to get started

Install the libraries

  • 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 Mydocuments/Arduino/Libraries/ for Windows, or Documents/Arduino/Libraries/ for MacOS

Collecting air quality data

Connect hardware

  • Connect the Grove sensors with the Wio Link board as indicated on the image below:
    • Connect the Grove Temperature & Humidity sensor (DHT22) with ‘Digital2’ on the Wio Link board.
    • Connect the Grove - VOC and eCO2 Gas Sensor (SGP30) with ‘I2C’ on the Wio Link board.
  • Connect the Wio Link board to your computer over USB

Air Quality Schema for Wio Link board

Setup your device

  • Open your Arduino IDE:
    • Go to Tools > Board and select the Seeed Wio Link board
    • Under Tools > Port select the USB port to which your device is connected
  • In your Arduino IDE, open the example ‘OKdo_Air_Quality_IoT_Starter_Kit_V1’ under _File > examples > OKdo_AQ_IoT_Starter_Kit_.

Authenticate your device

  • Select the tab keys.h
  • In the OKdo 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_TOKENvalues in your keys.h tab with the values that can be found in Device Settings > Authentication section.
  • Update your WiFi settings (WIFI_SSID and WIFI_PASSWORD)

OKdo device authentication

/*
* Enter your AllThingsTalk device credentials below
*/
#ifndef KEYS_h
#define KEYS_h
const char* DEVICE_ID = "5BroM9c13gfgjijfFHkWyr8B";
const char* DEVICE_TOKEN = "maker:4G8leAuDguYIW1VeVxnpDx9BZXwuSSNb7NaAOyS";

const char* WIFI_SSID= "myWiFi";
const char* WIFI_PASSWORD = "MyWiFiPassword";

#endif

Run the example

Simply hit the upload icon in the Arduino IDE. This will save the sketch, compile it and upload it to your Wio Link board.

Run example sketch

Now your device should increase the value of the device sensors and send each minute its state to AllThingsTalk. This will be represented by the corresponding Device Assets in the OKdo Cloud application.

Alternatively, you can also open the Tools > Serial monitor of the Arduino IDE. This can be very useful when debugging your own sketches.
Make sure you select the correct COM port to listen (under Tools > Port )
When the monitor is open, make sure the Baud rate is set to 115200bps

Sharing your Air Quality Data with the global community

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 OKdo 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.

Share data to the community

Welcome to the community

Select Air Quality community from the grounds menu to discover the community. Now go to Pinboards, and select Map to see all the devices being shared, and further discover the power of the community.