Skip to content
Marc Sowen edited this page Dec 21, 2021 · 11 revisions

Welcome to the homebridge-homematicip!

Per device config

HmIP devices can be configured by adding a devices sections to your config.json file, e.g.

{
    "bridge": {
        "name": "Homebridge",
        "username": "0E:47:xx:xx:xx:xx",
        "port": 51355,
        "pin": "xxx-xx-xxx",
        "advertiser": "ciao"
    },
    "platforms": [{
        "platform": "HomematicIP",
        "name": "HomematicIP",
        "access_point": "3014F711A000xxxxxxxxxxxx",
        "auth_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "devices": {
            "HOME_SECURITY_SYSTEM": {
                "hide": true
            },
            "3014F711A000xxxxxxxxxxEF": {
                "openLatch": true
            },
            "3014F711A000xxxxxxxxxx22": {
                "hide": true
            }
        }
    }]
}

All devices can be identified by their SGTIN which is the first property (without dashes, all-capital letters). One exception is the Home Security System which is just a pseudo device and therefore has a special SGTIN (HOME_SECURITY_SYSTEM).

The devices can be removed by adding a "hide"-Property and setting it to true. After restart, the device will be removed from the HomeKit-Database. The property defaults to false therefore by default, all known devices will be added.

Some devices have device specific properties:

HmIP-DLD

Parameter Description Default
openLatch When unlocking, the lock will be unlocked and the latch will be pulled so the door will jump open. false

Example:

            "3014F711A000xxxxxxxxxxEF": {
                "openLatch": true
            },
Clone this wiki locally