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

# knxUltimateHueContactSensor Node – Tutorial Outline

## 1. Intro (0:00)
- "Hi again! Let’s bridge Hue contact sensors into KNX with the `knxUltimateHueContactSensor` node."
- "Perfect for doors, windows, and magnetic contacts managed by the Hue ecosystem."

## 2. Prerequisites (0:20)
- KNX gateway (`knxUltimate-config`) for ETS lookup and secure GA formatting.
- Hue bridge (`hue-config`) logged in with API credentials.
- Hue contact sensor paired and visible in the bridge.

## 3. Inputs & Outputs (0:45)
- Inputs: none; Hue push updates feed the node.
- Output: single channel emitting KNX-ready boolean values representing open/closed state.

## 4. KNX Gateway & Hue Bridge Selection (1:05)
- Choose the KNX gateway (optional but recommended) to unlock CSV autocomplete.
- Choose the Hue bridge so the node can query `rtype=contact` resources.

## 5. KNX Mapping (1:25)
- **Group Address**: select the GA that should receive the contact state (`1.xxx`). Autocomplete uses ETS CSV.
- **Name**: label for the GA, populated automatically from the ETS description.
- **Datapoint Type**: choose an appropriate DPT (typically `1.019` window/door or `1.002` boolean). Dropdown automatically lists all `1.xxx` types.

## 6. Hue Device Selection (1:55)
- Start typing the sensor’s name (as seen in Hue app). Autocomplete lists matching devices.
- Selecting one stores the Hue resource ID so the node subscribes to the correct sensor.

## 7. Runtime Behaviour (2:15)
- When the contact changes state, the node outputs a message with the converted boolean value.
- The payload is ready to feed into `knxUltimate` nodes or logic that writes back to the KNX bus.
- Status icon in the node title updates with the configured name for easy identification.

## 8. Best Practices (2:40)
- Match the DPT to the semantics you expect (for example `1.019` for open/close).
- Group window sensors by floor or room using Node-RED link nodes.
- Combine with `knxUltimateAlerter` to notify if doors stay open too long.

## 9. Demo Ideas (3:05)
- Trigger KNX lighting if the patio door opens after sunset.
- Notify the intrusion alarm GA when a Hue contact sensor trips.

## 10. Wrap-Up & CTA (3:30)
- "We selected the gateway, mapped the KNX address, picked the Hue contact, and explored best practices."
- "Subscribe for more Hue-to-KNX tutorials and drop your contact sensor scenarios below!"