Go to file

Håvard O. Nordstrand 7c4d06ad3c Update changelog		2020-06-29 13:40:56 +02:00
src	Add info metric and prep release	2020-06-29 13:39:10 +02:00
CHANGELOG.md	Update changelog	2020-06-29 13:40:56 +02:00
LICENSE	Initial commit	2020-06-26 08:35:46 +02:00
README.md	Add info metric and prep release	2020-06-29 13:39:10 +02:00

README.md

Prometheus ESP8266 DHT Exporter

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

Metrics

Metric	Description	Unit
iot_info	Metadata about the device.
iot_air_humidity_percent	Air humidity.	`%`
iot_air_temperature_celsius	Air temperature.	`°C`
iot_air_heat_index_celsius	Apparent air temperature, based on temperature and humidity.	`°C`

Hardware

ESP8266-based board: WEMOS D1 Mini

DHT sensor: Wemos DHT Shield (DHT11)

Software

Arduino IDE
- Download and install.
esp8266 library for Arduino
- See the instructions on the page.
DHT sensor library for ESPx
- Install using the Arduino library manager.
- The Adafruit one didn't work for the WEMOS D1.

Building

This uses the Arduino IDE.

Copy config.default.h to config.h and fill inn the details.
Set the correct settings for the board.
- WEMOS D1 Mini uses board "WeMoS D1 R2 & mini".
Build and upload using the Arduino IDE.

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).