This node controls Philips HUE lights (single or grouped) and maps their commands/states to KNX.

General

Property Description
KNX GW Select the KNX gateway to be used
HUE Bridge Select the HUE Bridge to be used
Name HUE light or grouped light to use (autocomplete while typing).

Locate device

Use the Locate button (play icon) to start a Hue identify session for the selected resource. While the session is active the button switches to a stop icon and the bridge makes the light โ€” or every light in the grouped resource โ€” blink once per second. Press the button again to stop immediately; otherwise the session ends automatically after 10 minutes.

OPTIONS

Here you can link KNX Group Addresses to the available HUE commands/states.

Start typing in the GA field (name or Group Address); suggestions appear while you type.

Switch

Property Description
Control This GA is used to turn on/off the HUE light via a boolean KNX value true/false
Status Link this to the lightโ€™s switch status group address

Dim

Property Description
Control dim Relative DIM of the HUE light. You can set the dimming speed in the Behaviour tab.
Control % Changes the absolute HUE lightโ€™s brightness (0-100%)
Status % Link this to the lightโ€™s brightness status KNX group address
Dim Speed (ms) Dimming speed in milliseconds. Applies to both the light brightness and the tunableโ€‘white datapoints. Calculated over the 0%โ†’100% range.
Min Dim brightness Tha Minimum brightness that the lamp can reach. For example, if you are dimming the light down, the light will stop dimming at the specified brightness %.
Max Dim brightness Tha Maximum brightness that the lamp can reach. For example, if you are dimming the light up, the light will stop dimming at the specified brightness %.

Tunable White

Property Description
Control dim Change white temperature using DPT 3.007 dimming. Speed is set in the Behaviour tab.
Control % Change white temperature using DPT 5.001. 0 = full warm, 100 = full cold.
Status % Temperature status GA. DPT 5.001 absolute value: 0 = full warm, 100 = full cold.
Control kelvin **DPT 7.600: ** set temperature in Kelvin using the KNX range 2000-6535 (converted to HUE mirek).
DPT 9.002: set temperature using HUE range 2000-6535 K (Ambiance starts at 2200 K). Conversions may introduce small deviations. ย 
Status kelvin **DPT 7.600: ** read temperature in Kelvin using KNX range 2000-6535 (converted from HUE).
DPT 9.002: read temperature using HUE range 2000-6535 K (Ambiance starts at 2200 K). Conversions may introduce small deviations. ย 
Invert dim direction Inverts the DIM direction.

RGB/HSV

Property Description
RGB section ย 
Control rgb Change color using RGB triplet (r,g,b). Gamut correction is handled. Sending a color turns the light on and sets color/brightness (perceptual). Sending r,g,b = 0 turns the light off.
Status rgb The lightโ€™s color status group address. Accepted datapoint is RGB triplet (r,g,b)
HSV section ย 
Color H dim Cycle through HSV hue using DPT 3.007 dimming. Speed is set in the Behaviour tab.
Status H % Status of the HSV chromatic circle.
Control S dim Changes the lightโ€™s color saturation, using DPT 3.007 dimming. You can set the dimming speed in the Behaviour tab.
Status S % The light color saturation status group address.
Dim Speed (ms) The dimming speed, in Milliseconds, from bottom to top scale.

For controlling the HSV โ€œVโ€ (brightness), use the standard controls under the Dim tab.

Effects

Non-Hue basic effects

Property Description
Blink true Blink the light, false Stop blinking. Blinks the light on and off. Useful for signalling. Works with all HUE lights.
Color Cycle true start cycle, false Stop cycle. Randomly changes the HUE lightโ€™s color at regular interval. Works with all HUE lights having color capabilities. The color effect will start 10 seconds after set.

Hue native effects

Use the Hue native effects table to map your KNX values to the effects supported by the selected light (for example candle, fireplace, prism). Each row links a KNX value (boolean, numeric or textual, depending on the datapoint you pick) with a Hue effect. On the KNX side you can:

  • send the mapped value to activate that effect;
  • optionally provide a status Group Address: the node emits the mapped value whenever the Hue bridge reports an effect change; if no mapping exists the raw effect name is sent (requires a textual DPT such as 16.xxx).

Behaviour

| Property | Description | | โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€“ | โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”- | | Read status at startup | Read the HUE light status at node-redโ€™s startup or node-redโ€™s full deploy, and send that status to the KNX BUS | | KNX Brightness Status | Updates the KNX brightness group address status, whenever the HUE lamp is switched ON/OFF. The options are When HUE light is Off send 0%. When HUE On, restore previous value (Default KNX behaviour) ** andLeave as is (default HUE behaviour) ** . If you have KNX dimmer with brightness status, like MDT, the suggested option is When HUE light is Off send 0%. When HUE On, restore previous value (Default KNX behaviour) _ | | Switch on behaviour | It sets the behaviour of your lights when switched on. You can choose from differents behaviours. Select color: ** the light will be switched on with the color of your choice. To change color, just CLICK on the color selector (under the _Select color_ control). **Select temperature and brightness: ** the light will be switched on with the temperature (Kelvin) and brightness (0-100) of your choice. **None: the light will retain its last status. In case youโ€™ve enable the night lighting, after the night time ends, the lamp will resume the color/temperature/brightness state set at day time. | | Night Lighting | It allows to set a particular light color/brightness at nighttime. The options are the same as the daytime. You could select either a temperature/brightness or color. A cozy temperature of 2700 Kelvin, with a brightness of 10% or 20%, is a good choice for bathroomโ€™s night light.| | Day/Night | Select the group address used to set the day/night behaviour. The group address value is _true if daytime, false if nighttime. | | Invert day/night value | Invert the values of Day/Night group address. Default value is unchecked . | | Read status at startup | Read the status at startup and emit the event to the KNX bus at startup/reconnection. (Default โ€œnoโ€)| | Force day mode | You can force the day mode by manually switching the light as described here: Switch to DAY mode by rapid switching the ligth off then on (This light only) ** does what described and acts only on this light.Switch to DAY mode by rapid switching the ligth off then on (apply yo ALL light nodes)** acts to ALL Light nodes, by setting the Day/Night group address to Day mode. | | Node Input/Output PINs | Hide or show the input/output PINs. Input/output PINS allow the node to accept msg input from the flow and send msg output to the flow. Input msg must follow the HUE API v.2 Standards. This is an example msg, that turns on the light: msg.on = {"on":true}. Please refer to the official HUE Api page |

Note

The Dimming function works in KNX mode start andstop ** . To start dimming, send only one โ€œstartโ€ KNX telegram. To stop dimming, send a โ€œstopโ€ KNX telegram. Pleaseremember that** , when you set your wall swiches properties.