node-red-contrib-knx-ultimate/tutorial/knxUltimateHueScene.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.

# knxUltimateHueScene Node – Tutorial Outline

## 1. Intro (0:00)
- "Hello! Today we automate Philips Hue scenes from KNX via the `knxUltimateHueScene` node."
- "We’ll cover single-scene triggers, status feedback, and multi-scene selection."

## 2. Requirements (0:20)
- Optional `knxUltimate-config` gateway for ETS autocomplete.
- Required `hue-config` node with valid Hue credentials.
- Hue room/zone scenes already created in the Hue app."

## 3. Multiple Operating Modes (0:45)
- **Single Scene Mode**: fire one Hue scene from a KNX boolean or scene GA.
- **Multi Scene Mode**: select among up to 64 scenes using a scene number GA (DPT `18.xxx`).
- Tabs in the editor switch between these modes (`selectedModeTabNumber`)."

## 4. Single Scene Mapping (1:10)
- **Trigger GA**: choose GA and DPT (`1.xxx` or `18.xxx`). Autocomplete filters to valid datapoints.
- **Scene Number / Value**: pick scene index (1–64) or set boolean true/false trigger, depending on DPT.
- **Status GA**: optional GA to reflect back whether the scene is active.
- **Hue Scene Recall Type**: choose `active` (instant apply) or `dynamic` (gradual)."

## 5. Multi Scene Mapping (1:45)
- **Scene Selector GA**: expects DPT `18.xxx` (scene number).
- **Rule Table**: map incoming values to Hue scene IDs with editable list rows.
- **Name**: label the multi-scene channel for clarity.

## 6. KNX & Hue Autocomplete (2:10)
- ETS CSV suggestions fill GA, DPT, and descriptive names automatically.
- Hue resource picker lists scenes available on the selected bridge and room; stored ID is used for recall.

## 7. Node PINs & IO (2:30)
- `enableNodePINS` exposes Node-RED pins for linking additional logic.
- Node has no standard inputs/outputs; it works as a service executing scene recalls."

## 8. Runtime Behaviour (2:50)
- KNX triggers call the Hue API to activate the specified scene.
- Optional status GA updates allow KNX LEDs or panels to reflect the current scene.
- Multi-scene mode can drive animated loops or lightning sequences from KNX logic."

## 9. Best Practices (3:15)
- Document which Hue room or zone each node controls.
- Keep KNX scene numbers aligned with ETS assignments to avoid confusion.
- Use `restoreDayMode` in companion Hue light nodes to blend scenes with day/night behaviour."

## 10. Demo Ideas (3:40)
- Map KNX scene buttons to Hue “Relax”, “Concentrate”, and “Nightlight”.
- Use a KNX slider to send scene numbers and cycle through Hue dynamic scenes."

## 11. Wrap-Up & CTA (4:05)
- "We configured single-scene triggers, multi-scene rules, and status feedback."
- "Like and subscribe for more Hue scene automation tips, and share your favourite scene setups!"