node-red-contrib-knx-ultimate 2.4.8 → 2.4.10

package/CHANGELOG.md

@@ -6,7 +6,13 @@
 
 # CHANGELOG
 
-**Version 2.4.7** - March 2024<br/>
+**Version 2.4.10** - March 2024<br/>
+- Warning: this version uses the Node-Red plugin system; the  Node-Red version must be **equals or major than 3.1.1**<br/>
+- NEW: Home Assistant translator node: translates the HA input msg, to a KNX value. Comes with a built.in translation table, that's user editable.<br/>
+- Updated KNX-Ultimate device node help.<br/>
+- Minor KNX-Ultimate device node UI changes.<br/>
+
+**Version 2.4.9** - March 2024<br/>
 - WARNING: this version uses the Node-Red plugin system; the  Node-Red version must be **equals or major than 3.1.1**<br/>
 - Fixed [this](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/338).<br/>
 

package/KNXEngine/src/dptlib/dpt238.js

@@ -29,12 +29,22 @@ exports.basetype = {
   bitlength: 8,
   range: [,],
   valuetype: 'basic',
-  desc: '1-byte'
+  desc: '1-byte',
+  help:
+    `// Datapoint for 1 byte.
+    // For example, for DPT 238.102, HVAC Mode, the values are as following:
+    // 0-Auto
+    // 1-Heat
+    // 3-Cool
+    // 9-Fan
+    // 14-Dry
+    msg.payload = 0; // Auto
+    return msg;`
 }
 
 exports.subtypes = {
-  // 20.102 HVAC mode
-  102: {
+  // .102 HVAC mode
+  '102': {
     name: 'HVAC_Mode',
     desc: '',
     unit: '',

package/README.md

@@ -38,6 +38,8 @@ msg.payload = {red:255, green:200, blue:30} // Put some colors in our life
 * **LOAD CONTROL node** [here](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/LoadControl-Configuration). Control your loads (Oven, Washing machine, etc..) and avoit shutting down the main voltage due to too high power consumption.
 * **VIEWER node** [here](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/knxUltimateViewer). View all Group Addresses and values of your KNX BUS, in the Node-Red Dashboard.
 * **PHILIPS HUE nodeset** [here](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/en-hue-configuration). Link HUE devices to KNX in a simple way.
+* **Homeassistant translator node** translates the HA input msg, to a KNX value. Comes with a built.in translation table, that's user editable.
+
 
 <br>
 <br>

package/nodes/hue-config.html

@@ -150,6 +150,6 @@
 
 </script>
 <script type="text/markdown" data-help-name="hue-config" This node registers to the Hue Bridge. Just set the Bridge's IP
-    and click **CONNECT** button. [Find it useful?](https://www.paypal.me/techtoday) <br />
+    and click **CONNECT** button. [DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday) <br />
 
 </script>

package/nodes/icons/node-ha-icon.svg

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Generated by Pixelmator Pro 3.5.7 -->
+<svg width="40" height="40" viewBox="0 0 40 40" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+    <image id="Livello-immagine" x="8" y="8" width="24" height="24" xlink:href="data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAAAXNSR0IArs4c6QAAAERlWElmTU0AKgAAAAgAAYdpAAQAAAABAAAAGgAAAAAAA6ABAAMAAAABAAEAAKACAAQAAAABAAAAGKADAAQAAAABAAAAGAAAAADiNXWtAAACn0lEQVRIDZ2Uy2sTURSHMzHioygWrRWitAXbpoiKIIKu6saVWVhs3EYXXZkKrgrd5J9wEXDlCwpSEF1YfEQtQSi4KIoiqAsXQtMWH9UhadXx+w33hsm0mcQc+HLOPfc85p65k1isRfE8rx+mDP0tprUU5lB0CIrw1/AMPUS201KFqCAKpeAB/AErsuVLReU23aOAxvIEgsVZ+iLfU2hvXJVK5SDJc6CxNBLtzSm26dMGAjTzAXgEweKrrMsG2VYUo9gBajR/J+bJp0n4bSugK3DTdddOosUt40P5onFNNz0JQb3wEILFWXrv4ZQ9pWzjQ9VEOcrttXHScbt4++lLD/ZtOAObrN/oVXQ14JMtX1CUo9w7plZtTzPvg/BVxFWTKlY+m81uFbIh+B5qgRgal2r10cGJlcs/97HQFxoeC646WVhy3aTAu1C3s36hWlOqnejq6rhEpxEIj6V2RGPEuSL2ltRGGw4ya9Uaofa8AscgYTbaUe9IOmeQbUU1x/Sjl9uueCRecBzntQowlo+oebAn7Wl2VOVFyTeKv7EBmUzmA/aaXft6/fvxfuG7Z5BtZXHZdfcLHIuwAhMU8Z+2UChsZn0Z6kTHCkuOq7hLsDEe2Aw2+Ix/srv7SIdpeIP1LHwPxPtmuEFVT2KPmM/nE0TpG5D4DWZKpb3YE3sGB3dQ/AD2K202knAD3d/DtgE6zvqlSfYbyJdOp7fjOwYls9dQhRso8DlchNO5XG4L+ji8ANtAX/5ReAx6oEjZqIH+fn/AElwxpziBPaN5J5Op3dgtFSfO26iB/FbUbFz/PyvV6qHR0dFtgVtkYyK1GujKRYmu41XGtVPv5j8blDVP/Q+dh04VaCDL+K/zUc3eLxY7zw4PX2PtN2wQL/dXuPsP3FmfJDlKUiMAAAAASUVORK5CYII="/>
+</svg>

package/nodes/knxUltimate-config.html

@@ -467,6 +467,6 @@
 <br/>
 
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
         
 </script>

package/nodes/knxUltimate-config.js

@@ -1379,7 +1379,7 @@ module.exports = (RED) => {
 
     // 14/08/2019 If the node has payload same as the received telegram, return false
     function checkRBEInputFromKNXBusAllowSend(_node, _KNXTelegramPayload) {
-      if (_node.inputRBE !== true) return true;
+      if (_node.inputRBE !== "true") return true;
 
       return !_.isEqual(_node.currentPayload, _KNXTelegramPayload);
     }

package/nodes/knxUltimate.html

@@ -1,3 +1,6 @@
+<!-- <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/jquery.searchableSelect.js"></script> -->
+
+
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimate', {
         category: "KNX Ultimate",
@@ -17,8 +20,8 @@
             listenallga: { value: false },
             name: { value: "" },
             outputtype: { value: "write" },
-            outputRBE: { value: true },
-            inputRBE: { value: false },
+            outputRBE: { value: "true" },
+            inputRBE: { value: "false" },
             formatmultiplyvalue: { value: 1 },
             formatnegativevalue: { value: "leave" },
             formatdecimalsvalue: { value: 999 },
@@ -28,7 +31,7 @@
         outputs: 1,
         icon: "node-knx-icon.svg",
         label: function () {
-            return (this.outputRBE == true ? "|rbe| " : "") + (this.name || this.topic || "KNX Device") + (this.inputRBE == true ? " |rbe|" : "")
+            return (this.outputRBE === "true" ? "|rbe| " : "") + (this.name || this.topic || "KNX Device") + (this.inputRBE === "true" ? " |rbe|" : "")
         },
         paletteLabel: "KNX DEVICE",
         // button: {
@@ -49,7 +52,6 @@
             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
@@ -161,9 +163,9 @@
                         if ($("#node-input-listenallga").is(":checked")) {
                             $("#GAandDPT").hide()
                             $("#divOutputRBE").hide()
-                            $("#node-input-outputRBE").prop('checked', false)
+                            $("#node-input-outputRBE").val("false")
                             $("#divInputRBE").hide()
-                            $("#node-input-inputRBE").prop('checked', false)
+                            $("#node-input-inputRBE").val("false")
                             $("#divnotifyreadrequestautoreact").hide();
                             $("#helpallga").show();
                             $("#divTopic").hide()
@@ -386,6 +388,17 @@
         </label>
         <input type="text" id="node-input-outputtopic" data-i18n="[placeholder]knxUltimate.placeholder.leaveempty" />
     </div>
+    <div class="form-row">
+        <label for="node-input-passthrough">
+            <i class="fa fa-long-arrow-right"></i> Passthrough
+        </label>
+        <select id="node-input-passthrough">
+            <option value="no">No</option>
+            <option value="yes">Yes, pass the input msg to the output msg</option>
+            <option value="yesownprop">Yes, but put the input msg into msg.inputmessage property of the output msg
+            </option>
+        </select>
+    </div>
     <div class="form-row">
         <input type="checkbox" id="node-input-listenallga"
             style="display:inline-block; width:auto; vertical-align:top;" />
@@ -406,16 +419,6 @@
         </ul>
         <div id="tabs-1">
             <div class="form-row" style="padding:10px">
-                <div class="form-row">
-                    <label style="width:180px" for="node-input-passthrough">
-                        <i class="fa fa-long-arrow-right"></i> Msg passthrough
-                    </label>
-                    <select id="node-input-passthrough">
-                        <option value="no" data-i18n="knxUltimate.selectlists.passthrough_No"></option>
-                        <option value="yes" data-i18n="knxUltimate.selectlists.passthrough_Leave"></option>
-                        <option value="yesownprop" data-i18n="knxUltimate.selectlists.passthrough_OwnProp"></option>
-                    </select>
-                </div>
                 <div class="form-row">
                     <dt>
                         <i class="fa fa-arrow-right"></i> CONTROL (payload to KNX bus)
@@ -433,11 +436,13 @@
                     </select>
                 </div>
                 <div class="form-row" id="divOutputRBE">
-                    <input type="checkbox" id="node-input-outputRBE"
-                        style="display:inline-block; width:auto; vertical-align:top;" />
-                    <label style="width:85%" for="node-input-outputRBE">
-                        <i class="fa fa-filter"></i> Send payload to KNX only if changed (RBE filter)
+                    <label style="width:180px" for="node-input-outputRBE">
+                        <i class="fa fa-filter"></i> RBE filter
                     </label>
+                    <select id="node-input-outputRBE">
+                        <option value="true">Enable (send the payload to KNX only if changed)</option>
+                        <option value="false">Disable</option>
+                    </select>
                 </div>
                 <br />
                 <div class="form-row">
@@ -458,11 +463,13 @@
 
                 </div>
                 <div class="form-row" id="divInputRBE">
-                    <input type="checkbox" id="node-input-inputRBE"
-                        style="display:inline-block; width:auto; vertical-align:top;" />
-                    <label style="width:85%" for="node-input-inputRBE">
-                        <i class="fa fa-filter"></i> React only by changed payload (RBE filter)
+                    <label style="width:180px" for="node-input-inputRBE">
+                        <i class="fa fa-filter"></i> RBE filter
                     </label>
+                    <select id="node-input-inputRBE">
+                        <option value="true">Enable (react only if payload changes)</option>
+                        <option value="false">Disable</option>
+                    </select>
                 </div>
                 <div class="form-row">
                     <input type="checkbox" id="node-input-notifywrite"
@@ -581,9 +588,11 @@
 <br /><br />
 </script>
 <script type="text/markdown" data-help-name="knxUltimate">
-<p>This node lets you control a KNX Group Address, this is the most used node.
+<p>This node lets you control a KNX Group Address, this is the most used node.  
+    
+[<i class="fa fa-code"></i> Here you'll find some samples](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-SamplesHome)
 
-**General**
+**Configuration**
 |Property|Description|
 |--|--|
 | Gateway | Select the KNX gateway to be used |
@@ -591,17 +600,35 @@
 | 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. |
+| Passthrough | If set, you can pass the input mgs to the output msg. |
 | Universal mode (listen to all Group Addresses) | By setting this, the node will read and control ALL group addresses. |
-| Sample Function | This will give it a hint on what to write in a function, if you want to control the node via a Node-Red function node. |
-| Input msg passthrough | If set, you can pass the input mgs to the output msg. |
+
+
+**Advanced options**
+|Property|Description|
+|--|--|
+||**CONTROL (payload to KNX bus)**|
 | Telegram type | *write* to send write telegram (usually, you want that), otherwise you can choose the telegram's type to react to. |
-| Send payload to KNX only if changed (RBE filter) | *Report by change* filter. If set, only the msg input (from the Flow) having different values each time, will be sent to the KNX bus. If you intend to send everytime the same value, turn it off. |
+| RBE filter (in the CONTROL section) | *Report by change* filter. If set, only the msg input (from the Flow) having different values each time, will be sent to the KNX bus. If you intend to send everytime the same value, turn it off. |
+||**STATUS (payload from KNX BUS)**|
 | Read status on start | Read group address status, every time Node-Red starts and at every reconnection to the KNX Gateway. The node stores all group address values to a file, so you can choose wether to read from file or from the KNX bus. |
-| React only by changed payload (RBE filter) | *Report by change* filter. If set, only the msg output (to KNX bus) having different values each time, will be sent to the msg output's flow. If you intend to send everytime the same value, leave it off. |
+| RBE filter (in the STATUS section)| *Report by change* filter. If set, only the msg output (to KNX bus) having different values each time, will be sent to the msg output's flow. If you intend to send everytime the same value, leave it off. |
 | React to write telegrams | The node will react (will send a msg to the flow) each time it receives a *write* telegram from the KNX bus. Usually, you want that. |
 | React to response telegrams | The node will react (will send a msg to the flow) each time it receives a *response* telegram from the KNX bus. Usually, you want that for particular scenarios. |
 | React to read telegrams | The node will react (will send a msg to the flow) each time it receives a *read* telegram from the KNX bus. Usually, you want that if you're want to send a custom value to the KNX BUS. |
-| Format input | Allow you to format numeric values received from the KNX Bus. |
+
+
+**Format input**
+|Property|Description|
+|--|--|
+| Multiply | Multiplies or divides the payload value |
+| Decimals | Round or handle decimals in any way |
+| Negatives | Handles the negative values |
+
+**Payload sample**
+|Property|Description|
+|--|--|
+| Sample | This will give it a hint on what to write in a function, if you want to control the node via a Node-Red function node. |
 
 <br/>
 
@@ -669,9 +696,9 @@ msg = {
 }
 ````
 
-<br/><a href="https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-SamplesHome" target="_blank"><i class="fa fa-code"></i> Samples</a>
+<br/>
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 
 

package/nodes/knxUltimate.js

@@ -26,8 +26,8 @@ module.exports = function (RED) {
     node.initialread = Number(config.initialread);
     node.listenallga = config.listenallga || false;
     node.outputtype = config.outputtype || 'write';// When the node is used as output
-    node.outputRBE = config.outputRBE || false; // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = config.inputRBE || false; // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = config.outputRBE || 'false'; // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = config.inputRBE || 'false'; // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = ''; // Current value for the RBE input and for the .previouspayload msg
     node.icountMessageInWindow = 0; // Used to prevent looping messages
     node.messageQueue = []; // 01/01/2020 All messages from the flow to the node, will be queued and will be sent separated by 60 milliseconds each. Use uf the underlying api "minimumDelay" is not possible because the telegram order isn't mantained.
@@ -234,7 +234,7 @@ module.exports = function (RED) {
       } else {
         if (node.listenallga == false) {
           // 23/12/2020 Applying RBE filter
-          if (node.outputRBE == true) {
+          if (node.outputRBE === "true") {
             // 19/01/2023 CHECKING THE INPUT PAYLOAD (ROUND, ETC) BASED ON THE NODE CONFIG
             //* ********************************************************
             const pTest = payloadRounder.Manipulate(node, msg.payload);

package/nodes/knxUltimateGarageDoorBarrierOpener.html

@@ -314,7 +314,7 @@ msg = {
 
 <br/><a href="https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-SamplesHome" target="_blank"><i class="fa fa-code"></i> Samples</a>
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 
 

package/nodes/knxUltimateGlobalContext.js

@@ -42,8 +42,8 @@ module.exports = function (RED) {
     node.initialread = false
     node.listenallga = true
     node.outputtype = 'write'
-    node.outputRBE = false // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = false // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = 'false' // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = 'false' // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = '' // Current value for the RBE input and for the .previouspayload msg
     node.passthrough = 'no'
     node.formatmultiplyvalue = 1

package/nodes/knxUltimateHATranslator.html

@@ -0,0 +1,74 @@
+<script type="text/javascript">
+	RED.nodes.registerType('knxUltimateHATranslator', {
+		category: 'KNX Ultimate',
+		defaults: {
+			name: { value: "" },
+			payloadPropName: { value: "payload", required: false },
+			commandText: { value: 'on:true\noff:false\nactive:true\ninactive:false\nopen:true\nclosed:false\nclose:false\n1:true\n0:false\ntrue:true\nfalse:false\nhome:true\nnot_home:false', required: false }
+		},
+		inputs: 1,
+		outputs: 1,
+		icon: "node-ha-icon.svg",
+		label: function () {
+			return (this.name || 'HA Translator');
+		},
+		color: '#AED6F1',
+		paletteLabel: "Homeassistant translator",
+		oneditprepare: function () {
+			var node = this;
+			node.editor = RED.editor.createEditor({
+				id: 'node-input-editorcommandText',
+				mode: 'ace/mode/text',
+				value: node.commandText
+			});
+		},
+		oneditsave: function () {
+			var node = this;
+			node.commandText = node.editor.getValue();
+			node.editor.destroy();
+			delete node.editor;
+		},
+		oneditcancel: function () {
+			var node = this;
+			node.editor.destroy();
+			delete node.editor;
+		},
+	});
+</script>
+
+<script type="text/html" data-template-name="knxUltimateHATranslator">
+    <div class="form-row">
+        <label for="node-config-input-name">
+            <i class="fa fa-tag"></i> Name
+        </label>
+        <input type="text" id="node-config-input-name">
+    </div>
+	<div class="form-row">
+        <label for="node-input-payloadPropName"><i class="fa fa-ellipsis-h"></i> Input</label>
+		<input type="text" id="node-input-payloadPropName">
+    </div>
+    <div class="form-row">
+        <label style="width:300px;" for="node-input-commandText"><i class="fa fa-tasks"></i> Translate (Homassistant:KNX)</label>
+        <div style="height: 250px; min-height:150px;" class="node-text-editor" id="node-input-editorcommandText"></div>
+    </div>
+</script>
+
+<script type="text/markdown" data-help-name="knxUltimateHATranslator">
+<p>This node translates the input msg to valid true/false values.<p>
+
+
+It can translate an input payload, to a true/false boolean values.<br />
+Each row in the text box, represents a translation command. <br/>
+You can add your own translation row.<br/>
+
+|Property|Description|
+|--|--|
+| Name | The node name. |
+| Input | The input msg property to be evaluated and translated. |
+| Translate | Add, delete or edit your own translation command. The row's translation command must be **input string from HA:KNX value** (*KNX value* as true or false). For example: <code>open:true</code> <code>closed:false</code>. |
+
+<br/>
+
+
+[Find it useful?](https://www.paypal.me/techtoday)
+</script>

package/nodes/knxUltimateHATranslator.js

@@ -0,0 +1,83 @@
+/* eslint-disable prefer-arrow-callback */
+module.exports = function (RED) {
+  function knxUltimateHATranslator(config) {
+    RED.nodes.createNode(this, config);
+    this.config = config;
+    var node = this;
+
+    function setNodeStatus({ fill, shape, text }) {
+      let dDate = new Date();
+      node.status({
+        fill: fill,
+        shape: shape,
+        text:
+          text +
+          " (" +
+          dDate.getDate() +
+          ", " +
+          dDate.toLocaleTimeString() +
+          ")",
+      });
+    }
+
+    setNodeStatus({ fill: "grey", shape: "dot", text: "Waiting" });
+
+    this.on("input", function (msg) {
+      // 11/11/2021 Clone input message and replace only relevant topics
+      const utils = require("./utils/utils.js");
+      let sPayload = utils.fetchFromObject(
+        msg,
+        config.payloadPropName || "payload"
+      );
+
+      // 15/11/2021 inform user about undefined topic or payload
+      if (sPayload === undefined) {
+        setNodeStatus({
+          fill: "red",
+          shape: "dot",
+          text: "Received invalid payload from " + msg.topic || "",
+        });
+        return;
+      }
+
+      var bRes = null;
+      try {
+        bRes = utils.ToBoolean(
+          sPayload,
+          RED.nodes.getNode(config.translatorConfig) // Retrieve the config node. It can be null, but it's handled in utils.js; // 15/11/2021 Convert input to boolean.);
+        );
+      } catch (error) { }
+      if (bRes === undefined || bRes === null) {
+        setNodeStatus({
+          fill: "red",
+          shape: "dot",
+          text:
+            "Received non convertible boolean value " +
+            sPayload +
+            " from " +
+            msg.topic,
+        });
+        return;
+      }
+
+      var msgOUt = RED.util.cloneMessage(msg);
+      try {
+        msgOUt.payload = bRes;
+        setNodeStatus({
+          fill: "green",
+          shape: "dot",
+          text: "(Send) " + msgOUt.payload,
+        });
+        node.send(msgOUt);
+      } catch (error) {
+        setNodeStatus({
+          fill: "red",
+          shape: "dot",
+          text: "Unable to invert the input payload " + bRes,
+        });
+      }
+    });
+  }
+
+  RED.nodes.registerType("knxUltimateHATranslator", knxUltimateHATranslator);
+};

package/nodes/knxUltimateHueBattery.html

@@ -252,7 +252,7 @@ you're typing.
 
 <br />
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 <br />
 

package/nodes/knxUltimateHueBattery.js

@@ -15,8 +15,8 @@ module.exports = function (RED) {
     node.initialread = true;
     node.listenallga = true; // Don't remove
     node.outputtype = 'write';
-    node.outputRBE = false; // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = false; // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = 'false'; // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = 'false'; // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = ''; // Current value for the RBE input and for the .previouspayload msg
     node.passthrough = 'no';
     node.formatmultiplyvalue = 1;

package/nodes/knxUltimateHueButton.html

@@ -446,7 +446,7 @@ It contains the detailed event sent by your Hue devicem so you can use it for wh
 
 <br/>
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 <br/>
 

package/nodes/knxUltimateHueButton.js

@@ -17,8 +17,8 @@ module.exports = function (RED) {
     node.initialread = true;
     node.listenallga = true; // Don't remove
     node.outputtype = 'write';
-    node.outputRBE = false; // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = false; // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = 'false'; // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = 'false'; // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = ''; // Current value for the RBE input and for the .previouspayload msg
     node.passthrough = 'no';
     node.formatmultiplyvalue = 1;

package/nodes/knxUltimateHueLight.html

@@ -1539,7 +1539,7 @@ The Dimming function works in **KNX mode `start` and `stop`**. To start dimming,
 
 <br/>
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 <br/>
 </script>

package/nodes/knxUltimateHueLight.js

@@ -40,8 +40,8 @@ module.exports = function (RED) {
     node.initialread = true;
     node.listenallga = true; // Don't remove
     node.outputtype = "write";
-    node.outputRBE = false; // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = false; // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = 'false'; // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = 'false'; // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = ""; // Current value for the RBE input and for the .previouspayload msg
     node.passthrough = "no";
     node.formatmultiplyvalue = 1;
@@ -209,9 +209,10 @@ module.exports = function (RED) {
                     const dretXY = hueColorConverter.ColorConverter.calculateXYFromRGB(colorChoosen.red, colorChoosen.green, colorChoosen.blue, gamut);
                     const dbright = hueColorConverter.ColorConverter.getBrightnessFromRGBOrHex(colorChoosen.red, colorChoosen.green, colorChoosen.blue);
                     node.currentHUEDevice.dimming.brightness = Math.round(dbright, 0);
+                    if (node.currentHUEDevice.color !== undefined) node.currentHUEDevice.color.xy = dretXY; // 26/03/2024
                     node.updateKNXBrightnessState(node.currentHUEDevice.dimming.brightness);
                     state = dbright > 0 ? { on: { on: true }, dimming: { brightness: dbright }, color: { xy: dretXY } } : { on: { on: false } };
-                    //state = { on: { on: true }, dimming: { brightness: dbright }, color: { xy: dretXY } };
+                    // state = { on: { on: true }, dimming: { brightness: dbright }, color: { xy: dretXY } };
                   } else if (temperatureChoosen !== undefined) {
                     // Kelvin
                     const mirek = hueColorConverter.ColorConverter.kelvinToMirek(temperatureChoosen);
@@ -220,10 +221,10 @@ module.exports = function (RED) {
                     node.updateKNXBrightnessState(node.currentHUEDevice.dimming.brightness);
                     // Kelvin temp
                     state = brightnessChoosen > 0 ? { on: { on: true }, dimming: { brightness: brightnessChoosen }, color_temperature: { mirek: mirek } } : { on: { on: false } };
-                    //state = { on: { on: true }, dimming: { brightness: brightnessChoosen }, color_temperature: { mirek: mirek } };
+                    // state = { on: { on: true }, dimming: { brightness: brightnessChoosen }, color_temperature: { mirek: mirek } };
                   } else if (brightnessChoosen !== undefined) {
                     state = brightnessChoosen > 0 ? { on: { on: true }, dimming: { brightness: brightnessChoosen } } : { on: { on: false } };
-                    //state = { on: { on: true }, dimming: { brightness: brightnessChoosen } };
+                    // state = { on: { on: true }, dimming: { brightness: brightnessChoosen } };
                   } else {
                     state = { on: { on: true } };
                   }
@@ -307,7 +308,7 @@ module.exports = function (RED) {
                       try {
                         const retLights = await node.serverHue.getAllLightsBelongingToTheGroup(node.hueDevice);
                         node.HUELightsBelongingToGroupWhileDaytime = cloneDeep(retLights); // DayTime has switched to false: save the lights belonging to the group into the HUELightsBelongingToGroupWhileDaytime array
-                      } catch (error) { }
+                      } catch (error) { /* empty */ }
                     })();
                   }
                 }
@@ -530,6 +531,7 @@ module.exports = function (RED) {
       try {
         let hueTelegram = {};
         let numStep = 10; // Steps from 0 to 100 by 10
+        const extendedConf = {};
 
         if (_KNXbrightness_Direction === 0 && _KNXaction === 0) {
           // STOP DIM
@@ -539,6 +541,12 @@ module.exports = function (RED) {
           return;
         }
 
+        // 26/03/2024 set the extended configuration as well, because the light was off (so i've been unable to set it up elsewhere)
+        if (node.currentHUEDevice.on !== undefined && node.currentHUEDevice.on.on === false) {
+          // if (node.currentHUEDevice.color !== undefined) extendedConf.color = { xy: node.currentHUEDevice.color.xy }; // DO NOT ADD THE COLOR, BECAUSE THE COLOR HAS ALSO THE BRIGHTNESS, SO ALL THE DATA NEEDED TO BE SWITCHED ON CORRECLY
+          if (node.currentHUEDevice.color_temperature !== undefined) extendedConf.color_temperature = { mirek: node.currentHUEDevice.color_temperature.mirek };
+        }
+
         // If i'm dimming up while the light is off, start the dim with the initial brightness set to zero
         if (_KNXbrightness_Direction > 0 && _KNXaction === 1 && node.currentHUEDevice.on !== undefined && node.currentHUEDevice.on.on === false) {
           node.brightnessStep = null;
@@ -575,7 +583,9 @@ module.exports = function (RED) {
             // Switch on the light if off
             if (node.currentHUEDevice.on !== undefined && node.currentHUEDevice.on.on === false) {
               hueTelegram.on = { on: true };
+              Object.assign(hueTelegram, extendedConf); // 26/03/2024 add extended conf
             }
+            //console.log(hueTelegram)
             node.serverHue.hueManager.writeHueQueueAdd(node.hueDevice, hueTelegram, node.isGrouped_light === false ? "setLight" : "setGroupedLight");
             if (node.brightnessStep >= maxDimLevelLight) clearInterval(node.timerStepDim);
           }, _dimSpeedInMillisecs);
@@ -851,7 +861,7 @@ module.exports = function (RED) {
 
     node.handleSendHUE = (_event) => {
       try {
-        let deviceByRef = cloneDeep(_event);
+        const deviceByRef = cloneDeep(_event);
         if (deviceByRef.id === node.hueDevice) {
           if (node.currentHUEDevice === undefined || node.serverHue === null || node.serverHue === undefined) {
             node.setNodeStatusHue({
@@ -1107,11 +1117,11 @@ module.exports = function (RED) {
     //     };
 
     /**
-* Update the KNC colors and HSV states group addresses
-* @param {object} _value {xy:{x,y}} in 0-1 scale
-* @param {string} _outputtype "write" is the default KNX command
-* @returns {}
-*/
+  * Update the KNC colors and HSV states group addresses
+  * @param {object} _value {xy:{x,y}} in 0-1 scale
+  * @param {string} _outputtype "write" is the default KNX command
+  * @returns {}
+  */
     node.updateKNXLightColorState = function updateKNXLightColorState(_value, _outputtype = "write") {
       if (config.GALightColorState !== undefined && config.GALightColorState !== "") {
         if (_value.xy === undefined || _value.xy.x === undefined) return;

package/nodes/knxUltimateHueLightSensor.html

@@ -262,7 +262,7 @@ It contains the detailed event sent by your Hue devicem so you can use it for wh
 
 <br/>
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 <br/>
 

package/nodes/knxUltimateHueLightSensor.js

@@ -15,8 +15,8 @@ module.exports = function (RED) {
     node.initialread = true;
     node.listenallga = true; // Don't remove
     node.outputtype = 'write';
-    node.outputRBE = false; // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = false; // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = 'false'; // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = 'false'; // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = ''; // Current value for the RBE input and for the .previouspayload msg
     node.passthrough = 'no';
     node.formatmultiplyvalue = 1;

package/nodes/knxUltimateHueMotion.html

@@ -249,7 +249,7 @@ It contains the detailed event sent by your Hue devicem so you can use it for wh
 
 <br/>
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 <br/>
 

package/nodes/knxUltimateHueMotion.js

@@ -15,8 +15,8 @@ module.exports = function (RED) {
     node.initialread = true;
     node.listenallga = true; // Don't remove
     node.outputtype = "write";
-    node.outputRBE = false; // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = false; // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = 'false'; // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = 'false'; // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = ""; // Current value for the RBE input and for the .previouspayload msg
     node.passthrough = "no";
     node.formatmultiplyvalue = 1;

package/nodes/knxUltimateHueScene.html

@@ -617,7 +617,7 @@ Drag the <code>toast</code> (the icon with three lines) at the far left of a row
 
 <br/>
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 <br/>
 

package/nodes/knxUltimateHueScene.js

@@ -18,8 +18,8 @@ module.exports = function (RED) {
     node.initialread = true;
     node.listenallga = true; // Don't remove
     node.outputtype = 'write';
-    node.outputRBE = false; // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = false; // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = 'false'; // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = 'false'; // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = ''; // Current value for the RBE input and for the .previouspayload msg
     node.passthrough = 'no';
     node.formatmultiplyvalue = 1;

package/nodes/knxUltimateHueTapDial.html

@@ -256,7 +256,7 @@ It contains the detailed event sent by your Hue devicem so you can use it for wh
 
 <br/>
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 <br/>
 

package/nodes/knxUltimateHueTapDial.js

@@ -16,8 +16,8 @@ module.exports = function (RED) {
     node.initialread = true;
     node.listenallga = true; // Don't remove
     node.outputtype = 'write';
-    node.outputRBE = false; // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = false; // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = 'false'; // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = 'false'; // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = ''; // Current value for the RBE input and for the .previouspayload msg
     node.passthrough = 'no';
     node.formatmultiplyvalue = 1;

package/nodes/knxUltimateHueTemperatureSensor.html

@@ -262,7 +262,7 @@ It contains the detailed event sent by your Hue devicem so you can use it for wh
 
 <br />
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 <br />
 

package/nodes/knxUltimateHueTemperatureSensor.js

@@ -15,8 +15,8 @@ module.exports = function (RED) {
     node.initialread = true;
     node.listenallga = true; // Don't remove
     node.outputtype = 'write';
-    node.outputRBE = false; // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = false; // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = 'false'; // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = 'false'; // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = ''; // Current value for the RBE input and for the .previouspayload msg
     node.passthrough = 'no';
     node.formatmultiplyvalue = 1;

package/nodes/knxUltimateHueZigbeeConnectivity.html

@@ -260,7 +260,7 @@ you're typing.
 
 <br />
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 <br />
 

package/nodes/knxUltimateHueZigbeeConnectivity.js

@@ -15,8 +15,8 @@ module.exports = function (RED) {
     node.initialread = true;
     node.listenallga = true; // Don't remove
     node.outputtype = 'write';
-    node.outputRBE = false; // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = false; // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = 'false'; // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = 'false'; // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = ''; // Current value for the RBE input and for the .previouspayload msg
     node.passthrough = 'no';
     node.formatmultiplyvalue = 1;

package/nodes/knxUltimateLoadControl.html

@@ -417,7 +417,7 @@ msg = {
 
 <br/>
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 <br/>
 

package/nodes/knxUltimateLogger.js

@@ -1,5 +1,5 @@
 module.exports = function (RED) {
-  function knxUltimateLogger (config) {
+  function knxUltimateLogger(config) {
     RED.nodes.createNode(this, config)
     const node = this
     node.server = RED.nodes.getNode(config.server)
@@ -11,8 +11,8 @@ module.exports = function (RED) {
     node.initialread = false
     node.listenallga = true
     node.outputtype = 'write'
-    node.outputRBE = false
-    node.inputRBE = false
+    node.outputRBE = 'false'
+    node.inputRBE = 'false'
     node.currentPayload = ''
     node.topic = config.topic !== undefined ? config.topic : ''
     node.autoStartTimerCreateETSXML = config.autoStartTimerCreateETSXML !== undefined ? config.autoStartTimerCreateETSXML : true
@@ -44,7 +44,7 @@ module.exports = function (RED) {
     if (!node.server) return
 
     // 26/03/2020 Create and output the XML for ETS bus monitor
-    function createETSXML () {
+    function createETSXML() {
       let sFile = '<CommunicationLog xmlns="http://knx.org/xml/telegrams/01">\n'
       for (let index = 0; index < node.etsXMLRow.length; index++) {
         const element = node.etsXMLRow[index]
@@ -58,7 +58,7 @@ module.exports = function (RED) {
     };
 
     // 25/10/2021 Count Telegrams. Requested by RicharddeCrep https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/149#issue-1034644956
-    function countTelegrams () {
+    function countTelegrams() {
       node.send([null, { topic: node.topic, payload: node.telegramCount, countIntervalInSeconds: node.intervalTelegramCount / 1000, currentTime: new Date().toLocaleString() }])
       node.setNodeStatus({ fill: 'green', shape: 'dot', text: 'Payload Telegram counter sent.', payload: node.telegramCount, GA: '', dpt: '', devicename: '' })
       node.telegramCount = 0

package/nodes/knxUltimateViewer.html

@@ -105,7 +105,7 @@ View all group addresses and their values in a Dashboard widget.
 
 <br/>
 
-[Find it useful?](https://www.paypal.me/techtoday)
+[DONATE HERE, THANK YOU!](https://www.paypal.me/techtoday)
 
 <br/>
 </script>

package/nodes/knxUltimateViewer.js

@@ -17,8 +17,8 @@ module.exports = function (RED) {
     node.initialread = false;
     node.listenallga = true;
     node.outputtype = 'write';
-    node.outputRBE = false; // Apply or not RBE to the output (Messages coming from flow)
-    node.inputRBE = false; // Apply or not RBE to the input (Messages coming from BUS)
+    node.outputRBE = 'false'; // Apply or not RBE to the output (Messages coming from flow)
+    node.inputRBE = 'false'; // Apply or not RBE to the input (Messages coming from BUS)
     node.currentPayload = ''; // Current value for the RBE input and for the .previouspayload msg
     node.passthrough = 'no';
     node.formatmultiplyvalue = 1;

package/nodes/knxUltimateWatchDog.js

@@ -1,7 +1,7 @@
 const ping = require('ping')
 
 module.exports = function (RED) {
-  function knxUltimateWatchDog (config) {
+  function knxUltimateWatchDog(config) {
     RED.nodes.createNode(this, config)
     const node = this
     node.server = RED.nodes.getNode(config.server)
@@ -14,8 +14,8 @@ module.exports = function (RED) {
     node.initialread = false
     node.listenallga = false
     node.outputtype = 'write'
-    node.outputRBE = false
-    node.inputRBE = false
+    node.outputRBE = 'false'
+    node.inputRBE = 'false'
     node.currentPayload = ''
     node.topic = config.topic !== undefined ? config.topic : ''
     node.retryInterval = config.retryInterval !== undefined ? config.retryInterval * 1000 : 10000
@@ -46,7 +46,7 @@ module.exports = function (RED) {
 
     if (!node.server) return
 
-    function handleTheDog () {
+    function handleTheDog() {
       node.beatNumber += 1
       if (node.beatNumber > node.maxRetry) {
         // Confirmed connection error

package/nodes/utils/utils.js

@@ -0,0 +1,57 @@
+module.exports.ToBoolean = function ToBoolean(value, _configTranslationNode) {
+  let res = false;
+  let decimal = /^\s*[+-]{0,1}\s*([\d]+(\.[\d]*)*)\s*$/;
+
+  if (typeof value === "boolean") {
+    return value;
+  } else if (typeof value === "string") {
+    try {
+      let translationTable = [];
+      if (_configTranslationNode === null) {
+        translationTable = DEFAULTTRANSLATIONINPUT.split("\n");
+      } else {
+        translationTable = _configTranslationNode.commandText.split("\n");
+      }
+      for (let index = 0; index < translationTable.length; index++) {
+        let inputPayloadToBeTranslated = translationTable[index].split(":")[0];
+        let outputBoolean = Boolean(translationTable[index].split(":")[1]);
+        if (
+          value.toLowerCase() === inputPayloadToBeTranslated.toLowerCase() &&
+          inputPayloadToBeTranslated.toLowerCase() !== ""
+        ) {
+          return translationTable[index].split(":")[1] === "true"
+            ? true
+            : false;
+        }
+      }
+    } catch (error) {
+      console.log("Boolean-Logic-Ultimate:utils:toBoolean: " + error.message);
+    }
+  } else if (typeof value === "number") {
+    // Is it formated as a decimal number?
+    if (decimal.test(value)) {
+      res = parseFloat(value) != 0;
+    } else {
+      res = value.toLowerCase() === "true";
+    }
+    return res;
+  }
+};
+
+module.exports.fetchFromObject = function fetchFromObject(
+  _msg,
+  _payloadPropName
+) {
+  // The output cannot be an oblect. In case, return undefined.
+  var _index = _payloadPropName.indexOf(".");
+  if (_index > -1) {
+    return fetchFromObject(
+      _msg[_payloadPropName.substring(0, _index)],
+      _payloadPropName.substr(_index + 1)
+    );
+  }
+  if (typeof _msg[_payloadPropName] === "object") return undefined;
+  return _msg[_payloadPropName];
+};
+const DEFAULTTRANSLATIONINPUT =
+  "on:true\noff:false\nactive:true\ninactive:false\nopen:true\nclosed:false\nclose:false\n1:true\n0:false\ntrue:true\nfalse:false\nhome:true\nnot_home:false\nnormal:false\nviolated:true";

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=16.0.0"
   },
-  "version": "2.4.8",
+  "version": "2.4.10",
   "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",
@@ -44,7 +44,8 @@
       "knxUltimateHueTemperatureSensor": "/nodes/knxUltimateHueTemperatureSensor.js",
       "knxUltimateHueScene": "/nodes/knxUltimateHueScene.js",
       "knxUltimateHueBattery": "/nodes/knxUltimateHueBattery.js",
-      "knxUltimateHueZigbeeConnectivity": "/nodes/knxUltimateHueZigbeeConnectivity.js"
+      "knxUltimateHueZigbeeConnectivity": "/nodes/knxUltimateHueZigbeeConnectivity.js",
+      "knxUltimateHATranslator": "/nodes/knxUltimateHATranslator.js"
     }
   },
   "repository": {