Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/seikan/homebridge-mi-air-purifier
A Xiaomi Mi air purifier plugin for Homebridge.
https://github.com/seikan/homebridge-mi-air-purifier
Last synced: about 2 months ago
JSON representation
A Xiaomi Mi air purifier plugin for Homebridge.
- Host: GitHub
- URL: https://github.com/seikan/homebridge-mi-air-purifier
- Owner: seikan
- License: other
- Created: 2017-05-19T13:25:32.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-01-26T13:21:19.000Z (almost 5 years ago)
- Last Synced: 2024-10-14T12:37:17.086Z (2 months ago)
- Language: JavaScript
- Size: 31.3 KB
- Stars: 172
- Watchers: 14
- Forks: 65
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-homebridge - Mi
README
# homebridge-mi-air-purifier
This is Xiaomi Mi Air Purifier plugin for [Homebridge](https://github.com/nfarina/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.
### 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
```
3. 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
```
4. Record down the `Address` and `Token` values as we need it in our configuration file later.
5. 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.
6. Then run the command again.
```
miio discover --sync
```
7. 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.
8. Restart Homebridge, and your Mi air purifier will be added to Home app.
### License
See the [LICENSE](https://github.com/seikan/homebridge-mi-air-purifier/blob/master/LICENSE.md) file for license rights and limitations (MIT).