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

# knxUltimateHueLightSensor Node – Tutorial Outline

## 1. Intro (0:00)
- "Welcome! Let’s transport Hue ambient light readings into KNX using the `knxUltimateHueLightSensor` node."
- "Ideal for automations that adjust KNX lighting or blinds based on measured lux levels."

## 2. Prerequisites (0:20)
- Optional `knxUltimate-config` gateway for ETS integration.
- Required `hue-config` bridge credentials.
- Hue light level sensor paired with the bridge."

## 3. Inputs & Outputs (0:40)
- Inputs: none (Hue events feed the node).
- Output: single channel emitting lux values as KNX datapoint `9.004` (lux)."

## 4. KNX Mapping (1:00)
- Select Group Address for light level sensor—autocomplete filters to DPT `9.004`.
- Name the sensor channel (auto-populated from ETS metadata).
- Confirm the DPT choice; default list contains only `9.004.x`."

## 5. Hue Device Selection (1:35)
- Begin typing the Hue sensor name; autocomplete lists `rtype=light_level` resources.
- Selected device ID is stored for future updates."

## 6. Startup Options & Node PINs (1:55)
- **Read Status at Startup**: request the current lux value when Node-RED deploys so KNX has a baseline.
- **Node PINs**: toggle visibility of the output pin if you want to wire the stream directly; hidden pins still emit messages."

## 7. Runtime Behaviour (2:20)
- Hue lux readings are converted from `mirek`-style units to actual lux (the node handles scaling).
- Value is emitted as a numeric payload ready for `knxUltimate` write nodes, dashboards, or logic flows."

## 8. Best Practices (2:45)
- Smooth sudden changes using a function or RBE before writing back to KNX to avoid flicker."
- Combine with the `knxUltimateWatchDog` to alert when light levels stay high/low unexpectedly."
- Document the placement (indoors/outdoors) in the node name for easy maintenance."

## 9. Demo Ideas (3:05)
- Adjust KNX dimming scenes based on lux threshold (e.g., lower blinds at >30,000 lux)."
- Use the sensor to drive corridor lighting when natural light drops below 50 lux."

## 10. Wrap-Up & CTA (3:30)
- "We linked the bridge, mapped the GA, enabled startup reads, and explored usage ideas."
- "Like and subscribe for more Hue sensor integrations with KNX.""