node-red-contrib-knx-ultimate 2.5.1 → 3.0.0-beta2

package/nodes/knxUltimate.html

@@ -1,6 +1,8 @@
 <!-- <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/jquery.searchableSelect.js"></script> -->
 
 
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
+
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimate', {
         category: "KNX Ultimate",
@@ -9,6 +11,7 @@
             //buttonState: {value: true},
             server: { type: "knxUltimate-config", required: true },
             topic: { value: "" },
+            setTopicType: { value: "str" },
             outputtopic: { value: "" },
             dpt: { value: "" },
             initialread: { value: 0 },
@@ -31,7 +34,7 @@
         outputs: 1,
         icon: "node-knx-icon.svg",
         label: function () {
-            return ((this.outputRBE === "true" || this.outputRBE === true) ? "|rbe| " : "") + (this.name || this.topic || "KNX Device") + ((this.inputRBE === "true" || this.inputRBE === true) ? " |rbe|" : "")
+            return ((this.outputRBE === "true" || this.outputRBE === true) ? "|rbe| " : "") + (this.name || this.topic || "KNX Device") + (this.setTopicType === 'str' || this.setTopicType === undefined ? '' : ' [' + this.setTopicType + ']') + ((this.inputRBE === "true" || this.inputRBE === true) ? " |rbe|" : "")
         },
         paletteLabel: "KNX DEVICE",
         // button: {
@@ -53,16 +56,7 @@
             var node = this;
             var oNodeServer = RED.nodes.node($("#node-input-server").val()); // Store the config-node
             $("#tabs").tabs();
-            // 31/03/2020 Search Helper
-            function fullSearch(sourceText, searchString) {
-                // This searches for all words in a string
-                var aSearchWords = searchString.toLowerCase().split(" ");
-                var i = 0;
-                for (let index = 0; index < aSearchWords.length; index++) {
-                    if (sourceText.toLowerCase().indexOf(aSearchWords[index]) > -1) i += 1;
-                }
-                return i == aSearchWords.length;
-            }
+
 
 
             // 15/09/2020 Supergiovane, set the help sample based on Datapoint
@@ -152,6 +146,7 @@
 
                     if ($("#node-input-server").val() !== "_ADD_" && $("#node-input-server").val() !== '') {
                         $.getJSON("knxUltimateDpts?serverId=" + $("#node-input-server").val() + "&_=" + new Date().getTime(), (data) => {
+                            $("#node-input-dpt").empty();
                             data.forEach(dpt => {
                                 $("#node-input-dpt").append($("<option></option>")
                                     .attr("value", dpt.value)
@@ -229,38 +224,76 @@
                         }
                     })
 
-                    // Autocomplete suggestion with ETS csv File
-                    $("#node-input-topic").autocomplete({
-                        minLength: 1,
-                        source: function (request, response) {
-                            $.getJSON("knxUltimatecsv?nodeID=" + oNodeServer.id + "&" + { _: new Date().getTime() }, (data) => {
-                                response($.map(data, function (value, key) {
-                                    var sSearch = (value.ga + " (" + value.devicename + ") DPT" + value.dpt);
-                                    if (fullSearch(sSearch, request.term)) {
-                                        return {
-                                            label: value.ga + " # " + value.devicename + " # " + value.dpt, // Label for Display
-                                            value: value.ga // Value
-                                        }
-                                    } else {
-                                        return null;
+                    // Set the group address type
+                    if (node.setTopicType === undefined) {
+                        node.setTopicType = 'str';
+                        $("#node-input-setTopicType").val('str');
+                    }
+                    // $("#node-input-topic").typedInput(
+                    //     {
+                    //         default: node.setTopicType || 'str',
+                    //         types: [{ value: 'str', label: "str", icon: 'red/images/typedInput/az.svg', autocomplete: autoCompleteGA }, 'flow', 'global', 'env'],
+                    //         typeField: "#node-input-setTopicType"
+                    //     });
+                    // var autoCompleteGA = function () {
+                    //     alert(value)
+                    //     return [{ value: "Ciso", label: "maso" }]
+                    // }
+
+
+                    $("#node-input-setTopicType").on('change', function () {
+                        try {
+                            $("#node-input-topic").autocomplete('destroy');
+                            $("#node-input-topic").off(); // Rimuovi tutti gli eventi associati
+                            $("#node-input-topic").val(''); // Pulisce il valore del campo di input, se necessario
+                            $("#node-input-topic").prop('disabled', false); // Assicura che il campo non sia disabilitato
+                            $("#node-input-topic").removeClass(); // Rimuove eventuali classi aggiunte dall'autocompletamento                           
+                        } catch (error) {
+                        }
+                        if ($("#node-input-setTopicType").val() === 'str') {
+                            $("#node-input-topic").prop('placeholder', 'Select your GA');
+                            // Autocomplete suggestion with ETS csv File
+                            $("#node-input-topic").autocomplete({
+                                minLength: 0,
+                                source: function (request, response) {
+                                    $.getJSON("knxUltimatecsv?nodeID=" + oNodeServer.id + "&" + { _: new Date().getTime() }, (data) => {
+                                        response($.map(data, function (value, key) {
+                                            var sSearch = (value.ga + " (" + value.devicename + ") DPT" + value.dpt);
+                                            if (htmlUtilsfullCSVSearch(sSearch, request.term)) {
+                                                return {
+                                                    label: value.ga + " # " + value.devicename + " # " + value.dpt, // Label for Display
+                                                    value: value.ga // Value
+                                                }
+                                            } else {
+                                                return null;
+                                            }
+                                        }));
+                                    });
+                                }, select: function (event, ui) {
+                                    // Sets Datapoint and device name automatically
+                                    var sDevName = ui.item.label.split("#")[1].trim();
+                                    try {
+                                        sDevName = sDevName.substr(sDevName.indexOf(")") + 1).trim();
+                                    } catch (error) {
                                     }
-                                }));
+                                    $('#node-input-name').val(sDevName);
+                                    var optVal = $("#node-input-dpt option:contains('" + ui.item.label.split("#")[2].trim() + "')").attr('value');
+                                    // Select the option value 
+                                    $("#node-input-dpt").val(optVal);
+                                    $("#node-input-dpt").trigger("change");
+                                }
+                            }).focus(function () {
+                                $(this).autocomplete('search', $(this).val() + 'exactmatch');
                             });
-                        }, select: function (event, ui) {
-                            // Sets Datapoint and device name automatically
-                            var sDevName = ui.item.label.split("#")[1].trim();
-                            try {
-                                sDevName = sDevName.substr(sDevName.indexOf(")") + 1).trim();
-                            } catch (error) {
-                            }
-                            $('#node-input-name').val(sDevName);
-                            var optVal = $("#node-input-dpt option:contains('" + ui.item.label.split("#")[2].trim() + "')").attr('value');
-                            // Select the option value 
-                            $("#node-input-dpt").val(optVal);
-                            $("#node-input-dpt").trigger("change");
+                            $("#divDatapointSelection").show();
+                        } else {
+                            $("#node-input-topic").prop('placeholder', $("#node-input-setTopicType").val());
+                            if ($("#node-input-topic").val() === '') $("#node-input-topic").val('MyVariable');
+                            $("#divDatapointSelection").hide();
                         }
                     });
 
+
                     // Hide or show the GA and DPT fields if Notify on all Group Addresses is checked
                     if (oNodeServer !== undefined && oNodeServer !== null) {
                         if (oNodeServer.csv !== undefined && oNodeServer.csv !== "") {
@@ -320,6 +353,8 @@
         oneditsave: function () {
             var node = this;
 
+            //this.propertyType = $("#node-input-property").typedInput('type');
+
             // 19/02/2020 Warn user that the node will node encode/decode datagram, if Listen All GA's if the config node doesn't contain the csv
             if ($("#isETSFileLoaded").val() === "no") {
                 // Notify the user
@@ -391,15 +426,22 @@
 <div id="divMain">
 
     <div id="GAandDPT">
+
         <div class="form-row">
             <label for="node-input-topic">
                 <img
                     src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAwAAAAMCAYAAABWdVznAAAACXBIWXMAAB7CAAAewgFu0HU+AAAF6WlUWHRYTUw6Y29tLmFkb2JlLnhtcAAAAAAAPD94cGFja2V0IGJlZ2luPSLvu78iIGlkPSJXNU0wTXBDZWhpSHpyZVN6TlRjemtjOWQiPz4gPHg6eG1wbWV0YSB4bWxuczp4PSJhZG9iZTpuczptZXRhLyIgeDp4bXB0az0iQWRvYmUgWE1QIENvcmUgNS42LWMxNDggNzkuMTY0MDM2LCAyMDE5LzA4LzEzLTAxOjA2OjU3ICAgICAgICAiPiA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPiA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIiB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIgeG1sbnM6cGhvdG9zaG9wPSJodHRwOi8vbnMuYWRvYmUuY29tL3Bob3Rvc2hvcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RFdnQ9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZUV2ZW50IyIgeG1wOkNyZWF0b3JUb29sPSJBZG9iZSBQaG90b3Nob3AgMjEuMSAoTWFjaW50b3NoKSIgeG1wOkNyZWF0ZURhdGU9IjIwMjAtMDMtMjNUMTY6MjE6MDkrMDE6MDAiIHhtcDpNb2RpZnlEYXRlPSIyMDIwLTAzLTIzVDE2OjI4OjI3KzAxOjAwIiB4bXA6TWV0YWRhdGFEYXRlPSIyMDIwLTAzLTIzVDE2OjI4OjI3KzAxOjAwIiBkYzpmb3JtYXQ9ImltYWdlL3BuZyIgcGhvdG9zaG9wOkNvbG9yTW9kZT0iMyIgcGhvdG9zaG9wOklDQ1Byb2ZpbGU9InNSR0IgSUVDNjE5NjYtMi4xIiB4bXBNTTpJbnN0YW5jZUlEPSJ4bXAuaWlkOjc4M2I5OWIxLTkwMjYtNGQ2OC05N2FmLTRkM2E2ZWY4Zjk2OCIgeG1wTU06RG9jdW1lbnRJRD0ieG1wLmRpZDo4N2E3YTg0NS0xMDljLTRkMTMtOGEzOS04OWVhOTMyMDQ0ZWMiIHhtcE1NOk9yaWdpbmFsRG9jdW1lbnRJRD0ieG1wLmRpZDo4N2E3YTg0NS0xMDljLTRkMTMtOGEzOS04OWVhOTMyMDQ0ZWMiPiA8eG1wTU06SGlzdG9yeT4gPHJkZjpTZXE+IDxyZGY6bGkgc3RFdnQ6YWN0aW9uPSJjcmVhdGVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOjg3YTdhODQ1LTEwOWMtNGQxMy04YTM5LTg5ZWE5MzIwNDRlYyIgc3RFdnQ6d2hlbj0iMjAyMC0wMy0yM1QxNjoyMTowOSswMTowMCIgc3RFdnQ6c29mdHdhcmVBZ2VudD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiLz4gPHJkZjpsaSBzdEV2dDphY3Rpb249InNhdmVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOjc4M2I5OWIxLTkwMjYtNGQ2OC05N2FmLTRkM2E2ZWY4Zjk2OCIgc3RFdnQ6d2hlbj0iMjAyMC0wMy0yM1QxNjoyODoyNyswMTowMCIgc3RFdnQ6c29mdHdhcmVBZ2VudD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKE1hY2ludG9zaCkiIHN0RXZ0OmNoYW5nZWQ9Ii8iLz4gPC9yZGY6U2VxPiA8L3htcE1NOkhpc3Rvcnk+IDwvcmRmOkRlc2NyaXB0aW9uPiA8L3JkZjpSREY+IDwveDp4bXBtZXRhPiA8P3hwYWNrZXQgZW5kPSJyIj8+DGyPFQAAAE9JREFUKJG1UEEOACAIgub/v2yHalnJVoe4uIEKSgccJ9jroVmjA0+ujZtWku3DgZmgBiT4egN9CmmEAAfA/5HUW0OQu7dKmOCzmM3k9YYKZv8ZEZ/YgNsAAAAASUVORK5CYII="></img>
-                <span data-i18n="knxUltimate.properties.node-input-topic"></span>
-            </label>
-            <input type="text" id="node-input-topic" placeholder="Sample: Dinning light" />
+                Group Addr.</label>
+            <select id="node-input-setTopicType" style="width:120px">
+                <option value="str">3-Levels</option>
+                <option value="flow">Flow</option>
+                <option value="global">Gobal</option>
+                <option value="env">$Env variable</option>
+            </select>
+            <input type="text" id="node-input-topic" placeholder="Start typing to search" style="width:180px" />
         </div>
-        <div class="form-row">
+
+        <div class="form-row" id="divDatapointSelection">
             <label for="node-input-dpt">
                 <img
                     src="data:image/png;base64,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"></img>
@@ -631,7 +673,8 @@
 |Property|Description|
 |--|--|
 | Gateway | Select the KNX gateway to be used |
-| Group Addr. | The KNX Group Address you want to control. If you've imported the ETS group addresses file, you can just start typing in your device name. |
+| GA Type dropdown list | The group address type. **3-Levels** is the default, where you can type the *3 level group address* or the *group address name* (if you've upload the ETS file), or **Global**, for reading the GA at startup from a global variable, or **Flow** that do the same as the *Global*, but at flow level. Select **$Env variable** to read the group address from an environment variable. |
+| Group Addr. | The KNX Group Address you want to control. If you've imported the ETS group addresses file, you can just start typing in your device name. You can leave it empty if you wish set it with *msg.setConfig* input message. |
 | Datapoint | The datapoint belonging to your node.|
 | Node name | Self explaining. |
 | Topic | The msg output topic. Leave it blank to have it set to your Group Address. |
@@ -677,19 +720,21 @@
 : writeraw (buffer): is used to send a value to the KNX bus, as buffer. Use in conjunction with *bitlenght*.
 : bitlenght (int): specifies the lenght of the *writeraw* buffer. Use in conjunction with *writeraw*.
 : resetRBE (boolean) : resets the internal RBE filters (*use msg.resetRBE = true*).
-: config (json) : programmatically change the KNX-Ultimate Device node configuration. See details.
+: setConfig (json) : programmatically change the KNX-Ultimate Device node Group Address and Datapoint. See details.
 
 ### Details
 
-`msg.config`: It's possible to programmatically change the KNX-Ultimate node configuration, by sending msg.setConfig object to the node.
+`msg.setConfig`: It's possible to programmatically change the KNX-Ultimate node configuration, by sending msg.setConfig object to the node.
 The new configuration will be retained until next msg.setConfig or until restart/redeploy.
-All properties are optional, that means, you can change only the properties you need.  
+All properties (*setGroupAddress* and *setDPT*) **are mandatory**..  
 Use it like that, in a functon node:    
 
-```json
+**Set both GA and DPT**
+
+```javascript
 // Change the node properties as follows:
 // setGroupAddress: set the new group address.
-// setDPT: set the new Datapoint, as you can see in the dropdown list (the numeric part, for example "1.001", "237.600", etc...)
+// setDPT: set the new Datapoint, as you can see in the dropdown list (the numeric part, for example "1.001", "237.600", etc...). If set to **auto**, the datapoint will be read from the ETS file (if present).
 var config= {
     setGroupAddress: "0/1/2",
     setDPT: "1.001"
@@ -698,6 +743,20 @@ msg.setConfig = config;
 return msg;
 ```
 
+**Set GA and read the datapoint from the ETS file** 
+
+```javascript
+// Change the node properties as follows:
+// setGroupAddress: set the new group address.
+// setDPT: set the new Datapoint, as you can see in the dropdown list (the numeric part, for example "1.001", "237.600", etc...). If set to "auto", the datapoint will be read from the ETS file (if present).
+var config= {
+    setGroupAddress: "0/1/2",
+    setDPT: "auto"
+};
+msg.setConfig = config;
+return msg;
+```
+
 ### Outputs
 
 1. Standard output
@@ -708,23 +767,31 @@ return msg;
 
 ### Details
 
-`msg.payload` is used as the payload of the published message.
-If it contains an Object it will be converted to a JSON string before being sent.  
+`msg.payload` is used as the payload of the group address (the group address value).
+This is, instead, an example of the complete msg object.  
 
 ```json
 msg = {
     topic: "0/1/2" // (Contains the node's topic, for example "MyTopic". If the node's topic is not set, contains the Group Address, for example "0/1/2")
     payload: false 
-    previouspayload: true // (Previous node payload value.)
-    payloadmeasureunit: "%" // (payload's measure unit)
-    payloadsubtypevalue: "Start" // (Subtype's decoded value, for exampe, On/Off, Ramp/NoRamp, Start/Stop, Alarm/NoAlarm)
-    devicename: "Dinning table lamp" // (Contains the node's name)
-    knx: {
+    previouspayload: true // Previous node payload value.
+    payloadmeasureunit: "%" // Payload's measure unit.
+    payloadsubtypevalue: "Start" // Subtype's decoded value, for exampe, On/Off, Ramp/NoRamp, Start/Stop, Alarm/NoAlarm
+    devicename: "Dinning table lamp" // If the node is in **universal mode**, it contains the full path (main, middle,name) of the group address name, otherwise, the node name.
+    gainfo: { // Contains the details about the group address name and number. This object is only present if the node is set in **universal mode** and with the **ETS file** been imported. If something wrong, it contains the string **unknown**.
+        maingroupname:"Light actuators"
+        middlegroupname:"First flow lights"
+        ganame:"Table Light"
+        maingroupnumber:"1"
+        middlegroupnumber:"1"
+        ganumber:"0"
+    }
+    knx: { // This is a representation of the KNX BUS telegram, coming from BUS
         event: "GroupValue_Write" // (or "GroupValue_Response", or "GroupValue_Read")
         dpt: "1.001"
-        dptdesc: "Humidity" // (payload's measure unit description)
+        dptdesc: "Humidity" // Payload's measure unit description
         source: "15.15.22"
-        destination: "0/1/2" // (Contains the Group Address of the incoming telegram)
+        destination: "0/1/2" // Contains the Group Address
         rawValue: buffer[1]raw // (or null, if "GroupValue_Read")
             0: 0x0 // (This is the RAW undecoded value)
     }

package/nodes/knxUltimate.js

@@ -1,7 +1,8 @@
+
 /* eslint-disable max-len */
 module.exports = function (RED) {
   const _ = require('lodash');
-  const KNXUtils = require('../KNXEngine/src/protocol/KNXUtils');
+  const KNXUtils = require('knxultimate');
   const payloadRounder = require('./utils/payloadManipulation');
 
   function knxUltimate(config) {
@@ -13,9 +14,82 @@ module.exports = function (RED) {
       node.status({ fill: 'red', shape: 'dot', text: '[THE GATEWAY NODE HAS BEEN DISABLED]' });
       return;
     }
-    node.topic = config.topic;
-    node.outputtopic = (config.outputtopic === undefined || config.outputtopic === '') ? config.topic : config.outputtopic; // 07/02/2020 Importante, per retrocompatibilità
-    node.dpt = config.dpt || '1.001';
+
+    // Used to call the status update from the config node.
+    node.setNodeStatus = ({
+      fill, shape, text, payload, GA, dpt, devicename,
+    }) => {
+      try {
+        if (node.server == null) { node.status({ fill: 'red', shape: 'dot', text: '[NO GATEWAY SELECTED]' }); return; }
+        if (node.icountMessageInWindow == -999) return; // Locked out, doesn't change status.
+        const dDate = new Date();
+        // 30/08/2019 Display only the things selected in the config
+        GA = (typeof GA === 'undefined' || GA == '') ? '' : `(${GA}) `;
+        devicename = devicename || '';
+        dpt = (typeof dpt === 'undefined' || dpt == '') ? '' : ` DPT${dpt}`;
+        payload = typeof payload === 'object' ? JSON.stringify(payload) : payload;
+        node.status({ fill, shape, text: `${GA + payload + (node.listenallga === true ? ` ${devicename}` : '')} (${dDate.getDate()}, ${dDate.toLocaleTimeString()} ${text}` });
+        // 16/02/2020 signal errors to the server
+        if (fill.toUpperCase() === 'RED') {
+          if (node.server) {
+            const oError = {
+              nodeid: node.id, topic: node.outputtopic, devicename, GA, text,
+            };
+            node.server.reportToWatchdogCalledByKNXUltimateNode(oError);
+          }
+        }
+        // Validate the Address to advise the user. The address can be undefined, because the
+        // group address can be set via setConfig
+        if (node.listenallga === false) {
+          try {
+            KNXUtils.validateKNXAddress(node.topic, true);
+          } catch (error) {
+            node.setNodeStatus({
+              fill: 'grey', shape: 'ring', text: "DISABLED: " + error.message, payload: '', GA: node.topic, dpt: '', devicename: '',
+            });
+          }
+        }
+
+      } catch (error) {
+      }
+
+    };
+
+
+
+    // Get the Group Address from various sources
+    if (config.setTopicType === undefined || config.setTopicType === 'str') {
+      node.topic = config.topic;
+      node.dpt = config.dpt || '1.001';
+    } else if (config.setTopicType === 'flow') {
+      try {
+        node.topic = node.context().flow.get(config.topic);
+        node.dpt = 'auto';
+        payloadRounder.KNXULtimateChangeConfigByInputMSG({ setConfig: { setGroupAddress: node.topic, setDPT: node.dpt } }, node, config);
+      } catch (error) {
+        node.topic = undefined;
+      }
+    } else if (config.setTopicType === 'global') {
+      try {
+        node.topic = node.context().global.get(config.topic);
+        node.dpt = 'auto';
+        payloadRounder.KNXULtimateChangeConfigByInputMSG({ setConfig: { setGroupAddress: node.topic, setDPT: node.dpt } }, node, config);
+      } catch (error) {
+        node.topic = undefined;
+      }
+    } else if (config.setTopicType === 'env') {
+      try {
+        node.topic = RED.util.getSetting(node, config.topic); // takes care of the subflow's env vairables
+        node.dpt = 'auto';
+        payloadRounder.KNXULtimateChangeConfigByInputMSG({ setConfig: { setGroupAddress: node.topic, setDPT: node.dpt } }, node, config);
+      } catch (error) {
+        node.topic = undefined;
+      }
+    }
+
+
+    node.outputtopic = (config.outputtopic === undefined || config.outputtopic === '') ? node.topic : config.outputtopic; // 07/02/2020 Importante, per retrocompatibilità
+    node.name = config.name;
     node.notifyreadrequest = config.notifyreadrequest || false;
     node.notifyreadrequestalsorespondtobus = config.notifyreadrequestalsorespondtobus || 'false'; // Auto respond if notifireadrequest is true
     node.notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized = config.notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized || '';
@@ -47,48 +121,11 @@ module.exports = function (RED) {
     node.sysLogger = require('./utils/sysLogger.js').get({ loglevel: node.server.loglevel || 'error' }); // 08/04/2021 new logger to adhere to the loglevel selected in the config-window
 
 
-
-    // Used to call the status update from the config node.
-    node.setNodeStatus = ({
-      fill, shape, text, payload, GA, dpt, devicename,
-    }) => {
-      try {
-        if (node.server == null) { node.status({ fill: 'red', shape: 'dot', text: '[NO GATEWAY SELECTED]' }); return; }
-        if (node.icountMessageInWindow == -999) return; // Locked out, doesn't change status.
-        const dDate = new Date();
-        // 30/08/2019 Display only the things selected in the config
-        GA = (typeof GA === 'undefined' || GA == '') ? '' : `(${GA}) `;
-        devicename = devicename || '';
-        dpt = (typeof dpt === 'undefined' || dpt == '') ? '' : ` DPT${dpt}`;
-        payload = typeof payload === 'object' ? JSON.stringify(payload) : payload;
-        node.status({ fill, shape, text: `${GA + payload + (node.listenallga === true ? ` ${devicename}` : '')} (${dDate.getDate()}, ${dDate.toLocaleTimeString()} ${text}` });
-        // 16/02/2020 signal errors to the server
-        if (fill.toUpperCase() === 'RED') {
-          if (node.server) {
-            const oError = {
-              nodeid: node.id, topic: node.outputtopic, devicename, GA, text,
-            };
-            node.server.reportToWatchdogCalledByKNXUltimateNode(oError);
-          }
-        }
-      } catch (error) {
-      }
-    };
-
-    // Check if the node has a valid topic and dpt
+    // Check if the node has a valid dpt
     if (node.listenallga === false) {
-      if (node.topic === undefined || node.dpt === undefined) {
-        node.setNodeStatus({
-          fill: 'red', shape: 'dot', text: 'Empty Group Addr. or datapoint.', payload: '', GA: '', dpt: '', devicename: '',
-        });
-        return;
-      }
-      // Validate the Address
-      try {
-        KNXUtils.validateKNXAddress(node.topic, true);
-      } catch (error) {
+      if (node.dpt === undefined || node.dpt === '') {
         node.setNodeStatus({
-          fill: 'red', shape: 'dot', text: error.message, payload: '', GA: node.topic, dpt: '', devicename: '',
+          fill: 'red', shape: 'dot', text: 'The Datapoint cannot be empty.', payload: '', GA: '', dpt: '', devicename: '',
         });
         return;
       }
@@ -113,6 +150,7 @@ module.exports = function (RED) {
       node.send(msg);
     };
 
+
     node.on('input', (msg) => {
       if (typeof msg === 'undefined') return;
       if (!node.server) return; // 29/08/2019 Server not instantiate
@@ -120,22 +158,24 @@ module.exports = function (RED) {
       // 11/01/2021 Accept properties change from msg
       // *********************************
       if (msg.hasOwnProperty('setConfig')) {
-        if (msg.setConfig.hasOwnProperty('setDPT')) {
-          node.dpt = msg.setConfig.setDPT;
-          if (node.sysLogger !== undefined && node.sysLogger !== null) node.sysLogger.info(`knxUltimate: new datapoint set by msg: ${node.dpt}`);
-          node.setNodeStatus({
-            fill: 'grey', shape: 'ring', text: `Datapoint changed to ${node.dpt}`, payload: '', GA: '', dpt: '', devicename: '',
-          });
-        }
-        if (msg.setConfig.hasOwnProperty('setGroupAddress')) {
-          node.topic = msg.setConfig.setGroupAddress;
-          if (node.sysLogger !== undefined && node.sysLogger !== null) node.sysLogger.info(`knxUltimate: new GroupAddress set by msg: ${node.topic}`);
+        payloadRounder.KNXULtimateChangeConfigByInputMSG(msg, node, config);
+        return;
+      }
+      // *********************************
+
+
+      // 16/06/2024 Check wether the node has a group address set.
+      // Validate the Address
+      if (node.listenallga === false) {
+        try {
+          KNXUtils.validateKNXAddress(node.topic, true);
+        } catch (error) {
           node.setNodeStatus({
-            fill: 'grey', shape: 'ring', text: `GroupAddress changed to ${node.topic}`, payload: '', GA: '', dpt: '', devicename: '',
+            fill: 'red', shape: 'dot', text: error.message, payload: '', GA: node.topic, dpt: '', devicename: '',
           });
+          return;
         }
       }
-      // *********************************
 
       // 19/06/2022 Reset the RBE filter https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/191
       // *********************************
@@ -241,7 +281,7 @@ module.exports = function (RED) {
           }
         }
       } else {
-        if (node.listenallga == false) {
+        if (node.listenallga === false) {
           // 23/12/2020 Applying RBE filter
           if (node.outputRBE === "true") {
             // 19/01/2023 CHECKING THE INPUT PAYLOAD (ROUND, ETC) BASED ON THE NODE CONFIG
@@ -287,7 +327,7 @@ module.exports = function (RED) {
             if (msg.event === 'Update_NoWrite') outputtype = 'update'; // 05/01/2021 Doesn't send anything to the bus. Only updates the node currentPayload
           }
 
-          if (node.listenallga == true) {
+          if (node.listenallga === true) {
             // The node is set to Universal mode (listen to all Group Addresses). Some fields are needed
             if (msg.hasOwnProperty('destination')) {
               grpaddr = msg.destination;
@@ -297,7 +337,7 @@ module.exports = function (RED) {
               });
               return;
             }
-            if (msg.hasOwnProperty('dpt')) {
+            if (msg.hasOwnProperty('dpt') && msg.dpt !== undefined && msg.dpt !== '') {
               dpt = msg.dpt;
             } else {
               // No datapoint set. If the CSV is loaded, try to get it from there.
@@ -325,7 +365,7 @@ module.exports = function (RED) {
             }
           } else {
             grpaddr = msg.hasOwnProperty('destination') ? msg.destination : node.topic;
-            dpt = msg.hasOwnProperty('dpt') ? msg.dpt : node.dpt;
+            dpt = (msg.hasOwnProperty('dpt') && msg.dpt !== undefined && msg.dpt !== '') ? msg.dpt : node.dpt;
           }
 
           // Protection over circular references (for example, if you link two Ultimate Nodes toghether with the same group address), to prevent infinite loops

package/nodes/knxUltimateAlerter.html

@@ -1,3 +1,5 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
+
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimateAlerter', {
         category: "KNX Ultimate",
@@ -45,16 +47,7 @@
                 } catch (error) { }
             });
 
-            // 31/03/2020 Search Helper
-            function fullSearch(sourceText, searchString) {
-                // This searches for all words in a string
-                var aSearchWords = searchString.toLowerCase().split(" ");
-                var i = 0;
-                for (let index = 0; index < aSearchWords.length; index++) {
-                    if (sourceText.toLowerCase().indexOf(aSearchWords[index]) > -1) i += 1;
-                }
-                return i == aSearchWords.length;
-            }
+
 
 
             // Scene configuration
@@ -90,12 +83,12 @@
 
                     // Autocomplete suggestion with ETS csv File
                     oTopicField.autocomplete({
-                        minLength: 1,
+                        minLength: 0,
                         source: function (request, response) {
                             $.getJSON("knxUltimatecsv?nodeID=" + oNodeServer.id, (data) => {
                                 response($.map(data, function (value, key) {
                                     var sSearch = (value.ga + " (" + value.devicename + ") DPT" + value.dpt);
-                                    if (fullSearch(sSearch, request.term)) {
+                                    if (htmlUtilsfullCSVSearch(sSearch, request.term + " 1.")) {
                                         return {
                                             label: value.ga + " # " + value.devicename + " # " + value.dpt, // Label for Display
                                             value: value.ga // Value
@@ -116,6 +109,8 @@
                             }
 
                         }
+                    }).focus(function () {
+                        $(this).autocomplete('search', $(this).val() + 'exactmatch');
                     });
 
                     oTopicField.val(rule.topic);

package/nodes/knxUltimateAlerter.js

@@ -4,8 +4,8 @@ module.exports = function (RED) {
     const fs = require('fs');
     const path = require('path');
     const mkdirp = require('mkdirp');
-    // const Address = require('./../KNXEngine/src/protocol/KNXAddress')
-    // const KnxConstants = require('./../KNXEngine/src/protocol/KNXConstants')
+    // const Address = require('knxultimate')
+    // const KnxConstants = require('knxultimate/protocol/KNXConstants')
 
     RED.nodes.createNode(this, config);
     const node = this;
@@ -209,6 +209,7 @@ module.exports = function (RED) {
         node.setLocalStatus({ fill: 'grey', shape: 'dot', text: 'ERROR: You must provide payload (true/false)', payload: '', GA: '', dpt: '', devicename: '' });
         return;
       }
+
       msg.knx = { dpt: '1.001' };
       node.handleSend(msg);
     });

package/nodes/knxUltimateGarageDoorBarrierOpener.html

@@ -1,3 +1,5 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
+
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimateGarageDoorBarrierOpener', {
         category: "KNX Ultimate",
@@ -48,7 +50,7 @@
 
             function getGroupAddressSimple(_sourceWidgetAutocomplete, _additionalSearchTerm) {
                 $(_sourceWidgetAutocomplete).autocomplete({
-                    minLength: 1,
+                    minLength: 0,
                     source: function (request, response) {
                         //$.getJSON("csv", request, function( data, status, xhr ) {
                         $.getJSON("knxUltimatecsv?nodeID=" + $("#node-input-server").val() + "&" + { _: new Date().getTime() }, (data) => {
@@ -57,7 +59,7 @@
                                     var sSearch = value.ga + " (" + value.devicename + ") DPT" + value.dpt;
                                     for (let index = 0; index < _additionalSearchTerm.length; index++) {
                                         const sDPT = _additionalSearchTerm[index];
-                                        if (fullSearch(sSearch, request.term + " " + sDPT)) {
+                                        if (htmlUtilsfullCSVSearch(sSearch, request.term + " " + sDPT)) {
                                             return {
                                                 label: value.ga + " # " + value.devicename + " # " + value.dpt, // Label for Display
                                                 value: value.ga + " # " + value.devicename + " # " + value.dpt, // Label for Display
@@ -73,19 +75,12 @@
                         const sDevName = ui.item.value.trim();
                         $(_sourceWidgetAutocomplete).val(sDevName);
                     },
+                }).focus(function () {
+                    $(this).autocomplete('search', $(this).val() + 'exactmatch');
                 });
             }
 
-            // 31/03/2020 Search Helper
-            function fullSearch(sourceText, searchString) {
-                // This searches for all words in a string
-                var aSearchWords = searchString.toLowerCase().split(" ");
-                var i = 0;
-                for (let index = 0; index < aSearchWords.length; index++) {
-                    if (sourceText.toLowerCase().indexOf(aSearchWords[index]) > -1) i += 1;
-                }
-                return i == aSearchWords.length;
-            }
+
 
             if (oNodeServer === undefined) {
                 // Hide the UI