node-red-contrib-knx-ultimate 4.1.28 → 4.1.30

package/CHANGELOG.md

@@ -6,6 +6,27 @@
 
 # CHANGELOG
 
+**Version 4.1.30** - March 2026<br/>
+
+- NEW: **KNX AI** now uses a full **Web Dashboard** as the main UI, opened from the node editor via **Open Web Page** button.<br/>
+- CHANGE: removed the legacy `knxUltimateAI-sidebar-plugin` file and aligned KNX AI admin routes to the Web Dashboard workflow.<br/>
+- IMPROVE: **KNX AI Flow Map** UX/readability: stable layout reset on page open, clearer legend, active/idle direction rendering and dashboard visual refinements.<br/>
+- UI: flattened the KNX AI Web Dashboard style (removed 3D/shadow-heavy look) for a cleaner production UI.<br/>
+- Docs/help/wiki: refreshed **KNX AI** documentation in all supported languages (EN/IT/DE/FR/ES/zh-CN), updated `KNX-AI-Sidebar` pages to Web Dashboard compatibility notes, and updated docs navigation section naming/ordering.<br/>
+- FIX: **KNX AI Ask chat**: SVG answers are now rendered correctly even with multiple SVG blocks, fenced `svg/xml/html` code blocks, or entity-escaped SVG markup.<br/>
+- FIX: **KNX Hue Light**: KNX read response for brightness now returns `0` when the light is OFF and brightness status is configured to follow HUE on/off.<br/>
+- FIX: **KNX Hue Light**: ignore dimming-only cached brightness updates from Hue while light is OFF, preventing wrong KNX brightness status jumps.<br/>
+- IMPROVE: **KNX Hue Light** grouped light handling: when an ON event arrives without dimming payload, brightness is fetched from bridge snapshot before publishing KNX status.<br/>
+- TEST: extended unit coverage for the new Hue Light brightness/read/grouped-light snapshot behaviors.<br/>
+
+**Version 4.1.29** - March 2026<br/>
+
+- NEW: **KNX DateTime** node: set date/time on the KNX bus via **DPT 19.001** (DateTime) and optionally **DPT 11.001** (Date) / **DPT 10.001** (Time).<br/>
+- NEW: **KNX DateTime**: send on startup (with delay), periodic send, editor send-now button, and input-triggered send.<br/>
+- UI: **KNX DateTime**: when adding a new node, it can auto-select the first KNX Gateway with an ETS import and pre-fill coherent group addresses.<br/>
+- UI: **KNX DateTime**: auto-fill is also triggered when changing the selected KNX Gateway (it won’t override manual values).<br/>
+- i18n/help/wiki: added **KNX DateTime** help and docs pages in all supported languages, and added the node to the docs navigation.<br/>
+
 **Version 4.1.28** - February 2026<br/>
 
 - NEW: **KNX Load Control**: added **Mode** selector to disable the internal logic and use only `msg.shedding` commands (`shed`/`unshed`).<br/>

package/examples/KNX DateTime - Set Date and Time to Bus.json

@@ -0,0 +1,89 @@
+[{
+  "id": "dt_cfg_1",
+  "type": "knxUltimate-config",
+  "z": "",
+  "host": "224.0.23.12",
+  "port": "3671",
+  "physAddr": "15.15.202",
+  "suppressACKRequest": false,
+  "csv": "",
+  "KNXEthInterface": "Auto",
+  "KNXEthInterfaceManuallyInput": "",
+  "autoReconnect": "yes"
+},
+{
+  "id": "dt_inj_now",
+  "type": "inject",
+  "z": "flow_dt",
+  "name": "Send NOW",
+  "props": [
+    { "p": "payload" }
+  ],
+  "repeat": "",
+  "crontab": "",
+  "once": false,
+  "onceDelay": 0.1,
+  "topic": "",
+  "payloadType": "date",
+  "x": 150,
+  "y": 160,
+  "wires": [["dt_node"]]
+},
+{
+  "id": "dt_inj_custom",
+  "type": "inject",
+  "z": "flow_dt",
+  "name": "Send fixed ISO date",
+  "props": [
+    { "p": "payload", "v": "2026-03-02T10:00:00+01:00", "vt": "str" }
+  ],
+  "repeat": "",
+  "crontab": "",
+  "once": false,
+  "onceDelay": 0.1,
+  "topic": "",
+  "x": 170,
+  "y": 220,
+  "wires": [["dt_node"]]
+},
+{
+  "id": "dt_node",
+  "type": "knxUltimateDateTime",
+  "z": "flow_dt",
+  "server": "dt_cfg_1",
+  "name": "KNX Clock",
+  "outputtopic": "events/knx/datetime",
+  "gaDateTime": "1/7/1",
+  "nameDateTime": "Bus DateTime",
+  "dptDateTime": "19.001",
+  "gaDate": "",
+  "nameDate": "",
+  "dptDate": "11.001",
+  "gaTime": "",
+  "nameTime": "",
+  "dptTime": "10.001",
+  "sendOnDeploy": true,
+  "sendOnDeployDelay": 2,
+  "periodicSend": false,
+  "periodicSendInterval": 60,
+  "periodicSendUnit": "m",
+  "x": 420,
+  "y": 190,
+  "wires": [["dt_dbg"]]
+},
+{
+  "id": "dt_dbg",
+  "type": "debug",
+  "z": "flow_dt",
+  "name": "DateTime out",
+  "active": true,
+  "tosidebar": true,
+  "console": false,
+  "tostatus": true,
+  "complete": "true",
+  "targetType": "full",
+  "x": 640,
+  "y": 190,
+  "wires": []
+}]
+

package/nodes/knxUltimate-config.js

@@ -1412,7 +1412,9 @@ module.exports = (RED) => {
                       destination: _dest,
                       apdu: { data: _apduData, bitlength: _apduBitLength, hex: _apduHex },
                       cemi: { hex: _cemiETS },
-                      echoed: _echoed
+                      echoed: _echoed,
+                      repeated: isRepeated,
+                      repeat: isRepeated
                     },
                     knxMultiRouting: {
                       gateway: { id: node.id, name: node.name || '', physAddr: node.physAddr || '' },
@@ -1429,7 +1431,9 @@ module.exports = (RED) => {
                   knx: {
                     event: _evt,
                     destination: _dest,
-                    rawValue: _rawValue
+                    rawValue: _rawValue,
+                    repeated: isRepeated,
+                    repeat: isRepeated
                   }
                 }
                 _input.handleSend(msg)
@@ -1449,7 +1453,8 @@ module.exports = (RED) => {
                           _devicename: _input.name ? _input.name : '',
                           _outputtopic: _input.outputtopic,
                           _oNode: null,
-                          _echoed
+                          _echoed,
+                          _repeated: isRepeated
                         })
                         _input.RecallScene(msgRecall.payload, false)
                       } catch (error) { }
@@ -1465,7 +1470,8 @@ module.exports = (RED) => {
                           _devicename: _input.name || '',
                           _outputtopic: _dest,
                           _oNode: null,
-                          _echoed
+                          _echoed,
+                          _repeated: isRepeated
                         })
                         _input.SaveScene(msgSave.payload, false)
                       } catch (error) { }
@@ -1492,7 +1498,8 @@ module.exports = (RED) => {
                           _devicename: oDevice.name || '',
                           _outputtopic: oDevice.outputtopic,
                           _oNode: null,
-                          _echoed
+                          _echoed,
+                          _repeated: isRepeated
                         })
                         oDevice.currentPayload = msg.payload
                         _input.setNodeStatus({
@@ -1532,7 +1539,8 @@ module.exports = (RED) => {
                   _Rawvalue: _rawValue,
                   _outputtopic: _dest,
                   _oNode: _input,
-                  _echoed
+                  _echoed,
+                  _repeated: isRepeated
                 })
                 _input.setNodeStatus({
                   fill: 'green',
@@ -1558,7 +1566,8 @@ module.exports = (RED) => {
                     _devicename: _input.name ? _input.name : '',
                     _outputtopic: _input.outputtopic,
                     _oNode: _input,
-                    _echoed
+                    _echoed,
+                    _repeated: isRepeated
                   })
                   // Check RBE INPUT from KNX Bus, to avoid send the payload to the flow, if it's equal to the current payload
                   if (!checkRBEInputFromKNXBusAllowSend(_input, msg.payload)) {
@@ -1605,7 +1614,9 @@ module.exports = (RED) => {
                       destination: _dest,
                       apdu: { data: _apduData, bitlength: _apduBitLength, hex: _apduHex },
                       cemi: { hex: _cemiETS },
-                      echoed: _echoed
+                      echoed: _echoed,
+                      repeated: isRepeated,
+                      repeat: isRepeated
                     },
                     knxMultiRouting: {
                       gateway: { id: node.id, name: node.name || '', physAddr: node.physAddr || '' },
@@ -1634,7 +1645,8 @@ module.exports = (RED) => {
                   _Rawvalue: _rawValue,
                   _outputtopic: _dest,
                   _oNode: _input,
-                  _echoed
+                  _echoed,
+                  _repeated: isRepeated
                 })
                 _input.setNodeStatus({
                   fill: 'blue',
@@ -1661,7 +1673,8 @@ module.exports = (RED) => {
                     _devicename: _input.name ? _input.name : '',
                     _outputtopic: _input.outputtopic,
                     _oNode: _input,
-                    _echoed
+                    _echoed,
+                    _repeated: isRepeated
                   })
                   // Check RBE INPUT from KNX Bus, to avoid send the payload to the flow, if it's equal to the current payload
                   if (!checkRBEInputFromKNXBusAllowSend(_input, msg.payload)) {
@@ -1705,7 +1718,9 @@ module.exports = (RED) => {
                       destination: _dest,
                       apdu: { data: null, bitlength: 0, hex: '' },
                       cemi: { hex: _cemiETS },
-                      echoed: _echoed
+                      echoed: _echoed,
+                      repeated: isRepeated,
+                      repeat: isRepeated
                     },
                     knxMultiRouting: {
                       gateway: { id: node.id, name: node.name || '', physAddr: node.physAddr || '' },
@@ -1736,7 +1751,8 @@ module.exports = (RED) => {
                   _Rawvalue: null,
                   _outputtopic: _dest,
                   _oNode: _input,
-                  _echoed
+                  _echoed,
+                  _repeated: isRepeated
                 })
                 _input.setNodeStatus({
                   fill: 'grey',
@@ -1763,7 +1779,8 @@ module.exports = (RED) => {
                     _devicename: _input.name || '',
                     _outputtopic: _input.outputtopic,
                     _oNode: _input,
-                    _echoed
+                    _echoed,
+                    _repeated: isRepeated
                   })
                   msg.previouspayload = typeof _input.currentPayload !== 'undefined' ? _input.currentPayload : '' // 24/01/2020 Reset previous payload
                   // 24/09/2019 Autorespond to BUS
@@ -2002,7 +2019,7 @@ module.exports = (RED) => {
       }
     }
 
-    function buildInputMessage ({ _srcGA, _destGA, _event, _Rawvalue, _inputDpt, _devicename, _outputtopic, _oNode, _echoed = false }) {
+    function buildInputMessage ({ _srcGA, _destGA, _event, _Rawvalue, _inputDpt, _devicename, _outputtopic, _oNode, _echoed = false, _repeated = false }) {
       let sPayloadmeasureunit = 'unknown'
       let sDptdesc = 'unknown'
       let sPayloadsubtypevalue = 'unknown'
@@ -2054,13 +2071,17 @@ module.exports = (RED) => {
         devicename: typeof _devicename !== 'undefined' ? _devicename : '',
         payloadmeasureunit: '',
         payloadsubtypevalue: '',
+        repeated: _repeated === true,
+        repeat: _repeated === true,
         knx: {
           event: _event,
           dpt: 'unknown',
           dptdesc: '',
           source: _srcGA,
           destination: _destGA,
-          rawValue: _Rawvalue
+          rawValue: _Rawvalue,
+          repeated: _repeated === true,
+          repeat: _repeated === true
         }
       }
 
@@ -2197,13 +2218,17 @@ module.exports = (RED) => {
           payloadsubtypevalue: sPayloadsubtypevalue,
           gainfo,
           echoed: _echoed,
+          repeated: _repeated === true,
+          repeat: _repeated === true,
           knx: {
             event: _event,
             dpt: sInputDpt,
             dptdesc: sDptdesc,
             source: _srcGA,
             destination: _destGA,
-            rawValue: _Rawvalue
+            rawValue: _Rawvalue,
+            repeated: _repeated === true,
+            repeat: _repeated === true
           }
         }
         // 11/11/2021 jsValue is null, as well as _Rawvalue, in case of READ REQUEST message.

package/nodes/knxUltimateAI.html

@@ -13,11 +13,11 @@
             notifyresponse: { value: true },
             notifywrite: { value: true },
 
-            analysisWindowSec: { value: 60, required: true, validate: RED.validators.number() },
-            historyWindowSec: { value: 300, required: true, validate: RED.validators.number() },
+            analysisWindowSec: { value: 120, required: true, validate: RED.validators.number() },
+            historyWindowSec: { value: 600, required: true, validate: RED.validators.number() },
             emitIntervalSec: { value: 0, required: true, validate: RED.validators.number() },
             topN: { value: 10, required: true, validate: RED.validators.number() },
-            maxEvents: { value: 5000, required: true, validate: RED.validators.number() },
+            maxEvents: { value: 50000, required: true, validate: RED.validators.number() },
 
             rateWindowSec: { value: 10, required: true, validate: RED.validators.number() },
             maxTelegramPerSecOverall: { value: 0, required: true, validate: RED.validators.number() },
@@ -33,7 +33,7 @@
             llmEnabled: { value: false },
             llmProvider: { value: "openai_compat" },
             llmBaseUrl: { value: "https://api.openai.com/v1/chat/completions" },
-            llmModel: { value: "gpt-4o-mini" },
+            llmModel: { value: "gpt-5.4" },
             llmSystemPrompt: { value: "" },
             llmTemperature: { value: 0.2, required: false, validate: RED.validators.number() },
             llmMaxTokens: { value: 600, required: false, validate: RED.validators.number() },
@@ -43,7 +43,7 @@
             llmIncludeFlowContext: { value: true },
             llmMaxFlowNodesInPrompt: { value: 80, required: false, validate: RED.validators.number() },
             llmIncludeDocsSnippets: { value: true },
-            llmDocsLanguage: { value: "it" },
+            llmDocsLanguage: { value: "en" },
             llmDocsMaxSnippets: { value: 5, required: false, validate: RED.validators.number() },
             llmDocsMaxChars: { value: 3000, required: false, validate: RED.validators.number() }
         },
@@ -100,6 +100,13 @@
 
             const nodeId = this.id;
 
+            $("#knx-ai-open-web-page").on("click", function (evt) {
+                evt.preventDefault();
+                const target = "knxUltimateAI/sidebar/page" + (nodeId ? ("?nodeId=" + encodeURIComponent(nodeId)) : "");
+                const wnd = window.open(target, "_blank", "noopener,noreferrer");
+                try { if (wnd && typeof wnd.focus === "function") wnd.focus(); } catch (e) { }
+            });
+
             const setModelsStatus = (text, level) => {
                 const $status = $("#knx-ai-models-status");
                 if (!$status || $status.length === 0) return;
@@ -190,6 +197,12 @@
         <label for="node-input-topic"><i class="fa fa-tasks"></i> <span data-i18n="knxUltimateAI.properties.topic"></span></label>
         <input type="text" id="node-input-topic" data-i18n="[placeholder]knxUltimateAI.properties.topic">
     </div>
+    <div class="form-row">
+        <label><i class="fa fa-external-link"></i> Web UI</label>
+        <button type="button" class="red-ui-button" id="knx-ai-open-web-page" style="background-color:#AD9EFF; border-color:#AD9EFF; color:#ffffff !important; -webkit-text-fill-color:#ffffff;">
+            <i class="fa fa-magic" style="color:#2b1f4d !important;"></i> <span style="color:#2b1f4d !important;">Open KNX AI Web</span>
+        </button>
+    </div>
 
     <div id="knx-ai-accordion">
         <h3><span data-i18n="knxUltimateAI.sections.capture"></span></h3>