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

package/CHANGELOG.md

@@ -6,6 +6,10 @@
 
 # CHANGELOG
 
+**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/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/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/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/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/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/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/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.10",
   "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/",