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

# knxUltimateHuePlug Node – Tutorial Outline

## 1. Intro (0:00)
- "Benvenuti! Oggi vediamo come controllare le prese smart Philips Hue da KNX con il nodo `knxUltimateHuePlug`."
- "Perfetto per integrare carichi plug-in, luci portatili o apparecchi monitorati dalla piattaforma Hue."

## 2. Prerequisiti (0:25)
- `knxUltimate-config` gateway per importare gli indirizzi ETS automaticamente.
- `hue-config` bridge con credenziali valide.
- Presa Hue o modulo compatibile gia aggiunto alla bridge."

## 3. Input & Output (0:50)
- Nessun input; il nodo gestisce Hue ↔ KNX internamente.
- Output opzionale (via Node PINs) per intercettare gli eventi in arrivo dalla Hue API."

## 4. Selezione Bridge & Dispositivo (1:10)
- Scegli il gateway KNX per abilitare l'autocomplete dei GA.
- Seleziona la Hue bridge, poi digita il nome della presa per ottenere l'autocomplete.
- Il nodo memorizza l'ID Hue, quindi non serve reinserirlo."

## 5. Controllo Interruttore (1:40)
- **Switch Control GA**: indirizzo KNX che invia ON/OFF (`1.xxx`).
- **Switch Status GA**: feedback booleano verso KNX quando Hue aggiorna lo stato.
- **Power State GA**: canale aggiuntivo per conoscere la disponibilita energetica/health del plug."

## 6. DPT e Naming (2:10)
- Ogni GA ha il proprio selettore DPT; usa `1.001` per on/off e `1.019` o `1.041` per stati se richiesto.
- I campi Nome aiutano a mantenere ordinata la diagnostica (es. "Plug TV Stato")."

## 7. Opzioni di Startup & PIN (2:35)
- **Read Status at Startup**: sincronizza lo stato della presa e i feedback quando il flusso viene deployato.
- **Node PINs**: mostra pin di ingresso/uscita per collegare logica personalizzata oppure nascondili per avere un nodo compatto."

## 8. Runtime Behaviour (3:00)
- I comandi KNX vengono convertiti in chiamate Hue; le risposte Hue aggiornano i GA di stato.
- Il canale power state indica se l'unita e alimentata o se la bridge segnala problemi."

## 9. Best Practices (3:25)
- Sfrutta l'indirizzo di stato per evitare loop: scrivi sul bus solo quando Hue conferma il cambio.
- Usa il canale power state come watchdog per inviare allarmi in caso di plug offline.
- Imposta nomi coerenti con ETS e Hue per evitare errori di mapping."

## 10. Demo Ideas (3:55)
- Controlla una presa lampada da un tasto KNX, ricevendo lo stato reale dalla Hue bridge.
- Disattiva carichi stand-by durante la notte e monitora se la presa viene scollegata."

## 11. Wrap-Up & CTA (4:20)
- "Abbiamo configurato controllo, stato, power e opzioni di avvio per la presa Hue."
- "Iscrivetevi, lasciate un like e raccontatemi nei commenti quali carichi integrerete!"