node-red-contrib-knx-ultimate 6.0.12 → 6.1.1

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

@@ -45,7 +45,7 @@ These options are hidden unless they apply to the selected type. Dimmable device
 
 ## Node PINs
 
-If you enable the node input/output PINs:
+The PIN selector is outside the editor tabs. Enabling it reveals a contextual **Flow input/output** section directly below, with copyable examples filtered to the selected device type:
 
 - **Input**: update the Matter state from the flow, without the KNX bus: `msg.payload = { function: "onoff", value: true }` (`function` is one of `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Useful to expose flow-computed values (e.g. a virtual sensor) to Alexa & Co.
 - **Output**: every command received from a Matter controller is forwarded to the flow: `msg.topic` = device name, `msg.payload` = value, `msg.matter` = the raw command. A device without command GAs becomes a **flow-only device**.

package/nodes/locales/en/knxUltimateMatterBridge.json

@@ -36,6 +36,20 @@
       "mappings": "KNX mappings",
       "advanced": "Advanced options"
     },
+    "flow_help": {
+      "title": "Flow input/output",
+      "intro": "These examples match the selected device type and are available while the node input/output PINs are enabled.",
+      "input_title": "Flow → Matter (node input)",
+      "input_hint": "Send one of these messages to update the exposed Matter state without writing to KNX.",
+      "output_title": "Matter → Flow (node output)",
+      "output_hint": "Commands received from a Matter controller are emitted with the value in msg.payload and raw routing details in msg.matter.",
+      "function": "Function",
+      "message": "Example message",
+      "copy": "Copy",
+      "copied": "Message copied",
+      "no_input": "This device type has no flow state-update examples.",
+      "no_output": "This device type does not emit controller commands; its output remains silent."
+    },
     "functions": {
       "fn_onoff_cmd": "On/Off command GA",
       "fn_onoff_status": "On/Off status GA",

package/nodes/locales/en/knxUltimateMatterControllerDevice.html

@@ -19,7 +19,15 @@ 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 and reveals the **Flow input** section directly below this field. Lights show their supported top-level light-state messages; non-light endpoints show the simple `{function,value}` contract and advanced Matter fields. The selection is preserved when the editor is reopened. |
+
+## Flow input
+
+Enable **Node Input/Output PINs** to reveal the **Flow input** section directly below the selector. For lights it shows copyable examples for the supported top-level properties, such as `msg.on`, `msg.dimming`, `msg.color_temperature` and `msg.color`. For non-light endpoints it is built from the advertised structure and provides 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
 
@@ -34,4 +42,8 @@ Examples: `{nodeId:"100",endpointId:1,clusterId:6,command:"on",args:{}}` turns O
 ## 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,29 @@
     "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_light_hint": "Light endpoints accept light-state properties directly on msg (not inside msg.payload). Only controls supported by the selected light are shown.",
+    "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", "on": "On", "off": "Off", "level": "Level", "brightness": "Brightness", "color_temperature": "Colour temperature", "xy_color": "XY colour", "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",

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

@@ -45,7 +45,7 @@ Estas opciones solo aparecen cuando tienen sentido para el tipo seleccionado. Lo
 
 ## PINes del nodo
 
-Si habilitas los PINes de entrada/salida del nodo:
+El selector de PINes está fuera de las pestañas del editor. Al activarlo aparece justo debajo una sección contextual **Entrada/salida del flow**, con ejemplos copiables filtrados según el tipo de dispositivo:
 
 - **Entrada**: actualiza el estado Matter desde el flow, sin pasar por el bus KNX: `msg.payload = { function: "onoff", value: true }` (`function` es una de `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Útil para exponer a Alexa y cía. valores calculados en el flow (p.ej. un sensor virtual).
 - **Salida**: cada comando recibido de un controlador Matter se reenvía al flow: `msg.topic` = nombre del dispositivo, `msg.payload` = valor, `msg.matter` = el comando en bruto. Un dispositivo sin GA de comando se convierte en un **dispositivo solo-flow**.

package/nodes/locales/es/knxUltimateMatterBridge.json

@@ -36,6 +36,20 @@
       "mappings": "Asignaciones KNX",
       "advanced": "Opciones avanzadas"
     },
+    "flow_help": {
+      "title": "Entrada/salida del flow",
+      "intro": "Estos ejemplos corresponden al tipo de dispositivo seleccionado y están disponibles mientras los pines de entrada/salida del nodo están activados.",
+      "input_title": "Flow → Matter (entrada del nodo)",
+      "input_hint": "Envía uno de estos mensajes para actualizar el estado Matter expuesto sin escribir en KNX.",
+      "output_title": "Matter → Flow (salida del nodo)",
+      "output_hint": "Los comandos recibidos de un controlador Matter se emiten con el valor en msg.payload y los detalles raw en msg.matter.",
+      "function": "Función",
+      "message": "Mensaje de ejemplo",
+      "copy": "Copiar",
+      "copied": "Mensaje copiado",
+      "no_input": "Este tipo de dispositivo no tiene ejemplos de actualización de estado desde el flow.",
+      "no_output": "Este tipo de dispositivo no emite comandos del controlador; su salida permanece inactiva."
+    },
     "functions": {
       "fn_onoff_cmd": "GA comando On/Off",
       "fn_onoff_status": "GA estado On/Off",

package/nodes/locales/es/knxUltimateMatterControllerDevice.html

@@ -19,7 +19,15 @@ 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 y la sección **Entrada del flow** justo debajo de este campo. Las luces muestran sus mensajes de estado compatibles en el nivel superior; los demás endpoints muestran el formato simple `{function,value}` y los campos Matter avanzados. |
+
+## Entrada del flow
+
+Activa **Node Input/Output PINs** para mostrar la sección **Entrada del flow** justo debajo del selector. Para una luz, muestra ejemplos copiables de las propiedades compatibles en el nivel superior, como `msg.on`, `msg.dimming`, `msg.color_temperature` y `msg.color`. Para los demás endpoints, se construye con la estructura anunciada y muestra el Endpoint ID, todos los atributos legibles/escribibles y los comandos aceptados. Sigue disponible 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
 
@@ -34,4 +42,8 @@ Ejemplos: `{nodeId:"100",endpointId:1,clusterId:6,command:"on",args:{}}` enciend
 ## 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,29 @@
     "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_light_hint": "Los endpoints de luz aceptan propiedades de estado directamente en msg (no dentro de msg.payload). Solo se muestran los controles compatibles con la luz seleccionada.",
+    "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", "on": "Encender", "off": "Apagar", "level": "Nivel", "brightness": "Brillo", "color_temperature": "Temperatura de color", "xy_color": "Color XY", "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",

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

@@ -45,7 +45,7 @@ Ces options ne s'affichent que lorsqu'elles s'appliquent au type sélectionné.
 
 ## PIN du nœud
 
-Si vous activez les PIN entrée/sortie du nœud :
+Le sélecteur de PIN se trouve hors des onglets de l'éditeur. Son activation affiche juste dessous une section contextuelle **Entrée/sortie du flow**, avec des exemples copiables filtrés selon le type d'appareil :
 
 - **Entrée** : mettez à jour l'état Matter depuis le flux, sans passer par le bus KNX : `msg.payload = { function: "onoff", value: true }` (`function` est l'une de `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Utile pour exposer à Alexa & Co. des valeurs calculées dans le flux (ex. un capteur virtuel).
 - **Sortie** : chaque commande reçue d'un contrôleur Matter est transmise au flux : `msg.topic` = nom de l'appareil, `msg.payload` = valeur, `msg.matter` = la commande brute. Un appareil sans GA de commande devient un **appareil flow uniquement**.

package/nodes/locales/fr/knxUltimateMatterBridge.json

@@ -36,6 +36,20 @@
       "mappings": "Mappages KNX",
       "advanced": "Options avancées"
     },
+    "flow_help": {
+      "title": "Entrée/sortie du flow",
+      "intro": "Ces exemples correspondent au type d'appareil sélectionné et sont disponibles lorsque les broches d'entrée/sortie du nœud sont activées.",
+      "input_title": "Flow → Matter (entrée du nœud)",
+      "input_hint": "Envoyez l'un de ces messages pour mettre à jour l'état Matter exposé sans écrire sur KNX.",
+      "output_title": "Matter → Flow (sortie du nœud)",
+      "output_hint": "Les commandes reçues d'un contrôleur Matter sont émises avec la valeur dans msg.payload et les détails bruts dans msg.matter.",
+      "function": "Fonction",
+      "message": "Message d'exemple",
+      "copy": "Copier",
+      "copied": "Message copié",
+      "no_input": "Ce type d'appareil ne possède aucun exemple de mise à jour d'état depuis le flow.",
+      "no_output": "Ce type d'appareil n'émet aucune commande de contrôleur ; sa sortie reste inactive."
+    },
     "functions": {
       "fn_onoff_cmd": "GA commande On/Off",
       "fn_onoff_status": "GA état On/Off",

package/nodes/locales/fr/knxUltimateMatterControllerDevice.html

@@ -19,7 +19,15 @@ 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 et la section **Entrée du flow** juste sous ce champ. Les lumières affichent leurs messages d'état pris en charge au premier niveau ; les autres endpoints affichent le format simple `{function,value}` et les champs Matter avancés. |
+
+## Entrée du flow
+
+Activez **Node Input/Output PINs** pour afficher la section **Entrée du flow** juste sous le sélecteur. Pour une lumière, elle propose des exemples copiables des propriétés prises en charge au premier niveau, comme `msg.on`, `msg.dimming`, `msg.color_temperature` et `msg.color`. Pour les autres endpoints, elle est construite depuis la structure annoncée et affiche l'Endpoint ID, tous les attributs lisibles/inscriptibles et toutes les commandes acceptées. Elle reste disponible 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
 
@@ -34,4 +42,8 @@ Exemples : `{nodeId:"100",endpointId:1,clusterId:6,command:"on",args:{}}` allume
 ## 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>

package/nodes/locales/fr/knxUltimateMatterControllerDevice.json

@@ -11,6 +11,29 @@
     "node-input-hueLight": "Appareil Matter",
     "paletteLabel": "Control Matter from KNX",
     "no_devices": "Aucun appareil Matter trouvé. Vérifiez le contrôleur Matter et actualisez.",
+    "input_help_label": "Entrée du flow",
+    "input_help_pin_hint": "Activez les broches d'entrée/sortie du nœud avant d'envoyer ces messages.",
+    "input_help_endpoint": "Endpoint sélectionné",
+    "input_help_endpoint_hint": "Le nœud connaît déjà le Node ID et l'Endpoint ID ; les messages simples n'en ont pas besoin.",
+    "input_help_simple_title": "Messages simples",
+    "input_help_simple_hint": "Ces fonctions utilisent des unités lisibles et sont traduites vers le cluster, la commande ou l'attribut Matter de l'endpoint sélectionné.",
+    "input_help_light_hint": "Les endpoints de type lumière acceptent les propriétés d'état directement dans msg (pas dans msg.payload). Seules les commandes prises en charge par la lumière sélectionnée sont affichées.",
+    "input_help_advanced_title": "Détails Matter avancés",
+    "input_help_advanced_hint": "Seuls les attributs et commandes annoncés sont affichés. Les exemples d'écriture utilisent 0 comme valeur provisoire ; les arguments des commandes peuvent devoir être adaptés au type Matter.",
+    "input_help_operation": "Opération",
+    "input_help_function": "Fonction",
+    "input_help_target": "Cible Matter",
+    "input_help_message": "Message",
+    "input_help_read": "Lecture",
+    "input_help_write": "Écriture",
+    "input_help_command": "Commande",
+    "input_help_copy": "Copier",
+    "input_help_copied": "Message copié",
+    "input_help_no_simple": "Cet endpoint ne possède aucune fonction d'entrée simple connue.",
+    "input_help_no_structure": "La structure Matter est indisponible. Actualisez la liste des appareils lorsque l'endpoint est en ligne.",
+    "input_functions": {
+      "onoff": "Marche / Arrêt", "on": "Allumer", "off": "Éteindre", "level": "Niveau", "brightness": "Luminosité", "color_temperature": "Température de couleur", "xy_color": "Couleur XY", "position": "Position du volet", "tiltposition": "Inclinaison du volet", "open": "Ouvrir", "close": "Fermer", "stop": "Arrêter", "setpoint": "Consigne chauffage", "coolingsetpoint": "Consigne refroidissement", "currenttemp": "Température actuelle", "fanspeed": "Vitesse du ventilateur", "temperature": "Température", "humidity": "Humidité", "illuminance": "Éclairement", "occupancy": "Occupation", "contact": "Contact", "battery": "Batterie", "activepower": "Puissance active", "importedenergy": "Énergie importée", "identify": "Identifier", "lock": "Verrouiller", "unlock": "Déverrouiller"
+    },
     "tabs": {
       "switch": "Changer",
       "dim": "Faible",
@@ -35,6 +58,14 @@
     "get_current": "Prendre le courant",
     "get_again": "Remonter",
     "wait": "Attendez...",
+    "locate_no_bridge": "Sélectionnez d'abord un contrôleur Matter",
+    "locate_no_device": "Sélectionnez d'abord un appareil Matter",
+    "locate_success": "Commande de localisation envoyée",
+    "locate_started": "Mode de localisation démarré. Appuyez à nouveau pour l'arrêter (arrêt automatique après 10 minutes).",
+    "locate_stopped": "Mode de localisation arrêté.",
+    "locate_start_title": "Localiser l'appareil Matter sélectionné",
+    "locate_stop_title": "Arrêter le mode de localisation",
+    "locate_error": "Impossible de localiser l'appareil Matter",
     "day_night": "Jour / nuit",
     "invert_day_night": "Valeur de jour / nuit inversée",
     "override_night_mode": "Forcer le mode jour",

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

@@ -11,7 +11,11 @@ Le contrôleur communique avec les appareils via le **réseau IP** (WiFi, Ethern
 
 1. **Déployez** d'abord ce nœud de configuration (le contrôleur doit être en fonction).
 2. Rouvrez le nœud et saisissez le **code d'appairage** : le code manuel à 11 chiffres (ex. `3497-011-2332`) ou le contenu du QR code (`MT:....`).
-3. Cliquez sur **APPAIRER**. Le commissionnement peut prendre jusqu'à une minute.
+3. Pour un code saisi manuellement, cliquez sur **APPAIRER**. Un QR lu avec **Webcam** ou **Image** démarre automatiquement l'appairage. Le commissionnement peut prendre jusqu'à une minute.
+
+Au lieu de saisir le payload QR, cliquez sur **Webcam** pour le scanner en direct ou sur **Image** pour le lire depuis une photo locale. Les QR codes standards sombres sur fond clair et les codes inversés blancs sur fond sombre sont pris en charge. Le décodage s'effectue entièrement dans le navigateur ; après la lecture d'un QR Matter valide, l'éditeur remplit le champ du code et démarre immédiatement l'appairage. Saisissez auparavant le nom facultatif de l'appareil si nécessaire. Un code saisi manuellement ne démarre toujours qu'après un clic sur **APPAIRER**. L'accès direct à la webcam exige que l'éditeur soit ouvert via HTTPS ou depuis `localhost` ; sinon l'éditeur explique cette limitation et le chargement d'une image reste disponible.
+
+Pendant le commissionnement, un panneau d'attente bloquant recouvre l'éditeur et empêche tout autre clic jusqu'à la réussite ou l'échec de l'opération.
 
 Si l'appareil est neuf et ne prend en charge que l'appairage Bluetooth, appairez-le d'abord avec l'app du fabricant ou un autre contrôleur Matter (Alexa, Google Home, Apple Home), puis utilisez sa fonction **« partager / appairer avec un autre hub »** pour générer un nouveau code pour KNX-Ultimate. L'appareil rejoint ainsi plusieurs fabrics à la fois.
 
@@ -26,4 +30,10 @@ Utilisez **Exporter** pour télécharger une sauvegarde complète de cette insta
 ## Supprimer un appareil
 
 Utilisez le bouton corbeille dans la liste des appareils appairés. Le contrôleur essaie de retirer l'appareil proprement ; s'il est injoignable, il est quand même supprimé de la fabric (une réinitialisation d'usine de l'appareil peut alors être nécessaire).
+
+La liste contient une ligne pour chaque nœud actuellement enregistré dans la fabric Matter de ce contrôleur. Les Node ID sont uniques au sein de cette fabric ; les endpoints exposés par un même bridge commissionné ne sont pas affichés comme des appareils distincts. La colonne d'état indique si chaque nœud est connecté, déconnecté, en cours de reconnexion ou en attente de découverte.
+
+Le contrôleur conserve séparément l'ordre des commandes de chaque appareil appairé. Un appareil lent, hors ligne ou supprimé ne peut pas bloquer les commandes destinées aux autres appareils. Les nœuds Controller qui référencent encore un Node ID supprimé refusent immédiatement les nouvelles commandes et affichent **Device no longer commissioned**.
+
+Lorsqu'un appareil devient indisponible, ses nœuds Controller restent bloqués et ignorent les commandes suivantes jusqu'à ce que cet appareil signale de nouveau `connected`. La reprise est automatique ; l'ouverture de l'éditeur du nœud appareil libère aussi le blocage pour un nouvel essai manuel.
 </script>

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

@@ -9,6 +9,18 @@
       "pairing_code": "Code d'appairage",
       "pairing_name": "Nom de l'appareil",
       "pair_button": "APPAIRER",
+      "qr_acquire": "Lire le QR code",
+      "qr_scan_camera": "Webcam",
+      "qr_scan_image": "Image",
+      "qr_stop_camera": "Arrêter la caméra",
+      "qr_camera_insecure": "Le navigateur ne peut pas utiliser la webcam car l'éditeur Node-RED n'est pas ouvert via HTTPS ou localhost. Rouvrez-le en HTTPS ou utilisez Image.",
+      "qr_camera_unsupported": "Ce navigateur ne peut pas accéder à une webcam. Utilisez un navigateur compatible ou chargez une image.",
+      "qr_camera_permission_denied": "L'autorisation d'utiliser la webcam a été refusée. Autorisez l'accès à la caméra dans le navigateur ou chargez une image.",
+      "qr_camera_failed": "Impossible de démarrer la webcam",
+      "qr_image_failed": "Aucun QR code lisible n'a été trouvé dans l'image sélectionnée",
+      "qr_invalid_matter": "Le QR code n'est pas un code d'appairage Matter (MT:…).",
+      "qr_found": "QR code Matter lu. L'appairage démarre automatiquement.",
+      "qr_decoder_unavailable": "Impossible de charger le lecteur de QR code.",
       "devices_title": "Appareils appairés",
       "col_name": "Nom",
       "col_product": "Produit",

package/nodes/locales/it/knxUltimateMatterBridge.html

@@ -45,7 +45,7 @@ Queste opzioni sono nascoste finché non servono al tipo selezionato. I disposit
 
 ## PIN del nodo
 
-Se abiliti i PIN input/output del nodo:
+Il selettore dei PIN si trova fuori dalle TAB dell'editor. Abilitandolo compare subito sotto una sezione contestuale **Input/output del flow**, con esempi copiabili filtrati per il tipo di dispositivo selezionato:
 
 - **Input**: aggiorna lo stato Matter dal flow, senza passare dal bus KNX: `msg.payload = { function: "onoff", value: true }` (`function` è una tra `onoff`, `level`, `rgb`, `colortemp`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`, `fanspeed`, `smoke`, `co`, `leak`, `co2`, `rvcstate`, `rvcmode`). Utile per esporre ad Alexa & Co. valori calcolati nel flow (es. un sensore virtuale).
 - **Output**: ogni comando ricevuto da un controller Matter viene inoltrato al flow: `msg.topic` = nome del dispositivo, `msg.payload` = valore, `msg.matter` = il comando grezzo. Un dispositivo senza GA di comando diventa un **dispositivo solo-flow**.

package/nodes/locales/it/knxUltimateMatterBridge.json

@@ -36,6 +36,20 @@
       "mappings": "Mappature KNX",
       "advanced": "Opzioni avanzate"
     },
+    "flow_help": {
+      "title": "Input/output del flow",
+      "intro": "Questi esempi corrispondono al tipo di dispositivo selezionato e sono disponibili quando i PIN input/output del nodo sono abilitati.",
+      "input_title": "Flow → Matter (input del nodo)",
+      "input_hint": "Invia uno di questi messaggi per aggiornare lo stato Matter esposto senza scrivere sul bus KNX.",
+      "output_title": "Matter → Flow (output del nodo)",
+      "output_hint": "I comandi ricevuti da un controller Matter vengono emessi con il valore in msg.payload e i dettagli raw in msg.matter.",
+      "function": "Funzione",
+      "message": "Messaggio di esempio",
+      "copy": "Copia",
+      "copied": "Messaggio copiato",
+      "no_input": "Questo tipo di dispositivo non ha esempi di aggiornamento stato dal flow.",
+      "no_output": "Questo tipo di dispositivo non emette comandi dal controller; il suo output rimane inattivo."
+    },
     "functions": {
       "fn_onoff_cmd": "GA comando On/Off",
       "fn_onoff_status": "GA stato On/Off",

package/nodes/locales/it/knxUltimateMatterControllerDevice.html

@@ -19,7 +19,15 @@ 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. La selezione viene mantenuta alla riapertura dell'editor. |
+| Node Input/Output PINs | Mostra i pin input/output Node-RED e la sezione **Input dal flow** subito sotto questo campo. Per le luci sono mostrati i messaggi di stato luce supportati al primo livello; per gli endpoint non luce sono mostrati il formato semplice `{function,value}` e i campi Matter avanzati. La selezione viene mantenuta alla riapertura dell'editor. |
+
+## Input dal flow
+
+Abilita **PIN di Input/Output del nodo** per mostrare la sezione **Input dal flow** subito sotto il selettore. Per le luci contiene esempi copiabili delle proprietà supportate al primo livello, come `msg.on`, `msg.dimming`, `msg.color_temperature` e `msg.color`. Per gli endpoint non luce viene costruita dalla struttura annunciata e mostra l'Endpoint ID selezionato, tutti gli attributi leggibili/scrivibili e tutti i comandi accettati. Rimane disponibile anche quando il nodo viene usato soltanto dal flow senza gateway KNX.
+
+Le scritture semplici usano `msg.payload = {function:"position",value:35}`. Ometti `value` per leggere uno stato supportato, ad esempio `{function:"temperature"}`; l'output usa unità comprensibili e include i dettagli raw in `msg.matter`. Le funzioni comprendono `onoff`, `level`, `position`, `tiltposition`, `open`, `close`, `stop`, `setpoint`, `coolingsetpoint`, `currenttemp`, `fanspeed`, letture sensore e `identify`, ma soltanto se annunciate dall'endpoint. La serratura accetta `{function:"lock",value:true|false}`.
+
+Gli input avanzati esistenti restano validi: usa `msg.clusterId` al primo livello con `msg.command`/`msg.args`, oppure `msg.attribute` con l'eventuale `msg.value`. Node ID ed Endpoint ID sono già selezionati dal nodo; `msg.endpointId` serve solo come override opzionale.
 
 ## Modalità Universale
 
@@ -34,4 +42,8 @@ Esempi: `{nodeId:"100",endpointId:1,clusterId:6,command:"on",args:{}}` accende;
 ## Comportamento
 
 Il nodo mantiene una cache locale da aggiornamenti Matter e scritture KNX, risponde alle letture KNX dalla cache e può emettere/leggere i valori all'avvio. Ascolta solo gli indirizzi di gruppo configurati, quindi ignora il traffico KNX non pertinente.
+
+I comandi vengono eseguiti in una coda ordinata separata per ciascun dispositivo associato. Un dispositivo offline, in timeout o rimosso non può quindi ritardare gli altri dispositivi Matter che usano lo stesso indirizzo di gruppo KNX. Un nodo che punta ancora a un dispositivo rimosso rifiuta subito il comando e mostra in rosso **Device no longer commissioned**; seleziona un dispositivo Matter valido oppure elimina il nodo Controller rimasto orfano.
+
+L'errore di dispositivo non disponibile rimane agganciato: i successivi comandi KNX e flow vengono ignorati e non possono sovrascrivere lo stato rosso. Il nodo riprende automaticamente non appena quel dispositivo Matter segnala `connected`; anche l'apertura dell'editor del nodo azzera il blocco per consentire un tentativo manuale.
 </script>

package/nodes/locales/it/knxUltimateMatterControllerDevice.json

@@ -11,6 +11,29 @@
     "node-input-hueLight": "Dispositivo Matter",
     "paletteLabel": "Control Matter from KNX",
     "no_devices": "Nessun dispositivo Matter trovato. Controlla il controller Matter e premi refresh.",
+    "input_help_label": "Input dal flow",
+    "input_help_pin_hint": "Abilita i PIN di input/output del nodo prima di inviare questi messaggi.",
+    "input_help_endpoint": "Endpoint selezionato",
+    "input_help_endpoint_hint": "Il nodo conosce già Node ID ed Endpoint ID, quindi non servono nei messaggi semplici.",
+    "input_help_simple_title": "Messaggi semplici",
+    "input_help_simple_hint": "Queste funzioni usano unità comprensibili e vengono tradotte nel cluster, comando o attributo Matter esposto dall'endpoint selezionato.",
+    "input_help_light_hint": "Gli endpoint luce accettano le proprietà dello stato luce direttamente in msg (non dentro msg.payload). Sono mostrati solo i controlli supportati dalla luce selezionata.",
+    "input_help_advanced_title": "Dettagli Matter avanzati",
+    "input_help_advanced_hint": "Sono elencati soltanto attributi e comandi annunciati. Gli esempi di scrittura usano 0 come segnaposto; gli argomenti dei comandi possono richiedere un adattamento al tipo Matter.",
+    "input_help_operation": "Operazione",
+    "input_help_function": "Funzione",
+    "input_help_target": "Target Matter",
+    "input_help_message": "Messaggio",
+    "input_help_read": "Lettura",
+    "input_help_write": "Scrittura",
+    "input_help_command": "Comando",
+    "input_help_copy": "Copia",
+    "input_help_copied": "Messaggio copiato",
+    "input_help_no_simple": "Questo endpoint non espone funzioni semplici conosciute.",
+    "input_help_no_structure": "La struttura Matter non è disponibile. Aggiorna la lista dei dispositivi mentre l'endpoint è online.",
+    "input_functions": {
+      "onoff": "On / Off", "on": "Accendi", "off": "Spegni", "level": "Livello", "brightness": "Luminosità", "color_temperature": "Temperatura colore", "xy_color": "Colore XY", "position": "Posizione tapparella", "tiltposition": "Inclinazione tapparella", "open": "Apri", "close": "Chiudi", "stop": "Stop", "setpoint": "Setpoint riscaldamento", "coolingsetpoint": "Setpoint raffrescamento", "currenttemp": "Temperatura corrente", "fanspeed": "Velocità ventilatore", "temperature": "Temperatura", "humidity": "Umidità", "illuminance": "Illuminamento", "occupancy": "Presenza", "contact": "Contatto", "battery": "Batteria", "activepower": "Potenza attiva", "importedenergy": "Energia importata", "identify": "Identifica", "lock": "Blocca", "unlock": "Sblocca"
+    },
     "tabs": {
       "switch": "On/Off",
       "dim": "Dimmer",