Philips Hue

Each interface in Antcas Control supports a maximum of one gateway. Currently, only devices and groups are supported.

Note: The older Bridge 1 is also still supported. Here the protocol must be set to HTTP in the gateway.

Setting Up the Interface

To communicate with the bridge, follow these steps:

Set up the system with the Hue app
Fix the IP of the bridge from the DHCP server
Search for the bridge and add the gateway
Then press the button on the gateway to register the gateway
The authentication is automatically written in the gateway
Now all devices appear in the installation

Groups

To also control groups, this function must be activated in the gateway. This makes the transmission somewhat slower but can bring a great advantage with many lights. The groups are assigned absolutely by name. If a name is later changed in the Hue app, that group and its assignment will be removed.

Create Channels

In the device structure, channels can be created. For these to be created, various prerequisites must be met.

Types	Prerequisite
Light	The light must be visible in the structure.
RGB Light	The light must be visible in the structure. In addition, at least Hue or XY must be available.

Monitor

The monitor can be found under Installation ▸ Wireless ▸ Philips Hue ▸ Monitor.

The target register can contain the following values:

Target	Description
Server	Value received from the bridge to the PLC.
Bridge	The command was directly received by the bridge.
Cache	The value was cached because the light is off. This value is sent to the PLC when the light is turned on. If an ON value is received, the cache is deleted.

Possible Variables

All available values are read from the bridge. It may happen that lights from third-party manufacturers do not support all communication variables.

Variable	Data Type	Description
switch	bool	Turns the light on or off.
dim	uint	Dims the light and turns it on if necessary. The value range is between 0 to 254.
sat	uint	Sets the saturation of the light. The value range is between 0 to 254.
hue	uint	Sets the color (angle of the color circle) of the light. The value range is between 0 to 65'535.
xy	string	Sets the color based on coordinates. The values are between 0 and 1 and are passed as a string separated by a semicolon. E.g.: 0.409;0.5179
temp	uint	Sets the color temperature of the light. The value is between 153 (6500K) to 500 (2000K).
online	bool	The value is true if the light can be reached by the bridge.

Templates

To make the integration of Philips Hue easy, we provide templates. These must each be imported.

Note: The templates for RGB lights cannot be imported into lights without RGB and vice versa.

Lights

Type	Description
Switch	Light only with switch command.
Dim	Light with dimming range 0..254
Dim & Temp	Light with dimming range 0..254 and color temperature

RGB Lights

Type	Description
RGB	RGB light with RGB control
RGB & Temp	RGB light with color temperature
XY	XY light converted to RGB
XY & Temp	XY light with color temperature