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

package/examples/Load Control - Manual Shedding Mode.json

@@ -0,0 +1,174 @@
+[
+  {
+    "id": "lc_tab",
+    "type": "tab",
+    "label": "KNX Load Control",
+    "disabled": false,
+    "info": ""
+  },
+  {
+    "id": "lc_cfg",
+    "type": "knxUltimate-config",
+    "z": "",
+    "host": "224.0.23.12",
+    "port": "3671",
+    "physAddr": "15.15.216",
+    "suppressACKRequest": false,
+    "csv": "",
+    "KNXEthInterface": "Auto",
+    "KNXEthInterfaceManuallyInput": "",
+    "autoReconnect": "no"
+  },
+  {
+    "id": "lc_c",
+    "type": "comment",
+    "z": "lc_tab",
+    "name": "Manual shedding/unshedding with 5 priority loads",
+    "info": "",
+    "x": 430,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "lc_node",
+    "type": "knxUltimateLoadControl",
+    "z": "lc_tab",
+    "server": "lc_cfg",
+    "name": "Load Control",
+    "controlMode": "msg",
+    "topic": "4/0/1",
+    "dpt": "14.056",
+    "wattLimit": 3000,
+    "sheddingCheckInterval": 15,
+    "sheddingRestoreDelay": 60,
+    "GA1": "4/1/1",
+    "DPT1": "1.001",
+    "Name1": "Water Heater",
+    "autoRestore1": true,
+    "MonitorGA1": "4/2/1",
+    "MonitorDPT1": "14.056",
+    "MonitorName1": "Water Heater W",
+    "GA2": "4/1/2",
+    "DPT2": "1.001",
+    "Name2": "EV Charger",
+    "autoRestore2": true,
+    "MonitorGA2": "4/2/2",
+    "MonitorDPT2": "14.056",
+    "MonitorName2": "EV Charger W",
+    "GA3": "4/1/3",
+    "DPT3": "1.001",
+    "Name3": "Boiler",
+    "autoRestore3": true,
+    "MonitorGA3": "4/2/3",
+    "MonitorDPT3": "14.056",
+    "MonitorName3": "Boiler W",
+    "GA4": "4/1/4",
+    "DPT4": "1.001",
+    "Name4": "Dryer",
+    "autoRestore4": true,
+    "MonitorGA4": "4/2/4",
+    "MonitorDPT4": "14.056",
+    "MonitorName4": "Dryer W",
+    "GA5": "4/1/5",
+    "DPT5": "1.001",
+    "Name5": "Oven",
+    "autoRestore5": true,
+    "MonitorGA5": "4/2/5",
+    "MonitorDPT5": "14.056",
+    "MonitorName5": "Oven W",
+    "x": 690,
+    "y": 240,
+    "wires": [
+      [
+        "lc_dbg"
+      ]
+    ]
+  },
+  {
+    "id": "lc_shed",
+    "type": "inject",
+    "z": "lc_tab",
+    "name": "msg.shedding = shed",
+    "props": [
+      {
+        "p": "shedding",
+        "v": "shed",
+        "vt": "str"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 210,
+    "y": 200,
+    "wires": [
+      [
+        "lc_node"
+      ]
+    ]
+  },
+  {
+    "id": "lc_unshed",
+    "type": "inject",
+    "z": "lc_tab",
+    "name": "msg.shedding = unshed",
+    "props": [
+      {
+        "p": "shedding",
+        "v": "unshed",
+        "vt": "str"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 220,
+    "y": 240,
+    "wires": [
+      [
+        "lc_node"
+      ]
+    ]
+  },
+  {
+    "id": "lc_auto",
+    "type": "inject",
+    "z": "lc_tab",
+    "name": "msg.shedding = auto",
+    "props": [
+      {
+        "p": "shedding",
+        "v": "auto",
+        "vt": "str"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 210,
+    "y": 280,
+    "wires": [
+      [
+        "lc_node"
+      ]
+    ]
+  },
+  {
+    "id": "lc_dbg",
+    "type": "debug",
+    "z": "lc_tab",
+    "name": "Load control output",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": true,
+    "complete": "true",
+    "targetType": "full",
+    "x": 950,
+    "y": 240,
+    "wires": []
+  }
+]

package/examples/Staircase - Timer, Override and Block.json

@@ -0,0 +1,305 @@
+[
+  {
+    "id": "stair_flow_1",
+    "type": "tab",
+    "label": "KNX Staircase",
+    "disabled": false,
+    "info": ""
+  },
+  {
+    "id": "stair_cfg_1",
+    "type": "knxUltimate-config",
+    "z": "",
+    "host": "224.0.23.12",
+    "port": "3671",
+    "physAddr": "15.15.210",
+    "suppressACKRequest": false,
+    "csv": "",
+    "KNXEthInterface": "Auto",
+    "KNXEthInterfaceManuallyInput": "",
+    "autoReconnect": "no"
+  },
+  {
+    "id": "stair_comment_1",
+    "type": "comment",
+    "z": "stair_flow_1",
+    "name": "Staircase timer with Trigger/Output/Status + Override + Block",
+    "info": "Use the inject nodes to test trigger/cancel. Override and Block are sent on KNX bus via the two knxUltimate helper nodes.",
+    "x": 430,
+    "y": 60,
+    "wires": []
+  },
+  {
+    "id": "stair_node_1",
+    "type": "knxUltimateStaircase",
+    "z": "stair_flow_1",
+    "server": "stair_cfg_1",
+    "name": "Staircase Light",
+    "outputtopic": "events/staircase",
+    "gaTrigger": "1/1/1",
+    "nameTrigger": "Trigger pushbutton",
+    "dptTrigger": "1.001",
+    "gaOutput": "1/1/2",
+    "nameOutput": "Light actuator",
+    "dptOutput": "1.001",
+    "gaStatus": "1/1/3",
+    "nameStatus": "Staircase status",
+    "dptStatus": "1.001",
+    "gaOverride": "1/1/4",
+    "nameOverride": "Maintenance override",
+    "dptOverride": "1.001",
+    "gaBlock": "1/1/5",
+    "nameBlock": "Activation block",
+    "dptBlock": "1.001",
+    "timerSeconds": 45,
+    "extendMode": "restart",
+    "triggerOffCancels": "yes",
+    "preWarnEnable": true,
+    "preWarnSeconds": 10,
+    "preWarnMode": "status",
+    "preWarnFlashMs": 400,
+    "blockAction": "off",
+    "emitEvents": true,
+    "x": 700,
+    "y": 260,
+    "wires": [
+      [
+        "stair_dbg_1"
+      ]
+    ]
+  },
+  {
+    "id": "stair_inj_on",
+    "type": "inject",
+    "z": "stair_flow_1",
+    "name": "Trigger ON",
+    "props": [
+      {
+        "p": "payload",
+        "v": "true",
+        "vt": "bool"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 170,
+    "y": 220,
+    "wires": [
+      [
+        "stair_node_1"
+      ]
+    ]
+  },
+  {
+    "id": "stair_inj_off",
+    "type": "inject",
+    "z": "stair_flow_1",
+    "name": "Trigger OFF (cancel)",
+    "props": [
+      {
+        "p": "payload",
+        "v": "false",
+        "vt": "bool"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 190,
+    "y": 260,
+    "wires": [
+      [
+        "stair_node_1"
+      ]
+    ]
+  },
+  {
+    "id": "stair_inj_toggle",
+    "type": "inject",
+    "z": "stair_flow_1",
+    "name": "Trigger command (string)",
+    "props": [
+      {
+        "p": "payload",
+        "v": "trigger",
+        "vt": "str"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 190,
+    "y": 300,
+    "wires": [
+      [
+        "stair_node_1"
+      ]
+    ]
+  },
+  {
+    "id": "stair_dbg_1",
+    "type": "debug",
+    "z": "stair_flow_1",
+    "name": "Staircase events",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": true,
+    "complete": "true",
+    "targetType": "full",
+    "x": 940,
+    "y": 260,
+    "wires": []
+  },
+  {
+    "id": "stair_override_node",
+    "type": "knxUltimate",
+    "z": "stair_flow_1",
+    "server": "stair_cfg_1",
+    "topic": "1/1/4",
+    "dpt": "1.001",
+    "initialread": false,
+    "notifyreadrequest": false,
+    "notifyresponse": true,
+    "notifywrite": false,
+    "notifyreadrequestalsorespondtobus": true,
+    "notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized": "0",
+    "listenallga": false,
+    "name": "Override command GA",
+    "outputtype": "write",
+    "outputRBE": false,
+    "inputRBE": false,
+    "x": 690,
+    "y": 420,
+    "wires": [
+      []
+    ]
+  },
+  {
+    "id": "stair_override_on",
+    "type": "inject",
+    "z": "stair_flow_1",
+    "name": "Override ON (GA 1/1/4)",
+    "props": [
+      {
+        "p": "payload",
+        "v": "true",
+        "vt": "bool"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 210,
+    "y": 400,
+    "wires": [
+      [
+        "stair_override_node"
+      ]
+    ]
+  },
+  {
+    "id": "stair_override_off",
+    "type": "inject",
+    "z": "stair_flow_1",
+    "name": "Override OFF (GA 1/1/4)",
+    "props": [
+      {
+        "p": "payload",
+        "v": "false",
+        "vt": "bool"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 210,
+    "y": 440,
+    "wires": [
+      [
+        "stair_override_node"
+      ]
+    ]
+  },
+  {
+    "id": "stair_block_node",
+    "type": "knxUltimate",
+    "z": "stair_flow_1",
+    "server": "stair_cfg_1",
+    "topic": "1/1/5",
+    "dpt": "1.001",
+    "initialread": false,
+    "notifyreadrequest": false,
+    "notifyresponse": true,
+    "notifywrite": false,
+    "notifyreadrequestalsorespondtobus": true,
+    "notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized": "0",
+    "listenallga": false,
+    "name": "Block command GA",
+    "outputtype": "write",
+    "outputRBE": false,
+    "inputRBE": false,
+    "x": 680,
+    "y": 520,
+    "wires": [
+      []
+    ]
+  },
+  {
+    "id": "stair_block_on",
+    "type": "inject",
+    "z": "stair_flow_1",
+    "name": "Block ON (GA 1/1/5)",
+    "props": [
+      {
+        "p": "payload",
+        "v": "true",
+        "vt": "bool"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 190,
+    "y": 500,
+    "wires": [
+      [
+        "stair_block_node"
+      ]
+    ]
+  },
+  {
+    "id": "stair_block_off",
+    "type": "inject",
+    "z": "stair_flow_1",
+    "name": "Block OFF (GA 1/1/5)",
+    "props": [
+      {
+        "p": "payload",
+        "v": "false",
+        "vt": "bool"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "x": 190,
+    "y": 540,
+    "wires": [
+      [
+        "stair_block_node"
+      ]
+    ]
+  }
+]

package/nodes/locales/en/knxUltimateDateTime.html

@@ -10,6 +10,9 @@ It can send:
 
 You can configure one or more group addresses and the node will write to all configured outputs.
 
+Note about **DPT 19.001**:
+- the node starts from a JavaScript `Date` and converts it to KNX DateTime via the KNX engine.
+
 ## When it sends
 
 - **On deploy/startup** (optional, with delay).
@@ -26,6 +29,10 @@ Supported payloads:
 - a timestamp number (milliseconds since epoch)
 - a string accepted by `new Date("...")`
 - `"now"`
+- an object with one of these fields:
+  - `msg.payload.dateTime`
+  - `msg.payload.timestamp`
+  - `msg.payload.epoch`
 
 Example:
 
@@ -34,12 +41,17 @@ msg.payload = new Date();
 return msg;
 ```
 
+## Gateway disconnected
+
+If the KNX gateway is disconnected, the send is queued and sent automatically when the connection comes back.
+The node keeps **only one pending request** (the latest one).
+
 ## Output
 
 The node emits one message per send:
 - `msg.payload`: the `Date` that has been written
 - `msg.sent`: array of `{ ga, dpt, name }`
 - `msg.reason`: `input`, `startup`, `periodic` or `button`
+- `msg.knxUltimateDateTime.date`: date/time in ISO format (`toISOString()`)
 
 </script>
-

package/nodes/locales/it/knxUltimateDateTime.html

@@ -10,6 +10,9 @@ Può inviare:
 
 Puoi configurare uno o più indirizzi di gruppo: il nodo scrive su tutti quelli configurati.
 
+Nota su **DPT 19.001**:
+- il nodo parte da una `Date` JavaScript e la converte in telegramma KNX DateTime tramite l'engine KNX.
+
 ## Quando invia
 
 - **Al deploy/avvio** (opzionale, con ritardo).
@@ -26,6 +29,10 @@ Payload supportati:
 - numero timestamp (millisecondi dall'epoch)
 - stringa accettata da `new Date("...")`
 - `"now"`
+- oggetto con uno di questi campi:
+  - `msg.payload.dateTime`
+  - `msg.payload.timestamp`
+  - `msg.payload.epoch`
 
 Esempio:
 
@@ -34,12 +41,17 @@ msg.payload = new Date();
 return msg;
 ```
 
+## Gateway non connesso
+
+Se il gateway KNX non è connesso, l'invio viene messo in coda e parte appena torna la connessione.
+Il nodo mantiene **una sola richiesta pendente** (l'ultima ricevuta).
+
 ## Output
 
 Il nodo emette un messaggio ad ogni invio:
 - `msg.payload`: la `Date` inviata
 - `msg.sent`: array di `{ ga, dpt, name }`
 - `msg.reason`: `input`, `startup`, `periodic` o `button`
+- `msg.knxUltimateDateTime.date`: data/ora in formato ISO (`toISOString()`)
 
 </script>
-

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "4.3.15",
+  "version": "4.3.17",
   "description": "Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, KNX AI for diagnosticsand KNX routing between interfaces. Easy to use and highly configurable.",
   "files": [
     "nodes/",
@@ -19,7 +19,7 @@
     "dns-sync": "0.2.1",
     "google-translate-tts": "^0.3.0",
     "js-yaml": "4.1.1",
-    "knxultimate": "5.5.6",
+    "knxultimate": "5.5.7",
     "lodash": "4.18.1",
     "node-color-log": "12.0.1",
     "ping": "0.4.4",
@@ -117,4 +117,4 @@
     "vite": "^7.1.3",
     "vue": "^3.5.21"
   }
-}
+}