node-red-contrib-knx-ultimate 5.0.4 → 5.2.2

package/nodes/locales/fr/matterbridge-config.html

@@ -0,0 +1,34 @@
+<script type="text/markdown" data-help-name="matterbridge-config">
+# Bridge Matter (BETA)
+
+> Ce nœud est en **BETA** : il fonctionne, mais des détails peuvent encore changer entre les versions.
+
+## Vue d'ensemble
+
+Ce nœud de configuration est le **bridge Matter lui-même** : il exécute le serveur Matter qu'Alexa, Google Home, Apple Home (ou tout contrôleur Matter) appairent **une seule fois**. Chaque nœud **Matter Bridge device** de vos flux pointe ici et apparaît dans les apps comme un appareil du bridge.
+
+## Configuration
+
+|Champ|Description|
+|--|--|
+| Nom | Le nom de ce nœud de configuration dans Node-RED |
+| Nom du bridge Matter | Le nom du bridge lui-même dans les apps Matter |
+| Port | Port UDP du serveur Matter (5540 par défaut). Chaque bridge a besoin de son propre port, vous pouvez donc exécuter **plusieurs bridges indépendants** |
+
+## Appairage
+
+1. **Déployez**, attendez quelques secondes, puis rouvrez ce nœud.
+2. Le panneau d'appairage montre le **QR code** et le **code manuel** : scannez ou saisissez-le dans Alexa / Google Home / Apple Home (« ajouter un appareil Matter »).
+3. Plusieurs contrôleurs peuvent être appairés au même bridge (multi-fabric Matter).
+
+Le bouton **Réinitialiser l'appairage** supprime tous les contrôleurs appairés et relance l'annonce d'appairage.
+
+## Identité et stockage
+
+L'identité du bridge est liée à ce nœud de configuration et enregistrée dans `knxultimatestorage/matter` du répertoire utilisateur de Node-RED : les re-deploys (même en changeant port ou nom) ne nécessitent **PAS** de nouvel appairage. Seule la suppression de ce nœud de configuration et la création d'un nouveau changent l'identité — dans ce cas supprimez l'ancien bridge de l'app Matter et appairez de nouveau.
+
+## Notes
+
+- L'hôte Node-RED doit avoir **IPv6 link-local** activé (exigence standard de Matter) et être joignable par les contrôleurs sur le réseau local.
+- Les nœuds d'appareil ajoutés/renommés/supprimés sont pris en compte en quelques secondes, sans nouvel appairage.
+</script>

package/nodes/locales/fr/matterbridge-config.json

@@ -0,0 +1,20 @@
+{
+  "matterbridge-config": {
+    "properties": {
+      "title": "Bridge Matter",
+      "intro": "Ce nœud de configuration est le bridge Matter lui-même : Alexa, Google Home, Apple Home (ou tout contrôleur Matter) l'appairent une fois et voient tous les appareils KNX que vous y rattachez. Ajoutez des nœuds \"Matter Bridge device\" dans vos flux et pointez-les ici. Déployez d'abord, puis rouvrez pour obtenir le code d'appairage.",
+      "node-config-input-name": "Nom",
+      "bridge_name": "Nom du bridge Matter",
+      "port": "Port",
+      "pairing_title": "Appairage (Alexa, Google Home, Apple Home...)",
+      "not_running": "Le bridge Matter n'est pas encore démarré. Déployez, attendez quelques secondes puis cliquez sur actualiser.",
+      "commissioned": "Bridge appairé avec ces contrôleurs :",
+      "awaiting": "En attente d'appairage. Scannez le QR code ou saisissez le code manuel dans votre app Matter :",
+      "qr_link": "Ouvrir le QR code dans le navigateur",
+      "deploy_first": "Déployez d'abord ce nœud de configuration, puis cliquez sur actualiser.",
+      "reset_button": "Réinitialiser l'appairage",
+      "reset_confirm": "Supprimer TOUS les contrôleurs appairés et relancer l'appairage ? Les appareils disparaîtront d'Alexa/Google/Apple.",
+      "reset_ok": "Appairage réinitialisé. Le bridge attend de nouveau un appairage."
+    }
+  }
+}

package/nodes/locales/it/knxUltimateMatterBridge.html

@@ -0,0 +1,53 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterBridge">
+# Matter Bridge device (BETA)
+
+> Questo nodo è in **BETA**: funziona, ma alcuni dettagli potrebbero cambiare tra una release e l'altra.
+
+## Panoramica
+
+Ogni nodo Matter Bridge device 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.
+
+## 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) | GA temperatura attuale, GA comando/stato setpoint (DPT 9.001) |
+| Ventola / VMC | GA comando/stato velocità % (DPT 5.001) |
+| 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).
+
+## PIN del nodo
+
+Se abiliti i PIN input/output del nodo:
+
+- **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`, `fanspeed`, `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

@@ -0,0 +1,83 @@
+{
+  "knxUltimateMatterBridge": {
+    "title": "Matter Bridge (BETA)",
+    "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",
+    "fields": {
+      "type": "Tipo dispositivo",
+      "name": "Nome (mostrato da Alexa & Co.)",
+      "name_placeholder": "es. Luce cucina",
+      "invert": "Inverti posizione %"
+    },
+    "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_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 %"
+    },
+    "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)",
+      "fan": "Ventola / VMC",
+      "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/knxUltimateMatterDevice.html

@@ -0,0 +1,56 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterDevice">
+# Dispositivo Matter (BETA)
+
+> Questo nodo è in **BETA**: funziona, ma alcuni dettagli potrebbero cambiare tra una release e l'altra.
+
+## Panoramica
+
+Il nodo Matter Device fa da ponte tra un **dispositivo Matter** e gli **indirizzi di gruppo KNX**. Il nodo opera tramite il nodo di configurazione *Matter Controller*, che associa (commissiona) i dispositivi nella propria fabric Matter.
+
+- **Controlla** qualsiasi dispositivo Matter associato dal bus KNX (on/off, dimmerazione, tapparelle, termostati, serrature, ...).
+- **Riporta** ogni attributo del dispositivo sugli indirizzi di gruppo KNX (stati, sensori, misure di potenza, batteria...).
+- Completamente generico: la lista delle mappature è costruita dagli **endpoint/cluster reali** esposti dal dispositivo.
+
+## Configurazione
+
+|Campo|Descrizione|
+|--|--|
+| GW KNX | Gateway KNX usato per i telegrammi |
+| Ctrl Matter | Il nodo di configurazione Matter Controller (dove associ i dispositivi) |
+| Dispositivo | Scegli il dispositivo Matter associato dalla lista con autocompletamento |
+| Mappature | Una riga per ogni mappatura indirizzo di gruppo ↔ cluster Matter |
+| Leggi lo stato all'avvio | Se abilitato, il nodo emette i valori correnti in cache al deploy/connessione |
+| PIN Input/Output del nodo | Abilita i pin input/output Node-RED per l'accesso Matter grezzo |
+
+## Mappature
+
+La lista delle destinazioni mostra le funzioni supportate con nomi comprensibili come *"Interruttore On/Off"* o *"Potenza istantanea consumata (W)"*, filtrate su ciò che il dispositivo espone realmente e con il valore attuale tra parentesi quadre.
+
+Ogni riga di mappatura ha una **direzione**:
+
+- **KNX → Matter (comando)**: un telegramma ricevuto sull'indirizzo di gruppo invoca un comando del cluster Matter o scrive un attributo. Esempio: GA `1/1/1` DPT 1.001 → `OnOff.on/off` (il payload booleano seleziona automaticamente on oppure off).
+- **Matter → KNX (stato)**: quando l'attributo Matter sottoscritto cambia, il valore viene convertito e scritto sull'indirizzo di gruppo. Le richieste `GroupValue_Read` ricevono in risposta il valore in cache.
+
+I cluster più comuni vengono convertiti automaticamente in valori adatti a KNX:
+
+|Cluster|Conversione|
+|--|--|
+| OnOff | booleano (DPT 1.001) |
+| LevelControl | 0-254 ↔ percentuale (DPT 5.001) |
+| WindowCovering | percent100ths ↔ percentuale (DPT 5.001), su/giù (DPT 1.008) |
+| ColorControl | mired ↔ Kelvin (DPT 7.600) |
+| Thermostat | centi-°C ↔ °C (DPT 9.001) |
+| Temperatura/Umidità | centi-unità ↔ unità (DPT 9.001/9.007) |
+| Luminosità | scala logaritmica ↔ Lux (DPT 9.004) |
+| PowerSource | mezzi-percento ↔ percentuale batteria (DPT 5.001) |
+| Potenza/Energia elettrica | mW ↔ W (DPT 14.056), mWh ↔ kWh (DPT 13.013) |
+
+Gli altri cluster/attributi passano senza conversione; il DPT che scegli esegue la codifica KNX finale.
+
+## PIN del nodo
+
+Se abiliti i PIN del nodo:
+
+- **Input**: invia comandi grezzi: `msg.payload = { endpointId: 1, clusterId: 6, command: "toggle" }` oppure scritture di attributi: `msg.payload = { endpointId: 1, clusterId: 8, attribute: "onLevel", value: 128 }`
+- **Output**: riceve ogni variazione di attributo (`msg.matter` contiene l'evento completo) e ogni evento dei cluster (pressioni di pulsanti ecc.).
+</script>

package/nodes/locales/it/knxUltimateMatterDevice.json

@@ -0,0 +1,109 @@
+{
+  "knxUltimateMatterDevice": {
+    "title": "Dispositivo Matter (BETA)",
+    "paletteLabel": "Matter Device (BETA)",
+    "matter_controller": "Ctrl Matter",
+    "matter_device": "Dispositivo",
+    "device_placeholder": "Clicca per scegliere un dispositivo Matter associato",
+    "mapping_help": "Aggiungi una riga per ogni mappatura. \"KNX → Matter\" invoca un comando del cluster (o scrive un attributo) quando arriva un telegramma sull'indirizzo di gruppo. \"Matter → KNX\" scrive il valore dell'attributo sull'indirizzo di gruppo ad ogni variazione (le richieste di lettura ricevono il valore in cache).",
+    "select_target": "-- seleziona la destinazione Matter --",
+    "stored_target": "Salvato",
+    "read_status_startup": "Leggi lo stato all'avvio",
+    "opt_yes_emit": "Sì, ed emetti i telegrammi KNX.",
+    "opt_no": "No",
+    "node_pins": "PIN Input/Output del nodo",
+    "node_pins_hide": "Nascondi",
+    "node_pins_show": "Mostra i PIN input/output del nodo",
+    "direction": {
+      "command": "KNX → Matter (comando)",
+      "status": "Matter → KNX (stato)"
+    },
+    "fields": {
+      "direction": "Direzione",
+      "target": "Endpoint / cluster / destinazione Matter",
+      "ga": "Indirizzo di gruppo",
+      "dpt": "DPT",
+      "ganame": "Nome"
+    },
+    "no_simple_targets": "Nessuna funzione supportata trovata su questo dispositivo (o il dispositivo non è ancora connesso).",
+    "endpoint": "Endpoint",
+    "friendly": {
+      "onoff_switch": "Interruttore On/Off (accendi/spegni)",
+      "onoff_toggle": "Inverti stato (toggle)",
+      "onoff_state": "Stato On/Off",
+      "level_set": "Imposta luminosità / livello (%)",
+      "level_state": "Luminosità / livello attuale (%)",
+      "colortemp_set": "Imposta temperatura colore (Kelvin)",
+      "colortemp_state": "Temperatura colore attuale (Kelvin)",
+      "cover_updown": "Tapparella Su/Giù",
+      "cover_stop": "Tapparella Stop",
+      "cover_position_set": "Porta tapparella in posizione (%)",
+      "cover_position_state": "Posizione attuale tapparella (%)",
+      "cover_tilt_set": "Inclina lamelle (%)",
+      "cover_tilt_state": "Inclinazione attuale lamelle (%)",
+      "thermo_localtemp": "Temperatura ambiente (°C)",
+      "thermo_heatsp_set": "Imposta setpoint riscaldamento (°C)",
+      "thermo_coolsp_set": "Imposta setpoint raffrescamento (°C)",
+      "thermo_heatsp_state": "Setpoint riscaldamento (°C)",
+      "thermo_coolsp_state": "Setpoint raffrescamento (°C)",
+      "fan_speed_set": "Imposta velocità ventola (%)",
+      "fan_speed_state": "Velocità ventola attuale (%)",
+      "lock_cmd": "Blocca/Sblocca serratura",
+      "lock_state": "Stato serratura (bloccata)",
+      "temp_measured": "Temperatura misurata (°C)",
+      "humidity_measured": "Umidità relativa (%)",
+      "illuminance_measured": "Luminosità ambiente (Lux)",
+      "occupancy_state": "Presenza rilevata",
+      "contact_state": "Stato contatto (chiuso/aperto)",
+      "battery_percent": "Livello batteria (%)",
+      "power_active": "Potenza istantanea consumata (W)",
+      "power_voltage": "Tensione (V)",
+      "power_current": "Corrente (A)",
+      "energy_imported": "Energia consumata (kWh)",
+      "identify_cmd": "Identifica dispositivo (lampeggio)",
+      "switch_position": "Posizione pulsante"
+    },
+    "devtype": {
+      "onofflight": "Luce On/Off",
+      "dimmablelight": "Luce dimmerabile",
+      "colortemperaturelight": "Luce bianco dinamico",
+      "extendedcolorlight": "Luce colorata",
+      "onoffpluginunit": "Presa (on/off)",
+      "dimmablepluginunit": "Presa (dimmerabile)",
+      "smartplug": "Presa smart",
+      "contactsensor": "Sensore contatto",
+      "lightsensor": "Sensore luminosità",
+      "occupancysensor": "Sensore presenza",
+      "temperaturesensor": "Sensore temperatura",
+      "humiditysensor": "Sensore umidità",
+      "pressuresensor": "Sensore pressione",
+      "flowsensor": "Sensore flusso",
+      "doorlock": "Serratura",
+      "windowcovering": "Tapparella/Tenda",
+      "thermostat": "Termostato",
+      "fan": "Ventilatore",
+      "genericswitch": "Pulsante/Interruttore",
+      "airqualitysensor": "Sensore qualità aria",
+      "smokecoalarm": "Rilevatore fumo/CO",
+      "waterleakdetector": "Rilevatore perdite acqua",
+      "roomairconditioner": "Condizionatore",
+      "airpurifier": "Purificatore aria",
+      "speaker": "Altoparlante",
+      "pumpcontroller": "Pompa",
+      "onofflightswitch": "Interruttore luce",
+      "dimmerswitch": "Interruttore dimmer",
+      "colordimmerswitch": "Interruttore dimmer colore",
+      "powersource": "Alimentazione",
+      "electricalsensor": "Sensore elettrico",
+      "bridgednode": "Dispositivo bridged",
+      "aggregator": "Bridge/Aggregatore",
+      "rootnode": "Nodo radice"
+    }
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "Nome",
+    "knx_gw": "GW KNX"
+  }
+}

package/nodes/locales/it/matter-config.html

@@ -0,0 +1,25 @@
+<script type="text/markdown" data-help-name="matter-config">
+# Controller Matter
+
+## Panoramica
+
+Questo nodo di configurazione è un **controller Matter** completo: crea una propria *fabric* Matter e vi associa (commissiona) i tuoi dispositivi Matter. I dispositivi associati diventano poi disponibili ai nodi **Matter Device**, che li mappano sugli indirizzi di gruppo KNX.
+
+Il controller comunica con i dispositivi tramite la **rete IP** (WiFi, Ethernet, oppure Thread attraverso un border router). Il commissioning via Bluetooth non è supportato: il dispositivo deve essere già raggiungibile in rete.
+
+## Associare un dispositivo
+
+1. Fai prima il **deploy** di questo nodo di configurazione (il controller deve essere in esecuzione).
+2. Riapri il nodo e inserisci il **codice di abbinamento**: il codice manuale a 11 cifre (es. `3497-011-2332`) oppure il contenuto del QR code (`MT:....`).
+3. Clicca **ASSOCIA**. Il commissioning può richiedere fino a un minuto.
+
+Se il dispositivo è nuovo di fabbrica e supporta solo il commissioning Bluetooth, associalo prima con l'app del produttore o con un altro controller Matter (Alexa, Google Home, Apple Home), poi usa la funzione **"condividi / abbina con altro hub"** di quel controller per generare un nuovo codice di abbinamento per KNX-Ultimate. In questo modo il dispositivo entra in più fabric contemporaneamente.
+
+## Archiviazione
+
+Le credenziali della fabric e i dispositivi associati sono salvati nella cartella `knxultimatestorage/matter` dentro la directory utente di Node-RED. Cancellando quella cartella si perdono tutte le associazioni.
+
+## Rimuovere un dispositivo
+
+Usa il pulsante cestino nella lista dei dispositivi associati. Il controller prova a decommissionare correttamente il dispositivo; se non è raggiungibile, viene comunque rimosso dalla fabric (potrebbe poi servire un reset di fabbrica del dispositivo).
+</script>

package/nodes/locales/it/matter-config.json

@@ -0,0 +1,26 @@
+{
+  "matter-config": {
+    "properties": {
+      "title": "Controller Matter",
+      "intro": "Questo nodo è un controller Matter (con una propria fabric). Associa qui i tuoi dispositivi Matter, poi usa il nodo \"Matter Device\" per mapparli sugli indirizzi di gruppo KNX. Fai prima il deploy del nodo, poi torna qui per associare i dispositivi.",
+      "node-config-input-name": "Nome",
+      "fabric_label": "Etichetta fabric",
+      "pairing_title": "Associa un nuovo dispositivo",
+      "pairing_help": "Inserisci il codice di abbinamento manuale a 11 cifre (es. 3497-011-2332) o il contenuto del QR code (MT:....). Il dispositivo deve essere raggiungibile sulla rete IP (WiFi/Ethernet o Thread tramite border router). Se il dispositivo è già associato a un altro controller (Alexa, Google, Apple), usa la funzione \"condividi/abbina con altro hub\" per ottenere un nuovo codice.",
+      "pairing_code": "Codice abbinamento",
+      "pair_button": "ASSOCIA",
+      "devices_title": "Dispositivi associati",
+      "col_name": "Nome",
+      "col_product": "Prodotto",
+      "col_state": "Stato",
+      "no_devices": "Nessun dispositivo ancora associato.",
+      "unpair_confirm": "Rimuovere (decommissionare) il dispositivo",
+      "unpair_ok": "Dispositivo rimosso.",
+      "deploy_first": "Fai prima il deploy di questo nodo di configurazione, poi riprova.",
+      "pairing_code_missing": "Inserisci un codice di abbinamento.",
+      "pairing_wait": "Abbinamento in corso. Può richiedere fino a un minuto...",
+      "pairing_failed": "Abbinamento fallito",
+      "pairing_ok": "Dispositivo associato con successo!"
+    }
+  }
+}

package/nodes/locales/it/matterbridge-config.html

@@ -0,0 +1,34 @@
+<script type="text/markdown" data-help-name="matterbridge-config">
+# Bridge Matter (BETA)
+
+> Questo nodo è in **BETA**: funziona, ma alcuni dettagli potrebbero cambiare tra una release e l'altra.
+
+## Panoramica
+
+Questo nodo di configurazione è il **bridge Matter vero e proprio**: esegue il server Matter che Alexa, Google Home, Apple Home (o qualunque controller Matter) associano **una sola volta**. Ogni nodo **Matter Bridge device** nei tuoi flow punta qui e compare nelle app come un dispositivo del bridge.
+
+## Configurazione
+
+|Campo|Descrizione|
+|--|--|
+| Nome | Il nome di questo nodo di configurazione in Node-RED |
+| Nome del bridge Matter | Come viene chiamato il bridge stesso nelle app Matter |
+| Porta | Porta UDP del server Matter (default 5540). Ogni bridge richiede la propria porta, quindi puoi eseguire **più bridge indipendenti** |
+
+## Abbinamento
+
+1. Fai il **deploy**, attendi qualche secondo, poi riapri questo nodo.
+2. Il pannello di abbinamento mostra il **QR code** e il **codice manuale**: scansiona o digita in Alexa / Google Home / Apple Home ("aggiungi dispositivo Matter").
+3. Più controller possono essere abbinati allo stesso bridge (multi-fabric Matter).
+
+Il pulsante **Reset abbinamento** rimuove tutti i controller abbinati e riavvia l'advertising di abbinamento.
+
+## Identità e archiviazione
+
+L'identità del bridge è legata a questo nodo di configurazione ed è salvata in `knxultimatestorage/matter` nella directory utente di Node-RED: i re-deploy (anche cambiando porta o nome) **NON** richiedono un nuovo abbinamento. Solo eliminando questo nodo di configurazione e creandone uno nuovo cambia l'identità — in quel caso rimuovi il vecchio bridge dall'app Matter e riabbina.
+
+## Note
+
+- L'host Node-RED deve avere **IPv6 link-local** attivo (requisito standard Matter) ed essere raggiungibile dai controller sulla rete locale.
+- I nodi device aggiunti/rinominati/rimossi vengono recepiti dai controller abbinati in pochi secondi, senza riabbinare.
+</script>

package/nodes/locales/it/matterbridge-config.json

@@ -0,0 +1,20 @@
+{
+  "matterbridge-config": {
+    "properties": {
+      "title": "Bridge Matter",
+      "intro": "Questo nodo di configurazione è il bridge Matter vero e proprio: Alexa, Google Home, Apple Home (o qualunque controller Matter) lo associano una volta sola e vedono tutti i dispositivi KNX che gli colleghi. Aggiungi i nodi \"Matter Bridge device\" nei tuoi flow e puntali qui. Fai prima il deploy, poi riapri per ottenere il codice di abbinamento.",
+      "node-config-input-name": "Nome",
+      "bridge_name": "Nome del bridge Matter",
+      "port": "Porta",
+      "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 di configurazione, 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."
+    }
+  }
+}

package/nodes/locales/zh-CN/knxUltimateMatterBridge.html

@@ -0,0 +1,53 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterBridge">
+# Matter Bridge device (BETA)
+
+> 此节点处于 **BETA** 阶段：可以正常工作，但细节可能在版本之间发生变化。
+
+## 概述
+
+每个 Matter Bridge device 节点将**一个 KNX 设备公开为 Matter 设备**：已配对的控制器（Alexa、Google Home、Apple Home...）会以您输入的名称看到它，随时可通过 App 和语音控制。将它指向一个 **Matter 桥接器**配置节点（真正的桥接器，只需配对一次 - 配对二维码在那里），然后在流程中随意添加任意数量的设备节点。
+
+这与 *Matter Device* 节点方向相反：那里是 KNX 控制 Matter 设备，这里是 Matter 控制器控制 KNX。
+
+## 配置
+
+|字段|说明|
+|--|--|
+| Matter 桥接器 | 此设备所属的 Matter 桥接器配置节点 |
+| KNX 网关 | 用于报文的 KNX 网关。**可选**：没有网关时，设备通过节点引脚以纯 Flow 模式工作。项目中只有一个网关时会自动选择 |
+| 名称 | Alexa 等显示并用于语音命令的名称 |
+| 设备类型 | Matter 设备类型（见下文）；决定显示哪些组地址字段 |
+| 启动时读取状态 | 启动时向状态 GA 发送 `GroupValue_Read`，以填充 Matter 属性 |
+
+## 设备类型与组地址
+
+|类型|组地址|
+|--|--|
+| 开关灯、插座 | 开/关命令 GA、开/关状态 GA (DPT 1.001) |
+| 调光灯 | + 调光 % 命令/状态 GA (DPT 5.001) |
+| RGB 彩色灯 | + RGB 颜色命令/状态 GA (DPT 232.600)。Matter 颜色（hue/saturation 或 XY，来自 App 的色轮）与 KNX RGB 三元组相互转换 |
+| 色温灯 | + 色温命令/状态 GA，开尔文 (DPT 7.600) |
+| 窗帘/卷帘 | 上/下 (DPT 1.008)、停止 (DPT 1.017)、位置 % 命令/状态 (DPT 5.001)、可选位置反转 |
+| 温控器（采暖） | 当前温度 GA、设定点命令/状态 GA (DPT 9.001) |
+| 风扇/新风 | 速度 % 命令/状态 GA (DPT 5.001) |
+| 传感器（温度、湿度、光照、人体、门磁） | 各一个状态 GA |
+| 烟雾/CO 报警器 | 烟雾报警状态 GA + 可选 CO 报警状态 GA (DPT 1.005)：手机上的紧急通知 |
+| 漏水探测器 | 漏水状态 GA (DPT 1.005) |
+| 空气质量传感器 (CO2) | CO2 状态 GA，ppm (DPT 9.008)；空气质量等级（好/一般/中等/差...）自动推导 |
+| 扫地机器人 | **仅 Flow**：无组地址。启用节点引脚：助手的命令（"开始清扫"、暂停/继续/回充）作为 `rvcmode`/`rvccommand` 到达输出；用 `msg.payload = { function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" }` 报告状态，用 `function: "rvcmode", value: "cleaning"\|"idle"` 报告模式 |
+
+- **命令 GA**：助手发送命令时写入 KNX 总线。
+- **状态 GA**：从总线读取，保持 Matter 属性（和 App）更新。
+
+## 节点引脚
+
+如果启用节点的输入/输出引脚：
+
+- **输入**：从 Flow 更新 Matter 状态，无需经过 KNX 总线：`msg.payload = { function: "onoff", value: true }`（`function` 为 `onoff`、`level`、`rgb`、`colortemp`、`position`、`temperature`、`humidity`、`illuminance`、`occupancy`、`contact`、`currenttemp`、`setpoint`、`fanspeed`、`smoke`、`co`、`leak`、`co2`、`rvcstate`、`rvcmode` 之一）。适合把 Flow 中计算的值（如虚拟传感器）公开给 Alexa 等。
+- **输出**：从 Matter 控制器收到的每个命令都转发到 Flow：`msg.topic` = 设备名称，`msg.payload` = 值，`msg.matter` = 原始命令。没有命令 GA 的设备成为**纯 Flow 设备**。
+
+## 说明
+
+- 设备的 Matter 身份与此节点绑定：删除节点并新建一个后，App 会看到一个全新的设备。
+- 添加/重命名/移除的设备节点会在几秒内被已配对的控制器识别，无需重新配对桥接器。
+</script>

package/nodes/locales/zh-CN/knxUltimateMatterBridge.json

@@ -0,0 +1,83 @@
+{
+  "knxUltimateMatterBridge": {
+    "title": "Matter Bridge (BETA)",
+    "bridge_name": "Matter 桥接器名称",
+    "port": "端口",
+    "devices_help": "添加要在 Matter 上公开的 KNX 设备。\"名称\"是 Alexa/Google/Apple 显示并用于语音命令的名称。命令 GA = 助手发送命令时写入；状态 GA = 从总线读取以保持 App 更新。",
+    "read_status_startup": "启动时读取状态组地址",
+    "opt_yes": "是",
+    "opt_no": "否",
+    "node_pins": "节点输入/输出引脚",
+    "node_pins_hide": "隐藏",
+    "node_pins_show": "显示节点输入/输出引脚",
+    "fields": {
+      "type": "设备类型",
+      "name": "名称（Alexa 等显示）",
+      "name_placeholder": "例如 厨房灯",
+      "invert": "反转位置 %"
+    },
+    "functions": {
+      "fn_onoff_cmd": "开/关 命令 GA",
+      "fn_onoff_status": "开/关 状态 GA",
+      "fn_level_cmd": "调光 % 命令 GA",
+      "fn_level_status": "调光 % 状态 GA",
+      "fn_sensor_ga": "传感器状态 GA",
+      "fn_updown": "上/下 命令 GA",
+      "fn_stop": "停止 命令 GA",
+      "fn_position_cmd": "位置 % 命令 GA",
+      "fn_position_status": "位置 % 状态 GA",
+      "fn_currenttemp": "当前温度 GA",
+      "fn_setpoint_cmd": "设定点 命令 GA",
+      "fn_setpoint_status": "设定点 状态 GA",
+      "fn_rgb_cmd": "RGB 颜色命令 GA (DPT 232.600)",
+      "fn_rgb_status": "RGB 颜色状态 GA (DPT 232.600)",
+      "fn_ct_cmd": "色温命令 GA（开尔文）",
+      "fn_ct_status": "色温状态 GA（开尔文）",
+      "fn_smoke_ga": "烟雾报警状态 GA",
+      "fn_co_ga": "CO 报警状态 GA（可选）",
+      "fn_leak_ga": "漏水状态 GA",
+      "fn_co2_ga": "CO2 状态 GA（ppm，DPT 9.008）",
+      "fn_fanspeed_cmd": "风扇速度 % 命令 GA",
+      "fn_fanspeed_status": "风扇速度 % 状态 GA"
+    },
+    "types": {
+      "onofflight": "开关灯",
+      "dimmablelight": "调光灯",
+      "rgblight": "RGB 彩色灯",
+      "colortemperaturelight": "色温灯（可调白光）",
+      "onoffplug": "插座（开/关）",
+      "temperaturesensor": "温度传感器",
+      "humiditysensor": "湿度传感器",
+      "lightsensor": "光照传感器 (Lux)",
+      "occupancysensor": "人体传感器",
+      "contactsensor": "门磁传感器",
+      "windowcovering": "窗帘 / 卷帘",
+      "thermostat": "温控器（采暖）",
+      "fan": "风扇 / 新风",
+      "smokecoalarm": "烟雾/CO 报警器",
+      "waterleakdetector": "漏水探测器",
+      "airqualitysensor": "空气质量传感器 (CO2)",
+      "robotvacuum": "扫地机器人（仅 Flow，通过节点引脚）"
+    },
+    "pairing": {
+      "title": "配对（Alexa、Google Home、Apple Home...）",
+      "not_running": "Matter 桥接器尚未运行。请先部署，等待几秒后点击刷新。",
+      "commissioned": "桥接器已与以下控制器配对：",
+      "awaiting": "等待配对。请在您的 Matter App 中扫描二维码或输入手动配对码：",
+      "qr_link": "在浏览器中打开二维码",
+      "deploy_first": "请先部署此节点，然后点击刷新。",
+      "reset_button": "重置配对",
+      "reset_confirm": "移除所有已配对的控制器并重新开始配对？设备将从 Alexa/Google/Apple 中消失。",
+      "reset_ok": "配对已重置。桥接器重新进入配对模式。"
+    },
+    "bridge": "Matter 桥接器",
+    "device_name": "名称（Alexa 等显示）",
+    "device_help": "选择设备类型并输入语音助手将使用的名称，然后填写组地址。KNX 网关是可选的：没有网关时，启用节点引脚并从流程驱动设备。"
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "名称",
+    "knx_gw": "KNX 网关"
+  }
+}