node-red-contrib-knx-ultimate 3.3.38 → 3.3.39

package/CHANGELOG.md

@@ -6,6 +6,9 @@
 
 # CHANGELOG
 
+**Version 3.3.39** - Juli 2025<br/>
+- Added other snippets to the KNX Device function tab.<br/>
+
 **Version 3.3.38** - May 2025<br/>
 - FIX: fixed possible issue having tabulator chars in the group address names.<br/>
 - KNX Engine: better handling of disconnections telegrams.<br/>

package/nodes/knxUltimate.html

@@ -128,6 +128,15 @@
             $("#snippetThree").on("click", function (event) {
                 node.receiveMsgFromKNXCodeEditor.session.setValue(KNXFunctionSnippetThree);
             });
+            $("#snippetFour").on("click", function (event) {
+                node.sendMsgToKNXCodeEditor.session.setValue(KNXFunctionSnippetFour);
+            });
+            $("#snippetFive").on("click", function (event) {
+                node.sendMsgToKNXCodeEditor.session.setValue(KNXFunctionSnippetFive);
+            });
+            $("#snippetSix").on("click", function (event) {
+                node.sendMsgToKNXCodeEditor.session.setValue(KNXFunctionSnippetSix);
+            });
 
             function checkUI() {
 
@@ -746,6 +755,9 @@
                 </div>
                 <i class="fa fa-code"></i> Select a snippet to be inserted<br />
                 <button type="button" id="snippetOne" class="red-ui-button">Status GA check</button>
+                <button type="button" id="snippetFour" class="red-ui-button">Toggle value</button>
+                <button type="button" id="snippetFive" class="red-ui-button">Send false after 5 secs</button>
+                <button type="button" id="snippetSix" class="red-ui-button">Send 20% to another GA</button>
                 <hr>
                 <div class="form-row">
                     <dt>
@@ -839,7 +851,7 @@ If enabled, "f(x)" indication will be added to node's name.
 | getGAValue (string GA, optional string DPT) | Get the specified GA's value, for example **'1/0/1'**, or also **'1/0/1 Bed table light'** (All text after a blank space will be ignored by the function. This is useful if you want to add the GA name as a reminder. With the ETS file imported, you can also copy and paste the GA and GA Name directly from the **Search GA** field.). **DPT** is optional if you've imported the ETS file, otherwise you must specify it, for example '1.001'. |
 | setGAValue (string GA, any value, optional string DPT) | Set the specified GA's value. The GA con be wrote for example **'1/0/1'**, or also **'1/0/1 Bed table light'** (All text after a blank space will be ignored by the function. This is useful if you want to add the GA name as a reminder. With the ETS file imported, you can also copy and paste the GA and GA Name directly from the **Search GA** field.). The **value** is mandatory, can be a boolean or number or string, **DPT** is optional if you've imported the ETS file, otherwise you must specify it, for example '1.001'. |
 | self (any value) | Set the currend node's value and sends the value to the KNX BUS as well. For example, *self(false)*. Caution using **self** function in the *From KNX BUS to node's OUTPUT PIN* code, because the code will be executed everytime a KNX telegram is received, so you coud have recurrency loops. |
-| toggle (nothing) | Toggle the currend node's value and sends the value to the KNX BUS as well. For example, *toggle()*. Caution using **toggle** function in the *From KNX BUS to node's OUTPUT PIN* code, because the code will be executed everytime a KNX telegram is received, so you coud have recurrency loops. |
+| toggle () | Toggle the currend node's value and sends the value to the KNX BUS as well. For example, *toggle()*. Caution using **toggle** function in the *From KNX BUS to node's OUTPUT PIN* code, because the code will be executed everytime a KNX telegram is received, so you coud have recurrency loops. |
 | node (object) | The node object. |
 | RED (Node-Red object) | The Node-Red's RED object. |
 | return (msg) | Mandatory `return msg;`, if you want to emit the message. Otherwise, using `return;` will not emit any message. |

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "3.3.38",
+  "version": "3.3.39",
   "description": "Control your KNX 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",

package/resources/KNXFunctionCodeSnippets.js

@@ -41,4 +41,25 @@ return msg`;
 const KNXFunctionSnippetThree = `// @ts-nocheck
 // The current msg contains the internal temperature in the "msg.payload" property, but we want to emit the external temperature as well.
 msg.externalTemperature = getGAValue('0/0/10 Garden temperature sensor'); // In case the ETS file is missing, you must specify the dpt as well: getGAValue('0/0/10','9.001')
+return msg;`;
+
+const KNXFunctionSnippetFour = `// @ts-nocheck
+// After 5000 milliseconds, toggle.
+setTimeout(function() {
+    toggle();
+}, 5000);
+return msg;`;
+
+const KNXFunctionSnippetFive = `// @ts-nocheck
+// After 5000 milliseconds, send false.
+setTimeout(function () {
+    self(false);
+}, 5000);
+return msg;`;
+
+const KNXFunctionSnippetSix = `// @ts-nocheck
+// Send 20% to the GA 1/0/1 having DPT 5.001
+if (msg.payload === true){
+    setGAValue('1/0/1',20,'5.001') 
+}
 return msg;`;