node-red-contrib-knx-ultimate 4.0.8 → 4.0.9

package/CHANGELOG.md

@@ -6,7 +6,7 @@
 
 # CHANGELOG
 
-**Version 4.0.8** - September 2025<br/>
+**Version 4.0.9** - September 2025<br/>
 - KNX Config node: now the ethernet interface is automatically selected, based on the KNX Gateway's IP subnet.<br/>
 - Added the details of keyring in clear text, when the loglevel is set to "debug".<br/>
 

package/nodes/knxUltimate-config.js

@@ -393,17 +393,87 @@ module.exports = (RED) => {
                       sequenceNumber: typeof device.sequenceNumber === "number" ? device.sequenceNumber : "",
                       serialNumber: device.serialNumber || "",
                     }));
-                    const keyringDump = {
-                      rawXML: node.keyringFileXML,
-                      password: node.credentials?.keyringFilePassword || "",
-                      createdBy: kr.getCreatedBy?.() || "",
-                      created: kr.getCreated?.() || "",
-                      interfaces,
-                      backbones,
-                      groupAddresses,
-                      devices,
-                    };
-                    node.sysLogger?.debug("KNX Secure keyring debug dump:", JSON.stringify(keyringDump, null, 2));
+                    const lines = [];
+                    lines.push("================ KNX Secure keyring debug dump ================");
+                    lines.push(`Node: ${node.name || node.id || ""}`);
+                    lines.push(`Created By: ${kr.getCreatedBy?.() || ""}`);
+                    lines.push(`Created On: ${kr.getCreated?.() || ""}`);
+                    lines.push(`Password (node credentials): ${node.credentials?.keyringFilePassword || ""}`);
+                    lines.push("");
+
+                    lines.push("Interfaces:");
+                    if (interfaces.length === 0) {
+                      lines.push("  (none)");
+                    } else {
+                      interfaces.forEach((iface, idx) => {
+                        lines.push(`  [${idx + 1}] ${iface.individualAddress || "(unknown)"} (${iface.type || ""})`);
+                        lines.push(`       Host: ${iface.host || ""}`);
+                        lines.push(`       User ID: ${iface.userId === "" ? "" : iface.userId}`);
+                        lines.push(`       Password (encoded): ${iface.password || ""}`);
+                        lines.push(`       Password (decoded): ${iface.decryptedPassword || ""}`);
+                        lines.push(`       Authentication (encoded): ${iface.authentication || ""}`);
+                        lines.push(`       Authentication (decoded): ${iface.decryptedAuthentication || ""}`);
+                        if (!iface.groupAddresses || iface.groupAddresses.length === 0) {
+                          lines.push("       Group Addresses: (none)");
+                        } else {
+                          lines.push("       Group Addresses:");
+                          iface.groupAddresses.forEach((ga) => {
+                            const senders = ga.senders && ga.senders.length > 0 ? ga.senders.join(", ") : "(none)";
+                            lines.push(`         - ${ga.address}: senders ${senders}`);
+                          });
+                        }
+                        lines.push("");
+                      });
+                    }
+
+                    lines.push("Backbones:");
+                    if (backbones.length === 0) {
+                      lines.push("  (none)");
+                    } else {
+                      backbones.forEach((backbone, idx) => {
+                        lines.push(`  [${idx + 1}] Multicast: ${backbone.multicastAddress || ""}`);
+                        lines.push(`       Latency: ${backbone.latency === "" ? "" : backbone.latency}`);
+                        lines.push(`       Key (encoded): ${backbone.key || ""}`);
+                        lines.push(`       Key (decoded hex): ${backbone.decryptedKey || ""}`);
+                        lines.push("");
+                      });
+                    }
+
+                    lines.push("Group Addresses:");
+                    if (groupAddresses.length === 0) {
+                      lines.push("  (none)");
+                    } else {
+                      groupAddresses.forEach((group, idx) => {
+                        lines.push(`  [${idx + 1}] ${group.address || ""}`);
+                        lines.push(`       Key (encoded): ${group.key || ""}`);
+                        lines.push(`       Key (decoded hex): ${group.decryptedKey || ""}`);
+                        lines.push("");
+                      });
+                    }
+
+                    lines.push("Devices:");
+                    if (devices.length === 0) {
+                      lines.push("  (none)");
+                    } else {
+                      devices.forEach((device, idx) => {
+                        lines.push(`  [${idx + 1}] ${device.individualAddress || ""}`);
+                        lines.push(`       Tool Key (encoded): ${device.toolKey || ""}`);
+                        lines.push(`       Tool Key (decoded hex): ${device.decryptedToolKey || ""}`);
+                        lines.push(`       Management Password (encoded): ${device.managementPassword || ""}`);
+                        lines.push(`       Management Password (decoded): ${device.decryptedManagementPassword || ""}`);
+                        lines.push(`       Authentication (encoded): ${device.authentication || ""}`);
+                        lines.push(`       Authentication (decoded): ${device.decryptedAuthentication || ""}`);
+                        lines.push(`       Sequence Number: ${device.sequenceNumber === "" ? "" : device.sequenceNumber}`);
+                        lines.push(`       Serial Number: ${device.serialNumber || ""}`);
+                        lines.push("");
+                      });
+                    }
+
+                    lines.push("Raw keyring (XML/base64 as provided):");
+                    lines.push(node.keyringFileXML || "(empty)");
+                    lines.push("================ End of keyring debug dump ================");
+
+                    node.sysLogger?.debug(lines.join("\n"));
                   } catch (dumpError) {
                     node.sysLogger?.error("KNX Secure: unable to log keyring details: " + dumpError.message);
                   }

package/nodes/knxUltimate.js

@@ -121,7 +121,8 @@ module.exports = function (RED) {
     node.inputmessage = {}; // Stores the input message to be passed through
     node.timerTTLInputMessage = null; // The stored node.inputmessage has a ttl.
     try {
-      node.sysLogger = new loggerClass({ loglevel: node.serverKNX.loglevel || 'error', setPrefix: node.type + " <" + (node.name || node.id || '') + ">" });
+      const baseLogLevel = (node.serverKNX && node.serverKNX.loglevel) ? node.serverKNX.loglevel : 'error';
+      node.sysLogger = new loggerClass({ loglevel: baseLogLevel, setPrefix: node.type + " <" + (node.name || node.id || '') + ">" });
     } catch (error) { console.log(error.stack) }
     node.sendMsgToKNXCode = config.sendMsgToKNXCode || undefined;
     node.receiveMsgFromKNXCode = config.receiveMsgFromKNXCode || undefined;

package/nodes/knxUltimateAutoResponder.js

@@ -54,7 +54,8 @@ module.exports = function (RED) {
     if (node.serverKNX === null) { node.status({ fill: 'red', shape: 'dot', text: '[NO GATEWAY SELECTED]' }); return; }
 
     try {
-      node.sysLogger = new loggerClass({ loglevel: node.serverKNX.loglevel, setPrefix: node.type + " <" + (node.name || node.id || '') + ">" });
+      const baseLogLevel = (node.serverKNX && node.serverKNX.loglevel) ? node.serverKNX.loglevel : 'error';
+      node.sysLogger = new loggerClass({ loglevel: baseLogLevel, setPrefix: node.type + " <" + (node.name || node.id || '') + ">" });
     } catch (error) { console.log(error.stack) }
     // Used to call the status update from the config node.
     node.setNodeStatus = ({ fill, shape, text, payload, GA, dpt, devicename }) => {

package/nodes/knxUltimateHueScene.js

@@ -29,7 +29,8 @@ module.exports = function (RED) {
     node.hueDevice = config.hueDevice;
     node.initializingAtStart = false;
     try {
-      node.sysLogger = new loggerClass({ loglevel: node.serverKNX.loglevel, setPrefix: node.type + " <" + (node.name || node.id || '') + ">" });
+      const baseLogLevel = (node.serverKNX && node.serverKNX.loglevel) ? node.serverKNX.loglevel : 'error';
+      node.sysLogger = new loggerClass({ loglevel: baseLogLevel, setPrefix: node.type + " <" + (node.name || node.id || '') + ">" });
     } catch (error) { console.log(error.stack) }
     // Multi scene
     config.GAsceneMulti = config.GAsceneMulti === undefined ? '' : config.GAsceneMulti;

package/nodes/knxUltimateLoadControl.js

@@ -38,7 +38,8 @@ module.exports = function (RED) {
     node.totalWatt = 0 // Current total watt consumption
     node.wattLimit = config.wattLimit === undefined ? 3000 : Number(config.wattLimit)
     try {
-      node.sysLogger = new loggerClass({ loglevel: node.serverKNX.loglevel, setPrefix: node.type + " <" + (node.name || node.id || '') + ">" });
+      const baseLogLevel = (node.serverKNX && node.serverKNX.loglevel) ? node.serverKNX.loglevel : 'error';
+      node.sysLogger = new loggerClass({ loglevel: baseLogLevel, setPrefix: node.type + " <" + (node.name || node.id || '') + ">" });
     } catch (error) { console.log(error.stack) }
     node.deviceList = []
     for (let index = 1; index < 6; index++) {

package/nodes/knxUltimateSceneController.js

@@ -29,7 +29,8 @@ module.exports = function (RED) {
     node.isSceneController = true // Signal to config node, that this is a node scene controller
     node.userDir = path.join(RED.settings.userDir, 'knxultimatestorage') // 09/03/2020 Storage of ttsultimate (otherwise, at each upgrade to a newer version, the node path is wiped out and recreated, loosing all custom files)
     try {
-      node.sysLogger = new loggerClass({ loglevel: node.serverKNX.loglevel, setPrefix: node.type + " <" + (node.name || node.id || '') + ">" });
+      const baseLogLevel = (node.serverKNX && node.serverKNX.loglevel) ? node.serverKNX.loglevel : 'error';
+      node.sysLogger = new loggerClass({ loglevel: baseLogLevel, setPrefix: node.type + " <" + (node.name || node.id || '') + ">" });
     } catch (error) { console.log(error.stack) }
     node.timerWait = null
     node.icountMessageInWindow = 0

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "4.0.8",
+  "version": "4.0.9",
   "description": "Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer. Easy to use and highly configurable.",
   "dependencies": {
     "binary-parser": "2.2.1",