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

# knxUltimateHueTapDial Node – Tutorial Outline

## 1. Intro (0:00)
- "Hi! Let’s translate Hue Tap Dial rotary gestures into KNX commands using the `knxUltimateHueTapDial` node."
- "Ideal for controlling KNX dimmers or scenes with the rotating knob." 

## 2. Prerequisites (0:20)
- Optional `knxUltimate-config` for ETS CSV lookup.
- Required `hue-config` bridge credentials.
- Hue Tap Dial accessory paired with the bridge.

## 3. Inputs & Outputs (0:40)
- Inputs: none (Hue rotary events feed the node).
- Output: single stream of KNX-ready dimming or step commands.

## 4. KNX Mapping (0:55)
- Select the Group Address to receive rotary actions.
- Choose a DPT: `3.007` for relative dimming, `5.001` for percentage, or `232.600` for custom payloads.
- Name the mapping to reflect the target circuit.

## 5. Hue Device Selection (1:30)
- Autocomplete lists `relative_rotary` resources; choose the correct Tap Dial.
- The node stores the Hue resource ID for future updates.

## 6. Node PINs & Output (1:45)
- **Node PINs**: use the behaviour tab to show or hide the Node-RED pins depending on whether you need a wired output."
- Hidden pins still emit messages, ideal if you link nodes virtually."

## 7. Runtime Behaviour (2:05)
- Clockwise and counterclockwise turns generate positive/negative steps or percentages, depending on DPT.
- Press events are handled by the Hue Button node; this node focuses on the rotary ring.

## 8. Best Practices (2:25)
- Match DPT to the KNX actuator expectations (step vs absolute percentage).
- Use smoothing or ramp functions downstream if required.
- Label the node with the room or load it controls.

## 9. Demo Ideas (2:50)
- Drive a KNX dimmer for dining room lights with the Tap Dial.
- Adjust fan speed or scene brightness by turning the knob.

## 10. Wrap-Up & CTA (3:10)
- "We selected the GA, DPT, and Hue Tap Dial, and explained how rotary gestures flow into KNX."
- "Like and subscribe for more Hue accessory integrations!"