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

831 lines (531 loc) • 126 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.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. **Version 2.4.27** - Mai 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - HUE light node: fixed status refresh of kelvin and brightness of a light belonging to a grouped_light. - 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. **Version 2.4.25** - Mai 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - HUE light node: fixed status sent to the KNX bus after issuing a read request for grouped_lights. - 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. **Version 2.4.24** - Mai 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - HUE light node: fixed kelvin temp status with datapoint 7.600, that sent wrong values to the bus. **Version 2.4.23** - Mai 2024 - Warning: Node-Red version **equals or major than 3.1.1** is needed to run this node. - HUE Scene node: fixed max scene count to 64. **Version 2.4.22** - April 2024 - Warning: this version uses the Node-Red plugin system; the Node-Red version must be **equals or major than 3.1.1** - HUE button node: NEW: now you can select the value and the dim direction to be transmitted, when Toggle Status is set to unchecked. Thanks @cybersmart-eu for the suggestion. **Version 2.4.21** - April 2024 - Warning: this version uses the Node-Red plugin system; the Node-Red version must be **equals or major than 3.1.1** - Home Assistant translator node: fixed an issue where user added translations does not work. **Version 2.4.20** - April 2024 - Warning: this version uses the Node-Red plugin system; the Node-Red version must be **equals or major than 3.1.1** - DPT9: auto transform a string value, to a numeric value. **Version 2.4.19** - April 2024 - Warning: this version uses the Node-Red plugin system; the Node-Red version must be **equals or major than 3.1.1** - Start adding youtube lessons and tutorials and linking it with the nodes. **Version 2.4.18** - April 2024 - Warning: this version uses the Node-Red plugin system; the Node-Red version must be **equals or major than 3.1.1** - Fixed some backward compatibility glitches in the KNX-Device's UI. **Version 2.4.16** - April 2024 - Warning: this version uses the Node-Red plugin system; the Node-Red version must be **equals or major than 3.1.1** - NEW: Home Assistant translator node: translates the HA input msg, to a KNX value. Comes with a built-in translation table, that's user editable. - NEW: HUE Contact Sensor node. - NEW: You can now get a list of all node's GA, to paste it into your KNX/IP routing table list. (See in the Gateway config window, TAB Utility. - Updated KNX-Ultimate device node help. - Minor KNX-Ultimate device node UI changes. - Fixed an issue with the RBE Filters. **Version 2.4.9** - March 2024 - WARNING: this version uses the Node-Red plugin system; the Node-Red version must be **equals or major than 3.1.1** - Fixed [this](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/338). **Version 2.4.6** - Feb 2024 - WARNING: this version uses the Node-Red plugin system; the Node-Red version must be **equals or major than 3.1.1** - Changed the KNX Engine keep alive CONNECTIONSTATUS_REQUEST interval from 60 to 30 secs, to allow some KNX/IP interfaces (not strictly following the KNX standard) to work properly. **Version 2.4.5** - Feb 2024 - WARNING: this version uses the Node-Red plugin system; the Node-Red version must be **equals or major than 3.1.1** - NEW: Added KNX Datapoint 275.100 - HUE Light: fixed https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/317 - HUE Light: corrected the 7.600 kelvin range https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/316 - HUE Light: blinking effect and color cyle are now stopped, whenever an FALSE KNX telegram is received by the light switching group address. - HUE Light: when the light is off, the dim up sequence starts now with initial brightness = zero. - KNX Engine: moved all HTTP calls to a single js file plugin, loaded at startup, to avoid multi KNX gateway or multi HUE bridges issues. - HUE: Optimized color translation between xyBri and RGB. - NEW: HUE Light node: added the HSV controls. - HUE Light node: stopping the dim sequence, now clears also the HUE bridge queue commands, to allow stopping the dimmer quickly. - HUE Light node: smoother dimming. - Fix the listing of ethernet interfaces in the gateway config window. - HUE: Fixed "read at startup" option, not working for some HUE nodes. - NEW: HUE: added node Zigbee Connectivity. - PLEASE TRY THIS VERSION AND GIVE ME ANY FEEDBACK ABOUT ISSUES YOU FIND. THANKS. **Version 2.4.5-beta.4 PUBLIC BETA** - Feb 2024 - Maintenance release. **Version 2.4.5-beta.3 PUBLIC BETA** - Feb 2024 - HUE: Fixed "read at startup" option, not working for some HUE nodes. - NEW: HUE: added node Zigbee Connectivity. **Version 2.4.5-beta.2 PUBLIC BETA** - Feb 2024 - Fix the listing of ethernet interfaces in the gateway config window. **Version 2.4.5-beta.1 PUBLIC BETA** - Feb 2024 - WARNING: this version uses the Node-Red plugin system; the Node-Red version must be **equals or major than 3.1.1** - HUE: Optimized color translation between xyBri and RGB. - NEW: HUE Light node: added the HSV controls. - HUE Light node: stopping the dim sequence, now clears also the HUE bridge queue commands, to allow stopping the dimmer quickly. - HUE Light node: smoother dimming. - PLEASE TRY THIS VERSION AND GIVE ME ANY FEEDBACK ABOUT ISSUES YOU FIND. THANKS. **Version 2.4.5-beta.0** - Jan 2024 - WARNING: this version uses the Node-Red plugin system; the Node-Red version must be **equals or major than 3.1.1** - NEW: Added KNX Datapoint 275.100 - HUE Light: fixed https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/317 - HUE Light: corrected the 7.600 kelvin range https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/316 - HUE Light: blinking effect and color cyle are now stopped, whenever an FALSE KNX telegram is received by the light switching group address. - HUE Light: when the light is off, the dim up sequence starts now with initial brightness = zero. - KNX Engine: moved all HTTP calls to a single js file plugin, loaded at startup, to avoid multi KNX gateway or multi HUE bridges issues. **Version 2.4.4** - Jan 2024 - Transitional version. **Version 2.4.0-beta.1** - Jan 2024 - This is a public installable beta. - HUE Light: fixed https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/317 - HUE Light: corrected the 7.600 kelvin range https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/316 - HUE Light: blinking effect and color cyle are now stopped, whenever an FALSE KNX telegram is received by the light switching group address. - HUE Light: when the light is off, the dim up sequence starts now with initial brightness = zero. - KNX Engine: moved all HTTP calls to a single js file, loaded at startup, to avoid multi KNX gateway or multi HUE bridges issues. - Minor fixes. **Version 2.4.0-beta.0** - Jan 2024 - THIS IS A BETA VERSION. INSTALL ONLY IF YOU HAVE MANY HUE BRIDGES. - HUE Light: fixed https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/317 - HUE Light: corrected the 7.600 kelvin range https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/316 - HUE Light: blinking effect and color cyle are now stopped, whenever an FALSE KNX telegram is received by the light switching group address. - HUE Light: when the light is off, the dim up sequence starts now with initial brightness = zero. - KNX Engine: moved all HTTP calls to a single js file, loaded at startup, to avoid multi KNX gateway or multi HUE bridges issues. **Version 2.3.5** - Jan 2024 - HUE Light: fixed multi HUE Bridge GUI issue. **Version 2.3.4** - Jan 2024 - HUE Light: fixex tab "DIM/Brightness" inaccessible, when "KNX Brightness Status" was set to use the default knx behaviour. **Version 2.3.3** - Jan 2024 - HUE Light: added a warning if you double click a node, with the node still querying the HUE Bridge for the device. **Version 2.3.2** - Jan 2024 - HUE Light: minor fixes. **Version 2.3.0** - Jan 2024 - HUE Light: partially rewrote code to cloneDeep(oHUEDevice) not to duplicate the brightness status of a single ligh, at node-red restart. https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/312#issue-2064480332 **Version 2.2.40** - Jan 2024 - HUE Light: fixed an issue with initial status read from HUE Bridge (on/off status was incorrectly set). **Version 2.2.39** - Jan 2024 - Fixed DPT 9.001 issue when sending numbers having > 2 decimals. - HUE Light node: fixed an issue in dimming, when the minimum dim level is set to the minimum level defined by the HUE bridge. **Version 2.2.37** - December 2023 - HUE Light Node: you can now set the DIM direction for tunable white lights. Fixed some issues as well. **Version 2.2.36** - December 2023 - HUE Light Node: Ensure at least one liht belonging to a group was on before switching to nighttime. Otherwise turn all lights on at daytime. **Version 2.2.35** - December 2023 - NEW: HUE Light Node: now it resumes the old status of all lights belonging to the selected group. **Version 2.2.34** - December 2023 - NEW: HUE Light Node: there is a new tab that auto-generates the light entity for Home Assistant. - HUE Light: resuming the last daytime status after nighttime, if the switch on behaviour at daytime is set to None. - The new HUE Scene node has exited the BETA status and is now considered safe to be used. **Version 2.2.33** - December 2023 - Quickfix: HUE Light: fixed an issue in the conversion of tunable white from Datapint 7.600 to mired and vice versa. - WARNING: the new HUE Scene node is to be considered **BETA (= in testing with user feedback)**. **Version 2.2.32** - December 2023 - Quickfix: HUE Light: fixed an issue in the conversion of tunable white from Datapoint 9.002 to mired and vice versa. - WARNING: the new HUE Scene node is to be considered **BETA (= in testing with user feedback)**. **Version 2.2.31** - December 2023 - NEW: HUE Scene node: added the status GA and Datapoint, for the scene to send true/false if active/not active. This currently works only for "Single mode". - WARNING: the new HUE Scene node is to be considered **BETA (= in testing with user feedback)**. **Version 2.2.30** - December 2023 - NEW: HUE Scene node: added a "Multi scene" section, more powerful. - HUE Scene: when selecting a group address for the scene, the scene number dropdown list doesn't show up. - WARNING: the new HUE Light node is to be considered **RELEASED (= production ready, but please report anyway any issue)**. - WARNING: the new HUE Scene node is to be considered **BETA (= in testing with user feedback)**. **Version 2.2.29** - November 2023 This is an interim version, to quick fix some issues. Please report any issue with HUE Nodes, on gitHub. - HUE Light: fixed an issue causing the node status to signal an error. Filtered the groupvalue_read from imbound KNX messages. - WARNING: the new HUE Light options are to be considered **BETA (= in testing with user feedback)**. **Version 2.2.28** - November 2023 This is an interim version, to quick fix some issues. Please report any issue with HUE Nodes, on gitHub. - HUE Light: fixed an issue where dimming down with the light switched off, causes the brightness status to jump to 100%, thus the light remains off. - HUE Light: Fixed some errors, if all devices belonging to a group, have only the dimming capability. - WARNING: the new HUE Light options are to be considered **BETA (= in testing with user feedback)**. **Version 2.2.27** - November 2023 This is an interim version, to quick fix some issues. Please report any issue with HUE Nodes, on gitHub. - HUE Light: the UI now changes, to adapt to lamp type. - HUE Light: "Get current" color button, now works for grouped light as well, by reading the first light belongin to the group. - WARNING: the new HUE Light options are to be considered **BETA (