node-red-contrib-knx-ultimate 6.3.24 → 6.3.25

package/CHANGELOG.md

@@ -6,6 +6,11 @@
 
 # CHANGELOG
 
+**Version 6.3.25** - August 2026<br/>
+
+- **IoT Bridge — direct Modbus Flex adapter without a bundled Modbus client**: Modbus mappings can now emit the exact `modbus-flex-write` request consumed by `node-red-contrib-modbus` and decode `modbus-read` / `modbus-flex-getter` responses back to KNX. The protocol-specific editor asks only for Unit ID, zero-based address, Modbus area and Boolean/unsigned 16-bit/signed 16-bit format; FC1–FC6 and quantity are derived automatically. TCP/RTU connections, polling, queues and reconnects remain in the external Modbus nodes. KNX responses never become Modbus commands, write acknowledgements never become KNX state, unchanged polls can be suppressed with **Emit on change only**, and local KNX echoes are loop-protected. Existing scalar Modbus mappings remain on the legacy contract until explicitly switched to Flex. A safe manual example and the six localized help/wiki sets document the wiring and host-version compatibility.<br/>
+- **Dependency cleanup — native asynchronous gateway DNS resolution**: replaced `dns-sync` and its obsolete `shelljs` → `glob@7` → `inflight` production chain with Node's built-in promise-based OS resolver. KNX gateway hostnames and `/etc/hosts` resolution remain supported in verbatim address order, while connection startup no longer launches a blocking child process.<br/>
+
 **Version 6.3.24** - August 2026<br/>
 
 - **KNX AI — working Telegram confirmation buttons**: changed the `windkh/node-red-contrib-telegrambot` preset from inline callbacks to a one-time Telegram reply keyboard. **Confirm** and **Cancel** now return as normal localized messages through the already connected `telegram receiver`, eliminating the silent no-op caused by a missing `callback_query` event node. Existing saved preset output mappings are upgraded at runtime, the keyboard is removed after the decision, and legacy callback events remain accepted. The importable direct-chat example no longer requires extra callback wiring; help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.<br/>

package/examples/IoT Bridge - Modbus Flex Adapter.json

@@ -0,0 +1,361 @@
+[
+  {
+    "id": "mb_flex_tab",
+    "type": "tab",
+    "label": "IoT Bridge - Modbus Flex Adapter",
+    "disabled": true,
+    "info": "Safe starter flow for the IoT Bridge and node-red-contrib-modbus. The tab is disabled on import and every Inject node is manual. Configure the KNX gateway, group addresses and Modbus client before enabling it."
+  },
+  {
+    "id": "mb_knx_cfg",
+    "type": "knxUltimate-config",
+    "z": "",
+    "host": "224.0.23.12",
+    "port": "3671",
+    "physAddr": "15.15.215",
+    "suppressACKRequest": false,
+    "csv": "",
+    "KNXEthInterface": "Auto",
+    "KNXEthInterfaceManuallyInput": "",
+    "autoReconnect": "no"
+  },
+  {
+    "id": "mb_client",
+    "type": "modbus-client",
+    "name": "LOCALHOST placeholder - configure me",
+    "clienttype": "tcp",
+    "bufferCommands": true,
+    "stateLogEnabled": false,
+    "queueLogEnabled": false,
+    "failureLogEnabled": true,
+    "tcpHost": "127.0.0.1",
+    "tcpPort": "1502",
+    "tcpType": "DEFAULT",
+    "serialPort": "/dev/ttyUSB",
+    "serialType": "RTU-BUFFERD",
+    "serialBaudrate": "9600",
+    "serialDatabits": "8",
+    "serialStopbits": "1",
+    "serialParity": "none",
+    "serialConnectionDelay": "100",
+    "serialAsciiResponseStartDelimiter": "0x3A",
+    "unit_id": "1",
+    "commandDelay": "1",
+    "clientTimeout": "1000",
+    "reconnectOnTimeout": false,
+    "reconnectTimeout": "2000",
+    "parallelUnitIdsAllowed": true,
+    "showWarnings": true,
+    "showLogs": false
+  },
+  {
+    "id": "mb_intro",
+    "type": "comment",
+    "z": "mb_flex_tab",
+    "name": "START HERE - disabled and manual-only",
+    "info": "1. Install a node-red-contrib-modbus version compatible with your Node-RED runtime.\n2. Configure the KNX gateway and replace the LOCALHOST Modbus client placeholder.\n3. Adapt every GA, Unit ID and zero-based address.\n4. Enable this tab only after reviewing the mappings.\n\nThere is no automatic Inject or polling in this example.",
+    "x": 300,
+    "y": 40,
+    "wires": []
+  },
+  {
+    "id": "mb_address_note",
+    "type": "comment",
+    "z": "mb_flex_tab",
+    "name": "Target is zero-based: manual reference 40010 is commonly address 9",
+    "info": "Always verify the addressing convention in the device manual. The bridge supports one bit or one 16-bit register per mapping.",
+    "x": 390,
+    "y": 80,
+    "wires": []
+  },
+  {
+    "id": "mb_bridge",
+    "type": "knxUltimateIoTBridge",
+    "z": "mb_flex_tab",
+    "server": "mb_knx_cfg",
+    "name": "KNX ↔ Modbus Flex adapter",
+    "outputtopic": "",
+    "emitOnChangeOnly": true,
+    "readOnDeploy": false,
+    "acceptFlowInput": true,
+    "nodeMode": "iot",
+    "haBusMode": "standalone",
+    "inputs": 1,
+    "outputs": 2,
+    "mappings": [
+      {
+        "id": "mb_map_coil",
+        "enabled": true,
+        "label": "Light command coil",
+        "ga": "3/1/1",
+        "dpt": "1.001",
+        "direction": "bidirectional",
+        "iotType": "modbus",
+        "target": "0",
+        "method": "POST",
+        "modbusFunction": "writeCoil",
+        "modbusMessageFormat": "flex",
+        "modbusUnitId": 1,
+        "modbusAddress": 0,
+        "modbusArea": "coil",
+        "modbusDataType": "bool",
+        "scale": 1,
+        "offset": 0,
+        "template": "",
+        "property": "",
+        "timeout": 0,
+        "retry": 0
+      },
+      {
+        "id": "mb_map_temperature",
+        "enabled": true,
+        "label": "Temperature x10 holding register",
+        "ga": "3/1/2",
+        "dpt": "9.001",
+        "direction": "bidirectional",
+        "iotType": "modbus",
+        "target": "9",
+        "method": "POST",
+        "modbusFunction": "writeHoldingRegister",
+        "modbusMessageFormat": "flex",
+        "modbusUnitId": 1,
+        "modbusAddress": 9,
+        "modbusArea": "holding-register",
+        "modbusDataType": "uint16",
+        "scale": 10,
+        "offset": 0,
+        "template": "",
+        "property": "",
+        "timeout": 0,
+        "retry": 0
+      },
+      {
+        "id": "mb_map_contact",
+        "enabled": true,
+        "label": "Read-only contact",
+        "ga": "3/1/3",
+        "dpt": "1.001",
+        "direction": "iot-to-knx",
+        "iotType": "modbus",
+        "target": "4",
+        "method": "POST",
+        "modbusFunction": "readDiscreteInputs",
+        "modbusMessageFormat": "flex",
+        "modbusUnitId": 1,
+        "modbusAddress": 4,
+        "modbusArea": "discrete-input",
+        "modbusDataType": "bool",
+        "scale": 1,
+        "offset": 0,
+        "template": "",
+        "property": "",
+        "timeout": 0,
+        "retry": 0
+      }
+    ],
+    "x": 650,
+    "y": 260,
+    "wires": [
+      [
+        "mb_flex_write",
+        "mb_debug_flex_payload"
+      ],
+      [
+        "mb_debug_knx_ack"
+      ]
+    ]
+  },
+  {
+    "id": "mb_manual_read",
+    "type": "inject",
+    "z": "mb_flex_tab",
+    "name": "MANUAL read holding register 9",
+    "props": [
+      {
+        "p": "payload",
+        "v": "{\"fc\":3,\"unitid\":1,\"address\":9,\"quantity\":1}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 230,
+    "y": 180,
+    "wires": [
+      [
+        "mb_flex_getter"
+      ]
+    ]
+  },
+  {
+    "id": "mb_flex_getter",
+    "type": "modbus-flex-getter",
+    "z": "mb_flex_tab",
+    "name": "Flex Getter (manual request)",
+    "showStatusActivities": false,
+    "showErrors": true,
+    "showWarnings": true,
+    "logIOActivities": false,
+    "server": "mb_client",
+    "useIOFile": false,
+    "ioFile": "",
+    "useIOForPayload": false,
+    "emptyMsgOnFail": false,
+    "keepMsgProperties": true,
+    "delayOnStart": false,
+    "enableDeformedMessages": false,
+    "startDelayTime": "",
+    "x": 490,
+    "y": 180,
+    "wires": [
+      [
+        "mb_bridge",
+        "mb_debug_read"
+      ],
+      [
+        "mb_debug_modbus_error"
+      ]
+    ]
+  },
+  {
+    "id": "mb_simulated_read",
+    "type": "inject",
+    "z": "mb_flex_tab",
+    "name": "MANUAL simulate raw 215 → KNX 21.5 °C",
+    "props": [
+      {
+        "p": "payload",
+        "v": "[215]",
+        "vt": "json"
+      },
+      {
+        "p": "modbusRequest",
+        "v": "{\"fc\":3,\"unitid\":1,\"address\":9,\"quantity\":1}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 270,
+    "y": 300,
+    "wires": [
+      [
+        "mb_bridge"
+      ]
+    ]
+  },
+  {
+    "id": "mb_flex_write",
+    "type": "modbus-flex-write",
+    "z": "mb_flex_tab",
+    "name": "Direct Flex Write",
+    "showStatusActivities": false,
+    "showErrors": true,
+    "showWarnings": true,
+    "logIOActivities": false,
+    "server": "mb_client",
+    "emptyMsgOnFail": false,
+    "keepMsgProperties": true,
+    "delayOnStart": false,
+    "startDelayTime": "",
+    "x": 930,
+    "y": 220,
+    "wires": [
+      [
+        "mb_debug_write"
+      ],
+      [
+        "mb_debug_modbus_error"
+      ]
+    ]
+  },
+  {
+    "id": "mb_debug_flex_payload",
+    "type": "debug",
+    "z": "mb_flex_tab",
+    "name": "Flex payload from bridge",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 960,
+    "y": 280,
+    "wires": []
+  },
+  {
+    "id": "mb_debug_knx_ack",
+    "type": "debug",
+    "z": "mb_flex_tab",
+    "name": "Modbus → KNX ack",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 950,
+    "y": 340,
+    "wires": []
+  },
+  {
+    "id": "mb_debug_read",
+    "type": "debug",
+    "z": "mb_flex_tab",
+    "name": "Raw Modbus read response",
+    "active": false,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 780,
+    "y": 140,
+    "wires": []
+  },
+  {
+    "id": "mb_debug_write",
+    "type": "debug",
+    "z": "mb_flex_tab",
+    "name": "Modbus write response",
+    "active": false,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 1190,
+    "y": 200,
+    "wires": []
+  },
+  {
+    "id": "mb_debug_modbus_error",
+    "type": "debug",
+    "z": "mb_flex_tab",
+    "name": "Modbus response / error",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 1190,
+    "y": 260,
+    "wires": []
+  }
+]

package/nodes/knxUltimate-config.js

@@ -6,6 +6,7 @@
 const fs = require('fs')
 const path = require('path')
 const net = require('net')
+const dns = require('dns/promises')
 const os = require('os')
 const _ = require('lodash')
 const knx = require('knxultimate')
@@ -195,6 +196,11 @@ const findAutoEthernetInterface = (targetIP) => {
   return bestMatch
 }
 
+const resolveHostAddress = async (hostname, lookup = dns.lookup) => {
+  const { address } = await lookup(hostname, { order: 'verbatim' })
+  return address
+}
+
 module.exports = (RED) => {
   // Log node and KNXUltimate engine versions once, at Node-RED startup.
   try {
@@ -1142,7 +1148,7 @@ module.exports = (RED) => {
       }
     }
 
-    node.setKnxConnectionProperties = () => {
+    node.setKnxConnectionProperties = async () => {
       // 25/08/2021 Moved out of node.initKNXConnection
       node.knxConnectionProperties = {
         ipAddr: node.host,
@@ -1183,10 +1189,9 @@ module.exports = (RED) => {
         switch (net.isIP(node.host)) {
           case 0:
             // Invalid IP, resolve the DNS name.
-            const dns = require('dns-sync')
             let resolvedIP = null
             try {
-              resolvedIP = dns.resolve(node.host)
+              resolvedIP = await resolveHostAddress(node.host)
             } catch (error) {
               throw new Error('net.isIP: INVALID IP OR DNS NAME. Error checking the Gateway Host in Config node. ' + error.message)
             }
@@ -1258,7 +1263,7 @@ module.exports = (RED) => {
 
     node.initKNXConnection = async () => {
       try {
-        node.setKnxConnectionProperties() // 28/12/2021 Added
+        await node.setKnxConnectionProperties() // 28/12/2021 Added
       } catch (error) {
         node.sysLogger?.error('setKnxConnectionProperties: ' + error.message)
         if (node.linkStatus !== 'disconnected') await node.Disconnect()
@@ -2764,3 +2769,7 @@ module.exports = (RED) => {
     }
   })
 }
+
+module.exports.__test = {
+  resolveHostAddress
+}