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

# knxUltimateHueZigbeeConnectivity Node – Tutorial Outline

## 1. Intro (0:00)
- "Hi! Let’s monitor Hue device connectivity in KNX using the `knxUltimateHueZigbeeConnectivity` node."
- "Great for checking whether Hue devices are online or if the mesh loses contact."

## 2. Prerequisites (0:20)
- Optional `knxUltimate-config` gateway for ETS lookup.
- Required `hue-config` bridge credentials.
- Hue device with Zigbee connectivity resource (e.g., plug, light, sensor)."

## 3. Inputs & Outputs (0:40)
- Inputs: none.
- Output: single boolean payload representing connectivity status (typically reachable/unreachable)."

## 4. KNX Mapping (0:55)
- Select the GA for connectivity monitoring (`1.xxx`). Autocomplete filters to boolean DPTs.
- Name the GA using ETS metadata (e.g., “Kitchen Light Connectivity”).
- Choose the DPT: typically `1.001` (switch) or `1.005` (alarm)."

## 5. Hue Device Selection (1:25)
- Autocomplete lists `rtype=zigbee_connectivity` entries; pick the device to monitor.
- The node stores the Hue resource ID and subscribes to state changes."

## 6. Startup Options & Node PINs (1:45)
- **Read Status at Startup**: fetch the current connectivity immediately after deployment so KNX widgets start with the right state."
- **Node PINs**: show or hide the Node-RED pins; hiding keeps the node compact while still emitting messages."

## 7. Runtime Behaviour (2:05)
- Hue reports connectivity as `connected` or `disconnected`; the node maps it to `true/false`.
- Feed the output into KNX boolean sensors or logic to trigger alerts or disable automations."

## 8. Best Practices (2:25)
- Pair with `knxUltimateAlerter` to notify when devices drop offline for extended periods.
- Label nodes with device type and room to speed troubleshooting.
- Use secure formatting if your KNX gateway enforces secure addresses."

## 9. Demo Ideas (2:50)
- Notify maintenance when a Hue plug becomes unreachable.
- Automatically switch KNX fallback lighting when a Hue strip disconnects."

## 10. Wrap-Up & CTA (3:10)
- "We mapped the GA, selected the Hue device, and explained how connectivity states flow into KNX."
- "Subscribe and share how you monitor Zigbee health in your install!"