Assemble the sensor

Step 1: Solder headers to your microcontroller

Solder the short headers to the Wemos microcontroller.

Your finished board should look like this:

Step 2: Solder headers to the humidity sensors

Solder the long headers to the humidity sensor shield

Use poster putty again, it really helps!

Your finished humidity sensor shield should look like this:

Step 3: Stack the shields

Stack the shield over the Wemos and check alignment. The white dots on both the Wemos board and the humidity sensor need to be on the same side.

Check that all pins line up and everything is aligned. If everything is OK then plug it in (push it down as white arrow indicates).

Your finished Wemos shield pair should look like this:

In order to check that you put the shield in the correct orientation there is an easy way: White dots. At the Wemos board as well as at the humidity sensor shield you are going to find a white dot in one of the corners. The white dots from Wemos board and sensor shield must be in the same side (just like the picture on the right)

Step 4: Connect the cables

Connect the sensor with four M/F jumper wires as follows. The picture shows the connections of the female side to the SDS011 sensor.

Install the software

Download the latest version of the hackAIR library.

Register on the hackAIR platform (if you have not done that already).

Go to your user profile on the platform ➞ Tab “Sensors” ➞ click on “add a new sensor”.

Fill in the information for your new sensor, including location details.

Save the information that you have provided. Now you go back to your profile, go to the tab “My sensors”. Click on the arrow in the bottom right corner. This takes you to your sensor profile. Here you see the access key. Copy the access key into a document on your computer. You need it later.

Step 2: Arduino set up

Now open the Arduino software to set it up to work with your sensor.

Add the following link to Additional Boards Manager URLs:

http://arduino.esp8266.com/stable/package_esp8266com_index.json

Go to Tools ➞ Board ➞ Boards Manager…

Search for ESP8266, click on it and install esp8266 by ESP8266 Community.

2. Install libraries

Click on Sketch ➞ Include Library ➞ Manage Libraries…

We need to install the following four additional libraries:

• WiFiManager by tzapu
  
• DHT sensor library by Adafruit
  
• Adafruit unified sensor library by Adafruit
  
• ESP8266WiFi by I.Grokhotkov
  

Search for DHT sensor library. Choose DHT sensor library by Adafruit and install it.

Search for Unified sensor abstraction layer. Choose Adafruit Unified Sensor and install it.

Search for esp8266wifi built-in. Choose ESP8266WiFi by I. Grokhotkov and install it.

Go to Sketch ➞ Include library ➞ include .zip library

Find the folder in which your previously downloaded hackAIR-Arduino.zip is stored. Choose and install it.

3. Connect Wemos

Connect the Wemos sensor to your computer with the USB cable.

Select the correct board type by going to Tools ➞ Board ➞ Arduino ➞ Wemos D1 R2 & mini

Select the correct port by going to Tools ➞ Port ➞ [name of the port]

On Windows: If more than one port is shown, you can find the correct one in your computer’s Device Manager.

On Mac: you’ll first need to download USB2Serial drivers. You can find drivers in this article. Once that is done, choose something like “wchusbserial”.

4. Upload software to Wemos

Go to File ➞ Examples ➞ hackAIR ➞ Wemos Advanced

This is the window that opens – it contains the software that needs to be uploaded to your Wemos sensor

Scroll down to Line 27: #define AUTHORIZATION “AUTHORIZATION TOKEN”

Replace the words “AUTHORIZATION TOKEN” in the quotation marks with your sensor access key, but keep the quotation marks.

Now you are ready to upload the software. To do so, just click on the upload button (the arrow that points to the right).

5. Connect the sensor to the network

Now you are ready to use your sensor. Disconnect the Wemos from the computer, and reconnect it with the sensor. When you power it up, it will create a temporary WiFi network.

With your laptop or phone, connect to the WiFi network ESP-wemos. Go to 192.168.4.1 and configure the WiFi by entering the details of your home WiFi (SSID and password). Once set up correctly, the temporary network will disappear and the sensor starts measuring.