node-red-contrib-knx-ultimate/tutorial/knxUltimateHueLight.md

Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer. Easy to use and highly configurable.

# knxUltimateHueLight Node – Tutorial Outline

## 1. Intro (0:00)
- "Welcome! This tutorial covers the `knxUltimateHueLight` node, the flagship bridge between Philips Hue lights and KNX."
- "We’ll cover on/off, dimming, colour, tunable white, advanced day-night presets, and optional feedback channels."

## 2. Prerequisites (0:25)
- `knxUltimate-config` gateway for ETS integration and secure GA formatting.
- `hue-config` bridge with valid credentials.
- Hue light, outlet, or group already paired and reachable."

## 3. Inputs & Outputs (0:50)
- No inputs or outputs: the node operates as a service orchestrating Hue ↔ KNX synchronisation.
- Hue events are translated to KNX telegrams; KNX commands are forwarded to Hue."

## 4. Basic KNX Mapping (1:10)
- **Switch GA**: on/off control (`1.xxx`).
- **State GA**: readback for KNX LEDs or logic.
- **Dim GA**: relative dimming (`3.007`) with configurable speed and min/max bounds.

## 5. Colour & HSV Controls (1:40)
- **RGB Colour**: GA for HSB/XY control plus state feedback.
- **Hue and Saturation Dimming**: separate GA pairs for changing hue (`HSV_H_DIM`) and saturation (`HSV_S_DIM`).
- Use snippet pickers to populate GAs quickly.

## 6. Tunable White & Kelvin (2:10)
- **Kelvin Dim**: GA for stepping colour temperature (`3.007`).
- **Kelvin Percentage**: relative CCT control (mapped to Hue mired range).
- **Absolute Kelvin**: GA/state for direct Kelvin values (`7.600` or `9.002`).
- Option to invert tunable white dim direction."

## 7. Brightness, Blink, Color Cycle (2:45)
- **Brightness GA**: absolute level in percent.
- **Blink GA**: toggles flashing sequence.
- **Colour Cycle GA**: start/stop Hue dynamic scenes."

## 8. Day/Night Modes (3:10)
- Configure default colour/brightness when the light turns on during day and night.
- Use Kelvin presets or custom RGB values.
- `Daylight Sensor GA` toggles the mode (with optional inversion).
- `Restore Day Mode` toggles let quick double presses revert to day settings."

## 9. Additional Options (3:40)
- **Read Status at Startup**: query Hue state on deploy.
- **Update KNX Brightness Status on Hue On/Off**: keep KNX status tidy.
- **Node PINs**: optional PINS for linking Hue and KNX flows.
- **Min/Max Dim Levels**: clamp KNX values to Hue safe range.
- **Dim Speed / HSV Dim Speed**: set ramp durations (ms).

## 10. Hue Device Selection (4:20)
- Autocomplete lists Hue lights, rooms, or groups.
- Selected device ID is stored and used for subsequent API calls.

## 11. Workflows & Tips (4:40)
- Map KNX rocker buttons to Hue dimming with smooth ramp rates.
- Sync Hue scenes with KNX pushbuttons using colour cycle GA.
- Combine with `knxUltimateAutoResponder` to ensure KNX reads always get a value.
- Use separate status GAs for dashboards or logic modules.

## 12. Demo Ideas (5:10)
- Day/night lighting for living room lamp with default warm presets.
- Hue gradient strip controlling Kelvin percentage from a KNX touch panel.

## 13. Wrap-Up & CTA (5:30)
- "We connected Hue to KNX for on/off, dimming, colour, Kelvin, and dynamic effects."
- "Subscribe, like, and comment with your Hue lighting automations!"