HUE Controller

KNX-Ultimate video tutorials (YouTube playlist)

Tutto disponibile da un solo nodo

Un’esperienza Controller coerente

• Un unico selettore Hue con ricerca e aggiornamento: la funzione corretta viene ricavata automaticamente dalla risorsa scelta.
• Un click o il focus sul campo dispositivo apre sempre l’elenco Hue completo anche dopo una selezione; digitando, l’elenco viene filtrato.
• Mappature luce basate sulle capacità: Dimmer, Bianco regolabile, RGB/HSV ed effetti nativi seguono le proprietà live dimming, color_temperature, color ed effects della risorsa luce Hue API v2 selezionata.
• Attesa delimitata nell’editor Luce: mentre Hue Bridge carica le risorse compare una clessidra animata, con controllo ogni 500 ms e rilascio dell’editor dopo circa 10 secondi accompagnato da un errore localizzato. Salvataggio, chiusura e cambio funzione annullano il timer.
• Righe KNX compatte mantengono GA, DPT e Nome sulla stessa linea; DPT e Nome hanno larghezze ridotte e Nome può restringersi negli editor più stretti senza alterare il valore memorizzato. I valori DPT salvati vengono conservati mentre le opzioni del selettore si caricano in modo asincrono.
• Gateway KNX opzionale: usa indirizzi di gruppo o nomi ETS importati; i datapoint compatibili arrivano dal gateway selezionato.
• Pin Node-RED dinamici per input Hue API v2 validati e output degli eventi Hue, dove supportati.
• Lettura stato all’avvio, sincronizzazione Hue→KNX e protezione dai loop conservate in ogni profilo privato.
• Migrazione interamente locale per tutti i quindici node type deprecati, seguita da una bozza email modificabile, da un pulsante facoltativo nel messaggio finale per sostenere il progetto, dal controllo locale e dal Deploy manuale.

Primi passi in quattro mosse

1. Configura una volta il Bridge Hue.
2. Aggiungi HUE Controller, quindi scegli o aggiorna un Dispositivo Hue; il Tipo dispositivo viene compilato automaticamente.
3. Seleziona un Gateway KNX e mappa comandi/stati disponibili, oppure lascia none per l’uso esclusivo nel flow.
4. Imposta comportamento e pin specifici della funzione, fai il deploy e controlla lo stato live del nodo.

Nessun gateway KNX? Il Controller continua a funzionare come integrazione Hue–Node-RED. I campi KNX vengono nascosti e restano disponibili le opzioni flow supportate dalla funzione selezionata.

Le sezioni sottostanti costituiscono il riferimento completo per funzione, consolidato dai precedenti nodi dedicati.

Conversione dei nodi HUE legacy

Il pulsante di migrazione compare solo quando l’editor Node-RED rileva almeno un nodo HUE legacy nei flow correnti. Un link al video esplicativo della migrazione su YouTube appare immediatamente prima dello stesso pulsante arancione ad alto contrasto con testo bianco in HUE Controller e in ogni editor HUE legacy. Il disclaimer conferma che nessun dato del flow o dei nodi lascia il browser.

Premi Converti nodi HUE legacy e conferma. Il browser esegue tutta la conversione in locale e non invia da nessuna parte dati relativi a flow, nodi, hue-config, knxUltimate-config, indirizzi di gruppo, collegamenti, credenziali, nomi, posizioni o ID. Dopo la conversione apre soltanto una bozza email modificabile indirizzata all’autore senza abbandonare Node-RED. La bozza contiene soltanto il numero dei nodi convertiti e uno spazio per note facoltative; decidi tu se inviarla e non viene mai spedita automaticamente. Il messaggio finale di Node-RED propone un pulsante facoltativo per sostenere il progetto; la pagina per la donazione si apre solo premendo quel pulsante.

Prima di iniziare, esporta un backup dei tuoi flow. Il browser chiude l’editor del nodo corrente e trasforma soltanto i nodi HUE legacy individuati in istanze HUE Controller. Tutte le proprietà salvate, i riferimenti alle configurazioni, le posizioni, l’appartenenza ai gruppi e i collegamenti restano invariati. Il workspace viene segnato come modificato, ma lo strumento non esegue mai il deploy: controlla il risultato e premi personalmente Deploy. Un nodo cambiato, un flow bloccato o un errore di conversione locale lascia il workspace invariato. Controllo di sicurezza: prima del Deploy esamina ogni nodo HUE modificato e verifica funzione, riferimenti alle configurazioni, pin di ingresso/uscita e collegamenti. Al termine del processo, un messaggio fisso di Node-RED resta visibile finché non premi OK.

Gli eventi Hue restano aggiornamenti di stato e non diventano nuovi comandi Hue. HUE Controller contiene profili privati per runtime, editor, template e traduzioni, quindi non dipende dal caricamento dei node type deprecati. Il nodo Hue Light originale resta invariato. I nodi Hue dedicati restano registrati per i flow esistenti, ma sono congelati e non ricevono nuove funzioni o aggiornamenti di manutenzione. Node-RED nasconde dalla palette la loro categoria speciale deprecated; le istanze esistenti restano modificabili e distribuibili, usano un colore più chiaro di HUE Controller, sono contrassegnate con (deprecated) sul canvas e mostrano in alto nell’editor un avviso di migrazione.

Funzione dispositivo

• Luce / gruppo luci (light)
• Presa / uscita (plug)
• Pulsante (button)
• Tap dial (relative_rotary)
• Movimento (motion)
• Movimento area (area_motion)
• Movimento telecamera (camera_motion)
• Contatto (contact)
• Livello luce (light_level)
• Temperatura (temperature)
• Umidità (humidity)
• Scena (scene)
• Batteria (device_power)
• Connettività Zigbee (zigbee_connectivity)
• Aggiornamento software dispositivo (device_software_update)

Luce / gruppo luci (light)

Questo nodo controlla le luci HUE (singole o raggruppate) e mappa comandi/stati su KNX.

Generale

Localizza dispositivo

Il pulsante Locate (icona play) avvia una sessione di identificazione Hue per la risorsa selezionata. Quando la sessione è attiva il pulsante mostra l’icona stop e il bridge fa lampeggiare la luce — o tutte le luci del gruppo — ogni secondo. Premi di nuovo il pulsante per interrompere subito; in caso contrario la sessione termina automaticamente dopo 10 minuti.

Opzioni

Qui puoi scegliere gli indirizzi KNX per essere collegati ai comandi/stati della luce Avable Hue.

Inizia a digitare nel campo GA (nome o indirizzo di gruppo) e i dispositivi disponibili compariranno mentre digiti.

Interruttore

Dim

Tunable White

RGB/HSV

Per controllare la “V” (luminosità) dell’HSV, usa i controlli standard nella scheda Dim .

Effetti

Effetti base non HUE

Effetti nativi HUE

La tabella Effetti nativi HUE consente di associare valori KNX agli effetti supportati dalla lampada selezionata (per esempio candle, fireplace, prism). Ogni riga collega un valore KNX (booleano, numerico o testuale a seconda del datapoint scelto) a uno degli effetti esposti dal bridge. Dal lato KNX puoi:

• inviare il valore mappato per attivare l’effetto corrispondente;
• impostare facoltativamente un indirizzo di stato: il nodo restituisce il valore mappato quando il bridge Hue segnala un cambio di effetto; se non trova corrispondenze invia il nome grezzo dell’effetto (necessita di un DPT testuale, ad esempio 16.xxx).

Comportamento

|Proprietà |Descrizione | |————————————————- |——————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————| |Leggi lo stato all’avvio |Leggi lo stato della luce HUE all’avvio del nodo-rosso o al rosso nodo-rosso del nodo e invia quello stato al bus KNX | |Stato di luminosità KNX |Aggiorna lo stato dell’indirizzo del gruppo di luminosità KNX, ogni volta che la lampada Hue viene accesa/disattivata.Le opzioni sono ** quando Hue Light è spento, inviare lo 0%.Quando accesa, ripristinare il valore precedente (comportamento KNX predefinito) ** e ** lasciano come (comportamento di tonalità predefinito) **.Se si dispone di Dimmer KNX con stato di luminosità, come MDT, l’opzione suggerita è ***quando la luce della tonalità è disattivata, inviare lo 0%.Quando accesa, ripristinare il valore precedente (comportamento KNX predefinito) *** | |Aggiorna lo stato HUE locale in cache dai write KNX |Opzione avanzata, abilitata di default. Se attiva, i write che arrivano dal bus KNX aggiornano subito anche lo stato HUE locale in cache del nodo, senza attendere feedback/eventi dal bridge Hue. Questo rende le reazioni locali piu rapide e le risposte immediate ai read KNX piu coerenti, soprattutto quando la luce o il grouped_light sono spenti. Disattivala se preferisci che la cache segua solo il feedback/evento reale del bridge Hue. | |Accendi comportamento |Imposta il comportamento delle luci quando acceso.Puoi scegliere tra comportamenti diversi. ** Seleziona colore: ** La luce verrà accesa con il colore di tua scelta.Per cambiare il colore, fai clic sul selettore dei colori (sotto il controlloSeleziona colore). ** Seleziona temperatura e luminosità: ** La luce verrà accesa con la temperatura (kelvin) e la luminosità (0-100) di tua scelta. ** Nessuna: ** La luce manterrà il suo ultimo stato.Nel caso in cui tu abbia abilitato l’illuminazione notturna, dopo la fine della notte, la lampada riprenderà lo stato del colore/temperatura/luminosità fissata al giorno.| |Illuminazione notturna |Permette di impostare un particolare colore/luminosità della luce di notte.Le opzioni sono le stesse del giorno.È possibile selezionare una temperatura/luminosità o colore.Una temperatura accogliente di 2700 Kelvin, con una luminosità del 10% o 20%, è una buona scelta per la luce notturna del bagno | |Giorno/notte |Seleziona l’indirizzo di gruppo utilizzato per impostare il comportamento giorno/notte.Il valore dell’indirizzo di gruppo è true se giorno, false se notturno.| |Valore giorno/notte invertito |Inverti i valori dell’indirizzo di gruppo day/night.Il valore predefinito è ** non controllato .| |Leggi lo stato all’avvio |Leggi lo stato all’avvio ed emetti l’evento al bus KNX all’avvio/riconnessione.(Predefinito “no”) | |Forza modalità diurna |È possibile forzare la modalità diurna cambiando manualmente la luce come descritto qui: ** Passa alla modalità Day spostando rapidamente il Ligth OFF e poi solo questa luce) ** fa ciò che ha descritto e agisce solo su questa luce. Passa alla modalità Day mediante rapido spegnimento del LIGTH OFF e quindi (applica tutti i nodi leggeri) ** agisce a tutti i nodi leggeri, impostando l’indirizzo del gruppo Day/Night in modalità Day.| |Pin di input/output del nodo |Nascondi o mostra i pin di input/output.I pin di input/output consentono al nodo di accettare l’ingresso MSG dal flusso e inviare l’uscita MSG al flusso.L’MSG di input deve seguire gli standard API V.2 HUE.Questo è un esempio di MSG, che accende la luce: msg.on = {"on": true} .Fare riferimento alla [pagina API HUE ufficiale](§url0§) |

Nota

La funzione Dimming funziona in modalità ** KNX start e stop **.Per iniziare a Dimming, invia solo un telegramma KNX “Start”.Per smettere di oscurarsi, invia un telegramma KNX “Stop”.Per favore ** ricorda che **, quando imposti le proprietà del tuo muro.

Presa / uscita (plug)

Presa / Plug Hue

Panoramica

Il nodo Hue Plug collega una presa intelligente Philips Hue alle indirizzazioni KNX:

• comandi on/off dal BUS
• feedback dello stato dalla piattaforma Hue
• gestione opzionale del parametro power_state

Configurazione

Suggerimenti KNX

• Usa un DPT 1.xxx per comando e stato.
• Il power_state può essere mappato a un GA booleano (true = on, false = standby) oppure a un DPT testuale.
• In risposta a una lettura KNX (GroupValue_Read) il nodo restituisce l’ultimo valore memorizzato.

Integrazione con i flow

Con i pin abilitati:

• Input : invia payload Hue v2 (es. { on: { on: true } }).
• Output : ricevi { payload, on, power_state, rawEvent } a ogni evento Hue.

API Hue

Le richieste utilizzano l’endpoint /resource/plug/{id}. Le notifiche arrivano dallo stream eventi e sono utilizzate per aggiornare lo stato KNX.

Pulsante (button)

Il nodo Hue Button inoltra gli eventi del pulsante Hue verso KNX e verso l’uscita del flow utilizzando il campo Hue button.button_report.event.

Nel campo GA (nome o indirizzo di gruppo) inizia a digitare per collegare la GA KNX; i dispositivi compaiono durante la digitazione.

Generale

Interruttore

Dimmer

Comportamento

Output

1. Uscita standard

   msg.payload contiene il valore booleano (o l’oggetto di dimmer) inviato a KNX; msg.event è la stringa dell’evento Hue (es. short_release, repeat).

Dettagli

msg.event replica button.button_report.event. L’evento originale di Hue è disponibile in msg.rawEvent. Usa la GA di stato opzionale per mantenere il toggle interno allineato con interruttori o attuatori esterni.

Tap dial (relative_rotary)

Il nodo Hue Tap Dial collega il servizio di rotazione del Tap Dial alle GA KNX e inoltra l’evento Hue originale al flow. Dopo aver associato un nuovo Tap Dial, premi l’icona di aggiornamento accanto al campo dispositivo.

Schede

• Mappatura - scegli GA KNX e DPT per gli eventi di rotazione. Sono supportati DPT 3.007 (dim relativo), DPT 5.001 (livello 0-100 %) e DPT 232.600 (controllo colore vendor).
• Comportamento - mostra/nasconde il pin di output del nodo. Se non è configurato un gateway KNX il pin resta attivo così gli eventi Hue raggiungono comunque il flow.

Impostazioni generali

Scheda Mappatura

Output

ℹ️ I controlli legati a KNX compaiono solo dopo la selezione del gateway; la scheda Mappatura resta nascosta finché non sono configurati sia bridge sia gateway.

Movimento (motion)

Questo nodo riceve gli eventi da un sensore di movimento Hue e li inoltra a KNX e al flow Node-RED.

Nel campo GA digita nome o indirizzo di gruppo KNX: i suggerimenti appaiono durante la digitazione. Il pulsante di refresh accanto a “Sensore Hue” consente di ricaricare la lista dal Bridge Hue.

Generale

Mappatura

Comportamento

ℹ️ Le sezioni KNX compaiono solo dopo aver scelto un gateway KNX, così puoi usare il nodo anche come semplice listener Hue → Node-RED.

Output

1. Uscita standard — msg.payload (boolean)

   true quando viene rilevato movimento, false quando termina.

Movimento area (area_motion)

Il nodo Hue Motion Area riceve gli eventi di movimento aggregati di un’area MotionAware (Hue Bridge Pro) e li inoltra a KNX o al flow Node-RED.

Nel campo GA digita nome o indirizzo di gruppo KNX per collegare l’indirizzo: i suggerimenti appaiono durante la digitazione.

Generale

Mappatura

Comportamento

Output

1. Uscita standard

   msg.payload (boolean): true quando l’area risulta in movimento, false quando è libera.

Dettagli

msg.payload contiene lo stato di movimento aggregato fornito dal servizio MotionAware per l’area selezionata.

Movimento telecamera (camera_motion)

Il nodo Hue Camera Motion ascolta il servizio di motion delle camere Philips Hue e replica in KNX lo stato rilevato/non rilevato.

Inizia a digitare nel campo GA (nome o indirizzo di gruppo) per collegare la GA KNX; i dispositivi compaiono durante la digitazione.

Generale

Associazione

Uscite

1. Uscita standard

   msg.payload (boolean): true quando viene rilevato movimento, altrimenti false

Dettagli

msg.payload contiene l’ultimo stato di movimento fornito dal servizio camera di Hue.

Contatto (contact)

Questo nodo inoltra gli eventi di un sensore di contatto HUE mappandoli su indirizzi di gruppo KNX.

Inizia a digitare nel campo GA, il nome o l’indirizzo di gruppo del dispositivo KNX, i dispositivi disponibili iniziano a mostrare mentre si digita.

Generale

Output

1. Output standard

   payload (booleano): l’output standard del comando.

Dettagli

msg.payload contiene l’evento HUE (boolean/oggetto) per eventuale logica personalizzata.

Livello luce (light_level)

Questo nodo legge gli eventi (lux) da un sensore di luce HUE e li espone su KNX.

Emette l’illuminamento ambientale (lux) a ogni variazione. Nel campo GA digita nome o indirizzo di gruppo per collegare la GA KNX (autocompletamento).

Generale

Mappatura

Output

1. Uscita standard

   payload (number): valore corrente in lux

Dettagli

msg.payload contiene il valore numerico in lux.

Temperatura (temperature)

Questo nodo legge la temperatura (°C) da un sensore HUE e la mappa su KNX.

Inizia a digitare nel campo GA (nome o indirizzo di gruppo) per collegare la GA KNX; i dispositivi compaiono durante la digitazione.

Generale

Mapping

Output

1. Uscita standard

   msg.payload (number): temperatura corrente in °C

Dettagli

msg.payload contiene il valore numerico della temperatura.

Umidità (humidity)

Questo nodo legge l’umidità relativa (%) da un sensore HUE e la invia verso KNX.

Inizia a digitare nel campo GA (nome o indirizzo di gruppo) per collegare la GA KNX; i dispositivi compaiono durante la digitazione.

Generale

Associazione

Uscite

1. Uscita standard

   msg.payload (numero): valore corrente di umidità relativa in %

Dettagli

msg.payload contiene il valore numerico dell’umidità (percentuale).

Scena (scene)

Il nodo Hue Scene pubblica le scene Hue su KNX e può inoltrare gli eventi grezzi al flow di Node-RED. Il campo scena supporta l’autocompletamento; dopo aver creato nuove scene sulla bridge premi l’icona di aggiornamento per ricaricare l’elenco.

Schede disponibili

• Mappatura - collega gli indirizzi di gruppo KNX alla scena selezionata. I DPT 1.xxx eseguono un richiamo booleano, mentre i DPT 18.xxx inviano un numero scena KNX.
• Multi scena - crea un elenco di regole che associano numeri scena KNX a scene Hue e definiscono se richiamarle come active, dynamic_palette o static.
• Comportamento - mostra/nasconde il pin di output del nodo. Senza un gateway KNX configurato il pin rimane comunque attivo, così gli eventi Hue raggiungono il flow.

Impostazioni generali

Scheda Mappatura

Scheda Multi scena

ℹ️ Gli elementi KNX vengono mostrati solo dopo aver selezionato un gateway KNX. Le schede di mappatura restano nascoste finché non sono configurati sia bridge sia gateway.

Batteria (device_power)

Questo nodo espone su KNX il livello batteria di un dispositivo Hue ed emette un evento ogni volta che il valore cambia.

Nel campo GA digita nome o indirizzo di gruppo KNX: i risultati compaiono durante la digitazione. Usa il pulsante di aggiornamento accanto a “Sensore Hue” per ricaricare l’elenco dal Bridge Hue dopo aver aggiunto nuovi dispositivi.

Generale

Mappatura

Comportamento

ℹ️ Le sezioni KNX vengono visualizzate solo dopo aver scelto un gateway KNX, evitando modifiche accidentali quando il nodo è usato solo verso Node-RED.

Connettività Zigbee (zigbee_connectivity)

Questo nodo legge la connettività Zigbee da un dispositivo HUE ed espone lo stato su KNX.

Inizia a digitare il nome o l’indirizzo di gruppo nel campo GA: l’autocompletamento mostra i dispositivi disponibili.

Generale

Mappatura

Output

1. Uscita standard

   payload (boolean): stato di connettività.

Dettagli

msg.payload contiene true/false.
msg.status contiene il testo: connected, disconnected, connectivity_issue, unidirectional_incoming .

Aggiornamento software dispositivo (device_software_update)

Questo nodo monitora se un dispositivo HUE ha un aggiornamento software disponibile e pubblica lo stato su KNX.

Inizia a digitare il nome o l’indirizzo di gruppo del dispositivo KNX nel campo GA, i dispositivi disponibili iniziano a mostrare mentre stai digitando.

Generale

Mappatura

Output

1. Uscita standard

   payload (boolean): flag aggiornamento.

   status (string): no_update, update_pending, ready_to_install, installing .