node-red-contrib-knx-ultimate 6.0.4 → 6.0.6

package/nodes/locales/en/knxUltimateMatterBridge.html

@@ -9,6 +9,8 @@ Each Expose KNX to Matter node exposes **one KNX device as a Matter device**: th
 
 This is the opposite direction of the *Matter Device* node: there KNX controls a Matter device, here the Matter controllers control KNX.
 
+Changing the device type after the bridge has been paired changes the Matter endpoint structure. Controllers may keep the old endpoint as unreachable; in that case reset/re-pair the bridge or create a new exposed device.
+
 ## Configuration
 
 |Field|Description|
@@ -28,7 +30,7 @@ This is the opposite direction of the *Matter Device* node: there KNX controls a
 | RGB color light | + RGB color command/status GA (DPT 232.600). The Matter color (hue/saturation or XY, from the app color wheel) is converted to/from the KNX RGB triplet |
 | Tunable white light | + Color temperature command/status GA in Kelvin (DPT 7.600) |
 | Cover / Shutter | Up/Down (DPT 1.008), Stop (DPT 1.017), Position % command/status (DPT 5.001), optional position inversion |
-| Thermostat (heating) | Current temperature GA, Setpoint command/status GA (DPT 9.001) |
+| Thermostat (heating and/or cooling) | Current temperature GA, Setpoint command/status GA (DPT 9.001). Optionally add a Cooling setpoint command/status GA to also expose a Cool mode (dual-setpoint) |
 | Fan / Ventilation | Fan speed % command/status GA (DPT 5.001) |
 | Sensors (temperature, humidity, light, occupancy, contact) | One status GA each |
 | Smoke/CO alarm | Smoke alarm status GA + optional CO alarm status GA (DPT 1.005): critical notifications on the phone |
@@ -41,7 +43,7 @@ This is the opposite direction of the *Matter Device* node: there KNX controls a
 
 ## Advanced compatibility
 
-These options are hidden unless they apply to the selected type. Dimmable devices can ignore the brightness command that some controllers send immediately after `On`. Covers can optimistically update the Matter position after a command, then correct it when the KNX status GA reports the real position.
+These options are hidden unless they apply to the selected type. Dimmable devices can ignore the brightness command that some controllers send immediately after `On`. For covers, **Swap Open / Close** reverses both the binary KNX command and percentage direction. **Cover slider debounce** coalesces rapid intermediate targets before writing to KNX: `0` uses adaptive windows (400 ms for the first command, 150 ms for subsequent commands); `1`–`5000` forces one fixed window. Covers can also optimistically update the Matter position after a command, then correct it when the KNX status GA reports the real position.
 
 ## Node PINs
 

package/nodes/locales/en/knxUltimateMatterBridge.json

@@ -17,24 +17,25 @@
       "name_placeholder": "e.g. Kitchen light",
       "invert": "Invert position %"
     },
-  "advanced": {
+    "advanced": {
       "title": "Advanced compatibility",
       "help": " Use these options only when a Matter controller or a KNX actuator needs special handling.",
+      "alexa_dedup_ms": "Alexa duplicate-command window (ms, 0 = off)",
       "turn_on_behavior": "Turn-on behavior",
       "turn_on_ignore_level": "Ignore brightness sent immediately after On",
       "turn_on_forward_all": "Forward every brightness command",
-    "ignore_level_ms": "Ignore brightness after On (ms)",
-    "cover_expose_as_light": "Expose cover as a dimmable light (Alexa workaround)",
-    "cover_expose_as_light_help": "Use only if Alexa cannot set the cover percentage. Brightness represents how open the cover is; KNX group addresses remain unchanged.",
+      "ignore_level_ms": "Ignore brightness after On (ms)",
+      "cover_swap_open_close": "Swap cover Open / Close",
+      "cover_slider_debounce": "Cover slider debounce (ms, 0 = adaptive)",
       "cover_update_mode": "Cover state update",
       "cover_optimistic": "Optimistically update Matter position",
       "cover_wait_status": "Wait for KNX status only",
-    "cover_status_timeout": "Cover status timeout (ms)"
-  },
-  "tabs": {
-    "mappings": "KNX mappings",
-    "advanced": "Advanced options"
-  },
+      "cover_status_timeout": "Cover status timeout (ms)"
+    },
+    "tabs": {
+      "mappings": "KNX mappings",
+      "advanced": "Advanced options"
+    },
     "functions": {
       "fn_onoff_cmd": "On/Off command GA",
       "fn_onoff_status": "On/Off status GA",
@@ -48,6 +49,8 @@
       "fn_currenttemp": "Current temperature GA",
       "fn_setpoint_cmd": "Setpoint command GA",
       "fn_setpoint_status": "Setpoint status GA",
+      "fn_coolingsetpoint_cmd": "Cooling setpoint command GA",
+      "fn_coolingsetpoint_status": "Cooling setpoint status GA",
       "fn_rgb_cmd": "RGB color command GA (DPT 232.600)",
       "fn_rgb_status": "RGB color status GA (DPT 232.600)",
       "fn_ct_cmd": "Color temperature command GA (Kelvin)",

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|
@@ -28,7 +30,7 @@ Es la dirección opuesta al nodo *Matter Device*: allí KNX controla un disposit
 | Luz RGB (color) | + GA comando/estado color RGB (DPT 232.600). El color Matter (hue/saturation o XY, de la rueda de color de la app) se convierte desde/hacia la terna RGB KNX |
 | Luz blanco dinámico | + GA comando/estado temperatura de color en Kelvin (DPT 7.600) |
 | Persiana / Cortina | Subir/Bajar (DPT 1.008), Stop (DPT 1.017), posición % comando/estado (DPT 5.001), inversión de posición opcional |
-| Termostato (calefacción) | GA temperatura actual, GA comando/estado consigna (DPT 9.001) |
+| Termostato (calefacción y/o refrigeración) | GA temperatura actual, GA comando/estado consigna (DPT 9.001). Añadiendo también la GA comando/estado consigna de refrigeración se expone también el modo Cool (doble consigna) |
 | Ventilador / VMC | GA comando/estado velocidad % (DPT 5.001) |
 | Sensores (temperatura, humedad, luz, presencia, contacto) | Una GA de estado cada uno |
 | Alarma humo/CO | GA estado alarma de humo + GA estado alarma CO opcional (DPT 1.005): notificaciones críticas en el teléfono |
@@ -41,7 +43,7 @@ Es la dirección opuesta al nodo *Matter Device*: allí KNX controla un disposit
 
 ## Compatibilidad avanzada
 
-Estas opciones solo aparecen cuando tienen sentido para el tipo seleccionado. Los dispositivos regulables pueden ignorar el comando de brillo que algunos controladores envían justo después de `On`. Las persianas pueden actualizar de forma optimista la posición Matter tras un comando y corregirla cuando la GA de estado KNX informa la posición real.
+Estas opciones solo aparecen cuando tienen sentido para el tipo seleccionado. Los dispositivos regulables pueden ignorar el brillo enviado justo después de `On`. Para persianas, **Intercambiar Abrir / Cerrar** invierte el comando KNX binario y la dirección porcentual. **Antirrebote del deslizador** agrupa objetivos intermedios rápidos antes de escribir en KNX: `0` usa ventanas adaptativas (400 ms para el primer comando y 150 ms para los siguientes); `1`–`5000` fuerza una ventana fija. La posición Matter también puede actualizarse de forma optimista y corregirse después mediante la GA de estado KNX.
 
 ## PINes del nodo
 

package/nodes/locales/es/knxUltimateMatterBridge.json

@@ -17,24 +17,25 @@
       "name_placeholder": "p.ej. Luz cocina",
       "invert": "Invertir posición %"
     },
-  "advanced": {
+    "advanced": {
       "title": "Compatibilidad avanzada",
       "help": " Usa estas opciones solo cuando un controlador Matter o un actuador KNX necesite un tratamiento especial.",
+      "alexa_dedup_ms": "Ventana anti-duplicados Alexa (ms, 0 = off)",
       "turn_on_behavior": "Comportamiento al encender",
       "turn_on_ignore_level": "Ignorar brillo enviado justo después de On",
       "turn_on_forward_all": "Reenviar cada comando de brillo",
-    "ignore_level_ms": "Ignorar brillo tras On (ms)",
-    "cover_expose_as_light": "Exponer persiana como luz regulable (solución para Alexa)",
-    "cover_expose_as_light_help": "Úsalo solo si Alexa no puede ajustar el porcentaje de la persiana. El brillo representa cuánto está abierta; las direcciones de grupo KNX no cambian.",
+      "ignore_level_ms": "Ignorar brillo tras On (ms)",
+      "cover_swap_open_close": "Intercambiar Abrir / Cerrar persiana",
+      "cover_slider_debounce": "Antirrebote del deslizador (ms, 0 = adaptativo)",
       "cover_update_mode": "Actualización de estado de persiana",
       "cover_optimistic": "Actualizar la posición Matter de forma optimista",
       "cover_wait_status": "Esperar solo el estado KNX",
-    "cover_status_timeout": "Timeout estado persiana (ms)"
-  },
-  "tabs": {
-    "mappings": "Asignaciones KNX",
-    "advanced": "Opciones avanzadas"
-  },
+      "cover_status_timeout": "Timeout estado persiana (ms)"
+    },
+    "tabs": {
+      "mappings": "Asignaciones KNX",
+      "advanced": "Opciones avanzadas"
+    },
     "functions": {
       "fn_onoff_cmd": "GA comando On/Off",
       "fn_onoff_status": "GA estado On/Off",
@@ -48,6 +49,8 @@
       "fn_currenttemp": "GA temperatura actual",
       "fn_setpoint_cmd": "GA comando consigna",
       "fn_setpoint_status": "GA estado consigna",
+      "fn_coolingsetpoint_cmd": "GA comando consigna refrigeración",
+      "fn_coolingsetpoint_status": "GA estado consigna refrigeración",
       "fn_rgb_cmd": "GA comando color RGB (DPT 232.600)",
       "fn_rgb_status": "GA estado color RGB (DPT 232.600)",
       "fn_ct_cmd": "GA comando temperatura de color (Kelvin)",

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|
@@ -28,7 +30,7 @@ C'est la direction opposée du nœud *Matter Device* : là-bas KNX contrôle un
 | Lumière RGB (couleur) | + GA commande/état couleur RGB (DPT 232.600). La couleur Matter (hue/saturation ou XY, depuis la roue de couleur de l'app) est convertie depuis/vers le triplet RGB KNX |
 | Lumière blanc dynamique | + GA commande/état température de couleur en Kelvin (DPT 7.600) |
 | Volet / Store | Monter/Descendre (DPT 1.008), Stop (DPT 1.017), position % commande/état (DPT 5.001), inversion de position optionnelle |
-| Thermostat (chauffage) | GA température actuelle, GA commande/état consigne (DPT 9.001) |
+| Thermostat (chauffage et/ou rafraîchissement) | GA température actuelle, GA commande/état consigne (DPT 9.001). En ajoutant aussi la GA commande/état consigne rafraîchissement, le mode Cool (double consigne) est également exposé |
 | Ventilateur / VMC | GA commande/état vitesse % (DPT 5.001) |
 | Capteurs (température, humidité, lumière, présence, contact) | Une GA d'état chacun |
 | Détecteur fumée/CO | GA état alarme fumée + GA état alarme CO optionnelle (DPT 1.005) : notifications critiques sur le téléphone |
@@ -41,7 +43,7 @@ C'est la direction opposée du nœud *Matter Device* : là-bas KNX contrôle un
 
 ## Compatibilité avancée
 
-Ces options ne s'affichent que lorsqu'elles s'appliquent au type sélectionné. Les appareils variables peuvent ignorer la commande de luminosité que certains contrôleurs envoient juste après `On`. Les volets peuvent mettre à jour la position Matter de façon optimiste après une commande, puis la corriger quand la GA d'état KNX rapporte la position réelle.
+Ces options ne s'affichent que lorsqu'elles s'appliquent au type sélectionné. Les appareils variables peuvent ignorer la luminosité envoyée juste après `On`. Pour les volets, **Permuter Ouvrir / Fermer** inverse la commande KNX binaire et le sens du pourcentage. **Anti-rebond curseur volet** regroupe les cibles intermédiaires rapides avant l'écriture KNX : `0` utilise des fenêtres adaptatives (400 ms pour la première commande, 150 ms pour les suivantes) ; `1`–`5000` impose une fenêtre fixe. La position Matter peut aussi être mise à jour de façon optimiste puis corrigée par la GA d'état KNX.
 
 ## PIN du nœud
 

package/nodes/locales/fr/knxUltimateMatterBridge.json

@@ -17,24 +17,25 @@
       "name_placeholder": "ex. Lumière cuisine",
       "invert": "Inverser la position %"
     },
-  "advanced": {
+    "advanced": {
       "title": "Compatibilité avancée",
       "help": " Utilisez ces options seulement lorsqu'un contrôleur Matter ou un actionneur KNX demande un traitement spécial.",
+      "alexa_dedup_ms": "Fenêtre anti-doublons Alexa (ms, 0 = off)",
       "turn_on_behavior": "Comportement à l'allumage",
       "turn_on_ignore_level": "Ignorer la luminosité envoyée juste après On",
       "turn_on_forward_all": "Transmettre chaque commande de luminosité",
-    "ignore_level_ms": "Ignorer la luminosité après On (ms)",
-    "cover_expose_as_light": "Exposer le volet comme lumière variable (contournement Alexa)",
-    "cover_expose_as_light_help": "À utiliser seulement si Alexa ne règle pas le pourcentage du volet. La luminosité représente son ouverture ; les adresses de groupe KNX restent inchangées.",
+      "ignore_level_ms": "Ignorer la luminosité après On (ms)",
+      "cover_swap_open_close": "Permuter Ouvrir / Fermer le volet",
+      "cover_slider_debounce": "Anti-rebond curseur volet (ms, 0 = adaptatif)",
       "cover_update_mode": "Mise à jour état volet",
       "cover_optimistic": "Mettre à jour la position Matter de façon optimiste",
       "cover_wait_status": "Attendre seulement l'état KNX",
-    "cover_status_timeout": "Timeout état volet (ms)"
-  },
-  "tabs": {
-    "mappings": "Mappages KNX",
-    "advanced": "Options avancées"
-  },
+      "cover_status_timeout": "Timeout état volet (ms)"
+    },
+    "tabs": {
+      "mappings": "Mappages KNX",
+      "advanced": "Options avancées"
+    },
     "functions": {
       "fn_onoff_cmd": "GA commande On/Off",
       "fn_onoff_status": "GA état On/Off",
@@ -48,6 +49,8 @@
       "fn_currenttemp": "GA température actuelle",
       "fn_setpoint_cmd": "GA commande consigne",
       "fn_setpoint_status": "GA état consigne",
+      "fn_coolingsetpoint_cmd": "GA commande consigne rafraîchissement",
+      "fn_coolingsetpoint_status": "GA état consigne rafraîchissement",
       "fn_rgb_cmd": "GA commande couleur RGB (DPT 232.600)",
       "fn_rgb_status": "GA état couleur RGB (DPT 232.600)",
       "fn_ct_cmd": "GA commande température de couleur (Kelvin)",

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|
@@ -28,7 +30,7 @@ Ogni nodo Expose KNX to Matter espone **un dispositivo KNX come dispositivo Matt
 | Luce RGB (colore) | + GA comando/stato colore RGB (DPT 232.600). Il colore Matter (hue/saturation o XY, dalla ruota colore dell'app) viene convertito da/verso la terna RGB KNX |
 | Luce bianco dinamico | + GA comando/stato temperatura colore in Kelvin (DPT 7.600) |
 | Tapparella / Tenda | Su/Giù (DPT 1.008), Stop (DPT 1.017), posizione % comando/stato (DPT 5.001), inversione posizione opzionale |
-| Termostato (riscaldamento) | GA temperatura attuale, GA comando/stato setpoint (DPT 9.001) |
+| Termostato (riscaldamento e/o raffrescamento) | GA temperatura attuale, GA comando/stato setpoint (DPT 9.001). Aggiungendo anche il GA comando/stato setpoint raffrescamento si espone anche la modalità Cool (doppio setpoint) |
 | Ventola / VMC | GA comando/stato velocità % (DPT 5.001) |
 | Sensori (temperatura, umidità, luminosità, presenza, contatto) | Un GA di stato ciascuno |
 | Rilevatore fumo/CO | GA stato allarme fumo + GA stato allarme CO opzionale (DPT 1.005): notifiche critiche sul telefono |
@@ -41,7 +43,7 @@ Ogni nodo Expose KNX to Matter espone **un dispositivo KNX come dispositivo Matt
 
 ## Compatibilità avanzata
 
-Queste opzioni sono nascoste finché non servono al tipo selezionato. I dispositivi dimmerabili possono ignorare il comando luminosità che alcuni controller inviano subito dopo `On`. Le tapparelle possono aggiornare ottimisticamente la posizione Matter dopo un comando, poi correggerla quando arriva la posizione reale dalla GA di stato KNX.
+Queste opzioni sono nascoste finché non servono al tipo selezionato. I dispositivi dimmerabili possono ignorare il comando luminosità che alcuni controller inviano subito dopo `On`. Per le tapparelle, **Scambia Apri / Chiudi** inverte sia il comando KNX binario sia la direzione percentuale. **Debounce slider tapparella** accorpa i target intermedi rapidi prima della scrittura KNX: `0` usa finestre adattive (400 ms per il primo comando, 150 ms per i successivi); `1`–`5000` imposta una finestra fissa. Le tapparelle possono inoltre aggiornare ottimisticamente la posizione Matter e correggerla quando arriva la posizione reale dalla GA di stato KNX.
 
 ## PIN del nodo
 

package/nodes/locales/it/knxUltimateMatterBridge.json

@@ -17,24 +17,25 @@
       "name_placeholder": "es. Luce cucina",
       "invert": "Inverti posizione %"
     },
-  "advanced": {
+    "advanced": {
       "title": "Compatibilità avanzata",
       "help": " Usa queste opzioni solo quando un controller Matter o un attuatore KNX richiede una gestione speciale.",
+      "alexa_dedup_ms": "Finestra anti-duplicati Alexa (ms, 0 = off)",
       "turn_on_behavior": "Comportamento all'accensione",
       "turn_on_ignore_level": "Ignora luminosità inviata subito dopo On",
       "turn_on_forward_all": "Inoltra ogni comando luminosità",
-    "ignore_level_ms": "Ignora luminosità dopo On (ms)",
-    "cover_expose_as_light": "Esponi tapparella come luce dimmerabile (workaround Alexa)",
-    "cover_expose_as_light_help": "Usa questa opzione solo se Alexa non imposta la percentuale della tapparella. La luminosità indica quanto è aperta; gli indirizzi di gruppo KNX non cambiano.",
+      "ignore_level_ms": "Ignora luminosità dopo On (ms)",
+      "cover_swap_open_close": "Scambia Apri / Chiudi tapparella",
+      "cover_slider_debounce": "Debounce slider tapparella (ms, 0 = adattivo)",
       "cover_update_mode": "Aggiornamento stato tapparella",
       "cover_optimistic": "Aggiorna ottimisticamente la posizione Matter",
       "cover_wait_status": "Attendi solo lo stato KNX",
-    "cover_status_timeout": "Timeout stato tapparella (ms)"
-  },
-  "tabs": {
-    "mappings": "Mappature KNX",
-    "advanced": "Opzioni avanzate"
-  },
+      "cover_status_timeout": "Timeout stato tapparella (ms)"
+    },
+    "tabs": {
+      "mappings": "Mappature KNX",
+      "advanced": "Opzioni avanzate"
+    },
     "functions": {
       "fn_onoff_cmd": "GA comando On/Off",
       "fn_onoff_status": "GA stato On/Off",
@@ -48,6 +49,8 @@
       "fn_currenttemp": "GA temperatura attuale",
       "fn_setpoint_cmd": "GA comando setpoint",
       "fn_setpoint_status": "GA stato setpoint",
+      "fn_coolingsetpoint_cmd": "GA comando setpoint raffrescamento",
+      "fn_coolingsetpoint_status": "GA stato setpoint raffrescamento",
       "fn_rgb_cmd": "GA comando colore RGB (DPT 232.600)",
       "fn_rgb_status": "GA stato colore RGB (DPT 232.600)",
       "fn_ct_cmd": "GA comando temperatura colore (Kelvin)",

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."
     }
   }
 }