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

# knxUltimateHueBattery Node – Tutorial Outline

## 1. Intro (0:00)
- "Hi! In this video we connect Philips Hue battery status to KNX using the `knxUltimateHueBattery` node."
- "We’ll map the Hue power resource to a KNX percentage and optionally a KNX notification address."

## 2. Inputs & Outputs (0:20)
- "No inputs."
- "One output emitting KNX-friendly battery updates (0–100%)."

## 3. Required Config Nodes (0:35)
- **KNX Gateway**: optional but recommended for ETS CSV autocomplete and secure GA highlighting."
- **Hue Bridge**: mandatory `hue-config` node with valid credentials."

## 4. Selecting the Hue Device (0:55)
- "Start typing the Hue device name; autocomplete lists all `device_power` resources."
- "Once selected, the Hue resource ID is stored in the hidden field."

## 5. Mapping to KNX (1:15)
- **Group Address**: choose the KNX group address that should carry the battery percentage. Autocomplete uses your ETS CSV."
- **Datapoint Type**: typically `5.001` (percentage). The dropdown is filtered automatically."
- **Name**: give the KNX datapoint a descriptive label."

## 6. Startup Options & Node PINs (1:40)
- **Read Status at Startup**: enable to fetch the current battery value when Node-RED deploys so KNX dashboards start with a valid reading."
- **Node PINs**: toggle the `enableNodePINS` selector to hide/show the Node-RED pins depending on whether you want to wire the output."

## 7. How Updates Flow (2:05)
- "The node listens to Hue push updates (or polls if required) and converts the reported percentage to the configured DPT."
- "Whenever the value changes, the node emits a message for the KNX bus to consume via a `knxUltimate` node or logging flow."

## 8. Best Practices (2:30)
- "Pair this node with `knxUltimateAutoResponder` so read requests always receive the last percentage."
- "Use the output to trigger KNX maintenance reminders when batteries fall below thresholds."
- "Keep device names in sync with your Hue app for easier autocomplete."

## 9. Demo Ideas (3:00)
- "Trigger a KNX notification whenever a sensor drops below 20%."
- "Log battery history with `knxUltimateLogger` for monthly maintenance reviews."

## 10. Wrap-Up & CTA (3:35)
- "We linked the Hue bridge, selected a device, mapped the group address, and enabled initial reads."
- "Subscribe for the next Hue-to-KNX walkthrough and share your monitoring scenarios in the comments!"