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
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.
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-3.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b38896901c90d54e09656fdc18e8084eb6e2a70cbc81d50aabfccc68969f59f7 |
|
MD5 | 40c91eea8e35374e3ee3929fc207a414 |
|
BLAKE2b-256 | 4997a22e99e273f88ef5c5682ee2fa59f8f9cdb892c18f7dc1ad7bffc5c8b912 |