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 and ETS group address importer. Easy to use and highly configurable.

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

Supergiovane/node-red-contrib-knx-ultimate

747 lines (559 loc) • 120 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.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 (= in testing with user feedback)**. **Version 2.2.26** - November 2023 This is an interim version, to quick fix some issues. Please report any issue with HUE Nodes, on gitHub. - HUE Light: fixed some spurious node status errors. - HUE Light: now the brightness status is ever transmitted over the KNX bus, whenever the light is switched on. - HUE Battery: the node can respond to KNX read request, by sending the stored value as response to the KNX bus. - HUE light level: the node can respond to KNX read request, by sending the stored value as response to the KNX bus. - HUE temperature sensor: the node can respond to KNX read request, by sending the stored value as response to the KNX bus. - WARNING: the new HUE Light options are to be considered **BETA (= in testing with user feedback)**. **Version 2.2.25** - November 2023 - HUE Light: fixed settings of some behaviour options. - You can now query the HUE Light node stati, via a "read" telegram sent to the KNX stati group address. ("Status" is Latin, not English, so the plural is "stati" and not "statuses" nor "status"). Other HUE nodes will follow asap. - Fixed some little bugs. - Fixed an issue where in some circumstances, the HUE Light turn off by itself. - WARNING: the new HUE Light options are to be considered **BETA (= in testing with user feedback)**. **Version 2.2.24** - November 2023 - HUE Light: added DPT 9.002 for direct kelvin selection, with HUE range (2000K-6535K). There is another DPT 7.600 with the KNX scale (0K-6553K) avaiable. - NEW: HUE Light: now you can choose the "switch on" behaviour between color and temperature (in Kelvin) + brightness. - The fontawesome JS is now locally referenced. - WARNING: the new HUE Light options are to be considered **BETA (= in testing with user feedback)**. **Version 2.2.20** - November 2023 - Fixed a cross site js script loading, affecting the node running under HomeAssistant. **Version 2.2.19** - November 2023 - HUE Bugfix. **Version 2.2.18** - November 2023 - HUE Bugfix. - New connection check for HUE bridge. **Version 2.2.16** - November 2023 - NEW: Hue Light: you can now enable the input/output PINs and send/receive commands to/from the light, via the msg flow, like msg.on={"on":true}. The option is "Node Input/Output PINs". - NEW: Hue Scene: you can now enable the input/output PINs and send/receive commands to/from the light, via the msg flow. The option is "Node Input/Output PINs". **Version 2.2.9** - November 2023 - Fixed errors in Iobroker. - HUE Light: NEW: color selection show now the temperature in kelvin. - HUE Light: NEW: Tunable White: added control and status in kelvin (DPT 7.600). This is in BETA testing. - Removed some options in button and scene nodes, because they are unnecessary. **Version 2.2.6** - October 2023 - Fix: fixed HUE button sending a KNX telegram at startup. Fixed also other nodes. - HUE Nodes: added the option to inizialize at startup or not. **Version 2.2.5** - October 2023 - Fix: fixed some HUE nodes not able to register to the event notification service. - Restyle GUI of KNX Device node. **Version 2.2.4** - October 2023 - HUE Light: fixed some status hiccups and better handling of async hue bridge functions. **Version 2.2.3** - October 2023 - HUE Light: Again, rewrite of the DIM function to get rid of the dimming_delta. **Version 2.2.2** - October 2023 - NEW: HUE Motion: support HUE Camera motion events via the HUE Motion node. - HUE Light: some tweaking to the GUI. - HUE Grouped Light: Fixed relative dimming function. - KNK Alerter node: <a href="https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/SampleAlerter">fixed the wiki sample page</a>. - KNX Viewer: added the help pane in Node-Red. **Version 2.2.1** - October 2023 - Massive rewrite of the DIM function, for brightness and for color temperature. - NEW: HUE Light: Added dimming speed, minimum dim value and maximum dim value. - NEW: HUE Light: Read of the lamp status at node-red start and after deploy of a new node. - Security fix: patched a vulnerability in crypto.js. **Version 2.1.63** - October 2023 - HUE Light: optimized the GUI in select color TAB. **Version 2.1.62** - October 2023 - HUE Light: FIX: a typo error could prevent the light to switch on, if the light was set to specified RGB color at switch on. **Version 2.1.61** - October 2023 - HUE Light: NEW color picker. A Color picker is shown in the right TABS of node-red, as soon as you open the light node. You can choose the color you want, and paste the RGB color into the HUE light node. - HUE Light: the color getter is now not shown, whenever you select a grouped light. You can use the color picker instead. **Version 2.1.58** - October 2023 - HUE Light: NEW color getter. Just click a button to automatically fill the node's "color" properties **Version 2.1.57** - October 2023 - HUE Light: NEW Behaviour "KNX Brightness Status" - HUE Light: the light now remembers the last brightness value after switch off **Version 2.1.56** - October 2023 - HUE Scene: removed non existant scene 0. **Version 2.1.54** - October 2023 - HUE Scene: NEW: you can now use also the Datapoint 18.001, to recall a scene via a KNX scene pushbutton. **Version 2.1.52** - October 2023 - HUE Light node: fixed another possible switch on brightness issue. **Version 2.1.51** - October 2023 - HUE Light node: fixed a possible switch on brightness issue. **Version 2.1.50** - October 2023 - KNXUltimateViewer node: fixed too large text in custom template.. **Version 2.1.47** - September 2023 - HUE BRIDGE: fixed multiple HUE bridge handling. **Version 2.1.46** - September 2023 - HUE BRIDGE: In case of https problems (certificate expired, etc...), the node will try to connect to the HUE BRIDGE in insecure http mode. **Version 2.1.45** - August 2023 - HUE Light: now it correctly sets the KNX brightness if you turn on/off the light via HUE app.<br/