Airthings Wave
custom-components/sensor.airthings_wave · vv5.0.0
hassio support for Airthings Wave BLE environmental radon sensor.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
sensor | Sensor (temperature, humidity, air quality…) |
What people report
Airthings Wave sensors read over Bluetooth; setup problems after OS updates and firmware changes reported.
- Works2
- Partly works1
- Not working1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Airthings Wave 2nd gen | Works Local | Support addedSaved copyThis pull request is support for The Airthings Wave 2nd generation. This new version or the airthings wave has a new uuid, but returns data the same way as the wave plus (but only a subset) Excerpt saved from GitHub on 2026-10-23. | PR #28 · 2020-08 | |
| Airthings Wave Mini | Works Local | Support added, untested by authorSaved copySupport for the Wave Mini. Not tested since I don't have a Wave Mini, but should not have any impact one the others since it is just a new UUID with matching decoder. (And my Wave 2 and Wave plus still works) The temperature calculation is a bit strange compared to the others - appear to be in Kelvin! Copied it from the original airthing code. Excerpt saved from GitHub on 2026-10-23. | PR #30 · 2020-08 | |
| Airthings Wave Plus | Partly works Local | Battery and illuminance missing after firmware BLE 2.1.0Saved copyMy Airthings Wave+ firmware was updated to version `BLE:2.1.0, MSP:2.1.0, SUB:2.0.14` recently and now battery and illuminance values are not available in Home Assistant. The `airthings.py` output is pasted below. I don't have anything to compare it with from the old firmware. ``` DEBUG:main:Found 1 airthings devices INFO:main:04:ee:03:xx:xx:xx: Manufacturer: Airthings AS Model: 2930 Serial: XXXXXX Device:Airthings Wave+ DEBUG:main:Characteristic DEBUG:main:Characteristic DEBUG:main:Characteristic DEBUG:main:Characteristic DEBUG:main:Characteristic DEBUG:main:Characteristic … Excerpt saved from GitHub on 2026-10-23. | Issue #81 · 2022-06 | |
| Airthings Wave (1st gen) | Not working Local | Sensors not created after HassOS updateSaved copyHi I`m running HA on NUC with Mint Linux and HA in Docker. In Mint I was able to obtain MAC of the Airthings wave and run env/bin/python3 radonwave.py ADDRESS and it worked in command line. In HA I get this error Log Details (ERROR) Logger: custom_components.airthings_wave.airthings Source: custom_components/airthings_wave/airthings.py:191 Integration: airthings_wave (documentation) First occurred: 11:53:52 PM (1 occurrences) Last logged: 11:53:52 PM Traceback (most recent call last): File "/usr/local/lib/python3.8/site-packages/pygatt/backends/gatttool/gatttool.py", line 415, in connect … Excerpt saved from GitHub on 2026-10-23. | Issue #32 · 2020-09 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Connection not stated
The integration doesn’t declare how it connects.
Details
| GitHub stars | 100 |
|---|---|
| Latest version | v5.0.0 (2023-07-14) |
| Set up in the UI | No, YAML |
| Maintainers | @MartyTremblay, @sverrham |
| License | MIT |
Limitations from the README
- Users has reported that it is possible to get data without first registering with the official app, so it should be possible to use the sensor with this integration without registering. The radon level history stored on the Wave itself cannot be accessed with this component. To get around this, it connects regularly …
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
