node-red-contrib-knx-ultimate 5.2.4 → 6.0.0

package/nodes/locales/de/knxUltimateMatterBridge.html

@@ -1,11 +1,11 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Matter Bridge device (BETA)
+# Expose KNX to Matter (BETA)
 
 > Dieser Node ist in **BETA**: Er funktioniert, aber Details können sich zwischen Releases noch ändern.
 
 ## Übersicht
 
-Jeder Matter Bridge device Node stellt **ein KNX-Gerät als Matter-Gerät** bereit: Die gekoppelten Controller (Alexa, Google Home, Apple Home...) sehen es mit dem von dir vergebenen Namen — bereit für App- und Sprachsteuerung. Verweise ihn auf einen **Matter Bridge**-Konfigurations-Node (die eigentliche Bridge, einmal gekoppelt - der Kopplungs-QR-Code lebt dort) und füge beliebig viele Device-Nodes hinzu, überall in deinen Flows.
+Jeder Expose KNX to Matter Node stellt **ein KNX-Gerät als Matter-Gerät** bereit: Die gekoppelten Controller (Alexa, Google Home, Apple Home...) sehen es mit dem von dir vergebenen Namen — bereit für App- und Sprachsteuerung. Verweise ihn auf einen **Matter Bridge**-Konfigurations-Node (die eigentliche Bridge, einmal gekoppelt - der Kopplungs-QR-Code lebt dort) und füge beliebig viele Device-Nodes hinzu, überall in deinen Flows.
 
 Das ist die Gegenrichtung zum *Matter Device*-Node: Dort steuert KNX ein Matter-Gerät, hier steuern Matter-Controller KNX.
 
@@ -39,6 +39,10 @@ Das ist die Gegenrichtung zum *Matter Device*-Node: Dort steuert KNX ein Matter-
 - **Befehls-GA**: wird auf den KNX-Bus geschrieben, wenn der Assistent einen Befehl sendet.
 - **Status-GA**: wird vom Bus gelesen, um die Matter-Attribute (und die Apps) aktuell zu halten.
 
+## Erweiterte Kompatibilität
+
+Diese Optionen werden nur angezeigt, wenn sie zum gewählten Typ passen. Dimmbare Geräte können den Helligkeitsbefehl ignorieren, den manche Controller direkt nach `Ein` senden. Rollläden/Jalousien können die Matter-Position nach einem Befehl optimistisch aktualisieren und sie korrigieren, sobald die KNX-Status-GA die echte Position meldet.
+
 ## Node-PINs
 
 Wenn du die Input/Output-PINs des Nodes aktivierst:

package/nodes/locales/de/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Matter Bridge (BETA)",
+    "title": "Expose KNX to Matter (BETA)",
     "bridge_name": "Name der Matter-Bridge",
     "port": "Port",
     "devices_help": "Füge die KNX-Geräte hinzu, die über Matter bereitgestellt werden sollen. Der \"Name\" ist der, den Alexa/Google/Apple anzeigen und für Sprachbefehle verwenden. Befehls-GA = wird geschrieben, wenn der Assistent einen Befehl sendet; Status-GA = wird vom Bus gelesen, um die App aktuell zu halten.",
@@ -10,12 +10,25 @@
     "node_pins": "Node Input/Output PINs",
     "node_pins_hide": "Ausblenden",
     "node_pins_show": "Input/Output-PINs anzeigen",
+    "type_change_warning": "Wenn der Gerätetyp nach der Kopplung der Bridge geändert wird, ändert sich die Matter-Endpunktstruktur. Alexa/Google/Apple können den alten Endpunkt als nicht erreichbar behalten; eventuell muss die Matter-Bridge zurückgesetzt/neu gekoppelt oder ein neues bereitgestelltes Gerät erstellt werden.",
     "fields": {
       "type": "Gerätetyp",
       "name": "Name (von Alexa & Co. angezeigt)",
       "name_placeholder": "z.B. Küchenlicht",
       "invert": "Position % invertieren"
     },
+    "advanced": {
+      "title": "Erweiterte Kompatibilität",
+      "help": " Verwende diese Optionen nur, wenn ein Matter-Controller oder ein KNX-Aktor eine besondere Behandlung benötigt.",
+      "turn_on_behavior": "Einschaltverhalten",
+      "turn_on_ignore_level": "Helligkeit direkt nach Ein ignorieren",
+      "turn_on_forward_all": "Jeden Helligkeitsbefehl weiterleiten",
+      "ignore_level_ms": "Helligkeit nach Ein ignorieren (ms)",
+      "cover_update_mode": "Jalousie-/Rollladenstatus",
+      "cover_optimistic": "Matter-Position optimistisch aktualisieren",
+      "cover_wait_status": "Nur auf KNX-Status warten",
+      "cover_status_timeout": "Timeout für Positionsstatus (ms)"
+    },
     "functions": {
       "fn_onoff_cmd": "Ein/Aus Befehls-GA",
       "fn_onoff_status": "Ein/Aus Status-GA",

package/nodes/locales/de/knxUltimateMatterControllerDevice.html

@@ -0,0 +1,27 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
+# Control Matter from KNX (BETA)
+
+> Dieser Knoten ist **BETA**: das Verhalten kann sich ändern, während die Matter-Implementierung weiter verfeinert wird.
+
+Dieser Knoten steuert einen bereits gekoppelten Matter-Endpunkt über KNX. Wähle das Matter-Gerät aus; der Editor erkennt die Fähigkeiten des Endpunkts und zeigt nur die passenden KNX-Zuordnungen.
+
+Er ersetzt die unveröffentlichten getrennten Matter-Controller-Nodes und behält die komplette Licht-UI bei, wenn der gewählte Endpunkt ein Licht ist.
+
+## Konfiguration
+
+|Feld|Beschreibung|
+|--|--|
+| KNX GW | KNX-Gateway zum Schreiben und Beantworten der konfigurierten Gruppenadressen. Kann leer bleiben, wenn nur der Node-RED-Ausgang benötigt wird. |
+| Matter controller | Matter-Controller-Konfigurationsknoten, in dem das Gerät gekoppelt wurde. |
+| Matter device | Matter-Endpunkt aus den gekoppelten Geräten. Die UI wird aus den echten Fähigkeiten neu aufgebaut. |
+| Switch / Steckdose / Licht On-Off | On/Off-Befehls- und Status-Gruppenadressen, normalerweise DPT `1.001`. |
+| Lichtsteuerung | Für Licht-Endpunkte wird die vollständige Licht-UI verwendet: relatives DIM (DPT `3.007`), Helligkeit %, RGB/HSV, Tunable White, Einschalt-Helligkeit/-Temperatur, Tag/Nacht-Licht, Min/Max-Dimmlevel und Dimmgeschwindigkeit. Nicht unterstützte Bereiche bleiben ausgeblendet. |
+| 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. |
+
+## Verhalten
+
+Der Knoten pflegt einen lokalen Cache aus Matter-Updates und KNX-Schreibtelegrammen, beantwortet KNX-Leseanfragen aus diesem Cache und kann Werte beim Start lesen/ausgeben. Er hört nur auf konfigurierte Gruppenadressen, daher wird fremder KNX-Verkehr ignoriert.
+</script>

package/nodes/locales/de/knxUltimateMatterControllerDevice.json

@@ -0,0 +1,97 @@
+{
+  "knxUltimateMatterControllerDevice": {
+    "title": "Control Matter from KNX",
+    "node-input-name": "Name",
+    "node-input-nameLightSwitch": "Switch (bit)",
+    "node-input-GALightSwitch": "GA",
+    "node-input-dptLightSwitch": "dpt",
+    "node-input-nameLightState": "State (bit)",
+    "node-input-GALightState": "GA",
+    "node-input-dptLightState": "dpt",
+    "node-input-hueLight": "Matter-Gerät",
+    "paletteLabel": "Control Matter from KNX",
+    "no_devices": "Keine Matter-Geräte gefunden. Matter-Controller prüfen und aktualisieren.",
+    "tabs": {
+      "switch": "Schalten",
+      "dim": "Dimmen",
+      "tunable_white": "Einstellbares Weiß",
+      "rgb_hsv": "RGB/HSV",
+      "effects": "Effekte",
+      "behaviour": "Verhalten"
+    },
+    "control": "Steuerung",
+    "status": "Status",
+    "night_lighting": "Nachtbeleuchtung",
+    "no_night_lighting": "Keine Nachtbeleuchtung",
+    "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_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_stop_title": "Locate-Modus beenden",
+    "locate_error": "Hue-Gerät konnte nicht lokalisiert werden",
+    "day_night": "Tag/Nacht",
+    "invert_day_night": "Tag/Nacht-Wert invertieren",
+    "override_night_mode": "Tagmodus erzwingen",
+    "override_no": "Nein",
+    "override_set_day_fast_this": "In den TAG-Modus wechseln durch schnelles Aus/Ein (nur dieses Licht)",
+    "override_set_day_fast_all": "In den TAG-Modus wechseln durch schnelles Aus/Ein (alle Lichter)",
+    "node_pins": "Node Ein-/Ausgangs-PINs",
+    "node_pins_hide": "Ausblenden",
+    "node_pins_show": "Ein-/Ausgangs-PINs anzeigen",
+    "read_status_startup": "Status beim Start lesen",
+    "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",
+    "k_suffix": "K",
+    "temp_desc_2200": "(Beginn der Philips White Ambiance Reihe)",
+    "temp_desc_2700": "(Warmweiß, intim, gemütlich, persönlich, für Wohnzimmer)",
+    "temp_desc_3000": "(Softweiß, warm, beruhigend, für Bad und Küche)",
+    "temp_desc_3500_day": "(Neutralweiß, ausgewogen, freundlich, einladend, für Büros und Einzelhandel)",
+    "temp_desc_3500_night": "(für Nacht nicht empfohlen – Neutralweiß, für Büros und Einzelhandel)",
+    "temp_desc_4100_day": "(Kaltweiß, präzise, sauber, fokussiert, für Garagen und Supermärkte)",
+    "temp_desc_4100_night": "(für Nacht nicht empfohlen – Kaltweiß, präzise, sauber, fokussiert, für Garagen und Supermärkte)",
+    "temp_desc_5000_day": "(Hellweiß, lebhaft, klar, für Lager, Stadien und Gesundheitswesen)",
+    "temp_desc_5000_night": "(für Nacht nicht empfohlen – Hellweiß, lebhaft, klar, für Lager, Stadien und Gesundheitswesen)",
+    "temp_desc_6500_day": "(Tageslicht, wach, energiegeladen, für Indoor-Landwirtschaft)",
+    "temp_desc_6500_night": "(für Nacht nicht empfohlen – Tageslicht, wach, energiegeladen, für Indoor-Landwirtschaft)",
+    "switch_on_behaviour": "Verhalten beim Einschalten",
+    "none": "Kein",
+    "switch_off": "(Ausschalten)",
+    "select_color": "Farbe auswählen",
+    "select_temperature_brightness": "Temperatur und Helligkeit auswählen",
+    "select_brightness": "Helligkeit auswählen",
+    "effect_command": "Effekt-Befehl",
+    "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_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_knx_value_placeholder": "Abzugleichender Wert",
+    "effect_base_label": "Nicht-Hue-Basiseffekte",
+    "effect_native_label": "Hue-native Effekte",
+    "matter_controller": "Matter-Controller",
+    "matter_device": "Matter-Gerät",
+    "matter_section": "Matter-Gerät"
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "Name",
+    "youtube_sample": "YouTube-Beispiel",
+    "knx_gw": "KNX-Gateway",
+    "hue_bridge": "Hue Bridge",
+    "philips_hue": "Philips HUE",
+    "read": "Lesen"
+  }
+}

package/nodes/locales/de/matter-config.json

@@ -8,6 +8,7 @@
       "pairing_title": "Neues Gerät koppeln",
       "pairing_help": "Gib den 11-stelligen manuellen Kopplungscode (z.B. 3497-011-2332) oder den QR-Code-Inhalt (MT:....) ein. Das Gerät muss über das IP-Netzwerk erreichbar sein (WLAN/Ethernet oder Thread über Border Router). Ist das Gerät bereits mit einem anderen Controller (Alexa, Google, Apple) gekoppelt, nutze dessen Funktion \"mit weiterem Hub teilen\", um einen neuen Code zu erhalten.",
       "pairing_code": "Kopplungscode",
+      "pairing_name": "Gerätename",
       "pair_button": "KOPPELN",
       "devices_title": "Gekoppelte Geräte",
       "col_name": "Name",
@@ -20,7 +21,10 @@
       "pairing_code_missing": "Bitte einen Kopplungscode eingeben.",
       "pairing_wait": "Kopplung läuft. Dies kann bis zu einer Minute dauern...",
       "pairing_failed": "Kopplung fehlgeschlagen",
-      "pairing_ok": "Gerät erfolgreich gekoppelt!"
+      "pairing_ok": "Gerät erfolgreich gekoppelt!",
+      "rename_button": "Umbenennen",
+      "rename_prompt": "Neuer Gerätename",
+      "rename_ok": "Gerät umbenannt."
     }
   }
 }

package/nodes/locales/de/matterbridge-config.json

@@ -10,6 +10,7 @@
       "pairing_title": "Kopplung (Alexa, Google Home, Apple Home...)",
       "not_running": "Die Matter-Bridge läuft noch nicht. Deployen, ein paar Sekunden warten und dann auf Aktualisieren klicken.",
       "commissioned": "Bridge mit diesen Controllern gekoppelt:",
+      "commissioned_hint": "Der QR-Code ist ausgeblendet, weil die Bridge bereits gekoppelt ist. Um Alexa als weiteren Matter-Controller hinzuzufügen, öffne den Kopplungsmodus über einen der oben aufgeführten Controller (z. B. Apple Home oder Google Home) und füge dann in Alexa ein Matter-Gerät hinzu. Verwende Kopplung zurücksetzen nur, wenn alle bestehenden Controller entfernt und die Kopplung neu begonnen werden soll.",
       "awaiting": "Warte auf Kopplung. Scanne den QR-Code oder gib den manuellen Code in deiner Matter-App ein:",
       "qr_link": "QR-Code im Browser öffnen",
       "deploy_first": "Bitte zuerst diesen Konfigurations-Node deployen und dann auf Aktualisieren klicken.",

package/nodes/locales/en/knxUltimateMatterBridge.html

@@ -1,11 +1,11 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Matter Bridge device (BETA)
+# Expose KNX to Matter (BETA)
 
 > This node is in **BETA**: it works, but details may still change between releases.
 
 ## Overview
 
-Each Matter Bridge device node exposes **one KNX device as a Matter device**: the paired controllers (Alexa, Google Home, Apple Home...) see it, with the name you typed, ready for app and voice control. Point it to a **Matter Bridge** configuration node (the actual bridge, paired once - the pairing QR code lives there) and add as many device nodes as you want, anywhere in your flows.
+Each Expose KNX to Matter node exposes **one KNX device as a Matter device**: the paired controllers (Alexa, Google Home, Apple Home...) see it, with the name you typed, ready for app and voice control. Point it to a **Matter Bridge** configuration node (the actual bridge, paired once - the pairing QR code lives there) and add as many device nodes as you want, anywhere in your flows.
 
 This is the opposite direction of the *Matter Device* node: there KNX controls a Matter device, here the Matter controllers control KNX.
 
@@ -39,6 +39,10 @@ This is the opposite direction of the *Matter Device* node: there KNX controls a
 - **Command GA**: written to the KNX bus when the assistant sends a command.
 - **Status GA**: read from the bus to keep the Matter attributes (and the apps) updated.
 
+## Advanced compatibility
+
+These options are hidden unless they apply to the selected type. Dimmable devices can ignore the brightness command that some controllers send immediately after `On`. Covers can optimistically update the Matter position after a command, then correct it when the KNX status GA reports the real position.
+
 ## Node PINs
 
 If you enable the node input/output PINs:

package/nodes/locales/en/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Matter Bridge (BETA)",
+    "title": "Expose KNX to Matter (BETA)",
     "bridge_name": "Matter bridge name",
     "port": "Port",
     "devices_help": "Add the KNX devices to expose on Matter. The \"Name\" is what Alexa/Google/Apple will show and use for voice commands. Command GA = written when the assistant sends a command; Status GA = read from the bus to keep the app updated.",
@@ -10,12 +10,25 @@
     "node_pins": "Node Input/Output PINs",
     "node_pins_hide": "Hide",
     "node_pins_show": "Show node input/output PINs",
+    "type_change_warning": "Changing the device type after the bridge has been paired changes the Matter endpoint structure. Alexa/Google/Apple may keep the old endpoint as unreachable; you may need to reset/re-pair the Matter Bridge or create a new exposed device instead.",
     "fields": {
       "type": "Device type",
       "name": "Name (shown by Alexa & Co.)",
       "name_placeholder": "e.g. Kitchen light",
       "invert": "Invert position %"
     },
+    "advanced": {
+      "title": "Advanced compatibility",
+      "help": " Use these options only when a Matter controller or a KNX actuator needs special handling.",
+      "turn_on_behavior": "Turn-on behavior",
+      "turn_on_ignore_level": "Ignore brightness sent immediately after On",
+      "turn_on_forward_all": "Forward every brightness command",
+      "ignore_level_ms": "Ignore brightness after On (ms)",
+      "cover_update_mode": "Cover state update",
+      "cover_optimistic": "Optimistically update Matter position",
+      "cover_wait_status": "Wait for KNX status only",
+      "cover_status_timeout": "Cover status timeout (ms)"
+    },
     "functions": {
       "fn_onoff_cmd": "On/Off command GA",
       "fn_onoff_status": "On/Off status GA",

package/nodes/locales/en/knxUltimateMatterControllerDevice.html

@@ -0,0 +1,27 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
+# Control Matter from KNX (BETA)
+
+> This node is in **BETA**: behaviour can change while the Matter implementation is refined.
+
+This node controls a commissioned Matter endpoint from KNX. Select the Matter device and the editor detects its capabilities, then shows only the KNX mappings that make sense for that endpoint.
+
+It replaces the unpublished per-device Matter controller nodes and keeps the full light UI when the selected endpoint is a light.
+
+## Configuration
+
+|Field|Description|
+|--|--|
+| KNX GW | KNX gateway used to write and answer the configured group addresses. It can be left empty when only Node-RED output is needed. |
+| Matter controller | Matter controller configuration node where the device has been commissioned. |
+| Matter device | Matter endpoint selected from commissioned devices. The UI is rebuilt from its real capabilities. |
+| Switch / Plug / Light On-Off | On/Off command and status group addresses, usually DPT `1.001`. |
+| Light controls | For light endpoints, the same light UI is used: relative DIM (DPT `3.007`), brightness %, RGB/HSV, tunable white, switch-on brightness/temperature, day/night lighting, min/max dim level and dim speed. Unsupported sections are hidden. |
+| 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. |
+
+## Behaviour
+
+The node keeps a local cache from Matter updates and KNX writes, answers KNX read requests from that cache, and can emit/read values at startup. Only the configured group addresses are listened to, so unrelated KNX traffic is ignored.
+</script>

package/nodes/locales/en/knxUltimateMatterControllerDevice.json

@@ -0,0 +1,97 @@
+{
+  "knxUltimateMatterControllerDevice": {
+    "title": "Control Matter from KNX",
+    "node-input-name": "Name",
+    "node-input-nameLightSwitch": "Switch (bit)",
+    "node-input-GALightSwitch": "GA",
+    "node-input-dptLightSwitch": "dpt",
+    "node-input-nameLightState": "State (bit)",
+    "node-input-GALightState": "GA",
+    "node-input-dptLightState": "dpt",
+    "node-input-hueLight": "Matter device",
+    "paletteLabel": "Control Matter from KNX",
+    "no_devices": "No Matter devices found. Check the Matter controller and click refresh.",
+    "tabs": {
+      "switch": "Switch",
+      "dim": "Dim",
+      "tunable_white": "Tunable white",
+      "rgb_hsv": "RGB/HSV",
+      "effects": "Effects",
+      "behaviour": "Behaviour"
+    },
+    "control": "Control",
+    "status": "Status",
+    "night_lighting": "Night Lighting",
+    "no_night_lighting": "No night lighting",
+    "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_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_stop_title": "Stop locate mode",
+    "locate_error": "Unable to locate Hue device",
+    "day_night": "Day/Night",
+    "invert_day_night": "Invert day/night value",
+    "override_night_mode": "Force day mode",
+    "override_no": "No",
+    "override_set_day_fast_this": "Switch to DAY mode by rapid switching the light off then on (this light only)",
+    "override_set_day_fast_all": "Switch to DAY mode by rapid switching the light off then on (apply to ALL light nodes)",
+    "node_pins": "Node Input/Output PINs",
+    "node_pins_hide": "Hide",
+    "node_pins_show": "Show node input/output PINs",
+    "read_status_startup": "Read status at startup",
+    "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",
+    "k_suffix": "K",
+    "temp_desc_2200": "(start of Philips White Ambiance lights range)",
+    "temp_desc_2700": "(warm white, intimate, cozy, personal, for living rooms)",
+    "temp_desc_3000": "(soft white, warm, calming, for bathrooms and kitchens)",
+    "temp_desc_3500_day": "(neutral white, balanced, friendly, inviting, for office spaces and retail)",
+    "temp_desc_3500_night": "(not recommended for night time - neutral white, for office spaces and retail)",
+    "temp_desc_4100_day": "(cool white, precise, clean, focused, for garages and grocery stores)",
+    "temp_desc_4100_night": "(not recommended for night time - cool white, precise, clean, focused, for garages and grocery stores)",
+    "temp_desc_5000_day": "(bright white, vibrant, crisp, for warehouses, sports stadiums and healthcare)",
+    "temp_desc_5000_night": "(not recommended for night time - bright white, vibrant, crisp, for warehouses, sports stadiums and healthcare)",
+    "temp_desc_6500_day": "(daylight, alert, energetic, for indoor agriculture)",
+    "temp_desc_6500_night": "(not recommended for night time - daylight, alert, energetic, for indoor agriculture)",
+    "switch_on_behaviour": "Switch on behaviour",
+    "none": "None",
+    "switch_off": "(Switch Off)",
+    "select_color": "Select color",
+    "select_temperature_brightness": "Select temperature and brightness",
+    "select_brightness": "Select brightness",
+    "effect_command": "Effect command",
+    "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_knx_value_placeholder": "Value to match",
+    "effect_base_label": "Non-Hue basic effects",
+    "effect_native_label": "Hue native effects",
+    "matter_controller": "Matter controller",
+    "matter_device": "Matter device",
+    "matter_section": "Matter device"
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "Name",
+    "youtube_sample": "Youtube sample",
+    "knx_gw": "KNX GW",
+    "hue_bridge": "Hue Bridge",
+    "philips_hue": "Philips HUE",
+    "read": "Read"
+  }
+}

package/nodes/locales/en/matter-config.json

@@ -8,6 +8,7 @@
       "pairing_title": "Pair a new device",
       "pairing_help": "Enter the 11-digit manual pairing code (e.g. 3497-011-2332) or the QR code content (MT:....). The device must be reachable on the IP network (WiFi/Ethernet or Thread via border router). If the device is already paired with another controller (Alexa, Google, Apple), use its \"share/pair with another hub\" function to obtain a new pairing code.",
       "pairing_code": "Pairing code",
+      "pairing_name": "Device name",
       "pair_button": "PAIR",
       "devices_title": "Commissioned devices",
       "col_name": "Name",
@@ -20,7 +21,11 @@
       "pairing_code_missing": "Please enter a pairing code.",
       "pairing_wait": "Pairing in progress. It can take up to a minute...",
       "pairing_failed": "Pairing failed",
-      "pairing_ok": "Device paired successfully!"
+      "pairing_ok": "Device paired successfully!",
+      "pairing_hint": "Prefer the QR code (MT:…): it carries the full device discriminator. The manual code stores only a short discriminator and can't reliably tell identical devices apart (e.g. several Shelly of the same model), which may pair the wrong one or report it as already commissioned. Pair one device at a time; if it's already paired elsewhere, factory-reset it first.",
+      "rename_button": "Rename",
+      "rename_prompt": "New device name",
+      "rename_ok": "Device renamed."
     }
   }
 }

package/nodes/locales/en/matterbridge-config.json

@@ -10,6 +10,7 @@
       "pairing_title": "Pairing (Alexa, Google Home, Apple Home...)",
       "not_running": "The Matter bridge is not running yet. Deploy, wait a few seconds, then click refresh.",
       "commissioned": "Bridge paired with these controllers:",
+      "commissioned_hint": "The QR code is hidden because the bridge is already paired. To add Alexa as another Matter controller, open pairing mode from one of the controllers listed above (for example Apple Home or Google Home), then add a Matter device in Alexa. Use Reset pairing only if you want to remove all existing controllers and start from scratch.",
       "awaiting": "Awaiting pairing. Scan the QR code or enter the manual code in your Matter app:",
       "qr_link": "Open the QR code in the browser",
       "deploy_first": "Deploy this configuration node first, then click refresh.",

package/nodes/locales/es/knxUltimateMatterBridge.html

@@ -1,11 +1,11 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Matter Bridge device (BETA)
+# Expose KNX to Matter (BETA)
 
 > Este nodo está en **BETA**: funciona, pero algunos detalles pueden cambiar entre versiones.
 
 ## Descripción general
 
-Cada nodo Matter Bridge device expone **un dispositivo KNX como dispositivo Matter**: los controladores emparejados (Alexa, Google Home, Apple Home...) lo ven, con el nombre que hayas elegido, listo para el control por app y por voz. Apúntalo a un nodo de configuración **Bridge Matter** (el bridge en sí, emparejado una sola vez - el QR de emparejamiento vive allí) y añade tantos nodos de dispositivo como quieras, en cualquier flow.
+Cada nodo Expose KNX to Matter expone **un dispositivo KNX como dispositivo Matter**: los controladores emparejados (Alexa, Google Home, Apple Home...) lo ven, con el nombre que hayas elegido, listo para el control por app y por voz. Apúntalo a un nodo de configuración **Bridge Matter** (el bridge en sí, emparejado una sola vez - el QR de emparejamiento vive allí) y añade tantos nodos de dispositivo como quieras, en cualquier flow.
 
 Es la dirección opuesta al nodo *Matter Device*: allí KNX controla un dispositivo Matter, aquí los controladores Matter controlan KNX.
 
@@ -39,6 +39,10 @@ Es la dirección opuesta al nodo *Matter Device*: allí KNX controla un disposit
 - **GA de comando**: se escribe en el bus KNX cuando el asistente envía un comando.
 - **GA de estado**: se lee del bus para mantener actualizados los atributos Matter (y las apps).
 
+## Compatibilidad avanzada
+
+Estas opciones solo aparecen cuando tienen sentido para el tipo seleccionado. Los dispositivos regulables pueden ignorar el comando de brillo que algunos controladores envían justo después de `On`. Las persianas pueden actualizar de forma optimista la posición Matter tras un comando y corregirla cuando la GA de estado KNX informa la posición real.
+
 ## PINes del nodo
 
 Si habilitas los PINes de entrada/salida del nodo:

package/nodes/locales/es/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Matter Bridge (BETA)",
+    "title": "Expose KNX to Matter (BETA)",
     "bridge_name": "Nombre del bridge Matter",
     "port": "Puerto",
     "devices_help": "Añade los dispositivos KNX a exponer en Matter. El \"Nombre\" es el que Alexa/Google/Apple muestran y usan para los comandos de voz. GA de comando = se escribe cuando el asistente envía un comando; GA de estado = se lee del bus para mantener la app actualizada.",
@@ -10,12 +10,25 @@
     "node_pins": "PINes de entrada/salida del nodo",
     "node_pins_hide": "Ocultar",
     "node_pins_show": "Mostrar PINes de entrada/salida",
+    "type_change_warning": "Cambiar el tipo de dispositivo después de emparejar el bridge cambia la estructura del endpoint Matter. Alexa/Google/Apple pueden conservar el endpoint antiguo como no alcanzable; puede ser necesario restablecer/reemparejar el Matter Bridge o crear un nuevo dispositivo expuesto.",
     "fields": {
       "type": "Tipo de dispositivo",
       "name": "Nombre (mostrado por Alexa y cía.)",
       "name_placeholder": "p.ej. Luz cocina",
       "invert": "Invertir posición %"
     },
+    "advanced": {
+      "title": "Compatibilidad avanzada",
+      "help": " Usa estas opciones solo cuando un controlador Matter o un actuador KNX necesite un tratamiento especial.",
+      "turn_on_behavior": "Comportamiento al encender",
+      "turn_on_ignore_level": "Ignorar brillo enviado justo después de On",
+      "turn_on_forward_all": "Reenviar cada comando de brillo",
+      "ignore_level_ms": "Ignorar brillo tras On (ms)",
+      "cover_update_mode": "Actualización de estado de persiana",
+      "cover_optimistic": "Actualizar la posición Matter de forma optimista",
+      "cover_wait_status": "Esperar solo el estado KNX",
+      "cover_status_timeout": "Timeout estado persiana (ms)"
+    },
     "functions": {
       "fn_onoff_cmd": "GA comando On/Off",
       "fn_onoff_status": "GA estado On/Off",

package/nodes/locales/es/knxUltimateMatterControllerDevice.html

@@ -0,0 +1,27 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
+# Control Matter from KNX (BETA)
+
+> Este nodo está en **BETA**: el comportamiento puede cambiar mientras se mejora la implementación Matter.
+
+Este nodo controla desde KNX un endpoint Matter ya emparejado. Selecciona el dispositivo Matter y el editor detecta sus capacidades, mostrando solo las asignaciones KNX coherentes con ese endpoint.
+
+Sustituye a los nodos Matter separados no publicados y conserva toda la UI de luz cuando el endpoint seleccionado es una luz.
+
+## Configuración
+
+|Campo|Descripción|
+|--|--|
+| KNX GW | Gateway KNX usado para escribir y responder las direcciones de grupo configuradas. Puede quedar vacío si solo se necesita la salida Node-RED. |
+| Matter controller | Nodo de configuración Matter Controller donde el dispositivo fue emparejado. |
+| Dispositivo Matter | Endpoint Matter seleccionado entre los dispositivos emparejados. La UI se reconstruye a partir de sus capacidades reales. |
+| Switch / Enchufe / Luz On-Off | Direcciones de grupo de comando y estado On/Off, normalmente DPT `1.001`. |
+| Controles de luz | Para endpoints de luz se usa la UI de luz completa: DIM relativo (DPT `3.007`), brillo %, RGB/HSV, blanco ajustable, brillo/temperatura al encender, modo día/noche, nivel min/max y velocidad de regulación. Las secciones no soportadas quedan ocultas. |
+| 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. |
+
+## Comportamiento
+
+El nodo mantiene una caché local con actualizaciones Matter y escrituras KNX, responde lecturas KNX desde esa caché y puede emitir/leer valores al inicio. Solo escucha las direcciones de grupo configuradas, por lo que ignora el tráfico KNX no relacionado.
+</script>

package/nodes/locales/es/knxUltimateMatterControllerDevice.json

@@ -0,0 +1,97 @@
+{
+  "knxUltimateMatterControllerDevice": {
+    "title": "Control Matter from KNX",
+    "node-input-name": "Nombre",
+    "node-input-nameLightSwitch": "Interruptor (bit)",
+    "node-input-GALightSwitch": "Georgia",
+    "node-input-dptLightSwitch": "DPT",
+    "node-input-nameLightState": "Estado (bit)",
+    "node-input-GALightState": "Georgia",
+    "node-input-dptLightState": "DPT",
+    "node-input-hueLight": "Dispositivo Matter",
+    "paletteLabel": "Control Matter from KNX",
+    "no_devices": "No se encontraron dispositivos Matter. Comprueba el controlador Matter y actualiza.",
+    "tabs": {
+      "switch": "Cambiar",
+      "dim": "Oscuro",
+      "tunable_white": "Blanco sintonizable",
+      "rgb_hsv": "RGB/HSV",
+      "effects": "Efectos",
+      "behaviour": "Comportamiento"
+    },
+    "control": "Control",
+    "status": "Estado",
+    "night_lighting": "Iluminación nocturna",
+    "no_night_lighting": "Sin iluminación nocturna",
+    "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_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_stop_title": "Detener el modo de localización",
+    "locate_error": "No se pudo localizar el dispositivo Hue",
+    "day_night": "Día/noche",
+    "invert_day_night": "Invertir el valor de día/noche",
+    "override_night_mode": "Forzar el modo diurno",
+    "override_no": "No",
+    "override_set_day_fast_this": "Cambie al modo de día apagando rápidamente la luz y luego (solo esta luz)",
+    "override_set_day_fast_all": "Cambie al modo de día apagando rápidamente la luz y luego (aplique a todos los nodos de luz)",
+    "node_pins": "Pasadores de entrada/salida del nodo",
+    "node_pins_hide": "Esconder",
+    "node_pins_show": "Mostrar pines de entrada/salida del nodo",
+    "read_status_startup": "Estado de lectura en el inicio",
+    "opt_no": "No",
+    "opt_yes_emit": "Sí, y emitir telegramas KNX.",
+    "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.",
+    "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)",
+    "temp_desc_2700": "(Cálido blanco, íntimo, acogedor, personal, para salas de estar)",
+    "temp_desc_3000": "(Blanco suave, cálido, calmante, para baños y cocinas)",
+    "temp_desc_3500_day": "(Blanco neutral, equilibrado, amigable, acogedor, para espacios de oficina y venta minorista)",
+    "temp_desc_3500_night": "(No se recomienda para la noche: blanco neutral, para espacios de oficina y venta minorista)",
+    "temp_desc_4100_day": "(COOL WHITE, PRECISE, CLIME, COMENTADO, PARA GARAJES Y TIENTES DE GRATOS)",
+    "temp_desc_4100_night": "(No se recomienda para la noche: blanco frío, preciso, limpio, enfocado, para garajes y supermercados)",
+    "temp_desc_5000_day": "(blanco brillante, vibrante, crujiente, para almacenes, estadios deportivos y atención médica)",
+    "temp_desc_5000_night": "(No se recomienda para la noche: blanco brillante, vibrante, nítido, para almacenes, estadios deportivos y atención médica)",
+    "temp_desc_6500_day": "(Día, alerta, enérgica, para la agricultura interior)",
+    "temp_desc_6500_night": "(No se recomienda para la noche: luz del día, alerta, enérgica, para la agricultura interior)",
+    "switch_on_behaviour": "Encender el comportamiento",
+    "none": "Ninguno",
+    "switch_off": "(Desconectar)",
+    "select_color": "Seleccionar color",
+    "select_temperature_brightness": "Seleccionar temperatura y brillo",
+    "select_brightness": "Seleccionar brillo",
+    "effect_command": "Comando de efecto",
+    "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_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",
+    "effect_base_label": "Efectos básicos no suyos",
+    "effect_native_label": "Efectos nativos de tono",
+    "matter_controller": "Controlador Matter",
+    "matter_device": "Dispositivo Matter",
+    "matter_section": "Dispositivo Matter"
+  },
+  "common": {
+    "ga": "Georgia",
+    "dpt": "DPT",
+    "name": "Nombre",
+    "youtube_sample": "Muestra de youtube",
+    "knx_gw": "KNX GW",
+    "hue_bridge": "Hue Bridge",
+    "philips_hue": "Tono Philips",
+    "read": "Leer"
+  }
+}