node-red-contrib-knx-ultimate/tutorial/teleprompter-it.txt

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.

# Presentazione Professionale dei Nodi KNX Ultimate

## knxUltimate-config
**A cosa serve**: definire i parametri del gateway KNX/IP e metterli a disposizione degli altri nodi.
**Funzioni principali**: supporto tunnelling/Secure, import ETS CSV con autocompletamento, diagnostica di connessione e monitor bus.
**Come si configura**: inserisci host e porta, scegli la NIC, carica il file ETS e abilita eventuali opzioni Secure o monitoraggio.

## hueConfig
**A cosa serve**: gestire l'autenticazione con il bridge Philips Hue e condividere le credenziali con gli altri nodi Hue.
**Funzioni principali**: pairing guidato, token persistenti, EventStream, fallback REST, gestione TLS/clock.
**Come si configura**: premi il pulsante link sul bridge, avvia la procedura di pairing, scegli modalità EventStream o polling e salva il nome di configurazione.

## knxUltimate
**A cosa serve**: scambiare telegrammi KNX in lettura e scrittura con conversioni DPT automatiche.
**Funzioni principali**: autocompletamento GA, filtri ETS, gestione priorità, statistiche runtime, Node Pins opzionali.
**Come si configura**: seleziona il gateway, imposta il DPT corretto, decidi ack/ritrasmissioni e abilita pin o filtri secondo la logica di flusso.

## knxUltimateSceneController
**A cosa serve**: orchestrare sequenze di scenari KNX con logica condizionale e override manuale.
**Funzioni principali**: passi programmabili, condizioni di attivazione, memoria scena, comandi manuali.
**Come si configura**: definisci le scene target, imposta ritardi e condizioni, collega i trigger tramite Node Pins.

## knxUltimateWatchDog
**A cosa serve**: sorvegliare gateway, dispositivi e gruppi KNX e avvisare in caso di timeout.
**Funzioni principali**: ping ciclici, contatore ritardi, azioni di recupero automatiche, metriche di salute.
**Come si configura**: indica le GA da monitorare, imposta intervalli/timeout e collega le uscite verso logger o alert.

## knxUltimateLogger
**A cosa serve**: registrare telegrammi e valori KNX per audit, diagnostica o esportazione.
**Funzioni principali**: buffer circolare, filtri per GA/DPT, export CSV/JSON, integrazione con context.
**Come si configura**: scegli la cartella di output, definisci retention e soglie, abilita eventuali notifiche o canali di esportazione.

## knxUltimateGlobalContext
**A cosa serve**: sincronizzare valori KNX con il contesto globale di Node-RED.
**Funzioni principali**: binding GA→context, sincronizzazione bidirezionale opzionale, filtraggio per DPT.
**Come si configura**: specifica il nome del contesto, scegli direzione di sincronizzazione e configura eventuali Node Pins per aggiornamenti esterni.

## knxUltimateAlerter
**A cosa serve**: generare notifiche quando i valori KNX superano soglie o condizioni definite.
**Funzioni principali**: comparatori multipli, isteresi, reset automatico, uscite verso email/MQTT/log.
**Come si configura**: imposta le condizioni, definisci i messaggi e collega le uscite ai canali di notifica desiderati.

## knxUltimateLoadControl
**A cosa serve**: bilanciare i carichi elettrici KNX e staccare i non essenziali al superamento soglie.
**Funzioni principali**: gruppi di carico, priorità dinamiche, cicli shed/restore, buffer eventi.
**Come si configura**: mappa le GA di misura, assegna i carichi alle fasce di priorità e configura tempi di intervento e ripristino.

## knxUltimateViewer
**A cosa serve**: offrire dashboard HTML/JSON per monitorare in tempo reale telegrammi e valori KNX.
**Funzioni principali**: tabelle live, card responsive, esportazione JSON, analisi code.
**Come si configura**: scegli le GA da mostrare, personalizza etichette e frequenza di refresh e pubblica la dashboard richiesta.

## knxUltimateAutoResponder
**A cosa serve**: rispondere automaticamente alle richieste di lettura KNX con l'ultimo valore noto.
**Funzioni principali**: cache valori, mapping multi-GA, aggiornamenti esterni via Node Pins, log attività.
**Come si configura**: definisci le GA ascolto/risposta, imposta la retention della cache e collega eventuali ingressi di aggiornamento.

## knxUltimateStaircase
**A cosa serve**: controllare luci a temporizzatore con preavviso, override e reset automatico.
**Funzioni principali**: timer multipli, impulsi di preavviso, forzature manuali, lettura stato all'avvio.
**Come si configura**: imposta GA comando/stato, durata timer, eventuali pin di override e logica di reset.

## knxUltimateGarage
**A cosa serve**: gestire portoni basculanti o sezionali con impulsi, feedback e sicurezza.
**Funzioni principali**: comando impulsivo, monitor stato, lock di sicurezza, gestione fotocellule, auto close.
**Come si configura**: assegna GA per comando/stato/allarmi, imposta tempi di corsa e configura logiche di blocco o riapertura.

## knxUltimateIoTBridge
**A cosa serve**: creare un ponte bidirezionale fra KNX e protocolli MQTT/REST/Modbus.
**Funzioni principali**: mapping tabellare, scaling valori, ack personalizzati, buffer offline.
**Come si configura**: compila la tabella di mapping, definisci i parametri di connessione esterni e imposta regole di ack/ritrasmissione.

## Pannello KNX Monitor
**A cosa serve**: visualizzare dalla barra laterale destra di Node-RED (la zona dei TAB) il traffico KNX in tempo reale.
**Funzioni principali**: refresh automatico a 1s, evidenziazione novità, toggle booleani rapidi, riordino elenco.
**Come si configura**: scegli il gateway dall'elenco, abilita/disabilita auto-refresh o riordino e filtra le GA d'interesse.

## knxUltimateHATranslator
**A cosa serve**: adattare messaggi KNX ai payload attesi da Home Assistant e viceversa.
**Funzioni principali**: mapping DPT→entità, assistente discovery, normalizzazione booleani/numeri, ack opzionali.
**Come si configura**: definisci le entità target, imposta conversioni e template e collega eventuali Node Pins per feedback.

## knxUltimateHueLight
**A cosa serve**: comandare luci Hue da KNX con supporto accensione, dimming, colore e scene dinamiche.
**Funzioni principali**: mapping multi-GA, profili giorno/notte, feedback stato, Node Pins.
**Come si configura**: assegna GA per switch/stato/dimmer/colore, imposta rampe e modalità scena e attiva EventStream dal bridge.

## knxUltimateHueButton
**A cosa serve**: ricevere eventi dai pulsanti Hue e convertirli in telegrammi KNX.
**Funzioni principali**: rilevazione corto/lungo, supporto risorse multiple, mapping DPT 1.xxx/18.xxx, debounce.
**Come si configura**: seleziona la risorsa Hue, associa le GA per ogni evento e imposta filtri di rimbalzo e feedback.

## knxUltimateHueMotion
**A cosa serve**: integrare i sensori di movimento Hue all'interno di KNX.
**Funzioni principali**: output booleano, filtri DPT, temporizzazioni, Node Pins visibili.
**Come si configura**: scegli GA movimento/stato, definisci eventuale timeout e regola la visibilità dei pin dal tab Behaviour.

## knxUltimateHueTapDial
**A cosa serve**: utilizzare Hue Tap Dial come controller rotativo o selettore scene su KNX.
**Funzioni principali**: passi incrementali/decrementali, mapping DPT 3.007/5.001/personalizzato, feedback opzionale.
**Come si configura**: imposta la risorsa Hue, definisci GA target e sensibilità e abilita i pin necessari.

## knxUltimateHueLightSensor
**A cosa serve**: portare nel bus KNX i valori di illuminamento dei sensori Hue.
**Funzioni principali**: conversione automatica in DPT 9.004, smoothing, lettura iniziale.
**Come si configura**: assegna la GA lux, definisci filtri o offset e scegli se esporre i Node Pins.

## knxUltimateHueTemperatureSensor
**A cosa serve**: pubblicare in KNX le temperature dei sensori Hue.
**Funzioni principali**: conversione DPT 9.001, offset, sync allo start, Node Pins.
**Come si configura**: imposta GA temperatura, eventuali correttivi e scegli se abilitare le uscite per altri flussi.

## knxUltimateHueScene
**A cosa serve**: attivare scene Hue da eventi KNX singoli o multi-scena.
**Funzioni principali**: supporto DPT 1.xxx/18.xxx, tab regole multi scena, feedback opzionale.
**Come si configura**: seleziona le scene Hue, associa GA trigger e status e definisci eventuali mappature avanzate.

## knxUltimateHueBattery
**A cosa serve**: monitorare lo stato batteria dei dispositivi Hue all'interno di KNX.
**Funzioni principali**: conversione device_power→DPT 5.001, lettura all'avvio, avvisi soglia, Node Pins.
**Come si configura**: assegna GA percentuale, imposta soglie di alert e decidi se generare notifiche o log.

## knxUltimateHueZigbeeConnectivity
**A cosa serve**: ricevere nel bus KNX le informazioni di connettività Zigbee dei dispositivi Hue.
**Funzioni principali**: mapping booleano, lettura iniziale, regole di fallback.
**Come si configura**: definisci GA booleano e DPT, pianifica le azioni da eseguire quando la connettività scende e collega eventuali alert.

## knxUltimateHueCameraMotion
**A cosa serve**: esporre gli eventi di movimento delle Hue Secure Cam su KNX.
**Funzioni principali**: EventStream realtime, mapping booleano, anti falsi positivi, buffer iniziale.
**Come si configura**: seleziona la telecamera, imposta GA e DPT, regola filtri e collega le uscite a logiche di sicurezza.

## knxUltimateContactSensor
**A cosa serve**: sincronizzare contatti magnetici Hue (aperto/chiuso) con indirizzi KNX.
**Funzioni principali**: filtro risorsa `contact`, mapping DPT 1.019, possibilità di inversione logica, label ETS.
**Come si configura**: scegli il sensore, mappa GA stato/allarme e imposta eventuali alert o ritardi.

## knxUltimateHueHumiditySensor
**A cosa serve**: inviare al bus KNX l'umidità relativa dei sensori Hue.
**Funzioni principali**: scaling DPT 9.007, smoothing facoltativo, lettura iniziale, Node Pins.
**Come si configura**: assegna GA umidità, definisci filtri o soglie e collega le uscite dove necessario.

## knxUltimateHuePlug
**A cosa serve**: controllare le prese smart Hue e ricevere feedback di stato o potenza.
**Funzioni principali**: comandi on/off, canali stato/potenza, power availability, Node Pins.
**Come si configura**: mappa GA comando/stato/potenza, scegli il DPT corretto e abilita letture automatiche allo start.

## knxUltimateHuedevice_software_update
**A cosa serve**: notificare via KNX la disponibilità di aggiornamenti firmware Hue.
**Funzioni principali**: interpretazione stati `up_to_date/available/required`, log eventi, avvisi programmabili.
**Come si configura**: definisci GA di alert, imposta la politica di notifica e collega eventuali dashboard o sistemi di ticketing.