node-red-contrib-knx-ultimate 4.1.35 → 4.2.1

package/CHANGELOG.md

@@ -6,6 +6,13 @@
 
 # CHANGELOG
 
+**Version 4.2.1** - March 2026<br/>
+
+- FIX: **KNX Hue Light** brightness writes are now applied even when the Hue light is OFF, without forcing the light to switch on.<br/>
+- FIX: **KNX Hue Light** grouped light handling: when a `grouped_light` is OFF and receives a brightness write, the node now presets supported member `light` resources first, so the brightness is ready when the group is turned on later.<br/>
+- TEST: extended **KNX Hue Light** coverage for brightness writes on OFF lights and OFF grouped lights.<br/>
+- UPDATE: KNXUltimate engine bumped to 5.4.0<br/>
+
 **Version 4.1.35** - March 2026<br/>
 
 - NEW: **KNX AI** anomalies output now always emits dedicated bus connection events when the KNX gateway connection is lost and when it is restored.<br/>

package/nodes/knxUltimateAI.js

@@ -1140,6 +1140,7 @@ module.exports = function (RED) {
     node._anomalyLifecycle = new Map()
     node._gaRateSeries = new Map()
     node._gaLabelCsvCache = { ref: null, map: {} }
+    node._busConnectionWatchTimer = null
     node._busConnectionState = (node.serverKNX && typeof node.serverKNX.linkStatus === 'string')
       ? String(node.serverKNX.linkStatus).toLowerCase()
       : 'unknown'
@@ -1150,6 +1151,7 @@ module.exports = function (RED) {
       startedAtMs: nowMs(),
       endedAtMs: 0
     }]
+    node._busConnectionWindowSec = 12 * 60 * 60
 
     // Register runtime instance for sidebar visibility
     aiRuntimeNodes.set(node.id, node)
@@ -2313,7 +2315,7 @@ module.exports = function (RED) {
     const appendBusConnectionTimeline = ({ state, atMs }) => {
       const nextState = state === 'connected' ? 'connected' : 'disconnected'
       const ts = Number.isFinite(Number(atMs)) && Number(atMs) > 0 ? Number(atMs) : nowMs()
-      const keepMs = Math.max(60, Number(node.historyWindowSec || 60)) * 4000
+      const keepMs = Math.max(12 * 60 * 60, Number(node._busConnectionWindowSec || 0)) * 2000
       if (!Array.isArray(node._busConnectionTimeline) || node._busConnectionTimeline.length === 0) {
         node._busConnectionTimeline = [{ state: nextState, startedAtMs: ts, endedAtMs: 0 }]
         return
@@ -2348,7 +2350,7 @@ module.exports = function (RED) {
     }
 
     const buildBusConnectionSummary = (now) => {
-      const windowSec = Math.max(5, Number(node.historyWindowSec || 60))
+      const windowSec = Math.max(12 * 60 * 60, Number(node._busConnectionWindowSec || 0))
       const windowMs = windowSec * 1000
       const windowStartMs = now - windowMs
       const timeline = Array.isArray(node._busConnectionTimeline) ? node._busConnectionTimeline : []
@@ -2424,7 +2426,10 @@ module.exports = function (RED) {
       if (/^Connected\./i.test(statusText)) nextState = 'connected'
       if (/^Disconnected\b/i.test(statusText)) nextState = 'disconnected'
       if (nextState === '') return
+      applyBusConnectionStateChange({ nextState, statusText })
+    }
 
+    const applyBusConnectionStateChange = ({ nextState, statusText }) => {
       const previousState = node._busConnectionState || 'unknown'
       if (previousState === nextState) return
       node._busConnectionState = nextState
@@ -2455,6 +2460,17 @@ module.exports = function (RED) {
       }
     }
 
+    const pollBusConnectionStatus = () => {
+      try {
+        const raw = String((node.serverKNX && node.serverKNX.linkStatus) ? node.serverKNX.linkStatus : '').trim().toLowerCase()
+        if (raw !== 'connected' && raw !== 'disconnected') return
+        applyBusConnectionStateChange({
+          nextState: raw,
+          statusText: `Polled gateway state: ${raw}`
+        })
+      } catch (error) { /* ignore */ }
+    }
+
     const maybeEmitOverallAnomaly = (now) => {
       const windowMs = Math.max(2, node.rateWindowSec) * 1000
       const cutoff = now - windowMs
@@ -2706,6 +2722,7 @@ module.exports = function (RED) {
     node.on('close', function (done) {
       try {
         if (node._timerEmit) clearInterval(node._timerEmit)
+        if (node._busConnectionWatchTimer) clearInterval(node._busConnectionWatchTimer)
         if (node._summaryRebuildTimer) {
           clearTimeout(node._summaryRebuildTimer)
           node._summaryRebuildTimer = null
@@ -2731,6 +2748,12 @@ module.exports = function (RED) {
       }, Math.max(5, node.emitIntervalSec) * 1000)
     }
 
+    if (node._busConnectionWatchTimer) clearInterval(node._busConnectionWatchTimer)
+    node._busConnectionWatchTimer = setInterval(() => {
+      pollBusConnectionStatus()
+    }, 1000)
+    pollBusConnectionStatus()
+
     updateStatus({ fill: 'grey', shape: 'dot', text: 'AI ready' })
   }
 

package/nodes/knxUltimateHueLight.js

@@ -160,7 +160,7 @@ module.exports = function (RED) {
       const defaultOperation = node.isGrouped_light === false ? "setLight" : "setGroupedLight";
       const isGroupedLightOff = node.isGrouped_light === true && node.currentHUEDevice?.on?.on === false;
       const stateKeys = _state && typeof _state === "object" ? Object.keys(_state) : [];
-      const presetKeys = ["color", "color_temperature", "gradient"];
+      const presetKeys = ["dimming", "color", "color_temperature", "gradient"];
       const actionableKeys = ["dimming", ...presetKeys];
       const hasActionablePayload = stateKeys.some((key) => actionableKeys.includes(key));
       const mustPresetGroupedLightChildren = isGroupedLightOff
@@ -534,14 +534,12 @@ module.exports = function (RED) {
               break;
             case config.GALightBrightness:
               msg.payload = dptlib.fromBuffer(msg.knx.rawValue, dptlib.resolve(config.dptLightBrightness));
+              if (typeof msg.payload !== "number" || Number.isNaN(msg.payload)) throw new Error("Invalid KNX brightness payload");
               state = { dimming: { brightness: msg.payload } };
-              if (node.currentHUEDevice === undefined) {
-                // Grouped light
-                state.on = { on: msg.payload > 0 };
-              } else {
-                // Light
-                if (node.currentHUEDevice.on.on === false && msg.payload > 0) state.on = { on: true };
-                if (node.currentHUEDevice.on.on === true && msg.payload === 0) state.on = { on: false };
+              if (msg.payload === 0) {
+                state.on = { on: false };
+              } else if (node.currentHUEDevice !== undefined && node.currentHUEDevice.on?.on === true) {
+                state.on = { on: true };
               }
               node.syncCurrentHUEDeviceFromKNXState(state); // Starting from v 4.1.31
               node.writeHueState(state);

package/nodes/plugins/knxUltimateAI-web-page.html

@@ -654,17 +654,36 @@
 
         #flow-wrap {
             position: relative;
-            min-height: 420px;
+            min-height: 280px;
+            height: 420px;
+            max-height: 1400px;
             padding: 12px;
             background: #ffffff;
+            overflow: auto;
+            resize: vertical;
         }
 
         #flow-svg {
             width: 100%;
+            min-height: 420px;
             height: 420px;
             display: block;
         }
 
+        .flow-resize-tip {
+            margin-left: auto;
+            color: #766f95;
+            font-size: 11px;
+            font-weight: 700;
+        }
+
+        @media (max-width: 900px) {
+            .flow-resize-tip {
+                width: 100%;
+                margin-left: 0;
+            }
+        }
+
         .viz-empty {
             position: absolute;
             inset: 0;
@@ -1178,6 +1197,8 @@
                         </label>
                         <button type="button" id="flow-clear-ga">Clear</button>
                         <button type="button" id="flow-reset-layout">Reset Layout</button>
+                        <button type="button" id="flow-reset-size">Reset Height</button>
+                        <span class="flow-resize-tip">Resize from the bottom-right corner</span>
                     </div>
                     <div class="flow-legend" id="flow-color-legend">
                         <span class="flow-legend-item"><span
@@ -1321,6 +1342,7 @@
             const $flowGaSelect = document.getElementById('flow-ga-select');
             const $flowClearGa = document.getElementById('flow-clear-ga');
             const $flowResetLayout = document.getElementById('flow-reset-layout');
+            const $flowResetSize = document.getElementById('flow-reset-size');
             const $eventPieSvg = document.getElementById('event-pie-svg');
             const $eventPieLegend = document.getElementById('event-pie-legend');
             const $anomalyPieSvg = document.getElementById('anomaly-pie-svg');
@@ -1339,16 +1361,19 @@
             let stateRequestInFlight = false;
             let lastDashboardRawData = null;
             let resizeHandle = null;
+            let flowResizeObserver = null;
             const flowFilterKey = 'knxUltimateAI:flowMapFilters';
             let flowEdgeCache = new Map();
             let flowNodeCache = new Map();
 
             // Normalize persisted filter payloads to a safe, bounded shape.
             const parseFlowFilters = (raw) => {
-                const defaults = { maxGa: 14, selectedGa: [], gaOrder: [], layoutOrder: [], edgeOrder: [] };
+                const defaults = { maxGa: 14, selectedGa: [], gaOrder: [], layoutOrder: [], edgeOrder: [], flowHeight: 420 };
                 if (!raw || typeof raw !== 'object') return defaults;
                 const maxGaNum = Number(raw.maxGa);
                 const maxGa = Number.isFinite(maxGaNum) ? Math.max(4, Math.min(60, Math.round(maxGaNum))) : defaults.maxGa;
+                const flowHeightNum = Number(raw.flowHeight);
+                const flowHeight = Number.isFinite(flowHeightNum) ? Math.max(280, Math.min(1400, Math.round(flowHeightNum))) : defaults.flowHeight;
                 const selectedGa = Array.isArray(raw.selectedGa)
                     ? Array.from(new Set(raw.selectedGa.map(x => String(x || '').trim()).filter(Boolean))).slice(0, 200)
                     : [];
@@ -1361,7 +1386,7 @@
                 const edgeOrder = Array.isArray(raw.edgeOrder)
                     ? Array.from(new Set(raw.edgeOrder.map(x => String(x || '').trim()).filter(Boolean))).slice(0, 4000)
                     : [];
-                return { maxGa, selectedGa, gaOrder, layoutOrder, edgeOrder };
+                return { maxGa, selectedGa, gaOrder, layoutOrder, edgeOrder, flowHeight };
             };
 
             // Read flow filter settings from local storage.
@@ -1386,6 +1411,23 @@
 
             let flowFilters = loadFlowFilters();
 
+            const applyFlowWrapHeight = () => {
+                if (!$flowWrap) return;
+                const desiredHeight = Number(flowFilters && flowFilters.flowHeight ? flowFilters.flowHeight : 420);
+                const nextHeight = Number.isFinite(desiredHeight) ? Math.max(280, Math.min(1400, Math.round(desiredHeight))) : 420;
+                $flowWrap.style.height = `${nextHeight}px`;
+            };
+
+            const storeFlowWrapHeight = () => {
+                if (!$flowWrap) return;
+                const measuredHeight = Math.round(Number($flowWrap.clientHeight || 0));
+                if (!Number.isFinite(measuredHeight) || measuredHeight <= 0) return;
+                const nextHeight = Math.max(280, Math.min(1400, measuredHeight));
+                if (Number(flowFilters.flowHeight || 0) === nextHeight) return;
+                flowFilters.flowHeight = nextHeight;
+                saveFlowFilters(flowFilters);
+            };
+
             // Restore the last selected KNX AI node.
             const loadStoredNode = () => {
                 try {
@@ -1863,7 +1905,7 @@
                 lines.push('Telegrams: ' + (c.telegrams || 0) + ' | Rate: ' + (c.overallRatePerSec || 0) + '/s | Echoed: ' + (c.echoed || 0) + ' | Repeat: ' + (c.repeated || 0) + ' | Unknown DPT: ' + (c.unknownDpt || 0));
                 if (s.busConnection && typeof s.busConnection === 'object') {
                     const bus = s.busConnection;
-                    lines.push('Bus connection: ' + String(bus.currentState || 'unknown') + ' | Connected: ' + Number(bus.connectedPct || 0) + '% | Disconnected: ' + Number(bus.disconnectedPct || 0) + '% over ' + Number(bus.windowSec || 0) + 's');
+                    lines.push('Bus connection: ' + String(bus.currentState || 'unknown') + ' | Connected: ' + Number(bus.connectedPct || 0) + '% | Disconnected: ' + Number(bus.disconnectedPct || 0) + '% over last ' + formatDurationCompact(bus.windowSec || 0));
                 }
 
                 if (Array.isArray(s.topGAs) && s.topGAs.length) {
@@ -3295,7 +3337,6 @@
                 const height = Math.max(baseHeight, requiredHeight);
                 $flowSvg.setAttribute('viewBox', '0 0 ' + width + ' ' + height);
                 $flowSvg.style.height = `${height}px`;
-                if ($flowWrap) $flowWrap.style.minHeight = `${height + 24}px`;
                 const usableW = Math.max(40, width - (padX * 2));
                 const usableH = Math.max(40, height - (padY * 2));
                 const stepX = cols > 1 ? (usableW / (cols - 1)) : 0;
@@ -3704,8 +3745,10 @@
 
             // Hard reset for Flow Map: clear all local caches/ordering and rebuild from fresh backend data.
             const resetFlowMapHard = async () => {
-                flowFilters = parseFlowFilters(null);
+                const preservedHeight = Number(flowFilters && flowFilters.flowHeight ? flowFilters.flowHeight : 420);
+                flowFilters = parseFlowFilters({ flowHeight: preservedHeight });
                 saveFlowFilters(flowFilters);
+                applyFlowWrapHeight();
                 flowEdgeCache = new Map();
                 flowNodeCache = new Map();
                 lastDashboardRawData = null;
@@ -3794,6 +3837,21 @@
                     }
                 });
             }
+            if ($flowResetSize) {
+                $flowResetSize.addEventListener('click', () => {
+                    flowFilters.flowHeight = 420;
+                    saveFlowFilters(flowFilters);
+                    applyFlowWrapHeight();
+                    storeFlowWrapHeight();
+                    if (lastDashboardRawData) renderDashboard(lastDashboardRawData);
+                });
+            }
+            if ($flowWrap && typeof window.ResizeObserver === 'function') {
+                flowResizeObserver = new window.ResizeObserver(() => {
+                    storeFlowWrapHeight();
+                });
+                flowResizeObserver.observe($flowWrap);
+            }
             if ($chatPresetBtns.length) {
                 $chatPresetBtns.forEach((btn) => {
                     btn.addEventListener('click', () => {
@@ -3814,6 +3872,7 @@
 
             // Bootstrap page state and start background polling.
             applyTheme(currentTheme, { rerender: false });
+            applyFlowWrapHeight();
             $auto.checked = loadAuto();
             fetchNodes(queryNodeId || loadStoredNode())
                 .then(() => resetFlowMapHard())

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "4.1.35",
+  "version": "4.2.1",
   "description": "Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, and KNX routing between interfaces. Easy to use and highly configurable.",
   "files": [
     "nodes/",
@@ -18,7 +18,7 @@
   "dependencies": {
     "dns-sync": "0.2.1",
     "js-yaml": "4.1.1",
-    "knxultimate": "5.2.11",
+    "knxultimate": "5.4.0",
     "lodash": "4.17.21",
     "node-color-log": "12.0.1",
     "ping": "0.4.4",
@@ -104,4 +104,4 @@
     "mocha": "^10.4.0",
     "marked": "^14.1.0"
   }
-}
+}