test-test-homebridge-fibaro-home-center

homebridge-fibaro-home-center

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

Installation

This plugin can be easily installed and configured 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:

Required: url or host, username and password

• url : url of your Home Center / Yubii Home, examples:
  • https://hc-00000XXX.local (put ca.cer file in the same folder as config.json)
  • http://hc-00000XXX.local
• host : IP address of your Home Center / Yubii Home, E.G.: 192.168.1.100 , host field is ignored if field url is filled
• username : username of your Home Center / Yubii Home
• password : password of your Home Center / Yubii Home

Optional:

• pollerperiod : 0 for disabling polling, 1 - 100 interval in seconds, 2 seconds is the default
• 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
• securitysystem : enabled or disabled in order to manage the availability of the security system
• addroomnametodevicename : enabled or disabled in order to add the room name to device name. default disabled, use different device names within the same room
• doorbelldeviceid : home center binary sensor device id acting as a doorbell
• logslevel : desired log level: 0 disabled, 1 only changes, 2 all
• advcontrol : enable if you want the device type in homekit to depend on how the device role in fibaro is selected. 0-disabled, 1-enabled

Example: config.json

Troubleshooting

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

• For some devices, responsible for the display method is field Role (for a given device in the Fibaro Panel). Check Advanced Control.
• If device still 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.
• If you want new device to be supported (or if it displays incorrectly despite the recommendation above) open new Issue and write: what is this product, as what should it be displayed, whether it does not display at all or displays incorrectly (as what device?), what version of this plugin, what Home Center, and attach the API response for this product (see below).

Advanced Control

• Now you can enable new option in plugin settings if you want the device type in Homekit to depend on how the device role in Fibaro is selected. See details: advanced control

Get API response for device

• How to get API response for device. Open in browser: http://FIBARO-IP/api/devices/ID (replace FIBARO-IP with your Home Center IP and ID with device ID) and login.

Exclude devices

• If You want to exclude one or more devices: 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.).

Add room name to device name

• Use different device names within the same room.

Adding scenes as momentary switches

• Any scenes with a name that start with _ will be added to HomeKit as a momentary switch with the same name without the _.

Switch accessories mapped on Home Center global variables

• It is possible to create Switch accessories on HomeKit with a toggle behaviour by:
  • 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.
• You can use these variable to trigger Home Center scenes.
• Known issue: 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.

Fibaro Security System configuration for HomeKit

See: security system

Latest release notes

Version 1.5.1

• Fix bug causing endless rastarting Homebridge when unable to connect to Home Center / Yubii Home
• Adding a delay (1 minute) in the next attempt to read data (in case of failure)
• Adding a delay (5 minutes) in the next attempt to first login (in case of failure)
• Fix bug in the dimmers
• Added the ability to select in the config thermostat max temperature

Version 1.5.0

• New option to enable in plugin settings: Advanced Control. Enable it if you want the device type in Homekit to depend on how the device role in Fibaro is selected. Details: Advanced Control page.
• New settings view: divided into sections.