node-red-contrib-knx-ultimate 6.0.11 → 6.1.0

package/nodes/knxUltimateMatterControllerDevice.js

@@ -10,8 +10,34 @@ const hueColorConverter = require('./utils/colorManipulators/hueColorConverter')
 const { createLightEngine } = require('./utils/lightEngines')
 const { hueStateToCanonical, matterEventToHuePatch } = require('./utils/lightEngines/matterHueShim')
 const { setupMatterControllerProfile } = require('./utils/matterControllerProfiles')
+const { setupMatterControllerCommandGate } = require('./utils/matterControllerCommandGate')
+
+let matterCommandGateEndpointRegistered = false
 
 module.exports = function (RED) {
+  if (!matterCommandGateEndpointRegistered) {
+    RED.httpAdmin.post('/KNXUltimateMatterControllerEnable', RED.auth.needsPermission('matter-config.write'), (req, res) => {
+      try {
+        const nodeId = String(req.body?.nodeId || '').trim()
+        if (nodeId === '') {
+          res.status(400).json({ error: 'Missing Matter Controller node id' })
+          return
+        }
+        const targetNode = RED.nodes.getNode(nodeId)
+        if (!targetNode || typeof targetNode.clearMatterCommandBlock !== 'function') {
+          // New or not-yet-deployed editor nodes have no runtime counterpart.
+          res.json({ status: 'not-deployed', cleared: false })
+          return
+        }
+        const cleared = targetNode.clearMatterCommandBlock('editor')
+        res.json({ status: 'ok', cleared })
+      } catch (error) {
+        res.status(500).json({ error: error.message || 'Unable to enable Matter commands' })
+      }
+    })
+    matterCommandGateEndpointRegistered = true
+  }
+
   function knxUltimateMatterControllerDevice (config) {
     RED.nodes.createNode(this, config)
     const node = this
@@ -20,6 +46,7 @@ module.exports = function (RED) {
     node.matterNodeId = config.matterNodeId !== undefined ? String(config.matterNodeId) : ''
     node.matterEndpointId = config.matterEndpointId !== undefined ? Number(config.matterEndpointId) : 1
     node.matterDeviceName = config.matterDeviceName !== undefined ? String(config.matterDeviceName) : ''
+    setupMatterControllerCommandGate(node)
 
     let matterCapabilities = {}
     try { matterCapabilities = JSON.parse(config.matterDeviceCapabilities || '{}') } catch (error) { /* empty */ }
@@ -45,6 +72,7 @@ module.exports = function (RED) {
       hueManager: {
         writeHueQueueAdd: (_lightID, _state, _operation) => {
           try {
+            if (node.matterCommandBlocked === true) return
             if (!node.lightEngine) return
             const patch = hueStateToCanonical(_state)
             if (!patch) return
@@ -217,6 +245,7 @@ module.exports = function (RED) {
       fill, shape, text, payload
     }) => {
       try {
+        if (node.matterCommandBlocked === true) return
         if (node.currentHUEDevice?.on?.on === true) { fill = 'blue'; shape = 'dot' } else { fill = 'blue'; shape = 'ring' };
         if (payload === undefined) payload = ''
         const dDate = new Date()
@@ -228,6 +257,7 @@ module.exports = function (RED) {
     // Compatibility callback used to update the Matter node status.
     node.setNodeStatusHue = ({ fill, shape, text, payload }) => {
       try {
+        if (node.matterCommandBlocked === true) return
         if (node.currentHUEDevice?.on?.on === true) { fill = 'blue'; shape = 'dot' } else { fill = 'blue'; shape = 'ring' };
         if (payload === undefined) payload = ''
         const dDate = new Date()
@@ -238,6 +268,7 @@ module.exports = function (RED) {
     }
 
     node.writeHueState = function writeHueState (_state) {
+      if (node.matterCommandBlocked === true) return
       const defaultOperation = node.isGrouped_light === false ? 'setLight' : 'setGroupedLight'
       const isGroupedLightOff = node.isGrouped_light === true && node.currentHUEDevice?.on?.on === false
       const stateKeys = _state && typeof _state === 'object' ? Object.keys(_state) : []
@@ -330,6 +361,7 @@ module.exports = function (RED) {
     // Compatibility callback invoked by the Matter controller adapter.
     node.handleSend = (msg) => {
       if (!msg || !msg.knx || !isConfiguredKNXGA(msg.knx.destination)) return
+      if (node.matterCommandBlocked === true) return
       if (node.currentHUEDevice === undefined && node.serverHue.linkStatus === 'connected') {
         node.setNodeStatusHue({
           fill: 'yellow',
@@ -1671,6 +1703,11 @@ module.exports = function (RED) {
     }
 
     node.on('input', (msg, send, done) => {
+      if (node.matterCommandBlocked === true) {
+        const error = new Error(node.matterCommandBlockReason || 'Matter device unavailable')
+        if (done) done(error); else node.error(error, msg)
+        return
+      }
       try {
         const state = RED.util.cloneMessage(msg)
         node.writeHueState(state)

package/nodes/locales/de/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Expose KNX to Matter (BETA)
-
 > Dieser Node ist in **BETA**: Er funktioniert, aber Details können sich zwischen Releases noch ändern.
 
 ## Übersicht

package/nodes/locales/de/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <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.
@@ -21,9 +19,31 @@ 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. Die Auswahl bleibt beim erneuten Öffnen des Editors erhalten. |
+| Node Input/Output PINs | Zeigt Node-RED-Eingangs-/Ausgangspins. Nicht-Licht-Endpunkte akzeptieren das einfache `{function,value}`-Format und die erweiterten Matter-Felder; der Ausgang sendet Statusupdates. |
+
+## Flow-Eingang
+
+Öffne bei einem ausgewählten Nicht-Licht-Endpunkt den Tab **Flow-Eingang**. Der Tab wird aus der angekündigten Endpunktstruktur aufgebaut und zeigt kopierbare Beispiele, die Endpoint ID sowie alle lesbaren/schreibbaren Attribute und akzeptierten Befehle. Er bleibt auch verfügbar, wenn der Knoten ohne KNX-Gateway nur im Flow verwendet wird.
+
+Einfache Schreibvorgänge verwenden `msg.payload = {function:"position",value:35}`. Ohne `value` wird ein unterstützter Zustand gelesen, zum Beispiel `{function:"temperature"}`; die Ausgabe verwendet verständliche Einheiten und enthält Rohdetails in `msg.matter`. Funktionen wie `onoff`, `level`, `position`, `open`, `close`, `stop`, Sollwerte, Lüfter und Sensoren erscheinen nur bei Unterstützung. Türschlösser akzeptieren `{function:"lock",value:true|false}`.
+
+Die bisherigen erweiterten Eingaben bleiben gültig: `msg.clusterId` mit `msg.command`/`msg.args` oder `msg.attribute` und optional `msg.value`. Node ID und Endpoint ID sind bereits im Knoten ausgewählt.
+
+## Universeller Modus
+
+Wähle **Universeller Modus**, um alle Geräte zu überwachen. Der Node hat immer einen Eingang und einen Ausgang und verwendet keine Endpunkt-Zuordnungen. Ein KNX-Gateway ist optional und wird nur für die Alarm-/Text-GAs des Batteriemonitors benötigt.
+
+Der **Universelle Batteriemonitor** speichert den vollständigen Batteriestatus. Optionale KNX-GAs senden den Sammelalarm als DPT 1.005 und wechseln alle 2 Sekunden die Gerätenamen als DPT 16.001. `{payload:{action:"getAllBatteries"}}` liefert das Cache-Inventar.
+
+Ausgaben enthalten den Rohwert in `msg.payload` und Routingdaten in `msg.matter` (`source`, `nodeId`, `endpointId`, `clusterId`, Attribut-/Ereignisname). Eingaben verwenden `msg.nodeId`, `msg.endpointId`, `msg.clusterId` und entweder `msg.command` mit `msg.args` oder `msg.attribute`; `msg.value` schreibt, ohne `msg.value` wird gelesen. Die Felder können auch unter `msg.matter` stehen.
+
+Beispiele: `{nodeId:"100",endpointId:1,clusterId:6,command:"on",args:{}}` schaltet ein; `{nodeId:"100",endpointId:1,clusterId:47,attribute:"batPercentRemaining"}` liest die Batterie. Batteriewerte bleiben in Matter-Halbprozenteinheiten und können in einem Function-Node durch zwei geteilt werden.
 
 ## 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.
+
+Befehle laufen pro gekoppeltem Gerät in einer eigenen geordneten Warteschlange. Ein offline befindliches, zeitüberschreitendes oder entferntes Gerät kann daher andere Matter-Geräte mit derselben KNX-Gruppenadresse nicht verzögern. Verweist ein Node weiterhin auf ein entferntes Gerät, wird der Befehl sofort abgewiesen und **Device no longer commissioned** rot angezeigt; wähle ein gültiges Matter-Gerät oder entferne den verwaisten Controller-Node.
+
+Ein Fehler wegen eines nicht verfügbaren Geräts bleibt verriegelt: weitere KNX- und Flow-Befehle werden ignoriert und können den roten Status nicht überschreiben. Der Node wird automatisch wieder aktiv, sobald dieses Matter-Gerät `connected` meldet; auch das Öffnen des Node-Editors löst die Verriegelung für einen manuellen Neuversuch.
 </script>

package/nodes/locales/de/knxUltimateMatterControllerDevice.json

@@ -11,6 +11,28 @@
     "node-input-hueLight": "Matter-Gerät",
     "paletteLabel": "Control Matter from KNX",
     "no_devices": "Keine Matter-Geräte gefunden. Matter-Controller prüfen und aktualisieren.",
+    "input_help_label": "Flow-Eingang",
+    "input_help_pin_hint": "Aktiviere die Ein-/Ausgangs-PINs des Knotens, bevor du diese Nachrichten sendest.",
+    "input_help_endpoint": "Ausgewählter Endpunkt",
+    "input_help_endpoint_hint": "Der Knoten kennt Node ID und Endpoint ID bereits; einfache Nachrichten benötigen sie nicht.",
+    "input_help_simple_title": "Einfache Nachrichten",
+    "input_help_simple_hint": "Diese Funktionen verwenden verständliche Einheiten und werden in den Matter-Cluster, Befehl oder das Attribut des ausgewählten Endpunkts übersetzt.",
+    "input_help_advanced_title": "Erweiterte Matter-Details",
+    "input_help_advanced_hint": "Es werden nur angekündigte Attribute und Befehle aufgelistet. Schreibbeispiele verwenden 0 als Platzhalter; Befehlsargumente müssen eventuell an den Matter-Datentyp angepasst werden.",
+    "input_help_operation": "Operation",
+    "input_help_function": "Funktion",
+    "input_help_target": "Matter-Ziel",
+    "input_help_message": "Nachricht",
+    "input_help_read": "Lesen",
+    "input_help_write": "Schreiben",
+    "input_help_command": "Befehl",
+    "input_help_copy": "Kopieren",
+    "input_help_copied": "Nachricht kopiert",
+    "input_help_no_simple": "Dieser Endpunkt besitzt keine bekannte einfache Eingangsfunktion.",
+    "input_help_no_structure": "Die Matter-Struktur ist nicht verfügbar. Aktualisiere die Geräteliste, während der Endpunkt online ist.",
+    "input_functions": {
+      "onoff": "Ein / Aus", "level": "Stufe", "position": "Rollladenposition", "tiltposition": "Lamellenposition", "open": "Öffnen", "close": "Schließen", "stop": "Stopp", "setpoint": "Heizsollwert", "coolingsetpoint": "Kühlsollwert", "currenttemp": "Aktuelle Temperatur", "fanspeed": "Lüftergeschwindigkeit", "temperature": "Temperatur", "humidity": "Luftfeuchtigkeit", "illuminance": "Beleuchtungsstärke", "occupancy": "Belegung", "contact": "Kontakt", "battery": "Batterie", "activepower": "Wirkleistung", "importedenergy": "Bezogene Energie", "identify": "Identifizieren", "lock": "Verriegeln", "unlock": "Entriegeln"
+    },
     "tabs": {
       "switch": "Schalten",
       "dim": "Dimmen",
@@ -92,7 +114,23 @@
     "matter_controller": "Matter-Controller",
     "matter_device": "Matter-Gerät",
     "device_type": "Gerätetyp",
-    "matter_section": "Matter-Gerät"
+    "matter_section": "Matter-Gerät",
+    "controller_mode": "Modus",
+    "single_mode": "Einzelnes Gerät",
+    "universal_mode": "Universeller Modus (alle Matter-Geräte)",
+    "universal_mode_description": "Alle mit diesem Controller verbundenen Matter-Geräte überwachen und steuern. Der universelle Modus funktioniert ohne KNX-Zuordnungen.",
+    "universal_service": "Dienst",
+    "universal_service_battery_monitor": "Universeller Batteriemonitor",
+    "universal_service_all_events": "Alle Matter-Ereignisse",
+    "universal_battery_threshold": "Schwelle für niedrigen Batteriestand",
+    "universal_low_battery_ga": "GA Batteriealarm",
+    "universal_low_battery_text_ga": "GA Gerätename",
+    "universal_battery_only_low": "Nur niedrige Batteriestände ausgeben",
+    "universal_emit_initial": "Anfänglichen Batterie-Snapshot ausgeben",
+    "universal_include_raw": "Rohes Matter-Ereignis einschließen",
+    "universal_mode_status": "Universeller Matter-Modus",
+    "universal_mode_locate_disabled": "„Suchen“ ist im universellen Modus nicht verfügbar.",
+    "universal_controller_name": "Universeller Matter-Controller"
   },
   "common": {
     "ga": "GA",

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

@@ -11,7 +11,11 @@ Der Controller kommuniziert mit den Geräten über das **IP-Netzwerk** (WLAN, Et
 
 1. Zuerst diesen Konfigurations-Node **deployen** (der Controller muss laufen).
 2. Den Node erneut öffnen und den **Kopplungscode** eingeben: entweder den 11-stelligen manuellen Code (z.B. `3497-011-2332`) oder den QR-Code-Inhalt (`MT:....`).
-3. Auf **KOPPELN** klicken. Die Kommissionierung kann bis zu einer Minute dauern.
+3. Bei einem manuell eingegebenen Code auf **KOPPELN** klicken. Ein mit **Webcam** oder **Bild** gelesener QR-Code startet die Kopplung automatisch. Die Kommissionierung kann bis zu einer Minute dauern.
+
+Statt den QR-Payload einzutippen, klicke auf **Webcam**, um ihn live zu scannen, oder auf **Bild**, um ihn aus einem lokalen Foto zu lesen. Sowohl normale dunkle QR-Codes auf hellem Grund als auch invertierte weiße Codes auf dunklem Grund werden unterstützt. Die Dekodierung erfolgt vollständig im Browser; nach dem Lesen eines gültigen Matter-QR-Codes füllt der Editor das Kopplungscode-Feld und startet die Kopplung sofort. Gib den optionalen Gerätenamen vor dem Scannen ein. Ein manuell eingegebener Code startet weiterhin erst mit **KOPPELN**. Der Live-Zugriff auf die Webcam setzt voraus, dass der Editor über HTTPS oder von `localhost` geöffnet wurde; andernfalls erklärt der Editor die Einschränkung und das Laden eines Bildes bleibt verfügbar.
+
+Während der Kommissionierung überdeckt ein blockierender Wartebildschirm den Editor und verhindert weitere Klicks, bis der Vorgang erfolgreich abgeschlossen wird oder fehlschlägt.
 
 Wenn das Gerät fabrikneu ist und nur Bluetooth-Kommissionierung unterstützt, kopple es zuerst mit der Hersteller-App oder einem anderen Matter-Controller (Alexa, Google Home, Apple Home) und nutze dann dessen Funktion **"mit weiterem Hub teilen"**, um einen neuen Kopplungscode für KNX-Ultimate zu erzeugen. So tritt das Gerät mehreren Fabrics gleichzeitig bei.
 
@@ -26,4 +30,10 @@ Mit **Exportieren** wird eine vollständige Sicherung dieser Controller-Instanz
 ## Ein Gerät entfernen
 
 Nutze den Papierkorb-Button in der Liste der gekoppelten Geräte. Der Controller versucht, das Gerät sauber zu dekommissionieren; ist es nicht erreichbar, wird es trotzdem aus der Fabric entfernt (danach kann ein Werksreset des Geräts nötig sein).
+
+Die Liste enthält eine Zeile für jeden Node, der derzeit in der Matter-Fabric dieses Controllers gespeichert ist. Node-IDs sind innerhalb dieser Fabric eindeutig; Endpunkte eines einzelnen kommissionierten Bridges werden nicht als separate Geräte aufgeführt. Die Statusspalte zeigt an, ob ein Node verbunden, getrennt, in Wiederverbindung oder auf Geräteerkennung wartend ist.
+
+Der Controller hält die Befehlsreihenfolge für jedes gekoppelte Gerät getrennt. Ein langsames, offline befindliches oder entferntes Gerät kann Befehle für andere Geräte nicht blockieren. Controller-Gerätenodes, die weiterhin auf eine entfernte Node ID verweisen, weisen neue Befehle sofort ab und zeigen **Device no longer commissioned** an.
+
+Wird ein Gerät nicht verfügbar, bleiben seine Controller-Nodes gesperrt und ignorieren weitere Befehle, bis dieses Gerät erneut `connected` meldet. Die Wiederherstellung erfolgt automatisch; auch das Öffnen des Geräte-Node-Editors löst die Sperre für einen manuellen Neuversuch.
 </script>

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

@@ -9,6 +9,18 @@
       "pairing_code": "Kopplungscode",
       "pairing_name": "Gerätename",
       "pair_button": "KOPPELN",
+      "qr_acquire": "QR-Code lesen",
+      "qr_scan_camera": "Webcam",
+      "qr_scan_image": "Bild",
+      "qr_stop_camera": "Kamera stoppen",
+      "qr_camera_insecure": "Der Browser kann die Webcam nicht verwenden, weil der Node-RED-Editor nicht über HTTPS oder localhost geöffnet ist. Öffne ihn über HTTPS oder verwende Bild.",
+      "qr_camera_unsupported": "Dieser Browser kann nicht auf eine Webcam zugreifen. Verwende einen unterstützten Browser oder lade ein Bild.",
+      "qr_camera_permission_denied": "Die Webcam-Berechtigung wurde verweigert. Erlaube den Kamerazugriff im Browser oder lade ein Bild.",
+      "qr_camera_failed": "Die Webcam konnte nicht gestartet werden",
+      "qr_image_failed": "Im ausgewählten Bild wurde kein lesbarer QR-Code gefunden",
+      "qr_invalid_matter": "Der QR-Code ist kein Matter-Kopplungscode (MT:…).",
+      "qr_found": "Matter-QR-Code gelesen. Die Kopplung startet automatisch.",
+      "qr_decoder_unavailable": "Der QR-Decoder konnte nicht geladen werden.",
       "devices_title": "Gekoppelte Geräte",
       "col_name": "Name",
       "col_product": "Produkt",

package/nodes/locales/en/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Expose KNX to Matter (BETA)
-
 > This node is in **BETA**: it works, but details may still change between releases.
 
 ## Overview

package/nodes/locales/en/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <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.
@@ -21,9 +19,31 @@ 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. The selection is preserved when the editor is reopened. |
+| Node Input/Output PINs | Shows Node-RED input/output pins. Non-light endpoints accept the simple `{function,value}` contract below as well as the advanced Matter fields; output emits state updates. The selection is preserved when the editor is reopened. |
+
+## Flow input
+
+For a selected non-light endpoint, open the **Flow input** tab in the editor. The tab is built from the endpoint's advertised structure and provides copyable examples, the selected Endpoint ID, every readable/writable attribute and every accepted command. It remains available when the node is used only by a flow without a KNX gateway.
+
+Simple writes use `msg.payload = {function:"position",value:35}`. Omit `value` to read a supported state, for example `{function:"temperature"}`; the output uses human units and includes raw routing details in `msg.matter`. Supported functions include `onoff`, `level`, `position`, `tiltposition`, `open`, `close`, `stop`, `setpoint`, `coolingsetpoint`, `currenttemp`, `fanspeed`, sensor readings and `identify`, but only when advertised by that endpoint. Door Lock accepts `{function:"lock",value:true|false}`.
+
+Existing advanced inputs remain valid: use top-level `msg.clusterId` plus `msg.command`/`msg.args`, or `msg.attribute` with optional `msg.value`. Node ID and Endpoint ID are already selected by the node; `msg.endpointId` is only an optional override.
+
+## Universal Mode
+
+Select **Universal Mode** in the **Mode** selector to receive every attribute report, cluster event and device initialization from this Matter controller. It always has one input and one output and does not use endpoint mappings. A KNX gateway is optional and is used only by the Battery Monitor alarm/text GAs.
+
+The **Universal Battery Monitor** scans all endpoints for Power Source, emits an initial snapshot, and caches complete normalized battery state. The optional KNX GAs publish an aggregate alarm as DPT 1.005 and cycle low-battery device names every 2 seconds as DPT 16.001. Send `{payload:{action:"getAllBatteries"}}` to retrieve the cached inventory.
+
+Outputs carry the raw value in `msg.payload` and routing details in `msg.matter` (`source`, `nodeId`, `endpointId`, `clusterId`, attribute/event name). Inputs use `msg.nodeId`, `msg.endpointId`, `msg.clusterId` and either `msg.command` with `msg.args`, or `msg.attribute`; add `msg.value` to write, omit it to read. The selectors may also be nested under `msg.matter`.
+
+Examples: `{nodeId:"100",endpointId:1,clusterId:6,command:"on",args:{}}` turns On; `{nodeId:"100",endpointId:1,clusterId:47,attribute:"batPercentRemaining"}` reads battery. Battery reports remain in raw Matter half-percent units; divide by two in a Function node when a percentage is needed.
 
 ## 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.
+
+Commands are scheduled in a separate ordered lane for each commissioned device. An offline, timing-out or removed device therefore cannot delay other Matter devices that use the same KNX group address. A node that still references a removed device rejects the command immediately and shows **Device no longer commissioned** in red; select a valid Matter device or remove the stale Controller node.
+
+An unavailable-device error is latched: further KNX and flow commands are ignored and cannot overwrite the red status. The node resumes automatically as soon as that Matter device reports `connected`; opening the node editor also clears the latch to allow a manual retry.
 </script>

package/nodes/locales/en/knxUltimateMatterControllerDevice.json

@@ -11,6 +11,28 @@
     "node-input-hueLight": "Matter device",
     "paletteLabel": "Control Matter from KNX",
     "no_devices": "No Matter devices found. Check the Matter controller and click refresh.",
+    "input_help_label": "Flow input",
+    "input_help_pin_hint": "Enable the node input/output PINs before sending these messages.",
+    "input_help_endpoint": "Selected endpoint",
+    "input_help_endpoint_hint": "The node already knows the Node ID and Endpoint ID, so the simple messages do not need them.",
+    "input_help_simple_title": "Simple messages",
+    "input_help_simple_hint": "These functions use human units and are translated to the Matter cluster, command or attribute shown by the selected endpoint.",
+    "input_help_advanced_title": "Advanced Matter details",
+    "input_help_advanced_hint": "Only advertised attributes and commands are listed. Attribute write examples use 0 as a placeholder; command arguments may need to be adapted to the Matter data type.",
+    "input_help_operation": "Operation",
+    "input_help_function": "Function",
+    "input_help_target": "Matter target",
+    "input_help_message": "Message",
+    "input_help_read": "Read",
+    "input_help_write": "Write",
+    "input_help_command": "Command",
+    "input_help_copy": "Copy",
+    "input_help_copied": "Message copied",
+    "input_help_no_simple": "This endpoint has no known simple input functions.",
+    "input_help_no_structure": "The Matter structure is unavailable. Refresh the device list while the endpoint is online.",
+    "input_functions": {
+      "onoff": "On / Off", "level": "Level", "position": "Cover position", "tiltposition": "Cover tilt", "open": "Open", "close": "Close", "stop": "Stop", "setpoint": "Heating setpoint", "coolingsetpoint": "Cooling setpoint", "currenttemp": "Current temperature", "fanspeed": "Fan speed", "temperature": "Temperature", "humidity": "Humidity", "illuminance": "Illuminance", "occupancy": "Occupancy", "contact": "Contact", "battery": "Battery", "activepower": "Active power", "importedenergy": "Imported energy", "identify": "Identify", "lock": "Lock", "unlock": "Unlock"
+    },
     "tabs": {
       "switch": "Switch",
       "dim": "Dim",
@@ -92,7 +114,23 @@
     "matter_controller": "Matter controller",
     "matter_device": "Matter device",
     "device_type": "Device type",
-    "matter_section": "Matter device"
+    "matter_section": "Matter device",
+    "controller_mode": "Mode",
+    "single_mode": "Single device",
+    "universal_mode": "Universal Mode (all Matter devices)",
+    "universal_mode_description": "Listen to and control all Matter devices connected to this controller. Universal Mode works without KNX mappings.",
+    "universal_service": "Service",
+    "universal_service_battery_monitor": "Universal Battery Monitor",
+    "universal_service_all_events": "All Matter events",
+    "universal_battery_threshold": "Low battery threshold",
+    "universal_low_battery_ga": "Low battery alarm GA",
+    "universal_low_battery_text_ga": "Low battery device GA",
+    "universal_battery_only_low": "Emit only low batteries",
+    "universal_emit_initial": "Emit initial battery snapshot",
+    "universal_include_raw": "Include raw Matter event",
+    "universal_mode_status": "Universal Matter mode",
+    "universal_mode_locate_disabled": "Locate is unavailable in Universal Mode.",
+    "universal_controller_name": "Matter Universal Controller"
   },
   "common": {
     "ga": "GA",

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

@@ -11,7 +11,11 @@ The controller talks to the devices over the **IP network** (WiFi, Ethernet, or
 
 1. **Deploy** this configuration node first (the controller must be running).
 2. Open the node again and enter the **pairing code**: either the 11-digit manual code (e.g. `3497-011-2332`) or the QR code content (`MT:....`).
-3. Click **PAIR**. Commissioning can take up to a minute.
+3. For a manually entered code, click **PAIR**. A QR read with **Webcam** or **Image** starts pairing automatically. Commissioning can take up to a minute.
+
+Instead of typing the QR payload, click **Webcam** to scan it live or **Image** to read it from a local picture. Both standard dark-on-light and inverted white-on-dark QR codes are supported. Decoding takes place entirely in the browser; after a valid Matter QR is read, the editor fills the pairing-code field and immediately starts pairing. Enter the optional device name before scanning if desired. A manually typed code still starts only when you click **PAIR**. Live webcam access requires the editor to be opened over HTTPS or from `localhost`; when that is not possible, the editor explains the limitation and image loading remains available.
+
+While commissioning is in progress, a blocking wait panel covers the editor and prevents further clicks until the operation succeeds or fails.
 
 If the device is brand new and only supports Bluetooth commissioning, first pair it with its vendor app or another Matter controller (Alexa, Google Home, Apple Home), then use that controller's **"share / pair with another hub"** function to generate a new pairing code for KNX-Ultimate. This way the device joins multiple fabrics at once.
 
@@ -26,4 +30,10 @@ Use **Export** to download a complete backup of this controller instance. It inc
 ## Removing a device
 
 Use the trash button in the commissioned devices list. The controller tries to decommission the device properly; if it is unreachable, it is removed from the fabric anyway (a factory reset of the device may then be needed).
+
+The list contains one row for every node currently stored in this controller's Matter fabric. Node IDs are unique within that fabric; endpoints exposed by one commissioned bridge are not listed as separate devices. The state column reports whether each node is connected, disconnected, reconnecting or waiting for discovery.
+
+The controller keeps command order separately for each commissioned device. A slow, offline or removed device cannot block commands for other devices. Controller device nodes that still reference a removed Node ID reject new commands immediately and display **Device no longer commissioned**.
+
+When a device becomes unavailable, its Controller nodes stay blocked and ignore further commands until that device reports `connected` again. Recovery is automatic; opening the device-node editor also clears the block for a manual retry.
 </script>

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

@@ -9,6 +9,18 @@
       "pairing_code": "Pairing code",
       "pairing_name": "Device name",
       "pair_button": "PAIR",
+      "qr_acquire": "Read QR code",
+      "qr_scan_camera": "Webcam",
+      "qr_scan_image": "Image",
+      "qr_stop_camera": "Stop camera",
+      "qr_camera_insecure": "The browser cannot use the webcam because the Node-RED editor is not open over HTTPS or localhost. Reopen it over HTTPS, or use Image.",
+      "qr_camera_unsupported": "This browser cannot access a webcam. Use a supported browser or load an image.",
+      "qr_camera_permission_denied": "Webcam permission was denied. Allow camera access in the browser, or load an image.",
+      "qr_camera_failed": "Unable to start the webcam",
+      "qr_image_failed": "No readable QR code was found in the selected image",
+      "qr_invalid_matter": "The QR code is not a Matter pairing code (MT:…).",
+      "qr_found": "Matter QR code read. Pairing starts automatically.",
+      "qr_decoder_unavailable": "The QR decoder could not be loaded.",
       "devices_title": "Commissioned devices",
       "col_name": "Name",
       "col_product": "Product",

package/nodes/locales/es/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Expose KNX to Matter (BETA)
-
 > Este nodo está en **BETA**: funciona, pero algunos detalles pueden cambiar entre versiones.
 
 ## Descripción general

package/nodes/locales/es/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <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.
@@ -21,9 +19,31 @@ 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. La selección se conserva al volver a abrir el editor. |
+| Node Input/Output PINs | Muestra pines de entrada/salida Node-RED. Los endpoints que no son luces aceptan el formato simple `{function,value}` y los campos Matter avanzados; la salida emite estados. |
+
+## Entrada del flow
+
+Para un endpoint que no sea una luz, abre la pestaña **Entrada del flow**. La pestaña se construye con la estructura anunciada y muestra ejemplos copiables, el Endpoint ID, todos los atributos legibles/escribibles y los comandos aceptados. Sigue disponible cuando el nodo se usa solo desde el flow, sin gateway KNX.
+
+Una escritura simple usa `msg.payload = {function:"position",value:35}`. Omite `value` para leer un estado, por ejemplo `{function:"temperature"}`; la salida usa unidades comprensibles e incluye los detalles raw en `msg.matter`. Las funciones `onoff`, `level`, `position`, `open`, `close`, `stop`, consignas, ventilador y sensores solo aparecen si el endpoint las anuncia. Una cerradura acepta `{function:"lock",value:true|false}`.
+
+Las entradas avanzadas siguen siendo válidas: `msg.clusterId` con `msg.command`/`msg.args`, o `msg.attribute` y el `msg.value` opcional. El Node ID y el Endpoint ID ya están seleccionados en el nodo.
+
+## Modo universal
+
+Selecciona **Modo universal** para supervisar todos los dispositivos. Siempre tiene una entrada y una salida y no usa mapeos de endpoint. El gateway KNX es opcional y solo se utiliza para las GA de alarma/texto del monitor.
+
+El **Monitor universal de baterías** conserva el estado completo. Las GA KNX opcionales publican la alarma global como DPT 1.005 y alternan cada 2 segundos los dispositivos como DPT 16.001. `{payload:{action:"getAllBatteries"}}` devuelve el inventario.
+
+La salida contiene el valor raw en `msg.payload` y el enrutamiento en `msg.matter` (`source`, `nodeId`, `endpointId`, `clusterId`, nombre de atributo/evento). La entrada usa `msg.nodeId`, `msg.endpointId`, `msg.clusterId` y `msg.command` con `msg.args`, o `msg.attribute`; añade `msg.value` para escribir y omítelo para leer. Los campos también pueden estar bajo `msg.matter`.
+
+Ejemplos: `{nodeId:"100",endpointId:1,clusterId:6,command:"on",args:{}}` enciende; `{nodeId:"100",endpointId:1,clusterId:47,attribute:"batPercentRemaining"}` lee la batería. La batería permanece en unidades Matter raw de medio porcentaje; divídela entre dos en un nodo Function.
 
 ## 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.
+
+Los comandos se ejecutan en una cola ordenada independiente para cada dispositivo emparejado. Por tanto, un dispositivo sin conexión, agotado por tiempo de espera o eliminado no puede retrasar otros dispositivos Matter que utilicen la misma dirección de grupo KNX. Un nodo que aún referencia un dispositivo eliminado rechaza el comando inmediatamente y muestra **Device no longer commissioned** en rojo; selecciona un dispositivo Matter válido o elimina el nodo Controller huérfano.
+
+El error de dispositivo no disponible queda enclavado: los siguientes comandos KNX y flow se ignoran y no pueden sobrescribir el estado rojo. El nodo se reanuda automáticamente en cuanto ese dispositivo Matter informa `connected`; abrir el editor del nodo también libera el bloqueo para permitir un reintento manual.
 </script>

package/nodes/locales/es/knxUltimateMatterControllerDevice.json

@@ -11,6 +11,28 @@
     "node-input-hueLight": "Dispositivo Matter",
     "paletteLabel": "Control Matter from KNX",
     "no_devices": "No se encontraron dispositivos Matter. Comprueba el controlador Matter y actualiza.",
+    "input_help_label": "Entrada del flow",
+    "input_help_pin_hint": "Activa los pines de entrada/salida del nodo antes de enviar estos mensajes.",
+    "input_help_endpoint": "Endpoint seleccionado",
+    "input_help_endpoint_hint": "El nodo ya conoce el Node ID y el Endpoint ID; los mensajes simples no los necesitan.",
+    "input_help_simple_title": "Mensajes simples",
+    "input_help_simple_hint": "Estas funciones usan unidades comprensibles y se traducen al clúster, comando o atributo Matter del endpoint seleccionado.",
+    "input_help_advanced_title": "Detalles Matter avanzados",
+    "input_help_advanced_hint": "Solo se muestran atributos y comandos anunciados. Los ejemplos de escritura usan 0 como marcador; los argumentos de los comandos pueden requerir adaptación al tipo Matter.",
+    "input_help_operation": "Operación",
+    "input_help_function": "Función",
+    "input_help_target": "Destino Matter",
+    "input_help_message": "Mensaje",
+    "input_help_read": "Lectura",
+    "input_help_write": "Escritura",
+    "input_help_command": "Comando",
+    "input_help_copy": "Copiar",
+    "input_help_copied": "Mensaje copiado",
+    "input_help_no_simple": "Este endpoint no tiene funciones de entrada simples conocidas.",
+    "input_help_no_structure": "La estructura Matter no está disponible. Actualiza la lista de dispositivos mientras el endpoint esté en línea.",
+    "input_functions": {
+      "onoff": "Encender / Apagar", "level": "Nivel", "position": "Posición de persiana", "tiltposition": "Inclinación de persiana", "open": "Abrir", "close": "Cerrar", "stop": "Detener", "setpoint": "Consigna de calefacción", "coolingsetpoint": "Consigna de refrigeración", "currenttemp": "Temperatura actual", "fanspeed": "Velocidad del ventilador", "temperature": "Temperatura", "humidity": "Humedad", "illuminance": "Iluminancia", "occupancy": "Ocupación", "contact": "Contacto", "battery": "Batería", "activepower": "Potencia activa", "importedenergy": "Energía importada", "identify": "Identificar", "lock": "Bloquear", "unlock": "Desbloquear"
+    },
     "tabs": {
       "switch": "Cambiar",
       "dim": "Oscuro",
@@ -92,7 +114,23 @@
     "matter_controller": "Controlador Matter",
     "matter_device": "Dispositivo Matter",
     "device_type": "Tipo de dispositivo",
-    "matter_section": "Dispositivo Matter"
+    "matter_section": "Dispositivo Matter",
+    "controller_mode": "Modo",
+    "single_mode": "Dispositivo individual",
+    "universal_mode": "Modo universal (todos los dispositivos Matter)",
+    "universal_mode_description": "Escucha y controla todos los dispositivos Matter conectados a este controlador. El modo universal funciona sin mapeos KNX.",
+    "universal_service": "Servicio",
+    "universal_service_battery_monitor": "Monitor universal de baterías",
+    "universal_service_all_events": "Todos los eventos Matter",
+    "universal_battery_threshold": "Umbral de batería baja",
+    "universal_low_battery_ga": "GA alarma de batería",
+    "universal_low_battery_text_ga": "GA nombre del dispositivo",
+    "universal_battery_only_low": "Emitir solo baterías bajas",
+    "universal_emit_initial": "Emitir instantánea inicial de baterías",
+    "universal_include_raw": "Incluir evento Matter raw",
+    "universal_mode_status": "Modo Matter universal",
+    "universal_mode_locate_disabled": "Localizar no está disponible en el modo universal.",
+    "universal_controller_name": "Controlador Matter universal"
   },
   "common": {
     "ga": "Georgia",

package/nodes/locales/es/matter-config.html

@@ -11,7 +11,11 @@ El controlador se comunica con los dispositivos a través de la **red IP** (WiFi
 
 1. Haz primero el **deploy** de este nodo de configuración (el controlador debe estar en ejecución).
 2. Vuelve a abrir el nodo e introduce el **código de emparejamiento**: el código manual de 11 dígitos (p.ej. `3497-011-2332`) o el contenido del código QR (`MT:....`).
-3. Pulsa **EMPAREJAR**. El comisionado puede tardar hasta un minuto.
+3. Para un código escrito manualmente, pulsa **EMPAREJAR**. Un QR leído con **Webcam** o **Imagen** inicia automáticamente el emparejamiento. El comisionado puede tardar hasta un minuto.
+
+En lugar de escribir el payload QR, pulsa **Webcam** para escanearlo en directo o **Imagen** para leerlo desde una foto local. Se admiten tanto los códigos QR estándar oscuros sobre fondo claro como los invertidos blancos sobre fondo oscuro. La decodificación se realiza íntegramente en el navegador; tras leer un QR Matter válido, el editor rellena el campo del código e inicia inmediatamente el emparejamiento. Introduce antes el nombre opcional del dispositivo si lo deseas. Un código escrito manualmente sigue iniciándose solo al pulsar **EMPAREJAR**. El acceso en directo a la webcam requiere que el editor se abra mediante HTTPS o desde `localhost`; si no es posible, el editor explica la limitación y la carga de imágenes sigue disponible.
+
+Durante el comisionado, un panel de espera bloqueante cubre el editor e impide más clics hasta que la operación finaliza correctamente o con un error.
 
 Si el dispositivo es nuevo de fábrica y solo admite emparejamiento por Bluetooth, emparéjalo primero con la app del fabricante o con otro controlador Matter (Alexa, Google Home, Apple Home) y usa después su función **"compartir / emparejar con otro hub"** para generar un nuevo código para KNX-Ultimate. Así el dispositivo se une a varias fabrics a la vez.
 
@@ -26,4 +30,10 @@ Usa **Exportar** para descargar una copia completa de esta instancia del control
 ## Eliminar un dispositivo
 
 Usa el botón de la papelera en la lista de dispositivos emparejados. El controlador intenta retirar el dispositivo correctamente; si no está accesible, se elimina igualmente de la fabric (puede ser necesario un reset de fábrica del dispositivo).
+
+La lista contiene una fila por cada nodo almacenado actualmente en la fabric Matter de este controlador. Los Node ID son únicos dentro de esa fabric; los endpoints expuestos por un único bridge comisionado no se muestran como dispositivos separados. La columna de estado indica si cada nodo está conectado, desconectado, reconectando o esperando ser descubierto.
+
+El controlador conserva por separado el orden de comandos de cada dispositivo emparejado. Un dispositivo lento, sin conexión o eliminado no puede bloquear los comandos destinados a otros dispositivos. Los nodos Controller que aún referencian un Node ID eliminado rechazan inmediatamente los nuevos comandos y muestran **Device no longer commissioned**.
+
+Cuando un dispositivo deja de estar disponible, sus nodos Controller permanecen bloqueados e ignoran los comandos posteriores hasta que ese dispositivo vuelve a informar `connected`. La recuperación es automática; abrir el editor del nodo de dispositivo también libera el bloqueo para un reintento manual.
 </script>

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

@@ -9,6 +9,18 @@
       "pairing_code": "Código de emparejamiento",
       "pairing_name": "Nombre del dispositivo",
       "pair_button": "EMPAREJAR",
+      "qr_acquire": "Leer código QR",
+      "qr_scan_camera": "Webcam",
+      "qr_scan_image": "Imagen",
+      "qr_stop_camera": "Detener cámara",
+      "qr_camera_insecure": "El navegador no puede usar la webcam porque el editor de Node-RED no está abierto mediante HTTPS o localhost. Vuelve a abrirlo con HTTPS o usa Imagen.",
+      "qr_camera_unsupported": "Este navegador no puede acceder a una webcam. Usa un navegador compatible o carga una imagen.",
+      "qr_camera_permission_denied": "Se denegó el permiso para usar la webcam. Permite el acceso a la cámara en el navegador o carga una imagen.",
+      "qr_camera_failed": "No se pudo iniciar la webcam",
+      "qr_image_failed": "No se encontró ningún código QR legible en la imagen seleccionada",
+      "qr_invalid_matter": "El código QR no es un código de emparejamiento Matter (MT:…).",
+      "qr_found": "Código QR Matter leído. El emparejamiento comienza automáticamente.",
+      "qr_decoder_unavailable": "No se pudo cargar el lector de códigos QR.",
       "devices_title": "Dispositivos emparejados",
       "col_name": "Nombre",
       "col_product": "Producto",

package/nodes/locales/fr/knxUltimateMatterBridge.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Expose KNX to Matter (BETA)
-
 > Ce nœud est en **BETA** : il fonctionne, mais des détails peuvent encore changer entre les versions.
 
 ## Vue d'ensemble

package/nodes/locales/fr/knxUltimateMatterControllerDevice.html

@@ -1,6 +1,4 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
-# Control Matter from KNX (BETA)
-
 > Ce nœud est en **BETA** : le comportement peut changer pendant l amélioration de l'implémentation Matter.
 
 Ce nœud contrôle depuis KNX un endpoint Matter déjà appairé. Sélectionnez l'appareil Matter et l'éditeur détecte ses capacités, puis affiche uniquement les mappings KNX adaptés à cet endpoint.
@@ -21,9 +19,31 @@ 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. La sélection est conservée à la réouverture de l'éditeur. |
+| Node Input/Output PINs | Affiche les pins entrée/sortie Node-RED. Les endpoints autres que lumière acceptent le format simple `{function,value}` et les champs Matter avancés ; la sortie émet les états. |
+
+## Entrée du flow
+
+Pour un endpoint autre que lumière, ouvrez l'onglet **Entrée du flow**. L'onglet est construit depuis la structure annoncée et affiche des exemples copiables, l'Endpoint ID, tous les attributs lisibles/inscriptibles et toutes les commandes acceptées. Il reste disponible lorsque le nœud est utilisé uniquement par le flow, sans passerelle KNX.
+
+Une écriture simple utilise `msg.payload = {function:"position",value:35}`. Omettez `value` pour lire un état, par exemple `{function:"temperature"}` ; la sortie utilise des unités lisibles et place les détails bruts dans `msg.matter`. Les fonctions `onoff`, `level`, `position`, `open`, `close`, `stop`, consignes, ventilateur et capteurs ne sont proposées que si l'endpoint les annonce. Une serrure accepte `{function:"lock",value:true|false}`.
+
+Les entrées avancées restent valides : `msg.clusterId` avec `msg.command`/`msg.args`, ou `msg.attribute` et éventuellement `msg.value`. Le Node ID et l'Endpoint ID sont déjà sélectionnés dans le nœud.
+
+## Mode universel
+
+Sélectionnez **Mode universel** pour surveiller tous les appareils. Le nœud possède toujours une entrée et une sortie et n'utilise pas les mappings d'un endpoint. La passerelle KNX est optionnelle et sert uniquement aux GA alarme/texte du moniteur.
+
+Le **Moniteur universel de batteries** conserve l'état complet. Les GA KNX optionnelles publient l'alarme globale en DPT 1.005 et font défiler les appareils toutes les 2 secondes en DPT 16.001. `{payload:{action:"getAllBatteries"}}` renvoie l'inventaire.
+
+La sortie place la valeur brute dans `msg.payload` et le routage dans `msg.matter` (`source`, `nodeId`, `endpointId`, `clusterId`, nom d'attribut/événement). L'entrée utilise `msg.nodeId`, `msg.endpointId`, `msg.clusterId` et soit `msg.command` avec `msg.args`, soit `msg.attribute`; ajoutez `msg.value` pour écrire, omettez-le pour lire. Ces champs peuvent aussi être placés sous `msg.matter`.
+
+Exemples : `{nodeId:"100",endpointId:1,clusterId:6,command:"on",args:{}}` allume ; `{nodeId:"100",endpointId:1,clusterId:47,attribute:"batPercentRemaining"}` lit la batterie. La batterie reste dans l'unité Matter brute par demi-pourcent ; divisez par deux dans un nœud Function.
 
 ## Comportement
 
 Le nœud garde un cache local depuis les mises à jour Matter et les écritures KNX, répond aux lectures KNX depuis ce cache et peut émettre/lire les valeurs au démarrage. Il n'écoute que les adresses de groupe configurées, donc le trafic KNX non lié est ignoré.
+
+Les commandes utilisent une file ordonnée séparée pour chaque appareil appairé. Un appareil hors ligne, en délai dépassé ou supprimé ne peut donc pas retarder les autres appareils Matter qui utilisent la même adresse de groupe KNX. Un nœud qui référence encore un appareil supprimé refuse immédiatement la commande et affiche **Device no longer commissioned** en rouge ; sélectionnez un appareil Matter valide ou supprimez le nœud Controller orphelin.
+
+Une erreur d'appareil indisponible reste verrouillée : les commandes KNX et flow suivantes sont ignorées et ne peuvent pas remplacer l'état rouge. Le nœud reprend automatiquement dès que cet appareil Matter signale `connected` ; l'ouverture de l'éditeur du nœud libère également le verrou pour permettre un nouvel essai manuel.
 </script>