Airthings Wave Plus and Raspberry Pi

Orjan Gengedal, December 17, 2018

How to read Airthings Wave Plus Sensor data using Raspberry Pi

RELEASE NOTES:

  • Release dated 14-Dec-2018
  • Added SAMPLE-PERIOD as an input argument.
  • Initial release 12-Dec-2018

 

View the full script on GitHub.

Due to popular demand, Wave Plus owners can now read sensor data using a Raspberry Pi. Our latest code is hosted at Github which has the most recent updates and HOW-TOs for using Raspberry Pi. Additionally, you can request new features, open issues or even contribute to the project by creating pull requests.

Airthings Wave Plus is a smart IAQ monitor with Radon detection, including sensors for temperature, air pressure, humidity, TVOCs and CO2.

In a previous post, we showed you how you could use a Raspberry Pi 3 Model B to read sensor data from the Airthings Wave over Bluetooth Low Energy (BLE).

Similarly, this guide explains how to read sensor data using the Raspberry Pi 3 Model B from the Airthings Wave Plus using the same approach.

To get started, follow the setup as explained in the previous Airthings Wave article and install the required packages/modules on the Raspberry Pi device.

Download the Python script:

pi@raspberrypi:~$ wget https://raw.githubusercontent.com/Airthings/waveplus-reader/master/read_waveplus.py

The following python script "read_waveplus.py" is only compatible with python2.7. In this guide, we have used python version 2.7.13. In addition to the pre-requisites listed in the previous post, the following python module must also be installed:

pi@raspberrypi:~$ sudo pip2 install tableprint==0.8.0

Read sensor data from the Airthings Wave Plus

The available sensor data are temperature, humidity, CO2 level, TVOC level, pressure, running average 24-hour radon concentration and running long-term average radon concentration.

To read the sensor data from the Airthings Wave Plus, you need the 10-digit serial number of the device. This can be found under the magnetic backplate of your Airthings Wave Plus. If your device is paired and connected to e.g. a phone, you may need to turn off bluetooth on your phone while using these scripts.

The general format for calling the "read_waveplus.py" script is as follows:

read_waveplus.py SN SAMPLE-PERIOD [pipe > yourfilename.txt]

Where the input arguments are:

Input arguement Example Comments
SN 0123456789 10-digit number. Can be found under the magnetic backplate of your Airthings Wave Plus.
Sample period 60 Read sensor values every 60 seconds. Must be larger than zero.
Pipe pipe > yourfilename.txt Optional. Since tableprint is incompatible with piping, we use a third optional input argument "pipe".


Except for the radon measurements, the Wave Plus updates its current sensor values once every 5 minutes. Radon measurements are updated once every hour. The radon measurements are given in Bq/m3 and the maximum value that can be read by the script is 16383 Bq/m3. Please note that the radon measurements are only available 1 hour after the batteries have been inserted.

Printing data to the terminal window

By default, the read_waveplus.py script will print the current sensor values to the Rasberry Pi terminal. Run the Python script in the following way:

pi@raspberrypi:~ $ sudo python2 read_waveplus.py SN SAMPLE-PERIOD

where you change SN with the 10-digit serial number, and change SAMPLE-PERIOD to a numerical value of your choice.

After a short delay, the script will print the current sensor values to the Raspberry Pi terminal window. Exit the script using Ctrl+C.

Piping data to a text-file

If you want to pipe the results to a text-file, you can run the script in the following way:

pi@raspberrypi:~ $ sudo python2 read_waveplus.py SN SAMPLE-PERIOD pipe > yourfilename.txt

Change SN with the 10-digit serial number, and change SAMPLE-PERIOD to a numerical value of your choice. Exit the script using Ctrl+C.

Final notes

This guide has been tested with Raspberry Pi 3 Model B, Raspbian Stretch, bluepy 1.2.0, tableprint 0.8.0 and Python 2.7.13.

Let us know how it went and what you would like to see next on our facebook page.

Our most popular products

Home

Meet Corentium Home by Airthings (previously known as Canary), a simple to use and wildly popular radon gas detector.
Home $179.99

Wave

A smart radon detector with quick and accurate results on your smartphone. Additionally, you can simply wave in front of the device to get a visual indication of your radon levels.
Wave $199.99

Wave Plus

The first battery-operated smart indoor air quality monitor with Radon detection, including sensors for temperature, air pressure, humidity, VOCs, and CO2.
Wave Plus $229.99

Wave Mini

Featuring TVOCs, temperature and humidity sensors, Wave Mini is the perfect first step into understanding the health and comfort level in every room, or a great addition to an existing air quality ecosystem.
Wave Mini $79.99

Hub

Complete the system. The Airthings Hub brings one or more devices online providing on-demand access to your indoor air quality (IAQ) data at anytime, from anywhere!
Hub $79.99

Pro

Meet Corentium Pro, a favorite of home inspectors and radon professionals. Fully AARST-NRPP certified for the North American market and beyond.
Pro $1299

Radon map

Thousands of Radon sensors across the world, broken down by location. See your region's approximate risk level.

Explore

Thousands of Radon sensors across the world, broken down by location. See your region's approximate risk level.

Explore