hma

homebridge-mi-air-purifier

A Xiaomi Mi air purifier plugin for Homebridge.

Showing:

Popularity

Downloads/wk

14

GitHub Stars

171

Maintenance

Last Commit

3yrs ago

Contributors

7

Package

Dependencies

0

Size (min+gzip)

2.2KB

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

homebridge-mi-air-purifier

This is Xiaomi Mi Air Purifier plugin for Homebridge. This plugin will add the air purifier and Air Quality Sensor to your Home app. This version is working with iOS 11 to add the device as air purifier in Home app.

mi-air-purifier

Features

  • Switch on / off.

  • Switch auto / manual mode.

  • Change fan rotation speed.

  • Switch child lock on / off.

  • Switch LED light on / off.

  • Switch buzzer sound on / off.

  • Display temperature.

  • Display humidity.

  • Display air quality.

Installation

  1. Install required packages.

    npm install -g homebridge-mi-air-purifier miio
    

  2. Make sure your Homebridge server is same network with your air purifier, then run following command to discover the token.

    miio discover --sync
    
  1. You may need to wait few minutes until you get the response similar to below:

    Device ID: 49466088
    Model info: Unknown
    Address: 192.168.1.8
    Token: 6f7a65786550386c700a6b526666744d via auto-token
    Support: Unknown
    

  2. Record down the Address and Token values as we need it in our configuration file later.

  3. If you are getting ?????????????? for your token value, please reset your device and connect your Homebridge server directly to the access point advertised by the device.

  4. Then run the command again.

    miio discover --sync
    

  5. Add following accessory to the config.json.

      "accessories": [
        {
          "accessory": "MiAirPurifier",
          "name": "Bed Room Air Purifier",
          "ip": "ADDRESS_OF_THE_AIR_PURIFIER",
          "token": "TOKEN_FROM_STEP_3",
          "showTemperature": true,
          "showHumidity": true,
          "showAirQuality": true,
          "showLED": true,
          "showBuzzer": true
        },
        {
          "accessory": "MiAirPurifier",
          "name": "Living Room Air Purifier",
          "ip": "ADDRESS_OF_THE_AIR_PURIFIER",
          "token": "TOKEN_FROM_STEP_3",
          "showTemperature": true,
          "showHumidity": true,
          "showAirQuality": true,
          "showLED": true,
          "showBuzzer": true
        }
      ]
    

    Notes: Set value for showTemperature, showHumidity, showAirQuality, showLED, showBuzzer to true or false to show or hide these sensors in Home app.

  6. Restart Homebridge, and your Mi air purifier will be added to Home app.

License

See the LICENSE file for license rights and limitations (MIT).

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial