homebridge-fibaro-home-center

Homebridge plugin for Fibaro Home Center (2, 2 Lite, 3, 3 Lite, Yubii Home).

Supports devices (Z-wave only, Zigbee not supported), scenes, global variables, security systems, climate / heating zones and exposes them to Homebridge and HomeKit (Apple Home and more).

How it works

This plugin comunicates with Fibaro HC / Yubii Home by the official Fibaro API. Homebridge and HC / Yubii Home should be in the same local network with the same IP address range (same subnet), E.G. 192.168.1.XXX.

You must have an account in HC / Yubii Home. The main account has access to all devices, scenes, etc., for additional accounts you can select what to share.

Results will appear in Homebridge and via HomeKit in your Apple Home app (or other HomeKit app).

Installation

This plugin can be easily installed through Homebridge UI or via NPM "globally" by typing:

npm install -g homebridge-fibaro-home-center

Configuration

Configure the plugin through the settings UI or directly in the JSON editor.

Required:

{
  "platforms": [
    {
        "platform": "FibaroHC",
        "name": "FibaroHC",
        "url": "PUT URL OR IP OF YOUR HOME CENTER HERE CONTAINING PROTOCOL AND NAME E.G.: https://hc-00000XXX.local OR IP E.G.: 192.168.1.100",
        "username": "PUT USERNAME OF YOUR HOME CENTER HERE",
        "password": "PUT PASSWORD OF YOUR HOME CENTER HERE"
    }
  ]
}

• url : url or IP of your Home Center / Yubii Home. Using https may be mandatory if you configured HC to use it. Examples:
  • 192.168.1.100 - replace with your IP
  • https://hc-00000XXX.local - replace with your HC serial, get ca.cer file from HC and put it in Homebridge in same folder as config.json
  • http://hc-00000XXX.local - replace with your HC serial
• username : username of your Home Center / Yubii Home
• password : password of your Home Center / Yubii Home

Advanced settings

{
    "bridge": {
        "name": "Homebridge",
        "username": "CC:22:3D:E3:CE:30",
        "port": 51826,
        "pin": "031-45-154"
    },
    
    "description": "This is an example configuration file. You can use this as a template for creating your own configuration file.",

    "platforms": [
        {
            "platform": "FibaroHC",
            "name": "FibaroHC",
            "url": "PUT URL OR IP OF YOUR HOME CENTER HERE CONTAINING PROTOCOL AND NAME E.G.: https://hc-00000XXX.local OR IP E.G.: 192.168.1.100",
            "username": "PUT USERNAME OF YOUR HOME CENTER HERE",
            "password": "PUT PASSWORD OF YOUR HOME CENTER HERE",
            "pollerperiod": "PUT 0 FOR DISABLING POLLING (REFRESH INTERVAL), 1 - 100 INTERVAL IN SECONDS. 3 SECONDS IS THE DEFAULT",
            "thermostattimeout": "NUMBER OF SECONDS FOR THERMOSTAT TIMEOUT, DEFAULT: 7200 (2 HOURS)"
            "thermostatmaxtemperature": "SET MAX TEMPERATURE FOR THERMOSTATIC DEVICES (DEFAULT 100C)",
            "switchglobalvariables": "PUT A COMMA SEPARATED LIST OF HOME CENTER GLOBAL VARIABLES ACTING LIKE A BISTABLE SWITCH",
            "dimmerglobalvariables": "PUT A COMMA SEPARATED LIST OF HOME CENTER GLOBAL VARIABLES ACTING LIKE A DIMMER",
            "adminUsername": "PUT ADMIN USERNAME OF YOUR HOME CENTER HERE TO SET GLOBAL VARIABLES",
            "adminPassword": "PUT ADMIN PASSWORD OF YOUR HOME CENTER HERE TO SET GLOBAL VARIABLES",
            "securitysystem": "PUT enabled OR disabled IN ORDER TO MANAGE THE AVAILABILITY OF THE SECURITY SYSTEM",
            "addRoomNameToDeviceName" : "PUT enabled OR disabled IN ORDER TO ADD THE ROOM NAME TO DEVICE NAME. DEFAULT disabled",
            "doorbellDeviceId" : "PUT HOME CENTER BINARY SENSOR DEVICE ID ACTING AS A DOORBELL",
            "logsLevel": "PUT THE DESIRED LOG LEVEL: 0 DISABLED, 1 ONLY CHANGES, 2 ALL"
        }
    ],

    "accessories": [
    ]
}

• pollerperiod : Polling interval (refresh interval) for querying Fibaro Home Center (0: disabled, recomended: 3, 1 or 2 seconds allows for a more responsive update of the Home app when changes appear outside the HomeKit environment). If it is disabled the Home app is not updated automatically when such a change happen but only when you close a panel and reopen it. Enabling this option is useful to read the new state when controlling devices outside HomeKit, E.G.: via Fibaro, physical buttons, scenes and automations.
• thermostatmaxtemperature : set max temperature for thermostatic devices (default 100 C)
• thermostattimeout : number of seconds for the thermostat timeout, default: 7200 (2 hours)
• switchglobalvariables : comma separated list of home center global variables acting like a bistable switch
• dimmerglobalvariables : comma separated list of home center global variables acting like a dimmer
• adminUsername: admin username of your home center, needed only to set global variables,
• adminPassword: admin password of your home center, needed only to set global variables,
• securitysystem : enabled or disabled in order to manage the availability of the security system
• addRoomNameToDeviceName : If enabled, to each device name will be added the name of the room in which it is located. Default: disabled.
• doorbellDeviceId : home center binary sensor device id acting as a doorbell
• logsLevel : desired log level: 0 disabled, 1 only changes, 2 all

Individual device settings

The ability to add individual settings for each device. Provide device ID and choose as which device to display. This way you can also add any device that is not currently supported pr exclude device.

• id : device ID (like: 42).
• displayAS : display as: switch, dimmer, etc. or exclude device.

{
  "platforms": [
    {
        "platform": "FibaroHC",
        "name": "FibaroHC",
        "url": "PUT URL OR IP OF YOUR HOME CENTER HERE CONTAINING PROTOCOL AND NAME E.G.: https://hc-00000XXX.local OR IP E.G.: 192.168.1.100",
        "username": "PUT USERNAME OF YOUR HOME CENTER HERE",
        "password": "PUT PASSWORD OF YOUR HOME CENTER HERE",
        "devices": [
                {
                    "id": 42,
                    "displayAs": "switch",
                },
                {
                    "id": 58,
                    "displayAs": "exclude",
                }
            ]
    }
  ]
}

Manuals

Exclude devices

Exclude one or more devices:

• add id of this device in plugin settings and select display as: 'exclude'
• or use a specific user (not an admin one) and grant access to only the needed devices
• or rename the device you want to exclude with an initial _ character.

Warning: If you exclude the device, adding it again will require reconfiguration (assignment to a room, automations, etc.).

Scenes

• Any scene with a name that start with _ will be added to HomeKit as a momentary switch
• Switch name will be same as scene name but without the _.
• Momentary switch means that it will turn off itself after a while.

Global variables

• Switch global variables - It is possible to create Switch in HomeKit with a toggle behaviour:
  • creating global variables (one for each switch) with 2 possible values: "true" and "false"
  • configuring a new parameter ("switchglobalvariables") in config.json that contains a comma separated list of the variable names you defined.
• Dimmer global variables - It is possible to create Dimmer in HomeKit with a toggle behaviour:
  • creating global variables (one for each dimmer) with possible values from 0 to 100
  • configuring a new parameter ("dimmerglobalvariables") in config.json that contains a comma separated list of the variable names you defined.
• You can use these variable to trigger Home Center scenes.
• Note: you need to configure homebridge in config.json with a user with superuser privileges because normal users cannot set global variable from the outside of Home Center.

Security System

• Enable security system in plugin settings or in config.json add the parameter: "securitysystem": "enabled"

• In Fibaro Home Center:

  • Create an Enumerated variable named SecuritySystem with the following values:

    • StayArmed
    • AwayArmed
    • NightArmed
    • Disarmed
    • AlarmTriggered

  • Create the following Alarm Zones in the Alarm Zones panel in the settings section (order is important): . StayZone . AwayZone . NightZone

  • For each security zone select the appropriate sensors.

  • Create a SetAlarmTriggered scene in the Alarm Scenes panel in the settings section that set the SecuritySystem variable to AlarmTriggered. The scene can also contain action logic to manage the alarm, eg: activate a siren.

  • Create a scene for setting arming status of devices and update the previous global variable. Scene names and code MUST be:

    • SetStayArmed:

        fibaro.alarm("disarm")
        fibaro.alarm(1, "arm")
        fibaro.setGlobalVariable("SecuritySystem", "StayArmed")
      

    • SetAwayArmed

        fibaro.alarm("disarm")
        fibaro.alarm(2, "arm")
        fibaro.setGlobalVariable("SecuritySystem", "AwayArmed")
      

    • SetNightArmed

        fibaro.alarm("disarm")
        fibaro.alarm(3, "arm")
        fibaro.setGlobalVariable("SecuritySystem", "NightArmed")
      

    • SetDisarmed

        fibaro.alarm("disarm")
        fibaro.setGlobalVariable("SecuritySystem", "Disarmed")
      

  • Scene must have flag Do not stop scene when alarm breached checked, in recent versions it's Allow to run when alarm breached.

Climate / Heating zones

• Thermostat Controls: once a climate / heating zone is created in the Home Center / Yubii Home, a corresponding Thermostat accessory is generated in HomeKit. The Thermostat accessory provides intuitive controls within the HomeKit ecosystem.
• Manual Settings and Timeout: the controls available on the Thermostat activate a manual setting for the specified duration. This duration is set by the thermostattimeout parameter in the config.json file. During this period, the manual settings remain in effect for the zone. After the predefined timeout period expires, the normal schedule of the zone is automatically reactivated. This ensures that the zone reverts to its programmed schedule once the manual setting duration elapses.

Child bridge mode

You can run this plugin as child bridge, that is an isolated process. There are several reasons/benefits of doing this. Details: https://github.com/homebridge/homebridge/wiki/Child-Bridges.

Troubleshooting

The device is displayed incorrectly or doesn't display at all

• If device displays incorrectly (e.g. as Switch but should be Outlet) or doubled (one device is displayed as two), you must remove this device from cache (in Homebridge Settings). Unfortunately, in this case, the settings for this device will most likely be lost (room selection, automations, etc.).
• Every change of devices display type (e.g. from Switch to Outlet etc.) can make it display incorrectly (like doubled). It is recommended to turn off Apple hubs during changes.

Get API response for device

Open in browser: http://FIBARO-IP/api/devices/DEVICE-ID (replace FIBARO-IP with your Home Center IP and DEVICE-ID with device ID) and login. Device ID you can check in Fibaro panel or directly in HomeKit device information (serial number field).

More logs

If you have any issues with this plugin, enable all logs in plugin config and the debug mode in the homebridge settings and restart the homebridge / child bridge. This will show additional information in log.

Contributing and support

• Feel free to create Issue or Pull Request

Disclaimer

• This is not the official Fibaro plugin. The plugin uses the official API. Despite the efforts made, the operation of the plugin is without any guarantees and at your own risk.

Latest release notes

Version 2.0.0

Warning! Read carefully before updating!

• The ability to add individual settings for each device. Provide device ID and choose as which device to display. This way you can also add any device that is currently not supported or exclude device.
• Improved mechanism of device detection to support more new devices.
• Check device ID directly in HomeKit accessory information (in device serial number field).
• Removed Advanced Control. If you have Advanced Control enabled before the update, nothing will change, if not, some devices can change the way they are displayed (this may require removal from the cache in Homebridge settings and/or reconfiguration in HomeKit). Now you can individually change the way that each device display.
• Bump dependencies.

Version 1.7.5

• Added new Fibaro "Roller Shutter com.fibaro.FGR224"
• Bump dependencies

Version 1.7.4

• Manage Satel motion sensor
• Manage heating/climate zone id collision
• Small refactoring
• Bump dependencies

See all: Releases