Go to file
SeanOMik 9a028544bb
Report status of sensors, dont just immediately return an internal error
2023-09-16 23:24:21 -04:00
src Report status of sensors, dont just immediately return an internal error 2023-09-16 23:24:21 -04:00
.gitignore Add sgp30 sensor 2023-07-23 23:02:56 -04:00
CHANGELOG.md Prep for release 1.2.0 2021-08-28 18:19:14 +02:00
LICENSE Initial commit 2020-06-26 08:35:46 +02:00
README.md update readme.md 2023-07-23 23:58:59 -04:00
platformio.ini Add sgp30 sensor 2023-07-23 23:02:56 -04:00
shell.nix Add sgp30 sensor 2023-07-23 23:02:56 -04:00

README.md

Prometheus ESP8266 DHT Exporter

An IoT Prometheus exporter for measuring temperature and humidity, using an ESP8266 (Arduino-compatible) with a Wi-Fi module and a DHT (temperature + humidity) sensor.

Metrics

Metric Description Unit
dorm_info Metadata about the device.
dorm_free_heap Free heap. byte
dorm_sensor Metadata about a sensor.
dorm_air_humidity_percent Air humidity. %H
dorm_air_temperature_celsius Air temperature. °C
dorm_air_heat_index_celsius Apparent air temperature, based on temperature and humidity. °C
dorm_air_quality_eco2 Equivalent calculated carbon-dioxide. ppm
dorm_air_quality_tvoc Total volatile organic compound. ppb/t
dorm_air_quality_h2 Hydrogen measurement. ppm
dorm_air_quality_ethanol Ethanol measurement. ppm

Requirements

Hardware

  • ESP8266-based board (or some other appropriate Arduino-based board).
    • Tested with "Adafruit Feather HUZZAH ESP8266" and "WEMOS D1 Mini".
  • DHT sensor.
    • Tested with a cheap DHT11 from eBay (using pin 12).
    • DHT11 supports a maximum of 1Hz polling while DHT22 supports a maximum of 2Hz polling.
    • Both DHT11 and DHT22 support both 3V and 5V at 2.5mA max current.
  • Adafruit SGP30 Sensor

Software

Building

Hardware

Using the "Adafruit Feather HUZZAH ESP8266".

Wire the DHT sensor power to the 3.3V and any GND on the ESP and wire the data output to e.g. pin 14 (aka D5).

Version

See src/version.h.

It's set manually since no build tools (or CI) other than the Arduino IDE is used.

License

GNU General Public License version 3 (GPLv3).