HUE Light - Supergiovane/node-red-contrib-knx-ultimate GitHub Wiki
🌐 Language: EN | IT | DE | FR | ES | 简体中文
Navigation: Home Overview: Changelog • FAQ • Security • Docs: Language bar KNX Device: Gateway • Device • Protections Other KNX Nodes: Scene Controller • WatchDog • Logger • Global Context • Alerter • Load Control • Viewer • Auto Responder • HA Translator • IoT Bridge HUE: Bridge • Light • Battery • Button • Contact • Device SW update • Light sensor • Motion • Scene • Tap Dial • Temperature • Zigbee connectivity Samples: Logger • Switch Light • Dimming • RGB color • RGBW color + White • Command a scene actuator • Datapoint 213.x 4x Setpoint • Datapoint 222.x 3x Setpoint • Datapoint 237.x DALI diags • Datapoint 2.x 1 bit proprity • Datapoint 22.x RCHH Status • Datetime to BUS • Read Status • Virtual Device • Subtype decoded • Alexa • Apple Homekit • Google Home • Switch on/off POE port of Unifi switch • Set configuration by msg • Scene Controller node • WatchDog node • Global Context node • Alerter node • Load control node • Viewer node • MySQL, InfluxDB, MQTT Sample Contribute to Wiki: Link
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") |
| Override night mode | You can override the night 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
|
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.
