HomeBridge accessory plugin for the Awair Glow air quality monitor.
Use it to see the status and readings of your monitor in HomeKit. Includes an overall AQ score, temperature, humidity, CO2, and VOC readings.
Assumes you have Homebridge installed.
-
You will need an Access Token from Awair to get started. Visit https://developer.getawair.com/ to get one. This will give you free access to the "Hobbyist" tier, which will be good enough to run this plugin.
-
Get a list of your Awair devices so you can plug them in to the config:
curl -X GET http://developer-apis.awair.is/v1/users/self/devices -H 'Authorization: Bearer {access-token}'
-
Install this plugin:
[sudo] npm install -g homebridge-awair-glow
-
Add an accessory entry to your Homebridge configuration for each Awair Glow you'd like to add. Here's the syntax:
{
"accessory": "AwairGlow",
"name": "Awair Glow",
"token": "xxx.xxx.xxx",
"deviceId": "12345"
}
Pull requests welcome. Useful information for further development:
- Custom characteristic to push score
- Can't read VOC on iPhone
- Platform-ize
- Read device list and add accessories automagically
http://developer-apis.awair.is/v1/users/self/devices
http://developer-apis.awair.is/v1/users/self/devices/:device_type/:device_id/air-data/15-min-avg
See response.sample.json
- Awair API: https://docs.developer.getawair.com/
- Homebridge: https://github.com/nfarina/homebridge
- Homebridge plugin development: http://blog.theodo.fr/2017/08/make-siri-perfect-home-companion-devices-not-supported-apple-homekit/
- List of Services and conventions: https://github.com/KhaosT/HAP-NodeJS/blob/master/lib/gen/HomeKitTypes.js
- Another Awair plugin: https://github.com/deanlyoung/homebridge-awair
- Reference AQ plugin: https://github.com/toto/homebridge-airrohr
- Refenerce temperature plugin: https://github.com/metbosch/homebridge-http-temperature