node-red-contrib-knx-ultimate 6.3.9 → 6.3.11

package/CHANGELOG.md

@@ -6,6 +6,14 @@
 
 # CHANGELOG
 
+**Version 6.3.11** - August 2026<br/>
+
+- **Matter Controller**: fixed KNX GA mapping tabs being hidden by transient empty KNX/Matter config-selector values during Node-RED 5 editor initialization; saved gateways now remain selected until the user explicitly changes them.<br/>
+
+**Version 6.3.10** - August 2026<br/>
+
+- **Watchdog**: added a default-on option to listen for error states reported by KNX-Ultimate nodes, including KNX Device, through the selected gateway; disabling it suppresses `NodeError` flow messages without affecting the Watchdog's own bus checks or control messages. Existing flows retain the previous enabled behavior.<br/>
+
 **Version 6.3.9** - August 2026<br/>
 
 - **Matter on Home Assistant**: declared the Node.js platform adapter as a required runtime dependency so Home Assistant's Node-RED add-on cannot omit it while installing optional packages; Matter Controller and Matter Bridge now load normally instead of reporting `Cannot find module '@matter/nodejs'` at startup.<br/>

package/nodes/knxUltimate-config.js

@@ -23,6 +23,7 @@ const loggerClass = require('./utils/sysLogger')
 // const { Server } = require('http')
 const payloadRounder = require('./utils/payloadManipulation')
 const utils = require('./utils/utils')
+const dispatchWatchDogNodeError = require('./utils/watchDogErrorDispatcher')
 
 // Versions logged once at startup (node package + KNXUltimate engine)
 let NODE_VERSION = 'unknown'
@@ -831,13 +832,7 @@ module.exports = (RED) => {
     // 16/02/2020 KNX-Ultimate nodes calls this function, then this funcion calls the same function on the Watchdog
     node.reportToWatchdogCalledByKNXUltimateNode = (_oError) => {
       // _oError is = { nodeid: node.id, topic: node.outputtopic, devicename: devicename, GA: GA, text: text };
-      const readHistory = []
-      const delay = 0
-      node.nodeClients
-        .filter((_oClient) => _oClient.isWatchDog !== undefined && _oClient.isWatchDog === true)
-        .forEach((_oClient) => {
-          _oClient.signalNodeErrorCalledByConfigNode(_oError)
-        })
+      dispatchWatchDogNodeError(node, _oError)
     }
 
     node.addClient = (_Node) => {

package/nodes/knxUltimateMatterControllerDevice.html

@@ -3,6 +3,7 @@
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/11f26b4500.js"></script>
 
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/configNodeEditorSelection.js"></script>
 
 <script type="text/javascript">
   (function () {
@@ -161,16 +162,6 @@
           });
         }
         $("#node-input-updateLocalStateFromKNXWrite").prop("checked", node.updateLocalStateFromKNXWrite === true || node.updateLocalStateFromKNXWrite === "true"); // Starting from v 4.1.31
-        const ensureConfigSelection = (selector) => {
-          if ($(selector).val() !== "_ADD_") return;
-          try {
-            $(selector).prop("selectedIndex", 0);
-          } catch (error) {
-            // Ignore UI quirks for legacy Node-RED versions
-          }
-        };
-        ["#node-input-server", "#node-input-serverMatter"].forEach(ensureConfigSelection);
-
         function ensureVerticalTabsStyle() {
           if ($('#knxUltimateMatterControllerDeviceVerticalTabs').length) return;
           const style = `
@@ -261,7 +252,7 @@
         function onEditPrepare() {
           ensureVerticalTabsStyle();
           const $knxServerInput = $("#node-input-server");
-          const KNX_EMPTY_VALUES = new Set(['', 'none', '_ADD_', '__NONE__']);
+          const KNX_EMPTY_VALUES = new Set(['', 'none', '_add_', '__none__']);
           // Historical variable names are retained for saved-flow compatibility; they point to Matter widgets.
           const $hueServerInput = $("#node-input-serverMatter");
           const $matterControllerModeInput = $("#node-input-matterControllerMode");
@@ -300,6 +291,21 @@
           let matterDevicePickerMouseDown = false;
           let showingNoHueDevicesPlaceholder = false;
           const HUE_EMPTY_SERVER_VALUES = new Set(['', 'none', '_add_', '__none__', '__null__', 'null', 'undefined']);
+          const selectionApi = window.KNXUltimateConfigNodeEditorSelection;
+          const normalizeConfigSelection = selectionApi && typeof selectionApi.normalizeSelection === 'function'
+            ? selectionApi.normalizeSelection
+            : (value, emptyValues) => {
+                const normalized = value === undefined || value === null ? '' : String(value).trim();
+                return emptyValues.has(normalized.toLowerCase()) ? '' : normalized;
+              };
+          const resolveSelectedOrStoredSelection = selectionApi && typeof selectionApi.resolveSelectedOrStoredSelection === 'function'
+            ? selectionApi.resolveSelectedOrStoredSelection
+            : (selectedValue, storedValue, emptyValues) => normalizeConfigSelection(selectedValue, emptyValues) || normalizeConfigSelection(storedValue, emptyValues);
+          const shouldPreserveSelection = selectionApi && typeof selectionApi.shouldPreserveSelection === 'function'
+            ? selectionApi.shouldPreserveSelection
+            : (event, nextValue, currentValue, emptyValues) => (!event || !event.originalEvent) && normalizeConfigSelection(nextValue, emptyValues) === '' && normalizeConfigSelection(currentValue, emptyValues) !== '';
+          let activeKnxServerId = resolveSelectedOrStoredSelection($knxServerInput.val(), node.server, KNX_EMPTY_VALUES);
+          let activeMatterServerId = resolveSelectedOrStoredSelection($hueServerInput.val(), node.serverMatter, HUE_EMPTY_SERVER_VALUES);
           let locateSessionActive = false;
           let locateAutoResetTimer = null;
           let locatePendingRequest = null;
@@ -483,14 +489,7 @@
           };
 
           const resolveKnxServerValue = () => {
-            const domValue = $knxServerInput.val();
-            if (domValue !== undefined && domValue !== null && domValue !== '') {
-              return domValue;
-            }
-            if (node.server !== undefined && node.server !== null) {
-              return node.server;
-            }
-            return '';
+            return activeKnxServerId;
           };
 
           const hasKnxServerSelected = () => {
@@ -500,17 +499,7 @@
           };
 
           const resolveHueServerValue = ({ allowStored = false } = {}) => {
-            if ($hueServerInput.length) {
-              const domValue = $hueServerInput.val();
-              if (domValue !== undefined && domValue !== null) {
-                const trimmed = String(domValue).trim();
-                if (trimmed !== '' && !HUE_EMPTY_SERVER_VALUES.has(trimmed.toLowerCase())) return trimmed;
-              }
-            }
-            if (node.serverMatter !== undefined && node.serverMatter !== null) {
-              const stored = String(node.serverMatter).trim();
-              if (stored !== '' && !HUE_EMPTY_SERVER_VALUES.has(stored.toLowerCase())) return stored;
-            }
+            if (activeMatterServerId !== '') return activeMatterServerId;
             if (allowStored && node.__locateSessionInfo && node.__locateSessionInfo.serverId) {
               return node.__locateSessionInfo.serverId;
             }
@@ -1458,8 +1447,20 @@
           $matterControllerModeInput.on('change.knxUltimateMatterControllerDevice', applyControllerMode);
           $universalServiceInput.on('change.knxUltimateMatterControllerDevice', refreshUniversalServiceVisibility);
 
-          $knxServerInput.on('change.knxUltimateMatterControllerDevice', () => {
-            refreshKnxBindings();
+          $knxServerInput.on('change.knxUltimateMatterControllerDevice', function (event) {
+            const selectedValue = $(this).val();
+            if (shouldPreserveSelection(event, selectedValue, activeKnxServerId, KNX_EMPTY_VALUES)) {
+              // Node-RED 5 can briefly emit an empty placeholder while rebuilding
+              // config-node selectors. Restore the effective saved value so an
+              // untouched save and the mapping tabs both keep the KNX gateway.
+              $knxServerInput.val(activeKnxServerId);
+              updateTabsVisibility();
+              return;
+            }
+            activeKnxServerId = normalizeConfigSelection(selectedValue, KNX_EMPTY_VALUES);
+            // Selecting none only changes visibility. Keep the mounted GA/DPT
+            // controls intact so choosing the gateway again cannot lose values.
+            if (activeKnxServerId !== '') refreshKnxBindings();
             updateTabsVisibility();
           });
 
@@ -1553,7 +1554,15 @@
           }
 
           if ($hueServerInput.length) {
-            $hueServerInput.off('.knxUltimateMatterControllerDeviceDevices').on('change.knxUltimateMatterControllerDeviceDevices', () => {
+            $hueServerInput.off('.knxUltimateMatterControllerDeviceDevices').on('change.knxUltimateMatterControllerDeviceDevices', function (event) {
+              const selectedValue = $(this).val();
+              if (shouldPreserveSelection(event, selectedValue, activeMatterServerId, HUE_EMPTY_SERVER_VALUES)) {
+                $hueServerInput.val(activeMatterServerId);
+                return;
+              }
+              const nextMatterServerId = normalizeConfigSelection(selectedValue, HUE_EMPTY_SERVER_VALUES);
+              if (nextMatterServerId === activeMatterServerId) return;
+              activeMatterServerId = nextMatterServerId;
               cachedHueDevices = [];
               node._cachedHueLightDevices = cachedHueDevices;
               showingNoHueDevicesPlaceholder = false;
@@ -1772,11 +1781,6 @@
 
         // The Matter controller needs no readiness poll here: the light list is fetched
         // on demand by the autocomplete. Start the editor immediately.
-        $("#node-input-serverMatter").change(function () {
-          try {
-            node._cachedHueLightDevices = [];
-          } catch (error) { }
-        });
         Go();
         // ################################################################
 

package/nodes/knxUltimateWatchDog.html

@@ -11,6 +11,7 @@
             retryInterval: { value: 10 },
             name: { value: "" },
             autoStart: { value: true },
+            listenToKnxUltimateNodeErrors: { value: true },
             checkLevel: { value: "Ethernet" }
         },
         inputs: 1,
@@ -190,7 +191,11 @@
     <div class="form-row">
         <input type="checkbox" id="node-input-autoStart" style="display:inline-block; width:auto; vertical-align:top;">
         <label style="width:auto" for="node-input-autoStart">&nbsp;&nbsp;<i class="fa fa-play-circle"></i> <span data-i18n="knxUltimateWatchDog.properties.node-input-autoStart"></span> </label>
-    </div>    
+    </div>
+    <div class="form-row">
+        <input type="checkbox" id="node-input-listenToKnxUltimateNodeErrors" style="display:inline-block; width:auto; vertical-align:top;">
+        <label style="width:auto" for="node-input-listenToKnxUltimateNodeErrors">&nbsp;&nbsp;<i class="fa fa-exclamation-triangle"></i> <span data-i18n="knxUltimateWatchDog.properties.node-input-listenToKnxUltimateNodeErrors"></span> </label>
+    </div>
     
     <div id="advancedOptionsAccordion">
         <h3><span data-i18n="knxUltimateWatchDog.properties.advancedOptionsAccordion"></span></h3>

package/nodes/knxUltimateWatchDog.js

@@ -21,6 +21,9 @@ module.exports = function (RED) {
     node.retryInterval = config.retryInterval !== undefined ? config.retryInterval * 1000 : 10000
     node.maxRetry = config.maxRetry !== undefined ? config.maxRetry : 6
     node.autoStart = config.autoStart !== undefined ? config.autoStart : true
+    // Keep existing flows compatible: before this option was exposed, KNX-Ultimate
+    // node errors were always forwarded by the gateway to every Watchdog node.
+    node.listenToKnxUltimateNodeErrors = config.listenToKnxUltimateNodeErrors !== false && config.listenToKnxUltimateNodeErrors !== 'false'
     node.beatNumber = 0 // Telegram counter
     node.timerWatchDog = null
     node.isWatchDog = true
@@ -119,6 +122,8 @@ module.exports = function (RED) {
 
     // 16/02/2020 This function is called by the knx-ultimate config node.
     node.signalNodeErrorCalledByConfigNode = _oError => {
+      if (!node.listenToKnxUltimateNodeErrors) return
+
       // Report an error from knx-ultimate node.
       // let oError = {nodeid:node.id,topic:node.outputtopic,devicename:devicename,GA:GA,text:text};
       const msg = {
@@ -214,9 +219,10 @@ module.exports = function (RED) {
     if (node.serverKNX) {
       if (node.timerWatchDog !== null) clearInterval(node.timerWatchDog)
       node.serverKNX.removeClient(node)
-      if (node.topic || node.listenallga) {
+      const hasHealthCheckTarget = node.checkLevel === 'Ethernet' || Boolean(node.topic)
+      if (hasHealthCheckTarget || node.listenToKnxUltimateNodeErrors) {
         node.serverKNX.addClient(node)
-        if (node.autoStart) node.StartWatchDogTimer() // Autostart watchdog
+        if (node.autoStart && hasHealthCheckTarget) node.StartWatchDogTimer() // Autostart watchdog
       }
     }
   }

package/nodes/locales/de/knxUltimateMatterControllerDevice.html

@@ -11,7 +11,7 @@ Er ersetzt die unveröffentlichten getrennten Matter-Controller-Nodes und behäl
 
 |Feld|Beschreibung|
 |--|--|
-| KNX GW | KNX-Gateway zum Schreiben und Beantworten der konfigurierten Gruppenadressen. Kann leer bleiben, wenn nur der Node-RED-Ausgang benötigt wird. |
+| KNX GW | KNX-Gateway zum Schreiben und Beantworten der konfigurierten Gruppenadressen. Kann leer bleiben, wenn nur der Node-RED-Ausgang benötigt wird. Das gespeicherte Gateway bleibt während der Initialisierung des Editors ausgewählt und ändert sich erst nach einer ausdrücklichen Benutzerauswahl. |
 | Matter controller | Matter-Controller-Konfigurationsknoten, in dem das Gerät gekoppelt wurde. |
 | Matter device | Matter-Endpunkt aus den gekoppelten Geräten. Die UI wird aus den echten Fähigkeiten neu aufgebaut. |
 | Switch / Steckdose / Licht On-Off | On/Off-Befehls- und Status-Gruppenadressen, normalerweise DPT `1.001`. |

package/nodes/locales/de/knxUltimateWatchDog.html

@@ -26,6 +26,7 @@ Ideal zum Signalisieren von Fehlern/Verbindungsproblemen (E-Mail, automatisches
 | Gruppenadresse monitor | GA, an die gelesen wird und von der eine Antwort erwartet wird. DPT muss 1.x (Boolean) sein. |
 | Name | Node-Name. |
 | Watchdog-Timer automatisch starten | Timer beim Deploy/Start automatisch starten. |
+| Fehler von KNX-Ultimate-Nodes überwachen | Standardmäßig aktiviert. Gibt eine `NodeError`-Nachricht aus, wenn ein KNX-Ultimate-Node am gewählten Gateway, einschließlich KNX Device, einen roten Fehlerstatus meldet. Bei Deaktivierung werden nur diese `NodeError`-Nachrichten unterdrückt; die eigenen Busprüfungen und Steuernachrichten des WatchDog bleiben aktiv. |
 | Check level (siehe wiki) | Siehe oben. |
 
 **Check level**
@@ -47,7 +48,7 @@ Ideal zum Signalisieren von Fehlern/Verbindungsproblemen (E-Mail, automatisches
 
 # Ausgaben des WatchDog
 
-Der Node gibt Nachrichten aus, wenn eigene Prüfungen Fehler melden oder wenn ein KNX-Ultimate-Node im Flow einen Fehlerstatus meldet.
+Der WatchDog gibt seine eigenen Busprüfungs- und Steuernachrichten immer aus. Wenn **Fehler von KNX-Ultimate-Nodes überwachen** aktiviert ist, gibt er zusätzlich Fehler von KNX-Ultimate-Nodes, einschließlich KNX Device, am gewählten Gateway aus.
 
 **Bei WatchDog-eigenem Verbindungsproblem**
 
@@ -64,7 +65,7 @@ msg = {
 }
 ```
 
-**Wenn einer deiner KNX-Ultimate-Nodes Probleme hat**
+**Wenn die Fehlerüberwachung aktiviert ist und ein KNX-Ultimate-Node ein Problem meldet**
 
 ```javascript
 
@@ -164,4 +165,4 @@ msg.connectGateway = true; return msg;
 ## Siehe auch
 
 [Sample WatchDog](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---WatchDog)
-</script>
+</script>

package/nodes/locales/de/knxUltimateWatchDog.json

@@ -8,6 +8,7 @@
             "node-input-topic": "Gruppenadresse monitor",
             "node-input-name": "Name",
             "node-input-autoStart": "Watchdog-Timer automatisch starten",
+            "node-input-listenToKnxUltimateNodeErrors": "Fehler von KNX-Ultimate-Nodes überwachen",
             "advancedOptionsAccordion": "Erweiterte Optionen",
             "node-input-retryInterval": "Wiederholungsintervall (in Sekunden)",
             "node-input-maxRetry": "Anzahl der Wiederholungen, bevor ein Fehler ausgegeben wird"

package/nodes/locales/en/knxUltimateMatterControllerDevice.html

@@ -11,7 +11,7 @@ It replaces the unpublished per-device Matter controller nodes and keeps the ful
 
 |Field|Description|
 |--|--|
-| KNX GW | KNX gateway used to write and answer the configured group addresses. It can be left empty when only Node-RED output is needed. |
+| KNX GW | KNX gateway used to write and answer the configured group addresses. It can be left empty when only Node-RED output is needed. The saved gateway remains selected while the editor initializes and changes only after an explicit user selection. |
 | Matter controller | Matter controller configuration node where the device has been commissioned. |
 | Matter device | Matter endpoint selected from commissioned devices. The UI is rebuilt from its real capabilities. |
 | Switch / Plug / Light On-Off | On/Off command and status group addresses, usually DPT `1.001`. |

package/nodes/locales/en/knxUltimateWatchDog.html

@@ -29,6 +29,7 @@ You can send an Email to the KNX installer responsible to your Building, or you
 | Group Address to monitor | The node will send a telegram to this address and monitors the message flowing through the KNX BUS. The Datapoint must be DPT 1.x (boolean).|
 | Node Name | Node Name |
 | Auto start the watchdog timer | The watchdog timer starts automatically on deploy or on node-red start. |
+| Listen to KNX-Ultimate node errors | Enabled by default. Outputs a `NodeError` when a KNX-Ultimate node associated with the selected gateway, including KNX Device, reports a red error status. Disabling it suppresses only those `NodeError` messages; the WatchDog's own bus checks and control messages remain active. |
 | Check level (please see the wiki) | See below |
 
 **Check level** > _**Ethernet**_: Checks the connection between knx-ultimate Gateway in unicast mode and your KNX IP Interface.<br />
@@ -56,7 +57,7 @@ Twisted Pair connection is up and running.
 
 # MESSAGE OUTPUT FROM THE WATCHDOG
 
-The WatchDog node outs a message whenever it receives an error from one of your knx-ultimate node in your flows, or whenever the internal Watchdog intercepts a KNX Bus communication error.<br />
+The WatchDog always outputs its own bus-check and control messages. When **Listen to KNX-Ultimate node errors** is enabled, it also outputs errors reported by KNX-Ultimate nodes, including KNX Device, associated with the selected gateway.<br />
 
 **In case of Watchdog self connection problem**
 
@@ -77,7 +78,7 @@ description: // (whatever error description)
 
 <br />
 
-**In case of one of your KNX-Ultimate nodes is in trouble**
+**When KNX-Ultimate node error listening is enabled and one of your nodes is in trouble**
 
 ```javascript
 

package/nodes/locales/en/knxUltimateWatchDog.json

@@ -9,6 +9,7 @@
             "node-input-topic": "Group Address to monitor",
             "node-input-name": "Node Name",
             "node-input-autoStart": "Auto start the watchdog timer",
+            "node-input-listenToKnxUltimateNodeErrors": "Listen to KNX-Ultimate node errors",
             "advancedOptionsAccordion": "Advanced Options",
             "node-input-retryInterval": "Retry interval (in seconds)",
             "node-input-maxRetry": "Number of retry before giving an error"

package/nodes/locales/es/knxUltimateMatterControllerDevice.html

@@ -11,7 +11,7 @@ Sustituye a los nodos Matter separados no publicados y conserva toda la UI de lu
 
 |Campo|Descripción|
 |--|--|
-| KNX GW | Gateway KNX usado para escribir y responder las direcciones de grupo configuradas. Puede quedar vacío si solo se necesita la salida Node-RED. |
+| KNX GW | Gateway KNX usado para escribir y responder las direcciones de grupo configuradas. Puede quedar vacío si solo se necesita la salida Node-RED. El gateway guardado permanece seleccionado durante la inicialización del editor y solo cambia tras una selección explícita del usuario. |
 | Matter controller | Nodo de configuración Matter Controller donde el dispositivo fue emparejado. |
 | Dispositivo Matter | Endpoint Matter seleccionado entre los dispositivos emparejados. La UI se reconstruye a partir de sus capacidades reales. |
 | Switch / Enchufe / Luz On-Off | Direcciones de grupo de comando y estado On/Off, normalmente DPT `1.001`. |

package/nodes/locales/es/knxUltimateWatchDog.html

@@ -29,6 +29,7 @@ Puede enviar un correo electrónico al instalador KNX responsable de su edificio
 |Dirección de grupo para monitorear |El nodo enviará un telegrama a esta dirección y monitorea el mensaje que fluye a través del bus KNX.El punto de datos debe ser dpt 1.x (boolean). |
 |Nombre de nodo |Nombre del nodo |
 |Auto Iniciar el temporizador de vigilancia |El temporizador Watchdog comienza automáticamente en implementación o en el inicio de Node-RED.|
+|Escuchar errores de los nodos KNX-Ultimate |Activado de forma predeterminada. Emite un mensaje `NodeError` cuando un nodo KNX-Ultimate asociado a la puerta de enlace seleccionada, incluido KNX Device, informa de un estado de error rojo. Al desactivarlo solo se suprimen esos mensajes `NodeError`; las comprobaciones del bus y los mensajes de control del WatchDog siguen activos.|
 |Verificar el nivel (consulte el wiki) |Ver a continuación |
 
 **COMPROBAR NIVEL ** > _**Ethernet** _: \*checkks la conexión entre la puerta de enlace de ultimate KNX en modo unicast y su interfaz IP KNX. <Br />
@@ -56,7 +57,7 @@ width = "90%"> <Br />
 
 # Salida de mensajes del Watchdog
 
-El nodo Watchdog sale un mensaje cada vez que recibe un error de uno de su nodo ultimal KNX en sus flujos, o cuando el vigilante interno intercepta un error de comunicación de bus KNX. <Br /> ** En caso de problema de autoexpresión de vigilancia** <a href = "https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/WatchDog-Configuration"
+El WatchDog siempre emite sus propios mensajes de comprobación del bus y de control. Cuando **Escuchar errores de los nodos KNX-Ultimate** está activado, también emite los errores informados por los nodos KNX-Ultimate, incluido KNX Device, asociados a la puerta de enlace seleccionada. <Br /> ** En caso de problema de autoexpresión de vigilancia** <a href = "https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/WatchDog-Configuration"
 Target = "_ en blanco"> Consulte aquí. </a>
 
 ```javascript
@@ -71,7 +72,7 @@ description: // (whatever error description)
 
 ```
 
-<Br /> ** En caso de que uno de sus nodos ultimados KNX esté en problemas**
+<Br /> **Cuando la escucha está activada y un nodo KNX-Ultimate informa de un error**
 
 ```javascript
 
@@ -216,4 +217,4 @@ return msg;
 ## Ver también
 
 [Muestra de vigilancia](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---WatchDog)
-</script>
+</script>

package/nodes/locales/es/knxUltimateWatchDog.json

@@ -8,6 +8,7 @@
       "node-input-topic": "Dirección de grupo para monitorear",
       "node-input-name": "Nombre de nodo",
       "node-input-autoStart": "Auto Iniciar el temporizador de vigilancia",
+      "node-input-listenToKnxUltimateNodeErrors": "Escuchar errores de los nodos KNX-Ultimate",
       "advancedOptionsAccordion": "Opciones avanzadas",
       "node-input-retryInterval": "Vuelva a intentar el intervalo (en segundos)",
       "node-input-maxRetry": "Número de reintento antes de dar un error"

package/nodes/locales/fr/knxUltimateMatterControllerDevice.html

@@ -11,7 +11,7 @@ Il remplace les nœuds Matter séparés non publiés et conserve toute l'UI lumi
 
 |Champ|Description|
 |--|--|
-| KNX GW | Passerelle KNX utilisée pour écrire et répondre sur les adresses de groupe configurées. Elle peut rester vide si seule la sortie Node-RED est utilisée. |
+| KNX GW | Passerelle KNX utilisée pour écrire et répondre sur les adresses de groupe configurées. Elle peut rester vide si seule la sortie Node-RED est utilisée. La passerelle enregistrée reste sélectionnée pendant l'initialisation de l'éditeur et ne change qu'après une sélection explicite de l'utilisateur. |
 | Matter controller | Nœud de configuration Matter Controller dans lequel le périphérique a été appairé. |
 | Appareil Matter | Endpoint Matter choisi parmi les appareils appairés. L'UI est reconstruite à partir de ses capacités réelles. |
 | Switch / Prise / Lumière On-Off | Adresses de groupe commande et état On/Off, généralement DPT `1.001`. |

package/nodes/locales/fr/knxUltimateWatchDog.html

@@ -29,6 +29,7 @@ Vous pouvez envoyer un e-mail au programme d'installation KNX responsable de vot
 |Adresse du groupe à surveiller |Le nœud enverra un télégramme à cette adresse et surveille le message qui traverse le bus KNX.Le point de données doit être dpt 1.x (booléen). |
 |Nom de nœud |Nom du nœud |
 |Démarrer automatiquement la minuterie de chien de garde |Le temporisateur de surveillance commence automatiquement sur le déploiement ou au démarrage de Node-RED.|
+|Écouter les erreurs des nœuds KNX-Ultimate |Activé par défaut. Émet un message `NodeError` lorsqu'un nœud KNX-Ultimate associé à la passerelle sélectionnée, y compris KNX Device, signale un état d'erreur rouge. La désactivation supprime uniquement ces messages `NodeError`; les contrôles du bus et les messages de commande du WatchDog restent actifs.|
 |Vérifier le niveau (veuillez consulter le wiki) |Voir ci-dessous |
 
 **Vérifier le niveau ** > _**Ethernet** _: \* Chechks la connexion entre la passerelle KNX-ultimate en mode unicast et votre interface IP KNX. <Br />
@@ -54,7 +55,7 @@ width = "90%"> <br />
 
 # Sortie du message du chien de garde
 
-Le nœud de surveillance ouvre un message chaque fois qu'il reçoit une erreur de l'un de votre nœud KNX-ultime dans vos flux, ou chaque fois que le chien de garde interne intercepte une erreur de communication de bus KNX. <Br /> ** En cas de problème de connexion auto à surveillance** <a href = "https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/WatchDog-Configuration"
+Le WatchDog émet toujours ses propres messages de contrôle du bus et de commande. Lorsque **Écouter les erreurs des nœuds KNX-Ultimate** est activé, il émet aussi les erreurs signalées par les nœuds KNX-Ultimate, y compris KNX Device, associés à la passerelle sélectionnée. <Br /> ** En cas de problème de connexion auto à surveillance** <a href = "https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/WatchDog-Configuration"
 Target = "_ Blank"> Veuillez voir ici. </a>
 
 ```javascript
@@ -69,7 +70,7 @@ description: // (whatever error description)
 
 ```
 
-<br /> ** Dans le cas de l'un de vos nœuds ultimes KNX est en difficulté**
+<br /> **Lorsque l'écoute est activée et qu'un nœud KNX-Ultimate signale une erreur**
 
 ```javascript
 
@@ -214,4 +215,4 @@ return msg;
 ## Voir aussi
 
 [Exemple de chien de garde](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---WatchDog)
-</script>
+</script>

package/nodes/locales/fr/knxUltimateWatchDog.json

@@ -8,6 +8,7 @@
       "node-input-topic": "Adresse du groupe à surveiller",
       "node-input-name": "Nom de nœud",
       "node-input-autoStart": "Démarrer automatiquement la minuterie de chien de garde",
+      "node-input-listenToKnxUltimateNodeErrors": "Écouter les erreurs des nœuds KNX-Ultimate",
       "advancedOptionsAccordion": "Options avancées",
       "node-input-retryInterval": "Réessier l'intervalle (en quelques secondes)",
       "node-input-maxRetry": "Nombre de réessayer avant de donner une erreur"

package/nodes/locales/it/knxUltimateMatterControllerDevice.html

@@ -11,7 +11,7 @@ Sostituisce i nodi Matter separati non pubblicati e mantiene tutta la UI luce qu
 
 |Campo|Descrizione|
 |--|--|
-| KNX GW | Gateway KNX usato per scrivere e rispondere sugli indirizzi di gruppo configurati. Può restare vuoto se serve solo l'output Node-RED. |
+| KNX GW | Gateway KNX usato per scrivere e rispondere sugli indirizzi di gruppo configurati. Può restare vuoto se serve solo l'output Node-RED. Il gateway salvato rimane selezionato durante l'inizializzazione dell'editor e cambia soltanto dopo una selezione esplicita dell'utente. |
 | Matter controller | Nodo di configurazione Matter Controller in cui il dispositivo è stato associato. |
 | Dispositivo Matter | Endpoint Matter selezionato tra i dispositivi abbinati. La UI viene ricostruita in base alle capability reali. |
 | Switch / Presa / Luce On-Off | Indirizzi di gruppo di comando e stato On/Off, di solito DPT `1.001`. |

package/nodes/locales/it/knxUltimateWatchDog.html

@@ -26,6 +26,7 @@ Il WatchDog è molto utile per notificare errori e problemi di connessione: puoi
 | Group Address da monitorare | GA a cui inviare il telegramma e da cui attendere risposta sul BUS KNX. Il Datapoint deve essere DPT 1.x (boolean). |
 | Nome nodo | Nome del nodo. |
 | Avvia il watchdog automaticamente | Avvio automatico del timer al deploy o all'avvio di Node-RED. |
+| Ascolta gli errori dei nodi KNX-Ultimate | Attiva per impostazione predefinita. Emette un `NodeError` quando un nodo KNX-Ultimate associato al gateway selezionato, incluso KNX Device, segnala uno stato di errore rosso. Disattivandola vengono soppressi solo questi messaggi `NodeError`; i controlli BUS e i messaggi di comando del WatchDog restano attivi. |
 | Livello controllo (vedi Wiki) | Vedi sotto. |
 
 **Check level**
@@ -47,7 +48,7 @@ Il WatchDog è molto utile per notificare errori e problemi di connessione: puoi
 
 # Messaggi in uscita dal WatchDog
 
-Il nodo emette un messaggio quando riceve un errore da un qualsiasi nodo KNX-Ultimate nel flow, oppure quando il watchdog interno intercetta un errore di comunicazione sul BUS KNX.
+Il WatchDog emette sempre i propri messaggi di controllo del BUS e di comando. Quando **Ascolta gli errori dei nodi KNX-Ultimate** è attiva, emette anche gli errori segnalati dai nodi KNX-Ultimate, incluso KNX Device, associati al gateway selezionato.
 
 **In caso di problema di connessione rilevato dal WatchDog**
 
@@ -64,7 +65,7 @@ msg = {
 }
 ```
 
-**In caso di errore di un tuo nodo KNX-Ultimate**
+**Quando l'ascolto è attivo e uno dei nodi KNX-Ultimate segnala un errore**
 
 ```javascript
 
@@ -180,4 +181,4 @@ return msg;
 ## Vedi anche
 
 [Sample WatchDog](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---WatchDog)
-</script>
+</script>

package/nodes/locales/it/knxUltimateWatchDog.json

@@ -9,6 +9,7 @@
             "node-input-topic": "Group Address da monitorare",
             "node-input-name": "Nome nodo",
             "node-input-autoStart": "Avvia il watchdog automaticamente",
+            "node-input-listenToKnxUltimateNodeErrors": "Ascolta gli errori dei nodi KNX-Ultimate",
             "advancedOptionsAccordion": "Opzioni avanzate",
             "node-input-retryInterval": "Riprova ogni (in secondi)",
             "node-input-maxRetry": "Dopo questo numero di tentativi, segnala l'errore"

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

@@ -11,7 +11,7 @@
 
 |字段|说明|
 |--|--|
-| KNX GW | 用于写入并响应已配置组地址的 KNX 网关。如果只需要 Node-RED 输出，可以留空。 |
+| KNX GW | 用于写入并响应已配置组地址的 KNX 网关。如果只需要 Node-RED 输出，可以留空。编辑器初始化期间会保留已保存的网关，只有用户明确选择后才会更改。 |
 | Matter controller | 设备已在其中配网的 Matter Controller 配置节点。 |
 | Matter device | 从已配对设备中选择的 Matter endpoint。UI 会根据真实能力重新构建。 |
 | Switch / 插座 / 灯 On-Off | On/Off 命令和状态组地址，通常使用 DPT `1.001`。 |

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

@@ -26,6 +26,7 @@ WatchDog 提供两级检测：
 | 需要监控的组地址 | 用于发送与监测的组地址；DPT 必须为 1.x（布尔）。|
 | 节点名称 | 节点名称。|
 | 自动启动看门狗定时器 | 在部署/启动时自动启动定时器。|
+| 监听 KNX-Ultimate 节点错误 | 默认启用。当与所选网关关联的 KNX-Ultimate 节点（包括 KNX Device）报告红色错误状态时，输出 `NodeError` 消息。禁用后只抑制这些 `NodeError` 消息；WatchDog 自身的总线检测和控制消息仍保持启用。|
 | 检查等级 (请查阅wiki) | 见上。|
 
 **Check level**
@@ -47,7 +48,7 @@ WatchDog 提供两级检测：
 
 # WatchDog 的输出
 
-当内部检测发现故障，或某个 KNX-Ultimate 节点在流程中上报错误时，WatchDog 会输出消息。
+WatchDog 始终输出自身的总线检测和控制消息。启用 **监听 KNX-Ultimate 节点错误** 后，它还会输出与所选网关关联的 KNX-Ultimate 节点（包括 KNX Device）所报告的错误。
 
 **WatchDog 自身连接问题**
 
@@ -64,7 +65,7 @@ msg = {
 }
 ```
 
-**你的某个 KNX-Ultimate 节点出现异常**
+**启用错误监听且某个 KNX-Ultimate 节点报告错误时**
 
 ```javascript
 
@@ -164,4 +165,4 @@ msg.connectGateway = true; return msg;
 ## 参见
 
 [Sample WatchDog](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---WatchDog)
-</script>
+</script>

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

@@ -9,6 +9,7 @@
             "node-input-topic": "需要监控的组地址",
             "node-input-name": "节点名称",
             "node-input-autoStart": "自动启动看门狗定时器",
+            "node-input-listenToKnxUltimateNodeErrors": "监听 KNX-Ultimate 节点错误",
             "advancedOptionsAccordion": "高级选项",
             "node-input-retryInterval": "重试间隔 (秒)",
             "node-input-maxRetry": "出错前的重试次数"

package/nodes/utils/watchDogErrorDispatcher.js

@@ -0,0 +1,19 @@
+module.exports = function dispatchWatchDogNodeError (configNode, nodeError) {
+  const clients = Array.isArray(configNode && configNode.nodeClients) ? configNode.nodeClients : []
+
+  clients
+    .filter(client => client && client.isWatchDog === true && client.listenToKnxUltimateNodeErrors !== false && client.listenToKnxUltimateNodeErrors !== 'false')
+    .forEach(client => {
+      try {
+        if (typeof client.signalNodeErrorCalledByConfigNode === 'function') {
+          client.signalNodeErrorCalledByConfigNode(nodeError)
+        }
+      } catch (error) {
+        try {
+          configNode.sysLogger?.error(`Unable to report KNX-Ultimate node error to Watchdog ${client.id}: ${error.message || error}`)
+        } catch {
+          // Error reporting must not prevent delivery to the remaining Watchdogs.
+        }
+      }
+    })
+}

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.3.9",
+  "version": "6.3.11",
   "description": "KNX Ultimate is the most advanced KNX integration for Node-RED, providing secure KNX/IP communication, routing, ETS project import, Philips Hue, Matter Controller and Matter Bridge (control matter device via KNX and expose KNX GA via Matter), MQTT, diagnostics with AI, virtual devices, and powerful automation nodes. Build professional, reliable, and scalable smart home and building automation projects with minimal effort.",
   "files": [
     "nodes/",

package/resources/configNodeEditorSelection.js

@@ -0,0 +1,32 @@
+(function (root, factory) {
+  const api = factory()
+  if (typeof module === 'object' && module.exports) module.exports = api
+  if (root) root.KNXUltimateConfigNodeEditorSelection = api
+}(typeof window !== 'undefined' ? window : globalThis, function () {
+  const DEFAULT_EMPTY_VALUES = new Set(['', 'none', '_add_', '__none__'])
+
+  function normalizeSelection (value, emptyValues = DEFAULT_EMPTY_VALUES) {
+    const normalized = value === undefined || value === null ? '' : String(value).trim()
+    const normalizedEmptyValues = emptyValues instanceof Set
+      ? emptyValues
+      : new Set(Array.isArray(emptyValues) ? emptyValues : DEFAULT_EMPTY_VALUES)
+    return normalizedEmptyValues.has(normalized.toLowerCase()) ? '' : normalized
+  }
+
+  function shouldPreserveSelection (event, nextValue, currentValue, emptyValues = DEFAULT_EMPTY_VALUES) {
+    const programmaticChange = !event || !event.originalEvent
+    return programmaticChange &&
+      normalizeSelection(nextValue, emptyValues) === '' &&
+      normalizeSelection(currentValue, emptyValues) !== ''
+  }
+
+  function resolveSelectedOrStoredSelection (selectedValue, storedValue, emptyValues = DEFAULT_EMPTY_VALUES) {
+    return normalizeSelection(selectedValue, emptyValues) || normalizeSelection(storedValue, emptyValues)
+  }
+
+  return {
+    normalizeSelection,
+    resolveSelectedOrStoredSelection,
+    shouldPreserveSelection
+  }
+}))