This page is part of archived documentation for openHAB 4.1. Go to the current stable version

# Airthings

This extension adds support for Airthings (opens new window) indoor air quality monitor sensors.

# Supported Things

Following thing types are supported by this extension:

Thing Type ID Description
airthings_wave_plus Airthings Wave Plus
airthings_wave_mini Airthings Wave Mini
airthings_wave_gen1 Airthings Wave 1st Gen (SN 2900xxxxxx)

# Discovery

As any other Bluetooth device, Airthings devices are discovered automatically by the corresponding bridge.

# Thing Configuration

Supported configuration parameters for the things:

Property Type Default Required Description
address String Yes Bluetooth address of the device (in format "XX:XX:XX:XX:XX:XX")
refreshInterval Integer 300 No How often a refresh shall occur in seconds

# Channels

Following channels are supported for Airthings Wave Mini thing:

Channel ID Item Type Description
temperature Number:Temperature The measured temperature
humidity Number:Dimensionless The measured humidity
tvoc Number:Dimensionless The measured TVOC level

The Airthings Wave Plus thing has additionally the following channels:

Channel ID Item Type Description
pressure Number:Pressure The measured air pressure
co2 Number:Dimensionless The measured CO2 level
radon_st_avg Number:RadiationSpecificActivity The measured radon short term average level
radon_lt_avg Number:RadiationSpecificActivity The measured radon long term average level

The Airthings Wave Gen 1 thing has the following channels:

Channel ID Item Type Description
radon_st_avg Number:RadiationSpecificActivity The measured radon short term average level
radon_lt_avg Number:RadiationSpecificActivity The measured radon long term average level
temperature Number:Temperature The measured temperature
humidity Number:Dimensionless The measured humidity

Note: For the Airthings Wave Gen 1, only one channel can be updated at each refreshInterval, so it will take refreshInterval x 4 cycles to sequentially update all 4 channels

# Example

airthings.things (assuming you have a Bluetooth bridge with the ID bluetooth:bluegiga:adapter1:

bluetooth:airthings_wave_plus:adapter1:sensor1  "Airthings Wave Plus Sensor 1" (bluetooth:bluegiga:adapter1) [ address="12:34:56:78:9A:BC", refreshInterval=300 ]

airthings.items:

Number:Temperature                  temperature     "Temperature [%.1f %unit%]"                   { channel="bluetooth:airthings_wave_plus:adapter1:sensor1:temperature" }
Number:Dimensionless                humidity        "Humidity [%d %unit%]"                        { channel="bluetooth:airthings_wave_plus:adapter1:sensor1:humidity" }
Number:Pressure                     pressure        "Air Pressure [%d %unit%]"                    { channel="bluetooth:airthings_wave_plus:adapter1:sensor1:pressure" }
Number:Dimensionless                co2             "CO2 level [%d %unit%]"                       { channel="bluetooth:airthings_wave_plus:adapter1:sensor1:co2" }
Number:Dimensionless                tvoc            "TVOC level [%d %unit%]"                      { channel="bluetooth:airthings_wave_plus:adapter1:sensor1:tvoc" }
Number:RadiationSpecificActivity    radon_st_avg    "Radon short term average level [%d %unit%]"  { channel="bluetooth:airthings_wave_plus:adapter1:sensor1:radon_st_avg" }
Number:RadiationSpecificActivity    radon_lt_avg    "Radon long term average level [%d %unit%]"   { channel="bluetooth:airthings_wave_plus:adapter1:sensor1:radon_lt_avg" }