Skip to main content

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 airthings 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
serial number*

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-1:

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-2:

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-3:

Sensor capabilities
^^^^^^^^^^^^^^^^^^^

-  Humidity (%rH)
-  Radon short term average (Bp/m3)
-  Radon long term average (Bq/m3)
-  Temperature (°C)


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

airthings-3.1.1.tar.gz (13.6 kB view hashes)

Uploaded Source

Built Distribution

airthings-3.1.1-py3-none-any.whl (18.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page