homebridge-mi-aqara
Mi Aqara plugin for HomeBridge
This repository contains the Aqara plugin for homebridge.
Aqara is a ZigBee gateway with a few sensors. Please see the pictures below.
Pre-Requirements
- Make sure you have V2 of the gateway. V1 has limited space so can't support this feature.
- Update gateway firmware to 1.4.1_141.0141 or later. You can contact @babymoney666 if your firmware is not up to date.
Installation
- Install HomeBridge, please follow it's README. If you are using Raspberry Pi, please read Running-HomeBridge-on-a-Raspberry-Pi.
- Make sure you can see HomeBridge in your iOS devices, if not, please go back to step 1.
- Download homebridge-mi-aqara to your local folder.
Configuration
-
Open Aqara gateway's settings, enable local network protocol. Please follow the steps in this thread: http://bbs.xiaomi.cn/t-13198850. It's in Chinese so you might need a translator to read it.
-
To control the devices, put gateway's MAC address (lower case without colon) and password to ~/homebridge/config.json.
{ "platforms": [ { "platform": "MiAqara", "hub_mac_address": ["6409802da3b3"], "hub_password": ["02i44k56zrgg578b"] }] }
If you have more than one gateways, fill them in right order, like below.
{
"platforms": [
{
"platform": "MiAqara",
"hub_mac_address": ["6409802da3b3", "f0b4299a5b2b", "f0b4299a77dd"],
"hub_password": ["02i44k56zrgg578b", "g250s2vtne8q9qhv", "syu3oasva3uqd5qd"]
}]
}
If gateway's password is not set or not set right, you will see the following error in homebridge's output.
> No password for gateway f0b429cbe4d3, please edit ~/.homebridge/config.json
Run it
-
From source code
$ cd /path/to/homebridge-mi-aqara $ DEBUG=* homebridge -D -P .
-
As homebridge plugin
$ npm install -g homebridge-mi-aqara $ homebridge