test-test-homebridge-fibaro-home-center v1.0.3

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

• 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

• 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.

• 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.).

• Use different device names within the same room.

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

• 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.

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.