airthings is a simple python package that contains methods to communicate with Airthings[1] devices. The package utilizies bluepy[2] for the communication between python and the devices. The package features can be found below.
Note: Some features are currently undocumented, and parts are untested/not yet implemented.
- Autodiscover Airthings devices
- Find and search for Airthings devices by using MAC addresses and/or identifiers
- Fetch sensor measurements from various Airthings models, see sensor capability list below
bluepy only supports Linux, and is therefore currently the only supported operating system.
I have only tested with the Wave Plus Gen 1 (2930). Other device models should in theory work fine, but they are untested or might be unimplemented.
- libglib2.0-dev
The current stable version of airthings is available on pypi and can be installed by running:
pip install airthings
Other sources:
Examples can be found in the examples directory.
Note: "Model number" are the first 4 digits of the Airthings device serial number
On 1st Gen Wave, temperature and humidity are updated every time we read the wave.
- Humidity (%rH)
- Radon short term average (Bp/m3)
- Radon long term average (Bq/m3)
- Temperature (°C)
Sensor values are updated every 5 minutes.
- Humidity (%rH)
- Temperature (°C)
- VOC (ppb)
Except for the radon measurements, the Wave Plus updates its current sensor values once every 5 minutes. Radon measurements are updated once every hour.
- Humidity (%rH)
- Radon short term average (Bp/m3)
- Radon long term average (Bq/m3)
- Temperature (°C)
- Atmospheric pressure (hPa)
- CO2 (ppm)
- VOC (ppb)
On 2nd Gen Wave, temperature and humidity are updated every 5 minutes. On both devices, radon measurements are updated once every hour.
- Humidity (%rH)
- Radon short term average (Bp/m3)
- Radon long term average (Bq/m3)
- Temperature (°C)