torifat / xiaomi-mi-air-purifier

Control and monitor your Xiaomi Mi Air Purifier purifier with HomeKit.

Features

• Air Purifier Accessory
  • Turn on/off
  • Control Fan Speed
  • Toggle Child Lock
  • Change Mode (Auto/Manual)
  • Filter Live Level
  • Filter Change Warning
• Air Quality Sensor
  • Air Quality
  • PM2.5 Density
• Temperature Sensor
• Relative Humidity Sensor

Prerequisites

• Installation of Homebridge

Installation

Install using npm:

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

Or, search for homebridge-xiaomi-mi-air-purifier in Plugins.

Note that it might be neccessary to enter the search string inside double quotes i.e. "homebridge-xiaomi-mi-air-purifier" in some Homebridge UI variants (such as Hoobs) in order to find it among the plethora of similarly named plugins.

Configuration

Configure the plugin in the GUI / Homebridge Config UI X (highly recommended), otherwise head over to Manual Config

Getting a Token

Use Xiaomi Cloud Tokens Extractor to get a token for your device.

Manual Config

Add this to your homebridge config.json file.

{
  "accessories": [
    {
      "name": "Air Purifier",
      "address": "<YOUR_DEVICE_IP_ADDRESS>",
      "token": "<YOUR_DEVICE_TOKEN>",
      "enableAirQuality": true,
      "enableTemperature": true,
      "enableHumidity": true,
      "filterChangeThreshold": 5,
      "enableFanSpeedControl": true,
      "enableChildLockControl": true,
      "accessory": "XiaomiMiAirPurifier"
    }
  ]
}

HomeKit pairing

1. Open the Home app on your device.
2. Tap the Home tab, then tap .
3. Tap Add Accessory, and select I Don't Have a Code or Cannot Scan.