node-red-contrib-knx-ultimate 4.3.16 → 4.3.17

package/CHANGELOG.md

@@ -6,6 +6,11 @@
 
 # CHANGELOG
 
+**Version 4.3.17** - May 2026<br/>
+
+- Examples: expanded the `examples/` folder to provide dedicated Node-RED flow files for all remaining KNX Ultimate nodes, including `KNX Staircase`, `KNX Garage`, `KNX Load Control`, `KNX IoT Bridge`, `KNX Auto Responder`, `KNX Alerter`, `KNX Global Context`, `KNX HA Translator`, and the full Philips Hue node set.<br/>
+- Examples: adopted a consistent one-file-per-node approach so users can import focused flows and quickly understand each node configuration and behavior.<br/>
+
 **Version 4.3.16** - May 2026<br/>
 
 - Docs/help/wiki: updated **KNX DateTime** help HTML and DateTime wiki pages (**EN/IT**) to document current `DPT 19.001` behavior based on JavaScript `Date`, additional input object fields (`msg.payload.dateTime` / `timestamp` / `epoch`), queued send while gateway is disconnected (latest pending only), and output metadata `msg.knxUltimateDateTime.date`.<br/>

package/examples/Alerter - Device Alert Aggregation.json

@@ -0,0 +1,196 @@
+[
+  {
+    "id": "al_tab",
+    "type": "tab",
+    "label": "KNX Alerter",
+    "disabled": false,
+    "info": ""
+  },
+  {
+    "id": "al_cfg",
+    "type": "knxUltimate-config",
+    "z": "",
+    "host": "224.0.23.12",
+    "port": "3671",
+    "physAddr": "15.15.211",
+    "suppressACKRequest": false,
+    "csv": "",
+    "KNXEthInterface": "Auto",
+    "KNXEthInterfaceManuallyInput": "",
+    "autoReconnect": "no"
+  },
+  {
+    "id": "al_c",
+    "type": "comment",
+    "z": "al_tab",
+    "name": "Aggregate alarm devices and emit 3 outputs",
+    "info": "",
+    "x": 370,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "al_node",
+    "type": "knxUltimateAlerter",
+    "z": "al_tab",
+    "server": "al_cfg",
+    "name": "KNX Alerter",
+    "property": "payload",
+    "propertyType": "msg",
+    "rules": [
+      {
+        "topic": "2/1/1",
+        "devicename": "Smoke Kitchen",
+        "longdevicename": "Smoke detector kitchen"
+      },
+      {
+        "topic": "2/1/2",
+        "devicename": "Water Laundry",
+        "longdevicename": "Water leak laundry room"
+      }
+    ],
+    "whentostart": "ifnewalert",
+    "timerinterval": "2",
+    "initialreadGAInRules": "1",
+    "x": 640,
+    "y": 220,
+    "wires": [
+      [
+        "al_dbg1"
+      ],
+      [
+        "al_dbg2"
+      ],
+      [
+        "al_dbg3"
+      ]
+    ]
+  },
+  {
+    "id": "al_on",
+    "type": "inject",
+    "z": "al_tab",
+    "name": "Alarm ON 2/1/1",
+    "props": [
+      {
+        "p": "topic",
+        "v": "2/1/1",
+        "vt": "str"
+      },
+      {
+        "p": "payload",
+        "v": "true",
+        "vt": "bool"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 180,
+    "y": 180,
+    "wires": [
+      [
+        "al_node"
+      ]
+    ]
+  },
+  {
+    "id": "al_off",
+    "type": "inject",
+    "z": "al_tab",
+    "name": "Alarm OFF 2/1/1",
+    "props": [
+      {
+        "p": "topic",
+        "v": "2/1/1",
+        "vt": "str"
+      },
+      {
+        "p": "payload",
+        "v": "false",
+        "vt": "bool"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 190,
+    "y": 220,
+    "wires": [
+      [
+        "al_node"
+      ]
+    ]
+  },
+  {
+    "id": "al_start",
+    "type": "inject",
+    "z": "al_tab",
+    "name": "Force cycle start",
+    "props": [
+      {
+        "p": "start",
+        "v": "true",
+        "vt": "bool"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 180,
+    "y": 260,
+    "wires": [
+      [
+        "al_node"
+      ]
+    ]
+  },
+  {
+    "id": "al_dbg1",
+    "type": "debug",
+    "z": "al_tab",
+    "name": "Output 1 - each device",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": true,
+    "complete": "true",
+    "targetType": "full",
+    "x": 930,
+    "y": 180,
+    "wires": []
+  },
+  {
+    "id": "al_dbg2",
+    "type": "debug",
+    "z": "al_tab",
+    "name": "Output 2 - all devices",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": true,
+    "complete": "true",
+    "targetType": "full",
+    "x": 930,
+    "y": 220,
+    "wires": []
+  },
+  {
+    "id": "al_dbg3",
+    "type": "debug",
+    "z": "al_tab",
+    "name": "Output 3 - last device",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": true,
+    "complete": "true",
+    "targetType": "full",
+    "x": 930,
+    "y": 260,
+    "wires": []
+  }
+]

package/examples/Auto Responder - Read Request Defaults.json

@@ -0,0 +1,43 @@
+[
+  {
+    "id": "ar_tab",
+    "type": "tab",
+    "label": "KNX Auto Responder",
+    "disabled": false,
+    "info": ""
+  },
+  {
+    "id": "ar_cfg",
+    "type": "knxUltimate-config",
+    "z": "",
+    "host": "224.0.23.12",
+    "port": "3671",
+    "physAddr": "15.15.212",
+    "suppressACKRequest": false,
+    "csv": "",
+    "KNXEthInterface": "Auto",
+    "KNXEthInterfaceManuallyInput": "",
+    "autoReconnect": "no"
+  },
+  {
+    "id": "ar_c",
+    "type": "comment",
+    "z": "ar_tab",
+    "name": "Respond automatically to KNX read requests with configured defaults",
+    "info": "",
+    "x": 420,
+    "y": 70,
+    "wires": []
+  },
+  {
+    "id": "ar_node",
+    "type": "knxUltimateAutoResponder",
+    "z": "ar_tab",
+    "server": "ar_cfg",
+    "name": "Auto responder",
+    "commandText": "[{\"ga\":\"2/7/1\",\"default\":true},{\"ga\":\"2/7/2\",\"dpt\":\"5.001\",\"default\":25},{\"ga\":\"2/7/3\",\"dpt\":\"16.001\",\"default\":\"Ready\"}]",
+    "x": 420,
+    "y": 170,
+    "wires": []
+  }
+]

package/examples/Garage - Door Controller.json

@@ -0,0 +1,132 @@
+[
+  {
+    "id": "ga_tab",
+    "type": "tab",
+    "label": "KNX Garage",
+    "disabled": false,
+    "info": ""
+  },
+  {
+    "id": "ga_cfg",
+    "type": "knxUltimate-config",
+    "z": "",
+    "host": "224.0.23.12",
+    "port": "3671",
+    "physAddr": "15.15.213",
+    "suppressACKRequest": false,
+    "csv": "",
+    "KNXEthInterface": "Auto",
+    "KNXEthInterfaceManuallyInput": "",
+    "autoReconnect": "no"
+  },
+  {
+    "id": "ga_c",
+    "type": "comment",
+    "z": "ga_tab",
+    "name": "Garage controller with command, moving and obstruction GA",
+    "info": "",
+    "x": 360,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "ga_node",
+    "type": "knxUltimateGarage",
+    "z": "ga_tab",
+    "server": "ga_cfg",
+    "name": "Garage Door",
+    "outputtopic": "events/garage",
+    "gaCommand": "1/2/1",
+    "nameCommand": "Garage command",
+    "dptCommand": "1.001",
+    "gaImpulse": "1/2/2",
+    "nameImpulse": "Garage impulse",
+    "dptImpulse": "1.017",
+    "gaMoving": "1/2/3",
+    "nameMoving": "Garage moving",
+    "dptMoving": "1.001",
+    "gaObstruction": "1/2/4",
+    "nameObstruction": "Garage obstruction",
+    "dptObstruction": "1.001",
+    "gaHoldOpen": "1/2/5",
+    "nameHoldOpen": "Hold open",
+    "dptHoldOpen": "1.001",
+    "gaDisable": "1/2/6",
+    "nameDisable": "Disable",
+    "dptDisable": "1.001",
+    "gaPhotocell": "1/2/7",
+    "namePhotocell": "Photocell",
+    "dptPhotocell": "1.001",
+    "autoCloseEnable": true,
+    "autoCloseSeconds": 120,
+    "emitEvents": true,
+    "x": 650,
+    "y": 220,
+    "wires": [
+      [
+        "ga_dbg"
+      ]
+    ]
+  },
+  {
+    "id": "ga_inj_on",
+    "type": "inject",
+    "z": "ga_tab",
+    "name": "Open/Toggle",
+    "props": [
+      {
+        "p": "payload",
+        "v": "true",
+        "vt": "bool"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 170,
+    "y": 200,
+    "wires": [
+      "ga_node"
+    ]
+  },
+  {
+    "id": "ga_inj_off",
+    "type": "inject",
+    "z": "ga_tab",
+    "name": "Close/Stop",
+    "props": [
+      {
+        "p": "payload",
+        "v": "false",
+        "vt": "bool"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 170,
+    "y": 240,
+    "wires": [
+      "ga_node"
+    ]
+  },
+  {
+    "id": "ga_dbg",
+    "type": "debug",
+    "z": "ga_tab",
+    "name": "Garage events",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": true,
+    "complete": "true",
+    "targetType": "full",
+    "x": 900,
+    "y": 220,
+    "wires": []
+  }
+]

package/examples/Global Context - Expose KNX Values.json

@@ -0,0 +1,45 @@
+[
+  {
+    "id": "gc_tab",
+    "type": "tab",
+    "label": "KNX Global Context",
+    "disabled": false,
+    "info": ""
+  },
+  {
+    "id": "gc_cfg",
+    "type": "knxUltimate-config",
+    "z": "",
+    "host": "224.0.23.12",
+    "port": "3671",
+    "physAddr": "15.15.214",
+    "suppressACKRequest": false,
+    "csv": "",
+    "KNXEthInterface": "Auto",
+    "KNXEthInterfaceManuallyInput": "",
+    "autoReconnect": "no"
+  },
+  {
+    "id": "gc_c",
+    "type": "comment",
+    "z": "gc_tab",
+    "name": "Expose KNX group addresses to global context",
+    "info": "",
+    "x": 350,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "gc_node",
+    "type": "knxUltimateGlobalContext",
+    "z": "gc_tab",
+    "server": "gc_cfg",
+    "name": "KNXGlobalContext",
+    "exposeAsVariable": "exposeAsVariableREADWRITE",
+    "writeExecutionInterval": 1000,
+    "contextStorage": "",
+    "x": 350,
+    "y": 140,
+    "wires": []
+  }
+]

package/examples/HA Translator - Payload Conversion.json

@@ -0,0 +1,118 @@
+[
+  {
+    "id": "ha_tab",
+    "type": "tab",
+    "label": "KNX HA Translator",
+    "disabled": false,
+    "info": ""
+  },
+  {
+    "id": "ha_c",
+    "type": "comment",
+    "z": "ha_tab",
+    "name": "Translate Home Assistant-like strings to booleans",
+    "info": "",
+    "x": 350,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "ha_node",
+    "type": "knxUltimateHATranslator",
+    "z": "ha_tab",
+    "name": "HA Translator",
+    "payloadPropName": "payload",
+    "commandText": "on:true\noff:false\nopen:true\nclosed:false\nhome:true\nnot_home:false",
+    "x": 560,
+    "y": 220,
+    "wires": [
+      [
+        "ha_dbg"
+      ]
+    ]
+  },
+  {
+    "id": "ha_on",
+    "type": "inject",
+    "z": "ha_tab",
+    "name": "payload:on",
+    "props": [
+      {
+        "p": "payload",
+        "v": "on",
+        "vt": "str"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 180,
+    "y": 180,
+    "wires": [
+      "ha_node"
+    ]
+  },
+  {
+    "id": "ha_off",
+    "type": "inject",
+    "z": "ha_tab",
+    "name": "payload:off",
+    "props": [
+      {
+        "p": "payload",
+        "v": "off",
+        "vt": "str"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 180,
+    "y": 220,
+    "wires": [
+      "ha_node"
+    ]
+  },
+  {
+    "id": "ha_home",
+    "type": "inject",
+    "z": "ha_tab",
+    "name": "payload:home",
+    "props": [
+      {
+        "p": "payload",
+        "v": "home",
+        "vt": "str"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 180,
+    "y": 260,
+    "wires": [
+      "ha_node"
+    ]
+  },
+  {
+    "id": "ha_dbg",
+    "type": "debug",
+    "z": "ha_tab",
+    "name": "Translated payload",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": true,
+    "complete": "true",
+    "targetType": "full",
+    "x": 820,
+    "y": 220,
+    "wires": []
+  }
+]

package/examples/Hue Area Motion - Zone Presence.json

@@ -0,0 +1,77 @@
+[
+  {
+    "id": "h_tab_knxUltimateHueAreaMotion",
+    "type": "tab",
+    "label": "knxUltimateHueAreaMotion",
+    "disabled": false,
+    "info": ""
+  },
+  {
+    "id": "h_knx",
+    "type": "knxUltimate-config",
+    "z": "",
+    "host": "224.0.23.12",
+    "port": "3671",
+    "physAddr": "15.15.220",
+    "suppressACKRequest": false,
+    "csv": "",
+    "KNXEthInterface": "Auto",
+    "KNXEthInterfaceManuallyInput": "",
+    "autoReconnect": "no"
+  },
+  {
+    "id": "h_hue",
+    "type": "hue-config",
+    "z": "",
+    "host": "192.168.1.10",
+    "name": "Hue Bridge",
+    "bridgeid": ""
+  },
+  {
+    "id": "h_c_knxUltimateHueAreaMotion",
+    "type": "comment",
+    "z": "h_tab_knxUltimateHueAreaMotion",
+    "name": "knxUltimateHueAreaMotion example (set your real Hue device id in hueDevice)",
+    "info": "",
+    "x": 430,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "h_node_knxUltimateHueAreaMotion",
+    "type": "knxUltimateHueAreaMotion",
+    "z": "h_tab_knxUltimateHueAreaMotion",
+    "name": "Hue Area Motion",
+    "server": "h_knx",
+    "serverHue": "h_hue",
+    "hueDevice": "device-id-here",
+    "nameAreaMotion": "Area motion",
+    "GAareaMotion": "5/3/1",
+    "dptAreaMotion": "1.001",
+    "readStatusAtStartup": "yes",
+    "enableNodePINS": "yes",
+    "outputs": 1,
+    "x": 620,
+    "y": 180,
+    "wires": [
+      [
+        "h_dbg_knxUltimateHueAreaMotion"
+      ]
+    ]
+  },
+  {
+    "id": "h_dbg_knxUltimateHueAreaMotion",
+    "type": "debug",
+    "z": "h_tab_knxUltimateHueAreaMotion",
+    "name": "knxUltimateHueAreaMotion output",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": true,
+    "complete": "true",
+    "targetType": "full",
+    "x": 920,
+    "y": 180,
+    "wires": []
+  }
+]

package/examples/Hue Battery - Level Status.json

@@ -0,0 +1,77 @@
+[
+  {
+    "id": "h_tab_knxUltimateHueBattery",
+    "type": "tab",
+    "label": "knxUltimateHueBattery",
+    "disabled": false,
+    "info": ""
+  },
+  {
+    "id": "h_knx",
+    "type": "knxUltimate-config",
+    "z": "",
+    "host": "224.0.23.12",
+    "port": "3671",
+    "physAddr": "15.15.225",
+    "suppressACKRequest": false,
+    "csv": "",
+    "KNXEthInterface": "Auto",
+    "KNXEthInterfaceManuallyInput": "",
+    "autoReconnect": "no"
+  },
+  {
+    "id": "h_hue",
+    "type": "hue-config",
+    "z": "",
+    "host": "192.168.1.10",
+    "name": "Hue Bridge",
+    "bridgeid": ""
+  },
+  {
+    "id": "h_c_knxUltimateHueBattery",
+    "type": "comment",
+    "z": "h_tab_knxUltimateHueBattery",
+    "name": "knxUltimateHueBattery example (set your real Hue device id in hueDevice)",
+    "info": "",
+    "x": 430,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "h_node_knxUltimateHueBattery",
+    "type": "knxUltimateHueBattery",
+    "z": "h_tab_knxUltimateHueBattery",
+    "name": "Hue Battery",
+    "server": "h_knx",
+    "serverHue": "h_hue",
+    "hueDevice": "device-id-here",
+    "namebatterysensor": "Battery %",
+    "GAbatterysensor": "5/8/1",
+    "dptbatterysensor": "5.001",
+    "readStatusAtStartup": "yes",
+    "enableNodePINS": "yes",
+    "outputs": 1,
+    "x": 620,
+    "y": 180,
+    "wires": [
+      [
+        "h_dbg_knxUltimateHueBattery"
+      ]
+    ]
+  },
+  {
+    "id": "h_dbg_knxUltimateHueBattery",
+    "type": "debug",
+    "z": "h_tab_knxUltimateHueBattery",
+    "name": "knxUltimateHueBattery output",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": true,
+    "complete": "true",
+    "targetType": "full",
+    "x": 920,
+    "y": 180,
+    "wires": []
+  }
+]