node-red-contrib-knx-ultimate 2.4.18 → 2.4.20

package/CHANGELOG.md

@@ -6,6 +6,14 @@
 
 # CHANGELOG
 
+**Version 2.4.20** - April 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/>
+- DPT9: auto transform a string value, to a numeric value.<br/>
+
+**Version 2.4.19** - April 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/>
+- Start adding youtube lessons and tutorials and linking it with the nodes.<br/>
+
 **Version 2.4.18** - April 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 some backward compatibility glitches in the KNX-Device's UI.<br/>

package/KNXEngine/CHANGELOG.md

@@ -6,11 +6,15 @@
 
 # CHANGELOG
 
+
+<p>
+<b>Version 1.0.49</b> - April 2024<br/>
+- DPT9: auto transform a string value, to a numeric value.<br/>
+</p>
 <p>
 <b>Version 1.0.48</b> - February 2024<br/>
 - Maintenance release.<br/>
 </p>
-
 <p>
 <b>Version 1.0.47</b> - January 2024<br/>
 - NEW: added DPT 275.100.<br/>

package/KNXEngine/package.json

@@ -1,7 +1,7 @@
 {
   "name": "knxultimate",
   "description": "KNX IP protocol implementation for Node. This is the ENGINE of Node-Red KNX-Ultimate node.",
-  "version": "1.0.48",
+  "version": "1.0.49",
   "engines": {
     "node": ">=14"
   },

package/KNXEngine/src/dptlib/dpt9.js

@@ -36,8 +36,9 @@ function frexp(value) {
 exports.formatAPDU = function (value) {
   const apdu_data = Buffer.alloc(2)
   if (!isFinite(value)) {
-    knxLog.get().warn('DPT9: cannot write non-numeric or undefined value')
+    knxLog.get().error('DPT9: cannot write non-numeric or undefined value');
   } else {
+    value = Number(value); // Sometime a number is passed as string.
     value = value.toFixed(2); // Fix issue with float having too many decimals.
     const arr = frexp(value)
     const mantissa = arr[0]; const exponent = arr[1]

package/README.md

@@ -13,9 +13,13 @@
 
 ![Sample Node](img/readmemain.png)
 
-Control your KNX intallation via Node-Red!<br/>
-A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer.<br/>
-Easy to use and highly configurable.
+
+<p align='center'>
+<img width="110px" src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/KNX_CERTI_MARK_RGB.jpg" ></br>
+<span style="font-size:0.7em;color:grey;">Authorized KNX logo by KNX Association*</span>
+</p>
+
+</br>
 
 **You can use it immediately!**
 
@@ -40,42 +44,30 @@ msg.payload = {red:255, green:200, blue:30} // Put some colors in our life
 * **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.
 * **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>
 <br>
 
 ## CHANGELOG
 
 * See <a href="https://github.com/Supergiovane/node-red-contrib-knx-ultimate/blob/master/CHANGELOG.md">here the changelog</a>
 
-<br>
-<br>
-
-## VOLUNTEER NEEDED FOR KNX SECURE
-
-**************************************************
-KNX-Secure is under development.<br/>
-I need volunteer helping in development of KNX Secure.<br/>
-High knowledge of cryptography and KNX is needed.
-**************************************************
-
-<br>
-<br>
-
-
-
+<br/>
 
-## HELP, SAMPLES, TROUBLESHOOT, WIKI, FAQ, BEST PRACTICES
+## LESSONS FROM BEGINNER TO CERTIFIED KNX-ULTIMATE GURU STATUS
 
-<a href="https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/Overview"><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/wiki/flags/usa-today.png"/></a>
+* <a href="https://youtu.be/4rjrMqszhP8" target="_blank">Lesson 01 - Introduction to KNX Device<br/>
+<img width="200px" src="https://img.youtube.com/vi/4rjrMqszhP8/0.jpg" ></a>
 
+* <a href="https://youtu.be/sRW5sHPnYi0" target="_blank">Lesson 02 - Working with ETS file importer<br/>
+<img width="200px" src="https://img.youtube.com/vi/sRW5sHPnYi0/0.jpg" ></a>
 
-> Tons of documentation, samples, even for use in conjunction with <img width="90px" src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/homekit.png" > <img width="70px" src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/alexa.png" > <img width="90px" src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/googleassistant.png" >
 
+[More to come...](https://github.com/Supergiovane/node-red-contrib-knx-ultimate)
 
 
+<br/>
+<br/>
 
-## STARTER PACK
+## DOCUMENTATION
 
 * [Wiki and Help](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki)
 * [Youtube channel](https://www.youtube.com/playlist?list=PL9Yh1bjbLAYpfy1Auz6CKDfXUusgMwOQr)
@@ -127,11 +119,6 @@ The Node protects you, from mistakes you can do. [Node Protections](https://gith
 
 You can select to activate or deactivate it. If active, the node reacts only if payload from KNX Bus or from input msg is changed.
 
-</details>
-<details><summary>Automatic KNX interface type detection</summary>
-
-Full support for IP Interfaces as well for IP Routers. It's recommended the use of IP Routers because of simple setup and stability in a large environment.
-
 </details>
 <details><summary>RAW message directly to the BUS</summary>
 
@@ -144,9 +131,10 @@ You can send RAW buffers directly to the bus.
 ## WORKING WITH THE ETS CSV FILE OR WITH ESF FILE
 
 Instead of create a knx-ultimate node for each Group Address to control, you can import your ETS csv or esf group addresses file.  
-Thanks to that, the knx-ultimate node where you selected **Universal mode (listen to all Group Addresses)**, becomes an universal input/output node, aware of all Datapoints, Group Addresses and Device's name (ex: Living Room Lamp). Just send the payload to the knx-ultimate node, and it'll encode it with the right datapoint and send it to the bus. Likewise, when the knx-ultimate node receives a telegram from the bus, it outputs a right decoded payload using the datapoint specified in the ETS file.
+Thanks to that, the knx-ultimate node where you selected **Universal mode (listen to all Group Addresses)**, becomes an universal input/output node, aware of all Datapoints, Group Addresses and Device's name (ex: Living Room Lamp). Just send the payload to the knx-ultimate node, and it'll encode it with the right datapoint and send it to the bus. Likewise, when the knx-ultimate node receives a telegram from the bus, it outputs a right decoded payload using the datapoint specified in the ETS file.  
+
 
-<details><summary>Sample ETS csv file to paste into the ETS field of your config node.</summary>
+<details><summary>Click here for a sample ETS csv file to paste into the ETS field of your config node.</summary>
 
 > Copy/Paste this into your configuration node.
 
@@ -185,7 +173,7 @@ Thanks to that, the knx-ultimate node where you selected **Universal mode (liste
 </details>
 
 
-<details><summary>Sample ETS esf file to paste into the ETS field of your config node.</summary>
+<details><summary>Click here for a sample ETS esf file to paste into the ETS field of your config node.</summary>
 
 > Copy/Paste this into your configuration node.
 
@@ -221,54 +209,13 @@ Attuatori luci.Luci primo piano.0/0/21	LED cambiacolori RGB scala	EIS 1 'Switchi
 
 </details>
 
-> You can work with a mix of knx-ultimate nodes, some with **Universal mode (listen to all Group Addresses)** checked and some not. You are absolutely free! See this youtube video,
+<br/>
 
 <a href="https://youtu.be/egRbR_KwP9I" target="_blank"><img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/yt.png' width='60%'></a>
 
 <br/>
 
 
-# <a href="https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki">Click here for comprehensive samples</a>
-**Turn on/off a Lamp**
-
-```javascript
-
-return {payload:true}
-
-```
-
-```javascript
-
-return {payload:false}
-
-```
-
-**Increase the light/open blind**
-
-```javascript
-
-// The parameter "data" indicates the relative amount of the dimming commmand (how much to dim).
-// The parameter "data" can be any integer value from 0 to 7
-// The parameter decr_incr:1 increases the light
-// The parameter decr_incr:0 decreases the light
-msg.payload = {decr_incr: 1, data: 5};
-return msg;
-
-```
-
-**Set RGBW color**
-
-```javascript
-
-// Each color in a range between 0 and 255
-msg.payload = {red:90, green:200, blue:30, white:120, mR:1, mG:1, mB:1, mW:1};
-return msg;
-
-```
-
---> [MORE Samples and documentation....](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki)
-
-<br/>
 
 
 ## COMMERCIAL COMPANIES USING KNX-ULTIMATE
@@ -357,6 +304,12 @@ A big THANK YOU to [@svenflender](https://github.com/svenflender) for the logo a
 <br/>
 
 ![Logo](https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/wiki/flags/madeinitaly.png)
+<p align='left'>
+<img width="110px" src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/KNX_CERTI_MARK_RGB.jpg" ></br>
+Authorized KNX logo by KNX Association</br>
+*<i>The author <b>Massimo Saccani</b> has been authorized to use the KNX logo.
+<br/>Forks of the knx-ultimate node are not implicitly allowed to use the KNX logo.</i>
+</p>
 
 [license-image]: https://img.shields.io/badge/license-MIT-blue.svg
 [license-url]: https://github.com/Supergiovane/node-red-contrib-knx-ultimate/master/LICENSE

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=16.0.0"
   },
-  "version": "2.4.18",
+  "version": "2.4.20",
   "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/RBEtrueFalse.json

@@ -1,55 +0,0 @@
-[
-    {
-        "id": "bbc41a15b589edd3",
-        "type": "knxUltimate",
-        "z": "a108904.7aa037",
-        "server": "a01c5d80.1bbb78",
-        "topic": "3/1/18",
-        "outputtopic": "",
-        "dpt": "1.009",
-        "initialread": false,
-        "notifyreadrequest": false,
-        "notifyresponse": false,
-        "notifywrite": true,
-        "notifyreadrequestalsorespondtobus": false,
-        "notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized": "",
-        "listenallga": false,
-        "name": "Porta REI apri/chiudi [ON/OFF]",
-        "outputtype": "write",
-        "outputRBE": true,
-        "inputRBE": true,
-        "formatmultiplyvalue": "1",
-        "formatnegativevalue": "leave",
-        "formatdecimalsvalue": "999",
-        "passthrough": "no",
-        "x": 700,
-        "y": 1580,
-        "wires": [
-            []
-        ]
-    }
-]
-
-
-[
-    {
-        "id": "48937ee6.d1bac",
-        "type": "knxUltimate",
-        "z": "10f01cd3.a2c053",
-        "server": "a01c5d80.1bbb78",
-        "topic": "0/1/0",
-        "dpt": "1.001",
-        "initialread": false,
-        "notifyreadrequest": false,
-        "notifyresponse": false,
-        "notifywrite": true,
-        "listenallga": false,
-        "name": "Corridoio e scala luce",
-        "outputtype": "write",
-        "x": 900,
-        "y": 2980,
-        "wires": [
-            []
-        ]
-    }
-]