node-red-contrib-knx-ultimate 7.1.4 → 8.0.2

package/nodes/locales/it/knxUltimateHueController.html

@@ -1,690 +0,0 @@
-<script type="text/markdown" data-help-name="knxUltimateHueController">
-### Aggiornamento a KNX Ultimate 8
-
-La versione 7 mostra un piccolo pulsante **Aggiorna alla v8** nella parte alta di questo editor. Il pulsante scarica un backup dei flow, installa i package HUE/Matter necessari, converte i nodi compatibili, esegue un Deploy completo, verifica i flow salvati e installa la versione 8. Quando richiesto, riavvia il servizio Node-RED: ricaricare soltanto il browser non basta. I nodi KNX AI legacy fermano la procedura automatica.
-
-[Guida completa all’aggiornamento](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/it-Upgrade-to-v8)
-
-<br/>
-
-<p><a href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E" target="_blank" rel="noopener noreferrer"><strong>Tutorial video KNX-Ultimate (playlist YouTube)</strong></a> Prima di iniziare, <a href="https://youtu.be/f0Evf2QFI7c" target="_blank" rel="noopener noreferrer">guarda il video esplicativo su YouTube</a>.</p>
-<p><strong>HUE Controller</strong> è il nodo unificato per le risorse Hue API v2.</p>
-<p>Seleziona un dispositivo o una risorsa Hue. HUE Controller ne rileva automaticamente il tipo e apre l'editor corretto per mappature KNX, comportamento e pin del nodo.</p>
-<p>Selettore del dispositivo, pulsante di aggiornamento e tipo rilevato condividono la stessa riga compatta, come nel workflow del Matter Controller.</p>
-<p>Un click o il focus sul campo dispositivo apre sempre l'elenco completo delle risorse Hue, anche quando un dispositivo è già selezionato. Digitando, l'elenco continua a essere filtrato.</p>
-<p>La selezione di un'altra risorsa Hue resta soltanto un'anteprima finché l'editor non viene salvato. Premendo <code>Annulla</code> vengono ripristinati il dispositivo, la funzione e le mappature salvati in precedenza.</p>
-<p>Il selettore del dispositivo Hue resta nascosto finché Hue Bridge non è selezionato, connesso e ha caricato il catalogo delle risorse. Durante l'attesa viene mostrato un indicatore di caricamento. Riportando il bridge su <code>none</code>, indicatore, selettore ed editor del dispositivo vengono nuovamente nascosti.</p>
-<p>Se il nodo possiede già un dispositivo Hue salvato, il relativo selettore resta visibile ma disabilitato mentre il bridge selezionato è offline, e le TAB delle mappature KNX restano disponibili. Dopo 15 secondi, l'etichetta di attesa segnala che Hue Bridge non è raggiungibile. La ricerca delle risorse continua in background e, se il bridge non diventa disponibile, compare infine un errore rosso fisso.</p>
-<p>Le righe di mappatura KNX mantengono GA, DPT e Nome sulla stessa linea. I campi DPT e Nome usano larghezze compatte e Nome può restringersi ulteriormente negli editor più stretti senza modificare il testo memorizzato. I valori DPT salvati vengono conservati mentre le opzioni del selettore si caricano in modo asincrono.</p>
-<p>Funzioni supportate: luci e gruppi di luci, prese, pulsanti, Tap dial, movimento e movimento telecamera, contatti, livello luce, temperatura, umidità, scene, batteria, connettività Zigbee e aggiornamento software.</p>
-<p>Quando non è selezionato alcun <strong>Gateway KNX</strong> (inclusi <code>none</code> e <em>Aggiungi nuovo...</em>), vengono nascoste le TAB delle mappature Luce, mentre la selezione della risorsa Hue e le opzioni per il solo flow restano disponibili. I relativi campi GA, DPT e Nome rimangono montati e conservano i valori quando il gateway viene riselezionato, ripristinando invariato anche il layout verticale delle TAB.</p>
-<p>I valori segnaposto temporanei emessi programmaticamente da Node-RED durante l'inizializzazione dei selettori KNX e Hue non sostituiscono i gateway salvati. Soltanto la selezione esplicita di <code>none</code> nasconde le TAB delle mappature Luce.</p>
-<p>Le TAB delle mappature Luce contengono soltanto i controlli di configurazione; le immagini decorative Dimmer, Bianco regolabile e RGB sono state eliminate.</p>
-<p>Per una luce singola, le sezioni <strong>Dimmer</strong>, <strong>Bianco regolabile</strong>, <strong>RGB/HSV</strong> ed effetti nativi seguono le capacità live dichiarate dalla risorsa Hue API v2 selezionata. Le relative mappature KNX appaiono automaticamente quando la luce espone <code>dimming</code>, <code>color_temperature</code> o <code>color</code>.</p>
-<p>L'editor Luce mostra subito le mappature salvate senza attendere la cache delle risorse Hue del runtime. Le capability correnti vengono caricate in background; se la richiesta fallisce, mappature e selettore dei pin restano disponibili e un errore Node-RED rosso e fisso segnala il problema.</p>
-<p>Locate e il contenitore delle mappature Luce vengono inizializzati prima dei widget opzionali Effetti e schede. Un gateway KNX salvato resta valido se Node-RED mostra temporaneamente un selettore vuoto durante l'avvio dell'editor. Gli errori del browser e il rifiuto del primo comando Locate producono un errore Node-RED rosso e fisso con il dettaglio tecnico, invece di lasciare l'editor silenzioso.</p>
-<p>Quando è selezionato un gateway, nei campi di mappatura puoi digitare un indirizzo di gruppo KNX o un nome importato da ETS; i datapoint compatibili vengono caricati da quel gateway.</p>
-<p>Il pulsante di migrazione compare solo quando l'editor Node-RED rileva almeno un nodo HUE legacy nei flow correnti. Lo stesso pulsante arancione ad alto contrasto con testo bianco è disponibile sotto l'avviso di deprecazione in ogni editor HUE legacy.</p>
-<p><strong>Converti nodi HUE legacy</strong> esegue l'intera conversione nel browser e non invia alcun dato del flow o dei nodi. Dopo la conversione locale, il browser 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 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.</p>
-<p>Dopo la conferma e prima di modificare i nodi, il browser avvia automaticamente il download di un backup JSON con data e ora di tutti i flow attualmente nell’editor, inclusi schede, subflow, nodi di configurazione, gruppi e collegamenti. Il file usa il formato di esportazione standard di Node-RED e può essere reimportato. Le credenziali dichiarate dai nodi sono escluse, come nell’esportazione standard. Il browser può chiedere dove salvare il file. Se non è possibile preparare il backup o avviarne il download, nessun nodo viene convertito.</p>
-<p>L'editor trasforma soltanto i nodi HUE legacy rilevati in istanze HUE Controller. Proprietà, riferimenti alle configurazioni, posizioni, gruppi e collegamenti esistenti restano intatti. Il flow viene segnato come modificato, ma non viene distribuito automaticamente: controllalo e premi personalmente <strong>Deploy</strong>. Un nodo cambiato, un flow bloccato o un errore di conversione locale lascia il flow invariato. <strong>Controllo di sicurezza:</strong> 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 <strong>OK</strong>.</p>
-<p>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 <code>deprecated</code>; le istanze esistenti restano modificabili e distribuibili, usano un colore più chiaro di HUE Controller, sono contrassegnate con <code>(deprecated)</code> sul canvas e mostrano in alto nell'editor un avviso di migrazione.</p>
-
-<!-- HUE_CONTROLLER_PROFILE_HELP_START -->
-
-## Funzione dispositivo
-
-- [Luce / gruppo luci (`light`)](#hue-controller-help-light)
-- [Presa / uscita (`plug`)](#hue-controller-help-plug)
-- [Pulsante (`button`)](#hue-controller-help-button)
-- [Tap dial (`relative_rotary`)](#hue-controller-help-relative_rotary)
-- [Movimento (`motion`)](#hue-controller-help-motion)
-- [Movimento area (`area_motion`)](#hue-controller-help-area_motion)
-- [Movimento telecamera (`camera_motion`)](#hue-controller-help-camera_motion)
-- [Contatto (`contact`)](#hue-controller-help-contact)
-- [Livello luce (`light_level`)](#hue-controller-help-light_level)
-- [Temperatura (`temperature`)](#hue-controller-help-temperature)
-- [Umidità (`humidity`)](#hue-controller-help-humidity)
-- [Scena (`scene`)](#hue-controller-help-scene)
-- [Batteria (`device_power`)](#hue-controller-help-device_power)
-- [Connettività Zigbee (`zigbee_connectivity`)](#hue-controller-help-zigbee_connectivity)
-- [Aggiornamento software dispositivo (`device_software_update`)](#hue-controller-help-device_software_update)
-
-<span id="hue-controller-help-light" data-hue-controller-type="light"></span>
-
-## Luce / gruppo luci (`light`)
-
-<p>Questo nodo controlla le luci HUE (singole o raggruppate) e mappa comandi/stati su KNX.</p>
-
-<p>Senza un gateway KNX, al posto dell'intestazione duplicata “Philips HUE” compare l'avviso per l'uso tramite input del flow.</p>
-
-<p><strong>Gruppi di luci:</strong> quando è configurato un gateway KNX, selezionando un <code>grouped_light</code> vengono sempre mostrate tutte le mappature Switch, Dim, Tunable White, RGB/HSV, Effetti e Comportamento. L'editor non limita questi campi in base alle luci attualmente incluse nel gruppo.</p>
-
-**Generale**
-
-| Proprietà | Descrizione |
-|-|-|
-|Gateway KNX |Seleziona il gateway KNX da utilizzare |
-|Hue Bridge |Seleziona il bridge Hue da utilizzare |
-|Nome |Luce Hue o gruppo da utilizzare. Le luci e i gruppi disponibili compaiono mentre digiti|
-
-<br/>
-
-**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.
-
-<br/>
-
-**Opzioni**
-
-Qui puoi associare gli indirizzi di gruppo KNX ai comandi e agli stati disponibili della luce Hue. <br/>
-Inizia a digitare nel campo GA (nome o indirizzo di gruppo) e i dispositivi disponibili compariranno mentre digiti.
-
-**Interruttore**
-
-| Proprietà | Descrizione |
-|-|-|
-|Comando |Indirizzo di gruppo usato per accendere o spegnere la luce Hue tramite un valore KNX booleano true/false. |
-|Stato |Collegalo all'indirizzo del gruppo di stato dell'interruttore della luce |
-
-<br/>
-
-**Dimmer**
-
-| Proprietà | Descrizione |
-|-|-|
-|Controllo dimmer | Dim relativo della luce HUE. La velocità si imposta nella scheda **Comportamento** .|
-|Controllo % |Imposta la luminosità assoluta della luce Hue (0–100%). |
-|Stato % |Collegalo all'indirizzo del gruppo KNX di luminosità della luce |
-|Velocità dimmer (ms) | Velocità di dimming in millisecondi. Vale per la luce e per il "tunable white”. Calcolata sul range 0%→100%.|
-|Luminosità minima dimmer |Luminosità minima raggiungibile durante la regolazione: la diminuzione si arresta alla percentuale specificata. |
-|Luminosità massima dimmer |Luminosità massima raggiungibile durante la regolazione: l'aumento si arresta alla percentuale specificata. |
-
-<br/>
-
-**Bianco regolabile**
-
-| Proprietà | Descrizione |
-|-|-|
-|Controllo dimmer | Cambia la temperatura del bianco con DPT 3.007 (velocità in **Comportamento** ). |
-|Controllo % | Cambia la temperatura del bianco con DPT 5.001. 0 = caldo, 100 = freddo |
-|Stato %| GA di stato temperatura (DPT 5.001). 0 = caldo, 100 = freddo |
-|Controllo Kelvin | **DPT 7.600:** imposta in Kelvin con range KNX 2000-6535 (convertito in mirek).<br/>**DPT 9.002:** imposta in Kelvin con range HUE 2000-6535 (Ambiance da 2200). Possibili piccole variazioni per conversioni. |
-|Stato Kelvin | **DPT 7.600:** leggi in Kelvin via range KNX 2000-6535 (convertito).<br/>**DPT 9.002:** leggi in Kelvin via range HUE 2000-6535 (Ambiance da 2200). Possibili piccole variazioni per conversioni. |
-|Inverti direzione dimmer |Inverte la direzione della regolazione. |
-<br/>
-
-**RGB/HSV**
-
-| Proprietà | Descrizione |
-|-|-|
-| **Sezione RGB** ||
-|Controllo RGB | Cambia colore con tripla RGB (r,g,b); gestione gamut inclusa. L'invio colore accende la luce impostando colore/luminosità; con r,g,b=0 la luce si spegne |
-|Stato RGB |Indirizzo di gruppo che riporta lo stato del colore della luce. Il datapoint accetta una terna RGB (R, G, B). |
-| **Sezione HSV** ||
-|Controllo dimmer H | Scorri la tonalità (HSV) con DPT 3.007; velocità in **Comportamento** |
-|Stato H %|Stato del circolo cromatico HSV. |
-|Controllo dimmer S | Cambia saturazione con DPT 3.007; velocità in **Comportamento** |
-|Stato S % |Indirizzo di gruppo che riporta lo stato della saturazione del colore della luce. |
-|Velocità dimmer (ms) |Tempo di regolazione, in millisecondi, per passare dal minimo al massimo della scala. |
-
-Per controllare la "V” (luminosità) dell'HSV, usa i controlli standard nella scheda **Dimmer** .
-
-<br/>
-
-**Effetti**
-
-_Effetti base non HUE_
-
-| Proprietà | Descrizione |
-|-|-|
-| Lampeggio | _true_ fa lampeggiare la luce, _false_ ferma il lampeggio. Alterna acceso/spento; utile per segnalazioni. Funziona con tutte le luci HUE. |
-| Ciclo colore | _true_ avvia il ciclo colori, _false_ lo interrompe. Cambia casualmente il colore della luce HUE a intervalli regolari. Funziona con le luci HUE che supportano il colore. L'effetto parte dopo 10 secondi. |
-
-_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).
-
-<br/>
-
-**Comportamento**
-
-|Proprietà |Descrizione |
-|------------------------------------------------- |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-|Leggi lo stato all'avvio |Legge lo stato della luce Hue all'avvio di Node-RED o dopo un deploy completo e lo invia al bus KNX. |
-|Stato luminosità KNX |Aggiorna l'indirizzo di gruppo dello stato di luminosità quando la lampada Hue viene accesa o spenta. Le opzioni sono **Se la luce HUE è spenta invia 0%. Se è accesa, ripristina il valore precedente (comportamento KNX predefinito)** e **Lascia invariato (comportamento HUE predefinito)**. Per i dimmer KNX con stato di luminosità, come quelli MDT, è consigliata la prima opzione. |
-|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 più rapide e le risposte immediate ai read KNX più 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. |
-|Comportamento all'accensione |Imposta il comportamento della luce quando viene accesa.<br/>**Seleziona colore:** accende la luce con il colore scelto. Fai clic sul selettore dei colori per modificarlo.<br/>**Seleziona temperatura e luminosità:** accende la luce con la temperatura (kelvin) e la luminosità (0–100%) scelte.<br/>**Nessuno:** mantiene l'ultimo stato della luce. Se è abilitata l'illuminazione notturna, al termine della notte viene ripristinato lo stato di colore, temperatura e luminosità impostato per il giorno. |
-|Illuminazione notturna |Permette di impostare il colore o la combinazione di temperatura e luminosità da usare di notte. Le opzioni sono le stesse della modalità diurna. Per la luce notturna del bagno, ad esempio, puoi scegliere 2700 K e una luminosità del 10% o 20%. |
-|Giorno/Notte |Indirizzo di gruppo che seleziona la modalità giorno/notte: _true_ per il giorno, _false_ per la notte. |
-|Inverti valore giorno/notte |Inverte i valori dell'indirizzo di gruppo giorno/notte. Per impostazione predefinita l'opzione è **deselezionata**. |
-|Leggi lo stato all'avvio |Legge lo stato e lo invia al bus KNX all'avvio o alla riconnessione. Valore predefinito: **No**. |
-|Forza modalità diurna |Consente di passare alla modalità diurna spegnendo e riaccendendo rapidamente la luce. **Solo questa luce** applica il cambio alla luce selezionata; **tutte le luci** lo applica a tutti i nodi luce, impostando la modalità giorno/notte su giorno. |
-|PIN di Input/Output del nodo |Mostra o nasconde i pin di ingresso e uscita, che consentono di ricevere e inviare messaggi al flow. I messaggi in ingresso devono seguire il formato delle API Hue v2. Ad esempio, per accendere la luce: <code> msg.on = {"on": true} </code>. Consulta la [pagina ufficiale delle API Hue](https://developers.meethue.com/develop/hue-api-v2/api-reference/#resource_light__id__put). |
-
-##### Nota
-
-La regolazione funziona con i comandi KNX **start** e **stop**: invia un telegramma "start" per avviarla e un telegramma "stop" per arrestarla. Tienine conto quando configuri i pulsanti a parete.
-
-<br/>
-
----
-
-<span id="hue-controller-help-plug" data-hue-controller-type="plug"></span>
-
-## Presa / uscita (`plug`)
-
-### Presa / Plug Hue
-
-#### Panoramica
-
-Il nodo Hue Plug collega una presa intelligente Philips Hue agli indirizzi di gruppo KNX:
-
-- comandi on/off dal BUS
-- feedback dello stato dalla piattaforma Hue
-- gestione opzionale del parametro `power_state`
-
-#### Configurazione
-
-|Campo|Descrizione|
-|--|--|
-| Gateway KNX | Gateway KNX utilizzato |
-| Hue Bridge | Bridge Hue configurato |
-| Nome | Seleziona la presa Hue (autocomplete) |
-| Comando | GA KNX per l'invio dell'on/off (DPT booleano) |
-| Stato | GA opzionale per ricevere lo stato on/off dal bridge |
-| Stato alimentazione | GA opzionale che replica il campo `power_state` (on/standby) |
-| Leggi stato all'avvio | Se abilitato, all'avvio il nodo invia lo stato corrente |
-| Pin di I/O | Abilita i pin Node-RED per inviare payload Hue personalizzati o ricevere gli eventi sul flow |
-
-#### 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.
-
----
-
-<span id="hue-controller-help-button" data-hue-controller-type="button"></span>
-
-## Pulsante (`button`)
-
-<p>Il nodo Hue Button inoltra gli eventi del pulsante Hue verso KNX e verso l'uscita del flow utilizzando il campo Hue <code>button.button_report.event</code>.</p>
-
-Nel campo GA (nome o indirizzo di gruppo) inizia a digitare per collegare la GA KNX; i dispositivi compaiono durante la digitazione.
-
-**Generale**
-
-|Proprietà|Descrizione|
-|--|--|
-| Gateway KNX | Seleziona il gateway KNX da utilizzare |
-| Hue Bridge | Seleziona il bridge Hue da utilizzare |
-| Pulsante Hue | Pulsante Hue da usare (autocompletamento) |
-
-**Interruttore**
-
-|Proprietà|Descrizione|
-|--|--|
-| Interruttore | GA attivata dall'evento <code>short\_release</code> (pressione rapida). |
-| GA stato | GA opzionale quando <em>Alterna valori</em> è attivo; mantiene allineato lo stato interno con altri attuatori. |
-
-**Dimmer**
-
-|Proprietà|Descrizione|
-|--|--|
-| Dim | GA utilizzata durante gli eventi <code>long\_press</code>/<code>repeat</code> per il dimming (tipicamente DPT 3.007). |
-
-**Comportamento**
-
-|Proprietà|Descrizione|
-|--|--|
-| Alterna valori | Se attivo, il nodo alterna automaticamente tra <code>true/false</code> e direzioni di dimmer. |
-| Payload interruttore | Payload inviato a KNX/flow quando Alterna valori è disattivato. |
-| Payload dimmer | Direzione inviata a KNX/flow quando Alterna valori è disattivato. |
-
-##### 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.
-
----
-
-<span id="hue-controller-help-relative_rotary" data-hue-controller-type="relative_rotary"></span>
-
-## 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
-
-| Proprietà | Descrizione |
-|--|--|
-| Gateway KNX | Gateway KNX usato per l'autocompletamento delle GA. |
-| Hue Bridge | Hue Bridge che espone il Tap Dial. |
-| Hue Tap Dial | Dispositivo rotativo (autocomplete; il pulsante di refresh ricarica l'elenco). |
-
-##### Scheda Mappatura
-
-| Proprietà | Descrizione |
-|--|--|
-| GA rotazione | GA KNX che riceve gli eventi di rotazione (supporta DPT 3.007, 5.001, 232.600). |
-| Nome | Etichetta descrittiva della GA. |
-
-##### Output
-
-|#|Porta|Payload|
-|--|--|--|
-|1|Uscita standard|`msg.payload` (oggetto) Evento Hue grezzo generato dal Tap Dial.|
-
-> ℹ️ 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.
-
----
-
-<span id="hue-controller-help-motion" data-hue-controller-type="motion"></span>
-
-## Movimento (`motion`)
-
-<p>Questo nodo riceve gli eventi da un sensore di movimento Hue e li inoltra a KNX e al flow Node-RED.</p>
-
-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.</p>
-
-**Generale**
-
-| Proprietà | Descrizione |
-|-|-|
-|Gateway KNX |Gateway KNX che riceve le segnalazioni di movimento (necessario per visualizzare le opzioni KNX) |
-|Hue Bridge |Hue Bridge da interrogare |
-| Sensore movimento Hue | Sensore di movimento Hue (supporta autocompletamento e refresh) |
-
-**Mappatura**
-
-| Proprietà | Descrizione |
-|--|--|
-| Movimento | GA KNX che riceve `true` quando viene rilevato movimento e `false` quando termina (DPT consigliato: <b>1.001</b>) |
-
-**Comportamento**
-
-| Proprietà | Descrizione |
-|--|--|
-| Pin di uscita del nodo | Mostra o nasconde l'uscita Node-RED; senza gateway KNX il pin resta attivo così gli eventi Hue raggiungono comunque il flow |
-
-> ℹ️ 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.
-
----
-
-<span id="hue-controller-help-area_motion" data-hue-controller-type="area_motion"></span>
-
-## Movimento area (`area_motion`)
-
-<p>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.</p>
-
-Nel campo GA digita nome o indirizzo di gruppo KNX per collegare l'indirizzo: i suggerimenti appaiono durante la digitazione.
-
-**Generale**
-
-| Proprietà | Descrizione |
-|--|--|
-| KNX GW | Gateway KNX che riceve lo stato di movimento dell'area. |
-| HUE Bridge | Bridge Hue Pro da utilizzare. |
-| HUE Area | Area MotionAware (convenience o security) da monitorare (autocomplete durante la digitazione). |
-| Leggi stato all'avvio | All'avvio/riconnessione legge il valore corrente e lo invia a KNX (predefinito: sì). |
-
-**Mappatura**
-
-| Proprietà | Descrizione |
-|--|--|
-| Movimento | GA KNX per lo stato di movimento dell'area (boolean). DPT consigliato: <b>1.001</b>. |
-
-**Comportamento**
-
-| Proprietà | Descrizione |
-|--|--|
-| Pin di uscita del nodo | Mostra o nasconde l'uscita Node-RED; senza gateway KNX il pin resta attivo così gli eventi MotionAware raggiungono comunque il flow. |
-
-##### 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.
-
----
-
-<span id="hue-controller-help-camera_motion" data-hue-controller-type="camera_motion"></span>
-
-## Movimento telecamera (`camera_motion`)
-
-<p>Il nodo Hue Camera Motion riceve gli eventi di movimento delle telecamere Philips Hue e replica in KNX lo stato rilevato/non rilevato.</p>
-
-Inizia a digitare nel campo GA (nome o indirizzo di gruppo) per collegare la GA KNX; i dispositivi compaiono durante la digitazione.
-
-**Generale**
-
-|Proprietà|Descrizione|
-|--|--|
-| Gateway KNX | Seleziona il gateway KNX da utilizzare |
-| Hue Bridge | Seleziona il bridge Hue da utilizzare |
-| Movimento telecamera Hue | Sensore di movimento della telecamera Hue (autocompletamento durante la digitazione) |
-| Leggi lo stato all'avvio | All'avvio/riconnessione legge il valore corrente e lo invia a KNX (predefinito: no) |
-
-**Associazione**
-
-|Proprietà|Descrizione|
-|--|--|
-| Movimento | GA KNX per il movimento (booleano). DPT consigliato: <b>1.001</b> |
-
-##### 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 della telecamera Hue.
-
----
-
-<span id="hue-controller-help-contact" data-hue-controller-type="contact"></span>
-
-## Contatto (`contact`)
-
-<p>Questo nodo inoltra gli eventi di un sensore di contatto HUE mappandoli su indirizzi di gruppo KNX.</p>
-
-Inizia a digitare il nome o l'indirizzo di gruppo del dispositivo KNX nel campo GA: l'autocompletamento mostra i dispositivi disponibili.
-
-**Generale**
-
-| Proprietà | Descrizione |
-|-|-|
-|Gateway KNX |Seleziona il gateway KNX da utilizzare |
-|Hue Bridge |Seleziona il bridge Hue da utilizzare |
-| Sensore contatto Hue | Sensore di contatto HUE da usare (autocompletamento) |
-
-|Proprietà |Descrizione |
-|-------- |-------------------------------------------------------------------------------------------------------------------------------------- |
-| Contatto | All'apertura/chiusura, invia su KNX: _true_ se attivo/aperto, altrimenti _false_. |
-
-##### Output
-
-1. Output standard
-   : payload (booleano): l'output standard del comando.
-
-##### Dettagli
-
-`msg.payload` contiene l'evento HUE (boolean/oggetto) per eventuale logica personalizzata.
-
----
-
-<span id="hue-controller-help-light_level" data-hue-controller-type="light_level"></span>
-
-## Livello luce (`light_level`)
-
-<p>Questo nodo legge gli eventi (lux) da un sensore di luce HUE e li espone su KNX.</p>
-
-Emette l'illuminamento ambientale (lux) a ogni variazione. Nel campo GA digita nome o indirizzo di gruppo per collegare la GA KNX (autocompletamento).
-
-**Generale**
-
-| Proprietà | Descrizione |
-|-|-|
-|Gateway KNX |Seleziona il gateway KNX da utilizzare |
-|Hue Bridge |Seleziona il bridge Hue da utilizzare |
-| Sensore luce Hue | Sensore di luce HUE da usare (autocompletamento) |
-|Leggi lo stato all'avvio |Leggi lo stato all'avvio ed emetti l'evento al bus KNX all'avvio/riconnessione.(Predefinito "no") |
-
-**Mappatura**
-
-| Proprietà | Descrizione |
-|--|--|
-| Lux | GA KNX che riceve il valore in lux |
-
-##### Output
-
-1. Uscita standard
-   : payload (number): valore corrente in lux
-
-##### Dettagli
-
-`msg.payload` contiene il valore numerico in lux.
-
----
-
-<span id="hue-controller-help-temperature" data-hue-controller-type="temperature"></span>
-
-## Temperatura (`temperature`)
-
-<p>Questo nodo legge la temperatura (°C) da un sensore HUE e la mappa su KNX.</p>
-
-Inizia a digitare nel campo GA (nome o indirizzo di gruppo) per collegare la GA KNX; i dispositivi compaiono durante la digitazione.
-
-**Generale**
-
-| Proprietà | Descrizione |
-|--|--|
-| Gateway KNX | Seleziona il gateway KNX da utilizzare |
-| Hue Bridge | Seleziona il bridge Hue da utilizzare |
-| Sensore temperatura Hue | Sensore di temperatura HUE (autocompletamento) |
-| Leggi lo stato all'avvio | All'avvio/riconnessione, leggi il valore corrente e invialo su KNX (predefinito: no) |
-
-**Mapping**
-
-| Proprietà | Descrizione |
-|--|--|
-| Temp | GA KNX per la temperatura in °C. DPT consigliato: <b>9.001</b> |
-
-##### Output
-
-1. Uscita standard
-   : `msg.payload` (number): temperatura corrente in °C
-
-##### Dettagli
-
-`msg.payload` contiene il valore numerico della temperatura.
-
----
-
-<span id="hue-controller-help-humidity" data-hue-controller-type="humidity"></span>
-
-## Umidità (`humidity`)
-
-<p>Questo nodo legge l'umidità relativa (%) da un sensore HUE e la invia verso KNX.</p>
-
-Inizia a digitare nel campo GA (nome o indirizzo di gruppo) per collegare la GA KNX; i dispositivi compaiono durante la digitazione.
-
-**Generale**
-
-|Proprietà|Descrizione|
-|--|--|
-| Gateway KNX | Seleziona il gateway KNX da utilizzare |
-| Hue Bridge | Seleziona il bridge Hue da utilizzare |
-| Sensore HUE | Sensore di umidità HUE (autocompletamento durante la digitazione) |
-| Leggi lo stato all'avvio | All'avvio/riconnessione legge il valore corrente e lo invia a KNX (predefinito: no) |
-
-**Associazione**
-
-|Proprietà|Descrizione|
-|--|--|
-| Umidità | GA KNX per l'umidità relativa %. DPT consigliato: <b>9.007</b> |
-
-##### Uscite
-
-1. Uscita standard
-   : `msg.payload` (numero): valore corrente di umidità relativa in %
-
-##### Dettagli
-
-`msg.payload` contiene il valore numerico dell'umidità (percentuale).
-
----
-
-<span id="hue-controller-help-scene" data-hue-controller-type="scene"></span>
-
-## 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 sul 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
-
-| Proprietà | Descrizione |
-|--|--|
-| Gateway KNX | Gateway KNX che fornisce il catalogo delle GA per l'autocomplete. |
-| Hue Bridge | Hue Bridge che ospita le scene. |
-| Scena HUE | Scena da richiamare (autocomplete; il pulsante di refresh ricarica il catalogo). |
-
-##### Scheda Mappatura
-
-| Proprietà | Descrizione |
-|--|--|
-| Richiama | Indirizzo KNX che richiama la scena. Usa DPT 1.xxx per un comando booleano o DPT 18.xxx per inviare un numero scena. |
-| DPT | Datapoint usato per il richiamo (1.xxx oppure 18.001). |
-| Nome | Etichetta descrittiva per la GA di richiamo. |
-| # | Appare quando è selezionato un DPT scena KNX; scegli il numero scena da inviare. |
-| GA stato | GA opzionale che indica se la scena è attualmente attiva (booleano). |
-
-##### Scheda Multi scena
-
-| Proprietà | Descrizione |
-|--|--|
-| Richiama | GA KNX (DPT 18.001) che consente di selezionare le scene tramite numero. |
-| Selettore scena | Lista modificabile che abbina numeri scena KNX a scene Hue e imposta la modalità di richiamo. Trascina le "grip” per riordinare. |
-
-> ℹ️ 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.
-
----
-
-<span id="hue-controller-help-device_power" data-hue-controller-type="device_power"></span>
-
-## Batteria (`device_power`)
-
-<p>Questo nodo espone su KNX il livello batteria di un dispositivo Hue ed emette un evento ogni volta che il valore cambia.</p>
-
-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**
-
-| Proprietà | Descrizione |
-|--|--|
-| Gateway KNX | Gateway KNX su cui pubblicare il livello batteria (necessario per visualizzare le opzioni KNX). |
-| Hue Bridge | Hue Bridge da utilizzare. |
-| Sensore batteria Hue | Dispositivo/sensore Hue che fornisce il livello batteria (supporta autocompletamento e refresh). |
-
-**Mappatura**
-
-| Proprietà | Descrizione |
-|--|--|
-| Livello | GA KNX per la percentuale batteria (0-100%). DPT consigliato: <b>5.001</b>. |
-
-**Comportamento**
-
-| Proprietà | Descrizione |
-|--|--|
-| Leggi stato all'avvio | All'avvio/riconnessione legge il valore corrente e lo invia su KNX. Default: "sì”. |
-| Pin di uscita del nodo | Mostra o nasconde l'uscita Node-RED. Se non selezioni alcun gateway KNX, il pin resta attivo così gli eventi Hue raggiungono comunque il flow. |
-
-> ℹ️ Le sezioni KNX vengono visualizzate solo dopo aver scelto un gateway KNX, evitando modifiche accidentali quando il nodo è usato solo verso Node-RED.
-
----
-
-<span id="hue-controller-help-zigbee_connectivity" data-hue-controller-type="zigbee_connectivity"></span>
-
-## Connettività Zigbee (`zigbee_connectivity`)
-
-<p>Questo nodo legge la connettività Zigbee da un dispositivo HUE ed espone lo stato su KNX.</p>
-
-Inizia a digitare il nome o l'indirizzo di gruppo nel campo GA: l'autocompletamento mostra i dispositivi disponibili.
-
-**Generale**
-
-| Proprietà | Descrizione |
-|--|--|
-| Gateway KNX | Gateway KNX su cui pubblicare lo stato. |
-| Hue Bridge | Hue Bridge da interrogare. |
-| Connettività Zigbee Hue | Sensore/dispositivo HUE che fornisce la connettività Zigbee (autocompletamento durante la digitazione). |
-
-**Mappatura**
-
-| Proprietà | Descrizione |
-|--|--|
-| Stato | Indirizzo di gruppo KNX che riflette la connettività Zigbee. Diventa _true_ se connesso, altrimenti _false_. |
-| Leggi stato all'avvio | Legge lo stato all'avvio/riconnessione ed emette su KNX. Default: "Sì”. |
-
-##### 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** .
-
----
-
-<span id="hue-controller-help-device_software_update" data-hue-controller-type="device_software_update"></span>
-
-## Aggiornamento software dispositivo (`device_software_update`)
-
-<p>Questo nodo monitora se un dispositivo HUE ha un aggiornamento software disponibile e pubblica lo stato su KNX.</p>
-
-Inizia a digitare il nome o l'indirizzo di gruppo del dispositivo KNX nel campo GA: l'autocompletamento mostra i dispositivi disponibili.
-
-**Generale**
-
-| Proprietà | Descrizione |
-|-|-|
-|Gateway KNX |Seleziona il gateway KNX da utilizzare |
-|Hue Bridge |Seleziona il bridge Hue da utilizzare |
-| Dispositivo Hue | Dispositivo HUE da monitorare (autocompletamento) |
-
-**Mappatura**
-
-| Proprietà | Descrizione |
-|--|--|
-| Stato | GA KNX che riflette lo stato: _true_ se update disponibile/pronto/in installazione, altrimenti _false_. |
-| Leggi stato all'avvio | Leggi all'avvio/riconnessione ed emetti su KNX (default "Sì”). |
-
-##### Output
-
-1. Uscita standard
-   : payload (boolean): flag aggiornamento.
-   : status (string): **no\_update, update\_pending, ready\_to\_install, installing** .
-
-<!-- HUE_CONTROLLER_PROFILE_HELP_END -->
-</script>