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

# knxUltimateHueCameraMotion Node – Tutorial Outline

## 1. Intro (0:00)
- "Ciao! Today we bridge Philips Hue camera motion events to KNX using the `knxUltimateHueCameraMotion` node."
- "Perfect when you want Hue Secure or Hue camera occupancy to trigger KNX lighting, alarms, or logic."

## 2. Prerequisites (0:20)
- `knxUltimate-config` gateway (recommended) for ETS CSV autocomplete and GA validation.
- `hue-config` bridge with authenticated Hue API access.
- A Hue camera that exposes the motion service and is powered on."

## 3. Inputs & Outputs (0:45)
- Inputs: none; the node subscribes to Hue push updates.
- Output 1: boolean payload representing motion detected vs. clear."

## 4. Hue & KNX Selection (1:05)
- Choose the KNX gateway so the GA dropdown filters to the correct DPTs.
- Pick the Hue bridge, then type the camera name to autocomplete the motion-capable devices.
- The selected Hue resource ID is stored automatically."

## 5. KNX Mapping (1:35)
- **Motion GA**: assign the KNX group address that should receive the motion state (`1.xxx`).
- **DPT Selector**: defaults to boolean types (use `1.001` or `1.004` depending on your ETS semantics).
- **Name Field**: optional label, typically the room or camera description."

## 6. Startup & Pins (2:00)
- **Read Status at Startup**: enable to sync the current Hue state immediately after deploy/reconnect.
- **Node PINs**: show/hide Node-RED pins if you prefer wiring the output directly into flows."

## 7. Runtime Behaviour (2:25)
- The node listens to Hue eventstream updates and outputs `true` when motion is reported, `false` when cleared.
- When Node PINs are hidden the node still emits messages; showing pins allows link or wire connections."

## 8. Best Practices (2:50)
- Debounce or rate-limit the boolean output if your KNX logic requires minimum run times.
- Combine with `knxUltimateHueLightSensor` or `knxUltimateHueLight` for presence-based lighting scenes.
- Keep Hue device names aligned with ETS descriptions for easier autocomplete."

## 9. Demo Ideas (3:20)
- Trigger stairway lights and a KNX voice prompt when the camera detects motion after sunset.
- Feed the payload into a KNX intrusion GA to log camera detections during away mode."

## 10. Wrap-Up & CTA (3:45)
- "We selected the bridge, mapped the GA, enabled startup sync, and reviewed best practices."
- "Iscriviti al canale, lascia un like e scrivi nei commenti come userai i motion event delle Hue cam!"