Hue
HSYCO integrates the Philips Hue wireless bulbs through their bridge device connected to the local network.
Contents
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.
