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

# knxUltimateHueHumiditySensor Node – Tutorial Outline

## 1. Intro (0:00)
- "Benvenuti! In questo video portiamo l'umidita relativa dai sensori Hue in KNX con il nodo `knxUltimateHueHumiditySensor`."
- "Ideale per ventilazione, comfort ambientale o notifiche di condensa gestite dal tuo impianto KNX."

## 2. Prerequisiti (0:20)
- `knxUltimate-config` gateway (opzionale ma consigliato) per autocomplete ETS.
- `hue-config` bridge con token gia autorizzato.
- Sensore Hue di umidita o multi-sensore con canale humidity attivo."

## 3. Input & Output (0:45)
- Nessun input: Hue push updates alimentano il nodo.
- Output 1: payload numerico in percentuale (% RH)."

## 4. Selezione di Hue e KNX (1:05)
- Scegli il gateway KNX per filtrare i DPT corretti.
- Scegli la Hue bridge, poi digita il nome del sensore per l'autocomplete.
- Il nodo memorizza automaticamente l'ID della risorsa Hue."

## 5. Mappatura KNX (1:35)
- **Humidity GA**: assegna l'indirizzo di gruppo che ricevera l'umidita.
- **DPT**: la lista propone `9.007` (umidita relativa); scegli quello coerente con ETS.
- **Nome**: etichetta in chiaro per riconoscere il canale."

## 6. Opzioni di Startup & PIN (2:00)
- **Read Status at Startup**: interroga la Hue bridge all'avvio per avere subito un valore.
- **Node PINs**: mostra o nascondi i pin Node-RED in base a come colleghi i flussi."

## 7. Comportamento Runtime (2:25)
- Ogni nuovo valore Hue viene convertito in percentuale e inviato su `msg.payload`.
- Quando i pin sono disattivati il nodo usa comunque l'uscita principale per emettere i messaggi."

## 8. Best Practices (2:50)
- Applica un filtro RBE o un arrotondamento se non vuoi ritrasmettere piccoli cambiamenti.
- Unisci il dato con `knxUltimateAutoResponder` per rispondere alle letture KNX.
- Etichetta i nodi con stanza e utilizzo (es. "Bagno Ventilazione") per debugging rapido."

## 9. Idee Demo (3:15)
- Avvia la ventilazione KNX quando l'umidita supera il 65%.
- Invia una notifica KNX quando il livello scende sotto il 30% per ricordare l'umidificazione."

## 10. Wrap-Up & CTA (3:40)
- "Abbiamo collegato la Hue bridge, mappato l'indirizzo KNX e attivato le opzioni di startup e PIN."
- "Iscriviti, lascia un like e condividi nei commenti come userai i dati di umidita Hue su KNX!"