Airthings Wave Air Quality for Home Assistant

Home Assistant support for the Airthing Wave and Airthings Wave Plus indoor air quality sensors.

SEE ALTERNATIVES:

https://github.com/custom-components/sensor.airthings_wave (appears to support Wave Plus now)
https://github.com/Danielhiversen/home_assistant_airthings_cloud

Support

Beware, very untested.

This was developed by @gkreitz and @mstanislav.

From @gkreitz: I wanted something to read my Airthings Wave Plus, so I built this. Far from production quality. Magic hardcoded constants. Reads data the wrong way to work around a bug. Tested on a single device. Only supports a single Wave Plus. Does not construct a unique id for the sensor. Figured I may as well upload in case it's useful to someone else.

If you have trouble with installation and configuration, visit the Airthings Wave Home Assistant community discussion.

Additional features and bug fixes are the responsibility of the community to implement (unless trivial to add).

Installation

Step 1: Install Custom Components

Make sure Home Assistant Community Store (HACS) is installed, then add the "Integration" repository: gkreitz/hass-airthings-wave.

Note:

The 'master' branch of this custom component is considered unstable, alpha quality and not guaranteed to work.
Manual installation by direct download and copying is not supported, if you have issues, please first try installing this integration with HACS.

Step 2: Configure

Find the MAC address for your Airthings Wave. See https://airthings.com/us/raspberry-pi/ for details.
Add the following to your configuration.yaml (or modify your sensor heading, if you already have one):

sensor:
  - platform: airthings
    model: waveplus
    mac: 00:11:22:AA:BB:CC # replace with MAC of your Airthings Wave+

sensor:
  - platform: airthings
    model: wave # or waveplus
    mac: 00:11:22:AA:BB:CC # replace with MAC of your Airthings Wave+
    unit_system: imperial # or metric

Then restart Home Assistant and if everything works, you'll have some new sensors named sensor.airthings_{co2,humidity,longterm_radon,pressure,shortterm_radon,temperature,voc}

Known issues

The unit_system imperial (Fahrenheit) is likely not working.
Addition of elevation in meters config option to correct the pressure sensor to sea level conditions.