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

package/nodes/locales/it/knxUltimateMatterBridge.html

@@ -1,65 +0,0 @@
-<script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-### 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/>
-
-## Panoramica
-
-Ogni nodo Expose KNX to Matter espone **un dispositivo KNX come dispositivo Matter**: i controller abbinati (Alexa, Google Home, Apple Home...) lo vedono, con il nome che hai scelto, pronto per il controllo da app e vocale. Puntalo a un nodo di configurazione **Bridge Matter** (il bridge vero e proprio, abbinato una sola volta - il QR di abbinamento vive lì) e aggiungi quanti nodi device vuoi, ovunque nei tuoi flow.
-
-È la direzione opposta del nodo *Matter Device*: lì KNX controlla un dispositivo Matter, qui i controller Matter controllano KNX.
-
-Cambiare il tipo dispositivo dopo l'abbinamento del bridge modifica la struttura dell'endpoint Matter. I controller possono conservare il vecchio endpoint come irraggiungibile; in tal caso resetta/riabbina il bridge oppure crea un nuovo dispositivo esposto.
-
-## Configurazione
-
-|Campo|Descrizione|
-|--|--|
-| Bridge Matter | Il nodo di configurazione Bridge Matter a cui appartiene questo dispositivo |
-| GW KNX | Gateway KNX usato per i telegrammi. **Opzionale**: senza, il dispositivo funziona in modalità solo-flow tramite i PIN del nodo. Selezionato automaticamente se il progetto ha un solo gateway |
-| Nome | Quello che Alexa & Co. mostrano e usano per i comandi vocali |
-| Tipo dispositivo | Il tipo di dispositivo Matter (vedi sotto); determina quali campi indirizzo di gruppo compaiono |
-| Leggi lo stato all'avvio | Invia una `GroupValue_Read` ai GA di stato all'avvio, per popolare gli attributi Matter |
-
-## Tipi di dispositivo e indirizzi di gruppo
-
-|Tipo|Indirizzi di gruppo|
-|--|--|
-| Luce On/Off, Presa | GA comando On/Off, GA stato On/Off (DPT 1.001) |
-| Luce dimmerabile | + GA comando/stato dimmer % (DPT 5.001) |
-| Luce RGB (colore) | + GA comando/stato colore RGB (DPT 232.600). Il colore Matter (hue/saturation o XY, dalla ruota colore dell'app) viene convertito da/verso la terna RGB KNX |
-| Luce bianco dinamico | + GA comando/stato temperatura colore in Kelvin (DPT 7.600) |
-| Tapparella / Tenda | Su/Giù (DPT 1.008), Stop (DPT 1.017), posizione % comando/stato (DPT 5.001), inversione posizione opzionale |
-| Termostato (riscaldamento e/o raffrescamento) | GA temperatura attuale, GA comando/stato setpoint (DPT 9.001). Aggiungendo anche il GA comando/stato setpoint raffrescamento si espone anche la modalità Cool (doppio setpoint) |
-| Condizionatore ambiente | Un unico dispositivo Matter che combina GA comando/stato On/Off (DPT 1.001), temperatura attuale e setpoint caldo/freddo (DPT 9.001), e velocità ventola % (DPT 5.001) |
-| Ventola / VMC | GA comando/stato velocità % (DPT 5.001) |
-| Serratura porta | GA comando blocco/sblocco e GA stato bloccato/sbloccato (DPT 1.001; `true` = bloccata) |
-| Sensori (temperatura, umidità, luminosità, presenza, contatto) | Un GA di stato ciascuno |
-| Rilevatore fumo/CO | GA stato allarme fumo + GA stato allarme CO opzionale (DPT 1.005): notifiche critiche sul telefono |
-| Rilevatore allagamento | GA stato allagamento (DPT 1.005) |
-| Sensore qualità aria (CO2) | GA stato CO2 in ppm (DPT 9.008); la classe qualità aria (buona/discreta/moderata/scarsa...) è derivata automaticamente |
-| Robot aspirapolvere | **Solo-flow**: nessun indirizzo di gruppo. Abilita i PIN del nodo: i comandi dell'assistente ("avvia pulizia", pausa/riprendi/torna alla base) arrivano sull'output come `rvcmode`/`rvccommand`; riporta lo stato con `msg.payload = { function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" }` e la modalità con `function: "rvcmode", value: "cleaning"\|"idle"` |
-
-- **GA comando**: scritto sul bus KNX quando l'assistente invia un comando.
-- **GA stato**: letto dal bus per tenere aggiornati gli attributi Matter (e le app).
-
-## Compatibilità avanzata
-
-Queste opzioni sono nascoste finché non servono al tipo selezionato. I dispositivi dimmerabili possono ignorare il comando luminosità che alcuni controller inviano subito dopo `On`. Per le tapparelle, **Scambia Apri / Chiudi** inverte sia il comando KNX binario sia la direzione percentuale. **Debounce slider tapparella** accorpa i target intermedi rapidi prima della scrittura KNX: `0` usa finestre adattive (400 ms per il primo comando, 150 ms per i successivi); `1`–`5000` imposta una finestra fissa. Le tapparelle possono inoltre aggiornare ottimisticamente la posizione Matter e correggerla quando arriva la posizione reale dalla GA di stato KNX.
-
-## PIN del nodo
-
-Il selettore dei PIN si trova fuori dalle TAB dell'editor. Abilitandolo compare subito sotto una sezione contestuale **Input/output del flow**, con esempi copiabili filtrati per il tipo di dispositivo selezionato:
-
-- **Input**: aggiorna lo stato Matter dal flow, senza passare dal bus KNX: `msg.payload = { function: "onoff", value: true }` (`function` è una tra `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `coolingsetpoint`, `fanspeed`, `lock`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Utile per esporre ad Alexa & Co. valori calcolati nel flow (es. un sensore virtuale).
-- **Output**: ogni comando ricevuto da un controller Matter viene inoltrato al flow: `msg.topic` = nome del dispositivo, `msg.payload` = valore, `msg.matter` = il comando grezzo. Un dispositivo senza GA di comando diventa un **dispositivo solo-flow**.
-
-## Note
-
-- L'identità Matter del dispositivo è legata a questo nodo: eliminando il nodo e creandone uno nuovo, le app vedono un dispositivo nuovo di zecca.
-- I nodi device aggiunti/rinominati/rimossi vengono recepiti dai controller abbinati in pochi secondi, senza riabbinare il bridge.
-</script>

package/nodes/locales/it/knxUltimateMatterBridge.json

@@ -1,123 +0,0 @@
-{
-  "knxUltimateMatterBridge": {
-    "title": "Expose KNX to Matter",
-    "bridge_name": "Nome del bridge Matter",
-    "port": "Porta",
-    "devices_help": "Aggiungi i dispositivi KNX da esporre su Matter. Il \"Nome\" è quello che Alexa/Google/Apple mostrano e usano per i comandi vocali. GA comando = scritto quando l'assistente invia un comando; GA stato = letto dal bus per tenere aggiornata l'app.",
-    "read_status_startup": "Leggi i GA di stato all'avvio",
-    "opt_yes": "Sì",
-    "opt_no": "No",
-    "node_pins": "PIN Input/Output del nodo",
-    "node_pins_hide": "Nascondi",
-    "node_pins_show": "Mostra i PIN input/output del nodo",
-    "type_change_warning": "Cambiare il tipo dispositivo dopo che il bridge è già stato abbinato modifica la struttura dell'endpoint Matter. Alexa/Google/Apple possono mantenere il vecchio endpoint come irraggiungibile; potrebbe servire resettare/riabbinare il Matter Bridge o creare un nuovo dispositivo esposto.",
-    "fields": {
-      "type": "Tipo dispositivo",
-      "name": "Nome (mostrato da Alexa & Co.)",
-      "name_placeholder": "es. Luce cucina",
-      "invert": "Inverti posizione %"
-    },
-    "advanced": {
-      "title": "Compatibilità avanzata",
-      "help": " Usa queste opzioni solo quando un controller Matter o un attuatore KNX richiede una gestione speciale.",
-      "alexa_dedup_ms": "Finestra anti-duplicati Alexa (ms, 0 = off)",
-      "turn_on_behavior": "Comportamento all'accensione",
-      "turn_on_ignore_level": "Ignora luminosità inviata subito dopo On",
-      "turn_on_forward_all": "Inoltra ogni comando luminosità",
-      "ignore_level_ms": "Ignora luminosità dopo On (ms)",
-      "cover_swap_open_close": "Scambia Apri / Chiudi tapparella",
-      "cover_slider_debounce": "Debounce slider tapparella (ms, 0 = adattivo)",
-      "cover_update_mode": "Aggiornamento stato tapparella",
-      "cover_optimistic": "Aggiorna ottimisticamente la posizione Matter",
-      "cover_wait_status": "Attendi solo lo stato KNX",
-      "cover_status_timeout": "Timeout stato tapparella (ms)"
-    },
-    "tabs": {
-      "mappings": "Mappature KNX",
-      "advanced": "Opzioni avanzate"
-    },
-    "flow_help": {
-      "title": "Input/output del flow",
-      "intro": "Questi esempi corrispondono al tipo di dispositivo selezionato e sono disponibili quando i PIN input/output del nodo sono abilitati.",
-      "input_title": "Flow → Matter (input del nodo)",
-      "input_hint": "Invia uno di questi messaggi per aggiornare lo stato Matter esposto senza scrivere sul bus KNX.",
-      "output_title": "Matter → Flow (output del nodo)",
-      "output_hint": "I comandi ricevuti da un controller Matter vengono emessi con il valore in msg.payload e i dettagli raw in msg.matter.",
-      "function": "Funzione",
-      "message": "Messaggio di esempio",
-      "copy": "Copia",
-      "copied": "Messaggio copiato",
-      "no_input": "Questo tipo di dispositivo non ha esempi di aggiornamento stato dal flow.",
-      "no_output": "Questo tipo di dispositivo non emette comandi dal controller; il suo output rimane inattivo."
-    },
-    "functions": {
-      "fn_onoff_cmd": "GA comando On/Off",
-      "fn_onoff_status": "GA stato On/Off",
-      "fn_level_cmd": "GA comando dimmer %",
-      "fn_level_status": "GA stato dimmer %",
-      "fn_sensor_ga": "GA stato sensore",
-      "fn_updown": "GA comando Su/Giù",
-      "fn_stop": "GA comando Stop",
-      "fn_position_cmd": "GA comando posizione %",
-      "fn_position_status": "GA stato posizione %",
-      "fn_currenttemp": "GA temperatura attuale",
-      "fn_setpoint_cmd": "GA comando setpoint",
-      "fn_setpoint_status": "GA stato setpoint",
-      "fn_coolingsetpoint_cmd": "GA comando setpoint raffrescamento",
-      "fn_coolingsetpoint_status": "GA stato setpoint raffrescamento",
-      "fn_rgb_cmd": "GA comando colore RGB (DPT 232.600)",
-      "fn_rgb_status": "GA stato colore RGB (DPT 232.600)",
-      "fn_ct_cmd": "GA comando temperatura colore (Kelvin)",
-      "fn_ct_status": "GA stato temperatura colore (Kelvin)",
-      "fn_smoke_ga": "GA stato allarme fumo",
-      "fn_co_ga": "GA stato allarme CO (opzionale)",
-      "fn_leak_ga": "GA stato allagamento",
-      "fn_co2_ga": "GA stato CO2 (ppm, DPT 9.008)",
-      "fn_fanspeed_cmd": "GA comando velocità ventola %",
-      "fn_fanspeed_status": "GA stato velocità ventola %",
-      "fn_lock_cmd": "GA comando blocco/sblocco",
-      "fn_lock_status": "GA stato bloccato/sbloccato"
-    },
-    "types": {
-      "onofflight": "Luce On/Off",
-      "dimmablelight": "Luce dimmerabile",
-      "rgblight": "Luce RGB (colore)",
-      "colortemperaturelight": "Luce bianco dinamico (temperatura colore)",
-      "onoffplug": "Presa (on/off)",
-      "temperaturesensor": "Sensore temperatura",
-      "humiditysensor": "Sensore umidità",
-      "lightsensor": "Sensore luminosità (Lux)",
-      "occupancysensor": "Sensore presenza",
-      "contactsensor": "Sensore contatto",
-      "windowcovering": "Tapparella / Tenda",
-      "thermostat": "Termostato (riscaldamento)",
-      "roomairconditioner": "Condizionatore ambiente",
-      "fan": "Ventola / VMC",
-      "doorlock": "Serratura porta",
-      "smokecoalarm": "Rilevatore fumo/CO",
-      "waterleakdetector": "Rilevatore allagamento",
-      "airqualitysensor": "Sensore qualità aria (CO2)",
-      "robotvacuum": "Robot aspirapolvere (solo-flow, via PIN del nodo)"
-    },
-    "pairing": {
-      "title": "Abbinamento (Alexa, Google Home, Apple Home...)",
-      "not_running": "Il bridge Matter non è ancora in esecuzione. Fai il deploy, attendi qualche secondo e clicca aggiorna.",
-      "commissioned": "Bridge abbinato a questi controller:",
-      "awaiting": "In attesa di abbinamento. Scansiona il QR code o inserisci il codice manuale nella tua app Matter:",
-      "qr_link": "Apri il QR code nel browser",
-      "deploy_first": "Fai prima il deploy di questo nodo, poi clicca aggiorna.",
-      "reset_button": "Reset abbinamento",
-      "reset_confirm": "Rimuovere TUTTI i controller abbinati e riavviare l'abbinamento? I dispositivi spariranno da Alexa/Google/Apple.",
-      "reset_ok": "Abbinamento resettato. Il bridge è di nuovo in attesa di abbinamento."
-    },
-    "bridge": "Bridge Matter",
-    "device_name": "Nome (mostrato da Alexa & Co.)",
-    "device_help": "Scegli il tipo di dispositivo e dagli il nome che userà l'assistente vocale, poi compila gli indirizzi di gruppo. Il gateway KNX è opzionale: senza, abilita i PIN del nodo e piloti il dispositivo dal flow."
-  },
-  "common": {
-    "ga": "GA",
-    "dpt": "DPT",
-    "name": "Nome",
-    "knx_gw": "GW KNX"
-  }
-}

package/nodes/locales/it/knxUltimateMatterControllerDevice.html

@@ -1,57 +0,0 @@
-<script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-### 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/>
-
-Questo nodo controlla da KNX un endpoint Matter già abbinato. Seleziona il dispositivo Matter e l'editor rileva le sue capability, mostrando solo le mappature KNX coerenti con quell'endpoint.
-
-Un click o il focus sul campo del dispositivo Matter apre sempre l'elenco completo degli endpoint abbinati, anche quando un dispositivo è già selezionato. Digitando, l'elenco continua a essere filtrato.
-
-Sostituisce i nodi Matter separati non pubblicati e mantiene tutta la UI luce quando l'endpoint selezionato è una luce.
-
-## Configurazione
-
-|Campo|Descrizione|
-|--|--|
-| KNX GW | Gateway KNX usato per scrivere e rispondere sugli indirizzi di gruppo configurati. Può restare vuoto se serve solo l'output Node-RED. Il gateway salvato rimane selezionato durante l'inizializzazione dell'editor e cambia soltanto dopo una selezione esplicita dell'utente. |
-| Matter controller | Nodo di configurazione Matter Controller in cui il dispositivo è stato associato. |
-| Dispositivo Matter | Endpoint Matter selezionato tra i dispositivi abbinati. La UI viene ricostruita in base alle capability reali. |
-| Switch / Presa / Luce On-Off | Indirizzi di gruppo di comando e stato On/Off, di solito DPT `1.001`. |
-| Serratura | Un GA comando DPT `1.xxx` invoca `lockDoor` con `true` e `unlockDoor` con `false`; un GA di stato separato riceve soltanto gli stati non ambigui Bloccata/Sbloccata. Se richiesto dall'endpoint, salva il PIN per operazioni remote nel campo credential. I comandi non annunciati dall'endpoint vengono rifiutati. |
-| Altri endpoint | Prese, attuatori On/Off, tapparelle, termostati, ventilatori, sensori ambientali/contatto/presenza, batteria, potenza ed energia usano il profilo multi-purpose. La TAB **Mappature** contiene soltanto le funzioni supportate dai cluster, attributi e comandi annunciati dall'endpoint; lascia vuoto un GA per disabilitarlo. |
-| Controlli luce | Per gli endpoint luce viene usata la stessa UI luce completa: DIM relativo (DPT `3.007`), luminosità %, RGB/HSV, bianco dinamico, luminosità/temperatura all'accensione, modalità giorno/notte, livello min/max e velocità dimmer. Le sezioni non supportate restano nascoste. |
-| Sensori | Gli endpoint sensore mostrano il relativo GA di misura/stato solo quando supportato: temperatura, umidità, illuminamento, presenza, contatto e batteria. |
-| Read at startup | Pubblica il valore Matter in cache al deploy/avvio o quando il dispositivo si riconnette. |
-| Update local state from KNX write | Aggiorna la cache locale Matter/KNX quando arriva una scrittura su un GA KNX configurato. |
-| Node Input/Output PINs | Mostra i pin input/output Node-RED e la sezione **Input dal flow** subito sotto questo campo. Per le luci sono mostrati i messaggi di stato luce supportati al primo livello; per gli endpoint non luce sono mostrati il formato semplice `{function,value}` e i campi Matter avanzati. La selezione viene mantenuta alla riapertura dell'editor. |
-
-## Input dal flow
-
-Abilita **PIN di Input/Output del nodo** per mostrare la sezione **Input dal flow** subito sotto il selettore. Per le luci contiene esempi copiabili delle proprietà supportate al primo livello, come `msg.on`, `msg.dimming`, `msg.color_temperature` e `msg.color`. Per gli endpoint non luce viene costruita dalla struttura annunciata e mostra l'Endpoint ID selezionato, tutti gli attributi leggibili/scrivibili e tutti i comandi accettati. Rimane disponibile anche quando il nodo viene usato soltanto dal flow senza gateway KNX.
-
-Le scritture semplici usano `msg.payload = {function:"position",value:35}`. Ometti `value` per leggere uno stato supportato, ad esempio `{function:"temperature"}`; l'output usa unità comprensibili e include i dettagli raw in `msg.matter`. Le funzioni comprendono `onoff`, `level`, `position`, `tiltposition`, `open`, `close`, `stop`, `setpoint`, `coolingsetpoint`, `currenttemp`, `fanspeed`, letture sensore e `identify`, ma soltanto se annunciate dall'endpoint. La serratura accetta `{function:"lock",value:true|false}`.
-
-Gli input avanzati esistenti restano validi: usa `msg.clusterId` al primo livello con `msg.command`/`msg.args`, oppure `msg.attribute` con l'eventuale `msg.value`. Node ID ed Endpoint ID sono già selezionati dal nodo; `msg.endpointId` serve solo come override opzionale.
-
-## Modalità Universale
-
-Seleziona **Modalità Universale** nel selettore **Modalità** per ricevere tutti i report attributo, gli eventi cluster e le inizializzazioni dei dispositivi. Ha sempre un input e un output e non usa le mappature del singolo endpoint. Il gateway KNX è opzionale e serve solo alle GA allarme/testo del Monitor batterie.
-
-Il **Monitor batterie universale** cerca Power Source in tutti gli endpoint e conserva lo stato normalizzato completo. Le GA KNX opzionali pubblicano l'allarme complessivo come DPT 1.005 e ciclano ogni 2 secondi i nomi dei device scarichi come DPT 16.001. Invia `{payload:{action:"getAllBatteries"}}` per ottenere l'inventario in cache.
-
-L'output contiene il valore raw in `msg.payload` e i dati di instradamento in `msg.matter` (`source`, `nodeId`, `endpointId`, `clusterId`, nome attributo/evento). L'input usa `msg.nodeId`, `msg.endpointId`, `msg.clusterId` e `msg.command` con `msg.args`, oppure `msg.attribute`; aggiungi `msg.value` per scrivere, omettilo per leggere. Gli stessi campi possono stare in `msg.matter`.
-
-Esempi: `{nodeId:"100",endpointId:1,clusterId:6,command:"on",args:{}}` accende; `{nodeId:"100",endpointId:1,clusterId:47,attribute:"batPercentRemaining"}` legge la batteria. Il valore batteria resta nell'unità raw Matter a mezzi punti percentuali; dividilo per due in un nodo Function.
-
-## Comportamento
-
-Il nodo mantiene una cache locale da aggiornamenti Matter e scritture KNX, risponde alle letture KNX dalla cache e può emettere/leggere i valori all'avvio. Ascolta solo gli indirizzi di gruppo configurati, quindi ignora il traffico KNX non pertinente.
-
-I comandi vengono eseguiti in una coda ordinata separata per ciascun dispositivo associato. Un dispositivo offline, in timeout o rimosso non può quindi ritardare gli altri dispositivi Matter che usano lo stesso indirizzo di gruppo KNX. Un nodo che punta ancora a un dispositivo rimosso rifiuta subito il comando e mostra in rosso **Device no longer commissioned**; seleziona un dispositivo Matter valido oppure elimina il nodo Controller rimasto orfano.
-
-L'errore di dispositivo non disponibile rimane agganciato: i successivi comandi KNX e flow vengono ignorati e non possono sovrascrivere lo stato rosso. Il nodo riprende automaticamente non appena quel dispositivo Matter segnala `connected`; anche l'apertura dell'editor del nodo azzera il blocco per consentire un tentativo manuale.
-</script>

package/nodes/locales/it/knxUltimateMatterControllerDevice.json

@@ -1,146 +0,0 @@
-{
-  "knxUltimateMatterControllerDevice": {
-    "title": "Control Matter from KNX",
-    "node-input-name": "Nome",
-    "node-input-nameLightSwitch": "Comando (bit)",
-    "node-input-GALightSwitch": "GA",
-    "node-input-dptLightSwitch": "dpt",
-    "node-input-nameLightState": "Stato (bit)",
-    "node-input-GALightState": "GA",
-    "node-input-dptLightState": "dpt",
-    "node-input-hueLight": "Dispositivo Matter",
-    "paletteLabel": "Control Matter from KNX",
-    "no_devices": "Nessun dispositivo Matter trovato. Controlla il controller Matter e premi l'icona di aggiornamento.",
-    "input_help_label": "Input dal flow",
-    "input_help_pin_hint": "Abilita i PIN di input/output del nodo prima di inviare questi messaggi.",
-    "input_help_endpoint": "Endpoint selezionato",
-    "input_help_endpoint_hint": "Il nodo conosce già Node ID ed Endpoint ID, quindi non servono nei messaggi semplici.",
-    "input_help_simple_title": "Messaggi semplici",
-    "input_help_simple_hint": "Queste funzioni usano unità comprensibili e vengono tradotte nel cluster, comando o attributo Matter esposto dall'endpoint selezionato.",
-    "input_help_light_hint": "Gli endpoint luce accettano le proprietà dello stato luce direttamente in msg (non dentro msg.payload). Sono mostrati solo i controlli supportati dalla luce selezionata.",
-    "input_help_advanced_title": "Dettagli Matter avanzati",
-    "input_help_advanced_hint": "Sono elencati soltanto attributi e comandi annunciati. Gli esempi di scrittura usano 0 come segnaposto; gli argomenti dei comandi possono richiedere un adattamento al tipo Matter.",
-    "input_help_operation": "Operazione",
-    "input_help_function": "Funzione",
-    "input_help_target": "Target Matter",
-    "input_help_message": "Messaggio",
-    "input_help_read": "Lettura",
-    "input_help_write": "Scrittura",
-    "input_help_command": "Comando",
-    "input_help_copy": "Copia",
-    "input_help_copied": "Messaggio copiato",
-    "input_help_no_simple": "Questo endpoint non espone funzioni semplici conosciute.",
-    "input_help_no_structure": "La struttura Matter non è disponibile. Aggiorna la lista dei dispositivi mentre l'endpoint è online.",
-    "input_functions": {
-      "onoff": "On / Off", "on": "Accendi", "off": "Spegni", "level": "Livello", "brightness": "Luminosità", "color_temperature": "Temperatura colore", "xy_color": "Colore XY", "position": "Posizione tapparella", "tiltposition": "Inclinazione tapparella", "open": "Apri", "close": "Chiudi", "stop": "Stop", "setpoint": "Setpoint riscaldamento", "coolingsetpoint": "Setpoint raffrescamento", "currenttemp": "Temperatura corrente", "fanspeed": "Velocità ventilatore", "temperature": "Temperatura", "humidity": "Umidità", "illuminance": "Illuminamento", "occupancy": "Presenza", "contact": "Contatto", "battery": "Batteria", "activepower": "Potenza attiva", "importedenergy": "Energia importata", "identify": "Identifica", "lock": "Blocca", "unlock": "Sblocca"
-    },
-    "tabs": {
-      "switch": "On/Off",
-      "dim": "Dimmer",
-      "tunable_white": "Bianco regolabile",
-      "rgb_hsv": "RGB/HSV",
-      "effects": "Effetti",
-      "mappings": "Mappature",
-      "behaviour": "Comportamento"
-    },
-    "control": "Comando",
-    "status": "Stato",
-    "door_lock_command": "Blocca / sblocca",
-    "door_lock_status": "Stato serratura",
-    "door_lock_pin": "PIN operazione remota",
-    "door_lock_pin_required": "La serratura indica che per le operazioni remote è richiesto un PIN.",
-    "door_lock_commands_missing": "L'endpoint non annuncia entrambi i comandi di blocco e sblocco. I comandi mancanti saranno rifiutati.",
-    "mapped": {
-      "onoff_command": "Comando On / Off", "onoff_state": "Stato On / Off", "cover_updown": "Tapparella su / giù", "cover_stop": "Stop tapparella", "cover_position_command": "Comando posizione tapparella", "cover_position_state": "Stato posizione tapparella", "heating_command": "Comando setpoint riscaldamento", "heating_state": "Stato setpoint riscaldamento", "cooling_command": "Comando setpoint raffrescamento", "cooling_state": "Stato setpoint raffrescamento", "local_temperature": "Temperatura locale", "fan_command": "Comando velocità ventilatore", "fan_state": "Stato velocità ventilatore", "temperature": "Temperatura", "humidity": "Umidità", "illuminance": "Illuminamento", "occupancy": "Presenza", "contact": "Stato booleano / contatto", "battery": "Batteria", "active_power": "Potenza attiva", "imported_energy": "Energia importata"
-    },
-    "night_lighting": "Illuminazione notturna",
-    "no_night_lighting": "Nessuna illuminazione notturna",
-    "get_current": "Acquisisci colore attuale",
-    "get_again": "Acquisisci di nuovo",
-    "wait": "Attendere...",
-    "locate_no_bridge": "Seleziona prima un controller Matter",
-    "locate_no_device": "Seleziona prima un dispositivo Matter",
-    "locate_success": "Comando di localizzazione inviato",
-    "locate_started": "Modalità di localizzazione avviata. Premi di nuovo per fermarla (si ferma automaticamente dopo 10 minuti).",
-    "locate_stopped": "Modalità di localizzazione terminata.",
-    "locate_start_title": "Localizza il dispositivo Matter selezionato",
-    "locate_stop_title": "Ferma la modalità di localizzazione",
-    "locate_error": "Impossibile localizzare il dispositivo Matter",
-    "day_night": "Giorno/Notte",
-    "invert_day_night": "Inverti valore giorno/notte",
-    "override_night_mode": "Forza modalità diurna",
-    "override_no": "No",
-    "override_set_day_fast_this": "Passa a GIORNO spegnendo e riaccendendo velocemente (solo questa luce)",
-    "override_set_day_fast_all": "Passa a GIORNO spegnendo e riaccendendo velocemente (tutte le luci)",
-    "node_pins": "PIN di Input/Output del nodo",
-    "node_pins_hide": "Nascondi",
-    "node_pins_show": "Mostra PIN di input/output",
-    "read_status_startup": "Leggi lo stato all'avvio",
-    "opt_no": "No",
-    "opt_yes_emit": "Sì, ed emetti i telegrammi KNX.",
-    "knx_brightness_status": "Stato luminosità KNX",
-    "knx_brightness_onhueoff": "Se la luce Matter è spenta invia 0%. Se è accesa, ripristina il valore precedente (comportamento KNX predefinito)",
-    "knx_brightness_no": "Lascia invariato (comportamento Matter predefinito)",
-    "update_local_state_from_knx_write": "Aggiorna lo stato Matter locale in cache dai write provenienti dal bus KNX",
-    "update_local_state_from_knx_write_hint": "Abilitato: reazioni locali più rapide e risposte immediate ai read KNX più coerenti. Disabilitato: la cache si aggiorna solo dai report Matter reali.",
-    "use_min_brightness": "Usa la luminosità minima specificata per la luce Matter",
-    "k_suffix": "K",
-    "temp_desc_2200": "(inizio della gamma Philips White Ambiance)",
-    "temp_desc_2700": "(bianco caldo, intimo, accogliente, personale, per soggiorni)",
-    "temp_desc_3000": "(bianco tenue, caldo, rilassante, per bagni e cucine)",
-    "temp_desc_3500_day": "(bianco neutro, equilibrato, amichevole, invitante, per uffici e negozi)",
-    "temp_desc_3500_night": "(sconsigliato di notte - bianco neutro, per uffici e negozi)",
-    "temp_desc_4100_day": "(bianco freddo, preciso, pulito, focalizzato, per garage e supermercati)",
-    "temp_desc_4100_night": "(sconsigliato di notte - bianco freddo, preciso, pulito, focalizzato, per garage e supermercati)",
-    "temp_desc_5000_day": "(bianco brillante, vivace, nitido, per magazzini, stadi e sanità)",
-    "temp_desc_5000_night": "(sconsigliato di notte - bianco brillante, vivace, nitido, per magazzini, stadi e sanità)",
-    "temp_desc_6500_day": "(luce diurna, allerta, energizzante, per agricoltura indoor)",
-    "temp_desc_6500_night": "(sconsigliato di notte - luce diurna, allerta, energizzante, per agricoltura indoor)",
-    "switch_on_behaviour": "Comportamento all'accensione",
-    "none": "Nessuno",
-    "switch_off": "(Spenta)",
-    "select_color": "Seleziona colore",
-    "select_temperature_brightness": "Seleziona temperatura e luminosità",
-    "select_brightness": "Seleziona luminosità",
-    "effect_command": "Comando effetti",
-    "effect_status": "Stato effetti",
-    "effect_mapping": "Associazioni",
-    "effect_autofill": "Compila con gli effetti disponibili",
-    "effect_tip": "Definisci le coppie valore KNX / effetto Matter. Quando il valore KNX ricevuto coincide, viene attivato l'effetto selezionato.",
-    "effect_tip_status": "Se configuri lo stato, il nodo invierà su KNX l'effetto corrente (valore associato o nome).",
-    "effect_not_supported": "Questa lampada non espone effetti Matter.",
-    "effect_knx_value_placeholder": "Valore da confrontare",
-    "effect_base_label": "Effetti base Matter",
-    "effect_native_label": "Effetti nativi Matter",
-    "matter_controller": "Controller Matter",
-    "matter_device": "Dispositivo Matter",
-    "device_type": "Tipo dispositivo",
-    "matter_section": "Dispositivo Matter",
-    "controller_mode": "Modalità",
-    "single_mode": "Dispositivo singolo",
-    "universal_mode": "Modalità universale (tutti i dispositivi Matter)",
-    "universal_mode_description": "Ascolta e controlla tutti i dispositivi Matter collegati a questo controller. La Modalità Universale funziona senza mappature KNX.",
-    "universal_service": "Servizio",
-    "universal_service_battery_monitor": "Monitor batterie universale",
-    "universal_service_all_events": "Tutti gli eventi Matter",
-    "universal_battery_threshold": "Soglia batteria scarica",
-    "universal_low_battery_ga": "GA allarme batteria",
-    "universal_low_battery_text_ga": "GA nome device scarico",
-    "universal_battery_only_low": "Emetti solo batterie scariche",
-    "universal_emit_initial": "Emetti snapshot iniziale batterie",
-    "universal_include_raw": "Includi evento Matter raw",
-    "universal_mode_status": "Modalità Matter universale",
-    "universal_mode_locate_disabled": "La funzione Trova non è disponibile in Modalità Universale.",
-    "universal_controller_name": "Controller Matter Universale"
-  },
-  "common": {
-    "ga": "GA",
-    "dpt": "DPT",
-    "name": "Nome",
-    "youtube_sample": "Esempio YouTube",
-    "knx_gw": "Gateway KNX",
-    "hue_bridge": "Controller Matter",
-    "philips_hue": "Matter",
-    "read": "Leggi"
-  }
-}

package/nodes/locales/it/knxUltimateSceneController.html

@@ -1,101 +0,0 @@
-<script type="text/markdown" data-help-name="knxUltimateSceneController">
-### 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/>
-
-**Deprecato:** Questo nodo dedicato resta supportato nei flow esistenti. Per i nuovi flow usa **KNX Utility** e seleziona la funzione corrispondente. Il nodo legacy è nascosto nella palette e contrassegnato con `(deprecated)` nel flow. Il suo editor offre un pulsante per convertire tutti i nodi utility KNX legacy compatibili in tutti i flow e subflow dopo conferma. La conversione avviene localmente nel browser, conserva ID, impostazioni, collegamenti e gruppi e supporta Annulla. La conferma chiude l’editor del nodo corrente e scarta le modifiche non salvate. Controlla il risultato prima di premere Deploy.
-
-# Scene Controller
-
-Il nodo Scene Controller si comporta come un dispositivo KNX di controllo scene: consente di salvare e richiamare una scena.
-
-## Impostazioni del nodo
-
-| Proprietà | Descrizione |
-|--|--|
-| Gateway | Gateway KNX selezionato. |
-| Richiama Scena | **Datapoint** e **Valore di attivazione**. Indirizzo di gruppo per il richiamo scena (es. `0/0/1`). Il nodo reagisce ai telegrammi ricevuti su questa GA richiamando la scena. Il Datapoint è il DPT della GA di richiamo scena. Il valore di attivazione è il valore che deve essere ricevuto per attivare il richiamo. Ricorda: per richiamare/salvare una scena con un comando DIM, inserisci nel campo del valore di attivazione l'oggetto corretto di dimming (`{decr_incr:1,data:5}` per alzare, `{decr_incr:0,data:5}` per abbassare). |
-| Salva Scena | **Datapoint** e **Valore di attivazione**. Indirizzo di gruppo per il salvataggio scena (es. `0/0/2`). Il nodo reagisce ai telegrammi ricevuti salvando i valori correnti di tutti i dispositivi della scena in memoria non volatile. Il Datapoint è il DPT della GA di salvataggio. Il valore di attivazione è il valore che deve essere ricevuto per attivare il salvataggio. Ricorda: per richiamare/salvare una scena con DIM usa l'oggetto di dimming come sopra. |
-| Nome nodo | Nome nodo (puoi indicare ad es. "Recall: <dispositivo> / Save: <dispositivo>"). |
-| Topic | Topic del nodo. |
-
-## Configurazione scena
-
-Aggiungi i dispositivi alla scena, come faresti con un vero controllore scene KNX. Ogni riga rappresenta un dispositivo.
-
-La scena salva automaticamente i nuovi valori degli attuatori della lista non appena arrivano dal BUS.
-
-| Proprietà | Descrizione |
-|--|--|
-| Pulsante Aggiungi | Aggiunge una riga. |
-| Campi riga | 1) Indirizzo di gruppo 2) Datapoint 3) Valore predefinito per questo dispositivo nella scena (può essere sovrascritto da Salva Scena). Sotto, il nome del dispositivo.<br/> Per inserire una pausa, scrivi **wait** nel primo campo e un numero nell'ultimo campo, che rappresenta la durata (millisecondi), ad es. `2000`.<br/> Il comando **wait** accetta anche secondi, minuti o ore: aggiungi `s` (es. `12s`), `m` (es. `5m`) o `h` (es. `1h`). |
-| Pulsante Rimuovi | Rimuove una riga/dispositivo. |
-
-## Messaggi in uscita
-
-```javascript
-
-msg = {
-  topic: "Scene Controller", // topic del nodo
-  recallscene: true|false, // true se è stata richiamata una scena
-  savescene: true|false, // true se è stata salvata una scena
-  savevalue: true|false, // true se è stato salvato manualmente il valore di una GA di un attuatore della scena
-  disabled: true|false // true se il controller scena è stato disabilitato via msg.disabled = true
-}
-```
-
----
-
-## Messaggi di ingresso (INPUT)
-
-Il nodo reagisce principalmente ai telegrammi KNX per richiamare/salvare le scene, ma puoi anche pilotarlo via msg. È possibile disabilitare i comandi provenienti dal BUS KNX e usare solo quelli dal flow.
-
-**Richiama una scena**
-
-```javascript
-
-msg.recallscene = true;
-return msg;
-```
-
-**Salva una scena**
-
-```javascript
-
-msg.savescene = true;
-return msg;
-```
-
-**Salva il valore corrente di una GA**
-
-La scena salva già automaticamente i valori aggiornati degli attuatori. A volte però è utile salvare come "valore reale di scena” il valore attuale di una GA diversa da quella prevista in scena (es. usare una GA di stato al posto di una GA di comando).
-
-Esempio: un attuatore tapparella ha GA di comando e GA di stato; il valore certo della posizione è nella GA di stato "altezza assoluta”. Con questa GA puoi aggiornare le GA di comando degli attuatori presenti in scena.
-
-```javascript
-
-// Salva lo stato (ad es. 70%) di una tapparella appartenente alla scena
-msg.savevalue = true;
-msg.topic = "0/1/1"; // GA
-msg.payload = 70; // valore da salvare
-return msg;
-```
-
-**Disabilita il Scene Controller**
-
-Disabilita i comandi dal BUS KNX (i msg dal flow restano accettati). Utile ad esempio di notte se non vuoi richiamare/salvare scene da pulsanti reali.
-
-```javascript
-
-msg.disabled = true; // false per riabilitare
-return msg;
-```
-
-## Vedi anche
-
-[Sample Scene Controller](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Sample-Scene-Node)
-</script>

package/nodes/locales/it/knxUltimateSceneController.json

@@ -1,32 +0,0 @@
-{
-    "knxUltimateSceneController": {
-        "paletteLabel": "Controller Scene KNX (deprecated)",
-        "title": "Controller scena",
-        "properties": {
-            "node-input-server": "Gateway",
-            "node-input-topic": "Richiama Scena",
-            "node-input-dpt": "Datapoint",
-            "node-input-topicTrigger": "Trigger",
-            "node-input-topicSave": "Salva Scena",
-            "node-input-name": "Nome nodo",
-            "node-input-outputtopic": "Topic"
-        },
-        "placeholder": {
-            "leaveempty": "Lascia vuoto per usare l'indirizzo di gruppo",
-            "valueexample": "Es: false, true, altrimenti qualsiasi valore"
-        },
-        "other": {
-            "sceneConfig": "Configurazione dei valori predefiniti della scena",
-            "add": "Premi Aggiungi per aggiungere un dispositivo alla scena"
-        },
-        "advanced": {
-            "notify-DPT3007": "Hai selezionato un DIM relativo. Per favore <a target='_blank' href='https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---Dimming'>clicca qui per vedere un esempio</a> e capire come gestire il relativo payload.",
-            "notify-DPT18001": "Hai selezionato un datapoint scena. Per favore <a target='_blank' href='https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---Control-a-scene-actuator'>clicca qui per vedere un esempio</a> per capire come gestire il relativo payload.",
-            "notify-DPT232600": "Hai selezionato un datapoint RGB. Per favore <a target='_blank' href='https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---RGB-Color'>clicca qui per vedere un esempio</a> per capire come gestire il relativo payload.",
-            "notify-DPT251600": "Hai selezionato un datapoint RGBW. Per favore <a target='_blank' href='https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---RGBW-Color-plus-White'>clicca qui per vedere un esempio</a> per capire come gestire il relativo payload."
-        },
-        "legacy_notice": "Questo nodo è deprecato e resta supportato nei flow esistenti. Usa KNX Utility per i nuovi flow. Il pulsante seguente converte tutti i nodi utility KNX legacy compatibili in tutti i flow e subflow.",
-        "migration_button": "Converti tutti i nodi KNX legacy compatibili",
-        "migration_button_title": "Converti in KNX Utility tutte le istanze utility KNX legacy compatibili presenti in tutti i flow e subflow dell’editor"
-    }
-}

package/nodes/locales/it/knxUltimateStaircase.html

@@ -1,77 +0,0 @@
-<script type="text/markdown" data-help-name="knxUltimateStaircase">
-### 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/>
-
-**Deprecato:** Questo nodo dedicato resta supportato nei flow esistenti. Per i nuovi flow usa **KNX Utility** e seleziona la funzione corrispondente. Il nodo legacy è nascosto nella palette e contrassegnato con `(deprecated)` nel flow. Il suo editor offre un pulsante per convertire tutti i nodi utility KNX legacy compatibili in tutti i flow e subflow dopo conferma. La conversione avviene localmente nel browser, conserva ID, impostazioni, collegamenti e gruppi e supporta Annulla. La conferma chiude l’editor del nodo corrente e scarta le modifiche non salvate. Controlla il risultato prima di premere Deploy.
-
-# Temporizzatore scale KNX
-
-<p>Il nodo Temporizzatore scale KNX riproduce il classico timer luci scala. Rileva gli impulsi di attivazione, comanda l'attuatore, sincronizza lo stato tramite una GA di feedback e gestisce i comandi di override o blocco.</p>
-
-**Indirizzi di gruppo**
-
-|Proprietà|Descrizione|
-|--|--|
-| GA impulso | GA binaria che avvia il timer quando riceve `1`. Se abiliti “Il valore 0 annulla il ciclo”, lo `0` spegne immediatamente la luce. |
-| GA uscita | Attuatore pilotato durante il ciclo. Seleziona il DPT coerente con il carico (binario, dimmer, analogico, …). |
-| GA stato | Replica lo stato attivo e il preavviso. In modalità *Attiva GA stato* viene commutata prima dello spegnimento. |
-| GA override | Mantiene la luce accesa e sospende il timer finché rimane a `1`. |
-| GA blocco | Quando vale `1` ignora nuovi impulsi. L'opzione *Quando è bloccato* decide se forzare lo spegnimento. |
-
-**Comportamento del timer**
-
-|Opzione|Descrizione|
-|--|--|
-| Durata timer | Durata base del ciclo scala. |
-| Nuovo impulso | Scegli se riavviare, prolungare o ignorare gli impulsi successivi. |
-| Il valore 0 annulla il ciclo | Arresta il ciclo con motivo `manual-off` quando l'impulso torna a `0`. |
-| Quando è bloccato | Determina se il blocco inibisce solo gli impulsi o forza lo spegnimento. |
-
-**Preavviso**
-
-|Opzione|Descrizione|
-|--|--|
-| Invia preavviso | Abilita l'avviso prima dello spegnimento. |
-| Preavviso (secondi) | Quanto tempo prima della scadenza attivare l'avviso. |
-| Modalità preavviso | *Attiva GA stato* commuta la GA di stato. *Fai lampeggiare l'uscita* spegne e riaccende l'uscita dopo la durata impostata. |
-| Durata lampeggio | Millisecondi durante i quali l'uscita resta spenta quando lampeggia. |
-
-**Uscita del nodo**
-
-- Se *Emetti eventi* è attivo il nodo emette oggetti strutturati (`trigger`, `extend`, `prewarn`, `timeout`, `override`, `block`, `manual-off`) con `remaining`, `active`, `override`, `blocked`.
-- In alternativa puoi usare la GA di stato come feedback direttamente sul bus KNX.
-
-## Ingressi
-
-|Proprietà|Descrizione|
-|--|--|
-| Input dal flow | Invia `true`, `false`, `'open'` o `'close'` dal flow per avviare o interrompere il temporizzatore. |
-| Telegrammi KNX | Il nodo reagisce alle GA configurate. |
-
-## Esempio dal flow
-
-```javascript
-
-// Avvia il temporizzatore scale
-msg.payload = true;
-return msg;
-```
-
-```javascript
-// Annulla il ciclo (opzione "Il valore 0 annulla il ciclo")
-msg.payload = false;
-return msg;
-```
-
-## Uscite
-
-|Proprietà|Descrizione|
-|--|--|
-| Eventi (opzionale) | Con *Emetti eventi* attivo il nodo invia gli oggetti evento descritti sopra sull'uscita. |
-
-</script>