Airthings Wave Plus

From Leo's Notes
Revision as of 22:39, 25 September 2022 by Leo (talk | contribs) (Created page with "Airthings Wave Plus is a air quality monitor with Bluetooth Low Energy capability. It's capable of measuring temperature, humidity and also CO2, Radon, and VOC. The unit runs on 2 AA batteries. You can poll its status via Bluetooth LE periodically using any device that supports Bluetooth including a Raspberry Pi or an ESP32. == MQTT == Using OpenMQTTGateway on a ESP32, we can read the unit's readings via Bluetooth LE and push it to a MQTT server. Create a MQTTtoBT comm...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
This page was last edited on 25 September 2022, at 22:39.

Airthings Wave Plus is a air quality monitor with Bluetooth Low Energy capability. It's capable of measuring temperature, humidity and also CO2, Radon, and VOC. The unit runs on 2 AA batteries. You can poll its status via Bluetooth LE periodically using any device that supports Bluetooth including a Raspberry Pi or an ESP32.

MQTT

Using OpenMQTTGateway on a ESP32, we can read the unit's readings via Bluetooth LE and push it to a MQTT server.

Create a MQTTtoBT command. You should publish this message to something like: openmqtt/ESP32/commands/MQTTtoBT/config.

{
"ble_read_address":"D8:71:4D:A9:CB:C3",
"ble_read_service":"b42e1c08-ade7-11e4-89d3-123b93f75cba",
"ble_read_char":"b42e2a68-ade7-11e4-89d3-123b93f75cba",
"value_type":"HEX",
"ttl":10,
"immediate":true
}

You should then hopefully be able to hear back once a connection gets established.

{
"id":"D8:71:4D:A9:CB:C3",
"service":"b42e1c08-ade7-11e4-89d3-123b93f75cba",
"characteristic":"b42e2a68-ade7-11e4-89d3-123b93f75cba",
"read":"015f220073008400ba07ddab5a0247000000ac05",
"success":true
}

The data here needs to be decoded. The data structure looks like this:

typedef struct
{
  uint8_t version = 0;
  uint8_t humidity = 0;
  uint8_t ambientLight = 0;
  uint8_t unused01 = 0;
  uint16_t radon = 0;
  uint16_t radonLongterm = 0;
  uint16_t temperature = 0;
  uint16_t pressure = 0;
  uint16_t co2 = 0;
  uint16_t voc = 0;
} WavePlusRawReadings;

In the example above, we'll break the read data out into their individual fields and decode it into useful measurements.

Hex Name Final reading
01 Version Version 1
5f Humidity 0x5f = 95 / 2 = 47.5%
22 Ambient Light 0x22 = 34
00 Unused
7300 Radon, 24 hours 0x0073 = 115 Bq
8400 Radon, long term 0x0084 = 132 Bq
ba07 Temperature 0x07ba = 1978 / 100 = 19.78 C
ddab Air Pressure 0xabdd = 43997 / 50 = 879.94 Pa
5a02 CO2 0x025a = 602 ppm
4700 VOC 0x0047 = 71 ppb
0000 ??
ac05 ?? 0x05ac = 1452