homebridge-homekit-control v0.2.4

Homebridge HomeKit Control

HomeKit Control allows you to control HomeKit enabled devices from Homebridge.

This is especially usefull if you want to control HomeKit Exclusive devices and accessories through:

• Google Assistant (using homebridge-gsh plugin)
• Amazon Alexa (using homebridge-alexa plugin)
• and of course still controllable from Apple HomeKit though Homebridge.

The Plugin currently supports the following Services provided by WLAN-based HomeKit enabled devices:

• Switch
• Outlet
• Motion Sensors
• Temperatur Sensors
• Humidity Sensors
• CO2 Sensors
• Carbon Monoxid Sensors
• Air Quality Sensors
• Ambient Light Sensors
• Light Bulbs
• Battery/Charging State

BLE is currently not supported, as it seems to be unstable when multiple BLE-enabled Plugins are installed.

All supported sensors on any configured device are automatically dicovered and added when HomeBridge starts up.

Install

sudo npm i -g homebridge-homekit-control

Pair devices

Discover Devices

homekitPair [network] [interface]

Example

homekitPair

or

homekitPair -i wlan0

• Select device, and enter code to pair (including -, example 123-45-678)
• Enter filename to save pairing's informations JSON
• Inside the JSON file, you can find

{
    "id": "device id",
    "name": "device name",
    "address": "device ip",
    "port": device-port,
    "pairingData": {
        "AccessoryPairingID": "xxx",
        "AccessoryLTPK": "xxx",
        "iOSDevicePairingID": "xxx",
        "iOSDeviceLTSK": "xxx",
        "iOSDeviceLTPK": "xxx"
    },
    "accessories": {
        "accessories": [...]
    }
}

• Note down the "id", "name", "address", "port" and "pairingData"

Config

This Plugin supports the Configuration Interface in Homebridge UI (homebridge-config-ui-x). Simply add a new Device and paste the values you obtained above.

Here are some additional configuration parameters, not obtained by the Device Pairing:

• services.enableHistory (boolean): true will enable fakeGato for compatible Sensors. This will allow you to view a history in the EVE-App
• services.historyInterval (optional, numeric): Determins the Interval used to take readings. The valus range is 30, 600. The default value is 600
• services.proxyAll(optional, boolean): By default we only proxy tested services and characteristics from your devices. When this mode is enabled, all available services and characteristics are proxied. Be carefull when activating, this may cause damage to your devices. The default value is false
• services.uniquePrefix(optional, string): When a device is added to multiple HomeBridge instances in the same network, you will need to provide a unique prefix. Otherwise Eve-App will get confused.

Example

{
    "platforms": [
        {
            "platform": "HomekitControl",
            "services": [
                {
                    "id": "device id",
                    "name": "device name",
                    "address": "device ip",
                    "port": "device port",
                    "enableHistory": false,
                    "pairingData": {
                        "AccessoryPairingID": "xxx",
                        "AccessoryLTPK": "xxx",
                        "iOSDevicePairingID": "xxx",
                        "iOSDeviceLTSK": "xxx",
                        "iOSDeviceLTPK": "xxx"
                    }
                }
            ]
        }
    ]
}

How to fix Known Errors:

if you get the error M2: Error: 6:

1. Add the device to your Homekit
2. Once the device is added and connected to your Wifi network
3. Remove device from your Home
4. Device should still be connected to your Wifi (check it from your router's connected clients)
5. Run the homekitPair command in your Homebridge and enter the pin
6. And voila, you get the JSON

Tested Accesories

(!!! Use at your own risk !!!)

• Quingping Air Monitor Lite (Cleargrass Luftdetektor Lite, Cleargrass Air Monitor Lite)
• Nanoleaf Aurora / Light Panels
• Gardena Smart Control Hub
  • Gardena Smart Irrigation Control
  • Gardena Smart Sensor II

Please let me know if you use this plugin and got it to work with a new HomeKit-Accesory that is not listed above

Building for developers

The project was converted to the build system from https://github.com/homebridge/homebridge-plugin-template. Visual Studio Code is set up to lint on save.

Using npm run dev will launch the develop environment, where your code is automatically compiled on save and the local homebridge server is automatically restarted.

The command npm rund build will trigger the compilation of your project manually.