Skip to content

fjs21/homebridge-blueair

 
 

Repository files navigation


Homebridge-BlueAir

Downloads Version verified-by-homebridge

GitHub issues GitHub pull requests

Original plugin not maintained but still available

Link to Original Plugin Repo

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.