Homebridge-BlueAir
Original plugin not maintained but still available
See Wiki for readme and further details.
Update to dynamic platform
The plugin was forked and updated completely to a typescript-based dynamic platform supporting the automatic configuration of devices with just the username and password.
Support for configuration in the Homebridge UI has also been added to simplify setup.
Installation
npm install homebridge-blueair
Features
-
Easy configuration - all you need is your username and password to get started. The defaults work for the vast majority of users.
-
Automatic detection and configuration of multiple BlueAir devices. By default - all of your supported devices are made available in HomeKit.
-
NEW support for AWS-based models such as the HealthProtect and DustMagnet models. Please check the 'enable AWS API connection' to try out this new feature developed by @jonato1.
Supported Devices / Features
| Device | Air Purifier | LED Status Switch | AQI (PM 1) | AQI (PM 2.5) | AQI (PM 10) | AQI (tVOC) | CO2 Sensor | Temp. Sensor | Humidity Sensor | Night Mode | Germ Shield |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Classic (280i, 290i, 380i, 480i, 490i, 580i, 680i, 690i) | Y | Y | N | Y | N | Y | Y | Y | Y | N | N |
| Classic (205, 405, 505, 605) | Y | Y | N | N | N | N | N | N | N | N | N |
| Aware | Y | Y | N | Y | Y | Y | Y | Y | Y | N | N |
| DustMagnet (5210, 5410) | Y | Y | N | Y | N | N | N | N | N | Y | N |
| HealthProtect (7440i, 7470i, 7710i) | Y | Y | In Progress | Y | In Progress | In Progress | N | Y | N | Y | Y |
| Blue Pure (211i Max, 311i+ Max, 411i Max) | Y | Y | In Progress | Y | In Progress | N | N | N | N | Y | N |
Note: For all newer Blueair devices that leverage AWS infrastructure (i.e. DustMagnet, HealthProtect, and Blue Pure), the only current regions supported are US and Canada/EU. Please open a new issue if you need a new region configured.
To do
- Continue to add support for additional models. Match capabilities to Homekit device. See Issue #6.
Plugin Configuration
Feature Toggles
- Enable AWS-enabled devices (This is required for devices like DustMagnet, HealthProtect, and Blue Pure.)
- Hide LED
- Hide Air Quality Sensor
- Hide Temperature Sensor
- Hide Humidity Sensor
- Hide CO2 Sensor
- Hide Night Mode
- Hide Germ Shield
If you choose to configure this plugin directly instead of using the Homebridge Configuration web UI, you'll need to add the platform to your config.json in your home directory inside .homebridge.
"platforms": [{
"platform": "BlueAir",
"username": "email@email.com",
"password": "password"
}]For most people, I recommend using Homebridge Configuration web UI to configure this plugin rather than doing so directly. It's easier to use for most users, especially newer users, and less prone to typos, leading to other problems.
Credits
Many thanks to @jonato1 for his hard work developing the Amazon Web Services (AWS) API and associate accessories.
This plug was forked from homebridge-blueair without which this would not be possible. Many thanks to @mylesagray! This plugin uses many cues from homebridge-myq2 for plugin structure and my other plugin homebridge-kumo.