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

package/nodes/locales/en/knxUltimateMatterControllerDevice.html

@@ -15,6 +15,8 @@ It replaces the unpublished per-device Matter controller nodes and keeps the ful
 | Matter controller | Matter controller configuration node where the device has been commissioned. |
 | Matter device | Matter endpoint selected from commissioned devices. The UI is rebuilt from its real capabilities. |
 | Switch / Plug / Light On-Off | On/Off command and status group addresses, usually DPT `1.001`. |
+| Door Lock | A DPT `1.xxx` command GA invokes `lockDoor` for `true` and `unlockDoor` for `false`; a separate status GA receives only unambiguous Locked/Unlocked states. If the endpoint requires it, store the remote-operation PIN in the credential field. Commands not advertised by the endpoint are rejected. |
+| Other endpoints | Plugs, On/Off actuators, covers, thermostats, fans, environmental/contact/occupancy sensors, battery, power and energy endpoints use the multi-purpose mapped profile. The dedicated **Mappings** tab contains only mappings backed by clusters, attributes and commands advertised by that endpoint; leave a GA empty to disable it. |
 | Light controls | For light endpoints, the same light UI is used: relative DIM (DPT `3.007`), brightness %, RGB/HSV, tunable white, switch-on brightness/temperature, day/night lighting, min/max dim level and dim speed. Unsupported sections are hidden. |
 | Sensors | Sensor endpoints expose their measurement/status GA only when supported: temperature, humidity, illuminance, occupancy, contact and battery. |
 | Read at startup | Publishes the cached Matter value at deploy/startup or when the device reconnects. |

package/nodes/locales/en/knxUltimateMatterControllerDevice.json

@@ -17,10 +17,19 @@
       "tunable_white": "Tunable white",
       "rgb_hsv": "RGB/HSV",
       "effects": "Effects",
+      "mappings": "Mappings",
       "behaviour": "Behaviour"
     },
     "control": "Control",
     "status": "Status",
+    "door_lock_command": "Lock / unlock",
+    "door_lock_status": "Lock state",
+    "door_lock_pin": "Remote-operation PIN",
+    "door_lock_pin_required": "This lock reports that a PIN is required for remote operation.",
+    "door_lock_commands_missing": "This endpoint does not advertise both lock and unlock commands. Missing commands will be rejected.",
+    "mapped": {
+      "onoff_command": "On / Off command", "onoff_state": "On / Off state", "cover_updown": "Cover up / down", "cover_stop": "Cover stop", "cover_position_command": "Cover position command", "cover_position_state": "Cover position state", "heating_command": "Heating setpoint command", "heating_state": "Heating setpoint state", "cooling_command": "Cooling setpoint command", "cooling_state": "Cooling setpoint state", "local_temperature": "Local temperature", "fan_command": "Fan speed command", "fan_state": "Fan speed state", "temperature": "Temperature", "humidity": "Humidity", "illuminance": "Illuminance", "occupancy": "Occupancy", "contact": "Boolean / contact state", "battery": "Battery", "active_power": "Active power", "imported_energy": "Imported energy"
+    },
     "night_lighting": "Night Lighting",
     "no_night_lighting": "No night lighting",
     "get_current": "Get current",
@@ -82,6 +91,7 @@
     "effect_native_label": "Hue native effects",
     "matter_controller": "Matter controller",
     "matter_device": "Matter device",
+    "device_type": "Device type",
     "matter_section": "Matter device"
   },
   "common": {

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

@@ -15,10 +15,14 @@ The controller talks to the devices over the **IP network** (WiFi, Ethernet, or
 
 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.
 
+Prefer the QR payload (`MT:...`): it contains the full discriminator. A manual code contains only the short discriminator and may select the wrong device when several identical models are in commissioning mode. Pair one device at a time.
+
 ## Storage
 
 The fabric credentials and the paired devices are stored in the `knxultimatestorage/matter` folder inside your Node-RED user directory. Deleting that folder unpairs everything.
 
+Use **Export** to download a complete backup of this controller instance. It includes the fabric, private credentials, sessions and commissioned-device data. **Protect the file like a password.** Import replaces this instance's current Matter storage and briefly restarts the controller. A controller backup cannot be imported into a bridge.
+
 ## 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).

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

@@ -2,7 +2,6 @@
   "matter-config": {
     "properties": {
       "title": "Matter Controller",
-      "intro": "This node is a Matter controller (its own fabric). Pair your Matter devices here, then use the \"Matter Device\" node to map them to KNX group addresses. Deploy the node first, then come back here to pair devices.",
       "node-config-input-name": "Name",
       "fabric_label": "Fabric label",
       "pairing_title": "Pair a new device",
@@ -25,7 +24,13 @@
       "pairing_hint": "Prefer the QR code (MT:…): it carries the full device discriminator. The manual code stores only a short discriminator and can't reliably tell identical devices apart (e.g. several Shelly of the same model), which may pair the wrong one or report it as already commissioned. Pair one device at a time; if it's already paired elsewhere, factory-reset it first.",
       "rename_button": "Rename",
       "rename_prompt": "New device name",
-      "rename_ok": "Device renamed."
+      "rename_ok": "Device renamed.",
+      "storage_title": "Fabric and commissioning backup",
+      "storage_export": "Export",
+      "storage_import": "Import",
+      "storage_warning": "The backup contains fabric credentials, private keys and commissioned-device data. Keep it secret like a password. Import replaces this controller's current Matter storage and briefly restarts it.",
+      "storage_import_confirm": "Replace this controller's Matter fabric and commissioned devices with the selected backup?",
+      "storage_import_ok": "Matter backup imported. The controller has restarted."
     }
   }
 }

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

@@ -21,12 +21,16 @@ This configuration node is the **Matter bridge itself**: it runs the Matter serv
 2. The pairing panel shows the **QR code** and the **manual pairing code**: scan or type it in Alexa / Google Home / Apple Home ("add Matter device").
 3. Multiple controllers can be paired with the same bridge (Matter multi-fabric).
 
+To add another controller after the QR code is hidden, open pairing mode from an already paired controller, then add a Matter device in the new controller. Use **Reset pairing** only to remove every existing controller and start over.
+
 The **Reset pairing** button removes all paired controllers and restarts the pairing advertising.
 
 ## Identity and storage
 
 The bridge identity is tied to this configuration node and stored in `knxultimatestorage/matter` inside the Node-RED user directory: re-deploys (even changing port or name) do **NOT** require a new pairing. Only deleting this configuration node and creating a new one changes the identity — in that case remove the old bridge from the Matter app and pair again.
 
+Use **Export** to download a complete backup of this bridge instance, including fabrics, private credentials, sessions and pairing data. **Protect the file like a password.** Import replaces this instance's storage and briefly restarts the bridge. A bridge backup cannot be imported into a controller.
+
 ## Notes
 
 - The Node-RED host must have **IPv6 link-local** enabled (standard Matter requirement) and be reachable from the controllers on the local network.

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

@@ -16,7 +16,10 @@
       "deploy_first": "Deploy this configuration node first, then click refresh.",
       "reset_button": "Reset pairing",
       "reset_confirm": "Remove ALL paired controllers and restart pairing? The devices will disappear from Alexa/Google/Apple.",
-      "reset_ok": "Pairing reset. The bridge is now advertising for pairing again."
+      "reset_ok": "Pairing reset. The bridge is now advertising for pairing again.",
+      "storage_title": "Fabric and commissioning backup", "storage_export": "Export", "storage_import": "Import",
+      "storage_warning": "The backup contains fabric credentials, private keys and pairing data. Keep it secret like a password. Import replaces this bridge's current Matter storage and briefly restarts it.",
+      "storage_import_confirm": "Replace this bridge's Matter fabrics and paired controllers with the selected backup?", "storage_import_ok": "Matter backup imported. The bridge has restarted."
     }
   }
 }

package/nodes/locales/es/knxUltimateMatterBridge.html

@@ -9,6 +9,8 @@ Cada nodo Expose KNX to Matter expone **un dispositivo KNX como dispositivo Matt
 
 Es la dirección opuesta al nodo *Matter Device*: allí KNX controla un dispositivo Matter, aquí los controladores Matter controlan KNX.
 
+Cambiar el tipo de dispositivo después de emparejar el bridge modifica la estructura del endpoint Matter. Los controladores pueden conservar el endpoint antiguo como no alcanzable; en ese caso, restablece/vuelve a emparejar el bridge o crea un nuevo dispositivo expuesto.
+
 ## Configuración
 
 |Campo|Descripción|

package/nodes/locales/es/knxUltimateMatterControllerDevice.html

@@ -15,6 +15,8 @@ Sustituye a los nodos Matter separados no publicados y conserva toda la UI de lu
 | Matter controller | Nodo de configuración Matter Controller donde el dispositivo fue emparejado. |
 | Dispositivo Matter | Endpoint Matter seleccionado entre los dispositivos emparejados. La UI se reconstruye a partir de sus capacidades reales. |
 | Switch / Enchufe / Luz On-Off | Direcciones de grupo de comando y estado On/Off, normalmente DPT `1.001`. |
+| Cerradura | Una GA de comando DPT `1.xxx` invoca `lockDoor` con `true` y `unlockDoor` con `false`; una GA de estado separada recibe solo estados Bloqueada/Desbloqueada inequívocos. Si el endpoint lo exige, el PIN remoto se guarda en el campo de credencial. Los comandos no anunciados se rechazan. |
+| Otros endpoints | Enchufes, actuadores On/Off, persianas, termostatos, ventiladores, sensores ambientales/de contacto/de ocupación, batería, potencia y energía usan el perfil multipropósito. La pestaña **Mapeos** contiene únicamente las funciones respaldadas por los clústeres, atributos y comandos anunciados. |
 | Controles de luz | Para endpoints de luz se usa la UI de luz completa: DIM relativo (DPT `3.007`), brillo %, RGB/HSV, blanco ajustable, brillo/temperatura al encender, modo día/noche, nivel min/max y velocidad de regulación. Las secciones no soportadas quedan ocultas. |
 | Sensores | Los endpoints de sensor muestran su GA de medida/estado solo cuando está soportado: temperatura, humedad, iluminancia, ocupación, contacto y batería. |
 | Read at startup | Publica el valor Matter en caché al desplegar/iniciar o cuando el dispositivo se reconecta. |

package/nodes/locales/es/knxUltimateMatterControllerDevice.json

@@ -17,10 +17,19 @@
       "tunable_white": "Blanco sintonizable",
       "rgb_hsv": "RGB/HSV",
       "effects": "Efectos",
+      "mappings": "Mapeos",
       "behaviour": "Comportamiento"
     },
     "control": "Control",
     "status": "Estado",
+    "door_lock_command": "Bloquear / desbloquear",
+    "door_lock_status": "Estado de la cerradura",
+    "door_lock_pin": "PIN de operación remota",
+    "door_lock_pin_required": "La cerradura indica que se requiere un PIN para operaciones remotas.",
+    "door_lock_commands_missing": "Este endpoint no anuncia ambos comandos de bloqueo y desbloqueo. Los comandos ausentes serán rechazados.",
+    "mapped": {
+      "onoff_command": "Comando Encendido / Apagado", "onoff_state": "Estado Encendido / Apagado", "cover_updown": "Persiana subir / bajar", "cover_stop": "Parar persiana", "cover_position_command": "Comando posición persiana", "cover_position_state": "Estado posición persiana", "heating_command": "Comando consigna calefacción", "heating_state": "Estado consigna calefacción", "cooling_command": "Comando consigna refrigeración", "cooling_state": "Estado consigna refrigeración", "local_temperature": "Temperatura local", "fan_command": "Comando velocidad ventilador", "fan_state": "Estado velocidad ventilador", "temperature": "Temperatura", "humidity": "Humedad", "illuminance": "Iluminancia", "occupancy": "Ocupación", "contact": "Estado booleano / contacto", "battery": "Batería", "active_power": "Potencia activa", "imported_energy": "Energía importada"
+    },
     "night_lighting": "Iluminación nocturna",
     "no_night_lighting": "Sin iluminación nocturna",
     "get_current": "Obtener",
@@ -82,6 +91,7 @@
     "effect_native_label": "Efectos nativos de tono",
     "matter_controller": "Controlador Matter",
     "matter_device": "Dispositivo Matter",
+    "device_type": "Tipo de dispositivo",
     "matter_section": "Dispositivo Matter"
   },
   "common": {

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

@@ -15,10 +15,14 @@ El controlador se comunica con los dispositivos a través de la **red IP** (WiFi
 
 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.
 
+Prefiere el payload QR (`MT:...`): contiene el discriminador completo. El código manual solo contiene el discriminador corto y puede seleccionar el dispositivo equivocado si hay varios modelos idénticos en modo de emparejamiento. Empareja un dispositivo cada vez.
+
 ## Almacenamiento
 
 Las credenciales de la fabric y los dispositivos emparejados se guardan en la carpeta `knxultimatestorage/matter` dentro del directorio de usuario de Node-RED. Borrar esa carpeta elimina todos los emparejamientos.
 
+Usa **Exportar** para descargar una copia completa de esta instancia del controlador. Incluye la fabric, credenciales privadas, sesiones y datos de dispositivos vinculados. **Protege el archivo como una contraseña.** La importación reemplaza el almacenamiento Matter de esta instancia y reinicia brevemente el controlador. Una copia de controlador no se puede importar en un bridge.
+
 ## 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).

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

@@ -2,7 +2,6 @@
   "matter-config": {
     "properties": {
       "title": "Controlador Matter",
-      "intro": "Este nodo es un controlador Matter (con su propia fabric). Empareja aquí tus dispositivos Matter y usa el nodo \"Matter Device\" para mapearlos a direcciones de grupo KNX. Haz deploy primero y vuelve aquí para emparejar dispositivos.",
       "node-config-input-name": "Nombre",
       "fabric_label": "Etiqueta de fabric",
       "pairing_title": "Emparejar un nuevo dispositivo",
@@ -24,7 +23,13 @@
       "pairing_ok": "¡Dispositivo emparejado correctamente!",
       "rename_button": "Renombrar",
       "rename_prompt": "Nuevo nombre del dispositivo",
-      "rename_ok": "Dispositivo renombrado."
+      "rename_ok": "Dispositivo renombrado.",
+      "storage_title": "Copia de fabric y vinculaciones",
+      "storage_export": "Exportar",
+      "storage_import": "Importar",
+      "storage_warning": "La copia contiene credenciales de fabric, claves privadas y datos de dispositivos vinculados. Protégela como una contraseña. La importación reemplaza el almacenamiento Matter de este controlador y lo reinicia brevemente.",
+      "storage_import_confirm": "¿Reemplazar la fabric Matter y los dispositivos vinculados de este controlador con la copia seleccionada?",
+      "storage_import_ok": "Copia Matter importada. El controlador se ha reiniciado."
     }
   }
 }

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

@@ -21,12 +21,16 @@ Este nodo de configuración es el **bridge Matter en sí**: ejecuta el servidor
 2. El panel de emparejamiento muestra el **código QR** y el **código manual**: escanéalo o escríbelo en Alexa / Google Home / Apple Home ("añadir dispositivo Matter").
 3. Se pueden emparejar varios controladores con el mismo bridge (multi-fabric Matter).
 
+Para añadir otro controlador cuando el código QR está oculto, abre el modo de emparejamiento desde un controlador ya vinculado y añade un dispositivo Matter en el nuevo controlador. Usa **Restablecer emparejamiento** solo para eliminar todos los controladores existentes y empezar de nuevo.
+
 El botón **Restablecer emparejamiento** elimina todos los controladores emparejados y reinicia el anuncio de emparejamiento.
 
 ## Identidad y almacenamiento
 
 La identidad del bridge está ligada a este nodo de configuración y se guarda en `knxultimatestorage/matter` dentro del directorio de usuario de Node-RED: los re-deploys (incluso cambiando puerto o nombre) **NO** requieren un nuevo emparejamiento. Solo borrar este nodo de configuración y crear uno nuevo cambia la identidad — en ese caso elimina el bridge antiguo de la app Matter y vuelve a emparejar.
 
+Usa **Exportar** para descargar una copia completa de esta instancia del bridge, con fabrics, credenciales privadas, sesiones y datos de vinculación. **Protege el archivo como una contraseña.** La importación reemplaza el almacenamiento de esta instancia y reinicia brevemente el bridge. Una copia de bridge no se puede importar en un controlador.
+
 ## Notas
 
 - El host de Node-RED debe tener **IPv6 link-local** habilitado (requisito estándar de Matter) y ser accesible desde los controladores en la red local.

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

@@ -16,7 +16,10 @@
       "deploy_first": "Haz deploy de este nodo de configuración primero y pulsa actualizar.",
       "reset_button": "Restablecer emparejamiento",
       "reset_confirm": "¿Eliminar TODOS los controladores emparejados y reiniciar el emparejamiento? Los dispositivos desaparecerán de Alexa/Google/Apple.",
-      "reset_ok": "Emparejamiento restablecido. El bridge vuelve a estar en espera de emparejamiento."
+      "reset_ok": "Emparejamiento restablecido. El bridge vuelve a estar en espera de emparejamiento.",
+      "storage_title": "Copia de fabric y vinculaciones", "storage_export": "Exportar", "storage_import": "Importar",
+      "storage_warning": "La copia contiene credenciales de fabric, claves privadas y datos de vinculación. Protégela como una contraseña. La importación reemplaza el almacenamiento Matter de este bridge y lo reinicia brevemente.",
+      "storage_import_confirm": "¿Reemplazar las fabrics Matter y los controladores vinculados de este bridge con la copia seleccionada?", "storage_import_ok": "Copia Matter importada. El bridge se ha reiniciado."
     }
   }
 }

package/nodes/locales/fr/knxUltimateMatterBridge.html

@@ -9,6 +9,8 @@ Chaque nœud Expose KNX to Matter expose **un appareil KNX comme appareil Matter
 
 C'est la direction opposée du nœud *Matter Device* : là-bas KNX contrôle un appareil Matter, ici les contrôleurs Matter contrôlent KNX.
 
+Changer le type d'appareil après l'appairage du bridge modifie la structure de l'endpoint Matter. Les contrôleurs peuvent conserver l'ancien endpoint comme injoignable ; dans ce cas, réinitialisez/réappairez le bridge ou créez un nouvel appareil exposé.
+
 ## Configuration
 
 |Champ|Description|

package/nodes/locales/fr/knxUltimateMatterControllerDevice.html

@@ -15,6 +15,8 @@ Il remplace les nœuds Matter séparés non publiés et conserve toute l'UI lumi
 | Matter controller | Nœud de configuration Matter Controller dans lequel le périphérique a été appairé. |
 | Appareil Matter | Endpoint Matter choisi parmi les appareils appairés. L'UI est reconstruite à partir de ses capacités réelles. |
 | Switch / Prise / Lumière On-Off | Adresses de groupe commande et état On/Off, généralement DPT `1.001`. |
+| Serrure | Une AG de commande DPT `1.xxx` appelle `lockDoor` avec `true` et `unlockDoor` avec `false` ; une AG d'état séparée reçoit uniquement les états Verrouillé/Déverrouillé non ambigus. Si nécessaire, le PIN distant est conservé dans le champ d'identification. Les commandes non annoncées sont refusées. |
+| Autres points de terminaison | Prises, actionneurs On/Off, volets, thermostats, ventilateurs, capteurs d'environnement/contact/occupation, batterie, puissance et énergie utilisent le profil polyvalent. L'onglet **Mappages** contient uniquement les fonctions prises en charge par les clusters, attributs et commandes annoncés. |
 | Contrôles lumière | Pour les endpoints lumière, l'UI lumière complète est utilisée : DIM relatif (DPT `3.007`), luminosité %, RGB/HSV, blanc réglable, luminosité/température à l'allumage, mode jour/nuit, niveau min/max et vitesse de variation. Les sections non supportées restent masquées. |
 | 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. |

package/nodes/locales/fr/knxUltimateMatterControllerDevice.json

@@ -17,10 +17,19 @@
       "tunable_white": "White à réglage réglable",
       "rgb_hsv": "RVB / HSV",
       "effects": "Effets",
+      "mappings": "Mappages",
       "behaviour": "Comportement"
     },
     "control": "Contrôle",
     "status": "Statut",
+    "door_lock_command": "Verrouiller / déverrouiller",
+    "door_lock_status": "État de la serrure",
+    "door_lock_pin": "PIN d'opération à distance",
+    "door_lock_pin_required": "Cette serrure indique qu'un PIN est requis pour les opérations à distance.",
+    "door_lock_commands_missing": "Ce point de terminaison n'annonce pas les deux commandes de verrouillage et déverrouillage. Les commandes absentes seront refusées.",
+    "mapped": {
+      "onoff_command": "Commande Marche / Arrêt", "onoff_state": "État Marche / Arrêt", "cover_updown": "Volet montée / descente", "cover_stop": "Arrêt volet", "cover_position_command": "Commande position volet", "cover_position_state": "État position volet", "heating_command": "Commande consigne chauffage", "heating_state": "État consigne chauffage", "cooling_command": "Commande consigne refroidissement", "cooling_state": "État consigne refroidissement", "local_temperature": "Température locale", "fan_command": "Commande vitesse ventilateur", "fan_state": "État vitesse ventilateur", "temperature": "Température", "humidity": "Humidité", "illuminance": "Éclairement", "occupancy": "Occupation", "contact": "État booléen / contact", "battery": "Batterie", "active_power": "Puissance active", "imported_energy": "Énergie importée"
+    },
     "night_lighting": "Éclairage nocturne",
     "no_night_lighting": "Pas d'éclairage de nuit",
     "get_current": "Prendre le courant",
@@ -74,6 +83,7 @@
     "effect_native_label": "Effets natifs de la teinte",
     "matter_controller": "Contrôleur Matter",
     "matter_device": "Appareil Matter",
+    "device_type": "Type d'appareil",
     "matter_section": "Appareil Matter"
   },
   "common": {

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

@@ -15,10 +15,14 @@ Le contrôleur communique avec les appareils via le **réseau IP** (WiFi, Ethern
 
 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.
 
+Préférez le payload QR (`MT:...`) : il contient le discriminateur complet. Le code manuel ne contient que le discriminateur court et peut sélectionner le mauvais appareil si plusieurs modèles identiques sont en mode appairage. Appairez un appareil à la fois.
+
 ## Stockage
 
 Les identifiants de la fabric et les appareils appairés sont enregistrés dans le dossier `knxultimatestorage/matter` du répertoire utilisateur de Node-RED. Supprimer ce dossier efface tous les appairages.
 
+Utilisez **Exporter** pour télécharger une sauvegarde complète de cette instance de contrôleur. Elle contient la fabric, les identifiants privés, les sessions et les données des appareils associés. **Protégez le fichier comme un mot de passe.** L'import remplace le stockage Matter de cette instance et redémarre brièvement le contrôleur. Une sauvegarde de contrôleur ne peut pas être importée dans un bridge.
+
 ## 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).

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

@@ -2,7 +2,6 @@
   "matter-config": {
     "properties": {
       "title": "Contrôleur Matter",
-      "intro": "Ce nœud est un contrôleur Matter (avec sa propre fabric). Appairez ici vos appareils Matter, puis utilisez le nœud \"Matter Device\" pour les mapper sur des adresses de groupe KNX. Déployez d'abord le nœud, puis revenez ici pour appairer les appareils.",
       "node-config-input-name": "Nom",
       "fabric_label": "Étiquette de fabric",
       "pairing_title": "Appairer un nouvel appareil",
@@ -24,7 +23,13 @@
       "pairing_ok": "Appareil appairé avec succès !",
       "rename_button": "Renommer",
       "rename_prompt": "Nouveau nom de l'appareil",
-      "rename_ok": "Appareil renommé."
+      "rename_ok": "Appareil renommé.",
+      "storage_title": "Sauvegarde de la fabric et des associations",
+      "storage_export": "Exporter",
+      "storage_import": "Importer",
+      "storage_warning": "La sauvegarde contient les identifiants de fabric, les clés privées et les données des appareils associés. Protégez-la comme un mot de passe. L'import remplace le stockage Matter de ce contrôleur et le redémarre brièvement.",
+      "storage_import_confirm": "Remplacer la fabric Matter et les appareils associés de ce contrôleur par la sauvegarde sélectionnée ?",
+      "storage_import_ok": "Sauvegarde Matter importée. Le contrôleur a redémarré."
     }
   }
 }

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

@@ -21,12 +21,16 @@ Ce nœud de configuration est le **bridge Matter lui-même** : il exécute le se
 2. Le panneau d'appairage montre le **QR code** et le **code manuel** : scannez ou saisissez-le dans Alexa / Google Home / Apple Home (« ajouter un appareil Matter »).
 3. Plusieurs contrôleurs peuvent être appairés au même bridge (multi-fabric Matter).
 
+Pour ajouter un contrôleur lorsque le QR code est masqué, ouvrez le mode d'appairage depuis un contrôleur déjà associé, puis ajoutez un appareil Matter dans le nouveau contrôleur. Utilisez **Réinitialiser l'appairage** uniquement pour supprimer tous les contrôleurs et recommencer.
+
 Le bouton **Réinitialiser l'appairage** supprime tous les contrôleurs appairés et relance l'annonce d'appairage.
 
 ## Identité et stockage
 
 L'identité du bridge est liée à ce nœud de configuration et enregistrée dans `knxultimatestorage/matter` du répertoire utilisateur de Node-RED : les re-deploys (même en changeant port ou nom) ne nécessitent **PAS** de nouvel appairage. Seule la suppression de ce nœud de configuration et la création d'un nouveau changent l'identité — dans ce cas supprimez l'ancien bridge de l'app Matter et appairez de nouveau.
 
+Utilisez **Exporter** pour télécharger une sauvegarde complète de cette instance du bridge, avec fabrics, identifiants privés, sessions et données d'association. **Protégez le fichier comme un mot de passe.** L'import remplace le stockage de cette instance et redémarre brièvement le bridge. Une sauvegarde de bridge ne peut pas être importée dans un contrôleur.
+
 ## Notes
 
 - L'hôte Node-RED doit avoir **IPv6 link-local** activé (exigence standard de Matter) et être joignable par les contrôleurs sur le réseau local.

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

@@ -16,7 +16,10 @@
       "deploy_first": "Déployez d'abord ce nœud de configuration, puis cliquez sur actualiser.",
       "reset_button": "Réinitialiser l'appairage",
       "reset_confirm": "Supprimer TOUS les contrôleurs appairés et relancer l'appairage ? Les appareils disparaîtront d'Alexa/Google/Apple.",
-      "reset_ok": "Appairage réinitialisé. Le bridge attend de nouveau un appairage."
+      "reset_ok": "Appairage réinitialisé. Le bridge attend de nouveau un appairage.",
+      "storage_title": "Sauvegarde de la fabric et des associations", "storage_export": "Exporter", "storage_import": "Importer",
+      "storage_warning": "La sauvegarde contient les identifiants de fabric, les clés privées et les données d'association. Protégez-la comme un mot de passe. L'import remplace le stockage Matter de ce bridge et le redémarre brièvement.",
+      "storage_import_confirm": "Remplacer les fabrics Matter et les contrôleurs associés de ce bridge par la sauvegarde sélectionnée ?", "storage_import_ok": "Sauvegarde Matter importée. Le bridge a redémarré."
     }
   }
 }

package/nodes/locales/it/knxUltimateMatterBridge.html

@@ -9,6 +9,8 @@ Ogni nodo Expose KNX to Matter espone **un dispositivo KNX come dispositivo Matt
 
 È la direzione opposta del nodo *Matter Device*: lì KNX controlla un dispositivo Matter, qui i controller Matter controllano KNX.
 
+Cambiare il tipo dispositivo dopo l'abbinamento del bridge modifica la struttura dell'endpoint Matter. I controller possono conservare il vecchio endpoint come irraggiungibile; in tal caso resetta/riabbina il bridge oppure crea un nuovo dispositivo esposto.
+
 ## Configurazione
 
 |Campo|Descrizione|

package/nodes/locales/it/knxUltimateMatterControllerDevice.html

@@ -15,6 +15,8 @@ Sostituisce i nodi Matter separati non pubblicati e mantiene tutta la UI luce qu
 | Matter controller | Nodo di configurazione Matter Controller in cui il dispositivo è stato associato. |
 | Dispositivo Matter | Endpoint Matter selezionato tra i dispositivi abbinati. La UI viene ricostruita in base alle capability reali. |
 | Switch / Presa / Luce On-Off | Indirizzi di gruppo di comando e stato On/Off, di solito DPT `1.001`. |
+| Serratura | Un GA comando DPT `1.xxx` invoca `lockDoor` con `true` e `unlockDoor` con `false`; un GA di stato separato riceve soltanto gli stati non ambigui Bloccata/Sbloccata. Se richiesto dall'endpoint, salva il PIN per operazioni remote nel campo credential. I comandi non annunciati dall'endpoint vengono rifiutati. |
+| Altri endpoint | Prese, attuatori On/Off, tapparelle, termostati, ventilatori, sensori ambientali/contatto/presenza, batteria, potenza ed energia usano il profilo multi-purpose. La TAB **Mappature** contiene soltanto le funzioni supportate dai cluster, attributi e comandi annunciati dall'endpoint; lascia vuoto un GA per disabilitarlo. |
 | Controlli luce | Per gli endpoint luce viene usata la stessa UI luce completa: DIM relativo (DPT `3.007`), luminosità %, RGB/HSV, bianco dinamico, luminosità/temperatura all'accensione, modalità giorno/notte, livello min/max e velocità dimmer. Le sezioni non supportate restano nascoste. |
 | 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. |

package/nodes/locales/it/knxUltimateMatterControllerDevice.json

@@ -17,10 +17,19 @@
       "tunable_white": "Bianco regolabile",
       "rgb_hsv": "RGB/HSV",
       "effects": "Effetti",
+      "mappings": "Mappature",
       "behaviour": "Comportamento"
     },
     "control": "Comando",
     "status": "Stato",
+    "door_lock_command": "Blocca / sblocca",
+    "door_lock_status": "Stato serratura",
+    "door_lock_pin": "PIN operazione remota",
+    "door_lock_pin_required": "La serratura indica che per le operazioni remote è richiesto un PIN.",
+    "door_lock_commands_missing": "L'endpoint non annuncia entrambi i comandi di blocco e sblocco. I comandi mancanti saranno rifiutati.",
+    "mapped": {
+      "onoff_command": "Comando On / Off", "onoff_state": "Stato On / Off", "cover_updown": "Tapparella su / giù", "cover_stop": "Stop tapparella", "cover_position_command": "Comando posizione tapparella", "cover_position_state": "Stato posizione tapparella", "heating_command": "Comando setpoint riscaldamento", "heating_state": "Stato setpoint riscaldamento", "cooling_command": "Comando setpoint raffrescamento", "cooling_state": "Stato setpoint raffrescamento", "local_temperature": "Temperatura locale", "fan_command": "Comando velocità ventilatore", "fan_state": "Stato velocità ventilatore", "temperature": "Temperatura", "humidity": "Umidità", "illuminance": "Illuminamento", "occupancy": "Presenza", "contact": "Stato booleano / contatto", "battery": "Batteria", "active_power": "Potenza attiva", "imported_energy": "Energia importata"
+    },
     "night_lighting": "Illuminazione notturna",
     "no_night_lighting": "Nessuna illuminazione notturna",
     "get_current": "Ottieni corrente",
@@ -82,6 +91,7 @@
     "effect_native_label": "Effetti nativi HUE",
     "matter_controller": "Controller Matter",
     "matter_device": "Dispositivo Matter",
+    "device_type": "Tipo dispositivo",
     "matter_section": "Dispositivo Matter"
   },
   "common": {

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

@@ -15,10 +15,14 @@ Il controller comunica con i dispositivi tramite la **rete IP** (WiFi, Ethernet,
 
 Se il dispositivo è nuovo di fabbrica e supporta solo il commissioning Bluetooth, associalo prima con l'app del produttore o con un altro controller Matter (Alexa, Google Home, Apple Home), poi usa la funzione **"condividi / abbina con altro hub"** di quel controller per generare un nuovo codice di abbinamento per KNX-Ultimate. In questo modo il dispositivo entra in più fabric contemporaneamente.
 
+Preferisci il payload QR (`MT:...`): contiene il discriminatore completo. Il codice manuale contiene solo quello corto e può selezionare il dispositivo sbagliato quando più modelli identici sono in modalità abbinamento. Associa un dispositivo alla volta.
+
 ## Archiviazione
 
 Le credenziali della fabric e i dispositivi associati sono salvati nella cartella `knxultimatestorage/matter` dentro la directory utente di Node-RED. Cancellando quella cartella si perdono tutte le associazioni.
 
+Usa **Esporta** per scaricare un backup completo di questa istanza controller. Include fabric, credenziali private, sessioni e dati dei dispositivi associati. **Proteggi il file come una password.** L'importazione sostituisce lo storage Matter di questa istanza e riavvia brevemente il controller. Un backup controller non può essere importato in un bridge.
+
 ## Rimuovere un dispositivo
 
 Usa il pulsante cestino nella lista dei dispositivi associati. Il controller prova a decommissionare correttamente il dispositivo; se non è raggiungibile, viene comunque rimosso dalla fabric (potrebbe poi servire un reset di fabbrica del dispositivo).

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

@@ -2,7 +2,6 @@
   "matter-config": {
     "properties": {
       "title": "Controller Matter",
-      "intro": "Questo nodo è un controller Matter (con una propria fabric). Associa qui i tuoi dispositivi Matter, poi usa il nodo \"Matter Device\" per mapparli sugli indirizzi di gruppo KNX. Fai prima il deploy del nodo, poi torna qui per associare i dispositivi.",
       "node-config-input-name": "Nome",
       "fabric_label": "Etichetta fabric",
       "pairing_title": "Associa un nuovo dispositivo",
@@ -25,7 +24,13 @@
       "pairing_hint": "Preferisci il QR code (MT:…): contiene il discriminatore completo del dispositivo. Il codice manuale contiene solo un discriminatore corto e non distingue in modo affidabile dispositivi identici (es. più Shelly dello stesso modello), rischiando di associare quello sbagliato o segnalarlo come già registrato. Registra un dispositivo alla volta; se è già associato altrove, fai prima un factory reset.",
       "rename_button": "Rinomina",
       "rename_prompt": "Nuovo nome dispositivo",
-      "rename_ok": "Dispositivo rinominato."
+      "rename_ok": "Dispositivo rinominato.",
+      "storage_title": "Backup fabric e associazioni",
+      "storage_export": "Esporta",
+      "storage_import": "Importa",
+      "storage_warning": "Il backup contiene credenziali fabric, chiavi private e dati dei dispositivi associati. Proteggilo come una password. L'importazione sostituisce lo storage Matter di questo controller e lo riavvia brevemente.",
+      "storage_import_confirm": "Sostituire la fabric Matter e i dispositivi associati di questo controller con il backup selezionato?",
+      "storage_import_ok": "Backup Matter importato. Il controller è stato riavviato."
     }
   }
 }

package/nodes/locales/it/matterbridge-config.html

@@ -21,12 +21,16 @@ Questo nodo di configurazione è il **bridge Matter vero e proprio**: esegue il
 2. Il pannello di abbinamento mostra il **QR code** e il **codice manuale**: scansiona o digita in Alexa / Google Home / Apple Home ("aggiungi dispositivo Matter").
 3. Più controller possono essere abbinati allo stesso bridge (multi-fabric Matter).
 
+Per aggiungere un altro controller quando il QR code è nascosto, apri la modalità di abbinamento da un controller già associato, poi aggiungi un dispositivo Matter nel nuovo controller. Usa **Reset abbinamento** solo per rimuovere tutti i controller esistenti e ripartire.
+
 Il pulsante **Reset abbinamento** rimuove tutti i controller abbinati e riavvia l'advertising di abbinamento.
 
 ## Identità e archiviazione
 
 L'identità del bridge è legata a questo nodo di configurazione ed è salvata in `knxultimatestorage/matter` nella directory utente di Node-RED: i re-deploy (anche cambiando porta o nome) **NON** richiedono un nuovo abbinamento. Solo eliminando questo nodo di configurazione e creandone uno nuovo cambia l'identità — in quel caso rimuovi il vecchio bridge dall'app Matter e riabbina.
 
+Usa **Esporta** per scaricare un backup completo di questa istanza bridge, incluse fabric, credenziali private, sessioni e dati di abbinamento. **Proteggi il file come una password.** L'importazione sostituisce lo storage dell'istanza e riavvia brevemente il bridge. Un backup bridge non può essere importato in un controller.
+
 ## Note
 
 - L'host Node-RED deve avere **IPv6 link-local** attivo (requisito standard Matter) ed essere raggiungibile dai controller sulla rete locale.

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

@@ -16,7 +16,10 @@
       "deploy_first": "Fai prima il deploy di questo nodo di configurazione, poi clicca aggiorna.",
       "reset_button": "Reset abbinamento",
       "reset_confirm": "Rimuovere TUTTI i controller abbinati e riavviare l'abbinamento? I dispositivi spariranno da Alexa/Google/Apple.",
-      "reset_ok": "Abbinamento resettato. Il bridge è di nuovo in attesa di abbinamento."
+      "reset_ok": "Abbinamento resettato. Il bridge è di nuovo in attesa di abbinamento.",
+      "storage_title": "Backup fabric e associazioni", "storage_export": "Esporta", "storage_import": "Importa",
+      "storage_warning": "Il backup contiene credenziali fabric, chiavi private e dati di abbinamento. Proteggilo come una password. L'importazione sostituisce lo storage Matter di questo bridge e lo riavvia brevemente.",
+      "storage_import_confirm": "Sostituire le fabric Matter e i controller abbinati di questo bridge con il backup selezionato?", "storage_import_ok": "Backup Matter importato. Il bridge è stato riavviato."
     }
   }
 }

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

@@ -9,6 +9,8 @@
 
 这与 *Matter Device* 节点方向相反：那里是 KNX 控制 Matter 设备，这里是 Matter 控制器控制 KNX。
 
+桥接器配对后更改设备类型会改变 Matter 端点结构。控制器可能会将旧端点保留为不可达；此时请重置并重新配对桥接器，或创建新的公开设备。
+
 ## 配置
 
 |字段|说明|

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

@@ -15,6 +15,8 @@
 | Matter controller | 设备已在其中配网的 Matter Controller 配置节点。 |
 | Matter device | 从已配对设备中选择的 Matter endpoint。UI 会根据真实能力重新构建。 |
 | Switch / 插座 / 灯 On-Off | On/Off 命令和状态组地址，通常使用 DPT `1.001`。 |
+| 门锁 | DPT `1.xxx` 命令组地址以 `true` 调用 `lockDoor`、以 `false` 调用 `unlockDoor`；独立状态组地址仅接收明确的已上锁/已解锁状态。如端点要求，远程操作 PIN 保存在凭据字段中。端点未声明的命令会被拒绝。 |
+| 其他端点 | 插座、开关执行器、窗帘、恒温器、风扇、环境/接点/占用传感器以及电池、功率和电能端点使用多用途映射配置。专用的 **映射** 选项卡仅包含端点实际声明的集群、属性和命令；组地址留空即可禁用。 |
 | 灯光控制 | 对灯光 endpoint 使用完整灯光 UI：相对调光（DPT `3.007`）、亮度百分比、RGB/HSV、色温、开灯亮度/温度、日/夜模式、最小/最大调光等级和调光速度。不支持的部分会隐藏。 |
 | 传感器 | 传感器 endpoint 只在支持时显示对应测量/状态 GA：温度、湿度、照度、占用、接触和电池。 |
 | Read at startup | 在部署/启动或设备重新连接时发布缓存的 Matter 值。 |

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

@@ -17,10 +17,19 @@
       "tunable_white": "可调白光",
       "rgb_hsv": "RGB/HSV",
       "effects": "效果",
+      "mappings": "映射",
       "behaviour": "行为"
     },
     "control": "控制",
     "status": "状态",
+    "door_lock_command": "上锁 / 解锁",
+    "door_lock_status": "门锁状态",
+    "door_lock_pin": "远程操作 PIN",
+    "door_lock_pin_required": "此门锁报告远程操作需要 PIN。",
+    "door_lock_commands_missing": "此端点未声明完整的上锁和解锁命令；缺失的命令将被拒绝。",
+    "mapped": {
+      "onoff_command": "开/关命令", "onoff_state": "开/关状态", "cover_updown": "窗帘上/下", "cover_stop": "窗帘停止", "cover_position_command": "窗帘位置命令", "cover_position_state": "窗帘位置状态", "heating_command": "制热设定值命令", "heating_state": "制热设定值状态", "cooling_command": "制冷设定值命令", "cooling_state": "制冷设定值状态", "local_temperature": "本地温度", "fan_command": "风扇速度命令", "fan_state": "风扇速度状态", "temperature": "温度", "humidity": "湿度", "illuminance": "照度", "occupancy": "占用", "contact": "布尔/接点状态", "battery": "电池", "active_power": "有功功率", "imported_energy": "输入电能"
+    },
     "night_lighting": "夜间照明",
     "no_night_lighting": "无夜间照明",
     "get_current": "获取当前",
@@ -74,6 +83,7 @@
     "effect_native_label": "Hue 原生效果",
     "matter_controller": "Matter 控制器",
     "matter_device": "Matter 设备",
+    "device_type": "设备类型",
     "matter_section": "Matter 设备"
   },
   "common": {

package/nodes/locales/zh-CN/matter-config.html

@@ -15,10 +15,14 @@
 
 如果设备是全新的且仅支持蓝牙配对，请先用厂商 App 或其他 Matter 控制器（Alexa、Google Home、Apple Home）配对，然后使用其**"与其他中枢共享/配对"**功能为 KNX-Ultimate 生成新的配对码。这样设备可以同时加入多个 fabric。
 
+优先使用二维码 payload（`MT:...`），因为它包含完整的鉴别码。手动配对码只包含短鉴别码；当多个相同型号同时处于配对模式时，可能会选错设备。请一次只配对一个设备。
+
 ## 存储
 
 Fabric 凭据和已配对设备保存在 Node-RED 用户目录下的 `knxultimatestorage/matter` 文件夹中。删除该文件夹将移除所有配对。
 
+使用 **导出** 下载此控制器实例的完整备份，其中包含 Fabric、私有凭据、会话和已配网设备数据。**请像密码一样保护此文件。** 导入会替换此实例当前的 Matter 存储并短暂重启控制器。控制器备份不能导入网桥。
+
 ## 移除设备
 
 使用已配对设备列表中的垃圾桶按钮。控制器会尝试正确地解除设备调试；如果设备无法访问，仍会从 fabric 中移除（之后可能需要对设备进行恢复出厂设置）。

package/nodes/locales/zh-CN/matter-config.json

@@ -2,7 +2,6 @@
   "matter-config": {
     "properties": {
       "title": "Matter 控制器",
-      "intro": "此节点是一个 Matter 控制器（拥有自己的 fabric）。在此配对您的 Matter 设备，然后使用 \"Matter Device\" 节点将其映射到 KNX 组地址。请先部署该节点，然后回到这里配对设备。",
       "node-config-input-name": "名称",
       "fabric_label": "Fabric 标签",
       "pairing_title": "配对新设备",
@@ -24,7 +23,13 @@
       "pairing_ok": "设备配对成功！",
       "rename_button": "重命名",
       "rename_prompt": "新的设备名称",
-      "rename_ok": "设备已重命名。"
+      "rename_ok": "设备已重命名。",
+      "storage_title": "Fabric 和配网备份",
+      "storage_export": "导出",
+      "storage_import": "导入",
+      "storage_warning": "备份包含 Fabric 凭据、私钥和已配网设备数据。请像密码一样妥善保管。导入会替换此控制器的 Matter 存储并短暂重启。",
+      "storage_import_confirm": "要用所选备份替换此控制器的 Matter Fabric 和已配网设备吗？",
+      "storage_import_ok": "Matter 备份已导入，控制器已重启。"
     }
   }
 }

package/nodes/locales/zh-CN/matterbridge-config.html

@@ -21,12 +21,16 @@
 2. 配对面板显示**二维码**和**手动配对码**：在 Alexa / Google Home / Apple Home 中扫描或输入（"添加 Matter 设备"）。
 3. 多个控制器可以与同一个桥接器配对（Matter 多 fabric）。
 
+二维码隐藏后如需添加其他控制器，请从一个已配对的控制器开启配对模式，然后在新控制器中添加 Matter 设备。仅在需要移除所有现有控制器并重新开始时使用**重置配对**。
+
 **重置配对**按钮会移除所有已配对的控制器并重新开始配对广播。
 
 ## 身份与存储
 
 桥接器身份与此配置节点绑定，保存在 Node-RED 用户目录的 `knxultimatestorage/matter` 中：重新部署（即使更改端口或名称）**不**需要重新配对。只有删除此配置节点并新建一个才会改变身份——此时请从 Matter App 中移除旧桥接器并重新配对。
 
+使用 **导出** 下载此网桥实例的完整备份，其中包含 Fabric、私有凭据、会话和配对数据。**请像密码一样保护此文件。** 导入会替换此实例的存储并短暂重启网桥。网桥备份不能导入控制器。
+
 ## 说明
 
 - Node-RED 主机必须启用 **IPv6 link-local**（Matter 标准要求），并且控制器可在本地网络访问到它。