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
            },

HmIP-MOD

Parameter	Description	Default
lightSwitch	Enables or removes optional light switch from accessory.	true

Example:

            "3014F711A000xxxxxxxxxxEF": {
                "lightSwitch": false
            },

Wall Thermostats (HMIP-WTH-2, HmIP-STHD, HmIP-STH, etc.)

Parameter	Description	Default
asClimateSensor	Hide the temperature controls and identify the device as a climate sensor only.	false

Example:

            "3014F711A000xxxxxxxxxxxx": {
                "asClimateSensor": true
            },

HmIP-BSL

Parameter	Description	Default
simpleSwitch	True removes the two lightbulb services (top and bottom light) from the accessory.	false

Example:

            "3014F711A000xxxxxxxxxxxx": {
                "simpleSwitch": true
            },