node-red-contrib-knx-ultimate 6.4.1 → 7.0.1

package/README.md

@@ -8,6 +8,10 @@
 
 KNX Ultimate is the most advanced KNX integration for Node-RED, providing secure KNX/IP communication, routing, ETS project import, Philips Hue, Matter Controller and Matter Bridge (control matter device via KNX and expose KNX GA via Matter), MQTT, diagnostics, virtual devices, and powerful automation nodes. Build professional, reliable, and scalable smart home and building automation projects with minimal effort.
 
+
+
+The former bundled AI assistant has moved to the standalone [Cerebrum Ultimate](https://github.com/Supergiovane/node-red-contrib-cerebrum-ultimate) package. Cerebrum Ultimate now provides the conversational, learning and supervised home-intelligence features, while using KNX Ultimate as an optional compatible integration. Hidden legacy runtime types remain in this package only so existing Node-RED flows continue to load; new installations should add the Cerebrum node from the standalone package.
+
 <br/>
 <br/>
 <br/>

package/nodes/knxUltimate-config.js

@@ -1529,9 +1529,9 @@ module.exports = (RED) => {
                   }
                   _input.handleSend(msg)
                 } else if (_input.hasOwnProperty('isSceneController')) { // 19/03/2020 in the middle of coronavirus. Whole italy is red zone, closed down. Scene Controller implementation
-                // 12/08/2020 Check wether is a learn (save) command or a activate (play) command.
+                  // 12/08/2020 Check wether is a learn (save) command or a activate (play) command.
                   if (_dest === _input.topic || _dest === _input.topicSave) {
-                  // Prepare the two messages to be evaluated directly into the Scene Controller node.
+                    // Prepare the two messages to be evaluated directly into the Scene Controller node.
                     new Promise((resolve) => {
                       if (_dest === _input.topic) {
                         try {
@@ -1568,16 +1568,16 @@ module.exports = (RED) => {
                         } catch (error) { }
                       }
                       resolve(true) // fulfilled
-                    // reject("error"); // rejected
+                      // reject("error"); // rejected
                     })
                       .then(function () { })
                       .catch(function () { })
                   } else {
-                  // 19/03/2020 Check and Update value if the input is part of a scene controller
+                    // 19/03/2020 Check and Update value if the input is part of a scene controller
                     new Promise((resolve) => {
-                    // Check and update the values of each device in the scene and update the rule array accordingly.
+                      // Check and update the values of each device in the scene and update the rule array accordingly.
                       for (let i = 0; i < _input.rules.length; i++) {
-                      // rule is { topic: rowRuleTopic, devicename: rowRuleDeviceName, dpt:rowRuleDPT, send: rowRuleSend}
+                        // rule is { topic: rowRuleTopic, devicename: rowRuleDeviceName, dpt:rowRuleDPT, send: rowRuleSend}
                         const oDevice = _input.rules[i]
                         if (typeof oDevice !== 'undefined' && oDevice.topic == _dest) {
                           const msg = buildInputMessage({
@@ -1606,23 +1606,23 @@ module.exports = (RED) => {
                         }
                       }
                       resolve(true) // fulfilled
-                    // reject("error"); // rejected
+                      // reject("error"); // rejected
                     })
                       .then(function () { })
                       .catch(function () { })
                   }
                 } else if (_input.hasOwnProperty('isLogger')) {
-                // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
-                // 24/03/2021 Logger Node, i'll pass cemiETS
+                  // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
+                  // 24/03/2021 Logger Node, i'll pass cemiETS
                   if (_cemiETS !== undefined) {
-                  // new Promise((resolve, reject) => {
+                    // new Promise((resolve, reject) => {
                     _input.handleSend(_cemiETS)
-                  //    resolve(true); // fulfilled
-                  // reject("error"); // rejected
-                  // }).then(function () { }).catch(function () { });
+                    //    resolve(true); // fulfilled
+                    // reject("error"); // rejected
+                    // }).then(function () { }).catch(function () { });
                   }
                 } else if (_input.listenallga === true && universalNodeAcceptsGA(_input, _dest)) {
-                // 25/10/2019 TRY TO AUTO DECODE IF Group address not found in the CSV
+                  // 25/10/2019 TRY TO AUTO DECODE IF Group address not found in the CSV
                   const msg = buildInputMessage({
                     _srcGA: _src,
                     _destGA: _dest,
@@ -1645,8 +1645,8 @@ module.exports = (RED) => {
                   _input.handleSend(msg)
                 } else if (_input.topic == _dest) {
                   if (_input.hasOwnProperty('isWatchDog')) {
-                  // 04/02/2020 Watchdog implementation
-                  // Is a watchdog node
+                    // 04/02/2020 Watchdog implementation
+                    // Is a watchdog node
                   } else {
                     const msg = buildInputMessage({
                       _srcGA: _src,
@@ -1721,14 +1721,14 @@ module.exports = (RED) => {
                   _input.handleSend(msg)
                 } else
                 if (_input.hasOwnProperty('isLogger')) {
-                // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
-                // 24/03/2021 Logger Node, i'll pass cemiETS
+                  // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
+                  // 24/03/2021 Logger Node, i'll pass cemiETS
                   if (_cemiETS !== undefined) {
-                  // new Promise((resolve, reject) => {
+                    // new Promise((resolve, reject) => {
                     _input.handleSend(_cemiETS)
-                  //    resolve(true); // fulfilled
-                  // reject("error"); // rejected
-                  // }).then(function () { }).catch(function () { });
+                    //    resolve(true); // fulfilled
+                    // reject("error"); // rejected
+                    // }).then(function () { }).catch(function () { });
                   }
                 } else if (_input.listenallga === true && universalNodeAcceptsGA(_input, _dest)) {
                   const msg = buildInputMessage({
@@ -1752,9 +1752,9 @@ module.exports = (RED) => {
                   })
                   _input.handleSend(msg)
                 } else if (_input.topic === _dest) {
-                // 04/02/2020 Watchdog implementation
+                  // 04/02/2020 Watchdog implementation
                   if (_input.hasOwnProperty('isWatchDog')) {
-                  // Is a watchdog node
+                    // Is a watchdog node
                     _input.watchDogTimerReset()
                   } else {
                     const msg = buildInputMessage({
@@ -1827,18 +1827,18 @@ module.exports = (RED) => {
                   _input.handleSend(msg)
                 } else
                 if (_input.hasOwnProperty('isLogger')) {
-                // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
-                // node.sysLogger?.info("BANANA isLogger", _evt, _src, _dest, _rawValue, _cemiETS);
-                // 24/03/2021 Logger Node, i'll pass cemiETS
+                  // 26/03/2020 Coronavirus is slightly decreasing the affected numer of people. Logger Node
+                  // node.sysLogger?.info("BANANA isLogger", _evt, _src, _dest, _rawValue, _cemiETS);
+                  // 24/03/2021 Logger Node, i'll pass cemiETS
                   if (_cemiETS !== undefined) {
-                  // new Promise((resolve, reject) => {
+                    // new Promise((resolve, reject) => {
                     _input.handleSend(_cemiETS)
-                  //    resolve(true); // fulfilled
-                  // reject("error"); // rejected
-                  // }).then(function () { }).catch(function () { });
+                    //    resolve(true); // fulfilled
+                    // reject("error"); // rejected
+                    // }).then(function () { }).catch(function () { });
                   }
                 } else if (_input.listenallga === true && universalNodeAcceptsGA(_input, _dest)) {
-                // Read Request
+                  // Read Request
                   const msg = buildInputMessage({
                     _srcGA: _src,
                     _destGA: _dest,
@@ -1860,11 +1860,11 @@ module.exports = (RED) => {
                   })
                   _input.handleSend(msg)
                 } else if (_input.topic === _dest) {
-                // 04/02/2020 Watchdog implementation
+                  // 04/02/2020 Watchdog implementation
                   if (_input.hasOwnProperty('isWatchDog')) {
-                  // Is a watchdog node
+                    // Is a watchdog node
                   } else {
-                  // Read Request
+                    // Read Request
                     const msg = buildInputMessage({
                       _srcGA: _src,
                       _destGA: _dest,
@@ -1881,7 +1881,7 @@ module.exports = (RED) => {
                     // 24/09/2019 Autorespond to BUS
                     if (_input.hasOwnProperty('notifyreadrequestalsorespondtobus') && _input.notifyreadrequestalsorespondtobus === true) {
                       if (typeof _input.currentPayload === 'undefined' || _input.currentPayload === '' || _input.currentPayload === null) {
-                      // 14/08/2021 Added || input.currentPayload === null
+                        // 14/08/2021 Added || input.currentPayload === null
                         node.sendKNXTelegramToKNXEngine({
                           grpaddr: _dest,
                           payload: _input.notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized,
@@ -1909,8 +1909,8 @@ module.exports = (RED) => {
                         _input.setNodeStatus({
                           fill: 'blue',
                           shape: 'ring',
-                          text: 'Read & Autorespond with default',
-                          payload: _input.notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized,
+                          text: 'Read & Autorespond',
+                          payload: _input.currentPayload,
                           GA: _input.topic,
                           dpt: msg.knx.dpt,
                           devicename: ''

package/nodes/knxUltimate.js

@@ -756,7 +756,7 @@ module.exports = function (RED) {
       // #endregion
 
       // 25/07/2019 if payload is read or the Telegram type is set to "read", do a read, otherwise, write to the bus
-      if ((msg.hasOwnProperty('readstatus') && msg.readstatus === true) || node.outputtype === 'read') {
+      if ((msg.hasOwnProperty('readstatus') && msg.readstatus === true) || node.outputtype === 'read' || (msg.hasOwnProperty('event') && msg.event === 'GroupValue_Read')) {
         // READ: Send a Read request to the bus
         let grpaddr = ''
         if (node.listenallga == false) {

package/nodes/knxUltimateAI.html

@@ -467,11 +467,11 @@
 
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimateAI', {
-        category: "KNX Ultimate AI",
+        category: "KNX Ultimate (legacy)",
         color: '#FF9800',
         defaults: {
             server: { type: "knxUltimate-config", required: true },
-            name: { value: "KNX AI", required: false },
+            name: { value: "Legacy AI node", required: false },
             topic: { value: "", required: false },
 
             llmEnabled: { value: false },
@@ -509,9 +509,9 @@
         },
         icon: "node-eye-icon.svg",
         label: function () {
-            return (this.name || "KNX AI");
+            return (this.name || "Legacy AI node");
         },
-        paletteLabel: "KNX AI",
+        paletteLabel: "Legacy AI node",
         oneditprepare: function () {
             try { RED.sidebar.show("help"); } catch (error) { }
             const node = this;
@@ -1531,9 +1531,13 @@
             } catch (error) { }
         }
     })
+    // The historical type remains registered so deployed flows keep loading,
+    // but new Cerebrum nodes belong to node-red-contrib-cerebrum-ultimate.
+    try { RED.palette.remove('knxUltimateAI'); } catch (error) { }
 </script>
 
 <script type="text/html" data-template-name="knxUltimateAI">
+  <div class="form-tips" style="margin-bottom:10px;"><b>Legacy node:</b> existing flow instances remain supported. For new installations use <a href="https://github.com/Supergiovane/node-red-contrib-cerebrum-ultimate#readme" target="_blank"><b>Cerebrum Ultimate</b></a>.</div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>
@@ -1559,7 +1563,7 @@
         <label><i class="fa fa-external-link"></i> Web UI</label>
         <div style="display:flex; gap:8px; flex-wrap:wrap;">
             <button type="button" class="red-ui-button" id="knx-ai-open-web-page-vue" style="background-color:#ff9800; border-color:#ff9800; color:#ffffff !important; -webkit-text-fill-color:#ffffff;">
-                <i class="fa fa-external-link" style="color:#ffffff !important;"></i> <span style="color:#ffffff !important;">Open KNX AI Web Page</span>
+                <i class="fa fa-external-link" style="color:#ffffff !important;"></i> <span style="color:#ffffff !important;">Open Cerebrum Ultimate Web Page</span>
             </button>
         </div>
     </div>