Home

Welcome to 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,
                "pin": "1234"
            },
            "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
pin	Optional PIN if it was assigned to the lock in HmIP app (Settings / Access authorizations).	none

Example:

            "3014F711A000xxxxxxxxxxEF": {
                "openLatch": true
            },