Fetch sensor measurements from Airthings devices
Project description
airthings
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.
Features
- 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
Requirements
The package has currently only been tested on Linux with the
Wave Plus Gen 1 (2930)
, other operating systems and device models
should in theory work fine, but is untested.
System requirements:
- libglib2.0-dev
Installation
------------
The current stable version of infrastructure-daigrams is available on
pypi and can be installed by running:
``pip install airthings``
Other sources:
- pypi: http://pypi.python.org/pypi/airthings/
- github: https://github.com/kotlarz/airthings/
Usage
-----
Examples can be found in the `examples <./examples>`__ directory.
Supported devices
-----------------
*Note: "Model number" are the first 4 digits of the Airthings device*
Wave Gen 1 (Model number: 2900)
On 1st Gen Wave, temperature and humidity are updated every time we read the wave.
Sensor capabilities ^^^^^^^^^^^^^^^^^^^
- Humidity (%rH)
- Radon short term average (Bp/m3)
- Radon long term average (Bq/m3)
- Temperature (°C)
Wave Mini Gen 1 (Model number: 2920)
Sensor values are updated every 5 minutes.
Sensor capabilities
^^^^^^^^^^^^^^^^^^^
- Humidity (%rH)
- Temperature (°C)
- VOC (ppb)
Wave Plus Gen 1 (Model number: 2930)
Except for the radon measurements, the Wave Plus updates its current sensor values once every 5 minutes. Radon measurements are updated once every hour.
Sensor capabilities ^^^^^^^^^^^^^^^^^^^
- Humidity (%rH)
- Radon short term average (Bp/m3)
- Radon long term average (Bq/m3)
- Temperature (°C)
- Atmospheric pressure (hPa)
- CO2 (ppm)
- VOC (ppb)
Wave Gen 2 (Model number: 2950)
On 2nd Gen Wave, temperature and humidity are updated every 5 minutes.
On both devices, radon measurements are updated once every hour.
Sensor capabilities
^^^^^^^^^^^^^^^^^^^
- Humidity (%rH)
- Radon short term average (Bp/m3)
- Radon long term average (Bq/m3)
- Temperature (°C)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for airthings-2.1.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1811fec737362e6705f764cc2cadd69a830f3858ef8b670c6ca2306d5c2872fc |
|
MD5 | abf11061f07703552432118c21afb00d |
|
BLAKE2b-256 | ef34f5a46706b528374f181d4abd5dc3e7f6be27fe39e07b9d3f9a9a73af33c8 |