search

marcsowen / homebridge-homematicip

Homematic IP plugin for homebridge
Apache License 2.0
77 stars 20 forks source link

readme

homebridge-homematicip

npm npm GitHub last commit GitHub build

Homematic IP platform plugin for homebridge

Uses the unofficial HTTP API and WebSockets for continuous channel updates.

Add one (or more) Homematic IP Access Points to config.json. There are two configuration options that you can set:

{
    "platform": "HomematicIP",
    "name": "HomematicIP",
    "access_point": "<your access point ID>",
    "auth_token": "<your API auth token>"
}

The Access Point ID is printed on the back of your Homematic IP Access Point (HmIP-HAP) and is labeled as "SGTIN", e.g. 3014-xxxx-xxxx-xxxx-xxxx-xxxx.

Pairing

{
    "platform": "HomematicIP",
    "name": "HomematicIP",
    "access_point": "<your access point ID>",
    "pin": "<your PIN if set in the app>"
}

If you do not have an auth_token or don't know it, leave it empty. Be sure to add the "pin" property if it is set in the app. After startup, watch the logs and wait for "Press blue, glowing link button of HmIP Access Point now!". Then press the button and note the "auth_token" that is being generated, add it to your config.json, remove the pin and restart.

Additional config

See Wiki for details.

Currently supported devices

[1] Currently, only first channel is supported.
[2] Please make sure homebridge-homematicip is added to the list of access control clients in HmIP app settings.

TODOs

Many thanks to our contributors

Help needed!