Skip to content
hassio support for Airthings Wave BLE environmental radon sensor.
Branch: master
Clone or download
Latest commit cebc2aa Dec 22, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
custom_components/airthings_wave Update Dec 22, 2019
.gitignore Create .gitignore Mar 28, 2019 Made bluetooth implementation more resilient Aug 27, 2019 Initial Apr 1, 2019
LICENSE Update Jul 10, 2019
ScreenShot2.png Resolves #10 Apr 4, 2019 Update Jul 10, 2019
package.yaml Update package.yaml Apr 15, 2019
resources.json Update resources.json Apr 2, 2019


GitHub Release GitHub Activity custom_updater License

Project Maintenance BuyMeCoffee BuyMeCoffee

Discord Community Forum

hassio support for Airthings Wave BLE environmental radon sensor.


Much of the code to build this component was inspired by these projects:

The aforementioned radonwave project is especially useful as it describes many of the BLE characteristics specific to this product and has good trouble-shooting tips. The script provided is also very useful in determining the MAC address of your AW device. See here:

Getting started




<config directory>/custom_components/airthings_wave/

Example configuration.yaml:

# Example configuration.yaml entry
  - platform: airthings_wave
    mac: "98:07:2D:4A:97:5C"
    name: 'Basement Airthings Wave'
    scan_interval: 120

Configuration Variables


(string)(Required) The airthings_wave mac address


(string)(Optional) The name of the device. Defaults to 'Airthings Wave'


(string)(Optional) The interval between polls. Defaults to 300 seconds (5 minutes)


It may be possible that the Wave must be connected to the official app at least once before you can use this program, so you will probably not get around registering an account with Airthings.

The radon level history stored on the Wave itself cannot be accessed with this component. To get around this, it connects regularly to the radon detector.

Make sure you install the latest firmware on the device using the official app first.

Known Issues

Hardware Requirements

Other Resources

You can’t perform that action at this time.