Directions / instructions for assembling and installing your sensor. Quite simple.

Are you ready? Let’s start!

Shopping List (only if you have decided to buy the parts yourself)
– NodeMCU ESP8266, CPU/WLAN microcontroller
– SDS011 dust sensor (formerly PPD42NS)
– BME 280, temperature, humidity and atmospheric pressure sensor
– cables, wires
– USB to Micro USB cable, flat, 3 meters long
– 2A AC Adapter, USB
– Cable ties
– Transparent hose, 6 mm in diameter and 20 cm long
– Waterproof HT Filter Discharge Pipe (DN 75 87⁰ ) – 2 pieces
How do we assemble the station?
You can easily assemble your measuring station. There are 8 cables and 2 small cable ties. That is all!
YOUR SENSOR IS READY TO WORK!

Install the Firmware

Here is the time when we load NodeMCU’s firmware

Introductory notes

Relax, you do not have to program anything!

We’ve programmed your firmware for you. Just copy it to NodeMCU (ESP8288) and install it. Mission possible even for beginners!

Anyone who needs help simply visit our adopters’ meetings.

Installing USB2Serial Drivers

To connect to ESP8266, you need USB2Serial drivers. The chipset of NodeMCU is usually CH341 (the manufacturer’s driver page is in Chinese).

Linux: does not require installation, the chip must be maintained directly (with dmesg check)
MacOS: for Sierrra, see this successfully tested instruction: https://github.com/adrianmihalko/ch340g-ch34g-ch34x-mac-os-x-driver
Windows: TBA (Works with the manufacturer’s drivers, see the link above)
Raspberry Pi: Try https://github.com/aperepel/raspberrypi-ch340-driver

Load the Firmware

How to copy? If you do not dare, please check the FAQ (frequently asked questions). There is a video that will guide you.

Warning! To avoid data loss when copying NodeMCU, use a USB cable no longer than one meter!

Installing Arduino software on your computer, uploading the NodeMCU firmware

Download & install Arduino: https://www.arduino.cc/en/Main/Software
In Arduino, menu „File -> Preferences ->Setting, find Additional Board Manager URLs“ field and paste this URL: http://arduino.esp8266.com/stable/package_esp8266com_index.json
Then, find in the menu „Tools -> Board-> Boardmanager“, find „esp8266“ and install „esp8266 by ESP8266 Community“
Download the firmware on your computer http://www.madavi.de/sensor/update/data/latest_bg.bin

Windows

In Windows, open Command Line (cmd) or PowerShell
Windows:
%USERPROFILE%\AppData\Local\Arduino15\packages\esp8266\tools\esptool\0.4.9\esptool.exe -vv -cd nodemcu -cb 57600 -ca 0x00000 -cp COM11 -cf
Specify the path to the downloaded Firmware folder
(the Port after ‚-cp‘ should fit)
You will learn which the right Port is by connecting NodeMCU to your computer and launching Arduino IDE. Under Tools -> Port “” Available Ports are visible, it is usually very simple to connect the Port with NodeMCU. Then close the IDE again, otherwise this port will be blocked.

Mac / Linux

Open Terminal in Linux/ Mac and add
Linux:
~/.arduino15/packages/esp8266/tools/esptool/0.4.9/esptool -vv -cd nodemcu -cb 57600 -ca 0x00000 -cp /dev/cu.wchusbserial1410 -cf
Specify the path to the downloaded Firmware folder
(the Port after ‚-cp‘ should fit)
MacOS:
Open the Terminal application (Finder>go>Utilities), paste the command
~/Library/Arduino15/packages/esp8266/tools/esptool/0.4.9/esptool -vv -cd nodemcu -cb 57600 -ca 0x00000 -cp /dev/cu.wchusbserial1410 -cf ~/Downloads/latest_bg.bin
-Specify the path to the downloaded Firmware folder
(the Port after ‚-cp‘ should fit)
If problems occur, you should try to run the command as root. This has to be replaced in the path, ~/‘ from its own directory.
You will learn which the right Port is by connecting NodeMCU to your computer and launching Arduino IDE. Under Tools -> Port “” Available Ports are visible, it is usually very simple to connect the Port with NodeMCU. Then close the IDE again, otherwise this port will be blocked.
There is a script for Linux at sensors-software/utils/flash/, which can delete the existing configuration:
https://github.com/opendata-stuttgart/sensors-software/tree/master/utils/flash

Relax, you do not have to program anything!

Just copy the firmware and everything will be done.

Installation of electronics

We now carefully assemble the controller and the sensors

IMPORTANT MESSAGE

Before installing, upload the NodeMCU firmware!
Back to the LOAD FIRMWARE menu

On delivery, the uploaded original firmware delivers a 5V voltage directly to the pin, causing damage to the SDS011 sensor.

Assembly

Advice: This guide is based on version 3 of NodeMCU.

Connecting SDS011 (dust sensor)

The Pins are numbered from RIGHT to LEFT,
When connecting them, be careful that the cable ends are pinched tightly on the pins, because Dupont cables can often pinch “next to” the Pins
SDS011 Pin 1 -> Pin D1 / GPIO5
SDS011 Pin 2 -> Pin D2 / GPIO4
SDS011 Pin 3 -> GND
SDS011 Pin 4 -> is not used
SDS011 Pin 5 -> VU (NodeMCU v3) / VIN (NodeMCU v2)
SDS011 Pin 6 -> is not used
SDS011 Pin 7 -> is not used

Connecting BME280 (temperature, humidity and atmospheric pressure sensor)

The pins are numbered from LEFT to RIGHT
VCC (Pin1) <-> 3V3
GND (Pin2) <-> G
SCL (Pin3) <-> D4
SDA (Pin4) <-> D3

Electronic scheme

The SDS011 particulate sensor and the BME280 temperature, humidity and atmospheric pressure sensor are connected to the chips (NodeMCU) according to the diagram on the right.

Final assembly of the station

The components are assembled in the measuring station

Bildschirmfoto-2016-11-25-um-17.30.55-495x400

Bildschirmfoto-2016-11-25-um-17.33.35-495x400

Connection

Connect the transparent tube to the SDS011 dust sensor
With a pig tail, connect to the SDS011 dust sensor to the controller so that they fit together in the tube.
Install so that the SDS011 dust sensor board is inverted with the blower down.
Carefully push the BME280 sensor and slide it all into the tube on the side without a rubber seal.
Connect the pipe with the rubber seal to the one with the components and remove the USB cable from the other side.

Sensor configuration

The station connects to your wireless network (WiFi)

Particle sensor configuration

Connect the charger to the network to start the station;
After a few seconds, will open its own WiFi hotspot named Feinstaubsensor-NUMBER, the digits being the CHIPID ID number (it is very likely that this number is written on the bag with the NODEMCU controller). The station will broadcast a WiFi signal about a minute.
Open your phone / laptop / tablet settings and connect to this network. It does not have a password (we know from experience that it may not be the first time – some devices do not like networks without a password).
Make sure you’re connected to this network and open a new page in your browser and type: http://192.168.4.1
You will see the following screen:

At the top you will also see your home / office network.
1.Click on it and in the password field carefully type the password of your WiFi network and 2. Press the Save button. (Do not change other settings unless you explicitly know what you are doing).

Take a screenshot. After 15 seconds, unplug the power from the outlet and then turn it back on again after 15 seconds.
As expected, you’ll soon lose connection to the station’s WiFi network. Transfer to the one you selected the station to connect to. (If you know more about networks, scan your network and if everything goes according to the instructions you will find the station).

A FEW EXTRAS FOR THE IMPATIENT:

Did you take a picture of the station settings like we asked you? There should be the ID of your sensor. This NUMBER will be needed for the two links below, where you will be able to see at any moment the station’s current readings, as well as all its testimonies. Instead of NUMBER, type the ID.

Graphics of the Atmospheric Sensor:
https://www.madavi.de/sensor/graph.php?sensor=esp8266-NUMBER-bme280
Graphics of the fine particle sensor:
https://www.madavi.de/sensor/graph.php?sensor=esp8266-NUMBER-sds011
If the open pages say, in German, that there is no such sensor, it means that the station is not receiving an internet connection from your network and did not make the initial registration. Go back to the beginning of this section and repeat the steps.
If there is a large red line on the open pages and it says the sensor is not registered, it means the station is working and you should register it (see below).
If you have registered the station with us but the red line is still visible and you do not see your sensor it on the map, it means that the station is in the process of registering in the global database – this can take 2 to 4 business days. Thank you for your patience.

Last Steps - Registration

To make the sensor a part of the global measurement network, we will need a few more details. Please fill in all cells of the final registration form. The address of the station in order to register it will be received with the station itself.

Any more questions?

See more in our Frequently Asked Questions section.

Directions / instructions for assembling and installing your sensor. Quite simple.

Are you ready? Let’s start!

Install the Firmware

Installing Arduino software on your computer, uploading the NodeMCU firmware

Relax, you do not have to program anything!

Just copy the firmware and everything will be done.

Installation of electronics

Connecting SDS011 (dust sensor)

Connecting BME280 (temperature, humidity and atmospheric pressure sensor)

Electronic scheme

Final assembly of the station

Sensor configuration

You are almost ready! You will soon be able to measure particulate matter.

Map (particulate matter)

Air Bulgaria

Карта на сайта