node-red-contrib-knx-ultimate 5.2.1 → 5.2.3

package/nodes/locales/fr/knxUltimateIoTBridge.json

@@ -22,6 +22,12 @@
       "base_topic": "Topic de base",
       "discovery": "Publier la découverte Home Assistant",
       "discovery_prefix": "Préfixe de découverte",
+      "name_format": "Format du nom d'entité",
+      "name_format_full": "Tel qu'importé d'ETS : (Groupe principal->Groupe intermédiaire) Nom",
+      "name_format_name_first": "Nom d'abord : Nom (Groupe principal->Groupe intermédiaire)",
+      "name_format_name_only": "Nom seul (supprimer le chemin ETS)",
+      "name_format_name_ga": "Nom + adresse de groupe : Nom (1/2/3)",
+      "name_format_hint": "Comment les noms des entités Home Assistant sont construits à partir des noms importés d'ETS, qui commencent par le chemin des groupes.",
       "hint": "Nécessite un broker MQTT accessible à la fois par Node-RED et Home Assistant, avec l'intégration MQTT activée dans HA. Les entités apparaissent sous un appareil portant le nom de ce nœud. Les valeurs du bus KNX sont publiées sur MQTT et les points de données inscriptibles acceptent les commandes de Home Assistant.",
       "exposed_gas": "Adresses de groupe à exposer",
       "exposed_gas_hint": "Cochez les adresses de groupe à publier vers Home Assistant. Par défaut, toutes les adresses importées sont sélectionnées. Les adresses utilisées par un volet/thermostat (ci-dessous) y sont gérées et n'ont pas besoin d'être cochées ici.",

package/nodes/locales/fr/knxUltimateMatterBridge.html

@@ -1,11 +1,11 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Matter Bridge (BETA)
+# Matter Bridge device (BETA)
 
 > Ce nœud est en **BETA** : il fonctionne, mais des détails peuvent encore changer entre les versions.
 
 ## Vue d'ensemble
 
-Le nœud Matter Bridge expose les **adresses de groupe KNX comme appareils Matter** : Alexa, Google Home, Apple Home (ou n'importe quel contrôleur Matter) appairent ce bridge **une seule fois** et voient tous vos appareils KNX configurés, avec les noms que vous avez choisis, prêts pour le contrôle par app et à la voix.
+Chaque nœud Matter Bridge device expose **un appareil KNX comme appareil Matter** : les contrôleurs appairés (Alexa, Google Home, Apple Home...) le voient, avec le nom que vous avez choisi, prêt pour le contrôle par app et à la voix. Pointez-le vers un nœud de configuration **Bridge Matter** (le bridge lui-même, appairé une seule fois - le QR d'appairage vit là-bas) et ajoutez autant de nœuds d'appareil que vous voulez, n'importe où dans vos flux.
 
 C'est la direction opposée du nœud *Matter Device* : là-bas KNX contrôle un appareil Matter, ici les contrôleurs Matter contrôlent KNX.
 
@@ -13,15 +13,13 @@ C'est la direction opposée du nœud *Matter Device* : là-bas KNX contrôle un
 
 |Champ|Description|
 |--|--|
-| GW KNX | Passerelle KNX utilisée pour les télégrammes. **Optionnel** : sans passerelle, le bridge fonctionne en mode flow uniquement — activez les PIN du nœud et pilotez chaque appareil avec des messages du flow |
-| 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). Un seul nœud bridge par instance Node-RED. |
-| Appareils | Les appareils KNX virtuels exposés sur Matter (voir ci-dessous) |
-| Lire les GA d'état au démarrage | Envoie un `GroupValue_Read` à chaque GA d'état au démarrage, pour peupler les attributs Matter |
+| Bridge Matter | Le nœud de configuration Bridge Matter auquel appartient cet appareil |
+| GW KNX | Passerelle KNX utilisée pour les télégrammes. **Optionnel** : sans elle, l'appareil fonctionne en mode flow uniquement via les PIN du nœud. Sélectionnée automatiquement si le projet n'a qu'une passerelle |
+| Nom | Ce qu'Alexa & Co. affichent et utilisent pour les commandes vocales |
+| Type d'appareil | Le type d'appareil Matter (voir ci-dessous) ; il détermine quels champs d'adresse de groupe apparaissent |
+| Lire l'état au démarrage | Envoie un `GroupValue_Read` aux GA d'état au démarrage, pour peupler les attributs Matter |
 
-## Appareils
-
-Chaque ligne est un appareil affiché par Alexa & Co. Choisissez le **type**, donnez-lui le **nom** que l'assistant utilisera, puis remplissez les adresses de groupe (avec autocomplétion ETS) :
+## Types d'appareil et adresses de groupe
 
 |Type|Adresses de groupe|
 |--|--|
@@ -36,29 +34,20 @@ Chaque ligne est un appareil affiché par Alexa & Co. Choisissez le **type**, do
 | Détecteur fumée/CO | GA état alarme fumée + GA état alarme CO optionnelle (DPT 1.005) : notifications critiques sur le téléphone |
 | Détecteur de fuite d'eau | GA état fuite (DPT 1.005) |
 | Capteur de qualité d'air (CO2) | GA état CO2 en ppm (DPT 9.008) ; la classe de qualité d'air (bonne/correcte/modérée/mauvaise...) est dérivée automatiquement |
-| Robot aspirateur | **Flow uniquement** : pas d'adresses de groupe. Activez les PIN du nœud : les commandes de l'assistant (« lance le nettoyage », pause/reprendre/retour à la base) arrivent sur la sortie comme `rvcmode`/`rvccommand` ; renvoyez l'état avec `msg.payload = { device, function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" }` et le mode avec `function: "rvcmode", value: "cleaning"\|"idle"`. Intégrez votre Roomba/Roborock avec n'importe quel nœud Node-RED et exposez-le à Alexa/Apple |
+| Robot aspirateur | **Flow uniquement** : pas d'adresses de groupe. Activez les PIN du nœud : les commandes de l'assistant (« lance le nettoyage », pause/reprendre/retour à la base) arrivent sur la sortie comme `rvcmode`/`rvccommand` ; renvoyez l'état avec `msg.payload = { function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" }` et le mode avec `function: "rvcmode", value: "cleaning"\|"idle"` |
 
 - **GA de commande** : écrite sur le bus KNX quand l'assistant envoie une commande.
 - **GA d'état** : lue depuis le bus pour tenir à jour les attributs Matter (et les apps).
 
-## Appairage
-
-1. **Déployez**, attendez quelques secondes, puis rouvrez le 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.
-
 ## PIN du nœud
 
 Si vous activez les PIN entrée/sortie du nœud :
 
-- **Entrée** : mettez à jour l'état Matter d'un appareil virtuel depuis le flow, sans passer par le bus KNX : `msg.payload = { device: "Lumière cuisine", function: "onoff", value: true }` (`device` accepte le nom ou l'id interne ; `function` est l'une de `onoff`, `level`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`). Utile pour exposer à Alexa & Co. des valeurs calculées dans le flow (ex. un capteur virtuel).
-- **Sortie** : chaque commande reçue d'un contrôleur Matter est transmise au flow : `msg.topic` = nom de l'appareil, `msg.payload` = valeur, `msg.matter` = la commande brute. Les appareils sans GA de commande deviennent des **appareils flow uniquement** : la commande arrive dans votre flow et vous décidez quoi en faire.
+- **Entrée** : mettez à jour l'état Matter depuis le flux, sans passer par le bus KNX : `msg.payload = { function: "onoff", value: true }` (`function` est l'une de `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Utile pour exposer à Alexa & Co. des valeurs calculées dans le flux (ex. un capteur virtuel).
+- **Sortie** : chaque commande reçue d'un contrôleur Matter est transmise au flux : `msg.topic` = nom de l'appareil, `msg.payload` = valeur, `msg.matter` = la commande brute. Un appareil sans GA de commande devient un **appareil flow uniquement**.
 
 ## Notes
 
-- L'hôte Node-RED doit avoir **IPv6 link-local** activé (exigence standard de Matter) et être joignable par le contrôleur sur le réseau local.
-- L'identité du bridge est enregistrée dans `knxultimatestorage/matter` du répertoire utilisateur de Node-RED : les re-deploys ne nécessitent PAS de nouvel appairage.
-- Les renommages et ajouts d'appareils sont pris en compte automatiquement par les contrôleurs ; un appareil supprimé disparaît des apps.
+- L'identité Matter de l'appareil est liée à ce nœud : supprimer le nœud et en créer un nouveau fait apparaître un tout nouvel appareil dans les apps.
+- Les nœuds d'appareil ajoutés/renommés/supprimés sont pris en compte en quelques secondes, sans réappairer le bridge.
 </script>

package/nodes/locales/fr/knxUltimateMatterBridge.json

@@ -69,7 +69,10 @@
       "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."
-    }
+    },
+    "bridge": "Bridge Matter",
+    "device_name": "Nom (affiché par Alexa & Co.)",
+    "device_help": "Choisissez le type d'appareil et donnez-lui le nom que l'assistant vocal utilisera, puis remplissez les adresses de groupe. La passerelle KNX est optionnelle : sans elle, activez les PIN du nœud et pilotez l'appareil depuis le flux."
   },
   "common": {
     "ga": "GA",

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/knxUltimateIoTBridge.html

@@ -16,6 +16,7 @@ Un bridge MQTT nativo con discovery di Home Assistant. Richiede un broker MQTT r
     - *Messaggi di flow* — il nodo mostra un PIN di ingresso e uno di uscita. Collega l'uscita di un nodo KNXUltimate in modalità **Universale** al PIN di ingresso (bus KNX → MQTT) e il PIN di uscita all'ingresso di un altro nodo KNXUltimate in modalità **Universale** (MQTT → bus KNX).
 - **URL broker / Nome utente / Password** — connessione al tuo broker MQTT.
 - **Topic di base / Prefisso discovery** — topic radice per i topic di stato/comando e il prefisso discovery di HA (predefinito `homeassistant`).
+- **Formato nome entità** — come costruire i nomi delle entità Home Assistant a partire dall'import ETS, i cui nomi iniziano con il percorso dei gruppi, es. `(Luci->Piano terra) Soggiorno`. Scegli *Come importato da ETS* (predefinito), *Prima il nome* (`Soggiorno (Luci->Piano terra)`), *Solo il nome* (`Soggiorno`) oppure *Nome + indirizzo di gruppo* (`Soggiorno (0/1/2)`).
 - **Indirizzi di gruppo da esporre** — ogni indirizzo importato nel gateway KNX (lista ETS) è elencato con una checkbox. Gli indirizzi spuntati vengono pubblicati come entità Home Assistant, tipizzate automaticamente dal DPT (switch, sensor, binary_sensor, number, text). Usa il filtro e i pulsanti *Seleziona tutti* / *Deseleziona tutti*. Per impostazione predefinita sono tutti selezionati. Ogni riga ha inoltre un'opzione **Sola lettura**: un indirizzo in sola lettura viene comunque pubblicato su Home Assistant (lo stato resta visibile) ma non accetta mai comandi verso il bus KNX (gli switch diventano binary_sensor, i number diventano sensor). I pulsanti *Imposta sola lettura* / *Togli sola lettura* la applicano a tutti gli indirizzi attualmente mostrati.
 - **Tapparelle e Termostati** — raggruppano più indirizzi in un'unica entità:
     - *Tapparella*: GA su/giù (1.008), GA stop opzionale (1.007), GA posizione comando/stato opzionale (5.001). *Inverti posizione* mappa la convenzione KNX (0% = aperto) su Home Assistant (100% = aperto).

package/nodes/locales/it/knxUltimateIoTBridge.json

@@ -22,6 +22,12 @@
       "base_topic": "Topic di base",
       "discovery": "Pubblica discovery Home Assistant",
       "discovery_prefix": "Prefisso discovery",
+      "name_format": "Formato nome entità",
+      "name_format_full": "Come importato da ETS: (Gruppo principale->Gruppo intermedio) Nome",
+      "name_format_name_first": "Prima il nome: Nome (Gruppo principale->Gruppo intermedio)",
+      "name_format_name_only": "Solo il nome (rimuovi il percorso ETS)",
+      "name_format_name_ga": "Nome + indirizzo di gruppo: Nome (1/2/3)",
+      "name_format_hint": "Come costruire i nomi delle entità Home Assistant a partire dai nomi importati da ETS, che iniziano con il percorso dei gruppi.",
       "hint": "Richiede un broker MQTT raggiungibile sia da Node-RED che da Home Assistant, con l'integrazione MQTT attiva in HA. Le entità compaiono sotto un dispositivo con il nome di questo nodo. I valori dal bus KNX vengono pubblicati su MQTT e i datapoint scrivibili accettano comandi da Home Assistant.",
       "exposed_gas": "Indirizzi di gruppo da esporre",
       "exposed_gas_hint": "Spunta gli indirizzi di gruppo che vuoi pubblicare su Home Assistant. Per impostazione predefinita sono tutti selezionati. Gli indirizzi usati da una tapparella/termostato qui sotto vengono gestiti lì e non serve spuntarli qui.",

package/nodes/locales/it/knxUltimateMatterBridge.html

@@ -1,11 +1,11 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Matter Bridge (BETA)
+# Matter Bridge device (BETA)
 
 > Questo nodo è in **BETA**: funziona, ma alcuni dettagli potrebbero cambiare tra una release e l'altra.
 
 ## Panoramica
 
-Il nodo Matter Bridge espone gli **indirizzi di gruppo KNX come dispositivi Matter**: Alexa, Google Home, Apple Home (o qualunque controller Matter) associano questo bridge **una sola volta** e vedono tutti i dispositivi KNX configurati, con i nomi che hai scelto, pronti per il controllo da app e vocale.
+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.
 
@@ -13,15 +13,13 @@ Il nodo Matter Bridge espone gli **indirizzi di gruppo KNX come dispositivi Matt
 
 |Campo|Descrizione|
 |--|--|
-| GW KNX | Gateway KNX usato per i telegrammi. **Opzionale**: senza gateway il bridge funziona in modalità solo-flow — abilita i PIN del nodo e piloti ogni dispositivo con i messaggi del flow |
-| Nome del bridge Matter | Come viene chiamato il bridge stesso nelle app Matter |
-| Porta | Porta UDP del server Matter (default 5540). Un solo nodo bridge per istanza Node-RED. |
-| Dispositivi | I dispositivi virtuali KNX esposti su Matter (vedi sotto) |
-| Leggi i GA di stato all'avvio | Invia una `GroupValue_Read` a ogni GA di stato all'avvio, per popolare gli attributi Matter |
+| 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 |
 
-## Dispositivi
-
-Ogni riga è un dispositivo mostrato da Alexa & Co. Scegli il **tipo**, dagli il **nome** che l'assistente userà, poi compila gli indirizzi di gruppo (con autocompletamento ETS):
+## Tipi di dispositivo e indirizzi di gruppo
 
 |Tipo|Indirizzi di gruppo|
 |--|--|
@@ -36,29 +34,20 @@ Ogni riga è un dispositivo mostrato da Alexa & Co. Scegli il **tipo**, dagli il
 | 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 = { device, function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" }` e la modalità con `function: "rvcmode", value: "cleaning"\|"idle"`. Integra il tuo Roomba/Roborock con qualsiasi nodo Node-RED ed esponilo ad Alexa/Apple |
+| 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).
 
-## Abbinamento
-
-1. Fai il **deploy**, attendi qualche secondo, poi riapri il 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.
-
 ## PIN del nodo
 
 Se abiliti i PIN input/output del nodo:
 
-- **Input**: aggiorna lo stato Matter di un dispositivo virtuale dal flow, senza passare dal bus KNX: `msg.payload = { device: "Luce cucina", function: "onoff", value: true }` (`device` accetta il nome o l'id interno; `function` è una tra `onoff`, `level`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`). 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. I dispositivi senza GA di comando diventano **dispositivi solo-flow**: il comando arriva al tuo flow e decidi tu cosa farne.
+- **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'host Node-RED deve avere **IPv6 link-local** attivo (requisito standard Matter) ed essere raggiungibile dal controller sulla rete locale.
-- L'identità del bridge è salvata in `knxultimatestorage/matter` nella directory utente di Node-RED: i re-deploy NON richiedono un nuovo abbinamento.
-- Rinomina e aggiunta di dispositivi vengono recepite automaticamente dai controller; se rimuovi un dispositivo, sparisce dalle app.
+- 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

@@ -69,7 +69,10 @@
       "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",

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/knxUltimateIoTBridge.html

@@ -16,6 +16,7 @@
     - *流消息* — 节点显示一个输入端口和一个输出端口。将一个**通用**模式的 KNXUltimate 节点的输出连接到输入端口（KNX 总线 → MQTT），并将输出端口连接到另一个**通用**模式 KNXUltimate 节点的输入（MQTT → KNX 总线）。
 - **Broker URL / 用户名 / 密码** — 连接到你的 MQTT broker。
 - **基础主题 / 自动发现前缀** — 状态/命令主题的根主题以及 HA 自动发现前缀（默认 `homeassistant`）。
+- **实体名称格式** — 如何根据 ETS 导入生成 Home Assistant 实体名称；ETS 导入的名称以组地址路径开头，例如 `(灯光->一层) 客厅`。可选择 *按 ETS 导入原样*（默认）、*名称在前*（`客厅 (灯光->一层)`）、*仅名称*（`客厅`）或 *名称 + 组地址*（`客厅 (0/1/2)`）。
 - **要暴露的组地址** — KNX 网关中导入的每个地址（ETS 列表）都带有一个复选框。勾选的地址会作为 Home Assistant 实体发布，并根据 DPT 自动分类（switch、sensor、binary_sensor、number、text）。可使用筛选框和*全选* / *全不选*按钮。默认全部选中。每一行还有一个**只读**开关：只读地址仍会发布到 Home Assistant（状态保持可见），但绝不接受回写到 KNX 总线的命令（switch 变为 binary_sensor，number 变为 sensor）。*设为只读* / *取消只读*按钮会将其应用到当前显示的所有地址。
 - **卷帘与温控器** — 将多个地址组合成一个实体：
     - *卷帘*：上/下 GA (1.008)、可选停止 GA (1.007)、可选位置 设置/状态 GA (5.001)。*反转位置* 将 KNX 约定（0% = 打开）映射到 Home Assistant（100% = 打开）。

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

@@ -22,6 +22,12 @@
       "base_topic": "基础主题",
       "discovery": "发布 Home Assistant 自动发现",
       "discovery_prefix": "自动发现前缀",
+      "name_format": "实体名称格式",
+      "name_format_full": "按 ETS 导入原样：(主组->中间组) 名称",
+      "name_format_name_first": "名称在前：名称 (主组->中间组)",
+      "name_format_name_only": "仅名称（移除 ETS 组路径）",
+      "name_format_name_ga": "名称 + 组地址：名称 (1/2/3)",
+      "name_format_hint": "如何根据 ETS 导入的名称生成 Home Assistant 实体名称；ETS 导入的名称以组地址路径开头。",
       "hint": "需要一个 Node-RED 和 Home Assistant 都能访问的 MQTT broker，并在 HA 中启用 MQTT 集成。实体会出现在以该节点命名的设备下。KNX 总线的值会发布到 MQTT，可写的数据点接受来自 Home Assistant 的命令。",
       "exposed_gas": "要暴露的组地址",
       "exposed_gas_hint": "勾选要发布到 Home Assistant 的组地址。默认全部选中。被下方卷帘/温控器使用的地址会在那里处理，无需在此勾选。",

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

@@ -1,11 +1,11 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Matter Bridge (BETA)
+# Matter Bridge device (BETA)
 
 > 此节点处于 **BETA** 阶段：可以正常工作，但细节可能在版本之间发生变化。
 
 ## 概述
 
-Matter Bridge 节点将 **KNX 组地址作为 Matter 设备**公开：Alexa、Google Home、Apple Home（或任何 Matter 控制器）只需配对此桥接器**一次**，即可看到您配置的所有 KNX 设备（使用您输入的名称），随时可通过 App 和语音控制。
+每个 Matter Bridge device 节点将**一个 KNX 设备公开为 Matter 设备**：已配对的控制器（Alexa、Google Home、Apple Home...）会以您输入的名称看到它，随时可通过 App 和语音控制。将它指向一个 **Matter 桥接器**配置节点（真正的桥接器，只需配对一次 - 配对二维码在那里），然后在流程中随意添加任意数量的设备节点。
 
 这与 *Matter Device* 节点方向相反：那里是 KNX 控制 Matter 设备，这里是 Matter 控制器控制 KNX。
 
@@ -13,15 +13,13 @@ Matter Bridge 节点将 **KNX 组地址作为 Matter 设备**公开：Alexa、Go
 
 |字段|说明|
 |--|--|
-| KNX 网关 | 用于报文的 KNX 网关。**可选**：没有网关时桥接器以纯 Flow 模式工作——启用节点引脚并用 Flow 消息驱动每个设备 |
-| Matter 桥接器名称 | 桥接器本身在 Matter App 中显示的名称 |
-| 端口 | Matter 服务器的 UDP 端口（默认 5540）。每个 Node-RED 实例只能有一个桥接器节点。 |
-| 设备 | 在 Matter 上公开的 KNX 虚拟设备（见下文） |
-| 启动时读取状态组地址 | 启动时向每个状态 GA 发送 `GroupValue_Read`，以填充 Matter 属性 |
+| Matter 桥接器 | 此设备所属的 Matter 桥接器配置节点 |
+| KNX 网关 | 用于报文的 KNX 网关。**可选**：没有网关时，设备通过节点引脚以纯 Flow 模式工作。项目中只有一个网关时会自动选择 |
+| 名称 | Alexa 等显示并用于语音命令的名称 |
+| 设备类型 | Matter 设备类型（见下文）；决定显示哪些组地址字段 |
+| 启动时读取状态 | 启动时向状态 GA 发送 `GroupValue_Read`，以填充 Matter 属性 |
 
-## 设备
-
-每一行都是 Alexa 等显示的一个设备。选择**类型**，输入助手将使用的**名称**，然后填写组地址（带 ETS 自动补全）：
+## 设备类型与组地址
 
 |类型|组地址|
 |--|--|
@@ -36,29 +34,20 @@ Matter Bridge 节点将 **KNX 组地址作为 Matter 设备**公开：Alexa、Go
 | 烟雾/CO 报警器 | 烟雾报警状态 GA + 可选 CO 报警状态 GA (DPT 1.005)：手机上的紧急通知 |
 | 漏水探测器 | 漏水状态 GA (DPT 1.005) |
 | 空气质量传感器 (CO2) | CO2 状态 GA，ppm (DPT 9.008)；空气质量等级（好/一般/中等/差...）自动推导 |
-| 扫地机器人 | **仅 Flow**：无组地址。启用节点引脚：助手的命令（"开始清扫"、暂停/继续/回充）作为 `rvcmode`/`rvccommand` 到达输出；用 `msg.payload = { device, function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" }` 报告状态，用 `function: "rvcmode", value: "cleaning"\|"idle"` 报告模式。用任何 Node-RED 节点集成您的 Roomba/Roborock 并公开给 Alexa/Apple |
+| 扫地机器人 | **仅 Flow**：无组地址。启用节点引脚：助手的命令（"开始清扫"、暂停/继续/回充）作为 `rvcmode`/`rvccommand` 到达输出；用 `msg.payload = { function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" }` 报告状态，用 `function: "rvcmode", value: "cleaning"\|"idle"` 报告模式 |
 
 - **命令 GA**：助手发送命令时写入 KNX 总线。
 - **状态 GA**：从总线读取，保持 Matter 属性（和 App）更新。
 
-## 配对
-
-1. **部署**，等待几秒，然后重新打开节点。
-2. 配对面板显示**二维码**和**手动配对码**：在 Alexa / Google Home / Apple Home 中扫描或输入（"添加 Matter 设备"）。
-3. 多个控制器可以与同一个桥接器配对（Matter 多 fabric）。
-
-**重置配对**按钮会移除所有已配对的控制器并重新开始配对广播。
-
 ## 节点引脚
 
 如果启用节点的输入/输出引脚：
 
-- **输入**：从 Flow 更新虚拟设备的 Matter 状态，无需经过 KNX 总线：`msg.payload = { device: "厨房灯", function: "onoff", value: true }`（`device` 接受名称或内部 id；`function` 为 `onoff`、`level`、`position`、`temperature`、`humidity`、`illuminance`、`occupancy`、`contact`、`currenttemp`、`setpoint` 之一）。适合把 Flow 中计算的值（如虚拟传感器）公开给 Alexa 等。
-- **输出**：从 Matter 控制器收到的每个命令都转发到 Flow：`msg.topic` = 设备名称，`msg.payload` = 值，`msg.matter` = 原始命令。没有命令 GA 的设备成为**纯 Flow 设备**：命令到达您的 Flow，由您决定如何处理。
+- **输入**：从 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 设备**。
 
 ## 说明
 
-- Node-RED 主机必须启用 **IPv6 link-local**（Matter 标准要求），并且控制器可在本地网络访问到它。
-- 桥接器身份保存在 Node-RED 用户目录的 `knxultimatestorage/matter` 中：重新部署**不**需要重新配对。
-- 设备重命名和新增会被控制器自动识别；移除的设备会从 App 中消失。
+- 设备的 Matter 身份与此节点绑定：删除节点并新建一个后，App 会看到一个全新的设备。
+- 添加/重命名/移除的设备节点会在几秒内被已配对的控制器识别，无需重新配对桥接器。
 </script>

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

@@ -69,7 +69,10 @@
       "reset_button": "重置配对",
       "reset_confirm": "移除所有已配对的控制器并重新开始配对？设备将从 Alexa/Google/Apple 中消失。",
       "reset_ok": "配对已重置。桥接器重新进入配对模式。"
-    }
+    },
+    "bridge": "Matter 桥接器",
+    "device_name": "名称（Alexa 等显示）",
+    "device_help": "选择设备类型并输入语音助手将使用的名称，然后填写组地址。KNX 网关是可选的：没有网关时，启用节点引脚并从流程驱动设备。"
   },
   "common": {
     "ga": "GA",

package/nodes/locales/zh-CN/matterbridge-config.html

@@ -0,0 +1,34 @@
+<script type="text/markdown" data-help-name="matterbridge-config">
+# Matter 桥接器 (BETA)
+
+> 此节点处于 **BETA** 阶段：可以正常工作，但细节可能在版本之间发生变化。
+
+## 概述
+
+此配置节点就是 **Matter 桥接器本身**：它运行 Matter 服务器，Alexa、Google Home、Apple Home（或任何 Matter 控制器）只需配对**一次**。流程中的每个 **Matter Bridge device** 节点都指向这里，并在 App 中显示为桥接器的一个设备。
+
+## 配置
+
+|字段|说明|
+|--|--|
+| 名称 | 此配置节点在 Node-RED 中的名称 |
+| Matter 桥接器名称 | 桥接器本身在 Matter App 中显示的名称 |
+| 端口 | Matter 服务器的 UDP 端口（默认 5540）。每个桥接器需要独立的端口，因此可以运行**多个独立的桥接器** |
+
+## 配对
+
+1. **部署**，等待几秒，然后重新打开此节点。
+2. 配对面板显示**二维码**和**手动配对码**：在 Alexa / Google Home / Apple Home 中扫描或输入（"添加 Matter 设备"）。
+3. 多个控制器可以与同一个桥接器配对（Matter 多 fabric）。
+
+**重置配对**按钮会移除所有已配对的控制器并重新开始配对广播。
+
+## 身份与存储
+
+桥接器身份与此配置节点绑定，保存在 Node-RED 用户目录的 `knxultimatestorage/matter` 中：重新部署（即使更改端口或名称）**不**需要重新配对。只有删除此配置节点并新建一个才会改变身份——此时请从 Matter App 中移除旧桥接器并重新配对。
+
+## 说明
+
+- Node-RED 主机必须启用 **IPv6 link-local**（Matter 标准要求），并且控制器可在本地网络访问到它。
+- 添加/重命名/移除的设备节点会在几秒内被已配对的控制器识别，无需重新配对。
+</script>

package/nodes/locales/zh-CN/matterbridge-config.json

@@ -0,0 +1,20 @@
+{
+  "matterbridge-config": {
+    "properties": {
+      "title": "Matter 桥接器",
+      "intro": "此配置节点就是 Matter 桥接器本身：Alexa、Google Home、Apple Home（或任何 Matter 控制器）配对一次即可看到你挂接的所有 KNX 设备。在流程中添加 \"Matter Bridge device\" 节点并指向这里。先部署，然后重新打开获取配对码。",
+      "node-config-input-name": "名称",
+      "bridge_name": "Matter 桥接器名称",
+      "port": "端口",
+      "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": "配对已重置。桥接器重新进入配对模式。"
+    }
+  }
+}