CHANGELOG.md

CHANGELOG

Version 7.0.1 - September 2026

KNX Device: fixed a wrong status text, when the node receives a READ request and responds with the last payload received.
KNX Device: the input msg now supports msg.event = "GroupValue_Read" as an additional method besides msg.readstatus = true, to issue a READ command to the bus.

Version 7.0.0 - September 2026

• Major release — focused KNX package: KNX Ultimate 7 starts the new package boundary. Conversational AI, supervised home learning, shared memory and multi-platform chat now belong to the standalone node-red-contrib-cerebrum-ultimate; this package remains the optional KNX/ETS integration. Existing deployed flows that contain the hidden legacy runtime types continue to load, but new instances can no longer be added from the palette.
  
• Cerebrum Ultimate documentation handoff: removed the obsolete bundled-assistant guides, samples, dashboard pages and public labels. The README, multilingual homepages, wiki navigation, localized legacy-node help and tutorial roadmap now point to the standalone node-red-contrib-cerebrum-ultimate package. The hidden legacy runtime identifiers remain registered only so existing flows continue to load.
  
• Cerebrum standalone extraction: the historical knxUltimateAI and knxUltimateAIHomeAssistant types remain registered so existing deployed flows continue to load and can be edited, but they are now hidden from the Node-RED palette. New Cerebrum installations move to the independent node-red-contrib-cerebrum-ultimate package, where KNX Ultimate is an optional integration alongside Home Assistant, HUE, Matter and other adapters.
  
• Cerebrum Ultimate — safe Cerebrum startup delivery: corrected the RedBot Telegram envelope used by startup and other proactive messages after a Node-RED restart. Its synthetic chat context now fulfils RedBot's synchronous context contract instead of returning undefined, preventing chat-platform from raising an uncaught sourceCode error and terminating Node-RED. Saved RedBot adapter code is hardened at runtime as well. Schedule persistence now passes the generated Markdown filename to the atomic writer under the correct filePath key, removing the accompanying undefined-path warning.
  
• Cerebrum Ultimate — Cerebrum (BETA): renamed the Web Assistant area to Cerebrum and introduced a passive home-automation intelligence layer that studies KNX telegrams, useful Node-RED flow events and the registered HUE, Matter and Home Assistant adapters. Cerebrum maintains bounded current-state and observation context locally, learns only repeated patterns spanning distinct days and asks the occupant for confirmation or correction through the Assistant output before a habit can become predictive. Confirmed habits remain subject to the exact ETS/DPT permissions: group addresses marked read-only are never written.
  
• Cerebrum — Home Assistant adapter: added the Cerebrum Home Assistant node and the shared runtime registry. When Node-RED is running as a Home Assistant add-on, Setup Doctor detects whether the required ha-api round trip is present and tells the user to add it when missing. Entity states, events and service capabilities are exposed to Cerebrum through bounded, vendor-neutral records without retaining raw messages, secrets or binary payloads.
  
• Cerebrum — supervised startup: every Cerebrum Ultimate node now asks its configured model to generate a short startup reassurance on the Assistant output. The message carries msg.boot = true for simple flow filtering and falls back to a localized deterministic notice if the provider is unavailable.
  
• Cerebrum Ultimate Web — Cerebrum workspace and readable memory: reorganized the Web navigation into Cerebrum submenus, removed the separate Cerebrum Ultimate node selector and bound the workspace directly to the node that opened it. Cerebrum Memory now offers an editable authoritative JSON view and a read-only simplified view; AI Chat Learning offers the equivalent editable native .knxctx view and localized simplified view. Copy follows the visible representation, while save, restore, download and concurrency checks continue to protect the complete authoritative files.
  
• Cerebrum — complete import/export: the Settings page now contains only import/export and its versioned backup includes AI configuration, chat learning, home memory, schedules and the readable schedules companion file, with validation and rollback-safe restoration.
  

Version 6.3.32 - August 2026

• Cerebrum Ultimate: AI-first chat with complete cloud ETS context, selectable local windows and guided retrieval; selected ETS access is now the sole read/write authority, with no neutral role.
  

Version 6.3.31 - August 2026

• Cerebrum Ultimate — adaptive prompts for 8K local models: the conversational prompt now reserves response space from the active model window before every request. For an 8K model it uses a compact tool contract and automatically bounds the newest conversation turns, KNX/adapter events, home memory, Web results, schedules, Function source, retrieved ETS objects and camera metadata. The complete selected ETS catalog remains local and available through deterministic retrieval; it is not copied wholesale into the prompt. The prompt-debug file records the final bounded system/user text actually sent to the model.
  
• Cerebrum Ultimate — model-guided local ETS retrieval: the conversational model now receives catalogActions for deterministic searches over the complete selected ETS catalog held inside the node instead of receiving the full catalog in every prompt. Bounded multi-pass retrieval supports ranked search across exact GAs, ETS names, aliases, hierarchy, areas, semantics, DPTs and value labels; accent-insensitive and typo-tolerant matches; exact-address lookup; area discovery/browsing; and related command/status discovery. No socket or second classifier is used: LM Studio returns structured requests, Cerebrum Ultimate executes them locally and calls the same model again with a deduplicated subset of at most 24 objects. Commands and GA-role learning are accepted only for retrieved objects and still pass the complete local ETS/DPT/access validation. The final prompt debug file exposes the retrieval summaries and exact retrieved subset.
  
• Cerebrum Ultimate — complete ETS with deduplicated operational context: removed the 4K/8K/16K/unlimited context-size selector and its persisted runtime property while keeping the complete selected ETS catalog locally searchable from every conversation. The implicit KNX and adapter archive range is now 20 minutes instead of 24 hours; an explicit user time range still takes precedence. Packaged help, README, wiki, examples and changelog text are no longer embedded in prompts and can instead be retrieved from public GitHub through the request-driven Web tool. Retrieved ETS metadata, archive rows and the current request each have one canonical prompt location; duplicated archive summaries, ETS-derived area lists, per-GA live snapshots and the always-on Node-RED project inventory were removed. Complete Function source is supplied only for explicit Function-code review requests. A node-specific, locally protected knxai-last-chat-prompt-<node-id>.txt debug file is overwritten before every conversational model call with the exact system/user prompt text and its estimated size, excluding API keys and HTTP headers; its path appears in the editor context card. Ollama receives the model's full declared window as num_ctx; Cerebrum Ultimate never retries an oversized request by compacting its input.
  
• Cerebrum Ultimate — explicit ETS catalog access and read-only policy: added the same filterable group-address selector used by IoT Bridge’s MQTT profile, with Select all/none and bulk or per-row Read only controls. Every selected ETS object is available to conversational retrieval, while Flow Builder keeps its complete selected design inventory. Excluded objects are absent from AI tools, while read-only objects remain searchable and readable but are rejected locally for every write even if their inferred or learned role is command. Complete ETS names, hierarchy paths and duplicate-address aliases are preserved in the local catalog and retrieved object records. There is intentionally no backward-compatibility migration: an existing node without a newly saved explicit ETS selection exposes no group addresses until it is opened, configured, saved and deployed.
  
• Cerebrum Ultimate — request-driven Web access with clarification-first tool use: removed the fixed proactive Web polling option, interval selector, background timer, synthetic recipient routing and related Setup Doctor state. During a normal conversation the model now decides semantically whether the current request needs fresh public information; when a missing goal, scope, place, time window or desired outcome would materially change the answer or query, it must ask one concise clarification and emit no tool action until the user answers. Explicit one-time or recurring Web checks remain available through the user-authorized natural-language scheduler and share the existing hourly budget, bounded research loop, verified citations and security controls. Editor strings, help, wiki documentation and tests were aligned in EN, IT, DE, FR, ES and zh-CN.
  

Version 6.3.30 - August 2026

• Cerebrum Ultimate — two-way RedBot Telegram voice chat: the RedBot / node-red-contrib-chatbot (Telegram) preset now accepts RedBot's native inbound audio payload and its already-downloaded OGG/Opus Buffer, applies the same 20 MB and five-minute safeguards without downloading the file a second time, and transcribes it through the selected OpenAI-compatible provider. Successful requests receive a native RedBot audio reply with the localized AI-generated-voice disclosure and text caption; KNX confirmations deliberately remain RedBot inline-buttons text messages because its Telegram voice sender cannot attach that keyboard to sendVoice. Existing saved RedBot input/output mappings are upgraded at runtime. The separate windkh/node-red-contrib-telegrambot voice contract and its tests remain unchanged.
  

Version 6.3.29 - August 2026

• Cerebrum Ultimate — patient provider-neutral model requests: every LLM chat request now receives the same 30-minute minimum deadline, regardless of provider, model or model manager, while longer legacy configured values remain honored. The model transport carries that deadline through both streaming and non-streaming responses instead of inheriting a shorter HTTP-library header timeout; fast responses are returned immediately, model-response timeouts remain distinct from unreachable-server errors, and Telegram audio operations retain their separate two-minute safeguard.
  
• Cerebrum Ultimate — provider-neutral reasoning control and responsive chat: added a localized Reasoning effort selector with provider/model default, none, minimal, low, medium, high, xhigh and max choices. The default sends no preference; explicit supported values are mapped by request protocol to Chat Completions reasoning_effort, Anthropic output_config.effort or Ollama think, without model-name allowlists, and a rejected preference is removed while preserving the rest of the request. OpenAI-compatible and Ollama chats now stream responses for every configured endpoint, keep reasoning traces separate from the structured user reply and retry without streaming when an endpoint rejects it. Abort and HTTP transport timeouts are reported as model-response timeouts instead of as false connection failures; genuine unreachable-server errors retain their provider-specific setup guidance. Context-error compaction remains in force. Editor help and wiki documentation were aligned in EN, IT, DE, FR, ES and zh-CN.
  
• Cerebrum Ultimate — optional model-sized local context: added a localized No Cerebrum Ultimate limit choice to the local-model chat-context selector. The existing 4K, 8K and 16K budgets are unchanged and 16K remains the backward-compatible default; when the new choice is explicit, Cerebrum Ultimate uses the active/reported Ollama or Bionic LM Studio context window instead of imposing its own token cap, while the model's physical limit and the existing context-error fallback remain authoritative.
  
• Cerebrum Ultimate editor — quieter Setup Doctor placement: moved Setup Doctor to the bottom of the Chat and home page, below the available-chat-context overview, and made it an accessible collapsed-by-default section so routine configuration stays compact while every diagnostic and refresh action remains available on demand.
  
• Cerebrum Ultimate — semantic persistent chat scheduling and fixed AI Education: added model-selected scheduleActions for creating, listing and cancelling one-time or recurring reminders, monitors and future home commands from normal human-language chat, without keywords, trigger phrases or rigid intent classifiers. Each node persists authoritative schedule state in JSON and a generated readable Markdown view across restarts; due tasks reuse both the model's execution instruction and the exact original user request while retaining Web budgets, detected-camera limits, explicit TTS Ultimate wiring, ETS/DPT validation and configured KNX confirmation. Empty structured replies from smaller local models receive one general semantic recovery pass instead of surfacing the old “No response text” placeholder. Scheduled camera results are delivered back to sidebar chat, and cancelling a plan also invalidates any pending camera work or KNX confirmation belonging to it. reset clears all schedules for the node, while clear_chat cancels only the current session's schedules. AI Education remains a fixed, user-edited node property stored in the Node-RED flow: the model reads it as authoritative guidance but never writes it; learned chat memory stores facts and preferences requested in chat, while scheduler storage holds plans and reminders. The previously introduced legacy knxai-education-<node-id>.md file is no longer read or written; existing copies are left untouched and ignored. Localized editor strings, help and wiki pages were aligned in EN, IT, DE, FR, ES and zh-CN.
  

Version 6.3.27 - August 2026

• Cerebrum Ultimate: enabled some things by default.

Version 6.3.26 - August 2026

• Cerebrum Ultimate — opt-in Web Intelligence with verified sources: added a provider-independent general Web tool that the conversational model selects semantically from the current request, without topic-specific logic, keywords or intent classifiers. Web access is off by default; proactive Web checks require a separate opt-in, explicit user-authored AI Education, a destination learned from at least one normal chat request and a configurable 5, 10, 15, 30, 60 or 180-minute minimum interval. Setup Doctor reports Web/proactive readiness, missing Education or recipient and the live hourly budget. Interactive and proactive requests share a rolling hourly call budget, with at most three Web operations in total per user turn or proactive cycle. Web-backed answers carry runtime-validated numbered citations ([S1], …) with sanitized URLs and available publication/retrieval times; external content remains untrusted data and cannot override assistant rules or permissions. Only bounded public HTTPS resources are accepted, with private/local/link-local/cloud-metadata targets, unsafe redirects, authenticated browsing and cookies blocked. Queries and the server's public IP are disclosed to external sites or the search service, while KNX/ETS data, camera content, chat identifiers, learned memory and credentials are never added automatically. Once verified Web results are available, the model can compose other enabled tools when authorized by the current chat or AI Education; existing tool availability, KNX permissions, ETS/DPT validation and configured write confirmation remain unchanged. Editor help and wiki documentation were aligned in EN, IT, DE, FR, ES and zh-CN.
  
• Cerebrum Ultimate — clearer chat wiring terminology: renamed the editor labels for chat input/output pins, message adapters and automatically detected compatible nodes in all six shipped languages, including the related empty/loading/error states and localized help/wiki references.
  
• Cerebrum Ultimate — automatic Setup Doctor and personalized safe first run: added an editor and Web UI preflight that checks the selected gateway and ETS import, AI/provider/model/API-key setup, provider reachability, chat and KNX-operation wiring, detected cameras and optional TTS Ultimate wiring. The provider check calls only its model-list endpoint, never sends a chat request and consumes no inference tokens; unused camera and TTS integrations do not reduce core readiness. Inventory wording now distinguishes the exact number of unique KNX group-address signals from estimated logical functions and deliberately avoids an unreliable physical-device count. Sending /start or /help produces a deterministic localized welcome on output 3 with installation-specific statistics and up to three safe suggestions, without calling the LLM, reading or writing KNX, or generating TTS; the Telegram preset renders those suggestions as an explicit reply keyboard. After explicit selection, a starter suggestion may perform exact KNX reads when needed, while KNX writes and routines, camera actions, TTS, persistent-memory changes and GA-role learning are suppressed. Help, wiki and the direct Telegram example were updated in EN, IT, DE, FR, ES and zh-CN.
  
• Cerebrum Ultimate — explicit TTS Ultimate flow output: replaced the internal TTS Ultimate node for announcements selector and direct node injection with a dedicated fifth output labelled TTS Ultimate. Each model-selected announcement now leaves the node through normal Node-RED wiring with the exact spoken text in msg.payload, msg.topic = "knx_ai_announcement" and msg.knxAi metadata for type, source node, session and reason; normal fan-out or Link Out/Link In can route it to one or more ttsultimate nodes. Output positions 1–4 remain unchanged. Existing flows that relied on the saved ttsUltimateNodeId selection must physically connect output 5 after upgrading; the old selection is no longer used. Help, wiki pages and importable Cerebrum Ultimate examples were updated in EN, IT, DE, FR, ES and zh-CN.
  
• Cerebrum Ultimate — two-way Telegram voice chat: the windkh/node-red-contrib-telegrambot preset now accepts native OGG/Opus voice messages, downloads them through the receiver-provided Telegram link with same-origin, timeout, 20 MB and five-minute safeguards, redacts the token-bearing URL, and transcribes them through OpenAI-compatible /audio/transcriptions. Successful voice requests receive native Telegram OGG/Opus replies synthesized by /audio/speech, including a localized AI-generated-voice disclosure, the text caption and confirmation keyboard; failed or oversized synthesis falls back to the complete text answer. Voice processing is intentionally plug-and-play only with the selected OpenAI-compatible chat provider: it reuses that provider's endpoint and API key with built-in gpt-4o-mini-transcribe, gpt-4o-mini-tts and alloy defaults. The separate Telegram voice-service section, credential and model fields were removed. Anthropic, Ollama and Bionic LM Studio remain available for text chat; a voice request with one of them returns a localized provider-selection instruction before audio download. Existing saved preset mappings are upgraded at runtime, the direct Telegram example now ships with the preset selected, and help/wiki documentation covers provider and privacy requirements in EN, IT, DE, FR, ES and zh-CN.
  

Version 6.3.25 - August 2026

• IoT Bridge — direct Modbus Flex adapter without a bundled Modbus client: Modbus mappings can now emit the exact modbus-flex-write request consumed by node-red-contrib-modbus and decode modbus-read / modbus-flex-getter responses back to KNX. The protocol-specific editor asks only for Unit ID, zero-based address, Modbus area and Boolean/unsigned 16-bit/signed 16-bit format; FC1–FC6 and quantity are derived automatically. TCP/RTU connections, polling, queues and reconnects remain in the external Modbus nodes. KNX responses never become Modbus commands, write acknowledgements never become KNX state, unchanged polls can be suppressed with Emit on change only, and local KNX echoes are loop-protected. Existing scalar Modbus mappings remain on the legacy contract until explicitly switched to Flex. A safe manual example and the six localized help/wiki sets document the wiring and host-version compatibility.
  
• Dependency cleanup — native asynchronous gateway DNS resolution: replaced dns-sync and its obsolete shelljs → glob@7 → inflight production chain with Node's built-in promise-based OS resolver. KNX gateway hostnames and /etc/hosts resolution remain supported in verbatim address order, while connection startup no longer launches a blocking child process.
  

Version 6.3.24 - August 2026

• Cerebrum Ultimate — working Telegram confirmation buttons: changed the windkh/node-red-contrib-telegrambot preset from inline callbacks to a one-time Telegram reply keyboard. Confirm and Cancel now return as normal localized messages through the already connected telegram receiver, eliminating the silent no-op caused by a missing callback_query event node. Existing saved preset output mappings are upgraded at runtime, the keyboard is removed after the decision, and legacy callback events remain accepted. The importable direct-chat example no longer requires extra callback wiring; help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.
  
• Cerebrum Ultimate — native CHAT learning memory: replaced the verbose Markdown/JSON V2 learning file with the direct line-oriented knxai-chat-context.knxctx V3 format. Sessions, instructions, turns and camera watches are stored as editable tab-separated SESSION, INSTRUCTION, TURN, CAMERA_WATCH and END_SESSION records with escaped text fields, without JSON serialization or a regenerated preview. The Web UI keeps copy, download, restore, revision-safe save and protected reinitialization. Previous .md Markdown/JSON V2 and Base64 V1 files are deliberately not read, imported, migrated or deleted; Cerebrum Ultimate starts a new native context instead. Help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.
  
• Cerebrum Ultimate — compact LLM settings layout: constrained the assistant connection form to a readable responsive width and removed the fixed 290 px indentation that allowed the local-context hint and status line to widen the complete Node-RED properties panel. The model autocomplete now reopens after mouse release, so the full provider list remains visible after a normal click instead of appearing only while the button is held.
  
• Cerebrum Ultimate — resettable CHAT learning: added a protected Reinitialize Memory action to Settings → AI Chat Learning. After explicit confirmation it atomically replaces the shared learning file with a new empty native context, clears sessions, persistent instructions, camera watches and pending chat confirmations across every Cerebrum Ultimate node using the same storage, and refreshes the editor immediately. Concurrent changes remain protected by the existing content revision check.
  
• Cerebrum Ultimate — complete model picker: clicking the model field now opens the complete list returned by the selected provider regardless of the text already present, while typed text can still filter the same list and custom model names remain accepted.
  
• Cerebrum Ultimate — native compact context archives: replaced JSONL serialization for KNX telegram and detected-adapter history with Cerebrum Ultimate's direct line-oriented .knxctx format. Typed payloads, flags and bounded adapter metadata round-trip without repeated JSON property names, while bus and archive summaries are rendered as compact key=value context instead of JSON before reaching the model. Existing JSONL archives are deliberately not read or migrated; new daily files use YYYY-MM-DD.knxctx. The user-editable CHAT learning file remains separate because it is also a portable user backup surface. Context cards, editor help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.
  
• Cerebrum Ultimate — user-selectable local chat context: added a localized Chat context amount selector for Ollama and Bionic LM Studio with 4K, 8K and 16K choices; 16K remains the default. The selected budget proportionally bounds KNX traffic, archives, ETS catalog, Node-RED inventory, memory and adapter context, and is also sent as Ollama's num_ctx, while the complete agent tool contract stays available without phrase classifiers, keyword gates or linguistic intent routing. The context overview now reports the configured operational limit. Editor help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.
  
• Cerebrum Ultimate — reliable conversational recall: verified that session IDs and recent turns were already persisted correctly, then moved the current session memory next to the current request in the operational prompt so small local models do not lose user-supplied facts inside large KNX context. The structured memory tool now explicitly covers durable user facts such as preferred name and language as well as preferences and instructions, while remaining model-selected with no phrase classifiers or intent routing; credentials, security codes and API keys are excluded.
  
• Cerebrum Ultimate — editable and portable CHAT learning: added Settings → AI Chat Learning to the Vue web UI for viewing the exact absolute path and editing, copying, downloading or restoring the shared learning file. The Conversations & home tab in the Node-RED node configuration includes a localized shortcut that opens the Web UI directly on this editor for the current node. Saves are validated, bounded to 512 KB, written atomically and applied immediately to every Cerebrum Ultimate node sharing the same storage, while revision checks prevent stale editors from overwriting newer learning. UI strings, editor help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.
  
• Cerebrum Ultimate — intent-free agentic chat tools: removed hard-coded semantic phrase classifiers from conversational routing. Every Ask/CHAT request now lets the model reason directly over the current goal, persistent user guidance, AI Education and the available structured KNX, camera, TTS Ultimate and memory tools. Routine planning no longer depends on a multilingual keyword list, TTS announcements no longer require an action alias, and durable chat instructions are remembered or forgotten through model-selected structured actions instead of regular-expression intent detection. Runtime argument validation, camera-adapter availability checks, ETS/DPT safeguards and command confirmation remain unchanged.
  
• Cerebrum Ultimate — learned KNX group-address roles: a neutral GA is now treated as unresolved rather than permanently uncontrollable. The conversational model can learn or forget the exact command, status or neutral role from trusted user teaching, persistent chat guidance, AI Education or unequivocal ETS semantics through the structured gaRoleActions tool. Learned role, reason and evidence are persisted per node in knxai-config-<node-id>.json, synchronized into bounded semantic home memory and reused after restart. A command role learned in the current answer can validate a write in that same turn, while exact ETS membership, immutable DPT, payload validation and configured confirmation still apply. Help and wiki documentation were aligned in EN, IT, DE, FR, ES and zh-CN.
  

Version 6.3.22 - August 2026

• Cerebrum Ultimate — visible context size and real prompt weight: the “Chat context overview” card now shows the current operational context limit and the actual UTF-8 size of the last operational chat prompt. Ollama, Bionic, OpenAI-compatible and Claude token-usage fields are captured when returned by the provider; otherwise the UI clearly labels the token count as an estimate. Local limits reflect the active context without exceeding Cerebrum Ultimate's 16K cap.
  
• Cerebrum Ultimate — documentation-free operational chat: Telegram, RedBot and custom CHAT adapters no longer inject packaged help, README, changelog, wiki or example snippets into model prompts. They retain live and archived KNX data, ETS semantics, Node-RED inventory, conversation and home memory, AI Education, cameras and TTS; the web Assistant keeps documentation access for package-support questions.
  
• Cerebrum Ultimate — tolerant safe-read normalization: state queries from small local models no longer become rejected writes when the model returns exact ETS destinations but omits the operation discriminator and payload. Payload-free operations are safely inferred as GroupValue_Read; payload-bearing operations remain writes and retain every ETS-role, DPT, payload and confirmation safeguard.
  
• Cerebrum Ultimate — fixed 16K Ollama runtime and prompt budget: Ollama's advertised model maximum is now informational instead of being sent back as the requested num_ctx. Cerebrum Ultimate caps num_ctx and its relevance-selected semantic prompt at 16K, preventing 131K KV-cache allocation and full-context prefill. An audit confirmed that OpenAI and Claude receive only output limits, not a client-selected maximum context window.
  
• Cerebrum Ultimate — fixed 16K Bionic prompt budget: Bionic's reported active or maximum context can no longer promote conversations to the full 131K data view. Cerebrum Ultimate always builds a relevance-selected 16K semantic prompt for Bionic while preserving the provider's loaded instance, open-ended reasoning, routines, KNX control, cameras and TTS capabilities.
  
• Cerebrum Ultimate — preserve Bionic LM Studio context: model discovery now keeps the context length of an already loaded Bionic instance instead of confusing the model's maximum capability with the desired runtime setting. Cerebrum Ultimate no longer loads inactive models through the management API: the first chat request leaves JIT loading and saved per-model defaults to Bionic, while Cerebrum Ultimate uses a conservative 16K prompt budget until the active configuration can be inspected.
  
• Cerebrum Ultimate — neutral structured-response example: the conversational contract now demonstrates empty action arrays instead of a fabricated group address, DPT, camera and payload. This prevents small local models from copying placeholder operations into unrelated replies such as greetings while preserving open-ended reasoning and every existing KNX, camera, TTS and routine capability.
  

Version 6.3.21 - August 2026

• Cerebrum Ultimate — persistent adapter-event history: every event published by an automatically detected adapter is now normalized into vendor-neutral metadata and appended to a node-specific daily JSONL archive. The archive follows the 10-day KNX retention, guaranteeing at least 24 hours of camera and future adapter events across Node-RED restarts without storing snapshot image data. The editor context card exposes the actual adapter-history directories.
  
• Cerebrum Ultimate — authoritative historical queries: web Assistant, Telegram, RedBot and custom CHAT channels now query both the adapter-event archive and the existing KNX daily telegram files. Historical prompts include totals calculated across every stored row in the requested interval plus relevance-selected detail samples, preventing sample size from being reported as the total. Natural-language ranges now include multilingual “last N hours” requests and are bounded by available retention.
  

Version 6.3.19 - August 2026

• Cerebrum Ultimate — conversational multi-step routines: added coordinated routines such as leaving home, bedtime and cinema mode. Cerebrum Ultimate can now perform a first pass with up to 20 fresh KNX state reads, use the authoritative bus results to prepare an ordered plan of up to 12 validated writes, request one confirmation and then execute the complete routine. After confirmation it waits up to four seconds for immediate matching bus feedback, reports verified and unverified operations without treating missing immediate feedback as a device failure, and dispatches any explicitly requested TTS Ultimate announcement only after execution. Routine details, preliminary readings and execution results are exposed as structured chat metadata. The importable confirmation example, editor help and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.
  
• Cerebrum Ultimate — localized output labels: corrected the four output-pin labels to use the node-scoped Node-RED translation catalog, so Summary, Anomalies, Assistant and KNX Commands follow the active editor language.
  

Version 6.3.18 - August 2026

• Cerebrum Ultimate — focused configuration with fixed defaults: aligned the hidden traffic-analysis defaults to a 600-second history, disk archival enabled for 10 days, automatic summaries disabled, a 120-second analysis window, 5,000 in-memory events and a Top-12 list. The Node-RED project inventory is now always included, while traffic analysis, chat input/output mappings and their obsolete editor controls remain hidden. Documentation language selection was removed because the AI now chooses the appropriate language. Proactive-home switches and advanced proactive settings were removed without legacy-value migration: user-managed AI Education is now the sole configuration surface for this behaviour. Editor help, examples and wiki documentation were updated in EN, IT, DE, FR, ES and zh-CN.
  
• Cerebrum Ultimate — horizontal accordion and visible chat context: rebuilt the editor accordion with the same horizontal-tab layout and visual behaviour as KNXUltimate. Automatically detected adapters now appear at the end, followed by a new context card that summarizes what chat can access, including generated context filenames and the absolute KNX telegram archive directories.
  
• Cerebrum Ultimate — TTS Ultimate announcements: added automatic discovery of node-red-contrib-tts-ultimate and a selector for the TTS Ultimate node to use across all flows. Chat responses can now dispatch spoken announcements through the selected TTS/Sonos path while preserving the existing adapter registry design.
  
• Cerebrum Ultimate — local model providers and responsiveness: promoted Ollama out of beta and added Bionic LM Studio. Model selection now discovers each local model's maximum context length and configures it when loaded; smaller context windows automatically receive reduced, relevance-selected prompts and bounded output budgets, with progressive context compaction on provider overflow errors. Local requests use a ten-minute minimum timeout, preserve detailed provider errors and retry supported OpenAI-compatible parameter variants. Chat users receive localized thinking feedback while inference is running, and the node status now reports only incoming requests and thinking state instead of KNX telegram traffic.
  

Version 6.3.17 - August 2026

• Cerebrum Ultimate — unified Assistant context for chat channels: Telegram, RedBot and custom chat adapters now receive the same complete KNX analysis context as the web Assistant, including the full relevant traffic selection, summaries, areas, learned home memory, Node-RED flow context, Function-node source and documentation snippets enabled by the node configuration. The chat-specific ETS catalog, camera capabilities, persistent conversation context, command validation and confirmation safeguards remain layered on top.
  

Version 6.3.16 - August 2026

• Cerebrum Ultimate — automatically detected camera adapters: installed camera suites can now register vendor-neutral camera catalogs, connectivity state, snapshots and smart events directly in the Cerebrum Ultimate chat runtime, without selectors or camera-node wiring. The “Conversations & home” editor section shows every detected adapter together with its registered controllers and cameras. node-red-contrib-unifi-ultimate is the first provider: users can request or visually analyze a current Protect snapshot and create persistent Telegram/RedBot notifications for motion, smart line crossings and intrusion/loiter zones. Generic smart-detection rules now correctly distinguish classified people, animals, vehicles, faces, license plates and packages from unclassified motion, and match classifications across Protect smart zones, lines and loiter zones. Chat snapshots no longer force full-HD; the provider chooses a supported quality and retries only transient failures at standard quality. An offline camera is identified explicitly before Chat AI proposes an unavailable snapshot. Camera rules share knxai-chat-context.md and survive Node-RED restarts; Telegram adapters emit snapshots as native photos. Existing node-red-contrib-telegrambot presets saved before image support are upgraded at runtime for snapshot replies, including explicit JPEG filename and MIME metadata. The same registry contract is ready for packages such as hikvision-ultimate.
  

Version 6.3.15 - August 2026

• Cerebrum Ultimate — persistent shared CHAT context: every Ask/chat session now reloads its bounded recent conversation and explicit long-term user instructions after Node-RED restarts. Requests such as “remember not to use the term unknown” are retained per session in the atomically written shared file knxultimatestorage/knxai/memory/knxai-chat-context.md, independently from home intelligence memory and even when KNX actuator control is disabled. All Cerebrum Ultimate nodes using the same storage share one live context; the file keeps up to 8 recent turns and 20 durable instructions per session, 50 sessions total, and a 512 KB hard limit. clear_chat removes only the selected shared session and reset clears the shared context.
  
• Cerebrum Ultimate — unified memory files: all Cerebrum Ultimate instances using the same storage now share knxai-home-memory.md and knxai-chat-context.md, without node.id in either filename. Per-node memory files from earlier builds are deliberately not migrated or read.
  
• Cerebrum Ultimate — fixed 5 MB home memory: the shared home-memory file now has a fixed 5 MB limit. The homeMemoryMaxKb editor option has been removed to simplify the UI, and saved values no longer affect runtime behavior.
  
• Cerebrum Ultimate — RedBot Telegram chat adapter: added a selectable RedBot / node-red-contrib-chatbot (Telegram) preset for direct chatbot-telegram-receive → Cerebrum Ultimate → chatbot-telegram-send wiring. It preserves RedBot conversation tracking, maps normalized inbound text and postbacks, and emits native inline-buttons confirmation actions.
  

Version 6.3.14 - August 2026

• Expose KNX to Matter — Room Air Conditioner and Door Lock: added native Matter Room Air Conditioner (0x0072) and Door Lock (0x000A) profiles. A room AC combines On/Off, current temperature, heating/cooling setpoints and fan speed in one endpoint; a door lock maps separate Lock/Unlock command and Locked/Unlocked status GAs. Both profiles support KNX or flow-backed state updates without feedback loops, with editor help and documentation in EN/IT/DE/FR/ES/zh-CN.
  

Version 6.3.13 - August 2026

• Matter: promoted Matter Controller, Matter Bridge and Expose KNX to Matter from BETA to production-ready status; removed BETA labels and experimental warnings from the palette, editor help, examples and multilingual documentation while retaining pairing, backup and endpoint-structure safety guidance.
  
• Matter visual identity: changed the Matter node background to the official Matter Day color (#8FB1FA) and the controller/bridge icon artwork to Matter Night (#131926) for readable, standards-aligned palette and canvas presentation.
  

Version 6.3.12 - August 2026

• HUE Controller: completed the EN, IT, DE, FR, ES and zh-CN editor translations, including Light Level, Locate, Light mapping labels, mapping placeholders, error messages and tutorial links; the embedded profiles and dynamic device labels now follow Node-RED's active locale instead of a potentially stale page-language attribute. Corrected French/Spanish Hue and KNX terminology and realigned the localized help and wiki documentation.
  

Version 6.3.11 - August 2026

• Matter Controller: fixed KNX GA mapping tabs being hidden by transient empty KNX/Matter config-selector values during Node-RED 5 editor initialization; saved gateways now remain selected until the user explicitly changes them.
  

Version 6.3.10 - August 2026

• Watchdog: added a default-on option to listen for error states reported by KNX-Ultimate nodes, including KNX Device, through the selected gateway; disabling it suppresses NodeError flow messages without affecting the Watchdog's own bus checks or control messages. Existing flows retain the previous enabled behavior.
  

Version 6.3.9 - August 2026

• Matter on Home Assistant: declared the Node.js platform adapter as a required runtime dependency so Home Assistant's Node-RED add-on cannot omit it while installing optional packages; Matter Controller and Matter Bridge now load normally instead of reporting Cannot find module '@matter/nodejs' at startup.
  

Version 6.3.8 - August 2026

• HUE Controller: fixed Light and grouped-light mapping tabs remaining hidden when Node-RED emits temporary empty KNX/Hue config-selector values during editor initialization; saved gateways now survive bootstrap and remount, while only an explicit user selection of none hides the mapping tabs.
  

Version 6.3.7 - August 2026

• HUE Controller: improved gateway-dependent editor visibility, preserving all KNX mappings and restoring the correct tab layout when gateways are deselected or reselected; obsolete headings and decorative images were removed.
  
• HUE Controller: added clearer Hue Bridge loading/offline feedback, kept saved mappings visible while disabling unavailable device discovery, and restored the complete previous configuration when the editor is cancelled after previewing another Hue resource.
  

Version 6.3.6 - August 2026

• HUE Controller: grouped lights now always show the complete Light mapping editor when KNX is configured, without checking child-light capabilities.
  

Version 6.3.5 - August 2026

• HUE Controller: fixed Light mapping tabs being blocked by the Hue resource-readiness check and false-success Locate requests. Editor and Locate failures now show a red Node-RED message.
  

Version 6.3.2 - August 2026

• Fixed stop issue in dimme-up.
  

Version 6.3.1 - August 2026

• Updated dependencies, including the security-fixed jsPDF release.
  
• Replaced node-color-log with Winston, shared with the KNXUltimate engine.
  
• Documentation language navigation: fixed localized homepage links returning 404 on GitHub Pages because they incorrectly included a trailing slash.
  

Version 6.3.0 - August 2026

• HUE Controller: unified device-first workflow for all supported Hue API v2 resources, with automatic type detection and legacy-node migration.
  
• Matter: clearer commissioning progress and refined Controller/Bridge workflows and documentation.
  
• Editor pickers: Hue, Matter and KNX Group Address lists now open reliably and show every available entry before filtering.
  

Version 6.2.3-beta.5 - August 2026

• HUE Controller: device-first selection with automatic type detection and all supported Hue API v2 resources.
  
• Device pickers: Hue, Matter and KNX Group Address lists now stay open on click and show all entries before filtering.
  

Version 6.2.3-beta.4 - August 2026

• Matter Controller — live commissioning progress: replaced the pairing overlay spinner with a milestone-based progress bar driven by the actual matter.js commissioning flow. The blocking panel now describes the active discovery, PASE, device-information, fail-safe, regulatory, time-sync, attestation, credential, access-control, CASE reconnect and completion phase in English; when exposed by the commissionee, its product name, Vendor ID and Product ID appear below the current operation. Progress polling is local to the Node-RED editor, stops with the pairing request and is isolated by operation ID across editor tabs.
  
• HUE Controller — unified Hue API v2 node: added one controller node covering the complete set of existing Hue functions: lights and grouped lights, plugs, buttons, Tap dial, motion and camera motion, contacts, light level, temperature, humidity, scenes, battery, Zigbee connectivity and device software update. The compact device-function selector uses one third of the available width and opens the established dedicated editor with its localized labels; KNX mapping fields are hidden whenever no KNX Gateway is selected, including none, an empty value and Add new.... The YouTube tutorial playlist now appears once at the top of the editor, while routine inline form-tips are removed from the unified UI and a compact migration privacy disclaimer remains directly below the conversion button. The migration action runs entirely inside the browser and changes only the legacy HUE nodes requiring conversion, preserving every existing property, config reference, group, position and link; no flow or node data leaves the editor and the workspace remains undeployed for user review. After a successful conversion, an editable email draft addressed to the author opens without navigating the top-level Node-RED page and contains only the converted-node count and space for optional notes; the user decides whether to send it and nothing is sent automatically. The final Node-RED message offers an optional support button, and the PayPal donation page opens only when the user clicks it. Each profile executes the same mature runtime contract, preserving KNX telegram types, Hue event/status direction, flow pins and loop protection. Runtime implementations, editor definitions, templates and all six translation catalogs are embedded as package-internal HUE Controller profiles; registration order no longer matters, the KNX and Hue gateway fields remain real config-node selectors, and the controller has no runtime or editor dependency on deprecated node types. The original Hue Light node remains unchanged. Existing dedicated Hue nodes remain fully compatible and registered, use Node-RED's special deprecated category so they no longer appear in the palette, retain the lighter #E7E9F6 color and (deprecated) canvas suffix without changing saved names, and show a localized HUE Controller migration notice at the top of their editors.
  
• HUE Controller — complete per-function help: the established help of every dedicated Hue node is now incorporated under the corresponding HUE Controller function key, with an anchor index and automatic sidebar focus when the function changes. The same 15-section reference is included in the Controller wiki documentation in EN, IT, DE, FR, ES and zh-CN; legacy deprecation notices are deliberately excluded from the embedded copies.
  
• HUE Controller — legacy-independent maintenance boundary: private runtime profiles and the private editor/template/translation sources are now the canonical implementation of HUE Controller. Its generator and consistency check read only those private sources and never inspect the frozen legacy nodes, so future Controller fixes remain isolated and the dedicated deprecated nodes can eventually be removed without breaking either runtime or UI. Added detailed architecture and lifecycle comments around runtime constructor capture, RED facades, editor mounting, profile drafts, dynamic pins, translations and the Hue Light bootstrap path.
  
• HUE Controller — consolidated documentation: removed all dedicated legacy Hue nodes from the multilingual documentation home cards and HUE navigation, leaving only Hue Bridge configuration and HUE Controller. Reworked the Controller page in EN, IT, DE, FR, ES and zh-CN with a responsive visual overview, the complete 15-function capability map, common Controller behavior, a four-step setup path, optional-KNX guidance, migration details and the full per-function reference inherited from the former dedicated nodes.
  
• HUE Controller — visible migration action: added a localized YouTube guide link immediately before every legacy-flow migration button, pointing to https://youtu.be/f0Evf2QFI7c in HUE Controller and all 15 legacy editors. The action uses a high-contrast orange treatment, forced white text and icon colors that cannot be overridden by Node-RED's button theme, darker hover/active states and an accessible keyboard focus ring so it remains immediately recognizable and readable in light and dark editor themes.
  
• HUE Controller documentation routing: added canonical Jekyll front matter and localized permalinks to every HUE Controller wiki page, fixing the GitHub Pages 404 and restoring correct links between EN, IT, DE, FR, ES and zh-CN.
  
• Matter documentation visual refresh: redesigned the Matter Controller, Matter Bridge configuration and Expose KNX to Matter wiki introductions in EN, IT, DE, FR, ES and zh-CN. The responsive visual overviews now surface the controller lifecycle, commissioning and backup workflow, persistent multi-fabric bridge identity, live endpoint reconciliation, the complete 17-profile device map and concise setup paths while retaining the established technical reference below.
  
• HUE Controller — contextual migration action: the highlighted legacy-flow migration button now appears in HUE Controller only when the Node-RED editor finds at least one registered legacy HUE node in the current flows, and the same orange action is available directly below the deprecation notice in every dedicated legacy HUE editor. All 15 legacy editors share one delegated confirmation dialog with the original pale-yellow backup warning before the fully local conversion and a separate safety notice requiring users to inspect every modified HUE node—function, configuration references, pins and wiring—before Deploy. Locked or changed flows and local conversion errors leave the workspace untouched; successful conversion creates one undoable editor change, opens an editable usage email draft without navigating away from Node-RED, and never deploys or sends email automatically. When these steps finish, a fixed modal Node-RED success message remains visible until the user clicks OK.
  
• HUE Controller — voluntary donation action: removed the automatic PayPal window after legacy conversion. The fixed completion message now offers a localized optional Support KNX Ultimate button alongside OK; the donation page opens in a new browser tab only after the user deliberately clicks that button, and the completion message remains available for flow-review guidance.
  
• HUE Controller — legacy KNX mapping preservation: fixed asynchronous DPT selectors overwriting an existing value when a converted node was inspected and saved before their options had finished loading. Conversion now treats every GA and DPT already stored by all 15 legacy HUE node types as authoritative and preserves those values unchanged; it does not infer, replace or recover missing DPTs.
  
• HUE Controller — light capability discovery: fixed single lights losing their Dim, Tunable White, RGB/HSV and native-effects KNX sections while the embedded Light editor was bootstrapping. Capability discovery now resolves the persisted Hue Bridge configuration instead of Node-RED's temporary _ADD_ selector sentinel, so Hue API v2 dimming, color_temperature, color and effects capabilities enable the corresponding mappings correctly. The legacy Hue Light node remains unchanged.
  
• HUE Controller — bounded Hue Bridge wait: restored the Light editor's spinning-hourglass dialog while the selected Hue Bridge is still loading resources. Readiness is polled every 500 ms and the editor is always released after about 10 seconds with a localized error; Save, Cancel, Close and function changes cancel the timer. Removed the Controller wrapper overrides that had forced the wait icon hidden, and replaced the legacy global-this timer with strict-mode-safe private state. The legacy Hue Light node remains unchanged.
  
• HUE Controller — compact KNX rows: reduced the DPT selector to 90–105 px and the Name field to 70–115 px within Controller mapping rows, keeping GA, DPT and Name on one line instead of wrapping on narrower editor trays. Rows are identified from their strict DPT field IDs after the private profile is mounted, so the scoped layout applies consistently without changing any frozen legacy template or persisted value.
  

Version 6.2.2 - July 2026

• Bump KNX Engine to 6.0.2
  
• Cerebrum Ultimate — streamlined configuration and JavaScript chat editors: removed the raw-hex, custom system-prompt, documentation-toggle, telegram-type and anomaly/pattern controls from the node editor. Cerebrum Ultimate now always listens to GroupValue Read/Response/Write, initializes pattern/anomaly analysis with its established defaults, excludes raw hex from prompts and always includes relevant documentation context. The chat input/output mappings now use the same color-coded JavaScript editors as KNXUltimate (green input and yellow output), including safe save/cancel lifecycle handling; No adapter is the default and keeps both editors hidden. All editor form-tips were removed, and model refresh now uses only a rotating button icon while loading instead of reporting the number of models found. Missing numeric settings now receive their established defaults instead of invalidating older nodes; this includes 120 minutes for the open threshold, 360 minutes for repeat cooldown and 256 KB for home memory. The KNX gateway is the only editor field that remains mandatory.
  

Version 6.2.1 - July 2026

• Cerebrum Ultimate — bounded proactive home intelligence: added an opt-in Proactive home & memory section that derives a multilingual semantic model from ETS hierarchy, names, roles and DPTs and can proactively report reliably recognized covers, windows or doors left open beyond a configurable threshold. Notifications use output 3 with msg.knxAi.type = "proactive_notification", retain the Telegram recipient through msg.inputMessage, obey quiet hours, a per-object cooldown and a maximum of three messages per hour, and never emit autonomous KNX commands on output 4. The LLM treats the user-only AI Education text as authoritative when deciding whether a candidate notification is useful; if Education cannot be evaluated, the notification is suppressed. A Markdown home reference is loaded at Node-RED startup, updated atomically and periodically, cleans stale temporary files, and is limited to 64–1,024 KB (256 KB by default), 120 significant observations, 80 aggregate habits, 80 notification records and 300 semantic ETS objects; older low-priority entries are pruned before the hard file limit can be exceeded. The direct Telegram example demonstrates the bounded memory and proactive settings.
  
• Cerebrum Ultimate — clearer accordion editor and practical guidance: replaced the crowded vertical tabs with three main accordion sections: AI assistant, Conversations & home, and KNX traffic analysis. Opening one section shows all related options together, with no nested tabs or hidden advanced details and no changes to persisted field IDs or values. Help and wiki documentation in every supported language now include realistic values for recipient, threshold, quiet hours, cooldown and memory, a copyable AI Education example, expected proactive/suppressed outcomes, and the KNX safety boundaries.
  

Version 6.2.0 - July 2026

• Cerebrum Ultimate — DPT 1 command payload normalization: fixed actuator writes being rejected when an otherwise valid AI response represented a DPT 1.xxx value as numeric 1/0 (including quoted values) instead of a JSON boolean. Exact safe equivalents true/false, 1/0, on/off and ETS value labels are now normalized to real booleans before local validation, confirmation and Universal Mode output; other numeric values remain rejected.
  
• Sidebar package cleanup: removed the unused KNX Debug and KNX Monitor sidebar tabs, their dedicated admin endpoints and the Debug logger's global 5,000-entry memory buffer. The independent Flow Bubbles plugin and standard Node-RED logging remain unchanged.
  
• Cerebrum Ultimate — conversational actuator control: ask inputs can now produce a text reply on the existing AI Assistant output and separately emit locally validated GroupValue_Write messages on a new KNX commands output for a KNX Ultimate node in Universal Mode. Actuator control is opt-in and off by default; commands are limited to exact imported ETS group addresses classified as commands, must use the ETS DPT, pass payload/range validation and are capped per request. A second option, enabled by default, previews the exact GA/DPT/payload plan and waits up to five minutes for confirmation from the same chat session before emitting anything; cancellation, stale-plan replacement and validation immediately before output prevent an old or changed plan from reaching KNX. Recent chat turns are kept in bounded per-session RAM history, including detected Telegram chat IDs, and clear_chat clears both conversation and pending commands for one session without affecting traffic history. A ready-to-import conversational control example is available under examples/, including simulated chat input, confirmation/cancellation and the Universal Mode connection.
  
• Cerebrum Ultimate — fresh KNX state reads: natural-language requests for a current value can now emit locally validated GroupValue_Read operations for exact objects in the imported ETS catalog, including status and read-only objects. Output 4 supplies the Universal Mode contract (msg.destination, exact ETS msg.dpt, msg.event = "GroupValue_Read" and msg.readstatus = true), waits up to six seconds for a fresh response/write telegram, and returns localized decoded values plus msg.knxAi.readResults on output 3. Reads are immediate and never require confirmation; the existing command-role and confirmation protections remain mandatory for writes. The conversational example now includes a live room-temperature read.
  
• Cerebrum Ultimate — request-language confirmation instructions: whenever validated commands are waiting for confirmation, the assistant now always appends deterministic confirmation/cancellation instructions in the current request language. Explicit message language remains authoritative, followed by the LLM language field, local request-text detection and Telegram/configuration fallback.
  
• Cerebrum Ultimate — button-ready confirmation metadata: pending confirmation replies now expose msg.knxAi.confirmationRequest with session, expiry, command count and localized confirm/cancel actions. Each action includes a stable callbackData value and a ready-to-send Node-RED message, allowing Telegram and other chat nodes to present buttons instead of requiring typed confirmation.
  
• Cerebrum Ultimate — input message passthrough: every AI Assistant and KNX command output now includes an independent copy of the triggering input message in msg.inputMessage, preserving Telegram/chat metadata and custom flow properties for downstream routing. Message-cloning and output-dispatch failures are contained and reported so malformed custom properties or downstream runtime errors cannot produce an uncaught exception or rejection.
  
• Cerebrum Ultimate — streamlined vertical editor tabs: the editor now opens on a compact Quick setup tab containing only the common AI choices (enable, provider, credential, model, KNX commands and confirmation). Capture, storage, detection, AI context and advanced connection controls use the same left-hand vertical tab layout and shared CSS as the Matter editors, with technical fields grouped by topic and no changes to persisted field IDs or configuration values.
  
• Cerebrum Ultimate — selectable chat adapters and direct Telegrambot wiring: a new Chat adapters tab loads preset input/output mappings from resources/KNXAIChatAdapterMappings.js and inserts their editable synchronous JavaScript into two persisted, full-width text boxes. The included windkh/node-red-contrib-telegrambot preset accepts receiver text and callback-query events directly, preserves chat/session/language data, converts output 3 directly to the Telegram sender contract and creates localized inline confirmation buttons from msg.knxAi.confirmationRequest. Adapter syntax/runtime failures are contained and reported, while unrelated outputs remain protected. A ready-to-import direct receiver/event → Cerebrum Ultimate → sender example is included under examples/; the Telegram package remains an optional external dependency.
  
• Cerebrum Ultimate — chat model compatibility: the refreshed OpenAI-compatible model list now excludes known legacy completion-only models such as gpt-3.5-turbo-instruct, davinci-002 and babbage-002. If a manually entered or third-party model rejects /v1/chat/completions, the assistant now reports the selected model and endpoint and suggests a compatible chat model instead of forwarding the provider's opaque error unchanged. Models that accept only the default temperature are retried without the custom temperature field, and token-limit fallbacks can be combined in the same request without discarding the prompt or conversation.
  
• Control Matter from KNX — contextual flow PIN help: Node Input/Output PINs now reveals the capability-driven Flow input section directly below the selector instead of adding a separate editor tab. The section remains hidden while the pins are disabled. Light endpoints now receive contextual, copyable examples for their supported top-level msg.on, msg.dimming, msg.color_temperature and msg.color contracts, while non-light endpoints retain their advertised simple and advanced Matter examples.
  
• Matter Bridge — contextual flow PIN help: Node Input/Output PINs now sits outside the editor tabs and, when enabled, reveals a contextual Flow input/output section directly below it. Copyable Flow → Matter and Matter → Flow examples are filtered to the selected device type, covering lights, covers, thermostats, fans, sensors, alarms and the flow-only robot vacuum while documenting only the message contracts already accepted or emitted by the runtime.
  

Version 6.1.0 - July 2026

• Matter Controller — QR pairing-code reader: the pairing editor can now fill the existing MT:… field by scanning a QR code with the local webcam or reading it from a selected image, including inverted white-on-dark QR codes used by some device web interfaces. Decoding remains entirely in the browser and never uploads the image or video; after a valid QR is read, pairing starts automatically, while manually typed codes still require PAIR. The optional device name is positioned before the scanner, the decoded code remains visible underneath it and fabric backup controls have moved to the bottom of the editor. A prominent blocking progress overlay prevents further editor interactions until commissioning succeeds or fails. When live camera access is unavailable because the editor is not open over HTTPS/localhost, permission was denied or the browser lacks camera support, the editor explains the reason and keeps image loading available.
  
• Matter Controller — commissioned-device status: fixed the connection-state import for the installed matter.js API, so the associated-devices table now reports connected, disconnected, reconnecting or waitingfordiscovery instead of misleading values such as unknown (0). The table has also been regression-tested to preserve every row returned by the controller without collapsing equal Node IDs.
  
• Matter Controller — per-device command isolation: commands now remain ordered inside an independent execution lane for each commissioned Node ID instead of sharing one blocking serial queue. An offline, timing-out or removed device can no longer delay other Matter Controller nodes that react to the same KNX group address. Removed Node IDs are rejected before queueing, every Matter operation has a bounded timeout and pending commands are purged on removal. An unavailable Controller node latches its red status and ignores subsequent KNX/flow commands instead of accepting them optimistically; it resumes automatically when that specific Matter device reports connected, while opening the node editor explicitly enables a manual retry.
  
• Control Matter from KNX — Universal Mode: a dedicated Mode selector now switches between a single Matter device and controller-wide Universal Mode. Its Universal Battery Monitor scans every commissioned node and endpoint for battery Power Source clusters, maintains a normalized cache, publishes an optional aggregate KNX alarm as DPT 1.005, cycles low-battery device names every 2 seconds as DPT 16.001, and answers getAllBatteries flow queries. The alternative All Matter events service preserves the generic attribute/event stream and dynamic read/write/command input.
  
• Universal Battery Monitor — KNX editor and diagnostics: battery options now use the same vertical-tab and ETS/CSV group-address selectors as single-device profiles. Alarm and text mappings are aligned as Function/GA/DPT/Name rows, support editable names and KNX read responses, ignore wired Power Source endpoints, and show an aggregate battery status instead of per-device unknown states.
  
• Matter light capability refresh: Color Control featureMap and the endpoint device type now drive the Tunable White and RGB/HSV tabs. New selections, changed devices and previously saved nodes normalize stale capabilities so Tunable White lights no longer retain unsupported colour mappings.
  
• Matter editor/help cleanup: decorative animated light icons and duplicate localized help headings were removed from the Matter Controller, Matter Bridge and shared light editor where applicable.
  
• Matter Bridge — editor tab orientation: the device editor now uses the same left-hand vertical tab layout as Matter Controller, keeping Mappings and Advanced options visually consistent without changing saved configuration.
  
• Control Matter from KNX — simple flow input and capability help: non-light endpoints now accept the same human-readable msg.payload = { function, value } contract used by Matter Bridge. The selected node and endpoint are implicit; percentages, temperatures and measurements use human units, while omitting value reads a supported state. A capability-driven Flow input tab, consistent with the node's existing editor tabs, replaces the modal help button and provides copyable simple examples plus every advertised readable/writable attribute, command, cluster ID and advanced message. It remains available for flow-only nodes without a KNX gateway. Existing top-level clusterId/command/attribute inputs remain compatible, and Door Lock also accepts {function:"lock",value:true|false}.
  
• Examples — Matter semantic flow input: added an importable, non-destructive Matter Controller example with manual Inject nodes for On/Off, level, cover position, thermostat setpoint, temperature read and Identify. It deliberately creates no matter-config, sends nothing automatically and directs users to select an existing fabric/endpoint and use only functions advertised in the Flow input tab.
  
• Control Matter from KNX — dedicated controller profiles: Window Covering (0x0102), Thermostat (0x0201), Fan Control (0x0202) and Switch (0x003B) endpoints are now selected into explicit capability-driven profiles instead of the anonymous mapped fallback. They share the guarded mapping lifecycle while presenting semantic canvas status; Switch initial/long/multi-press events are filtered to the selected endpoint and exposed on the optional flow output. Simple actuators and sensors remain on the generic mapped profile.
  
• Control Matter from KNX — flow attribute reads and persistent Door Lock status: mapped endpoints now use an unambiguous top-level flow contract: msg.clusterId plus msg.attribute reads an attribute, msg.value makes it an attribute write, and msg.command plus msg.args invokes a command. Reads return the value in msg.payload, may force a remote request with msg.requestFromRemote = true, and accept numeric attribute ID 0. Door Lock nodes now retain their last locked/unlocked canvas status when generic Matter or KNX notifications arrive.
  

Version 6.0.10 - July 2026

• Matter nodes — crash containment: asynchronous bridge state updates, controller client callbacks, engine errors, startup/watchdog timers and the controller command queue are now guarded so rejected promises and EventEmitter errors are reported instead of becoming uncaught exceptions or unhandled rejections capable of stopping Node-RED.
  
• Matter Controller — post-commission naming: assigning a name immediately after pairing now waits for matter.js to finish exposing the root BasicInformation cluster. Root endpoint 0 is resolved explicitly, preventing the misleading BasicInformation cluster not found warning seen when re-adding devices such as Shelly Plug.
  
• Control Matter from KNX — profile deploy crash: Door Lock and multi-purpose profiles now expose the KNX status callback before registering with knxUltimate-config, preventing _Node.setNodeStatus is not a function during deploy.
  
• Control Matter from KNX — flow PIN persistence: the Node Input/Output PINs selection is no longer overwritten from the KNX gateway presence when reopening the editor. The saved choice remains authoritative and inputs/outputs are updated coherently on save.
  
• Matter terminology cleanup: removed leftover Philips Hue wording from Matter controller labels, notifications, runtime status, localized strings and help. Backward-compatible saved configuration keys remain unchanged.
  
• Control Matter from KNX (BETA) — Door Lock support: commissioned Door Lock endpoints (including locks bridged by a vendor Matter hub) are now detected from their real 0x0101 cluster and expose KNX DPT 1 command/status mappings. true invokes lockDoor, false invokes unlockDoor, and subscribed lockState feedback updates KNX without command reflection. NotFullyLocked and Unlatched remain explicit flow states and are never collapsed into an unsafe binary KNX value. The optional remote-operation PIN is stored as a Node-RED credential; endpoints that do not advertise a requested command are rejected instead of receiving an invented operation. This is the first controller-side device profile in the extensible profile architecture requested in discussion #519.
  
• Control Matter from KNX (BETA) — multi-purpose endpoint profiles: the controller node now keeps its established light path unchanged while routing non-light endpoints through a separate capability-driven mapped profile. Selecting a plug/On-Off actuator, cover, thermostat, fan, environmental/contact/occupancy sensor, battery, electrical-power or energy endpoint builds only the KNX mappings backed by clusters, attributes and supported commands actually reported by that endpoint. These mappings now live inside a dedicated Mappings tab beside Behaviour, matching the established light editor layout. Each mapping can be disabled by leaving its GA empty; cached status supports KNX read responses and startup publication, attribute reports never reflect commands back to Matter, and cluster events remain available on the optional flow output. Saved mappings survive an untouched editor save even when the Matter endpoint is temporarily offline.
  
• Matter nodes — cleaner editors: long pairing, storage, cache and endpoint-structure explanations were removed from the Matter node forms and consolidated in the localized HTML help, keeping the editors focused on fields, actions and live operational status.
  
• Matter nodes — distinct canvas icons: Matter Controller and Matter Bridge nodes now use separate compact icons, with mat above a large right/left direction arrow, making the two integration directions immediately distinguishable in the palette, workspace and configuration selectors.
  
• Matter Controller/Bridge — protocol version and portable storage backups: the Node-RED startup version line now logs the implemented Matter protocol revision (Matter 1.5.1, separately from the matter.js package version). Both Matter configuration editors can export and import a per-instance JSON backup containing the complete persistent Matter storage required to preserve fabrics, private credentials, sessions and commissioned/paired nodes. Import atomically replaces only the selected instance and restarts its engine; backup files contain secrets and must be protected like passwords.
  
• Homepage — KNX integration engines, MQTT and Matter overview: the integration-logo heading and Supported technologies section now identify the KNX integration engines and include dedicated MQTT and Matter cards in all six languages (EN/IT/DE/FR/ES/zh-CN), highlighting MQTT/Home Assistant discovery and the bidirectional Matter Controller/Bridge integration for controlling Matter devices and exposing KNX objects to Matter. The feature-request/enterprise-support solicitation, standalone changelog promotion and donation section have been removed.
  
• Expose KNX to Matter (BETA) — dedup for duplicate Alexa light commands: same Alexa quirk as the covers below, on lights: a single "turn on" / "set to 50%" voice request could arrive as up to two identical cluster commands (two On, or MoveToLevelWithOnOff + MoveToLevel with the same level), making the node emit duplicate raw msgs on OnOffLightDevice/DimmableLightDevice (discussion #516). A short leading-edge dedup now forwards the first command immediately (no added latency — lights react instantly) and drops only a command identical to the one just emitted for the same function within the window; any change of value (a real On→Off, or a different brightness) always passes through at once, so genuine commands are never swallowed. The window is exposed in the node's Advanced tab as Alexa duplicate-command window (default 1.2s, 0 = disabled/raw), the same approach the Home Assistant Matter Hub adopted for this Alexa behavior. The complementary ignore brightness after On option (already present) covers Alexa's other habit of sending a brightness right after On.
  
• Expose KNX to Matter (BETA) — Home Assistant Matter Hub-style cover compatibility: WindowCovering now exposes Swap Open / Close and Cover slider debounce in the Advanced tab. Swap reverses the binary KNX Up/Down command and percentage direction symmetrically for Alexa installations that interpret them backwards. Debounce collapses rapid GoToLiftPercentage targets into the last KNX command; 0 uses the adaptive Home Assistant Matter Hub windows (400ms first command / 150ms subsequent commands), while 1–5000 selects a fixed per-cover window. StopMotion remains immediate and cancels every pending movement. Help HTML and Matter Bridge docs were updated in EN/IT/DE/FR/ES/zh-CN.
  
• Expose KNX to Matter (BETA) — cover "arrived" safety net: in Wait for KNX status mode, if no KNX status telegram confirms the exact requested position within a generous window (45s), the node now falls back to reflecting the requested position to Matter anyway. Without this, a real actuator that never reports back the exact requested percentage (positioning tolerance/drift) could leave the Matter device reporting "still moving" forever, since matter.js only clears OperationalStatus on an exact match.
  
• Expose KNX to Matter (BETA) — raw color commands: RGB and tunable-white lights now capture color commands at the same "raw" command boundary already used for On/Off, dimming and covers - a repeated color command (e.g. the same color sent twice) is forwarded on the node's optional output PIN every time, not just on the first. Only possible for ColorControl because it is command-based (MoveToHue, MoveToSaturation, MoveToHueAndSaturation, MoveToColor, MoveToColorTemperature); Thermostat setpoints and Fan speed remain attribute-write only in the Matter spec, so they still report only on actual value changes - there is no lower-level hook matter.js exposes for those.
  
• Expose KNX to Matter (BETA) — fixed WindowCovering percentage commands: GoToLiftPercentage commands (e.g. "Alexa, set the cover to 50%") were being misread as plain Open/Close commands, discarding the requested percentage. matter.js always resolves the command's direction parameter to a concrete Open/Close before calling our handler — it is not a usable signal — while targetPercent100ths is always populated. The node now classifies purely on the target position (0/10000 → Up/Down GA, anything else → Position GA), fixing intermediate cover positions from any Matter controller. Thanks to @till69 for tracing this down in discussion #516.
  
• Expose KNX to Matter (BETA) — removed the "Expose as dimmable light" Alexa workaround: now that the actual cause of Alexa's broken cover percentages is fixed (see above), the v6.0.3 workaround that exposed covers as dimmable lights is no longer needed and has been removed, including its editor checkbox. Breaking for the small number of BETA users who enabled it: existing flows with the option turned on simply revert to a normal Matter Window Covering device on next deploy - you may need to remove/re-add the accessory in your controller's app.
  
• Expose KNX to Matter (BETA) — heating/cooling thermostats: the bridged Thermostat can now expose a Cooling setpoint in addition to the existing heating one. Add a Cooling setpoint command/status GA on the device to automatically upgrade the Matter endpoint to a dual-mode (Heat/Cool) thermostat; leaving it empty keeps the previous heating-only behavior unchanged. Mode (Heat/Cool) switches from the controller are accepted but not yet mirrored back to KNX.
  
• Expose KNX to Matter (BETA) — stable per-device identity: bridged devices now also set the optional UniqueID of BridgedDeviceBasicInformation (matching the existing serial number), improving cross-reset device identity for controllers that rely on it (e.g. Apple Home) alongside the endpoint number.
  
• Matter Bridge/Controller — safer shared storage initialization: the storage.path write on the process-wide matter.js Environment.default, followed by the ServerNode/CommissioningController creation, is now serialized through a small FIFO lock (matterEnvironmentLock.mjs) shared by both engines, removing a theoretical race between a concurrently starting Matter Bridge and Matter Controller.
  

Version 6.0.4 - July 2026

• Expose KNX to Matter (BETA) — clearer editor layout: reorganized the device editor into dedicated KNX mappings and Advanced options tabs, following the established KNXUltimate node UI. Type-specific compatibility settings are easier to find, and checkbox labels now include icons with the checkbox positioned after the text. All saved fields and runtime behavior remain unchanged.
  

Version 6.0.3 - July 2026

• Expose KNX to Matter (BETA) — Alexa cover percentage workaround: covers/shutters can optionally be exposed to Matter controllers as dimmable lights when Alexa does not send percentage commands to a native Window Covering endpoint. Brightness represents openness (100% open, 0% closed), while On/Off opens or closes the cover. Commands and status remain mapped through the existing KNX cover position GA/DPT, including position inversion and loop-protected KNX-to-Matter feedback. The standard Matter Window Covering endpoint remains the default.
  

Version 6.0.2 - July 2026

• Expose KNX to Matter (BETA) — covers/shutters with Alexa: initialize position-aware covers with a valid numeric Matter position instead of an unknown (null) value. This helps controllers such as Alexa expose percentage positioning and send GoToLiftPercentage instead of degrading to Open/Close only. Added targeted command diagnostics to the Node-RED log and output message for interoperability testing.
  
• Expose KNX to Matter (BETA) — raw flow output: On/Off and absolute dimming commands are now captured at the Matter command boundary, so the optional output PIN forwards repeated commands even when the Matter state is already unchanged. Matter validation still runs before KNX routing, and KNX-to-Matter status updates remain loop-protected.
  

Version 6.0.1 - July 2026

• Expose KNX to Matter (BETA) — flow-only covers/shutters: fixed intermediate position commands reaching the Node-RED output but not being optimistically confirmed to Matter when no KNX command group address was configured. Voice assistants such as Alexa no longer report that the device is not responding after a percentage-position command.
  

Version 6.0.0 - July 2026

• BREAKING CHANGE: this release intentionally bumps the package to 6.0.0 because the Matter node model changed. The unpublished dedicated Matter controller nodes and the old generic Matter Device node have been replaced by the new single Control Matter from KNX (BETA) node, and the KNX-to-Matter bridge/editor behaviour has been reworked. Existing experimental Matter flows created with the previous beta nodes may need to be rebuilt or adjusted.
  
• Matter nodes are BETA: all Matter nodes are experimental and may be changed, renamed, removed, or replaced at any time until the Matter integration leaves the BETA phase. Do not treat their editor fields, flow JSON structure, runtime behaviour, storage layout, or exposed APIs as stable yet.
  
• New Control Matter from KNX (BETA) node: a single capability-driven Matter controller node. Select a commissioned Matter endpoint and the editor shows only the KNX mappings supported by that endpoint (switch, brightness, color temperature, temperature, humidity, lux, occupancy, contact and battery). Light endpoints keep the familiar light-style tabs and the main KNX light options from the dedicated node, including relative DIM (DPT 3.007), brightness %, tunable-white DIM/Kelvin, switch-on brightness/temperature, dim speed, min/max dim level, tunable-white direction inversion and optional day/night lighting. This replaces the unpublished dedicated Matter controller nodes and the old generic Matter Device node.
  
• Matter Bridge device (BETA) is now presented as Expose KNX to Matter (BETA) in the editor, with advanced compatibility options for real-world KNX actuators: dimmable devices can ignore brightness commands sent immediately after On, and covers/shutters can optimistically update their Matter position while waiting for the real KNX status feedback.
  
• Matter Controller pairing and device list improvements: clearer commissioning errors, persistent error dialogs, better logging, device names shown more consistently, and direct rename support from the associated-devices list.
  
• Documentation: added localized editor help and online docs for the new Matter nodes in EN/IT/DE/FR/ES/zh-CN, and expanded the Matter section in the documentation navigation.
  

Version 5.2.5 - July 2026

• Maintenance release.
  

Version 5.2.4 - July 2026

• Matter Bridge — bridge name: the Matter bridge name field (the name Alexa/Google/Apple show for the bridge itself) now falls back to the configuration node's own Name when left empty, instead of the generic KNX-Ultimate Bridge. The field is empty by default with a placeholder hint, so a freshly named bridge is never anonymous during pairing.
  
  • Naming clarification: Alexa and Google Home honor the names set on the bridge and on the device nodes, so they appear automatically in the apps. Apple Home deliberately ignores the provided names and asks you to name each accessory manually during setup — this is an Apple/HomeKit limitation, not a bridge issue. Node help and the online docs now document this difference in all six languages (EN/IT/DE/FR/ES/zh-CN).
    

Version 5.2.3 - July 2026

• MQTT / Home Assistant bridge — Entity name format: new selector to reshape the names exposed to Home Assistant. The ETS import builds each name with the group-address path first (e.g. (Lights->Ground floor) Living room); now you can choose As imported from ETS (default), Name first (Living room (Lights->Ground floor)), Name only (Living room) or Name + group address (Living room (0/1/2)). Changing it only updates the friendly name (the unique_id/object_id stay stable, so existing entities are not duplicated).
  
  • The group-address list in the editor now previews the chosen format live: pick a format and every row is re-labelled instantly, exactly as it will appear in Home Assistant, without reloading the list or losing the expose / read-only ticks.
    
  • Entity names are sanitized before publishing: ASCII control characters are stripped and runs of whitespace collapsed (ETS exports sometimes lose an accented character and leave a double space, e.g. Velocità vento → Velocit vento), and a name that would be empty falls back to the group address.
    
• Documentation: node help and the online IoT-Bridge page updated for the new option in all six languages (EN/IT/DE/FR/ES/zh-CN).
  

Version 5.2.2 - July 2026

• New Matter Bridge (BETA): exposes KNX group addresses as Matter devices. Alexa, Google Home, Apple Home (or any Matter controller) commission the bridge once — via QR code or 11-digit manual code shown in the editor — and see all your KNX devices with the names you typed, ready for app and voice control. It is the opposite direction of the Matter Device node introduced in 5.1.0.
  
  • Two-node architecture (like the HUE and Matter Controller integrations): a Matter Bridge configuration node is the bridge itself (holds the pairing, the QR code and the port), and a Matter Bridge device node is added per exposed device and points to it. Spread the device nodes across your flows, each with its own status — no giant list.
    
  • 17 device types: on/off light, dimmable light, RGB color light (DPT 232.600, converted to/from the Matter color wheel), tunable white light (color temperature in Kelvin, DPT 7.600), plug, cover/shutter (up/down, stop, position % with optional inversion), thermostat (current temperature + heating setpoint, both ways), fan/ventilation (speed %), sensors (temperature, humidity, illuminance, occupancy, contact), smoke/CO alarm, water leak detector, air quality sensor (CO2 ppm with automatic air-quality classification) and robot vacuum (flow-only: integrate your robot with any Node-RED node and expose it to the voice assistants).
    
  • Bidirectional with loop protection: assistant commands write to the KNX command group addresses; telegrams on the status group addresses update the Matter attributes (and the apps). At startup each device node can send a GroupValue_Read to its status GAs so the Matter attributes are populated before the first app query.
    
  • Live device reconciliation: the Matter server stays alive across re-deploys — added/renamed/removed device nodes appear on the paired controllers within seconds, without restarting Node-RED and without re-pairing.
    
  • Optional node Input/Output PINs: the output forwards every controller command to the flow; the input updates the Matter state from flow messages (msg.payload = { function, value }). Devices without a command GA become flow-only devices.
    
  • The KNX gateway is optional on the device node: without it the device runs in flow-only mode, useful to expose flow-computed or non-KNX devices to Alexa & Co.
    
  • Multi-fabric: several controllers can be paired at the same time; the pairing panel lists them and a Reset pairing button decommissions everything. The bridge identity persists across re-deploys (no re-pairing needed). Each configuration node can use a different UDP port, so multiple independent bridges are possible.
    
  • Editor with ETS group-address autocomplete filtered per function: the KNX gateway is resolved automatically (auto-selected when only one exists), so the address list is always available. Localized in EN/IT/DE/FR/ES/zh-CN.
    
  • Note for early 5.2.x BETA testers: the two-node split changes the Matter identity of the bridge - remove the old bridge from your Matter app and pair the new configuration node once.
    
• Matter Device node editor: the mappings list grows to fill the edit panel and has a native resize grip (bottom-right corner) to drag it to any height.
  
• Matter integration hardening: try/catch protection on all critical paths (controller startup, client registration, structure queries, commissioning aftermath) so errors never crash Node-RED. Fixed the devices editor losing the configured group addresses on close/reopen (with automatic recovery of configurations saved by the affected versions).
  
• Documentation: node help for the three Matter nodes in all six languages, new Matter section in the online docs sidebar with the Matter Controller, Matter Device and Matter Bridge pages (EN/IT/DE/FR/ES/zh-CN), the two new nodes on the homepage node list and the Matter logo alongside Home Assistant and MQTT.
  

Version 5.1.0 - July 2026

• New Matter integration (BETA): control any commissioned Matter device from the KNX bus and track its states on KNX group addresses.
  
  • New Matter Controller configuration node: a full Matter controller with its own fabric (based on matter.js). Pair devices directly from the editor using the 11-digit manual pairing code or the QR code content (MT:...); commissioning works over the IP network (WiFi/Ethernet or Thread via border router). The commissioned devices list shows name, product, node ID and connection state, with one-click unpair. Fabric credentials are stored under knxultimatestorage/matter in the Node-RED user directory.
    
  • New Matter Device (BETA) node: pick a paired Matter device and map KNX group addresses to its functions with a dynamic mapping list. The function list is human friendly: it shows only the functions the device really exposes, with plain-language localized names (e.g. "On/Off switch", "Instantaneous power (W)", "Room temperature (°C)") and the current value in brackets, instead of raw Matter cluster/attribute names. Friendly endpoint names for 34 common device types (smart plug, dimmable light, cover, thermostat, sensors...).
    
  • Mappings are bidirectional: KNX → Matter (commands/attribute writes, e.g. GA 1/1/1 DPT 1.001 → OnOff) and Matter → KNX (attribute changes written to the GA; GroupValue_Read requests answered from the cache). Automatic value conversion for the common clusters: OnOff, LevelControl (0-254 ↔ %), WindowCovering (percent100ths ↔ %, up/down), ColorControl (mireds ↔ Kelvin), Thermostat and temperature/humidity sensors (centi-units ↔ units), illuminance (log scale ↔ Lux), battery (half-percent ↔ %), power/energy metering (mW ↔ W, mWh ↔ kWh), door lock, occupancy and contact sensors.
    
  • Selecting a function pre-fills the suggested KNX DPT and the GA name; the group address field has the usual ETS autocomplete. Optional node input/output pins for raw Matter access from the flow. Editor and help localized in EN/IT/DE/FR/ES/zh-CN.
    

Version 5.0.4 - July 2026

• IoT Bridge node, Covers & Thermostats editor: fixed the group-address autocomplete, which suggested only DPT 1.x addresses in every field. Each field now filters by the datapoint it expects: cover Set/Status position GAs list DPT 5.x (5.001), and the thermostat Current temperature and Setpoint set/status GAs list DPT 9.x (9.001). Up/Down, Stop and On/Off keep their 1.x filter.
  

Version 5.0.3 - July 2026

• Added a link to the KNX-Ultimate YouTube tutorials playlist at the top of every node's configuration panel, so the video tutorials are one click away from any node.
  

Version 5.0.2 - July 2026

• IoT Bridge node, MQTT / Home Assistant (native) mode:
  
  • New Read only flag per group address in the Group addresses to expose list: a read-only GA is still published to Home Assistant (its state stays visible) but never accepts commands back to the KNX bus (switches are exposed as binary_sensor, numbers/text as sensor). Added Set read only / Clear read only buttons that apply it to all currently shown (filtered) addresses.
    
  • New KNX bus connection selector: Stand-alone (default, talks to the KNX gateway directly) or Flow messages, which enables the node's input/output pins — wire a KNXUltimate node in Universal mode to the input (KNX bus → MQTT) and another to the output (MQTT → KNX bus). Pins are shown only when needed (none in stand-alone, one input + one output in flow mode).
    
  • Editor help and online docs updated in EN/IT/DE/FR/ES/zh-CN.
    

Version 5.0.1 - June 2026

• IoT Bridge node (renamed MQTT - IoT in the UI): new MQTT / Home Assistant (native) mode selectable via a Mode dropdown. In this mode the node connects directly to an MQTT broker and bridges KNX ↔ MQTT both ways, publishing Home Assistant MQTT Discovery so KNX appears automatically in Home Assistant (no mqtt in/mqtt out wiring needed). The classic IoT bridge mode is unchanged.
  
  • Every group address imported in the KNX gateway (ETS list) can be exposed automatically as a Home Assistant entity (switch, sensor, binarysensor, number, text), typed from its DPT. A checkbox list with filter and _Select all / none lets you choose exactly which GAs to publish.
    
  • New Covers & Thermostats editor: composite entities that aggregate several GAs (cover with up/down, stop and position including KNX↔HA position inversion; thermostat with current temperature, setpoint and optional on/off). The cover/thermostat GA fields have ETS group-address autocomplete, like the KNX device node.
    
  • Robust lifecycle: the MQTT broker is closed gracefully on deploy / Node-RED exit (retained offline, forced disconnect, hard-capped so a slow or unreachable broker never blocks a deploy); all MQTT event handlers are fully guarded.
    
  • Editor help and online docs updated, plus Home Assistant / MQTT logos on the docs pages. Localized in EN/IT/DE/FR/ES/zh-CN.
    

Version 5.0.0 - June 2026

• KNXUltimate engine: updated to 6.0.1 (see the engine CHANGELOG).
  
• KNX config node: new "Reveal keyring passwords" button in the Utility tab, enabled only when KNX Secure is selected. It shows, in clear text, all the keyring passwords (interfaces, backbone, group addresses and devices keys/passwords) plus the general keyring password, decoded from the loaded keyring file. Localized in EN/IT/DE/FR/ES/zh-CN.
  

Version 4.3.24 - June 2026

• Hue Contact Sensor and Motion nodes: fixed the state on the KNX bus getting stuck on a wrong value (e.g. a contact sensor showing closed while the door stayed open) after the Hue event-stream reconnected. The nodes now re-publish the authoritative state at startup and after every (re)connection, and ignore stale/out-of-order reports by checking the contact_report.changed / motion_report.changed timestamp. Closes #514.
  

Version 4.3.23 - June 2026

• Hue nodes: fixed the help text not appearing in the editor sidebar when selecting a node. The help is now declared inline in each node's main HTML file (sidebar reads help from there; the locales/ files keep providing translations). Affected nodes: Light/Outlet, Area Motion, Battery, Button, Contact Sensor, Light Sensor, Motion, Scene, Tap Dial, Temperature Sensor, Zigbee Connectivity and Device Software Update. Also closed an unterminated template <script> tag in the Hue Light node.
  

Version 4.3.22 - June 2026

• Hue config node: when the user clicks "I already have the credentials" to enter the connection data manually, the now-useless CONNECT button is hidden.
  

Version 4.3.21 - June 2026

• KNXUltimate engine: updated to 5.5.9.
  

Version 4.3.20 - June 2026

• Cerebrum Ultimate: new Flow Builder (BETA) tab in the AI web page — describe an automation in plain language and the AI generates a ready-to-import Node-RED flow (JSON) using KNX Ultimate nodes, the Philips Hue nodes and native Function/logic nodes, wired to your imported group addresses. Copy the JSON and paste it via Node-RED Menu > Import. Generated node ids, wiring and config-node references are validated and rewired server-side before output.
  
• Cerebrum Ultimate: added Anthropic (Claude) as an LLM provider alongside OpenAI-compatible and Ollama. Uses Claude's native Messages API; model and API key are configurable from the node (default claude-opus-4-8), with model auto-discovery.
  
• Cerebrum Ultimate: Flow Builder UI is fully localized (EN/IT/DE/FR/ES) and laid out side-by-side (prompt and generated JSON); minor sidebar fix so long menu labels are no longer truncated.
  

Version 4.3.19 - June 2026

• Docs: reworked the multilingual FAQ & Troubleshoot wiki pages — rewrote the ES/FR pages in the clean concise style, removed a garbled machine-translated tail from the IT page, and deleted 5 orphan FAQ files not referenced in the navigation.
  
• Docs: added a dedicated FAQ section about Weinzierl (73x) KNX/IP interfaces that may need Suppress ACK request (e.g. over VPN/high-latency links), in all 6 languages.
  
• Editor: when a Weinzierl interface is selected from the discovery dropdown in the gateway config node, Suppress ACK request is now enabled automatically (it only enables it, never overrides a manual choice, and shows an info notification).
  

Version 4.3.18 - May 2026

• Bump Engine to 5.5.8
• Security: removed unused dependency translate-google (which transitively pulled in the critically vulnerable safe-eval package). No functionality was affected as the package was never referenced in the codebase.
  
• Security: applied npm audit fix to resolve moderate and high vulnerabilities in brace-expansion, diff, minimatch, picomatch, postcss, and vite.
  
• Tests: added unit test suites for payloadManipulation (Manipulate), utils (ToBoolean, fetchFromObject), ColorConverter (kelvin/mirek, scale, brightness, HSV/RGB, hexRgb, xyBriToRgb) and XYFromRGB_Supergiovane (calculateXYFromRGB) — 83 new tests, total suite 117 passing.
  

Version 4.3.17 - May 2026

• Examples: expanded the examples/ folder to provide dedicated Node-RED flow files for all remaining KNX Ultimate nodes, including KNX Staircase, KNX Garage, KNX Load Control, KNX IoT Bridge, KNX Auto Responder, KNX Alerter, KNX Global Context, KNX HA Translator, and the full Philips Hue node set.
  
• Examples: adopted a consistent one-file-per-node approach so users can import focused flows and quickly understand each node configuration and behavior.
  

Version 4.3.16 - May 2026

• Docs/help/wiki: updated KNX DateTime help HTML and DateTime wiki pages (EN/IT) to document current DPT 19.001 behavior based on JavaScript Date, additional input object fields (msg.payload.dateTime / timestamp / epoch), queued send while gateway is disconnected (latest pending only), and output metadata msg.knxUltimateDateTime.date.
  
• Bump knxultimate Engine to 5.5.7
  

Version 4.3.15 - May 2026

• FIX: DPT dropdown in editor now remains open when clicking on an already populated datapoint field (no immediate close on mouse button release).
  
• Docs: added GitHub badges Commit activity and Last commit to the README header.
  

Version 4.3.13 - May 2026

• Bump KNX Engine to 5.5.6
  

Version 4.3.12 - May 2026

• Docs/help/wiki: refined KNX DEVICE / KNX Function wording in all supported languages (EN/IT/DE/FR/ES/zh-CN) to state explicitly that getGAValue(...) must always be used as await getGAValue(...); without await the function returns a Promise, not the GA value.
  
• UI: updated remaining KNX Function helper snippets to always use await getGAValue(...) in practical examples.
  

Version 4.3.11 - May 2026

• Docs/help/wiki: clarified in KNX DEVICE / KNX Function help HTML and Device wiki pages in all supported languages (EN/IT/DE/FR/ES/zh-CN) that getGAValue(...) is async and should be used as await getGAValue(...), even in cache-only mode.
  
• UI: updated KNX Function editor helper/snippet and Monaco typings so getGAValue(...) is suggested with await and exposed as a Promise in the editor.
  

Version 4.3.10 - April 2026

• CHANGE: KNX Function getGAValue(...) now accepts an optional readIfMissing boolean. Default is true to preserve the current behaviour; pass false to use cache-only mode and immediately return undefined when the GA value is not available locally.
  
• PERF: KNX Function getGAValue(...) and KNX cache lookups now use indexed GA access plus deduplicated pending reads, reducing overhead and avoiding duplicate simultaneous GroupValue_Read requests for the same GA.
  
• Docs/help/wiki: updated KNX DEVICE / KNX Function help HTML and Device wiki pages in all supported languages (EN/IT/DE/FR/ES/zh-CN) to document the new getGAValue(..., readIfMissing) signature and cache-only mode.
  

Version 4.3.9 - April 2026

• Bump KNX Engine to 5.5.3 (fixed umlaut issue in dpt16)
  

Version 4.3.8 - April 2026

• FIX: Cerebrum Ultimate Web Assistant Ask tab now truly uses the full available content width on desktop too; removed the leftover 50vw cap that still kept the panel at half width.
  
• FIX: KNX DEVICE in universal mode (listenAllGA) now falls back to raw instead of raising a datapoint-detection error when no ETS DPT is available and automatic inference fails; raw bytes remain available in msg.knx.rawValue.
  
• NEW: Cerebrum Ultimate can now optionally archive captured telegrams to disk under knxultimatestorage, with configurable retention in days and automatic reuse of the archive for Ask queries.
  
• CHANGE: Cerebrum Ultimate Ask now uses the disk archive by default when enabled, honoring explicit time references and otherwise searching the last 24 hours plus current RAM events.
  
• CHANGE: Cerebrum Ultimate flow context for the AI prompt now includes the whole Node-RED project inventory, not only KNX nodes or the current flow, so function/change/inject/template nodes with KNX-related logic are visible to the assistant.
  
• FIX: Cerebrum Ultimate Ask now includes the real JavaScript source of Node-RED function nodes for code-review questions, instead of exposing only short flattened snippets that could make the assistant say it could not inspect the full code.
  
• UI: Cerebrum Ultimate editor options were reorganized into clearer sections, with technical tuning moved under Advanced, several low-value LLM tuning fields removed from the editor, and localized tab labels/help/docs updated in all supported languages.
  
• UI: Cerebrum Ultimate Web Assistant Ask panel now uses the full available page width instead of being capped to half-page width on desktop.
  

Version 4.3.6 - April 2026

• UI: when KNX DEVICE is set to dpt = raw, the editor now hides decoded-payload options that do not apply to raw telegrams, including RBE, periodic send, format numeric values, manual write button modes, and notifyreadrequestalsorespondtobus.
  

Version 4.3.5 - April 2026

• NEW: KNX DEVICE now supports explicit dpt = raw mode for incoming telegrams: decoding is skipped, msg.payload is null, and raw bytes remain available in msg.knx.rawValue.
  
• FIX: KNX DEVICE RAW write now accepts both msg.bitlength and legacy msg.bitlenght, with bitlength preferred and old flows kept backward compatible.
  
• CHANGE: KNX DEVICE in dpt = raw mode now accepts raw outgoing telegrams only via msg.writeraw, preventing accidental normal writes with an invalid datapoint.
  
• Docs/help/wiki: updated KNX DEVICE help HTML and Device wiki pages in all supported languages (EN/IT/DE/FR/ES/zh-CN) to document raw mode and the preferred bitlength property.
  

Version 4.3.4 - April 2026

• UI: KNX Function editor areas now have colored backgrounds (light green for input→bus, light yellow for bus→output) for easier visual distinction.
  
• UI: KNX Function Monaco editor no longer shows red underlines for custom KNX functions (getGAValue, setGAValue, toggle, self).
  
• NEW: KNX Function : let val = await getGAValue(...) now automatically sends a GroupValue_Read to the KNX bus when the requested group address has no cached value yet, and waits up to 3 seconds for the device to respond before returning null. Use await getGAValue(...) in your KNX Function code to benefit from this behaviour.
  

Version 4.3.3 - April 2026

• UI: in the KNX Function helper, the Search GA field is now always visible; if the ETS CSV is not imported, the field is disabled and shows To enable the search, IMPORT THE ETS FILE.
  
• In the KNX DEVICE NODE, added the "toggle with status" function snippet.
  

Version 4.3.2 - April 2026

• Docs/help/wiki: updated Cerebrum Ultimate help HTML and wiki pages in all supported languages (EN/IT/DE/FR/ES/zh-CN) to reflect the latest LLM/Ollama UX changes.
  
• Docs/help/wiki: documented the new Ollama quick setup flow (Download model -> Install it).
  
• Docs/help/wiki: clarified that the LLM Assistant tab is shown first in the Cerebrum Ultimate editor for faster setup.
  

Version 4.3.1 - April 2026

• Bumped KNXEngine to 5.5.2
  
• UI: Cerebrum Ultimate Web now always opens on the first menu item (Overview).
  
• FIX: Cerebrum Ultimate Web Assistant preset prompts now send the exact current button text to the AI request, so localized UI labels are used directly (no forced English fallback).
  

Version 4.3.0 - April 2026

• Bumped KNXEngine to 5.5.1
  

Version 4.2.14 - April 2026

• FIX: KNX Logger XML download now works also with Node-RED authentication enabled by appending the active editor access_token and respecting httpAdminRoot when opening the download URL.
  
• FIX: KNX Logger admin download route now normalizes access_token from query into Authorization: Bearer ... before permission checks, then removes it from query parameters to avoid auth conflicts.
  
• FIX: resolved authenticated XML export failures (401 Unauthorized) reported in issue #502.
  

Version 4.2.13 - April 2026

• FIX: Cerebrum Ultimate Web hardened authenticated requests by always attaching Bearer auth on API/audio calls (query token or Node-RED stored editor token fallback), preventing silent audio failures in authenticated sessions.
  
• FIX: Cerebrum Ultimate Tests now validates audio responses (audio/*) and reports auth/session issues explicitly instead of failing silently when HTML/login pages are returned.
  
• NEW: Cerebrum Ultimate Tests now announces test completion by voice at the end of the test run (single and repeat-stop end states).
  
• UI: Cerebrum Ultimate Tests added a blocking wait popup while building a Test Plan from the template builder, aligned with the existing AI Areas wait overlay behavior.
  
• i18n: normalized Duplicate / Duplicate Plan action labels to imperative form across supported UI languages for consistency in the Tests page.
  

Version 4.2.12 - April 2026

• FIX: Cerebrum Ultimate Web and KNX Viewer Web admin routes now normalize access_token auth safely by mapping query token to Authorization: Bearer ... only when missing, then removing access_token from req.query before permission checks.
  
• FIX: resolved intermittent 400 Bad Request on authenticated web pages caused by duplicate bearer token sources (header + query string).
  
• CHANGE: extracted shared auth normalization helper to nodes/utils/httpAdminAccessToken.js to keep AI/Viewer behavior aligned and easier to maintain.
  

Version 4.2.11 - April 2026

• UI: Cerebrum Ultimate Web improved assistant workflow with chat-style layout (prompt input under messages), clearer prompt focus, and streamlined Ask page text.
  
• UI: Cerebrum Ultimate Web added clearer loading feedback for AI operations (area regeneration/deletion and planner generation), including a centered blocking wait overlay during long-running area generation.
  
• NEW: Cerebrum Ultimate Web added bulk action Delete AI Areas and localized labels for Regenerate AI Areas / Delete AI Areas across supported UI languages.
  
• FIX: Cerebrum Ultimate backend hardened JSON extraction/parsing for LLM outputs and improved timeout/token-limit diagnostics in error messages.
  
• CHANGE: Cerebrum Ultimate backend raised default/forced llmMaxTokens handling for structured responses and aligned editor defaults for high-token completions.
  
• Docs/wiki: improved Cerebrum Ultimate Dashboard pages for end users, added localized guidance updates, and made support CTA links visible in docs navigation.
  

Version 4.2.10 - April 2026

• UI: Cerebrum Ultimate Web sidebar menu style aligned to Homebridge (font size/weight, spacing, icon/text alignment and sidebar widths) for closer visual consistency.
  
• UI: Cerebrum Ultimate Web removed sidebar menu subtitles to keep navigation labels clean and compact.
  
• UI: Cerebrum Ultimate Web Assistant tab: the Ask panel is now half-page width on desktop and full width on smaller screens.
  

Version 4.2.7 - April 2026

• UI: Cerebrum Ultimate Web layout and visual style aligned to the Homebridge-like interface, with unified orange accent palette and cleaned component styling.
  
• CHANGE: Cerebrum Ultimate Web removed legacy theme management and related theme files, keeping a single coherent visual theme.
  
• UI: Cerebrum Ultimate Web navigation/workspace refactor: dedicated pages for Settings and Test Results, plus improved menu structure and labels.
  
• NEW: Cerebrum Ultimate Web Settings now includes split tabs (Cerebrum Ultimate Node and Import / Export) and moved node selection/auto-refresh controls into the dedicated node settings panel.
  
• NEW: Cerebrum Ultimate Web Test Results can now be exported to PDF directly from the selected report.
  
• FIX: Cerebrum Ultimate Web area editor unsaved-changes detection no longer prompts discard/stay immediately after saving a newly created area and pressing Close.
  

Version 4.2.5 - March 2026

• NEW: added the KNX Flow Bubbles editor plugin to visualize live KNX Device state directly on the workspace.
  
• FIX: KNX Flow Bubbles are now removed correctly when disabled, and their visibility is evaluated per linked KNX Gateway config-node instead of globally.
  
• UI: KNX Flow Bubbles shell is now fully round for a cleaner visual appearance.
  
• Docs/help/wiki: documented the Enable flow bubbles plugin option in the gateway editor and supported documentation languages.
  
• Docs: removed obsolete references to Echo sent message to all node with same Group Address and aligned the text with the current automatic local mirroring behavior.
  

Version 4.2.4 - March 2026

• NEW: KNX Viewer Web added a new Vue-based web page, opened directly from the KNXViewer node editor, to visualize KNX lights and dimmers in a modern dashboard.
  
• UI: KNX Viewer Web uses a visual style aligned with Cerebrum Ultimate, including live light/dimmer cards, search, node selection and auto-refresh.
  
• IMPROVE: KNX Viewer Web ON lights now use a much stronger yellow highlight for clearer visual feedback.
  
• CHANGE: package build/publish flow now also includes the KNX Viewer Web Vue bundle.
  

Version 4.2.3 - March 2026

• IMPROVE: Cerebrum Ultimate Flow Map added a new toggle to show or hide knxUltimate nodes running in Universal Mode; they are now hidden by default to keep the topology cleaner.
  

Version 4.2.2 - March 2026

• CHANGE: Cerebrum Ultimate Web Page is now the official Vue-based dashboard served from /knxUltimateAI/sidebar/page.
  
• CHANGE: removed the old Cerebrum Ultimate legacy web page and its dedicated editor button, keeping the Vue preview as the only web UI entrypoint.
  
• IMPROVE: Cerebrum Ultimate Flow Map in the Vue dashboard: wider layout, fullscreen toggle, animated/dashed traffic arrows, refined marker sizing and better panel width usage.
  

Version 4.2.1 - March 2026

• FIX: KNX Hue Light brightness writes are now applied even when the Hue light is OFF, without forcing the light to switch on.
  
• FIX: KNX Hue Light grouped light handling: when a grouped_light is OFF and receives a brightness write, the node now presets supported member light resources first, so the brightness is ready when the group is turned on later.
  
• TEST: extended KNX Hue Light coverage for brightness writes on OFF lights and OFF grouped lights.
  
• UPDATE: KNXUltimate engine bumped to 5.4.0
  

Version 4.1.35 - March 2026

• NEW: Cerebrum Ultimate anomalies output now always emits dedicated bus connection events when the KNX gateway connection is lost and when it is restored.
  
• NEW: Cerebrum Ultimate Web Dashboard added a bus connection persistence section with a green/red time bar showing connected/disconnected periods over the history window.
  

Version 4.1.34 - March 2026

• FIX: KNX Hue Light grouped light handling: when a grouped_light is OFF and receives color / color temperature / gradient commands, the node now presets supported member light resources first and only then turns the group ON, so all lamps can inherit the requested state more reliably.
  
• DEBUG: KNX Hue Light added debug traces for the new grouped-light preset-before-ON sequence.
  

Version 4.1.33 - March 2026

• FIX: KNX Hue Light grouped light handling: when a grouped_light is OFF, writes for dimming, color temperature, color/xy and related dynamic updates are now fanned out to the member light resources when needed, instead of relying only on the grouped resource.
  
• CHANGE: KNX Hue Light advanced option Update local cached Hue state from KNX bus writes is now enabled by default for new nodes.
  
• UI/help/wiki/docs: clarified the tradeoff of the local Hue cache synchronization option in the editor, node help and documentation pages across supported languages.
  

Version 4.1.32 - March 2026

• KNX Engine bumped to 5.2.11.
  

Version 4.1.31 - March 2026

• NEW: KNX Hue Light: added advanced option Update local cached Hue state from KNX bus writes to keep the node local Hue cache aligned immediately on KNX write telegrams, without waiting for Hue bridge feedback.
  
• UI: KNX Hue Light: the new advanced checkbox now restores and persists reliably when reopening/saving the node editor.
  
• Docs/help/wiki: updated KNX Hue Light help and documentation in all supported languages (EN/IT/DE/FR/ES/zh-CN, including generated *-zh-CN-* wiki variants).
  
• TEST: extended unit coverage for the optional KNX-write local cache synchronization behaviour.
  

Version 4.1.30 - March 2026

• NEW: Cerebrum Ultimate now uses a full Web Dashboard as the main UI, opened from the node editor via Open Web Page button.
  
• CHANGE: removed the legacy knxUltimateAI-sidebar-plugin file and aligned Cerebrum Ultimate admin routes to the Web Dashboard workflow.
  
• IMPROVE: Cerebrum Ultimate Flow Map UX/readability: stable layout reset on page open, clearer legend, active/idle direction rendering and dashboard visual refinements.
  
• UI: flattened the Cerebrum Ultimate Web Dashboard style (removed 3D/shadow-heavy look) for a cleaner production UI.
  
• Docs/help/wiki: refreshed Cerebrum Ultimate documentation in all supported languages (EN/IT/DE/FR/ES/zh-CN), updated Cerebrum Ultimate-Sidebar pages to Web Dashboard compatibility notes, and updated docs navigation section naming/ordering.
  
• FIX: Cerebrum Ultimate Ask chat: SVG answers are now rendered correctly even with multiple SVG blocks, fenced svg/xml/html code blocks, or entity-escaped SVG markup.
  
• FIX: KNX Hue Light: KNX read response for brightness now returns 0 when the light is OFF and brightness status is configured to follow HUE on/off.
  
• FIX: KNX Hue Light: ignore dimming-only cached brightness updates from Hue while light is OFF, preventing wrong KNX brightness status jumps.
  
• IMPROVE: KNX Hue Light grouped light handling: when an ON event arrives without dimming payload, brightness is fetched from bridge snapshot before publishing KNX status.
  
• TEST: extended unit coverage for the new Hue Light brightness/read/grouped-light snapshot behaviors.
  

Version 4.1.29 - March 2026

• NEW: KNX DateTime node: set date/time on the KNX bus via DPT 19.001 (DateTime) and optionally DPT 11.001 (Date) / DPT 10.001 (Time).
  
• NEW: KNX DateTime: send on startup (with delay), periodic send, editor send-now button, and input-triggered send.
  
• UI: KNX DateTime: when adding a new node, it can auto-select the first KNX Gateway with an ETS import and pre-fill coherent group addresses.
  
• UI: KNX DateTime: auto-fill is also triggered when changing the selected KNX Gateway (it won’t override manual values).
  
• i18n/help/wiki: added KNX DateTime help and docs pages in all supported languages, and added the node to the docs navigation.
  

Version 4.1.28 - February 2026

• NEW: KNX Load Control: added Mode selector to disable the internal logic and use only msg.shedding commands (shed/unshed).
  
• UI/Docs/help/wiki: updated KNX Load Control editor, help and docs pages in all supported languages.
  

Version 4.1.27 - February 2026

• Bumped KNX Engine to 5.2.8
  

Version 4.1.26 - February 2026

• i18n: Cerebrum Ultimate sidebar tab: localized the Summary and UI strings in all supported languages (including output pin labels).
  

Version 4.1.25 - February 2026

• FIX: KNX Device: periodic send (cyclic write) now also works when the value is restored from the persisted GA cache after a Node-RED restart.
  

Version 4.1.24 - February 2026

• Cleanup: removed unused dependencies (binary-parser, crypto-js, xml2js) and the redundant path polyfill.
  
• Cleanup: removed mkdirp and switched to fs.mkdirSync(..., { recursive: true }) for directory creation.
  

Version 4.1.23 - February 2026

• CHANGE: KNX Gateway config: persisted GA cache is no longer deleted automatically when opening the editor.
  
• NEW: KNX Gateway config: added an explicit Clear persisted GA cache button in the Utility tab.
  
• NEW: KNX Device: added Periodic send stored value option (cyclic write) with configurable interval (disabled in Universal mode).
  
• UI: KNX Gateway config: added a Node Status section label above status-related options.
  
• i18n: unified manual button labels across locales: KNX Read and Toggle boolean.
  
• Docs/help/wiki: updated Gateway configuration and Device pages in all supported languages to document the new options.
  

Version 4.1.22 - February 2026

• NEW: KNX Multi Routing: added KNX routing counter (hop count) handling to prevent telegram loops: optional Respect routing counter (drop if 0) and Decrement routing counter when routing.
  
• FIX: KNX Multi Routing: improved behaviour with rewritten telegrams by relying on coherent cEMI; knx.routingCounter is exposed based on knx.cemi.hex.
  
• CHANGE: KNX Router Filter: cEMI consistency is now always enforced when rewriting knx.source/knx.destination (updates knx.cemi.hex accordingly; removed the related toggle option).
  
• CHANGE: KNX Router Filter: added cemiSynced metadata on passed messages (msg.payload.knxRouterFilter.cemiSynced).
  
• NEW: KNX Router Filter: runtime configuration via msg.setConfig (all node parameters), retained until next msg.setConfig or redeploy/restart; config messages are not forwarded.
  
• IMPROVE: KNX Multi Routing Server KNX/IP: better status/diagnostics and docs note about Advertise host for clients that show “connected” but the server receives no telegrams (multi-homed/Docker/VM).
  
• Docs/help/wiki: updated KNX Multi Routing and KNX Router Filter pages in all supported languages to document routing counter, rewrite+cEMI sync behaviour, and msg.setConfig usage (with examples).
  

Version 4.1.19 - February 2026

• NEW: KNX Multi Routing: added Server KNX/IP mode (standalone KNXnet/IP tunneling server) that outputs/accepts RAW telegrams on the node ports (no gateway required).
  

• NEW: Cerebrum Ultimate sidebar: added another TAB in the Node-Red's toolbar buttons dedicated to AI analysis.
  

• NEW: added Cerebrum Ultimate node (traffic analyzer + optional LLM assistant) and Cerebrum Ultimate 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: Cerebrum Ultimate sidebar chat: improved Markdown rendering (including tables), for better readability of AI answers.
  

• Docs: completed the help + wiki pages for Cerebrum Ultimate, 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 Cerebrum Ultimate, 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.
  

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 #317
  
• HUE Light: corrected the 7.600 kelvin range #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 #317
  
• HUE Light: corrected the 7.600 kelvin range #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 #317
  
• HUE Light: corrected the 7.600 kelvin range #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 #317
  
• HUE Light: corrected the 7.600 kelvin range #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. #312 (comment)
  

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: fixed the wiki sample page.
  - 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.
  
• Fix a resource occupation while connecting to the HUE bridge and the bridge is not reachable for the first time.
  

Version 2.1.43 - August 2023

• HUE Light: Moved some options to the "Behaviour" tab and fixed a race condition in the color setting, when some options are in conflict each other.
  

Version 2.1.42 - August 2023

• Fixed some issues in getting the hue device's names, when using some non LTS versions of node.js.
  

Version 2.1.41 - August 2023

• NEW: HUE Light: you can now control ALL GROUPED LIGHT together.
  
• HUE Light: fixed an issue with the "Link brightness to on/off switch" option, when a json color is selected at daylight or nighttime
  
• HUE Light: New: now you can use both DPT 5.001 and 3.007 in the color temperature, at the same time.
  

Version 2.1.40 - August 2023

• HUE Light: Bugfix: color cycle continues to cycle color, even if a FALSE is sent from the group address.
  

Version 2.1.39 - August 2023

• KNX-Ultimate Node: fixed an issue with the msg.topic sent to the flow.
  
• NEW: HUE Light: now you can set the color temperature, using datapoint 5.001 as well.
  
• NEW: HUE Light: the node will now disable parts of the UI, based on the capabilities of the HUE lamp.
  
• HUE nodes now wait 15 seconds before getting status and updating KNX devices, after node-red restart.
  

Version 2.1.38 - August 2023

• Strenghten HUE eventsource resiliency.
  
• Implemented standard logging on all HUE nodes (there was temporary console.log statements).
  

Version 2.1.37 - July 2023

• Load control: added msg.shedding to force shed/unshed.
  

Version 2.1.36 - July 2023

• HUE Server bugfix: in some cases, the eventsource lost the connection while in idle for more than 15 minutes; fixed.
  

Version 2.1.35 - July 2023

• Maintenance release. Added a youtube link with samples, into every HUE node configuration's window.
  

Version 2.1.34 - July 2023

• NEW: Hue light node now supports the grouped lights.
  
• Tap Dial node: fixed an issue with datapoint 5.001.
  
• Full rewrite of the HUE engine, to reduce the http traffic with the HUE Bridge as much as possible.
  

Version 2.1.33 - July 2023

• HUE Light: fix for lights not supporting GAMUT.
  

Version 2.1.32 - July 2023

• NEW: Hue Battery Sensor: you can now get the battery level of all your battery powered HUE devices.
  
• The sensors now read the value at startup.
  
• Minor fixes.
  

Version 2.1.31 - July 2023

• FIX: HUE Light: fixed wrong datapoint in the color cycle effect.
  

Version 2.1.29 - July 2023

• FIX: HUE Light: fixed an issue involving brightness. The HUE HUB, randomly, sends a 0.39 dimming value as hue status. This cause an ON telegram to be sent to the KNX bus.
  

Version 2.1.28 - July 2023

• HUE Light: fixed DIM behaviour.
  

Version 2.1.27 - July 2023

• Trashed some old unuseful code and status options.
  
• Keep moving help to the help box of node-red.
  

Version 2.1.26 - July 2023

• Hue Light: fixed brightness states issue.
  

Version 2.1.25 - July 2023

• Hue Light: added the option to update the KNX Brightness status when turn on/off the HUE light.
  

Version 2.1.24 - July 2023

• Hue Light: fix brightness not sending true/false to the KNX switch status, if no brightness GA present. Set the RBE filter on that.
  

Version 2.1.23 - July 2023

• Hue Light: Update KNX Switch Status on HUE brighness change, now is the default.
  

Version 2.1.22 - July 2023

• NEW: Hue Light: UI optimization and allow to set the switch on light, even it Night Lighting is unselected.
  

Version 2.1.20 - July 2023

• NEW: Hue Light: you can choose to enable/disable the day/night behaviour.
  
• NEW: Hue Light: you can now choose some options in the new Behaviours configuration tab.
  

Version 2.1.19 - July 2023

• Hue light and Hue button optimization.
  

Version 2.1.18 - July 2023

• Quick fix for MDT and Wienzler interfaces.
  

Version 2.1.17 - July 2023

• Revamped UI of KNX-Ultimate device node.
  
• HUE light: added "invert" option to the Day/Night sensor.
  
• More verbose status for all nodes.
  

Version 2.1.16 - June 2023

• NEW: Hue scene. You can now call a HUE scene.
  
• Bump dependencies versions.
  
• Increased TTL of dgram socket, from 128 to 250.
  
• Set max hop count in tunneling/broadcast, from 6 to 7.
  
• Enabled compatibility with KNX Virtual (BETA).
  
• Continue migrating the Help from gitHub to the standard Node-Red help box. You could find some discrepancies in help text. Sorry for that.
  
• BREAKING CHANGE* removed the emulation capability, because it's a complicated thing to mantain. If you don't know what it is, just don't care about that.
  

Version 2.1.15 - June 2023

• Fix an issue with auto discovery of not registered HUE bridges. Now you must first set the IP, then click CONNECT.
  

Version 2.1.14 - June 2023

• Hue Light node: added day/night behaviour.
  

Version 2.1.13 - June 2023

• Hue Light node: fixed inversion in the color temp state.
  
• Hue Light node: switching on/off the light, now sets the DIM to 100%/0% as well.
  

Version 2.1.12 - June 2023

• Hue Light node: added tunable white.
  

Version 2.1.11 - June 2023

• KNX Global Context node: added the optional datastore to choose from.
  

Version 2.1.10 - June 2023

• KNX Gateway Node: Migrated documentation to the standard node-red documentation box.
  
• KNXUltimate engine is now part of the published package https://www.npmjs.com/package/knxultimate.
  

Version 2.1.9 - June 2023

• Start migrating documentation to the standard node-red documentation box.
  

Version 2.1.8 - June 2023

• HUE event stream reader revamped.
  

Version 2.1.7 - June 2023

• KNX nodes not correctly show status of JSON objects (like dimming, color, etc.).
  

Version 2.1.6 - June 2023

• Several fixes for reading the correct GAMUT color.
  

Version 2.1.4 - June 2023

• NEW: Hue light node: added random color cycle effect group address.
  
• Fixed destroying KNX nodes.
  
• Fixed destroying HUE nodes.
  
• Several HUE bugfixes.
  

Version 2.1.3 - June 2023

• Bugfix.
  

Version 2.1.2 - June 2023

• NEW: Hue Hue Light node, added BLINK option.
  

Version 2.1.1 - June 2023

• NEW: Hue Tap Dial node: setting a color datapoint(232.600), the rotary dial will send a random color to the KNX group address.
  

Version 2.1.0 - June 2023

• HUE nodes exited the BETA version. You can now start using HUE nodes.
  

Version 2.0.21 - June 2023

• HUE: CAUTION POSSIBLE BREAKING CHANGES TO THE HUE NODES. PLEASE BE AWARE THAT HUE NODES ARE STILL IN BETA
  
• Revamped hue clipv2 push event client.
  
• New service icons.
  

Version 2.0.20 - June 2023

• HUE: CAUTION POSSIBLE BREAKING CHANGES TO THE HUE NODES. PLEASE BE AWARE THAT HUE NODES ARE STILL IN BETA
  
• Fixed API issue, when no HUE bridges present.
  

Version 2.0.19 - June 2023

• HUE: CAUTION POSSIBLE BREAKING CHANGES TO THE HUE NODES. PLEASE BE AWARE THAT HUE NODES ARE STILL IN BETA
  
• Fixed reading initial state of hue lamps.
  

Version 2.0.18 - June 2023

• HUE: CAUTION POSSIBLE BREAKING CHANGES TO THE HUE NODES. PLEASE BE AWARE THAT HUE NODES ARE STILL IN BETA
  
• Fixed HUE telegram speed, according to the HUE Api V2 recommendation.
  

Version 2.0.17 - June 2023

• HUE: CAUTION POSSIBLE BREAKING CHANGES TO THE HUE NODES. PLEASE BE AWARE THAT HUE NODES ARE STILL IN BETA
  
• Fixed issues with async call to getlightstate aas soon as the light node is created.
  

Version 2.0.16 - June 2023

• HUE: CAUTION POSSIBLE BREAKING CHANGES TO THE HUE NODES. PLEASE BE AWARE THAT HUE NODES ARE STILL IN BETA
  
• Fixed issues with dimming in the hue button and hue tap dial nodes.
  

Version 2.0.15 - June 2023

• HUE: CAUTION POSSIBLE BREAKING CHANGES TO THE HUE NODES. PLEASE BE AWARE THAT HUE NODES ARE STILL IN BETA
  
• NEW: Temperature sensor.
  
• Changes to HUE Light node, to mime the ISE KNX CONNECT HUE beavior.
  

Version 2.0.13 - June 2023

• HUE: CAUTION POSSIBLE BREAKING CHANGES TO THE HUE NODES. PLEASE BE AWARE THAT HUE NODES ARE STILL IN BETA
  
• Hue Button node: fixed missing events in output msg.
  

Version 2.0.12 - June 2023

• HUE: CAUTION BREAKING CHANGES TO THE HUE NODES. PLEASE BE AWARE THAT HUE NODES ARE STILL IN BETA
  
• NEW: Hue light sensor node.
  

Version 2.0.11 - June 2023

• HUE: CAUTION BREAKING CHANGES TO THE HUE NODES. PLEASE BE AWARE THAT HUE NODES ARE STILL IN BETA
  
• Hotfix for Hue Button node, not retain property in config window.
  
• Removed "Double Tap" event, because it doesn't exists yet.
  

Version 2.0.10 - June 2023

• HUE: CAUTION BREAKING CHANGES TO THE HUE NODES. PLEASE BE AWARE THAT HUE NODES ARE STILL IN BETA
  
• Hue Button node redesign.
  
• Other hue nodes fixes
  

Version 2.0.9 - June 2023

• NEW: HUE Motion node
  
• NEW: HUE Tap Dial node
  

Version 2.0.7 - June 2023

• HUE Button node: added an output PIN
  
• HUE Button node: added an option to emit a simplified msg

Version 2.0.6 - June 2023

• NEW: HUE Button node. All HUE integrations are in BETA.
  
• Slowly integrating the help in the node-red help section.
  

Version 2.0.1 - June 2023

• NEW: more KNX group addresses in the HUE Light node
  

Version 2.0.0 - June 2023

• NEW Added HUE Light node. More HUE nodes to come. Please feel free to try it.
  
• Global context node: in the node name, only chas a-z are now allowed, to overcome syntax errors.
  
• As i spend 50% of my time to translate all documentation and node texts to 4 languages, i'll leave only English as main language, so you will see the UI only in English.
  

Version 1.4.18 - Mai 2023

• NEW: Gateway Config Node: Starting from version 1.4.18, you can also simply enter the path to the ETS exported file (e.g.: /home/pi/mycsv.csv), instead of pasting it's content.
  

Version 1.4.16 - Mai 2023

• FIX: fixed an issue when you have more than one Global Variable node.
  

Version 1.4.15 - March 2023

• FIX: fidex an issue with unicode chars in the ESF imported file.
  
• NEW: Added Datapoint 235.001 Tariff. Please see the sample in the node window, appearing after you select the datapoint.
  

Version 1.4.14 - March 2023

• NEW: Added Datapoint 29.xxx. Please see the sample in the node window, appearing after you select the datapoint.
  

Version 1.4.13 - January 2023

• FIX: Fixed Datapoint 9. There was too many decimals.
  

Version 1.4.12 - January 2023

• FIX: fixed scene controller issue.
  

Version 1.4.11 - January 2023

• FIX: fixed RBE output filter, for those Datapoints (like PPM) that doesn't follow the KNX specifications. (#223) and when you use the "round, multiply, etc..." payload handling option in the node configuration.
  
• NEW: Added DPT28.001 UTF-8 string. Thanks @twod-davydemaegt.
  
• FIX: Fixed a mistake (old one) in the ESF file import. Thanks @twod-davydemaegt.
  

Version 1.4.10 - December 2022

• Wellcome in: Company Can'nX from France is using KNX-Ultimate in his Kloud'nX product.
  
• Minor fixes and WIKI update.
  

Version 1.4.9 - November 2022

• NEW: GlobalContext node: If you import your ETS file, the global variable now contains ALL group addresses included in the ETS file.
  
• Fixed incorrect links in the Node-Red's Help TAB for some nodes.
  

Version 1.4.8 - November 2022

• NEW: added Datapoints 13.016, 13.1200, 13.1201.
  

Version 1.4.7 - November 2022

• NEW: added "Griesser Object" Custom Datapoint 6001.001. Thanks @croghostrider
  

Version 1.4.6 - November 2022

• NEW: added Airflow Datapoint 9.009.
  

Version 1.4.5 - October 2022

• Now the Watchdog node sends same errors from other KNX-Ultimate nodes, only once. This avoids flooding node-red flow with unnecessary messages.
  

Version 1.4.4 - October 2022

• FIX: fixed an issue accurring when you put a wrong IP/hostname in the configuration gateway. Leaving node-red running with such wrong configuration, after a month or so, all UDP channels remain occupied until reboot. Thanks to @tarag for reporting that.
  

Version 1.4.3 - October 2022

• Changed view for JSON objects (will display the RAW value instead of the JSON) in the KNXUltimate Viewer node.
  
• Added the measure unit near the payload value.
  

Version 1.4.2 - October 2022

• Added DPT 21.001.
  

Version 1.4.1 - October 2022

• Added DPT 14.077.
  
• NEW: you can now set the ETS group address list at runtime, via the Watchdog Node. See here https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/WatchDog-Configuration the "importCSV" property of the msg.setGatewayConfig.
  
• Updated the Wiki in all languages.
  

Version 1.4.0 - September 2022

• Cleaned code and standardize things, thanks @croghostrider.
  
• Fixed DPT 13.002 description Flow Rate in m³/h
  

Version 1.3.49 - August 2022

• Fixed name validation in the Viewer node.
  

Version 1.3.48 - August 2022

• Fixed old "new Buffer" call. It's deprecated and may not work with new node.js versions.
  

Version 1.3.47 - August 2022

• Temporary hide KNX Secure TAB from the config window. It will appear again when KNX Secure will be ready.
  

Version 1.3.46 - July 2022

• NEW: Added hostname DNS resolution in Config Gateway IP. Now you can put an IP or an hostname in the IP gateway's field.
  - NEW: Added Datapoint 1.024 Day/Night.
  - Now the procol in the config node gateways is only suggested. You can choose the protocol by yourself.
  

Version 1.3.45 - June 2022

• NEW: pass msg.resetRBE = true to a device node, to reset both input and output RBE filter on that particular node.
  

Version 1.3.43 - Mai 2022

• NEW: Scene Controller: you can now specity the "wait" time also in seconds, minutes or hours.
  

Version 1.3.42 - Mai 2022

• Fixed an issue in the gateway config node UI. Corrected some UI spacing issues in low resolution monitor.
  - Fixed an issue occurring in the detection of local IP in case of ETH interface without family property specified.
  

Version 1.3.41 - Mai 2022

• Fixed an issue in the gateway config node UI, where you manually set the IP interface name.
  - Fixed an issue introduced by a breaking change in Node 18.
  - Added more "trace" log in the ipAddressHelper function, to better track the ethernet interface details.
  

Version 1.3.40 - Mai 2022

• Fixed an issue in the GlobalContext node, preventing the node from searching for the DPT, if the CSV ETS file has been imported and you don't specify the DPT in the msg input. Thanks to @Sebastien-Posca for pointing me out that.
  

Version 1.3.39 - April 2022

• Fixed an empty text in the KNX Alerter config node, about the Read States at start.
  
• Fixed an improperly cleaned queue in the config node close function.
  
• Fixed a possible issue in case of multiple disconnection from the KNX Bus in a short timeframe.
  
• Fixed sending disconnection_request with a null connection_ID, in the KNX Engine.
  
• Fixed re-sending per KNX Standards, of not ACKnowledged telegrams, not always working in some circumstances.
  
• Protected some function with a try-catch.
  
• Now the telegram handler function stops whenever the connection is lost and restart from fresh on connection.
  - Optimized the retain mechanism of the queue handling, in case of shorttimed disconnections.
  

Version 1.3.38 - April 2022

• Memory footprint decreased.
  
• Better handling of KNX nodes objects array, for flows with more than 250 nodes.
  

Version 1.3.37 - April 2022

• Changed: the KNX Gateway Node don't care anymore for ROUTING_LOST_MESSAGE and ROUTING_BUSY. Previously, it was disconnecting. Now it only advises in LOG.
  
• Updated and beautifullyfied the WIKI.
  
• Totally rewrote the CIRCULAR REFERENCE PROTECTION and FLOOD PROTECTION wiki page, in all languages.
  

Version 1.3.36 - February 2022

• Purged unused requires and bumped dependencies versions.
  

Version 1.3.35 - March 2022

• Reset handlers by removing/adding every time the connection is set by "new" directive.
  
• Fixed an issue causing glitches, when the disconnection is requested by the KNX interface instead of KNX-Ultimate.
  
• Fixed an issue occurring when the disconnection is started from KNX-Ultimate by the DISCONNECT_REQUEST, but the KNX Interface fails to send the DISCONNECT_RESPONSE to confirm the disconnection.
  
• Updated knxUltimate-config.js to actively disconnect and close the socket when the disconnection is requested by the KNX Interface. All other cases (disconnection by ethernet cable, disconnection by unreachable KNX Interface, disconnection by temporary out of access, disconnection by means of user intervention, disconnection by Watchdog node etc...) are not affected by this issue.
  
• Optimized memory allocation to allow the garbage collector to get rid of unref variables.
  
• Scene controller: fixed node status issues.
  
• Load control: code revision.
  
• Logger: code revision.
  
• Watchdog: code revision.
  
• Device node: code revision.
  
• Global Context: code revision.
  
• Wiki: merged Global Context node sample, into one single page for better readability.
  
• FIX: fixed rounding of numbers in the device node.
  

Version 1.3.32 - February 2022

• FIX Datapoint 16.001: fixed an issue with the ISO8859-1 encoding.
  

Version 1.3.31 - February 2022

• KNX Viewer node: now the payload is formatted depending on value type.
  
• KNX Viewer node: now the list is ordered by group address.
  
• KNX Viewer node: added a second output pin, that emits an Array containing all group addresses.
  

Version 1.3.30 - February 2022

• KNX Viewer node: changed the Datetime display to local time format.
  

Version 1.3.29 - February 2022

• Load Control: the timer for shedding won't everytime obey to what you've set. Fixed.
  
• Load Control: Added pre-shedding yellow warning message in the node status.
  

Version 1.3.28 - February 2022

• NEW: KNX Viewer: this node allow you to see all datapints and values in a dashboard wirget. https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/knxUltimateViewer
  

Version 1.3.27 - February 2022

• Load Control: minor fixes + issue a KNX read of Watt values, in case the GA doesn't automatically send a power value on change.
  

Version 1.3.26 - February 2022

• FIX: fix a crash occurring it the KNX Gateway is set to "emulate" (that means, don't write to the bus).
  

Version 1.3.25 - February 2022

• FIX: Load Control: measure unit was Wh. Corrected in W. Thank @Mauro of VivereSmart Facebook group https://www.facebook.com/groups/viveresmart
  
• Load Control: Added more info to the output message. Updated the online help.
  

Version 1.3.24 - February 2022

• NEW: Load Control node: switch off your device if you're exceeding the Watt limit of your house.
  
• FIX: Alerter Node: fixed a KNX Address verification, in case you wrote your own string instead of a GA.
  
• FIX: Alerter Node: the node was sending a "read" request to all group addresses at start. Fixed.
  

Version 1.3.22 - February 2022

• FIX: WriteRaw: some values wasn't sent to the bus due to an hex conversion issue.
  

Version 1.3.21 - January 2022

• FIX: Node Logger wasn't correclty logging the bus traffic. Fixed.
  

Version 1.3.20 - January 2022

• NEW: Telegram out queue TTL: as soon as KNX-Ultimate detects a connection loss, it will retain the telegrams sent to the BUS during the disconnection. After the reconnection, KNX-Ultimate will send the retained queue.
  

Version 1.3.19 - January 2022

• NEW: Added Datapoint 14.058 Pressure (Pa).
  
• Added some more description while disconnecting from the BUS.
  

Version 1.3.18 - January 2022

• FIX: Scene Controller: fixed an issue preventing the node to work if you haven't set the RECALL and SAVE group addresses.
  
• WIKI: updated the samples in the scene controller node.
  

Version 1.3.16 - January 2022

• KNXEngine: there are some weird KNX gateways out there, either sending malformed header or CEMI messages. Now KNX-Ultimate will simply ignore these bad messages. Prior, it was disconnecting.
  
• KNXEngine: KNX-Secure packets are silently discarded for now, until KNX Secure will be ready.
  
• KNXEngine: added more logs to for troubleshooting pourposes.
  

Version 1.3.15 - January 2022

• KNXEngine: better handling of disconnection in UDP mode, allowing very old grandpa KNX/IP interfaces enough time to understand what's happening, avoiding it to go crazy.
  
• KNXEngine: corrected Curve Crypto in KNX-Secure (KNX Secure is not enabled yet!).
  

Version 1.3.14 - 26 December 2021

• KNXEngine: ACK management: the not acknowledged message will be re-transmitted once, then the connection will be dropped, as per KNX specs.
  
• KNXEngine: ACK management: the telegram's queue to be sent to the KNX BUS will be paused during the ACK waiting.
  
• KNXEngine: Routing: now the routing_busy and routing_lost_messages telegrams sent by the KNX/IP Router are handled.
  

Version 1.3.13 - 25 December 2021

• KNXEngine: when in tunneling and suppress ACK request is disabled, the error is raised only after 3° failed ACK reception instead of 1°.
  
• KNXEngine: at disconnection, delete all pending ACK requests timer.
  
• Warning: if you've suppressed the ACK requests, in some cases the node cannot detect the disconnection. In this case, please use the KNX Watchdog to detect the disconnecitons and reconnect.
  

Version 1.3.12 - December 2021

• KNX-Ultimate DEVICE node: added the validation of Group Address while deploy, with support for modern addressing up to 31/7/255.
  

Version 1.3.10 - December 2021

• FIX: fixed a stupid "Disconnected by Message length mismatch 8/16" error due to a dumb find/replace error in the code.
  
• Added some more log to help resolving issues.
  

Version 1.3.5 - REMOVED FROM REPO due to "Disconnected by Message length mismatch 8/16" error - December 2021

• New KNX Engine has been enabled again, after fixing some glitches.
  

Version 1.3.4 - December 2021

• Temporary reverted to old API, due to some little glitches.
  

Version 1.3.2 - December 2021

• NEW: config node: you can now gather debug info (there is a button for that) to be sent to the developer to help resolving your issue. Then, please paste the debug infos in your gitHub issue.
  

Version 1.3.1 - December 2021
---- MAJOR VERSION WITH TOTALLY REWRITTEN KNX API, IN PURE JAVASCRIPT ----
---- IF YOU ENCOUNTER ISSUES, JUST INSTALL THE LAST OLD VERSION WITH: npm install node-red-contrib-knx-ultimate@1.2.57 ----
---- PLEASE BE AWARE THAT ALL PREVIOULSY KNX SECURE OPTIONS HAVE BEEN HIDDEN UNTIL READY TO BE RELEASED, TO AVOID CONFUSIONS ----

• KNX-Secure: not ready yet. I think not before the 1° quarter of 2022 because i'm learning the MANY cryptograhics algorithms of this Secure thing. Already done are the loading/checking against password of the ETS Keyring file, the new TCP stack (will come toghether with the already present UDP stack) and the first connection handshake between KNX-Ultimate and a KNX/IP Interface via TCP tunnel, using the DH Curve25519 algorythm. SOMEONE INTERESTED HELPING ME WITH THE DEVELOPMENT (FOR FREE)?
  
• NEW: new KNX API developed in these months. This new API is more speedy, more mantainable (get rid of the old "machina" framework) and ready to accomodate the natively supports KNX-Secure.
  
• NEW: ETS Logger: now the node logs the sent packets as well (previously, it was recording only the received ones).
  
• NEW: KNX-Ultimate now supports TCP connection as well (for KNX Secure tunneling). All protocols are now supported (UDP Routing and Tunneling, TCP).
  
• NEW: You can now choose the IP protocol to be used for the gateway.
  
• NEW: WatchDog node: You can now set the communication protocol (TunnelingUDP, Multicast) using msg.setGatewayConfig.Protocol. Updated the Wiki as well to reflect the change.
  
• FIX: Watchdog node's setConfig sat the wrong configuration in case of more than one node gateway simultaneously active on the same flow.
  
• FIX: Manually setting interface in a gateway node set to multicast address, resulting in the gateway bond to all interfaces, causing some issues in receiving datagrams on systems having more than one ethernet interface active at the same time.
  
• FIX: KNX-Device: if the node was set to react to "Read" requests and "Autorespond" was also enabled and "Autorespond with default value if no payload is present" was also active, in some circumstances the "response" telegram was sent to a wrong group address.
  
• FIX: Config gateway: the custom delay between Telegrams sent to the KNX BUS was locked to the safe mimimum of 40ms, even if you sat a lower value. Now is 30ms, but proceed with caution if you set a low value. 50ms should be the safe-default.
  
• FIX: Config gateway: suppress acknowledge telegram now work as expected, totally ignoring received Acknowledges and don't ask for any as well. Prior was only ignoring the received Acknowledges.
  

Version 1.2.57 - November 2021

• Added following datapoints:
  
• 12.100 counter timesec (s)
  
• 12.101 counter timemin (min)
  
• 12.102 counter timehrs (h)
  
• 12.1200 volume liquid (l)
  

Version 1.2.56 - November 2021

• FIX: hotfix echo in tunneling mode doesn't work since 1.2.55.
  

Version 1.2.55 - November 2021

• Gateway servere node: recoding of some javascript parts, to increase speed to better accomodate the crypt/entrypt process of the upcoming KNX-Secure implementation.
  
• KNX-Secure: succesfully read ETS Keyring file and decrypt of Devices keys, Group Address keys, Backbone Key, Management Key and Auth Key.
  
• KNX-Secure: a shield icon near the Gateway name in the KNX Device node appears, if KNX-Secure gateway has been selected.
  
• KNX-Secure: node-red log now logs wether the gateway is secure or not, ETS Keyring project name, created By and ETS version.
  

Version 1.2.54 - November 2021

• THIS VERSION TOUCHES MANY CONNECTIVITY POINTS. It should handle all things better, but if you've trouble, you can always revert to the previous version by issuing npm install node-red-contrib-knx-ultimate@1.2.53
  
• Tunneling/Routing connection optimization: standardized delay in CONNECT_RESPONSE timeout and cleaned some code to better handling installations with more than 500 group addresses.
  
• In tunneling mode, the node now signal the disconnection after 3 KNX Interface's connection state response failed, as per KNX standard.
  
• Increased the socket telegram TTL (Time to Live) for Multicast as well as for Unicast, from 16 to 128 for better handling of multirouted packets.
  
• Added "[THE GATEWAY NODE HAS BEEN DISABLED]" node status message, if you've disabled the KNX Gateway.
  
• NEW: you can now choose to delay the connection to the KNX BUS at start. In some circumstances it's advisable to delay the connection to the BUS to allow the ethernet cards to be lifted up by the sysop. Thi happens often in VM environments.
  
• Changing the log level in the Gateway node doesn't require a node-red restart anymore.
  
• Because i'm flooded by user's queries, i removed a warning from the node status, if the persitent file has not yet been created.
  
• Wait for message acknowledge by the IP router: now waits for 5 failed message ACKs before firing the disconnection sequence.
  
• FIX: fixed a false "disconnection" node status, due to a glitch in the KNX API (after a connection request, the API was sending a false "disconnection" status). Chiamati in causa anche tutti i Santi, prima.
  
• Fixed some check-connection timers not stopping in time.
  
• Speed up the first KNX connection after node-red start/restart/deploy.
  
• Speed up the reconnection attempts in case of disconnections.
  

Version 1.2.53 - November 2021

• Device node: as soon as you add a new node with "read from bus at start" option enabeld, it requests the value from the BUS also if you DEPLOY "modified nodes" only. Prior to that, you had to do a full DEPLOY.
  

Version 1.2.52 - October 2021

• KNX Logger node: fixed some default fields.
  

Version 1.2.51 - October 2021

• NEW: Logger node: you can now count telegrams per second (or any interval you want), for statistic pourposes. Thank @RicharddeCrep for proposing this ehnancement.
  
• WIKI: Updated the wiki in Deutsch, English, Italano and Chinese.
  
• Datapoint 10.001: fixed a little issue if the date of week is Sunday.
  
• Added the milliseconds indication in all logs (things happen fast!).
  

Version 1.2.49 - October 2021

• Gateway connection: added more checks for connection resilience, in case of KNX Interface of particular manufacturer.
  
• Gateway connection: connection is now more speedy.
  
• NEW: Gateway connection has a new option to enable/disable the automatic connection to the KNX BUS at start. You can now choose not to connect to the BUS on boot.- Watchdog node: fixed an issue in changing the configuration via setConfig parameter, when an ethernet interface was manually selected in the config window.
  

Version 1.2.48 - October 2021

• Watchdog node: fixed a misleading status color during the first KNX test performed.
  

Version 1.2.47 - September 2021

• Added Datapoint 14.057 Power Factor.
  

Version 1.2.46 - September 2021

• GlobalContext Node: you can now correctly pass the value to a group address even without setting the datapoint, if you import the CSV file.
  

Version 1.2.45 - September 2021

• NEW: Chinese translation. Many thanks @songzh96 for the BIG work done in traslating the entire WIKI and the node config windows in Chinese!
  

Version 1.2.44 - September 2021

• NEW: Scene Node: you can now add a pause in the command rule list (example, turn on light, wait 4000 milliseconds, turn off light).
  
• WIKI: better organization of help, with direct links "SEE ALSO" to other related pages. You find these links at the bottom of every each page.
  

Version 1.2.43 - September 2021

• Watchdog Node: fixed the msg.connectGateway = true not actually reconnecting.
  

Version 1.2.42 - August 2021

• FIX: if the config node is configured in EMULATION mode, knx-ultimate ouputs always the flow msg with the Group Address as topic, instead of a msg with the customized topic (if you have customizet it).
  

Version 1.2.41 - August 2021

• Fixed a zero day bug: the loading of buffer value other than true/false from the peristent file (where all the values are persisted, stored and read upon restart if you selected that in the node config) fails. No error occurs nor other malfunctions, but the node emits a status error and the value is not read from this file.
  

Version 1.2.40 - August 2021

• Great improvement of system resource.
  
• Fixed too many reconnection attempts in a short timeframe. Now it's more relaxed thus more responsive.
  
• I've successfully collected KNX Secure device to go ahead with the development. THANK YOU TO ALL PATREONS, SPECIALLY TO A COMPANY THAT WON'T BE MENTIONED HERE, HAVING SENT ME KNX SECURE DEVICES.
  

Version 1.2.39 - August 2021

• I remember you that i'm still collecting money to buy a KNX Router for testing KNX-Secure. Should you help me, click "Donate via PayPal" above in this page.
  
• Optimized the fix in 1.2.38 by adding more in-depth checks.
  

Version 1.2.38 - August 2021

• I remember you that i'm still collecting money to buy a KNX Router for testing KNX-Secure. Should you help me, click "Donate via PayPal" above in this page.
  
• Sometimes, with some KNX Interfaces, whenever you unplug the eth cable for a while, the gateway could'nt regain the connection. Fixed.
  
• Added a slight random delay before connecting to KNX BUS, to allow lazy ehternet adapters to come up after a reboot.
  
• Improvement: knx-ultimate nodes does have a persistent state after reboot (it saves the states to a json file). Now, if you have multiple gateways, it saves the states for each gateway in a different file.
  
• FIX: currently, knx-ultimate set to "auto respond with current value" and "if value unknown, respond with", responds with value selected by the user, if the current value is "" or undefined. Now it does so even if the value is null.
  

Version 1.2.36 - July 2021

• Fixed a wrong help link in the gateway configuration node, in the italian language.
  
• Fix: on importing ETS Group Addresses file, the debug window won't show the import's warnings/error.
  
• NEW: starting implementation of KNX Secure (ETA END DECEMBER 2021). For now, the only thing working is keyring import and verification of his Hash against the password you set on the file while exporting keyring from ETS and decyphering of the Backbone key.
  
• Updated Documentation to reflect KNX Secure changes.
  

Version 1.2.34 - June 2021

• Gateway configuration: added option Suppress repeated (R-Flag) telegrams fom BUS. When enabled, this option suppress the telegrams marked as "repeated" (with R-Flag) coming from the bus. See here: https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Gateway-configuration
  

Version 1.2.33 - May 2021

• Gateway configuration -> Advanced Options -> Node list in all flows: added more infos to each node in the list, to allow more control on the nodes overview. The options are: "No Initial Read, React to Write, React to Response, No React to Read, No Autorespond to Read Requests, Telegram type write, No RBE on Output to Bus, No RBE on Input from Bus"
  

Version 1.2.32 - May 2021

• NEW Dattpoint 14.074 (Time in secs) and 14.076 (Volume in m3).
  

Version 1.2.31 - May 2021

• Fixed an issue happening if whenever you change a KNX node's datapoint, while the persistent value saved to file has already been saved using the old datapoint.
  

Version 1.2.30 - May 2021

• Datapoint 14.x: fixed a possible issue if the inpur message coming from the flow, is'nt a valid datapoint 14.x value.
  

Version 1.2.29 - May 2021

• KNX Device: if "read on connection/reconnection" is selected, the gateway node will now read all values of all nodes in 2 steps: first from file (for the nodes set in this way), then from BUS (for the nodes set in this way). This allow nodes that are setup as virtual devices, to get their values from file before being asked to send the value as response to the bus, by other nodes. It's all clear? No? Sorry for that, i'm unable to better explain that.
  - Watchdog node: NEW: you can force the selected gateway to disconnect from the KNX BUS and to STOP reconnection attempts. You can also force the selected gateway to connect to the KNX BUS and to ENABLE reconnection attempts. https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---WatchDog
  

Version 1.2.28 - May 2021

• KNX Device: if you send a boolean value to a node with datapoint 16.001 (Ascii string), all nodes goes to sleep and shows "Waiting" in the status. Fixed. Thanks to @Podler.

Version 1.2.27 - April 2021

• Alerter node: fixed an issue related to the order of cycled msg output of alerted devices.- Alerter node: now you can read the value of all devices belonging to the list, on each connection/reconnection.
  
• Alerter node: now you can read the value of all devices belonging to the list, by massing msg.readstatus = true to the node.
  
• Updated Wiki, Help and SAMPLE to reflect this change.
  

Version 1.2.26 - April 2021

• NEW: Alerter node: added a third output PIN containing the last alerted device (https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Alerter-Configuration).
  
• Updated Wiki, Help and SAMPLE to reflect this change.
  

Version 1.2.25 - April 2021

• NEW: Alerter node: added a second output PIN containing all alerted devices at once (useful for Telegram, Alexa and so on) (https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Alerter-Configuration).
  
• NEW: Alerter node: now you can enter TWO device's descriptions, one short (MAX 14 CHARS, SUITABLE FOR DPT 16.x) and one long.
  
• Updated Wiki, Help and SAMPLE to reflect this change.
  

Version 1.2.23 - April 2021

• Fix: Put some spaces in the device list window of Alerter and Scene node, to facilitate the fields editing.
  
• Alerter node: other than "write", the devices listed react to "response" telegrams as well (https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Alerter-Configuration).
  

Version 1.2.22 - April 2021

• Fix: emulated mode in knx-ultimate set to "universal mode" has the topic always set to empty string.
  
• NEW: Alerter node (https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Alerter-Configuration).
  
• NEW: Alerter node HELP online with samples, in both italiano, english and deutsch.
  

Version 1.2.21 - April 2021

• Increased the Multicast TTL from 1 to 16 (this should allow the multicast packet to be routed beyond the current subnet).
  

Version 1.2.20 - April 2021

• The "Suppress ACK Request" in the gateway config window is now enabled by default on new installations. This prevent some issues with some IP Interfaces.
  

Version 1.2.19 - April 2021

• NEW: Silent Mode for log. You can now chose to totally avoid logging, thanks to the new logging engine. This is useful for reducing I/O access to the disk. Thank to @Webbeh for the request.
  

Version 1.2.18 - April 2021

• NEW: KNX-Ultimate node can retain it's value after reconnection to KNX bus and even after reboot of node-red.
  
• Update the WIKI to reflect the changes (https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Device).
  
• NEW: begin to prepare KNX-Ultimate to support KNX Secure. Some changes to the underlying API where made.
  
• Done some checks on new datapoints coming from BUS to discard wrong telegrams lenght.
  

Version 1.2.14 - March 2021

• NEW: KNX-Logger now logs telegrams sent by KNX-Ultimate nodes having an IP Interface as gateway. Previously, it worked only woth IP Routers.
  
• Begin refractoring of code for KNX Secure compatibility.
  

Version 1.2.13 - March 2021

• Global Context Node: added the option to set the interval to write to the KNX bus.
  
• Global Context Node: fixed the help link, it was broken in italian language.
  
• Global Context Node: optimized the JavaScript samples.
  
• Global Context Node: fix the gateway description not showing in config window, in italian language.
  
• Global Context Node: added the configuration help page in the wiki for all languages (https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/GlobalVariable).
  
• NEW: Online node-red public test website: Point your browser here http://casacorte.myqnapcloud.com:2021 There is a node-red installation ready to be tested, with KNX-Ultimate fully set in "emulation" mode (you cannot do any damage, because the KNX backbone is simulated).
  
• Added proKNX to the list of KNX device manufacturers using KNX-Ultimate (at bottom of the README page).
  

Version 1.2.11 - February 2021

• NEW: Gateway Simulation node. Put "EMULATE" instead of IP Address in the gateway node. The gateway will not write to the KNX BUS. Useful for simulation and classroom's lessons.
  
• NEW: Online node-red public test website... coming soon.

Version 1.2.10 - February 2021

• Global Context Node: fixed translation issues and added a warning in the config window.

Version 1.2.9 - February 2021

• NEW: LOBAL CONTEXT node: https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/SampleGlobalContextNode), exposes the group addresses to a Global Context variable, to be used in function nodes.
  
• NEW: Datapoint 19.001 DateTime
  
• Added sample in the config window of Datapoint 19.001 and updated the sample page in the wiki.

Version 1.2.8 - January 2021

• NEW: you can now change the node configuration my input message. https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample-setConfig
  
• Added msg.setConfig sample and updated the rest of the WIKI.

Version 1.2.7 - January 2021

• NEW: Datapoint 237 DALI diags. https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---DPT237
  
• Added sample DPT 237.x in the Wiki

Version 1.2.6 - January 2021

• NEW: Datapoint 213.x has been added.
  
• Added sample DPT 213.x in the Wiki

Version 1.2.5 - January 2021

• FIX: nodes wasn't emitting a msg to the flow, when they've been set to respond to READ requests while the they haven't already received a value either from BUS or flow.
  
• NEW: you can now update the node's payload without sending the KNX Telegram to the bus. See the node input messages in the wiki and the Virtual Device sample.
  
• Updated the Help in various parts of the wiki.
  
• Updated Virtual Device sample, in the samples section.
  

Version 1.2.4 - January 2021

• REMOVED: removed compatibility with KNX Virtual because it brokes some dockerized/pluginized node-red KNX connections.
  

Version 1.2.3 - 31 December 2020

• FIX: last 2 bytes of 249.600 were swapped.
  
• FIX: last 2 bytes of 242.600 were swapped.
  

Version 1.2.2 - 31 December 2020

• NEW: Datapoint 249.600 added msg.payload={transitionTime:100, colourTemperature:1000, absoluteBrightness:80, isTimePeriodValid:true, isAbsoluteColourTemperatureValid:true, isAbsoluteBrightnessValid:true};- FIX: validities bits of 242.600, that returns everytime true.
  

Version 1.2.1 - December 2020

• FIX: fixed RBE filter not working for Datapoint 242.600
  
• Change: payload 242.600 must now be passed with color and brighness valididy booleans: msg.payload={x:500, y:500, brightness:80, isColorValid:true, isBrightnessValid:true};

Version 1.2.0 - December 2020

• NEW: added compatibility with ETS KNX VIRTUAL.
  
• NEW: added node protection help in the german wiki.
  
• Updated the circular reference protection to be more intelligent thus more tollerant. Thanks @Christian for raising the request.
  
• Updated the circular reference sample in the wiki.
  
• Updated the msg input help in the wiki for all languages..
  

Version 1.1.99 - December 2020

• FIX: RBE filter (from BUS and from flow) doesn't work if the payload is an object.
  
• Removed an unwanted debug log in dPT 242.600
  

Version 1.1.98 - December 2020

• NEW: added Datapoint 242.600 Color xyY.
  

Version 1.1.97 - December 2020

• NEW: added help links directly into the config windows and upon selection of datapoint as well.
  
• Cleaning of UI.
  

Version 1.1.95 - December 2020

• Enhancement: you can now send a raw buffer directly to the KNX bus. See the Wiki, "message to the node" page.
  
• Updated the wiki accordingly.
  

Version 1.1.93 - December 2020

• Enhancement: Check if the gateway's IP is a valid one, otherwise it avoids connection. Thanks @heleon for signaling this issue.
  
• Replaced some deprecated buffer calls.
  

Version 1.1.92 - October 2020

• BUGFIX: RGB Color wasn't working. Now it's fixed.
  

Version 1.1.91 - October 2020

• NEW: Datapoint 22.201 RCHH Status (for example, for MDT actuators)
  
• Added sample for Datapoint 22.x (https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---DPT22)
  
• Added sample for Datapoint 20.x
  

Version 1.1.90 - October 2020

• Connection and queue handling optimization for big installations where knxd is used and where there is a near maximum (allowed by knx standards) of datagram per seconds traffic on the BUS. Thanks @Songzh
  
• FIX sample message not showing in the config window of knx-ultimate device, if the device is already presento on the flow.
  
• Added sample for Datapoint 2.*, 1 bit with priority.
  
• Added sample for Datapoint 6.x, value -128 to 127%.
  
• Added sample for Datapoint 7.x.
  
• Added sample for Datapoint 8.x.
  
• Added sample for Datapoint 9.x.
  
• Added sample for Datapoint 12.x.
  
• Added sample for Datapoint 13.x.
  
• Added sample for Datapoint 14.x.
  
• Added sample for switching on/off a POE port of Unifi Switch (https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---UnifiPOE)

Version 1.1.89 - September 2020

• Fix an issue, where the node stops connecting to the bus if you're using knxd, in some particular scenario. Thanks @Songzh
  

Version 1.1.88 - September 2020

• FIX: Scene Controller. If disabled, it outputs now the correct values of recallscene and savescene properties (before, both was sentout as false, even if true). See here at bottom: https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/SceneController-Configuration#messages-from-the-node
  

Version 1.1.86 - September 2020

• NEW: Scene Controller, added the ability to disable the scene controller via msg.disabled = true. See here at bottom: https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/SceneController-Configuration#messages-from-the-node
  

Version 1.1.85 - September 2020

• FIX: The buffer of the ETS Logger is now cleared after every sendout. Thanks @Mil.
  

Version 1.1.84 - September 2020

• The knx API is now part of knx-ultimate. External dependency has been removed. This allow to a more tight integration between KNX Bus and node-red.
  
• Update: Rewrite of all datapoint names, to adhere to ETS naming convenction. Updated some deprecated buffer initialization.
  
• NEW: Added Datapoint 6.020 Status with mode.
  
• NEW: Added Datapoint 8.012 Length in meter.
  
• NEW: Added Datapoint 9.029 Wind speed (km/h).
  
• NEW: Added Datapoint 9.030 Concentration (ug/m3).
  
• NEW: many people simply don't care about WIKI in Github, so i need to find a simpler and more direct way to access the huge documentation, without being flooded by questions about samples, that are already in the WIKI. Now KNX-Ultimate node displays a text box with sample on how to format input payload and a link to the relative help page, directly in the config window.
  

Version 1.1.83 - September 2020

• Update API to 2.3.24: Added Datapoint 222.100 and 222.201.
  
• NEW: Added Sample DPT 222 (See in the Wiki).
  

Version 1.1.82 - August 2020

• Update API to 2.3.23: Fixed a very old/why this?/odd issue with log in datapoints code, that instantiate a new instance of the logger instead of using the proper one. Thanks @heleon19 .
  

Version 1.1.81 - August 2020

• Update API to 2.3.22: Changed the log datetime from ISO to Local UTC. Added the prefix "KnUltimate-API to the log, to better undestand form where the log comes.
  - NEW: ADDED Datapoint 5.100 Fan Stage

Version 1.1.80 - August 2020

• Update API to 2.3.21: changing the debug level now is applied immediately without restarting node-red.

Version 1.1.79 - August 2020

• NEW: The scene controller node can now save the current group address value via a msg input. See here: https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/SceneController-Configuration#messages-from-the-node and the sample in the wiki as well..

Version 1.1.76 - August 2020

• Fixed the ETS XML logger. Sometimes the files could contains an invalid CEMI telegram that was not properly discarded and that prevent ETS to load the log. Thanks @Namakemono93.
  
• Fixed a visual glitch in the KNX-Node config window (Telegram value format) for nodered 1.1.0 and above.

Version 1.1.75 - June 2020

• NEW: Added Datapont 7.xxx with 7.600 as well.
  
• Adjusted italian node translation on "OUTPUT (invio datagrammi sul bus KNX)" selection properties. Adjusted the documentation consequently.
  

Version 1.1.73 - Mai 2020

• FIX: fixed an issue in importing ETS file, preventing import if you have an improperly set knx-ultimate node, having no gateway selected. Thanks @enzensbs.
  

Version 1.1.72 - Mai 2020

• Update knx api to 2.3.19
  
• FIX: fixed a problem when issuing a gateway ip change to a watchdog node, if you've a tunneling KNX Interface and node-red v. 0.20 or below.
  
• FIX: above related with connection status request if tunneling mode, sometime giving "timed out waiting for CONNECTIONSTATE_RESPONSE" errors.
  

Version 1.1.71 - Mai 2020

• Update knx api to 2.3.18
  
• NEW: added Datapoint 251.600 RGBW
  
• State request to the BUS is now sent every 60 seconds instead of 10, for lowering the BUS traffic (see changelog for Version 1.1.68)
  
• More relaxed handling of errors coming from an query to a KNX/IP interface not always reponding to connection status (in case, for example, of some implementations of knxd)
  
• Watchdog: on "basic Ethernet check", switched to ping mode detection. With the introduction of "echo local telegrams" in unicast mode, since some versions ago, the watchdog must yet check for the KNX Interface using Ping, otherwise, the lost of connection is never trapped. Other than that, the "basic Ethernet check" works only with KNX Interfaces, because the router uses multicast and multicast is connectionless.
  

Version 1.1.70 - Mai 2020

• NEW: Added the option to select the delay between each telegram and further delay multiplicator between only the read telegrams
  

Version 1.1.69 - Mai 2020

• Update: knxultimate-api to 2.3.17.
  
• NEW: Added Datapoint 12.001 and 12.1201.
  

Version 1.1.68 - April 2020

• Update: knxultimate-api to 2.3.16.
  
• FIX: fixed disconnection in tunneling mode by strictly adhere to KNX standard (sending state request to the BUS every 10 seconds). Thanks to Matthias of Timberwolf Server.
  
• Introduced some internal changes in preparation to the introduction of the new dashboard compatible visualization nodeset "visu-ultimate".
  

Version 1.1.67 - April 2020

• Re-introduced selectable option for local echo if tunneling.
  
• Smarter restart maneuvering in case of Ethernet issues, while on tunneling connections.
  

Version 1.1.65 - April 2020

• FIX: If the imported ETS file, contains a device name with a # character, strange things happens. Fixed.
  
• Forced local Echo for IP interfaces.
  

Version 1.1.64 - April 2020

• NEW: Added Telegram type "Read", to issue a read by simply pass a payload to the node. Thanks @waldbaer for the suggestion.
  

Version 1.1.63 - April 2020

• Informational nitification when datapoint RGB is selected, on how to pass into the payload.
  
• Removal selection of echoing the sent payload on all node, if the gateway is unicast. Now the echo is active everytime.
  

Version 1.1.62 - April 2020 in Italy, we're crying our dead people.

• Better decriptive Multicast/Unicast gateway auto discovery.
  
• Definitive use of heavily modified knx-ultimate.js API instead of knx.js.
  

Version 1.1.61 - April 2020 in Italy, deaths are increasing to 600 pro day.

• Fix error in ESF file import, if you set more than one Group Address in a single device property.
  

Version 1.1.60 - April 2020 in Italy, deaths are decresing to 500 pro day.

• Fix error in gateway node translation, that disappeared.
  

Version 1.1.59 - April 2020 in Italy, deaths are decresing to 500 pro day.

• Adjusted translations.
  
• NEW: added Datapoint 10 Bytes.
  

Version 1.1.58 - April 2020 in Italy, continue lock down Coronavirus.

• Adjusted translations.
  
• Small bugfixes.
  
• Removed the deprecated setGatewayConfig from knx-ultimate. Use Watchdog node instead.
  

Version 1.1.57 - April 2020 in Italy, continue lock down Coronavirus, but situation is better now.

• Datapoint 18.001 added. Now this datapoint for Scene is fully supported.
  
• Sample controlling datapoint 18.001.
  
• Scene node and knx-ultimate device node changed accordnlgy.
  

Version 1.1.55 - March 2020 in Italy, continue lock down Coronavirus, but situation is better now.

• NEW: Added option to skip the import of the group address from the ETS file, if the datapoint is not set.
  

Version 1.1.54 - March 2020 in Italy, continue lock down Coronavirus, but situation is better now.

• FIX: fixed status display of date/time. Yet if you uncheck the option not do display the date/time, it works.
  
• ENHANCEMENT: search for all words in the group address fields. You can now search, for example, for "licht wohnzimmer".
  
• Changed palette order to better view the service nodes, like Logger and Watchdog.
  
• Ongoning Deutch translation.
  

Version 1.1.53 - March 2020 in Italy, continue lock down Coronavirus.

• NEW: msg passthrough option.
  

Version 1.1.52 - March 2020 in Italy, continue lock down Coronavirus.

• FIX: import ETS csv and ESF files may had problem with languages other that english. Fixed.
  
• FIX: Scene Controller, fix trigger suggestion if datapoint trigger is set to DIM.
  
• FIX: WatchDog, fix autostart timer if no Group Address monitor is selected.
  
• NEW: Logger Node, a new node to hear all telegrams and to output an ETS bus monitor compatible file.
  
• Update underlying KNX api to 2.3.10, to extract CEMI telegram for the Logger Node.
  
• Minor bugfixes.
  
• Other translation work has been done.
  

Version 1.1.50 - March 2020 in Italy, continue lock down Coronavirus. Cases 25.000

• FIX: Scene controller, the "save scene" datapoint was override by "recall scene" datapoint on each open of the config window.
  
• FIX: Scene Controller, without imported ETS file, the scene controller recall/save worked only with boolean values. Now it works correctly. Thanks @mthauth.
  
• FIX: Scene Controller, correct handling of dim commands (example {decr_incr:1,data:5}).
  
• Scene Controller now is called via javascript Promise to leverage the main thread.
  

Version 1.1.48 - March 2020 in Italy, continue lock down Coronavirus. Milan index down 8%, Down Jons as well. Panic selling everywhere.

• FIX: When you copy/paste knx-ultimate or scene controller node, autofill of device names doesn't work.
  
• Scene Controller devices cosmetics adjustments.
  

Version 1.1.47 - March 2020 in Italy, continue lock down. More people involved in Coronavirus

• FIX: In gateway config-node, fixed the "List of your nodes in all flows" (under Advanced Options) list, sometime not populated.
  
• ENHANCEMENT: Now knx-ultimate and scene controller display device list names for newly added nodes in the flow. Prior, you had to save the node first, to get the knx device list into the Group Address fields.
  

Version 1.1.45 - March 2020 in Italy, we're locked down for Coronavirus

• Update knxultimate-api. Nodes connected to an IP Interface now behave like nodes connected to an IP Router, and local writes are mirrored automatically to nodes sharing the same Group Address.
  
• I'm internationalizing the node (Deutsch, Italiano, English) with the help of @svenflender, so please be patient if some parts are still only in english. Internationalization is working with node-red version 1.0.3 and above. Versions below, does have issues in the i18n module, so knx-ultimate falls back to english. Please upgrade node-red.
  

Version 1.1.43 - March 2020 in the middle of Coronavirus emergency in Italy

• NEW: Scene Controller node (see the Wiki).
  

Version 1.1.40 - March 2020

• Better handling of telegrams, giving priority to the "write" and "response" telegram in the queue. Thanks @heleon19 for the suggestion.
  

Version 1.1.39 - March 2020

• Fix a very low priority issue: a possible crash if you set the knx-ultimate node's output as "respond", while passing an object as payload to the input.
  

Version 1.1.38 - March 2020

• Yet, if you import an ETS CSV file without datapoints, a fake datapoint 1.001 will be used (if you selected to force import the group address)
  
• Update help and wiki to reflect the change
  

Version 1.1.37 - Feb 2020

• Fixed an issue where new knx-ultimate nodes, without a gateway config node, doesn't open the configuration window. Thanks @svenflender
  

Version 1.1.36 - Feb 2020

• You can now import ESF group address format, beside CSV.
  
• Updated the Wiki.
  

Version 1.1.34 - Feb 2020

• Fix an issue with RGB values.
  
• Added RGB sample in the Wiki.
  

Version 1.1.33 - Feb 2020

• New: the Watchdog node now outputs a msg to the flow if you issued a setGatewayConfig
  
• Patched and switched to knxultimate-api (v. 2.3.8) underlying API. This should fix a very rare issue causing node-red to crash giving ERR_SOCKET_DGRAM_NOT_RUNNING error.
  

Version 1.1.32 - Feb 2020

• New: in the knx-ultimate, added the option to format the msg.payload value, if it's numeric.
  
• Switched to knx.js API 2.3.7
  
• Refractoring of some internal code to speed up things, whenever the node sends a "Read" request to the BUS.
  
• Fix a message warning in the config page, if you not imported the ETS csv file.
  
• Fix the "Universal Mode" setting wrongly reverting to false on newly added nodes, if you've not imported the ETS csv.
  
• Devicename msg property is now populated with the node name, if the node is in Universal Mode and the ETS CSV file has not been imported (previoulsy was set to empty string).
  
• Update the Wiki and node help, with the new "payload format" options.
  

Version 1.1.31 - Feb 2020

• Rewritten the "Send a GrpValue read once on connection/reconnect" using the telegram queue.
  
• New: new underlying API set to knxultimate-api (v. 2.3.7) and patched with last API fixes. From now onwards, knx-ultimate node will switch between underlying knx.js API and his own knxultimate-api, to allow a quicker fix of possible problems with the API.
  
• Relocate nodes in a specific folder.
  

Version 1.1.30 - Feb 2020

• New: the Watchdog node now signals if a knx-ultimate node throws errors as well. See here output message properties.
  

Version 1.1.29 - Feb 2020

• Changed Node KNX Icon, logo and colors, thanks @svenflender
  
• New in config-node: copy/paste friendly text block, with a list of all KNX Nodes (for using, for example, in KNX Router line/zone filters).
  
• New: added subtype decoded value payloadsubtypevalue ( for exampe, On/Off, Ramp/NoRamp, Start/Stop, Alarm/NoAlarm ). See here an example
  

Version 1.1.28 - Jan 2020

• New: Added topic property
  
• New: added page to wiki, explaining the node protection. Node Protections.
  
• Updated Wiki to reflect the new changes.
  

Version 1.1.27 - Jan 2020

• New: added payloadmeasureunit to the node's msg output (for example "W" or "%"), based on Datapoint type.
  
• New: added knx.dptdesc to the node's msg output (for example "Power" or "Humidity").
  
• New: added Loglevel option in config-node, for debugging pourpose only. Thanks Heleon19.
  

Version 1.1.26 - Jan 2020

• New: Watchdog Node added. Please consult the Wiki.
  
• Changed category (the node's list on left panel of node-red) to "KnxUltimate", to accomodate the Watchdog node.
  

Version 1.1.25 - Jan 2020

• New: ability to programmatically change the KNX/IP interface or router's IP, Port, Physical Address and reset local ETH Interface Binding.
  

Version 1.1.24 - Jan 2020

• FIX: If the message has no payload and no readstatus, throw an error. If you requests a readstatus, there's no need to pass a payload. Previously, the node has gone in stop mode if the payload was null, thus having readstatus.
  
• Added Read Request sample in the Wiki.
  

Version 1.1.22

• Added msg.previouspayload that stores the previous node value
  
• Update Wiki accordlingy.
  

Version 1.1.21

• Fixed a possible crash if the payload is an object and the node is set to send a "response" telegram instead of a "write" telegram.
  
• Added an explanation about meaning of status colors, in the node info on the right panel and in the wiki.
  
• Updated node info and wiki to reflect the new UI changes.
  

Version 1.1.20

• Config node UI cleanup.
  
• During the ETS CSV file import, if a datapoint is not set, you can now select whether to abort the import or to skip the affected group address and continue.
  
• Added Homekit, Alexa and Google Assistant samples in the wiki.
  

Version 1.1.19

• More UI cleanup.

Version 1.1.18

• Removed the handling of the telegram queue's delay buffer from underlying KNX.js API, because it doesn't respect the telegram queue order.
  
• Added own message queue buffer with delay of 50 millisecs. Now the telegrams order is respected.
  
• In the node's configuration, added an advanced tab, that hides or shows the advanced options; now the configuration is much more clean. Advanced Options opens up automatically if the values have been changed from defaults.
  

Version 1.1.17

• Fixed autorespond to a read request.
  

Version 1.1.16

• Added a minimum delay of 60milliseconds between telegrams, when the node sends telegrams to the BUS, to avoid flooding the KNX BUS, causing a loss of telegrams. The KNX.org specs allows max 50 telegrams per seconds (max 1 telegram each 20milliseconds), but in real life, this is too much.
  

Version 1.1.15

• Updated underlying API to 2.3.6 with some bugfixes.
  
• Added FAQ and troubleshoot in the Wiki.
  

Version 1.1.14

• Fix issue with RBE Output due to code cleanup.
  

Version 1.1.13

• Code cleanup thanks @SystemKeeper
  

Version 1.1.12

• Universal mode optimizations
  
• Fix abnormal log iw universal mode receiver cannot find a suitable datapoint
  
• Added automatic discover for datapoint 14.056
  
• Added automatic discover for datapoint 16.001
  

Version 1.1.12

• Fixed a little issue where the status message is not displayed if the node has not well wrote group address (for example 1/5 instead of 1/5/1). Thanks @arsiesis.
  
• Cleaned up the layout of config window.
  
• Changed option Listen to all Group Addresses to a more comprensible Universal mode (listen to all Group Addresses).
  
• The node can now be used as universal KNX sender/receiver without the need of the ETS CSV File.
  

Version 1.1.10

• Auto send node value as response to the KNX Bus. It works in conjunction with React to read telegrams. When checked, whenever the node receives a read request from bus, it sends a response to the KNX Bus with the stored payload value.
  
• Fixed an issue where if you have a node set to Universal mode (listen to all Group Addresses) (with ETS CSV File set) and you create a new node having a Group Addr. not in the ETS CSV file, an exception is raised but not caught and the nodes may not receive the values from KNX BUS.
  

Version 1.1.9

• Fixed visual glitch when create a new freshly Config Node.
  
• Added 3 options in the config-node to select what to display in the node status, for a cleaner flow or for a clearer flow.
  
• Fixed issue with IP Interfaces. On each deploy, the node doesn't lock tunnels anymore.
  

Version 1.1.8

• For new nodes, the rbe output filter is enabled by default. You can always turn it off in the options. This helps novice users avoiding loops.
  
• Fixed an issue where if the connection is in tunnel mode and the connection to the IP Interface or KNX Bus is lost, the node trows an unhandled exception. Thanks to User Maarten200.
  
• Added the word "knxUltimate" before any log, to identify that the log comes from the knx-ultimate node.
  

Version 1.1.7

• Fixed bind to ethernet. Now you can manually input the ethernet name as well. Thanks to user rotorman.
  

Version 1.1.6

• Fixed inport CSV from ETS where there is return carriages and parenthesis in the Group Address description. Thanks to user xrk.
  

Version 1.1.4

• Last changed status date/time shortened out
  

Version 1.1.3

• In node status, added the last changed status date/time.
  

Version 1.1.2

• When you asks for a read on a node having Listen All Group Addresses set to true, due to a low delay between each KNX telegram, some telegrams are discarded. Increased the delay between telegram to avoid that.
  
• Added RBE filter for the INPUT from KNX bus as well.
  
• Added the option to bind to local ethernet interface, in case you have more than one, for example, ethernet and wifi.
  
• Fixed option suppress_ack_ldatareq not retain after restart.
  
• In-Line help update to reflect new changes.
  

Version 1.1.1

• Disambigued misinterpretation of the "disconnect" status.
  
• In the autocomplete box of KNX device names, when you type in the group address or the device's name, it shows the main and subgroup name as well
  
• Cosmetic adjustment
  
• In-Line help additions
  

Version 1.1.0 LTS (Long term stable)

• Once disabled for loop or circular reference protection, the node can be re-enabled by simply click on deploy "modified nodes"
  
• When "Universal mode (listen to all Group Addresses)" is selected, the RBE filter is disabled.
  
• Cosmetic adjustment
  

Version 1.0.19

• Automatic loop protection
  

Version 1.0.18

• Added gateway options:
  KNX Physical Address
  Suppress ACK request
  This option help compatibility with old Siemens SWG1 148-1AB22 IP Interface
  
• Added RBE option to the input (Report by Exception node - only passes on data if the payload has changed)
  

Version 1.0.16

• Input message format has been CHANGED! please see the wiki!!!.
  
• Circular reference protection (when 2 nodes with same group address are link toghether, the protection avoids loops.).
  

Version 1.0.15

• Device Node outputs the name when ETS csv is not set too.
  

Version 1.0.14

• Fixed knx dependency
  

Version 1.0.7

• Check for invalid node's Group Addr.
  

Version 1.0.5

• Fixed the fix for the typo error causing a mess
  

Version 1.0.5

• Fixed a typo error causing a mess
  

Version 1.0.4

• Fixed possible issue with the csv ETS endpoint
  

Version 1.0.3

• If ETS csv file is set, when typing a group address in the node, a list of KNX devices will be shown and when selected, it set the Datapoint and the Devicename automatically.
  

Version 1.0.2

• Fixed minor glitches in node config ui
  

Version 1.0.1 FIRST PUBLIC RELEASE

• Fixed minor glitches
  
• Ended extensive testing
  
• Enhanced Wiki and Youtube Video about ETS CSV File

Version 0.0.6 BETA

• Fixed Telegram type unable to be set
  
• Added node status for response (blue) and read (grey)
  

Version 0.0.5 BETA

• Integration of Help documentation
  
• Readstatus fix
  

Version 0.0.3 BETA

• Added Help documentation
  
• Added samples on the Readme.md
  
• Better user's notifications handling of the ETS csv file checks.
  

Version 0.0.2 BETA

• Added BETA warnings.
  

Version 0.0.1 BETA

• Initial release