waveplus_exporter

Prometheus exporter for the Airthings Waveplus air sensor, based on their library

Raspberry Pi Setup

This worked for me on a raspberry pi 3.

System Setup

$ sudo systemctl start hciuart
$ sudo bluetoothctl
[bluetooth]# power on
[bluetooth]# show
...
	Powered: yes
...

Python Setup

$ sudo apt install python3 python3-pip libglib2.0-dev python3-venv
$ export VENV=/opt/venv
$ sudo python3 -m venv $VENV && $VENV/bin/pip3 install python-dotenv prometheus_client bluepy
$ export PATH="$VENV/bin:$PATH"
$ sudo pip3 install bluepy prometheus_client

Prometheus Setup

A raspberry pi has more than enough compute to run a prometheus instance, this exporter, and plenty more. See the example config file.

$ prometheus --config.file example_prometheus_config.yml

Usage

usage: python3 waveplus_exporter.py [-h] [--port [PORT]] [--bind [BIND]] [--periodseconds [PERIODSECONDS]] --serialnumber [SERIALNUMBER]

optional arguments:
  -h, --help            show this help message and exit
  --port [PORT]         The TCP port to listen on (default: 9744)
  --bind [BIND]         The interface/IP to bind to (default: 0.0.0.0)
  --periodseconds [PERIODSECONDS] number of seconds to wait between sampling (default: 60)

Dashboard

Grafana dashboard

License

The original reader from Airthings uses the MIT License, and so does this.