airRohr Sensor Firmware for SPS30, SDS011, DHT22, BMP180, BMP/E 280, NEO-6M and many more

Features:

many environmental and air quality sensors can be used concurrently
Integration in Sensor.Community (formerly Luftdaten.Info)
Configuration via HTTP in local WiFi or with a Sensor-as Access-Point
Support for OLED- and LCD-Displays (SSD1306, SH1106 and LCD1602, LCD2004)
Wide selection of API integrations for measurement reporting
Ability to print measurements as CSV via USB-serial
Used with ESP8266 (NodeMCU v2/v3 and compatible) and ESP32 (experimental)

Contributing

Please refer to Contributing README for details.

WiFi configuration

For German Version see: Konfiguration der Sensoren

If a (previously) configured WiFi is not reachable within 20 seconds after power-on, the firmware flips itself into AP mode and creates a WiFi network in the form airRohr-\[Sensor-ID\].

This WiFi network is by default unencrypted. When a client connects to this, it will get redirected to the sensors web server http://192.168.4.1/ which allows initial configuration.

Configurable is

WiFi Access Point to use
Options for measurements (Sensors to poll, intervals..)
APIs to send the measurements

The unencrypted Access Point for initial configuration will turn itself off after about 10 minutes. In order to reactivate please power cycle the board.

DHT22 Humidity Reporting

The DHT22 sensor is originally an Indoor sensor. For outdoor use it appears to be rather sensitive to water condensation after 100% rel.Humidity that keep it for very long time (sometimes forever) at 99.9% value. Also it appears to be sensitive to high UV light, which tends to cause the sensor to crash until hard power-loss restarted.

Better experiences have been made with a BME280 or SHT3x sensor, so consider those instead.

Debug via USB-Serial

Connecting/Powering via a computer USB will provide USB serial with the settings 9600 baud 8N1. By default the sensor will provide human readable debug information of configurable granularity there.

Save as CSV

All measurements can also be read as CSV via USB-Serial when using the USB port in the settings 9600 Baud 8N1. In order to avoid interfering of debug options (see earlier section) set debug to None in the configuration.

Wiring

Please refer to the Pinout of NodeMCU v2 and v3 for much more detailed information about the individual pin functions.

SDS011 (serial)

Note: Serial connections are always crossed (RX on one side is connected with TX on other side)

Pin 1 (TX) -> (RX) Pin D1 (GPIO5)
Pin 2 (RX) -> (TX) Pin D2 (GPIO4)
Pin 3 (GND) -> GND
Pin 4 (2.5m) -> unused
Pin 5 (5V) -> VU
Pin 6 (1m) -> unused

DHT22

Pin 1 => 3V3
Pin 2 => Pin D7 (GPIO13)
Pin 3 => unused
Pin 4 => GND

DS18B20 (OneWire interface)

Please check your version (pinout) at [https://datasheets.maximintegrated.com/en/ds/DS18B20.pdf] Uses the same PIN D7 as DHT22, so DHT22 OR DS18B20 can be used.

GND -> Pin GND
DQ -> Pin D7 (GPIO 13)
VCC -> Pin 3V3 or Pin VU

PMS1003 to PMS6003

Pinout: 8 7 6 5 4 3 2 1

Pin 1 (VCC) -> VU
Pin 2 (GND) -> GND
Pin 3 (SET) -> unused
Pin 4 (RX) -> Pin D2 (GPIO4)
Pin 5 (TX) -> Pin D1 (GPIO5)
Pin 6 (RESET) -> unused
Pin 7 (NC) -> unused
Pin 8 (NC) -> unused

PMS7003

Pinout PMS7003: 9 7 5 3 1 10 8 6 4 2

Pin 1/2 (VCC) -> VU
Pin 3/4 (GND) -> GND
Pin 5 (RESET) -> unused
Pin 6 (NC) -> unused
Pin 7 (RX) -> Pin D2 (GPIO4)
Pin 8 (NC) -> unused
Pin 9 (TX) -> Pin D1 (GPIO5)
Pin 10 (SET) -> unused

Honeywell PM sensor

Pinout: 8 7 6 5 4 3 2 1

Pin 1 (3.3V) -> unused
Pin 2 (5V) -> VU
Pin 3 (NC) -> unused
Pin 4 (NC) -> unused
Pin 5 TEST) -> unused
Pin 6 (TX) -> Pin D1 (GPIO5)
Pin 7 (RX) -> Pin D2 (GPIO4)
Pin 8 (GND) -> GND

BMP180 / BMP280 / BME280 / HTU21D / SHT3x (I2C)

VCC -> Pin 3V3
GND -> Pin GND
SCL -> Pin D4 (GPIO2)
SDA -> Pin D3 (GPIO0)

SPS30 (I2C, 5V)

Pinout: 1 2 3 4 5

Pin 1 (5V) -> Pin VU/VIN
Pin 2 (SDA) -> Pin D3 (GPIO0)
Pin 3 (SCL) -> Pin D4 (GPIO2)
Pin 4 (SEL) -> Pin GND
Pin 5 (GND) -> Pin GND

LCD1602 (I2C, 5V - check your version)

VCC -> Pin VU
GND -> Pin GND
SCL -> Pin D4 (GPIO2)
SDA -> Pin D3 (GPIO0)

OLED displays with SSD1306 (I2C, 128x64 pixels)

VCC -> Pin VU
GND -> Pin GND
SCL -> Pin D4 (GPIO2)
SDA -> Pin D3 (GPIO0)

GPS NEO 6M (serial)

VCC and GND can be provided by board board (use 3.3v!)