Air quality sensor
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ondřej Hruška 688bff3a6a finalizations and debugging 3 years ago
components kinda working now maybe 3 years ago
main finalizations and debugging 3 years ago
.gitignore Initial template version based of cspemu 3 years ago
CMakeLists.txt Initial template version based of cspemu 3 years ago
LICENSE.txt license 3 years ago
Makefile Initial template version based of cspemu 3 years ago license 3 years ago
sdkconfig co2 maybe working better 3 years ago

ESP air quality sensor


  • CO2 ppm
  • air temperature
  • relative humidity
  • gas sensor VOC equivalent PPM
  • gas sensor CO2 equivalent PPM

Data reading

The module prints actual readings to the debug console.

Data is accessible as JSON on a REST endpoint /sample, port 80



More data is included once BSEC2 (Bosch proprietary BME680 client / fusion library) finishes its calibration. See the websrv.c file for details.

Workarounds & reliability features

The used CO2 sensor has buggy ABC algorithm that sometimes underflows. Further, I2C is very much broken on the sample used, so I use the Modbus interface instead. Automatic restart and calibration restore is implemented for it.

BSEC2 state persistence is implemented, but dubious if functional due to the millisecond timestamp logic. Air quality reports usually start coming after a couple hours of run time with varying ambient gas concentration.


Config via console on the serial port (115200-8-N-1), or telnet (port 22).

WiFi can be configured and persisted, including static IP. WiFi scan is not implemented.


  • BME680 in I2C mode
  • SenseAir Sunrise (buggy early revision, will need updating for newer sensors)


  • I2C_SDA0 16 - i2c for BME680
  • I2C_SCL0 17
  • I2C_SDA1 5 (senseair sunrise uart TX)
  • I2C_SCL1 18 (senseair sunrise uart RX)
  • CO2_NRDY 23
  • CO2_COMSEL 13 (high=uart)
  • CO2_EN 15 sunrise restart pin, works like nReset


See the LICENSE file.