node-red-contrib-knx-ultimate 6.0.7 → 6.0.9

package/CHANGELOG.md

@@ -6,8 +6,12 @@
 
 # CHANGELOG
 
-**Version 6.0.7** - July 2026<br/>
+**Version 6.0.9** - July 2026<br/>
 
+- **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.<br/>
+- **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.<br/>
+- **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.<br/>
+- **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.<br/>
 - **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](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/discussions/519).<br/>
 - **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.<br/>
 - **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.<br/>

package/nodes/knxUltimateMatterBridge.js

@@ -157,6 +157,8 @@ module.exports = function (RED) {
     }
 
     const safeSendToKNX = (telegram, context = 'write') => {
+      // Matter command handlers are asynchronous and shared by many endpoints. Guard
+      // each KNX dispatch so one unavailable gateway cannot break other device routes.
       try {
         if (!node.serverKNX || typeof node.serverKNX.sendKNXTelegramToKNXEngine !== 'function') {
           node.setNodeStatus({ fill: 'red', shape: 'dot', text: `KNX server missing (${context})` })

package/nodes/knxUltimateMatterControllerDevice.html

@@ -219,7 +219,7 @@
           ensureVerticalTabsStyle();
           const $knxServerInput = $("#node-input-server");
           const KNX_EMPTY_VALUES = new Set(['', 'none', '_ADD_', '__NONE__']);
-          // Variable names kept from the Hue-born code; they now point to the Matter widgets.
+          // Historical variable names are retained for saved-flow compatibility; they point to Matter widgets.
           const $hueServerInput = $("#node-input-serverMatter");
           const $hueDeviceInput = $("#node-input-matterNodeId");
           const $deviceNameInput = $("#node-input-matterDeviceName");
@@ -287,8 +287,8 @@
               $icon.removeClass('fa-stop fa-play').addClass(locateSessionActive ? 'fa fa-stop' : 'fa fa-play');
             }
             const title = locateSessionActive
-              ? (node._('knxUltimateMatterControllerDevice.locate_stop_title') || 'Stop Hue locate')
-              : (node._('knxUltimateMatterControllerDevice.locate_start_title') || 'Locate selected Hue device');
+              ? (node._('knxUltimateMatterControllerDevice.locate_stop_title') || 'Stop Matter locate')
+              : (node._('knxUltimateMatterControllerDevice.locate_start_title') || 'Locate selected Matter device');
             $locateDeviceButton.attr('title', title);
           };
 
@@ -344,8 +344,8 @@
             if (!context) {
               if (!silent) {
                 const message = !resolveHueServerValue({ allowStored: true })
-                  ? (node._('knxUltimateMatterControllerDevice.locate_no_bridge') || 'Select a Hue bridge first')
-                  : (node._('knxUltimateMatterControllerDevice.locate_no_device') || 'Select a Hue device first');
+                  ? (node._('knxUltimateMatterControllerDevice.locate_no_bridge') || 'Select a Matter controller first')
+                  : (node._('knxUltimateMatterControllerDevice.locate_no_device') || 'Select a Matter device first');
                 RED.notify(message, 'warning');
               }
               updateLocateButtonState(false);
@@ -414,7 +414,7 @@
               updateLocateButtonState(false);
               clearLocateAutoReset();
               if (!silent) {
-                RED.notify(message || (node._('knxUltimateMatterControllerDevice.locate_error') || 'Unable to locate Hue device'), 'error');
+                RED.notify(message || (node._('knxUltimateMatterControllerDevice.locate_error') || 'Unable to locate Matter device'), 'error');
               }
             }).always(() => {
               locatePendingRequest = null;
@@ -627,7 +627,7 @@
           const serializeMatterCapabilities = (capabilities) => JSON.stringify(capabilities || {});
           const getJSONPromise = (url) => new Promise((resolve, reject) => { $.getJSON(url, resolve).fail(reject); });
 
-          // Same name/contract as the Hue filter, on Matter items { value, matterNodeId, matterEndpointId }.
+          // Filters Matter items shaped as { value, matterNodeId, matterEndpointId }.
           const filterHueDevices = (devices, term) => {
             const cleaned = (term || '').replace(/exactmatch/gi, '').trim();
             return $.map(devices, (item) => {
@@ -757,11 +757,11 @@
             $.getJSON(`knxUltimateDpts?serverId=${serverId}&_=${Date.now()}`, (data) => {
               data.forEach((dpt) => {
                 if (prefixes.some((prefix) => prefix === "" || dpt.value.startsWith(prefix))) {
-                  // Adjustment for HUE Temperature
+                  // Adjustment for Matter color temperature
                   if (dpt.value.startsWith("7.600")) {
                     $(_destinationWidget).append($("<option></option>").attr("value", dpt.value).text(dpt.text + " - KNX Kelvin range 2000-6535k (Homeassistant color_temperature_mode: absolute)"));
                   } else if (dpt.value.startsWith("9.002")) {
-                    $(_destinationWidget).append($("<option></option>").attr("value", dpt.value).text(dpt.text + " - HUE Kelvin range 2000-6535k (Homeassistant color_temperature_mode: absolute_float)"));
+                    $(_destinationWidget).append($("<option></option>").attr("value", dpt.value).text(dpt.text + " - Matter Kelvin range 2000-6535 K (Home Assistant color_temperature_mode: absolute_float)"));
                   } else if (dpt.value.startsWith("5.001")) {
                     $(_destinationWidget).append($("<option></option>").attr("value", dpt.value).text(dpt.text + " - Homeassistant color_temperature_mode: relative"));
                   } else {
@@ -1084,13 +1084,6 @@
             }
             applyMatterCapabilities(currentMatterCapabilities);
 
-            if ($pinSelect.length) {
-              const desiredPins = knxSelected ? 'no' : 'yes';
-              if ($pinSelect.val() !== desiredPins) {
-                $pinSelect.val(desiredPins).trigger('change');
-              }
-            }
-
             if ($pinSectionRow.length) {
               $pinSectionRow.show();
             }
@@ -1236,7 +1229,7 @@
               .append($("<option>").val("temperature").text(node._("knxUltimateMatterControllerDevice.select_temperature_brightness")));
             $("#node-input-specifySwitchOnBrightness").val(node.specifySwitchOnBrightness);
             $("#node-input-enableDayNightLighting").val(node.enableDayNightLighting);
-            // "Get current" reads the state from the Hue bridge: not available on Matter.
+            // Live "Get current" reads are not available on this Matter path.
             $("#getColorAtSwitchOnDayTimeButton").hide();
             $("#getColorAtSwitchOnNightTimeButton").hide();
             applyMatterCapabilities(currentMatterCapabilities);
@@ -1261,8 +1254,8 @@
             if ($("#node-input-enableDayNightLighting").val() === "yes") blinkBackground("#colorPickerNight");
           });
 
-          // "Get current" (reading the live state from the Hue bridge) does not exist on
-          // Matter: the buttons are hidden by populateSwitchOnCombos above.
+          // Live "Get current" reads do not exist on this Matter path; the buttons are
+          // hidden by populateSwitchOnCombos above.
 
           // Fill options for minDimLevel and maxDimLevel and comboBrightnessAtSwitchOn (for color brightness at switch on, with temperature toghedher)
           for (let index = 100; index >= 0; index -= 5) {
@@ -2151,14 +2144,13 @@
 
 
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-<p>This node controls Philips Hue lights (single or grouped) and maps their commands/states to KNX.</p>
+<p>This node controls commissioned Matter endpoints and maps their commands and states to KNX.</p>
 
 **General**
 
-This node was born from the Hue Light node: same KNX group-address model and behaviour,
-with the Philips Hue engine replaced by the **Matter controller** engine. A Matter bridge
-(for example a Hue Bridge paired via Matter) is expanded into its lamps in the picker.
-Hue-only features (native effects, locate) are not available on Matter.
+The editor detects the selected endpoint capabilities and exposes only the corresponding
+Matter functions. Bridged Matter devices are expanded into their individual endpoints in
+the device picker.
 
 |Property|Description|
 |--|--|
@@ -2170,14 +2162,14 @@ Hue-only features (native effects, locate) are not available on Matter.
 
 **OPTIONS**
 
-Here you can link KNX Group Addresses to the available Hue commands/states.<br/>
+Here you can link KNX Group Addresses to the available Matter commands and states.<br/>
 Start typing in the GA field (name or Group Address); suggestions appear while you type.
 
 **Switch**
 
 |Property|Description|
 |--|--|
-| Control | This GA is used to turn on/off the Hue light via a boolean KNX value true/false|
+| Control | This GA turns the Matter light on or off via a boolean KNX value true/false. |
 | Status | Link this to the light's switch status group address|
 
 <br/>
@@ -2186,8 +2178,8 @@ Start typing in the GA field (name or Group Address); suggestions appear while y
 
 |Property|Description|
 |--|--|
-| Control dim | Relative DIM of the Hue light. You can set the dimming speed in the **Behaviour** tab. |
-| Control % | Changes the absolute Hue light's brightness (0-100%)|
+| Control dim | Relative DIM of the Matter light. You can set the dimming speed in the **Behaviour** tab. |
+| Control % | Changes the absolute Matter light brightness (0-100%). |
 | Status % | Link this to the light's brightness status KNX group address |
 | Dim Speed (ms) | Dimming speed in milliseconds. Applies to both the light brightness and the tunable-white datapoints. Calculated over the 0%→100% range. |
 | Min Dim brightness | Tha Minimum brightness that the lamp can reach. For example, if you are dimming the light down, the light will stop dimming at the specified brightness %. |
@@ -2202,8 +2194,8 @@ Start typing in the GA field (name or Group Address); suggestions appear while y
 | Control dim | Change white temperature using DPT 3.007 dimming. Speed is set in the **Behaviour** tab.|
 | Control % | Change white temperature using DPT 5.001. 0 = full warm, 100 = full cold.|
 | Status %| Temperature status GA. DPT 5.001 absolute value: 0 = full warm, 100 = full cold.|
-| Control kelvin | **DPT 7.600: ** set temperature in Kelvin using the KNX range 2000-6535 (converted to Hue mirek).<br/>**DPT 9.002:** set temperature using Hue range 2000-6535 K (Ambiance starts at 2200 K). Conversions may introduce small deviations.|
-| Status kelvin | **DPT 7.600: ** read temperature in Kelvin using KNX range 2000-6535 (converted from Hue).<br/>**DPT 9.002:** read temperature using Hue range 2000-6535 K (Ambiance starts at 2200 K). Conversions may introduce small deviations. |
+| Control kelvin | **DPT 7.600:** set the Matter color temperature in Kelvin in the supported endpoint range.<br/>**DPT 9.002:** set the temperature as a KNX floating-point value. Conversions may introduce small deviations. |
+| Status kelvin | **DPT 7.600:** read the Matter color temperature in Kelvin.<br/>**DPT 9.002:** read the temperature as a KNX floating-point value. |
 | Invert dim direction | Inverts the DIM direction. |
 <br/>
 
@@ -2227,12 +2219,12 @@ For controlling the HSV "V” (brightness), use the standard controls under the
 
 **Effects**
 
-_Non-Hue basic effects_
+_Basic Matter effects_
 
 |Property|Description|
 |--|--|
-| Blink | _true_ Blink the light, _false_ Stop blinking. Blinks the light on and off. Useful for signalling. Works with all Hue lights. |
-| Color Cycle | _true_ start cycle, _false_ Stop cycle. Randomly changes the Hue light's color at regular interval. Works with all Hue lights having color capabilities. The color effect will start 10 seconds after set. |
+| Blink | _true_ blinks the light, _false_ stops blinking. Useful for signalling and available on compatible Matter lights. |
+| Color Cycle | _true_ starts the cycle, _false_ stops it. Randomly changes the Matter light color at regular intervals when color control is supported. |
 
 <br/>
 
@@ -2240,16 +2232,16 @@ _Non-Hue basic effects_
 
 | Property | Description |
 | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Read status at startup | Read the Hue light status at node-red's startup or node-red's full deploy, and send that status to the KNX BUS |
-| KNX Brightness Status | Updates the KNX brightness group address status, whenever the Hue lamp is switched ON/OFF. The options are **When Hue light is Off send 0%. When Hue On, restore previous value (Default KNX behaviour) ** and**Leave as is (default Hue behaviour) ** . If you have KNX dimmer with brightness status, like MDT, the suggested option is _**When Hue light is Off send 0%. When Hue On, restore previous value (Default KNX behaviour)** _ |
-| Update local cached Hue state from KNX bus writes | Advanced option, enabled by default. When enabled, writes arriving from the KNX bus also update the node's local cached Hue state immediately, without waiting for feedback/events from the Hue bridge. This gives faster local reactions and more consistent immediate KNX read responses, especially while the light or grouped light is OFF. Disable it if you prefer the cache to follow only real feedback/events from the Hue bridge. |
+| Read status at startup | Read the Matter endpoint status at Node-RED startup or full deploy and send it to the KNX bus. |
+| KNX Brightness Status | Updates the KNX brightness status whenever the Matter light switches ON/OFF. It can send 0% while OFF and restore the previous value when ON, or leave the brightness status unchanged. |
+| Update local cached Matter state from KNX bus writes | When enabled, KNX writes immediately update the local Matter-state cache without waiting for the endpoint report. Disable it if the cache should follow only real Matter reports. |
 | Switch on behaviour | It sets the behaviour of your lights when switched on. You can choose from differents behaviours.<br/> **Select color: ** the light will be switched on with the color of your choice. To change color, just CLICK on the color selector (under the _Select color_ control).<br/>**Select temperature and brightness: ** the light will be switched on with the temperature (Kelvin) and brightness (0-100) of your choice.<br/>**None:** the light will retain its last status. In case you've enable the night lighting, after the night time ends, the lamp will resume the color/temperature/brightness state set at day time. |
 | Night Lighting | It allows to set a particular light color/brightness at nighttime. The options are the same as the daytime. You could select either a temperature/brightness or color. A cozy temperature of 2700 Kelvin, with a brightness of 10% or 20%, is a good choice for bathroom's night light.|
 | Day/Night | Select the group address used to set the day/night behaviour. The group address value is _true_ if daytime, _false_ if nighttime. |
 | Invert day/night value | Invert the values of _Day/Night_ group address. Default value is **unchecked** . |
 | Read status at startup | Read the status at startup and emit the event to the KNX bus at startup/reconnection. (Default "no")|
 | Force day mode | You can force the day mode by manually switching the light as described here: **Switch to DAY mode by rapid switching the ligth off then on (This light only) ** does what described and acts only on this light.**Switch to DAY mode by rapid switching the ligth off then on (apply yo ALL light nodes)** acts to ALL Light nodes, by setting the Day/Night group address to Day mode. |
-| Node Input/Output PINs | Hide or show the input/output PINs. Input/output PINS allow the node to accept msg input from the flow and send msg output to the flow. Input msg must follow the Hue API v.2 Standards. This is an example msg, that turns on the light: <code>msg.on = {"on":true}</code>. Please refer to the [official Hue Api page](https://developers.meethue.com/develop/hue-api-v2/api-reference/#resource_light__id__put) |
+| Node Input/Output PINs | Hide or show the flow input/output PINs. The input accepts supported Matter commands and the output emits validated Matter endpoint events. The selection is persisted with the node. |
 
 ### Note
 

package/nodes/knxUltimateMatterControllerDevice.js

@@ -23,6 +23,10 @@ module.exports = function (RED) {
 
     let matterCapabilities = {}
     try { matterCapabilities = JSON.parse(config.matterDeviceCapabilities || '{}') } catch (error) { /* empty */ }
+    // Non-light endpoints are handled by isolated profiles. A successful profile setup
+    // owns the complete node lifecycle and deliberately bypasses the legacy light path.
+    // Keeping this boundary here prevents new device types from changing established
+    // light behaviour or its saved configuration contract.
     if (setupMatterControllerProfile(matterCapabilities.profile, RED, node, config)) return
 
     // Matter engine (adapter). The manager is resolved lazily at each write, because
@@ -115,8 +119,8 @@ module.exports = function (RED) {
       config.GADaylightSensor
     ].map((ga) => String(ga || '').trim()).filter((ga) => ga !== '')
     const isConfiguredKNXGA = (ga) => node.knxUltimateAcceptedGAs.includes(String(ga || '').trim())
-    // Synthetic "current device" in Hue shape, kept in sync from the Matter attribute
-    // reports. It lets the whole Hue-born logic below run untouched on a Matter light.
+    // Synthetic current-device compatibility state, kept in sync from Matter attribute
+    // reports. It lets the established light logic run untouched on a Matter light.
     node.currentHUEDevice = {
       id: node.matterNodeId,
       type: 'light',
@@ -221,14 +225,14 @@ module.exports = function (RED) {
         node.status({ fill, shape, text: (node.sHUENodeStatusText || '') + ' ' + (node.sKNXNodeStatusText || '') })
       } catch (error) { }
     }
-    // Used to call the status update from the HUE config node.
+    // Compatibility callback used to update the Matter node status.
     node.setNodeStatusHue = ({ fill, shape, text, payload }) => {
       try {
         if (node.currentHUEDevice?.on?.on === true) { fill = 'blue'; shape = 'dot' } else { fill = 'blue'; shape = 'ring' };
         if (payload === undefined) payload = ''
         const dDate = new Date()
         payload = typeof payload === 'object' ? JSON.stringify(payload) : payload.toString()
-        node.sHUENodeStatusText = `|HUE: ${text} ${payload} (${formatTs(dDate)})`
+        node.sHUENodeStatusText = `|Matter: ${text} ${payload} (${formatTs(dDate)})`
         node.status({ fill, shape, text: node.sHUENodeStatusText + ' ' + (node.sKNXNodeStatusText || '') })
       } catch (error) { }
     }
@@ -323,7 +327,7 @@ module.exports = function (RED) {
       return Math.floor(Math.random() * (max - min + 1) + min) // The maximum is inclusive and the minimum is inclusive
     }
 
-    // This function is called by the hue-config.js
+    // Compatibility callback invoked by the Matter controller adapter.
     node.handleSend = (msg) => {
       if (!msg || !msg.knx || !isConfiguredKNXGA(msg.knx.destination)) return
       if (node.currentHUEDevice === undefined && node.serverHue.linkStatus === 'connected') {
@@ -1166,7 +1170,7 @@ module.exports = function (RED) {
           node.setNodeStatusHue({
             fill: 'red',
             shape: 'ring',
-            text: "Rejected HUE light settings. I'm still not ready...",
+            text: "Rejected Matter light settings. I'm still not ready...",
             payload: ''
           })
           return

package/nodes/locales/de/knxUltimateMatterControllerDevice.html

@@ -21,7 +21,7 @@ Er ersetzt die unveröffentlichten getrennten Matter-Controller-Nodes und behäl
 | Sensoren | Sensor-Endpunkte zeigen ihre Mess-/Status-GA nur bei Unterstützung: Temperatur, Feuchte, Helligkeit, Präsenz, Kontakt und Batterie. |
 | Read at startup | Veröffentlicht den gecachten Matter-Wert beim Deploy/Start oder wenn sich das Gerät erneut verbindet. |
 | Update local state from KNX write | Aktualisiert den lokalen Matter/KNX-Cache, wenn ein Telegramm auf eine konfigurierte KNX-GA geschrieben wird. |
-| Node Input/Output PINs | Zeigt Node-RED-Eingangs-/Ausgangspins. Der Eingang akzeptiert boolesche Payloads sowie Matter-ähnliche `msg.payload` oder `msg.on.on`; der Ausgang sendet Statusupdates. |
+| Node Input/Output PINs | Zeigt Node-RED-Eingangs-/Ausgangspins. Der Eingang akzeptiert boolesche Payloads sowie Matter-ähnliche `msg.payload` oder `msg.on.on`; der Ausgang sendet Statusupdates. Die Auswahl bleibt beim erneuten Öffnen des Editors erhalten. |
 
 ## Verhalten
 

package/nodes/locales/de/knxUltimateMatterControllerDevice.json

@@ -35,14 +35,14 @@
     "get_current": "Aktuellen Wert holen",
     "get_again": "Erneut holen",
     "wait": "Bitte warten...",
-    "locate_no_bridge": "Bitte zuerst eine Hue-Bridge auswählen",
-    "locate_no_device": "Bitte zuerst ein Hue-Gerät auswählen",
+    "locate_no_bridge": "Bitte zuerst einen Matter-Controller auswählen",
+    "locate_no_device": "Bitte zuerst ein Matter-Gerät auswählen",
     "locate_success": "Locate-Befehl gesendet",
     "locate_started": "Locate-Modus gestartet. Nochmal drücken, um zu stoppen (automatisch nach 10 Minuten).",
     "locate_stopped": "Locate-Modus beendet.",
-    "locate_start_title": "Ausgewähltes Hue-Gerät lokalisieren",
+    "locate_start_title": "Ausgewähltes Matter-Gerät lokalisieren",
     "locate_stop_title": "Locate-Modus beenden",
-    "locate_error": "Hue-Gerät konnte nicht lokalisiert werden",
+    "locate_error": "Matter-Gerät konnte nicht lokalisiert werden",
     "day_night": "Tag/Nacht",
     "invert_day_night": "Tag/Nacht-Wert invertieren",
     "override_night_mode": "Tagmodus erzwingen",
@@ -56,11 +56,11 @@
     "opt_no": "Nein",
     "opt_yes_emit": "Ja, und KNX-Telegramme senden.",
     "knx_brightness_status": "KNX Helligkeitsstatus",
-    "knx_brightness_onhueoff": "Wenn HUE aus: 0% senden. Wenn HUE an: vorherigen Wert wiederherstellen (Standard KNX Verhalten)",
-    "knx_brightness_no": "Unverändert lassen (Standard HUE Verhalten)",
-    "update_local_state_from_knx_write": "Lokalen Hue-Cache durch KNX-Bus-Schreibtelegramme aktualisieren",
-    "update_local_state_from_knx_write_hint": "Aktiviert: schnellere lokale Reaktionen und konsistentere sofortige KNX-Leseantworten. Deaktiviert: Cache nur durch echte Hue-Bridge-Ereignisse aktualisieren.",
-    "use_min_brightness": "Minimale Helligkeit der HUE Lampe verwenden",
+    "knx_brightness_onhueoff": "Wenn Matter aus: 0% senden. Wenn Matter an: vorherigen Wert wiederherstellen (Standard-KNX-Verhalten)",
+    "knx_brightness_no": "Unverändert lassen (Standard-Matter-Verhalten)",
+    "update_local_state_from_knx_write": "Lokalen Matter-Cache durch KNX-Bus-Schreibtelegramme aktualisieren",
+    "update_local_state_from_knx_write_hint": "Aktiviert: schnellere lokale Reaktionen und konsistentere sofortige KNX-Leseantworten. Deaktiviert: Cache nur durch echte Matter-Berichte aktualisieren.",
+    "use_min_brightness": "Minimale Helligkeit der Matter-Lampe verwenden",
     "k_suffix": "K",
     "temp_desc_2200": "(Beginn der Philips White Ambiance Reihe)",
     "temp_desc_2700": "(Warmweiß, intim, gemütlich, persönlich, für Wohnzimmer)",
@@ -83,12 +83,12 @@
     "effect_status": "Effekt-Status",
     "effect_mapping": "Zuordnungen",
     "effect_autofill": "Mit verfügbaren Effekten füllen",
-    "effect_tip": "Hinterlege KNX-Wert/Hue-Effekt-Paare. Bei passendem KNX-Wert wird der ausgewählte Effekt ausgelöst.",
+    "effect_tip": "Hinterlege KNX-Wert/Matter-Effekt-Paare. Bei passendem KNX-Wert wird der ausgewählte Effekt ausgelöst.",
     "effect_tip_status": "Ist eine Status-GA gesetzt, sendet der Knoten den aktuellen Effekt (zugeordneter Wert oder Name) auf den KNX-Bus.",
-    "effect_not_supported": "Diese Leuchte stellt keine Hue-Effekte bereit.",
+    "effect_not_supported": "Diese Leuchte stellt keine Matter-Effekte bereit.",
     "effect_knx_value_placeholder": "Abzugleichender Wert",
-    "effect_base_label": "Nicht-Hue-Basiseffekte",
-    "effect_native_label": "Hue-native Effekte",
+    "effect_base_label": "Matter-Basiseffekte",
+    "effect_native_label": "Native Matter-Effekte",
     "matter_controller": "Matter-Controller",
     "matter_device": "Matter-Gerät",
     "device_type": "Gerätetyp",
@@ -100,8 +100,8 @@
     "name": "Name",
     "youtube_sample": "YouTube-Beispiel",
     "knx_gw": "KNX-Gateway",
-    "hue_bridge": "Hue Bridge",
-    "philips_hue": "Philips HUE",
+    "hue_bridge": "Matter-Controller",
+    "philips_hue": "Matter",
     "read": "Lesen"
   }
 }

package/nodes/locales/en/knxUltimateMatterControllerDevice.html

@@ -21,7 +21,7 @@ It replaces the unpublished per-device Matter controller nodes and keeps the ful
 | Sensors | Sensor endpoints expose their measurement/status GA only when supported: temperature, humidity, illuminance, occupancy, contact and battery. |
 | Read at startup | Publishes the cached Matter value at deploy/startup or when the device reconnects. |
 | Update local state from KNX write | Updates the local Matter/KNX cache when a telegram is written on a configured KNX GA. |
-| Node Input/Output PINs | Shows Node-RED input/output pins. Input accepts boolean payloads and Matter-style `msg.payload` or `msg.on.on`; output emits state updates. |
+| Node Input/Output PINs | Shows Node-RED input/output pins. Input accepts boolean payloads and Matter-style `msg.payload` or `msg.on.on`; output emits state updates. The selection is preserved when the editor is reopened. |
 
 ## Behaviour
 

package/nodes/locales/en/knxUltimateMatterControllerDevice.json

@@ -35,14 +35,14 @@
     "get_current": "Get current",
     "get_again": "Get again",
     "wait": "Wait...",
-    "locate_no_bridge": "Select a Hue bridge first",
-    "locate_no_device": "Select a Hue device first",
+    "locate_no_bridge": "Select a Matter controller first",
+    "locate_no_device": "Select a Matter device first",
     "locate_success": "Locate command sent",
     "locate_started": "Locate mode started. Press again to stop (auto-stops after 10 minutes).",
     "locate_stopped": "Locate mode stopped.",
-    "locate_start_title": "Locate selected Hue device",
+    "locate_start_title": "Locate selected Matter device",
     "locate_stop_title": "Stop locate mode",
-    "locate_error": "Unable to locate Hue device",
+    "locate_error": "Unable to locate Matter device",
     "day_night": "Day/Night",
     "invert_day_night": "Invert day/night value",
     "override_night_mode": "Force day mode",
@@ -56,11 +56,11 @@
     "opt_no": "No",
     "opt_yes_emit": "Yes, and emit KNX telegrams.",
     "knx_brightness_status": "KNX Brightness Status",
-    "knx_brightness_onhueoff": "When Hue light is Off send 0%. When Hue On, restore previous value (Default KNX behaviour)",
-    "knx_brightness_no": "Leave as is (default Hue behaviour)",
-    "update_local_state_from_knx_write": "Update local cached Hue state from KNX bus writes",
-    "update_local_state_from_knx_write_hint": "Enabled: faster local reactions and consistent immediate KNX read responses. Disabled: keep the cache aligned only with real Hue bridge events.",
-    "use_min_brightness": "Use minimum brightness specified in the Hue light",
+    "knx_brightness_onhueoff": "When the Matter light is Off send 0%. When it is On, restore the previous value (default KNX behaviour)",
+    "knx_brightness_no": "Leave as is (default Matter behaviour)",
+    "update_local_state_from_knx_write": "Update local cached Matter state from KNX bus writes",
+    "update_local_state_from_knx_write_hint": "Enabled: faster local reactions and consistent immediate KNX read responses. Disabled: keep the cache aligned only with real Matter reports.",
+    "use_min_brightness": "Use minimum brightness specified for the Matter light",
     "k_suffix": "K",
     "temp_desc_2200": "(start of Philips White Ambiance lights range)",
     "temp_desc_2700": "(warm white, intimate, cozy, personal, for living rooms)",
@@ -83,12 +83,12 @@
     "effect_status": "Effect status",
     "effect_mapping": "Mappings",
     "effect_autofill": "Fill with available effects",
-    "effect_tip": "Provide KNX value / Hue effect pairs. When the incoming KNX payload matches the value, the selected effect is applied to the light.",
-    "effect_tip_status": "If a status group address is configured, the current Hue effect is emitted using the mapped KNX value or the effect name.",
-    "effect_not_supported": "This light does not expose Hue effects.",
+    "effect_tip": "Provide KNX value / Matter effect pairs. When the incoming KNX payload matches the value, the selected effect is applied to the light.",
+    "effect_tip_status": "If a status group address is configured, the current Matter effect is emitted using the mapped KNX value or the effect name.",
+    "effect_not_supported": "This light does not expose Matter effects.",
     "effect_knx_value_placeholder": "Value to match",
-    "effect_base_label": "Non-Hue basic effects",
-    "effect_native_label": "Hue native effects",
+    "effect_base_label": "Basic Matter effects",
+    "effect_native_label": "Native Matter effects",
     "matter_controller": "Matter controller",
     "matter_device": "Matter device",
     "device_type": "Device type",
@@ -100,8 +100,8 @@
     "name": "Name",
     "youtube_sample": "Youtube sample",
     "knx_gw": "KNX GW",
-    "hue_bridge": "Hue Bridge",
-    "philips_hue": "Philips HUE",
+    "hue_bridge": "Matter controller",
+    "philips_hue": "Matter",
     "read": "Read"
   }
 }

package/nodes/locales/es/knxUltimateMatterControllerDevice.html

@@ -21,7 +21,7 @@ Sustituye a los nodos Matter separados no publicados y conserva toda la UI de lu
 | Sensores | Los endpoints de sensor muestran su GA de medida/estado solo cuando está soportado: temperatura, humedad, iluminancia, ocupación, contacto y batería. |
 | Read at startup | Publica el valor Matter en caché al desplegar/iniciar o cuando el dispositivo se reconecta. |
 | Update local state from KNX write | Actualiza la caché local Matter/KNX cuando se escribe un telegrama en una GA KNX configurada. |
-| Node Input/Output PINs | Muestra pines de entrada/salida Node-RED. La entrada acepta payloads booleanos y mensajes Matter en `msg.payload` o `msg.on.on`; la salida emite estados. |
+| Node Input/Output PINs | Muestra pines de entrada/salida Node-RED. La entrada acepta payloads booleanos y mensajes Matter en `msg.payload` o `msg.on.on`; la salida emite estados. La selección se conserva al volver a abrir el editor. |
 
 ## Comportamiento
 

package/nodes/locales/es/knxUltimateMatterControllerDevice.json

@@ -35,14 +35,14 @@
     "get_current": "Obtener",
     "get_again": "Volver a",
     "wait": "Esperar...",
-    "locate_no_bridge": "Seleccione primero un bridge Hue",
-    "locate_no_device": "Seleccione primero un dispositivo Hue",
+    "locate_no_bridge": "Seleccione primero un controlador Matter",
+    "locate_no_device": "Seleccione primero un dispositivo Matter",
     "locate_success": "Comando de localización enviado",
     "locate_started": "Modo de localización iniciado. Pulsa de nuevo para detenerlo (se detiene automáticamente tras 10 minutos).",
     "locate_stopped": "Modo de localización detenido.",
-    "locate_start_title": "Localizar el dispositivo Hue seleccionado",
+    "locate_start_title": "Localizar el dispositivo Matter seleccionado",
     "locate_stop_title": "Detener el modo de localización",
-    "locate_error": "No se pudo localizar el dispositivo Hue",
+    "locate_error": "No se pudo localizar el dispositivo Matter",
     "day_night": "Día/noche",
     "invert_day_night": "Invertir el valor de día/noche",
     "override_night_mode": "Forzar el modo diurno",
@@ -58,8 +58,8 @@
     "knx_brightness_status": "Estado de brillo KNX",
     "knx_brightness_onhueoff": "Cuando la luz del tono está apagada, envíe 0%. Cuando se enciende, restaure el valor anterior (comportamiento de KNX predeterminado)",
     "knx_brightness_no": "Salir como está (comportamiento de tono predeterminado)",
-    "update_local_state_from_knx_write": "Actualizar el estado local en caché de Hue a partir de escrituras del bus KNX",
-    "update_local_state_from_knx_write_hint": "Activado: reacciones locales mas rapidas y respuestas inmediatas de lectura KNX mas coherentes. Desactivado: la cache se actualiza solo con eventos reales del bridge Hue.",
+    "update_local_state_from_knx_write": "Actualizar el estado local en caché de Matter a partir de escrituras del bus KNX",
+    "update_local_state_from_knx_write_hint": "Activado: reacciones locales más rápidas y respuestas inmediatas de lectura KNX más coherentes. Desactivado: la caché se actualiza solo con informes Matter reales.",
     "use_min_brightness": "Use brillo mínimo especificado en la luz del tono",
     "k_suffix": "K",
     "temp_desc_2200": "(Inicio de Philips White Ambiance Lights Range)",
@@ -83,7 +83,7 @@
     "effect_status": "Estado del efecto",
     "effect_mapping": "Mapeos",
     "effect_autofill": "Llenar con los efectos disponibles",
-    "effect_tip": "Proporcione pares de valor KNX / Effect Hue. Cuando la carga útil de KNX entrante coincide con el valor, el efecto seleccionado se aplica a la luz.",
+    "effect_tip": "Proporcione pares de valor KNX / efecto Matter. Cuando la carga útil de KNX entrante coincide con el valor, el efecto seleccionado se aplica a la luz.",
     "effect_tip_status": "Si se configura una dirección de grupo de estado, el efecto de tono actual se emite utilizando el valor KNX asignado o el nombre del efecto.",
     "effect_not_supported": "Esta luz no expone los efectos del tono.",
     "effect_knx_value_placeholder": "Valor para coincidir",
@@ -100,8 +100,8 @@
     "name": "Nombre",
     "youtube_sample": "Muestra de youtube",
     "knx_gw": "KNX GW",
-    "hue_bridge": "Hue Bridge",
-    "philips_hue": "Tono Philips",
+    "hue_bridge": "Controlador Matter",
+    "philips_hue": "Matter",
     "read": "Leer"
   }
 }

package/nodes/locales/fr/knxUltimateMatterControllerDevice.html

@@ -21,7 +21,7 @@ Il remplace les nœuds Matter séparés non publiés et conserve toute l'UI lumi
 | Capteurs | Les endpoints capteur affichent leur GA de mesure/état uniquement si elle est supportée : température, humidité, éclairement, occupation, contact et batterie. |
 | Read at startup | Publie la valeur Matter en cache au déploiement/démarrage ou quand le périphérique se reconnecte. |
 | Update local state from KNX write | Met à jour le cache local Matter/KNX lorsqu'un télégramme est écrit sur une GA KNX configurée. |
-| Node Input/Output PINs | Affiche les pins entrée/sortie Node-RED. L'entrée accepte les payloads booléens et les messages Matter dans `msg.payload` ou `msg.on.on`; la sortie émet les états. |
+| Node Input/Output PINs | Affiche les pins entrée/sortie Node-RED. L'entrée accepte les payloads booléens et les messages Matter dans `msg.payload` ou `msg.on.on`; la sortie émet les états. La sélection est conservée à la réouverture de l'éditeur. |
 
 ## Comportement
 

package/nodes/locales/fr/knxUltimateMatterControllerDevice.json

@@ -48,10 +48,10 @@
     "opt_no": "Non",
     "opt_yes_emit": "Oui, et émettez des télégrammes KNX.",
     "knx_brightness_status": "Statut de luminosité de KNX",
-    "knx_brightness_onhueoff": "Lorsque Hue Light est éteint, envoyez 0%. Lorsque Hue On, restaurez la valeur précédente (comportement KNX par défaut)",
+    "knx_brightness_onhueoff": "Lorsque la lumière Matter est éteinte, envoyer 0 %. Lorsqu'elle est allumée, restaurer la valeur précédente (comportement KNX par défaut)",
     "knx_brightness_no": "Laisser tel quel (comportement de teinte par défaut)",
-    "update_local_state_from_knx_write": "Mettre à jour l'état Hue local en cache à partir des écritures du bus KNX",
-    "update_local_state_from_knx_write_hint": "Active: reactions locales plus rapides et reponses immediates de lecture KNX plus coherentes. Desactive: le cache ne suit que les evenements reels du bridge Hue.",
+    "update_local_state_from_knx_write": "Mettre à jour l'état Matter local en cache à partir des écritures du bus KNX",
+    "update_local_state_from_knx_write_hint": "Activé : réactions locales plus rapides et réponses immédiates de lecture KNX plus cohérentes. Désactivé : le cache ne suit que les rapports Matter réels.",
     "use_min_brightness": "Utilisez une luminosité minimale spécifiée dans la lumière des teintes",
     "k_suffix": "K",
     "temp_desc_2200": "(Début de la gamme Philips White Ambiance Lights)",
@@ -75,7 +75,7 @@
     "effect_status": "État de l'effet",
     "effect_mapping": "Mappages",
     "effect_autofill": "Remplissez les effets disponibles",
-    "effect_tip": "Fournir des paires d'effets KNX Valeur / Hue. Lorsque la charge utile KNX entrante correspond à la valeur, l'effet sélectionné est appliqué à la lumière.",
+    "effect_tip": "Fournir des paires valeur KNX / effet Matter. Lorsque la charge utile KNX entrante correspond à la valeur, l'effet sélectionné est appliqué à la lumière.",
     "effect_tip_status": "Si une adresse de groupe d'état est configurée, l'effet de teinte actuel est émis en utilisant la valeur KNX mappée ou le nom d'effet.",
     "effect_not_supported": "Cette lumière n'expose pas les effets de la teinte.",
     "effect_knx_value_placeholder": "Valeur à correspondre",
@@ -92,8 +92,8 @@
     "name": "Nom",
     "youtube_sample": "Échantillon YouTube",
     "knx_gw": "KNX GW",
-    "hue_bridge": "Hue Bridge",
-    "philips_hue": "Hue Philips",
+    "hue_bridge": "Contrôleur Matter",
+    "philips_hue": "Matter",
     "read": "Lire"
   }
 }

package/nodes/locales/it/knxUltimateMatterControllerDevice.html

@@ -21,7 +21,7 @@ Sostituisce i nodi Matter separati non pubblicati e mantiene tutta la UI luce qu
 | Sensori | Gli endpoint sensore mostrano il relativo GA di misura/stato solo quando supportato: temperatura, umidità, illuminamento, presenza, contatto e batteria. |
 | Read at startup | Pubblica il valore Matter in cache al deploy/avvio o quando il dispositivo si riconnette. |
 | Update local state from KNX write | Aggiorna la cache locale Matter/KNX quando arriva una scrittura su un GA KNX configurato. |
-| Node Input/Output PINs | Mostra i pin input/output Node-RED. L'input accetta payload booleani e messaggi stile Matter in `msg.payload` o `msg.on.on`; l'output emette gli aggiornamenti di stato. |
+| Node Input/Output PINs | Mostra i pin input/output Node-RED. L'input accetta payload booleani e messaggi stile Matter in `msg.payload` o `msg.on.on`; l'output emette gli aggiornamenti di stato. La selezione viene mantenuta alla riapertura dell'editor. |
 
 ## Comportamento
 

package/nodes/locales/it/knxUltimateMatterControllerDevice.json

@@ -35,14 +35,14 @@
     "get_current": "Ottieni corrente",
     "get_again": "Ottieni di nuovo",
     "wait": "Attendere...",
-    "locate_no_bridge": "Seleziona prima un bridge Hue",
-    "locate_no_device": "Seleziona prima un dispositivo Hue",
+    "locate_no_bridge": "Seleziona prima un controller Matter",
+    "locate_no_device": "Seleziona prima un dispositivo Matter",
     "locate_success": "Comando di localizzazione inviato",
     "locate_started": "Modalità di localizzazione avviata. Premi di nuovo per fermarla (si ferma automaticamente dopo 10 minuti).",
     "locate_stopped": "Modalità di localizzazione terminata.",
-    "locate_start_title": "Localizza il dispositivo Hue selezionato",
+    "locate_start_title": "Localizza il dispositivo Matter selezionato",
     "locate_stop_title": "Ferma la modalità di localizzazione",
-    "locate_error": "Impossibile localizzare il dispositivo Hue",
+    "locate_error": "Impossibile localizzare il dispositivo Matter",
     "day_night": "Giorno/Notte",
     "invert_day_night": "Inverti valore giorno/notte",
     "override_night_mode": "Forza modalità diurna",
@@ -56,11 +56,11 @@
     "opt_no": "No",
     "opt_yes_emit": "Sì, ed emetti i telegrammi KNX.",
     "knx_brightness_status": "Stato luminosità KNX",
-    "knx_brightness_onhueoff": "Se la luce HUE è spenta invia 0%. Se è accesa, ripristina il valore precedente (Comportamento KNX predefinito)",
-    "knx_brightness_no": "Lascia invariato (comportamento HUE predefinito)",
-    "update_local_state_from_knx_write": "Aggiorna lo stato HUE locale in cache dai write provenienti dal bus KNX",
-    "update_local_state_from_knx_write_hint": "Abilitato: reazioni locali piu rapide e risposte immediate ai read KNX piu coerenti. Disabilitato: la cache si aggiorna solo dagli eventi reali del bridge Hue.",
-    "use_min_brightness": "Usa la luminosità minima specificata nella luce HUE",
+    "knx_brightness_onhueoff": "Se la luce Matter è spenta invia 0%. Se è accesa, ripristina il valore precedente (comportamento KNX predefinito)",
+    "knx_brightness_no": "Lascia invariato (comportamento Matter predefinito)",
+    "update_local_state_from_knx_write": "Aggiorna lo stato Matter locale in cache dai write provenienti dal bus KNX",
+    "update_local_state_from_knx_write_hint": "Abilitato: reazioni locali più rapide e risposte immediate ai read KNX più coerenti. Disabilitato: la cache si aggiorna solo dai report Matter reali.",
+    "use_min_brightness": "Usa la luminosità minima specificata per la luce Matter",
     "k_suffix": "K",
     "temp_desc_2200": "(inizio della gamma Philips White Ambiance)",
     "temp_desc_2700": "(bianco caldo, intimo, accogliente, personale, per soggiorni)",
@@ -83,12 +83,12 @@
     "effect_status": "Stato effetti",
     "effect_mapping": "Associazioni",
     "effect_autofill": "Compila con gli effetti disponibili",
-    "effect_tip": "Definisci le coppie valore KNX / effetto Hue. Quando il valore KNX ricevuto coincide, viene attivato l'effetto selezionato.",
+    "effect_tip": "Definisci le coppie valore KNX / effetto Matter. Quando il valore KNX ricevuto coincide, viene attivato l'effetto selezionato.",
     "effect_tip_status": "Se configuri lo stato, il nodo invierà su KNX l'effetto corrente (valore associato o nome).",
-    "effect_not_supported": "Questa lampada non espone effetti Hue.",
+    "effect_not_supported": "Questa lampada non espone effetti Matter.",
     "effect_knx_value_placeholder": "Valore da confrontare",
-    "effect_base_label": "Effetti base non HUE",
-    "effect_native_label": "Effetti nativi HUE",
+    "effect_base_label": "Effetti base Matter",
+    "effect_native_label": "Effetti nativi Matter",
     "matter_controller": "Controller Matter",
     "matter_device": "Dispositivo Matter",
     "device_type": "Tipo dispositivo",
@@ -100,8 +100,8 @@
     "name": "Nome",
     "youtube_sample": "Esempio YouTube",
     "knx_gw": "Gateway KNX",
-    "hue_bridge": "Hue Bridge",
-    "philips_hue": "Philips HUE",
+    "hue_bridge": "Controller Matter",
+    "philips_hue": "Matter",
     "read": "Leggi"
   }
 }

package/nodes/locales/zh-CN/knxUltimateMatterControllerDevice.html

@@ -21,7 +21,7 @@
 | 传感器 | 传感器 endpoint 只在支持时显示对应测量/状态 GA：温度、湿度、照度、占用、接触和电池。 |
 | Read at startup | 在部署/启动或设备重新连接时发布缓存的 Matter 值。 |
 | Update local state from KNX write | 当配置的 KNX GA 收到写入 telegram 时，更新本地 Matter/KNX 缓存。 |
-| Node Input/Output PINs | 显示 Node-RED 输入/输出端口。输入接受布尔 payload，以及 `msg.payload` 或 `msg.on.on` 中的 Matter 风格消息；输出发送状态更新。 |
+| Node Input/Output PINs | 显示 Node-RED 输入/输出端口。输入接受布尔 payload，以及 `msg.payload` 或 `msg.on.on` 中的 Matter 风格消息；输出发送状态更新。重新打开编辑器时会保留此选择。 |
 
 ## 行为
 

package/nodes/locales/zh-CN/knxUltimateMatterControllerDevice.json

@@ -48,11 +48,11 @@
     "opt_no": "否",
     "opt_yes_emit": "是，并发送 KNX 电报。",
     "knx_brightness_status": "KNX 亮度状态",
-    "knx_brightness_onhueoff": "当 HUE 灯关闭时发送 0%。当 HUE 打开时恢复先前值（默认 KNX 行为）",
-    "knx_brightness_no": "保持不变（默认 HUE 行为）",
-    "update_local_state_from_knx_write": "根据 KNX 总线写入更新本地缓存的 Hue 状态",
-    "update_local_state_from_knx_write_hint": "启用：本地响应更快，KNX 即时读回更一致。禁用：缓存只根据 Hue 网关的真实事件更新。",
-    "use_min_brightness": "使用 HUE 灯中设置的最小亮度",
+    "knx_brightness_onhueoff": "Matter 灯关闭时发送 0%。Matter 灯打开时恢复先前值（默认 KNX 行为）",
+    "knx_brightness_no": "保持不变（默认 Matter 行为）",
+    "update_local_state_from_knx_write": "根据 KNX 总线写入更新本地缓存的 Matter 状态",
+    "update_local_state_from_knx_write_hint": "启用：本地响应更快，KNX 即时读回更一致。禁用：缓存只根据真实的 Matter 报告更新。",
+    "use_min_brightness": "使用 Matter 灯中设置的最小亮度",
     "k_suffix": "K",
     "temp_desc_2200": "（飞利浦 White Ambiance 系列起始）",
     "temp_desc_2700": "（暖白，温馨、舒适、私密，适合客厅）",
@@ -75,12 +75,12 @@
     "effect_status": "效果状态",
     "effect_mapping": "映射",
     "effect_autofill": "填充可用效果",
-    "effect_tip": "配置 KNX 数值与 Hue 效果对，收到匹配的 KNX 数值时触发对应效果。",
+    "effect_tip": "配置 KNX 数值与 Matter 效果对，收到匹配的 KNX 数值时触发对应效果。",
     "effect_tip_status": "若配置状态组地址，将把当前效果（映射值或效果名称）发送到 KNX。",
-    "effect_not_supported": "该灯具不支持 Hue 效果。",
+    "effect_not_supported": "该灯具不支持 Matter 效果。",
     "effect_knx_value_placeholder": "匹配值",
-    "effect_base_label": "非 Hue 基础效果",
-    "effect_native_label": "Hue 原生效果",
+    "effect_base_label": "Matter 基础效果",
+    "effect_native_label": "Matter 原生效果",
     "matter_controller": "Matter 控制器",
     "matter_device": "Matter 设备",
     "device_type": "设备类型",
@@ -92,8 +92,8 @@
     "name": "名称",
     "youtube_sample": "YouTube 示例",
     "knx_gw": "KNX 网关",
-    "hue_bridge": "Hue Bridge",
-    "philips_hue": "飞利浦 HUE",
+    "hue_bridge": "Matter 控制器",
+    "philips_hue": "Matter",
     "read": "读取"
   }
 }

package/nodes/matter-config.js

@@ -31,7 +31,8 @@ module.exports = (RED) => {
     node.matterInstanceId = `knxultimate-matter-${node.id.replace(/[^a-zA-Z0-9]/g, '')}`
     node.matterStoragePath = path.join(RED.settings.userDir || '.', 'knxultimatestorage', 'matter')
 
-    // Helper like the hue-config one
+    // Expose controller connectivity without copying engine state into the config node.
+    // Consumers read the latest value lazily, including during asynchronous startup.
     Object.defineProperty(node, 'linkStatus', {
       get: function () {
         return node.matterManager?.matterConnectionStatus ?? 'disconnected'
@@ -39,6 +40,8 @@ module.exports = (RED) => {
     })
 
     const safeClientCall = (client, fn, label) => {
+      // One faulty device node must never interrupt event delivery to the remaining
+      // Matter clients registered on this shared controller connection.
       try {
         if (!client || typeof fn !== 'function') return
         fn()

package/nodes/utils/matterControllerProfiles/doorLock.js

@@ -28,12 +28,16 @@ const lockStateName = (value) => {
 }
 
 const lockStateToBoolean = (value) => {
+  // KNX DPT 1 can represent only two states. Do not collapse transitional or
+  // ambiguous Matter lock states into a potentially unsafe locked/unlocked value.
   if (Number(value) === LOCK_STATE.LOCKED) return true
   if (Number(value) === LOCK_STATE.UNLOCKED) return false
   return undefined
 }
 
 const setupDoorLockProfile = (RED, node, config) => {
+  // Profiles initialize the same flags consumed by knxUltimate-config as ordinary
+  // KNX nodes. In particular, listenallga must remain enabled for handleSend calls.
   node.name = config.name || node.matterDeviceName || 'Control Matter door lock from KNX'
   node.topic = node.name
   node.notifyreadrequest = true
@@ -53,8 +57,14 @@ const setupDoorLockProfile = (RED, node, config) => {
     .filter((ga) => ga !== '')
 
   const setStatus = (fill, shape, text) => node.status({ fill, shape, text })
+  // knxUltimate-config invokes this synchronously from addClient(). Profiles return
+  // early from the main light constructor, so they must expose the callback before
+  // registering with the shared KNX configuration node.
+  node.setNodeStatus = ({ fill = 'grey', shape = 'ring', text = '' } = {}) => setStatus(fill, shape, text)
 
   const commandArgs = () => {
+    // Matter represents the remote credential as bytes. Keep the PIN in Node-RED's
+    // credential store and materialize the Buffer only for the outgoing command.
     const pin = String(node.credentials?.doorLockPin || '')
     return pin === '' ? {} : { pinCode: Buffer.from(pin, 'utf8') }
   }
@@ -91,6 +101,8 @@ const setupDoorLockProfile = (RED, node, config) => {
     node.currentLockState = Number(rawState)
     const state = lockStateToBoolean(rawState)
     const name = lockStateName(rawState)
+    // Attribute reports update KNX state only; they never enqueue a Matter command.
+    // This one-way path is the primary feedback-loop guard for Door Lock endpoints.
     if (state !== undefined) writeKnxState(state)
     sendFlow(source, state, rawState)
     setStatus(state === undefined ? 'yellow' : 'blue', state === undefined ? 'ring' : 'dot', `Matter: ${name}`)
@@ -102,6 +114,8 @@ const setupDoorLockProfile = (RED, node, config) => {
     const capabilities = (() => {
       try { return JSON.parse(config.matterDeviceCapabilities || '{}') } catch (error) { return {} }
     })()
+    // Never invent optional operations: the editor persists the commands actually
+    // advertised by this endpoint and runtime validation enforces that snapshot.
     if (locked && capabilities.lockDoor === false) throw new Error('The Matter endpoint does not expose lockDoor')
     if (!locked && capabilities.unlockDoor === false) throw new Error('The Matter endpoint does not expose unlockDoor')
     const queued = manager.writeMatterQueueAdd({
@@ -153,6 +167,8 @@ const setupDoorLockProfile = (RED, node, config) => {
   node.handleMatterClusterEvent = () => {}
   node.handleMatterNodeInitialized = () => {
     try {
+      // The controller engine already caches the initial attribute read. Reusing that
+      // value avoids an extra request and publishes startup state through the same path.
       const value = node.serverMatter?.matterManager?.getCachedAttribute(
         node.matterNodeId,
         node.matterEndpointId,

package/nodes/utils/matterControllerProfiles/index.js

@@ -13,7 +13,10 @@ const PROFILE_SETUPS = Object.freeze({
 
 const setupMatterControllerProfile = (profile, RED, node, config) => {
   const setup = PROFILE_SETUPS[profile]
+  // Returning false is significant: the caller must continue through the unchanged
+  // Matter-light implementation when no specialized profile claims the endpoint.
   if (typeof setup !== 'function') return false
+  // A profile that returns successfully owns input, close, KNX and Matter handlers.
   setup(RED, node, config)
   return true
 }

package/nodes/utils/matterControllerProfiles/mappedEndpoint.js

@@ -13,6 +13,8 @@ const isValidGroupAddress = (value) => {
 const parseMappings = (value) => {
   try {
     const parsed = Array.isArray(value) ? value : JSON.parse(value || '[]')
+    // Ignore incomplete or stale editor rows. Only mappings with a valid KNX address,
+    // resolvable DPT and explicit Matter target are allowed into runtime routing.
     return parsed.filter((mapping) => {
       if (!mapping || !isValidGroupAddress(mapping.ga) || !mapping.target || !mapping.dpt) return false
       try { dptlib.resolve(mapping.dpt); return true } catch (error) { return false }
@@ -42,6 +44,8 @@ const setupMappedEndpointProfile = (RED, node, config) => {
   let lastInitialReadTs = 0
 
   const status = (fill, shape, text) => node.status({ fill, shape, text })
+  // knxUltimate-config calls setNodeStatus synchronously while adding the client.
+  node.setNodeStatus = ({ fill = 'grey', shape = 'ring', text = '' } = {}) => status(fill, shape, text)
   const manager = () => node.serverMatter?.matterManager
   const sendKnx = (mapping, payload, outputtype = 'write') => {
     if (payload === undefined || !node.serverKNX) return false
@@ -57,12 +61,16 @@ const setupMappedEndpointProfile = (RED, node, config) => {
   const sendCached = (mapping, outputtype) => {
     const currentManager = manager()
     if (!currentManager) return false
+    // Cached reports are authoritative for KNX read responses and startup publication;
+    // reading them must not generate a new Matter write or command.
     const value = currentManager.getCachedAttribute(node.matterNodeId, mapping.endpointId, mapping.clusterId, mapping.target)
     return sendKnx(mapping, matterToKnx(mapping.clusterId, mapping.target, value), outputtype)
   }
   const enqueue = (mapping, value) => {
     const currentManager = manager()
     if (!currentManager) throw new Error('Matter controller not ready')
+    // Conversion happens before queueing so the Matter manager receives a canonical,
+    // cluster-specific command or attribute write rather than a raw KNX payload.
     const action = knxToMatter(mapping, value)
     if (!action) return
     const queued = currentManager.writeMatterQueueAdd({
@@ -96,6 +104,8 @@ const setupMappedEndpointProfile = (RED, node, config) => {
   }
   node.handleSendMatter = (event) => {
     try {
+      // Attribute reports travel only toward KNX/flow. Keeping feedback separate from
+      // enqueue() prevents programmatic state synchronization from echoing to Matter.
       if (String(event?.nodeId) !== String(node.matterNodeId) || Number(event?.endpointId) !== Number(node.matterEndpointId)) return
       node.mappings.filter((mapping) => mapping.direction === 'status' && Number(mapping.clusterId) === Number(event.clusterId) && mapping.target === event.attributeName).forEach((mapping) => {
         sendKnx(mapping, matterToKnx(event.clusterId, event.attributeName, event.value))
@@ -108,11 +118,15 @@ const setupMappedEndpointProfile = (RED, node, config) => {
     }
   }
   node.handleMatterClusterEvent = (event) => {
+    // Cluster events have no implicit KNX mapping. They are exposed as raw flow output
+    // only when the user explicitly enables the node pins.
     if (enablePins && String(event?.nodeId) === String(node.matterNodeId) && Number(event?.endpointId) === Number(node.matterEndpointId)) {
       node.send({ topic: `${event.clusterId}.${event.eventName}`, payload: event.events, matter: event })
     }
   }
   node.handleMatterNodeInitialized = () => {
+    // nodeInitialized can be emitted more than once while sessions recover. Bound the
+    // startup publication to avoid duplicate KNX telegram bursts during reconnects.
     if (config.readStatusAtStartup === 'no' || Date.now() - lastInitialReadTs < 5000) return
     let sent = 0
     node.mappings.filter((mapping) => mapping.direction === 'status').forEach((mapping) => { if (sendCached(mapping, 'write')) sent += 1 })

package/nodes/utils/matterEngine.mjs

@@ -443,6 +443,15 @@ class classMatter extends EventEmitter {
   }
 
   _findEndpoint = (node, _endpointId) => {
+    // getDevices() can expose only functional/bridged endpoints while the root endpoint
+    // lives behind getRootEndpoint(). Resolve endpoint 0 explicitly for node clusters
+    // such as BasicInformation and GeneralCommissioning.
+    if (Number(_endpointId) === 0 && typeof node?.getRootEndpoint === 'function') {
+      try {
+        const root = node.getRootEndpoint()
+        if (root !== undefined) return root
+      } catch (error) { /* The legacy endpoint structure may still be initializing. */ }
+    }
     return this._getAllEndpoints(node).find((ep) => Number(ep.number) === Number(_endpointId))
   }
 
@@ -564,12 +573,21 @@ class classMatter extends EventEmitter {
     if (label.length > 64) throw new Error('Matter device name is too long')
     const node = this.pairedNodes.get(_nodeIdString)
     if (node === undefined) throw new Error(`Matter node ${_nodeIdString} unknown or not yet connected`)
+    // commission() attaches the PairedNode before its first wildcard read/subscription
+    // has necessarily built the legacy endpoint structure. A user-supplied name is
+    // applied immediately after commissioning, so wait briefly for BasicInformation
+    // instead of reporting a misleading permanent-cluster warning.
+    const deadline = Date.now() + 10000
     let clusterClient
-    try {
-      if (typeof node.getRootClusterClient === 'function') clusterClient = node.getRootClusterClient(this._api.BasicInformation)
-    } catch (error) { /* empty */ }
-    if (clusterClient === undefined) clusterClient = this._findClusterClient(node, 0, 40) // BasicInformation on the root endpoint
-    if (clusterClient === undefined) throw new Error(`BasicInformation cluster not found on node ${_nodeIdString}`)
+    do {
+      try {
+        if (typeof node.getRootClusterClient === 'function') clusterClient = node.getRootClusterClient(this._api.BasicInformation)
+      } catch (error) { /* Endpoint structure is still initializing. */ }
+      if (clusterClient === undefined) clusterClient = this._findClusterClient(node, 0, 40) // BasicInformation on the root endpoint
+      if (clusterClient !== undefined) break
+      await pleaseWait(100)
+    } while (Date.now() < deadline)
+    if (clusterClient === undefined) throw new Error(`BasicInformation cluster was not available on node ${_nodeIdString} after initialization`)
     const attribute = clusterClient.attributes.nodeLabel
     if (attribute === undefined) throw new Error(`nodeLabel attribute not found on node ${_nodeIdString}`)
     await attribute.set(label)

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "6.0.7",
+  "version": "6.0.9",
   "description": "Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, KNX AI for diagnosticsand KNX routing between interfaces. Easy to use and highly configurable.",
   "files": [
     "nodes/",
@@ -145,4 +145,4 @@
     "vite": "^7.1.3",
     "vue": "^3.5.21"
   }
-}
+}