Hue

From HSYCO
Jump to navigation Jump to search

HSYCO integrates the Philips Hue wireless bulbs through their bridge device connected to the local network.

HSYCO Configuration

Add a HUE I/O Server in the I/O Servers section of the Settings and set its parameters:

High Availability

  • Shutdown when inactive: defaults to false.

Options

ID Default Values Description
startupevents false true generate IO events also during the driver’s start-up phase
false start generating events only after HSYCO is aligned with the current status of the system
mac <mac_address> if specified, the driver will connect to the bridge device with the corresponding MAC address. If not specified this driver will connect to the first bridge found on the local network
pollinterval 10 n > 0 the data acquisition interval, in seconds

Setup

The first time HSYCO connects to the Hue bridge, an authentication procedure is required. Configure the HUE I/O Server as described above and restart HSYCO. After few seconds the datapoint 'authentication' of the I/O Server will be set to '1'. At this point you have 30 seconds to manually press the button on the Hue bridge. From now on, HSYCO is authenticated and this procedure will be no longer needed.

N.B. the authentication is linked to the ID assigned to the HUE I/O Server. Changing the ID will require performing the authentication procedure again.

Datapoints

Each Hue bridge can be connected to up to 50 light bulbs. Each bulb is assigned a numeric ID by the bridge. The driver generates several datapoints for each bulb having the prefix 'light.<n>', where <n> is the numeric ID of the bulb.

ID Value R/W Description
connection online R connection established
offline R HSYCO can't connect to the device
light.<n>.on 1 R the light <n> is on
W turn on light <n>
0 R the light <n> is off
W turn off light <n>
flip W invert the state of light <n>
light.<n>.reachable 1 R the light <n> is connected to the bridge
0 R the light <n> is out of reach
light.<n>.brightness 1 ... 254 R the brightness of light <n> is set to the reported value
W set the brightness of light <n> to the specified value
light.<n>.color.xy <x>:<y> R the color of light <n> is set to the reported value (expressed as coordinates of the CIE color space, e.g. "0.4595:0.4105")
W set the color of light <n> to the specified value (expressed as coordinates of the CIE color space, e.g. "0.4595:0.4105") or to the closest available approximation
light.<n>.color.rgb <rrggbb> R the color of light <n> is set to the reported value (expressed as RGB hexadecimal value, e.g. "12e5ff")
W set the color of light <n> to the specified value (expressed as RGB hexadecimal value, e.g. "12e5ff") or to the closest available approximation
light.<n>.color.saturation 0 ... 254 R the color saturation of light <n> is set to the reported value
W set the color saturation of light <n> to the specified value
light.<n>.color.hue 0 ... 65535 R the color hue of light <n> is set to the reported value
W set the color hue of light <n> to the specified value
light.<n>.color.temperature 153 ... 500 R the color temperature of light <n> is set to the reported value
W set the color temperature of light <n> to the specified value

User Interface

UISET Actions

ID Attribute Set to

USER Commands

Name Param Action

Release Notes

3.5.0

  • initial release


Philips and Philips Hue are registered trademarks of Koninklijke Philips N.V.