homebridge-mijia

MiJia plugin for HomeBridge

This repository contains the MiJia plugin for homebridge.

MiJia is a ZigBee gateway with a almost all sensors and accessories. Please see the pictures below.

A new service has been added. Level battery.

Adding a new low battery service. When the battery is low, the notification icon (iOS 10.3 or later version)

Pre-Requirements

1. Make sure you have V2 of the gateway. V1 has limited space so can't support this feature.
2. Update gateway firmware to 1.4.1_141.0141 or later. You can contact @babymoney666 if your firmware is not up to date.

Installation

1. Install HomeBridge, please follow it's README. If you are using Raspberry Pi, please read Running-HomeBridge-on-a-Raspberry-Pi.
2. Make sure you can see HomeBridge in your iOS devices, if not, please go back to step 1.
3. Download homebridge-mijia to your local folder.

Configuration

1. Open MiJia 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.

2. To control the devices, put gateway's MAC address (lower case without colon) and password to ~/.homebridge/config.json.

    {
        "platforms": [
        {
            "platform": "MiJiaPlatform",
            "sid": ["1a2b3c4d5e6f"],
            "password": ["1234567890123456"]
        }]
    }

If you have more than one gateways, fill them in right order, like below.

    {
        "platforms": [
        {
            "platform": "MiJiaPlatform",
            "sid": ["1a2b3c4d5e6f", "1a2b3c4d5e6f", "1a2b3c4d5e6f"],
            "password": ["1234567890123456", "1234567890123456", "1234567890123456"]
        }]
    }

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

If you like to use Light Bulb type for Light Switch to make grandma Siri happy, like me, you can set the following in the config.

    {
        "platforms": [
        {
            "platform": "MiJiaPlatform",
            ...
            "fakeLightBulbForLightSwitch": true,
            ...
        }]
    }
    

If you prefer to see sensor names instead of hex digis as name, add a mapping table to your config.json

    {
        "platforms": [
        {
            "platform": "MiJiaPlatform",
            ...
            "sensor_names": {
				"0c08":"Kitchen Window"
            }
            ...
        }]
    }   

Run it

1. From source code

    $ cd /path/to/homebridge-mijia
    $ DEBUG=* homebridge -D -P .

2. As homebridge plugin

    $ npm install -g homebridge-mijia
    $ homebridge