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

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/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": "配对已重置。桥接器重新进入配对模式。"
+    }
+  }
+}

package/nodes/matterbridge-config.html

@@ -0,0 +1,121 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
+
+<script type="text/javascript">
+    RED.nodes.registerType('matterbridge-config', {
+        category: 'config',
+        defaults: {
+            name: { value: '' },
+            bridgeDeviceName: { value: 'KNX-Ultimate Bridge' },
+            bridgePort: { value: 5540, required: true, validate: RED.validators.number() }
+        },
+        oneditprepare: function () {
+            try { RED.sidebar.show('help'); } catch (error) { }
+
+            var node = this;
+            var $pairingBody = $('#mbc-pairing-body');
+            var $refreshPairing = $('#mbc-refresh-pairing');
+            var $resetButton = $('#mbc-factory-reset');
+
+            var t = function (key) {
+                return RED._('node-red-contrib-knx-ultimate/matterbridge-config:matterbridge-config.properties.' + key);
+            };
+
+            function loadPairingInfo() {
+                $pairingBody.html('<i class="fa fa-circle-notch fa-spin"></i>');
+                $.getJSON('KNXUltimateMatterBridgeInfo?configId=' + node.id + '&_=' + Date.now(), function (info) {
+                    $pairingBody.empty();
+                    if (info.error) {
+                        $pairingBody.append($('<p style="color:#999;"></p>').text(info.error));
+                        return;
+                    }
+                    if (!info.running) {
+                        $pairingBody.append($('<p style="color:#999;"></p>').text(t('not_running')));
+                        return;
+                    }
+                    if (info.commissioned) {
+                        $pairingBody.append($('<p style="color:#1b7d33;"></p>').text(t('commissioned') + ' (' + info.fabrics.length + ')'));
+                        info.fabrics.forEach(function (f) {
+                            $pairingBody.append($('<div style="margin-left:10px;"></div>').text('• ' + (f.label || 'Controller') + ' (vendor ' + f.vendorId + ')'));
+                        });
+                        $resetButton.show();
+                        return;
+                    }
+                    $pairingBody.append($('<p style="color:#b8860b;"></p>').text(t('awaiting')));
+                    if (info.manualPairingCode) {
+                        $pairingBody.append($('<p></p>').append($('<b style="font-size:18px; letter-spacing:2px;"></b>').text(info.manualPairingCode)));
+                    }
+                    if (info.qrAscii) {
+                        $pairingBody.append($('<pre style="font-family:monospace; line-height:1.05; font-size:7px; display:inline-block; padding:6px; background:#fff; color:#000;"></pre>').text(info.qrAscii));
+                    }
+                    if (info.qrPairingCode) {
+                        var url = 'https://project-chip.github.io/connectedhomeip/qrcode.html?data=' + encodeURIComponent(info.qrPairingCode);
+                        $pairingBody.append($('<p></p>').append($('<a target="_blank"></a>').attr('href', url).text(t('qr_link'))));
+                    }
+                    $resetButton.hide();
+                }).fail(function () {
+                    $pairingBody.empty();
+                    $pairingBody.append($('<p style="color:#999;"></p>').text(t('deploy_first')));
+                });
+            }
+
+            $refreshPairing.on('click', function () { loadPairingInfo(); });
+            $resetButton.on('click', function () {
+                if (!window.confirm(t('reset_confirm'))) return;
+                $resetButton.prop('disabled', true);
+                $.getJSON('KNXUltimateMatterBridgeReset?configId=' + node.id, function (data) {
+                    if (data && data.error) RED.notify(data.error, { type: 'error' });
+                    else RED.notify(t('reset_ok'), { type: 'success' });
+                    loadPairingInfo();
+                }).always(function () { $resetButton.prop('disabled', false); });
+            });
+
+            loadPairingInfo();
+        },
+        oneditsave: function () {
+            try { RED.sidebar.show('info'); } catch (error) { }
+        },
+        label: function () {
+            return this.name || this.bridgeDeviceName || 'Matter Bridge';
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="matterbridge-config">
+  <div class="form-row" style="margin-bottom:10px;">
+    <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
+  </div>
+
+  <div class="form-row">
+    <b><span data-i18n="matterbridge-config.properties.title"></span></b>
+    <p><span data-i18n="matterbridge-config.properties.intro"></span></p>
+  </div>
+
+  <div class="form-row">
+    <label for="node-config-input-name">
+      <i class="fa fa-tag"></i> <span data-i18n="matterbridge-config.properties.node-config-input-name"></span>
+    </label>
+    <input type="text" id="node-config-input-name">
+  </div>
+
+  <div class="form-row">
+    <label for="node-config-input-bridgeDeviceName" style="width:180px;">
+      <i class="fa fa-share-alt"></i> <span data-i18n="matterbridge-config.properties.bridge_name"></span>
+    </label>
+    <input type="text" id="node-config-input-bridgeDeviceName" style="width:220px;">
+    <label for="node-config-input-bridgePort" style="width:60px; text-align:right;"><span data-i18n="matterbridge-config.properties.port"></span></label>
+    <input type="number" id="node-config-input-bridgePort" style="width:90px;">
+  </div>
+
+  <hr/>
+
+  <div class="form-row">
+    <b><i class="fa fa-qrcode"></i>&nbsp;<span data-i18n="matterbridge-config.properties.pairing_title"></span></b>
+    <button type="button" id="mbc-refresh-pairing" class="red-ui-button" style="margin-left:6px; color:#1b7d33; border-color:#1b7d33;">
+      <i class="fa fa-refresh"></i>
+    </button>
+    <button type="button" id="mbc-factory-reset" class="red-ui-button" style="margin-left:6px; color:#c00; border-color:#c00; display:none;">
+      <i class="fa fa-trash"></i>&nbsp;<span data-i18n="matterbridge-config.properties.reset_button"></span>
+    </button>
+  </div>
+  <div class="form-row" id="mbc-pairing-body" style="text-align:center;"></div>
+</script>

package/nodes/matterbridge-config.js

@@ -0,0 +1,220 @@
+/* eslint-disable max-len */
+const path = require('path')
+
+// 10/09/2024 Setup the color logger
+const loggerSetup = (options) => {
+  const clog = require('node-color-log').createNamedLogger(options.setPrefix)
+  clog.setLevel(options.loglevel)
+  clog.setDate(() => (new Date()).toLocaleString())
+  return clog
+}
+
+// The running Matter servers, keyed by config node id. Kept OUTSIDE the node lifecycle:
+// a re-deploy must NOT restart the Matter server, otherwise the paired controllers
+// resume their session without re-reading the structure and never see device changes.
+// The devices are reconciled live instead; the server is closed only when the config
+// node is deleted/disabled.
+const runningBridges = new Map()
+
+module.exports = (RED) => {
+  function matterBridgeConfig (config) {
+    RED.nodes.createNode(this, config)
+    const node = this
+    node.loglevel = config.loglevel !== undefined ? config.loglevel : 'error'
+    node.sysLogger = null
+    try {
+      node.sysLogger = loggerSetup({ loglevel: node.loglevel, setPrefix: 'matterbridge-config.js' })
+    } catch (error) { console.log(error.stack) }
+
+    node.name = config.name === undefined || config.name === '' ? 'Matter Bridge' : config.name
+    node.bridgePort = Number(config.bridgePort) || 5540
+    node.bridgeDeviceName = config.bridgeDeviceName === undefined || config.bridgeDeviceName === '' ? 'KNX-Ultimate Bridge' : config.bridgeDeviceName
+    node.matterInstanceId = `knxultimate-bridge-${node.id.replace(/[^a-zA-Z0-9]/g, '')}`
+    node.matterStoragePath = path.join(RED.settings.userDir || '.', 'knxultimatestorage', 'matter')
+
+    node.matterBridge = null
+    node.deviceClients = new Map() // matterDeviceId -> device node
+    let startupTimer = null
+    let reconcileTimer = null
+    let closing = false
+
+    Object.defineProperty(node, 'linkStatus', {
+      get: function () {
+        return node.matterBridge?.bridgeStatus === 'running' ? 'running' : 'stopped'
+      }
+    })
+
+    const safeClientCall = (client, fn, label) => {
+      try {
+        if (!client || typeof fn !== 'function') return
+        fn()
+      } catch (error) {
+        node.sysLogger?.warn(`Matter bridge client ${label} error: ${error.message}`)
+      }
+    }
+
+    // Desired device definitions built from the currently registered device nodes.
+    const buildDeviceDefs = () => {
+      const defs = []
+      node.deviceClients.forEach((client) => {
+        try {
+          const def = typeof client.getMatterDef === 'function' ? client.getMatterDef() : undefined
+          if (def && def.id && def.type) defs.push(def)
+        } catch (error) { /* empty */ }
+      })
+      return defs
+    }
+
+    // Notify every registered device node that the bridge status changed.
+    const notifyClientsStatus = () => {
+      node.deviceClients.forEach((client) => {
+        safeClientCall(client, () => client.handleBridgeStatus(), 'handleBridgeStatus')
+      })
+    }
+
+    const bindEngineEvents = (engine) => {
+      engine.removeAllListeners()
+      // Matter -> KNX: a controller (Alexa...) sent a command to a bridged device.
+      // Route it to the device node that owns that Matter device.
+      engine.on('command', (command) => {
+        try {
+          const client = node.deviceClients.get(command.deviceId)
+          if (client === undefined) return
+          safeClientCall(client, () => client.handleMatterCommand(command), 'handleMatterCommand')
+        } catch (error) {
+          node.sysLogger?.warn(`matterbridge-config: command routing error: ${error.message}`)
+        }
+      })
+      engine.on('commissioned', () => notifyClientsStatus())
+      engine.on('decommissioned', () => notifyClientsStatus())
+      engine.on('fabricsChanged', () => notifyClientsStatus())
+      engine.on('online', () => notifyClientsStatus())
+    }
+
+    // Reconcile the exposed devices with the currently registered device nodes.
+    const scheduleReconcile = () => {
+      if (reconcileTimer !== null) clearTimeout(reconcileTimer)
+      reconcileTimer = setTimeout(() => {
+        (async () => {
+          try {
+            if (node.matterBridge === null || node.matterBridge.bridgeStatus !== 'running') return
+            await node.matterBridge.reconcileDevices(buildDeviceDefs())
+            notifyClientsStatus()
+          } catch (error) {
+            node.sysLogger?.warn(`matterbridge-config: reconcile error: ${error.message}`)
+          }
+        })()
+      }, 1500)
+    }
+
+    const ensureEngineStarted = async () => {
+      try {
+        const { classMatterBridge } = await import('./utils/matterBridgeEngine.mjs')
+        const existing = runningBridges.get(node.id)
+
+        if (existing !== undefined && existing.bridgeStatus === 'running' &&
+          Number(existing.options.port) === node.bridgePort &&
+          existing.options.deviceName === node.bridgeDeviceName) {
+          // Re-deploy: reuse the running Matter server and reconcile the devices live.
+          node.matterBridge = existing
+          bindEngineEvents(existing)
+          await existing.reconcileDevices(buildDeviceDefs())
+          notifyClientsStatus()
+          return
+        }
+
+        if (existing !== undefined) {
+          // Port or bridge name changed: a full restart is unavoidable.
+          try {
+            existing.removeAllListeners()
+            await existing.close()
+          } catch (error) { /* empty */ }
+          runningBridges.delete(node.id)
+        }
+
+        const engine = new classMatterBridge(node.matterStoragePath, node.matterInstanceId, {
+          info: (m) => node.sysLogger?.info(m),
+          warn: (m) => node.sysLogger?.warn(m),
+          error: (m) => node.sysLogger?.error(m),
+          debug: (m) => node.sysLogger?.debug(m)
+        }, { port: node.bridgePort, deviceName: node.bridgeDeviceName })
+        runningBridges.set(node.id, engine)
+        node.matterBridge = engine
+        bindEngineEvents(engine)
+        await engine.start(buildDeviceDefs())
+        notifyClientsStatus()
+      } catch (error) {
+        node.sysLogger?.error(`matterbridge-config: ensureEngineStarted error: ${error.message}`)
+      }
+    }
+
+    // The Matter server is started shortly after boot, giving the device nodes the
+    // time to register themselves during flow initialization.
+    startupTimer = setTimeout(() => {
+      (async () => {
+        if (closing) return
+        await ensureEngineStarted()
+      })()
+    }, 5000)
+
+    // Functions called from the device nodes -----------------------------------------
+    node.registerDevice = (client) => {
+      try {
+        if (!client || !client.matterDeviceId) return
+        node.deviceClients.set(client.matterDeviceId, client)
+        scheduleReconcile()
+      } catch (error) {
+        node.sysLogger?.warn(`matterbridge-config: registerDevice error: ${error.message}`)
+      }
+    }
+
+    node.unregisterDevice = (client) => {
+      try {
+        if (!client || !client.matterDeviceId) return
+        node.deviceClients.delete(client.matterDeviceId)
+        scheduleReconcile()
+      } catch (error) { /* empty */ }
+    }
+
+    node.setDeviceState = async (deviceId, fn, value) => {
+      if (node.matterBridge === null) return false
+      return node.matterBridge.setDeviceState(deviceId, fn, value)
+    }
+
+    node.getPairingInfo = () => {
+      if (node.matterBridge === null) return { running: false }
+      return node.matterBridge.getPairingInfo()
+    }
+
+    node.factoryResetBridge = async () => {
+      if (node.matterBridge === null) throw new Error('Matter bridge not started')
+      await node.matterBridge.factoryReset()
+      notifyClientsStatus()
+    }
+    // END functions called from the device nodes -------------------------------------
+
+    node.on('close', (removed, done) => {
+      closing = true
+      try {
+        if (startupTimer !== null) clearTimeout(startupTimer)
+        if (reconcileTimer !== null) clearTimeout(reconcileTimer)
+      } catch (error) { /* empty */ }
+      try {
+        if (node.matterBridge !== null) node.matterBridge.removeAllListeners()
+      } catch (error) { /* empty */ }
+      (async () => {
+        try {
+          if (removed === true && node.matterBridge !== null) {
+            await node.matterBridge.close()
+            runningBridges.delete(node.id)
+          }
+        } catch (error) { /* empty */ }
+        node.matterBridge = null
+        node.deviceClients.clear()
+        node.sysLogger = null
+        done()
+      })()
+    })
+  }
+  RED.nodes.registerType('matterbridge-config', matterBridgeConfig)
+}