https://github.com/depau/air-quality-sensor-esp8266-fw
ESP8266 firmware for publishing BME680 + SDS011 readings to MQTT
https://github.com/depau/air-quality-sensor-esp8266-fw
bme680 esp8266 homie-convention openhab sds011
Last synced: 2 months ago
JSON representation
ESP8266 firmware for publishing BME680 + SDS011 readings to MQTT
- Host: GitHub
- URL: https://github.com/depau/air-quality-sensor-esp8266-fw
- Owner: depau
- License: gpl-3.0
- Created: 2021-05-01T18:11:13.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2021-05-05T02:35:26.000Z (about 4 years ago)
- Last Synced: 2025-01-15T05:52:41.298Z (4 months ago)
- Topics: bme680, esp8266, homie-convention, openhab, sds011
- Language: C++
- Homepage:
- Size: 32.2 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Air quality sensor to MQTT
The firmware I use to push measurements from my air quality sensors (BME680 and SDS011) to my MQTT broker.
Note that this uses the proprietary BME680 library. I do have concerns about it but after inspecting the
alternative libraries I concluded that, at this moment, the manufacturer seems to be the one having the
best API and providing the most accurate readings.
One could also argue that the SDS011, even though the protocol is very simple, runs its own proprietary
firmware, it's just 4 wires apart as opposed to running as part of the MCU firmware.
This code includes a library for the SDS011 that I've written myself, since the existing libraries that
I could find are quite terrible. All functionality documented in the datasheet is exposed.
## Flashing
This software uses PlatformIO, so to flash you can run
```
pio run --target upload
```
after changing the UART parameters in `platformio.ini`. ArduinoOTA is also implemented.
## Remote logging
```bash
mosquitto_sub -h MQTT_BROKER -t homie/air-sensor/general/log -N
```