node-red-contrib-knx-ultimate

Version:

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.

github.com/Supergiovane/node-red-contrib-knx-ultimate

Supergiovane/node-red-contrib-knx-ultimate

760 lines (488 loc) • 140 kB

Markdown

![Sample Node](img/logo.png) [![Donate via PayPal](https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/CodiceQR.png)](https://www.paypal.com/donate/?hosted_button_id=S8SKPUBSPK758) # CHANGELOG **Version 4.3.3** - April 2026 - UI: in the **KNX Function helper**, the **Search GA** field is now always visible; if the ETS CSV is not imported, the field is disabled and shows `To enable the search, IMPORT THE ETS FILE`. - In the KNX DEVICE NODE, added the "toggle with status" function snippet. **Version 4.3.2** - April 2026 - Docs/help/wiki: updated **KNX AI** help HTML and wiki pages in all supported languages (EN/IT/DE/FR/ES/zh-CN) to reflect the latest LLM/Ollama UX changes. - Docs/help/wiki: documented the new **Ollama quick setup** flow (**Download model** -> **Install it**). - Docs/help/wiki: clarified that the **LLM Assistant** tab is shown first in the KNX AI editor for faster setup. **Version 4.3.1** - April 2026 - Bumped KNXEngine to 5.5.2 - UI: **KNX AI Web** now always opens on the first menu item (**Overview**). - FIX: **KNX AI Web Assistant** preset prompts now send the exact current button text to the AI request, so localized UI labels are used directly (no forced English fallback). **Version 4.3.0** - April 2026 - Bumped KNXEngine to 5.5.1 **Version 4.2.14** - April 2026 - FIX: **KNX Logger** XML download now works also with Node-RED authentication enabled by appending the active editor `access_token` and respecting `httpAdminRoot` when opening the download URL. - FIX: **KNX Logger** admin download route now normalizes `access_token` from query into `Authorization: Bearer ...` before permission checks, then removes it from query parameters to avoid auth conflicts. - FIX: resolved authenticated XML export failures (`401 Unauthorized`) reported in issue #502. **Version 4.2.13** - April 2026 - FIX: **KNX AI Web** hardened authenticated requests by always attaching Bearer auth on API/audio calls (query token or Node-RED stored editor token fallback), preventing silent audio failures in authenticated sessions. - FIX: **KNX AI Tests** now validates audio responses (`audio/*`) and reports auth/session issues explicitly instead of failing silently when HTML/login pages are returned. - NEW: **KNX AI Tests** now announces test completion by voice at the end of the test run (single and repeat-stop end states). - UI: **KNX AI Tests** added a blocking wait popup while building a Test Plan from the template builder, aligned with the existing AI Areas wait overlay behavior. - i18n: normalized **Duplicate / Duplicate Plan** action labels to imperative form across supported UI languages for consistency in the Tests page. **Version 4.2.12** - April 2026 - FIX: **KNX AI Web** and **KNX Viewer Web** admin routes now normalize `access_token` auth safely by mapping query token to `Authorization: Bearer ...` only when missing, then removing `access_token` from `req.query` before permission checks. - FIX: resolved intermittent `400 Bad Request` on authenticated web pages caused by duplicate bearer token sources (header + query string). - CHANGE: extracted shared auth normalization helper to `nodes/utils/httpAdminAccessToken.js` to keep AI/Viewer behavior aligned and easier to maintain. **Version 4.2.11** - April 2026 - UI: **KNX AI Web** improved assistant workflow with chat-style layout (prompt input under messages), clearer prompt focus, and streamlined Ask page text. - UI: **KNX AI Web** added clearer loading feedback for AI operations (area regeneration/deletion and planner generation), including a centered blocking wait overlay during long-running area generation. - NEW: **KNX AI Web** added bulk action **Delete AI Areas** and localized labels for **Regenerate AI Areas** / **Delete AI Areas** across supported UI languages. - FIX: **KNX AI backend** hardened JSON extraction/parsing for LLM outputs and improved timeout/token-limit diagnostics in error messages. - CHANGE: **KNX AI backend** raised default/forced `llmMaxTokens` handling for structured responses and aligned editor defaults for high-token completions. - Docs/wiki: improved **KNX AI Dashboard** pages for end users, added localized guidance updates, and made support CTA links visible in docs navigation. **Version 4.2.10** - April 2026 - UI: **KNX AI Web** sidebar menu style aligned to Homebridge (font size/weight, spacing, icon/text alignment and sidebar widths) for closer visual consistency. - UI: **KNX AI Web** removed sidebar menu subtitles to keep navigation labels clean and compact. - UI: **KNX AI Web** **Assistant** tab: the **Ask** panel is now half-page width on desktop and full width on smaller screens. **Version 4.2.7** - April 2026 - UI: **KNX AI Web** layout and visual style aligned to the Homebridge-like interface, with unified orange accent palette and cleaned component styling. - CHANGE: **KNX AI Web** removed legacy theme management and related theme files, keeping a single coherent visual theme. - UI: **KNX AI Web** navigation/workspace refactor: dedicated pages for **Settings** and **Test Results**, plus improved menu structure and labels. - NEW: **KNX AI Web** **Settings** now includes split tabs (**KNX AI Node** and **Import / Export**) and moved node selection/auto-refresh controls into the dedicated node settings panel. - NEW: **KNX AI Web** **Test Results** can now be exported to **PDF** directly from the selected report. - FIX: **KNX AI Web** area editor unsaved-changes detection no longer prompts discard/stay immediately after saving a newly created area and pressing **Close**. **Version 4.2.5** - March 2026 - NEW: added the **KNX Flow Bubbles** editor plugin to visualize live KNX Device state directly on the workspace. - FIX: **KNX Flow Bubbles** are now removed correctly when disabled, and their visibility is evaluated per linked **KNX Gateway** config-node instead of globally. - UI: **KNX Flow Bubbles** shell is now fully round for a cleaner visual appearance. - Docs/help/wiki: documented the **Enable flow bubbles plugin** option in the gateway editor and supported documentation languages. - Docs: removed obsolete references to **Echo sent message to all node with same Group Address** and aligned the text with the current automatic local mirroring behavior. **Version 4.2.4** - March 2026 - NEW: **KNX Viewer Web** added a new Vue-based web page, opened directly from the **KNXViewer** node editor, to visualize KNX lights and dimmers in a modern dashboard. - UI: **KNX Viewer Web** uses a visual style aligned with **KNX AI**, including live light/dimmer cards, search, node selection and auto-refresh. - IMPROVE: **KNX Viewer Web** ON lights now use a much stronger yellow highlight for clearer visual feedback. - CHANGE: package build/publish flow now also includes the **KNX Viewer Web** Vue bundle. **Version 4.2.3** - March 2026 - IMPROVE: **KNX AI Flow Map** added a new toggle to show or hide `knxUltimate` nodes running in **Universal Mode**; they are now hidden by default to keep the topology cleaner. **Version 4.2.2** - March 2026 - CHANGE: **KNX AI Web Page** is now the official Vue-based dashboard served from `/knxUltimateAI/sidebar/page`. - CHANGE: removed the old **KNX AI** legacy web page and its dedicated editor button, keeping the Vue preview as the only web UI entrypoint. - IMPROVE: **KNX AI Flow Map** in the Vue dashboard: wider layout, fullscreen toggle, animated/dashed traffic arrows, refined marker sizing and better panel width usage. **Version 4.2.1** - March 2026 - FIX: **KNX Hue Light** brightness writes are now applied even when the Hue light is OFF, without forcing the light to switch on. - 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. - TEST: extended **KNX Hue Light** coverage for brightness writes on OFF lights and OFF grouped lights. - UPDATE: KNXUltimate engine bumped to 5.4.0 **Version 4.1.35** - March 2026 - NEW: **KNX AI** anomalies output now always emits dedicated bus connection events when the KNX gateway connection is lost and when it is restored. - NEW: **KNX AI Web Dashboard** added a bus connection persistence section with a green/red time bar showing connected/disconnected periods over the history window. **Version 4.1.34** - March 2026 - FIX: **KNX Hue Light** grouped light handling: when a `grouped_light` is OFF and receives color / color temperature / gradient commands, the node now presets supported member `light` resources first and only then turns the group ON, so all lamps can inherit the requested state more reliably. - DEBUG: **KNX Hue Light** added debug traces for the new grouped-light preset-before-ON sequence. **Version 4.1.33** - March 2026 - FIX: **KNX Hue Light** grouped light handling: when a `grouped_light` is OFF, writes for dimming, color temperature, color/xy and related dynamic updates are now fanned out to the member `light` resources when needed, instead of relying only on the grouped resource. - CHANGE: **KNX Hue Light** advanced option **Update local cached Hue state from KNX bus writes** is now enabled by default for new nodes. - UI/help/wiki/docs: clarified the tradeoff of the local Hue cache synchronization option in the editor, node help and documentation pages across supported languages. **Version 4.1.32** - March 2026 - KNX Engine bumped to 5.2.11. **Version 4.1.31** - March 2026 - NEW: **KNX Hue Light**: added advanced option **Update local cached Hue state from KNX bus writes** to keep the node local Hue cache aligned immediately on KNX write telegrams, without waiting for Hue bridge feedback. - UI: **KNX Hue Light**: the new advanced checkbox now restores and persists reliably when reopening/saving the node editor. - Docs/help/wiki: updated **KNX Hue Light** help and documentation in all supported languages (EN/IT/DE/FR/ES/zh-CN, including generated `*-zh-CN-*` wiki variants). - TEST: extended unit coverage for the optional KNX-write local cache synchronization behaviour. **Version 4.1.30** - March 2026 - NEW: **KNX AI** now uses a full **Web Dashboard** as the main UI, opened from the node editor via **Open Web Page** button. - CHANGE: removed the legacy `knxUltimateAI-sidebar-plugin` file and aligned KNX AI admin routes to the Web Dashboard workflow. - IMPROVE: **KNX AI Flow Map** UX/readability: stable layout reset on page open, clearer legend, active/idle direction rendering and dashboard visual refinements. - UI: flattened the KNX AI Web Dashboard style (removed 3D/shadow-heavy look) for a cleaner production UI. - 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. - 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. - 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. - FIX: **KNX Hue Light**: ignore dimming-only cached brightness updates from Hue while light is OFF, preventing wrong KNX brightness status jumps. - 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. - TEST: extended unit coverage for the new Hue Light brightness/read/grouped-light snapshot behaviors. **Version 4.1.29** - March 2026 - 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). - NEW: **KNX DateTime**: send on startup (with delay), periodic send, editor send-now button, and input-triggered send. - 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. - UI: **KNX DateTime**: auto-fill is also triggered when changing the selected KNX Gateway (it won’t override manual values). - i18n/help/wiki: added **KNX DateTime** help and docs pages in all supported languages, and added the node to the docs navigation. **Version 4.1.28** - February 2026 - NEW: **KNX Load Control**: added **Mode** selector to disable the internal logic and use only `msg.shedding` commands (`shed`/`unshed`). - UI/Docs/help/wiki: updated **KNX Load Control** editor, help and docs pages in all supported languages. **Version 4.1.27** - February 2026 - Bumped KNX Engine to 5.2.8 **Version 4.1.26** - February 2026 - i18n: **KNX AI** sidebar tab: localized the Summary and UI strings in all supported languages (including output pin labels). **Version 4.1.25** - February 2026 - FIX: **KNX Device**: periodic send (cyclic write) now also works when the value is restored from the persisted GA cache after a Node-RED restart. **Version 4.1.24** - February 2026 - Cleanup: removed unused dependencies (`binary-parser`, `crypto-js`, `xml2js`) and the redundant `path` polyfill. - Cleanup: removed `mkdirp` and switched to `fs.mkdirSync(..., { recursive: true })` for directory creation. **Version 4.1.23** - February 2026 - CHANGE: **KNX Gateway config**: persisted GA cache is no longer deleted automatically when opening the editor. - NEW: **KNX Gateway config**: added an explicit **Clear persisted GA cache** button in the Utility tab. - NEW: **KNX Device**: added **Periodic send stored value** option (cyclic write) with configurable interval (disabled in Universal mode). - UI: **KNX Gateway config**: added a **Node Status** section label above status-related options. - i18n: unified manual button labels across locales: **KNX Read** and **Toggle boolean**. - Docs/help/wiki: updated Gateway configuration and Device pages in all supported languages to document the new options. **Version 4.1.22** - February 2026 - NEW: **KNX Multi Routing**: added KNX routing counter (hop count) handling to prevent telegram loops: optional **Respect routing counter (drop if 0)** and **Decrement routing counter when routing**. - FIX: **KNX Multi Routing**: improved behaviour with rewritten telegrams by relying on coherent cEMI; `knx.routingCounter` is exposed based on `knx.cemi.hex`. - CHANGE: **KNX Router Filter**: cEMI consistency is now always enforced when rewriting `knx.source`/`knx.destination` (updates `knx.cemi.hex` accordingly; removed the related toggle option). - CHANGE: **KNX Router Filter**: added `cemiSynced` metadata on passed messages (`msg.payload.knxRouterFilter.cemiSynced`). - NEW: **KNX Router Filter**: runtime configuration via `msg.setConfig` (all node parameters), retained until next `msg.setConfig` or redeploy/restart; config messages are not forwarded. - IMPROVE: **KNX Multi Routing Server KNX/IP**: better status/diagnostics and docs note about **Advertise host** for clients that show “connected” but the server receives no telegrams (multi-homed/Docker/VM). - Docs/help/wiki: updated **KNX Multi Routing** and **KNX Router Filter** pages in all supported languages to document routing counter, rewrite+cEMI sync behaviour, and `msg.setConfig` usage (with examples). **Version 4.1.19** - February 2026 - NEW: **KNX Multi Routing**: added **Server KNX/IP** mode (standalone KNXnet/IP tunneling server) that outputs/accepts RAW telegrams on the node ports (no gateway required). - NEW: KNX AI sidebar: added another TAB in the Node-Red's toolbar buttons dedicated to AI analysis. - NEW: added **KNX AI** node (traffic analyzer + optional LLM assistant) and **KNX AI** sidebar tab. - NEW: added **KNX Multi Routing** node to bridge multiple `knxUltimate-config` gateways via Node-RED (RAW telegram forwarding + source/destination metadata). - NEW: added **KNX Router Filter** node to filter routed RAW telegrams (event type + GA/source patterns + loop prevention). - CHANGE: `knxUltimateAI` LLM: enabled extra context by default (Flow inventory + documentation snippets) to improve answer quality; both can be disabled in the node settings. - NEW: `knxUltimateAI` LLM: added documentation snippets retrieval from built-in help/README/examples (and `docs/wiki` when available in the local install) to help the assistant explain node behaviour and configuration. - IMPROVE: KNX AI sidebar chat: improved Markdown rendering (including tables), for better readability of AI answers. - Docs: completed the help + wiki pages for **KNX AI**, **KNX Multi Routing** and **KNX Router Filter** in all supported languages, and added them to the docs homepages. - Docs: added the new nodes to the wiki navbar in all languages (so they appear in the left navigation menu). - Docs: added new wiki **Samples** pages (with diagrams) for the 3 new nodes. - Examples: added importable Node-RED flow JSON examples for **KNX AI**, **KNX Multi Routing** and **KNX Router Filter** (including KNX Multi Routing **Server KNX/IP** sample). **Version 4.1.15** - January 2026 - KNX Engine bump to 5.2.4 **Version 4.1.14** - January 2026 - FIX: HueEngine reconnect: improved recovery after network link drops (stale sockets), with forced HTTPS agent reset + HTTP timeouts + SSE connect timeout to prevent “stuck” connections. - CHANGE: HueEngine ping interval set to 90 seconds for faster disconnect detection. - FIX: Hue Button editor: typedInput/checkbox values now persist and restore reliably (`toggleValues`, `switchSend`, `dimSend`). - FIX: Hue Button runtime: node status now updates on every valid Hue event (even after reconnect / without KNX GA configured). - FIX: Hue config: guarded client status updates so UI/status errors cannot crash Node-RED. **Version 4.1.12** - January 2026 - FIX: Hue HTTP layer: avoid unhandled errors that could stall the shared Hue command queue when a Hue device/resource is missing (e.g. deleted from the bridge), so other Hue nodes keep working. - Docs: added dedicated wiki pages for the Node-RED sidebar tabs **KNX Monitor** and **KNX Debug** (with screenshots) in all supported languages, plus a dedicated navbar section. - Cleanup: removed the unused `HomeAssistantImporter-sidebar-plugin` stub. **Version 4.1.10** - January 2026 - NEW: KNX Gateway config: added a **Status date/time format** setting (ISO / ISO no seconds / Custom tokens / Legacy) to avoid relying on the underlying OS locale (useful for Home Assistant OS). - Updated node status timestamp rendering across KNX Ultimate nodes to use the configured format, with safe fallbacks to prevent editor/runtime crashes. - Docs/help: updated the Gateway configuration help + wiki pages in all languages to document the new options. **Version 4.1.9** - December 2025 - NEW: added **Hue Motion Area** node for Philips Hue Bridge Pro MotionAware areas, exposing aggregated motion state from Hue `convenience_area_motion` and `security_area_motion` services to KNX or Node-RED flows. - Hue config: extended the internal resource browser to resolve MotionAware area services against their `motion_area_configuration`, showing friendly area names and linked rooms/zones in the editor device picker. **Version 4.1.8** - December 2025 - Logger node editor: when **Action** is set to `Emit payload only`, the file path row is now completely hidden (instead of just disabled), using a dedicated row id for better future Node-RED compatibility. - Logger node editor: added a **Download** button next to the file path. - Logger node: updated labels, help and wiki pages in all languages to explain both the **payload interval** and **Max rows** behaviour, including how the XML/file is **rotated** when the configured row limit is reached. **Version 4.1.7** - December 2025 - Logger node: replaced the checkbox with an explicit **Action** selector (`Emit payload only` / `Emit payload and save to file`), keeping backward compatibility with existing flows. - Logger node: file saving now appends and enforces **Max rows** by trimming oldest lines in both buffer and file; removed the folder picker/listDirs endpoint in favour of a single full-path field. - Logger node: localized labels/help updated in all languages to reflect the new save mode and path field. **Version 4.1.5** - December 2025 - Bump KNX Engine to 5.2.3. **Version 4.1.4** - December 2025 - KNX config node: cache and force-close the FT1.2 serial driver on deploy/close even when the KNX client instance is already null, preventing orphaned handles from blocking reconnects after a redeploy. **Version 4.1.3** - December 2025 - KNX config node: strengthened FT1.2 teardown with a direct serial-driver close fallback so the KBerry port is reliably released even if a previous disconnect was in a "disconnected" state; prevents reconnection stalls with "Timeout waiting for FT1.2 ACK (reset)". **Version 4.1.2** - December 2025 - KNX config node: deploy/disconnect now always tears down the KNX client and clears timers, ensuring Serial FT1.2/KBerry ports are released and can reconnect after configuration changes. **Version 4.1.1** - November 2025 - KNX config node: Serial FT1.2 now exposes a dedicated **Serial FT1.2 mode** selector with _KBerry/BAOS_ vs _Standard FT1.2_; the choice is forwarded to the KNX engine as `serialInterface.isKBERRY` (default: KBerry/BAOS). - KNX config node: when `SerialFT12` is selected, Secure KNX options that only apply to IP tunnelling (manual tunnel IA, tunnel user ID/password, mixed keyring+manual mode) are automatically hidden or disabled to keep the UI focused; help and wiki pages in all languages now clearly state that KNX/IP Secure & Data Secure apply only to IP transports, not to Serial FT1.2. - KNX Device node: the manual command button in the editor is now enabled by default and set to **Toggle boolean (write)**, with the notification message correctly translated in all locales and extended to show the payload value when relevant. - Docs & homepage: Serial FT1.2 documentation and the technology cards on the docs homepages have been refreshed to explicitly mention **Weinzierl KBerry/BAOS** support and the recommended UART defaults for TP/FT1.2 adapters. **Version 4.0.30** - November 2025 - KNX config node: enabled the new Serial FT1.2 transport from `knxultimate`, with auto-discovery of `/dev/tty*` ports and editable UART parameters (baud rate, data bits, stop bits, parity, RTS/CTS, DTR, ACK timeout) so TPUART hats and Weinzierl TP interfaces can connect directly without KNXd. - Editor: serial interfaces now appear alongside KNX/IP gateways in the `IP/Hostname` dropdown (marked as `[Serial]`); selecting one auto-sets protocol to Serial FT1.2 and pre-populates the UART settings with the recommended defaults. **Version 4.0.29** - November 2025 - All Hue editor nodes now honour the refresh icon by forcing a live reload from the Hue bridge (with URL-safe server ids), keeping device/scene lists in sync after bridge-side changes. **Version 4.0.27** - October 2025 - GA selector inputs: suppressed the empty-result tooltip by keeping the typed group address as a fallback option so single matches are never hidden behind "no items to show". **Version 4.0.26** - October 2025 - Watchdog node editor: added the same GA autocomplete list used in the other KNX nodes, restricted to boolean DPT 1.x addresses and with secure-address highlighting to keep configuration consistent. **Version 4.0.25** - October 2025 - KNX Device node editor: repositioned the "Show manual command button in editor" option directly under the input passthrough setting so related controls stay together. - KNX Function helper: refreshed the send-side snippet library with ready-to-use home-automation templates (motion-triggered lighting, HVAC standby on window-open, night door alerts, bedtime all-off) and cleaned up placeholders for easier copy/paste. **Version 4.0.24** - October 2025 - Hue config node: pairing now polls the bridge automatically and closes the dialog as soon as the link button is pressed, with a cancellable wait message and improved error feedback. - Hue config node: added "I ALREADY HAVE THE CREDENTIALS" button and restored bridge discovery so manual credentials can be entered immediately without running the registration flow. - Backend: `/KNXUltimateRegisterToHueBridge` now succeeds even when the config node is not yet saved, ensuring the automatic pairing response always reaches the editor. - Documentation: refreshed Hue Bridge wiki/help pages in all supported languages to explain the new pairing flow and manual credentials option; tutorials & teleprompter scripts updated accordingly. - General: kept unit test coverage for the Hue Light node to guard recent regressions. - KNX config node: host autocomplete now shows the full gateway list on focus/click, regardless of the current filter, to simplify manual selection. **Version 4.0.23** - October 2025 - Fixed some regressions in the hue light node. **Version 4.0.22** - October 2025 - FIX: Restored the `knxUltimateHueLight` implementation to the stable 4.0.16 baseline to stop Hue `grouped_light` devices from switching off immediately. - FIX: Hardened the **KNX Debug** sidebar by replacing the timer logic with an HTML-driven poll loop and keeping the _Auto_ option disabled by default. **Version 4.0.19** - October 2025 - Hue Light node: the `Locate` button now runs as a toggle — it starts a bridge identify loop that replays the Hue `identify` command every second, switches the icon to “stop”, and halts immediately when pressed again or automatically after 10 minutes. - Hue config node: added identify-session management (start/stop/timeout) so grouped lights fan out the locate pulse to all members without spamming the bridge. - Admin API `/KNXUltimateLocateHueDevice`: upgraded to orchestrate the new toggle behaviour, queueing devices per session and surfacing precise success/stop responses for the editor. - Editor UX: locate buttons across all locales now swap play/stop icons, surface contextual tooltips, and show language-specific messages for “started” / “stopped” states. - Docs: refreshed the Hue Light wiki/help pages in EN/IT/DE/FR/ES/zh-CN (and mixed-language variants) to describe the continuous locate mode and the new button semantics. - Hue config node now exposes `refreshHueResources()` and `getHueResourceSnapshot()` so Hue devices always reload directly from the bridge after a refresh or reconnect, preventing stale caches. - Hue Light and Hue Plug nodes request the live Hue snapshot before applying KNX commands, queue pending writes during synchronisation (with a 10 s TTL), and replay only the fresh ones as soon as the bridge answers. - Hue Scene node now behaves like the other actuators: it waits for the bridge snapshot before serving KNX/flow recalls, replays deferred commands, and shows the actual flow payload in the status text. - All Hue editor dialogs automatically show flow pins whenever no KNX gateway is configured and hide them when one is selected, keeping the Flow output consistent with the gateway state. - General Hue editor polish: the refresh buttons and status messages now reflect the effective payload sent to Hue, and the UI stays responsive while the bridge syncs in the background. - KNX Ultimate node: the optional editor button can now be enabled per node and configured to issue a KNX read, toggle boolean DPT 1.x values, or push a custom value consistent with the node datapoint. - Added new KNX Function receive snippets (motion-triggered lighting, HVAC standby on window open, and night-time door alerts) to speed up common smart-home automations. **Version 4.0.16** - October 2025 - Fixed Gateway Discover, that sometimes donesn't show some KNX Gateways. - HUE Lights Refresh button in the Light node, now ask for a refresh from the HUE bridge directly. **Version 4.0.15** - October 2025 - NEW: Introduced the KNX Monitor sidebar plugin with live GA table, 1 s auto-refresh, highlight on fresh telegrams and row toggles for boolean values. - NEW: Added inline filtering, draggable column widths, persistent gateway selection and reorder controls to speed up commissioning and diagnosis. - Added `/knxUltimateMonitor` and `/knxUltimateMonitorToggle` admin endpoints to feed the sidebar and allow direct write/toggle actions. - Docs: documented the KNX Monitor panel across all supported wiki languages and refreshed screenshots/tooltips. **Version 4.0.14** - October 2025 - NEW: Added KNX ↔ IoT Bridge node to orchestrate bidirectional KNX↔MQTT/REST/Modbus mappings with scaling, templating and ack metadata. **Version 4.0.13** - October 2025 - NEW: Added KNX Garage Door node with boolean/impulse control, hold-open and disable GAs, safety integration and automatic re-close timer. - KNX Staircase node: editor refinements with read-only DPTs, flow payload support and localisation polish across supported languages. - KNX Staircase & Garage nodes: unified status handling and multilingual flow examples in docs/help. **Version 4.0.12** - October 2025 - NEW: Added KNX Staircase Light node with timer handling, pre-warning, override and block support. - KNX Config node: replaced the "errors only" status filter with a configurable status throttle (0/1/3/5/10/30 s) that emits only the latest status after the chosen delay, preventing editor memory growth when many nodes update. - HUE Light node: the "Keep brightness" option now restores the last active dim level when toggled via KNX On/Off instead of forcing 100%. - Common functions: hardened `/knxultimateCheckHueConnected` admin endpoint so missing/initialising HUE config nodes no longer raise exceptions. **Version 4.0.11** - October 2025 - HUE nodes: hardened KNX telegram handling with a shared safe-send guard so editor events no longer ceases to function, when the KNX gateway is offline. - HUE Contact Sensor node: placeholders now leverage i18n translations with graceful fallback when translation keys are missing. - Editor polish: unified the default width of the `name` input across KNX and Hue nodes for a consistent layout. - KNX Scene Controller, Alerter and Load Control nodes: GA autocompletes now open their suggestion list immediately on focus/click to speed up GA selection. - Docs: audited external links; Hue API references require developer login but all other anchors resolve correctly. - HUE Light node: added configuration UI and runtime support for Hue lamp dynamic effects (candle, fireplace, etc.) with KNX mappings and status feedback. - NEW: Added Hue Plug/Outlet node to map KNX on/off control to Philips Hue smart plugs. - NEW: Added Hue Humidity Sensor node to expose relative humidity readings from Hue bridges to KNX. - NEW: Added Hue Camera Motion node to forward Hue camera motion detections to KNX, with optional flow output pins. - Hue Button node: refreshed editor layout and switched to Hue `button.button_report.event` instead of the deprecated `last_event`. - Hue Battery, Motion, Temperature, Light Sensor and Zigbee Connectivity nodes now share the unified editor layout with refresh icon, KNX-aware tabs and optional flow pin toggles. - Docs: cleaned bold markdown spacing across KNX Ultimate help translations to avoid rendering glitches. **Version 4.0.10** - October 2025 - KNX Config node: you can now choose wether to display only the errors in the node statuses only errors. **Version 4.0.9** - September 2025 - KNX Config node: now the ethernet interface is automatically selected, based on the KNX Gateway's IP subnet. - Added the details of keyring in clear text, when the loglevel is set to "debug". **Version 4.0.7** - September 2025 - Fixed an issue where some secure fields were missing when creating a new config-node. - HUE Light: enhanced the Homeassistant export yaml. **Version 4.0.6** - September 2025 - Fixed regression in automatic datapoint selection, based on group address DPT. **Version 4.0.5** - September 2025 - NEW: You have now the choide to select multiple modes to authenticate to a KNX Gateway. **Version 4.0.4** - September 2025 - NEW: you can now login to your secure gateway using only tunnel and password, without the keyring file. **Version 4.0.3** - September 2025 - GlobalContextNode: Added "lastupdate" property. - Device Node. Refractor snippet list and UI. **Version 4.0.2** - September 2025 - CAUTION - MAKE A BACKUP OF YOUR FLOW BEFORE UPGRADING - NEW: KNX Secure has arrived!! - Enhancements: enancements in the UI - Enhancements: enancements in the help tab of node-red - Enhancements: added localization IT EN DE CN **Version 3.3.40** - August 2025 - KNX Peristent value files are now saved every 5 seconds, other than at the node disconnection. - Fixed an issue preventing the AutoResponder node to start, if the imported ETS file contains malformed structure. **Version 3.3.39** - July 2025 - Added other snippets to the KNX Device function tab. **Version 3.3.38** - May 2025 - FIX: fixed possible issue having tabulator chars in the group address names. - KNX Engine: better handling of disconnections telegrams. **Version 3.3.37** - May 2025 - FIX: fixed an issue preventing the nodes from loading the presistent data from file, after node-red restarting or gateway reconnection. **Version 3.3.36** - April 2025 - Node.js must be >=20.18.1 to allow installation of KNX Ultimate. **Version 3.3.35** - May 2025 - Fixed an issue preventing KNX Engine queue to further processing the KNX queue, in case of lack of ACK reception of a non-existent group address. **Version 3.3.34** - April 2025 - **BREAKING CHANGE** **!!!!!!!**: node must be >=20.1.1 (needed before was >=20.0.0).**!!!!!!!** **BREAKING CHANGE** - housekeeping. **Version 3.3.33** - April 2025 - **BREAKING CHANGE** **!!!!!!!**: node must be >=20.0.0 (needed before was >=18.0.0).**!!!!!!!** **BREAKING CHANGE** - HUE: getting rid of the Eventsource package, due to sleepy connections not recognized. **Version 3.3.30** - April 2025 - **BREAKING CHANGE** **!!!!!!!**: node must be >=18.0.0 (needed before was >=16.0.0).**!!!!!!!** **BREAKING CHANGE** - HUE: fixed SSE Hue Bridge silent disconnection issue. **Version 3.3.25** - April 2025 - HUE: fixed a saltuary bug preventing reconnection after HUE bridge has been restarted and there is no KNX Gateway configured. **Version 3.3.24** - April 2025 - NEW: Added Datapoint 14.1200 **Version 3.3.23** - April 2025 - HUE nodes: fixed no-reconnection after disconnection, due to a bug in the connection handler. - Housekeeping **Version 3.3.22** - March 2025 - HUE Button: fixed random unresponsive button event. - Housekeeping **Version 3.3.21** - March 2025 - KNX Engine: fixed an unmeaningful error while validating DPTs. **Version 3.3.20** - March 2025 - Load control node: fixed a malfunction in the flow's msg.shedding procedure. **Version 3.3.19** - March 2025 - HUE light nodes now have the colored status icon that follows the light status on/off. Blue fill dot is ON, blue ring is OFF **Version 3.3.18** - March 2025 - For all HUE nodes, added both the HUE and KNX status in the node's status text. - HUE engine: fixed a reconnection issue occurring sometimes, in some circumstances. - KNX engine: speed up the connection, from 30 to 10 seconds. **Version 3.3.16** - February 2025 - HUE config node: moved the connect directive after events declarations. - HUE engine: optimized the disconnection detection procedure. **Version 3.3.15** - February 2025 - Housekeeping and added some warnings on Watchdog node and configuration nodes. **Version 3.3.14** - January 2025 - NEW: Added all subtypes to KNX Datapoint 20.x. **Version 3.3.13** - January 2025 - NEW: Hue light now handles Hue Outlets as well. **Version 3.3.9** - December 2024 - CHRISTMAS FIX: issue on iterable interfaces error in raspberry pi. **Version 3.3.8** - December 2024 - HOT FIX: fixed compilation problem in the knx engine, causing the node to stop working. **Version 3.3.7** - December 2024 - DPT18.x: fixed scene validation 1 to 64. **Version 3.3.6** - December 2024 - KNX Alerter Node: read status after deploy even of a single node. **Version 3.3.5** - December 2024 - KNX Alerter Node: now the node works even if no ETS file has been imported. **Version 3.3.3** - November 2024 - KNX Config Node: Automatic KNX Gateway discover in the gateway node config window. - KNX Engine: new: new telegram sequencer waiter, for more accurate timing in slow or sliggish computers. - KNX Engine: bunp 4.0.0-beta.7 . **Version 3.3.0** - November 2024 - KNX Engine: explicitly set the local port of the unicast socket on 3671 and the local IP of the multicast to 0.0.0.0. - KNX Engine: many engine adaptation for the upcoming KNX-Secure implementation. **Version 3.2.17** - October 2024 - Hue devices: globally check for boundary limits, when calculating brightness and colorYX from an RGB or HEX KNX input. **Version 3.2.16** - October 2024 - Hue devices: fixed an issue with the ETS CSV file, when a HUE device's GA isn't contained in the CSV. - Hue Light: fixed an issue in setting RGB to 255,255,255, caused by an out of boundary of the calculater brightness value. **Version 3.2.15** - October 2024 - Hue Light: fixed an issue with old lightstrip causing an error in setting mirek. **Version 3.2.14** - October 2024 - Workarouded bug in node-red 4.0.x not selecting the default server's node. **Version 3.2.13** - October 2024 - Revert back from gathering the debug log. It doesn't like me. **Version 3.2.12** - October 2024 - Bump knxultimate engine to v. 3.0.4. **Version 3.2.11** - October 2024 - Fixed help texts in various nodes. - When you open a node, the node red's site bar goes into the help panel. Then, it goes into the info panel once closed. - Gather debug infos + log to be pasted into a new gitHub Issue. See the "Utility" TAB of the KNX Gateway config node. See DISCUSSIONS on gitHub. **Version 3.2.10** - October 2024 - Fixed a race condition happening whenever FULL DEPLOY is pressed in the node-red interface, preventing the HUE bridge node to gracefully disconnect from the HUE Bridge. **Version 3.2.9** - October 2024 - Maintenance release: added some log to better identify problems. **Version 3.2.8** - October 2024 - KNX Node: fixed "read status at startup" field not showing up in very old versions. **Version 3.2.7** - September 2024 - KNX Node: added "echoed" property to the flow's msg output. See help for further infos. **Version 3.2.6** - September 2024 - KNXViewer: fixed an issue with the PIN3. **Version 3.2.4** - September 2024 - KNX engine: fix oldest invalid KNX queue interval, by defaulting it to 25ms. **Version 3.2.2** - September 2024 - KNX engine: Bump to 3.0.2: fixed an issue with the KNX queue. **Version 3.2.1-beta.0** - September 2024 - Rewrote the logger engine and fixed some issues in the KNXUltimate package. - KNX engine: implemented a new "limiter" package for better calculate the maximum numbers of telegrams accepted by the KNX BUS. **Version 3.2.0** - September 2024 - Major Version. - HUE engine: implemented a new "limiter" package for better calculate the maximum numbers of telegrams accepted by the HUE Bridge. **Version 3.1.9** - September 2024 - HUE Bridge: you can now register to a bridge with your own credentials. - HUE Bridge: you can reveal the encrypted bridge's credentials (there is a button for that). **Version 3.1.8** - September 2024 - Wiki: completed the wiki for all nodes. - Node-Red help panel: completed the help for all nodes. - Logging: fixed the loglevel (was simply ignored before!). **Version 3.1.7** - August 2024 - KNX Node: KNX Function: async/await caused some race condition issues, so the code is now sync. **Version 3.1.6** - August 2024 - KNX Node: KNX Function: added "self", "toggle" and "setGAValue" function. See the help. - KNX Node: KNX Function: the code runs now in async/await mode. - The wiki has been revamped and will be implemented with HUE samples, in the upcoming release. **Version 3.1.5** - August 2024 - KNX Node: fixed some UI glitches while switching from universal mode to 3-level group Group Address. - KNX Function code editor: exited BETA. **Version 3.1.4** - August 2024 - KNX Node: added a group address search helper in the KNX Function TAB. - Updated documentation. **Version 3.1.3** - August 2024 - KNX Node: now the property page opens directly on KNX Function tab, if js code is present. CAUTION, KNX FUNCTION IS STILL IN BETA AND SUBJECT TO CHANGES. - KNX Node: Universal mode is now selectable in the dropdown list of GA Types. - KNX Node: better UI controls placements. - Updated documentation. **Version 3.1.2** - August 2024 - NEW: KNX Function code editor: minor fixes. CAUTION, KNX FUNCTION IS STILL IN BETA AND SUBJECT TO CHANGES. **Version 3.1.1** - August 2024 - NEW: KNX Function code editor in the device node: you can now write you own script to handle inbound and outboud KNX messages. Added "node" and "RED" object to the function's context. CAUTION, KNX FUNCTION IS STILL IN BETA AND SUBJECT TO CHANGES. **Version 3.1.0** - August 2024 - NEW: KNX Function code editor in the device node: you can now write you own script to handle inbound and outboud KNX messages. **Version 3.0.10** - August 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - KNX Auto Responder node (BETA): fixed issue with unused saved values. Please be aware that until the node exits beta, there can be breaking changes. **Version 3.0.9** - August 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - KNX Auto Responder node (BETA): fixed issue with malformed responses. Please be aware that until the node exits beta, there can be breaking changes. **Version 3.0.7** - August 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - KNX Auto Responder node (BETA): at start, it loads the last states saved in a persistent file. Please be aware that until the node exits beta, there can be breaking changes. **Version 3.0.6** - August 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - KNX Auto Responder node (BETA): fixed some issues when the ETS file has not been imported. Please be aware that until the node exits beta, there can be breaking changes. **Version 3.0.5** - August 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - KNX Auto Responder node (BETA): changed to JSON array instead of plain text and updated the help. Please be aware that until the node exits beta, there can be breaking changes. **Version 3.0.4** - August 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - NEW: KNX Auto Responder node (BETA): The node will respond to read request coming from the KNX BUS, with the current GA value. Please be aware that until the node exits beta, there can be breaking changes. **Version 3.0.3** - July 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - FIX: fix crash when no more KNX tunnels avaiable. **Version 3.0.2** - July 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - HUE BRIDGE: added the message to DEPLOY the flow prior to proceed, when you're creating a new HUE CONFIG node. **Version 3.0.1** - July 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - FEATURE: Due to multiple users not well knowing the KNX Protocol, by default new nodes have "Auto" in the protocol field. The node will automatically detect and apply the correct protocol. This is the real AI. **Version 3.0.0** - July 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - FEATURE CAUTION: rewrote the KNX engine in Typescript. If you encounter problems, please open a gitub issue. You can revert by installing the older version 2.5.1 - FEATURE: KNX Ultimate node: you can now set the group address from a global, flow or $env variable, beside the standard 3-level format. - FEATURE: KNX Ultimate node: if you imported the ETS file, as soon as you click to any Group Address field selector, the list shows up immediately. - FEATURE: KNX Ultimate node: msg.setConfig passed to the node, now can read the group address name and datapoint automatically, based on the group address (require the ETS file to be imported). - FEATURE: KNX Ultimate node: the object property _gainfo_ has been added to the msg output. Refer to the help panel for further infos. - Chore: "betterized" the description for some captions in the KNX Device node. - NEW: KNX Viewer node: added an output PIN (third) you can use to monitor the KNX BUS congestion. - Chore: HUEEngine: reduced waiting time from 200 to 150ms and "awaited" the async function to send the hue commands in the send's loop. - NEW: Hue Node Software Update Status for the HUE devices. **Version 3.0.0-beta3** - Juni 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - Chore: "betterized" the description for some captions in the KNX Device node. - NEW: KNX Viewer node: added an output PIN (third) you can use to monitor the KNX BUS congestion. - Chore: HUEEngine: reduced waiting time from 200 to 150ms and "awaited" the async function to send the hue commands in the send's loop. **Version 3.0.0-beta2** - Juni 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - NEW: Hue Node Software Update Status for the HUE devices. **Version 3.0.0-beta1** - Juni 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - FEATURE CAUTION: rewrote the KNX engine in Typescript. If you encounter problems, please open a gitub issue. You can revert by installing the older version 2.5.1 - FEATURE: KNX Ultimate node: you can now set the group address from a global, flow or $env variable, beside the standard 3-level format. - FEATURE: KNX Ultimate node: if you imported the ETS file, as soon as you click to the Group Address field, the list shows up immediately. - FEATURE: KNX Ultimate node: msg.setConfig passed to the node, now can read the group address name and datapoint automatically, based on the group address (require the ETS file to be imported). - FEATURE: KNX Ultimate node: the object property _gainfo_ has been added to the msg output. Refer to the help panel for further infos. **Version 2.5.1** - Mai 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - NEW: HUE light node: you can now override the day/night mode by setting the day mode temporary, whenever you fast toggles the light switch on then off within 10 seconds. There are multiple choiches to select from. **Version 2.5.0** - Mai 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - HUE light node: internally calculate the average color xy and temp in kelvin, for group_lights (not emitted by the HUE Bridge). - KNOW ISSUE: HUE light node: grouped_lights: the status group address is updated multiple times, equals to the lights contained in the grouped_light. To avoid repeating the same telegram multiple times, simply enable the RBE filter on the KNX node. <br