node-red-contrib-knx-ultimate 5.0.4 → 5.2.2

package/nodes/locales/es/knxUltimateMatterDevice.html

@@ -0,0 +1,56 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterDevice">
+# Dispositivo Matter (BETA)
+
+> Este nodo está en **BETA**: funciona, pero algunos detalles pueden cambiar entre versiones.
+
+## Descripción general
+
+El nodo Matter Device hace de puente entre un **dispositivo Matter** y las **direcciones de grupo KNX**. El nodo opera a través del nodo de configuración *Controlador Matter*, que comisiona los dispositivos en su propia fabric Matter.
+
+- **Controla** cualquier dispositivo Matter emparejado desde el bus KNX (on/off, regulación, persianas, termostatos, cerraduras, ...).
+- **Sigue** cada atributo del dispositivo en direcciones de grupo KNX (estados, sensores, medición de potencia, batería...).
+- Totalmente genérico: la lista de mapeos se construye a partir de los **endpoints/clústeres reales** que expone el dispositivo.
+
+## Configuración
+
+|Campo|Descripción|
+|--|--|
+| GW KNX | Gateway KNX usado para los telegramas |
+| Ctrl Matter | El nodo de configuración Controlador Matter (donde se emparejan los dispositivos) |
+| Dispositivo | Elige el dispositivo Matter emparejado desde el autocompletado |
+| Mapeos | Una fila por cada mapeo dirección de grupo ↔ clúster Matter |
+| Leer estado al inicio | Si está activo, el nodo emite los valores actuales en caché al hacer deploy/conectar |
+| PINes de entrada/salida | Habilita los pines de Node-RED para el acceso Matter en bruto |
+
+## Mapeos
+
+La lista de destinos muestra las funciones soportadas con nombres comprensibles como *"Interruptor On/Off"* o *"Potencia instantánea (W)"*, filtradas según lo que el dispositivo realmente expone y con el valor actual entre corchetes.
+
+Cada fila de mapeo tiene una **dirección**:
+
+- **KNX → Matter (comando)**: un telegrama recibido en la dirección de grupo invoca un comando del clúster Matter o escribe un atributo. Ejemplo: GA `1/1/1` DPT 1.001 → `OnOff.on/off` (el valor booleano elige automáticamente on u off).
+- **Matter → KNX (estado)**: cuando cambia el atributo Matter suscrito, su valor se convierte y se escribe en la dirección de grupo. Las peticiones `GroupValue_Read` se responden con el valor en caché.
+
+Los clústeres más comunes se convierten automáticamente en valores aptos para KNX:
+
+|Clúster|Conversión|
+|--|--|
+| OnOff | booleano (DPT 1.001) |
+| LevelControl | 0-254 ↔ porcentaje (DPT 5.001) |
+| WindowCovering | percent100ths ↔ porcentaje (DPT 5.001), subir/bajar (DPT 1.008) |
+| ColorControl | mireds ↔ Kelvin (DPT 7.600) |
+| Thermostat | centi-°C ↔ °C (DPT 9.001) |
+| Temperatura/Humedad | centi-unidades ↔ unidades (DPT 9.001/9.007) |
+| Iluminancia | escala logarítmica ↔ Lux (DPT 9.004) |
+| PowerSource | medio-porcentaje ↔ porcentaje de batería (DPT 5.001) |
+| Potencia/Energía eléctrica | mW ↔ W (DPT 14.056), mWh ↔ kWh (DPT 13.013) |
+
+Los demás clústeres/atributos pasan sin conversión; el DPT elegido realiza la codificación KNX final.
+
+## PINes del nodo
+
+Si habilitas los PINes del nodo:
+
+- **Entrada**: envía comandos en bruto: `msg.payload = { endpointId: 1, clusterId: 6, command: "toggle" }` o escrituras de atributos: `msg.payload = { endpointId: 1, clusterId: 8, attribute: "onLevel", value: 128 }`
+- **Salida**: recibe cada cambio de atributo (`msg.matter` contiene el evento completo) y cada evento de clúster (pulsaciones de botones, etc.).
+</script>

package/nodes/locales/es/knxUltimateMatterDevice.json

@@ -0,0 +1,109 @@
+{
+  "knxUltimateMatterDevice": {
+    "title": "Dispositivo Matter (BETA)",
+    "paletteLabel": "Matter Device (BETA)",
+    "matter_controller": "Ctrl Matter",
+    "matter_device": "Dispositivo",
+    "device_placeholder": "Haz clic para elegir un dispositivo Matter emparejado",
+    "mapping_help": "Añade una fila por cada mapeo. \"KNX → Matter\" invoca un comando del clúster (o escribe un atributo) cuando llega un telegrama a la dirección de grupo. \"Matter → KNX\" escribe el valor del atributo en la dirección de grupo cada vez que cambia (las peticiones de lectura se responden con el valor en caché).",
+    "select_target": "-- selecciona el destino Matter --",
+    "stored_target": "Guardado",
+    "read_status_startup": "Leer estado al inicio",
+    "opt_yes_emit": "Sí, y emitir telegramas KNX.",
+    "opt_no": "No",
+    "node_pins": "PINes de entrada/salida del nodo",
+    "node_pins_hide": "Ocultar",
+    "node_pins_show": "Mostrar PINes de entrada/salida",
+    "direction": {
+      "command": "KNX → Matter (comando)",
+      "status": "Matter → KNX (estado)"
+    },
+    "fields": {
+      "direction": "Dirección",
+      "target": "Endpoint / clúster / destino Matter",
+      "ga": "Dirección de grupo",
+      "dpt": "DPT",
+      "ganame": "Nombre"
+    },
+    "no_simple_targets": "No se encontraron funciones compatibles en este dispositivo (o el dispositivo aún no está conectado).",
+    "endpoint": "Endpoint",
+    "friendly": {
+      "onoff_switch": "Interruptor On/Off (encender/apagar)",
+      "onoff_toggle": "Invertir estado (toggle)",
+      "onoff_state": "Estado On/Off",
+      "level_set": "Ajustar brillo / nivel (%)",
+      "level_state": "Brillo / nivel actual (%)",
+      "colortemp_set": "Ajustar temperatura de color (Kelvin)",
+      "colortemp_state": "Temperatura de color actual (Kelvin)",
+      "cover_updown": "Persiana Subir/Bajar",
+      "cover_stop": "Persiana Stop",
+      "cover_position_set": "Mover persiana a posición (%)",
+      "cover_position_state": "Posición actual de la persiana (%)",
+      "cover_tilt_set": "Inclinar lamas (%)",
+      "cover_tilt_state": "Inclinación actual de lamas (%)",
+      "thermo_localtemp": "Temperatura ambiente (°C)",
+      "thermo_heatsp_set": "Ajustar consigna calefacción (°C)",
+      "thermo_coolsp_set": "Ajustar consigna refrigeración (°C)",
+      "thermo_heatsp_state": "Consigna calefacción (°C)",
+      "thermo_coolsp_state": "Consigna refrigeración (°C)",
+      "fan_speed_set": "Ajustar velocidad ventilador (%)",
+      "fan_speed_state": "Velocidad actual ventilador (%)",
+      "lock_cmd": "Bloquear/Desbloquear cerradura",
+      "lock_state": "Estado cerradura (bloqueada)",
+      "temp_measured": "Temperatura medida (°C)",
+      "humidity_measured": "Humedad relativa (%)",
+      "illuminance_measured": "Iluminancia (Lux)",
+      "occupancy_state": "Presencia detectada",
+      "contact_state": "Estado contacto (cerrado/abierto)",
+      "battery_percent": "Nivel de batería (%)",
+      "power_active": "Potencia instantánea (W)",
+      "power_voltage": "Tensión (V)",
+      "power_current": "Corriente (A)",
+      "energy_imported": "Energía consumida (kWh)",
+      "identify_cmd": "Identificar dispositivo (parpadeo)",
+      "switch_position": "Posición del botón"
+    },
+    "devtype": {
+      "onofflight": "Luz On/Off",
+      "dimmablelight": "Luz regulable",
+      "colortemperaturelight": "Luz de temperatura de color",
+      "extendedcolorlight": "Luz de color",
+      "onoffpluginunit": "Enchufe (on/off)",
+      "dimmablepluginunit": "Enchufe (regulable)",
+      "smartplug": "Enchufe inteligente",
+      "contactsensor": "Sensor de contacto",
+      "lightsensor": "Sensor de luz",
+      "occupancysensor": "Sensor de presencia",
+      "temperaturesensor": "Sensor de temperatura",
+      "humiditysensor": "Sensor de humedad",
+      "pressuresensor": "Sensor de presión",
+      "flowsensor": "Sensor de caudal",
+      "doorlock": "Cerradura",
+      "windowcovering": "Persiana/Cortina",
+      "thermostat": "Termostato",
+      "fan": "Ventilador",
+      "genericswitch": "Botón/Interruptor",
+      "airqualitysensor": "Sensor de calidad del aire",
+      "smokecoalarm": "Alarma humo/CO",
+      "waterleakdetector": "Detector de fugas de agua",
+      "roomairconditioner": "Aire acondicionado",
+      "airpurifier": "Purificador de aire",
+      "speaker": "Altavoz",
+      "pumpcontroller": "Bomba",
+      "onofflightswitch": "Interruptor de luz",
+      "dimmerswitch": "Interruptor regulador",
+      "colordimmerswitch": "Interruptor regulador de color",
+      "powersource": "Alimentación",
+      "electricalsensor": "Sensor eléctrico",
+      "bridgednode": "Dispositivo puenteado",
+      "aggregator": "Bridge/Agregador",
+      "rootnode": "Nodo raíz"
+    }
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "Nombre",
+    "knx_gw": "GW KNX"
+  }
+}

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

@@ -0,0 +1,25 @@
+<script type="text/markdown" data-help-name="matter-config">
+# Controlador Matter
+
+## Descripción general
+
+Este nodo de configuración es un **controlador Matter** completo: crea su propia *fabric* Matter y empareja (comisiona) tus dispositivos Matter. Los dispositivos emparejados quedan disponibles para los nodos **Matter Device**, que los mapean a direcciones de grupo KNX.
+
+El controlador se comunica con los dispositivos a través de la **red IP** (WiFi, Ethernet o Thread mediante un border router). El emparejamiento por Bluetooth no está soportado: el dispositivo debe estar ya accesible en la red.
+
+## Emparejar un dispositivo
+
+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.
+
+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.
+
+## 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.
+
+## 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).
+</script>

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

@@ -0,0 +1,26 @@
+{
+  "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",
+      "pairing_help": "Introduce el código de emparejamiento manual de 11 dígitos (p.ej. 3497-011-2332) o el contenido del código QR (MT:....). El dispositivo debe estar accesible en la red IP (WiFi/Ethernet o Thread mediante border router). Si ya está emparejado con otro controlador (Alexa, Google, Apple), usa su función \"compartir/emparejar con otro hub\" para obtener un nuevo código.",
+      "pairing_code": "Código de emparejamiento",
+      "pair_button": "EMPAREJAR",
+      "devices_title": "Dispositivos emparejados",
+      "col_name": "Nombre",
+      "col_product": "Producto",
+      "col_state": "Estado",
+      "no_devices": "Aún no hay dispositivos emparejados.",
+      "unpair_confirm": "Eliminar (retirar) el dispositivo",
+      "unpair_ok": "Dispositivo eliminado.",
+      "deploy_first": "Haz deploy de este nodo de configuración primero e inténtalo de nuevo.",
+      "pairing_code_missing": "Introduce un código de emparejamiento.",
+      "pairing_wait": "Emparejamiento en curso. Puede tardar hasta un minuto...",
+      "pairing_failed": "Emparejamiento fallido",
+      "pairing_ok": "¡Dispositivo emparejado correctamente!"
+    }
+  }
+}

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

@@ -0,0 +1,34 @@
+<script type="text/markdown" data-help-name="matterbridge-config">
+# Bridge Matter (BETA)
+
+> Este nodo está en **BETA**: funciona, pero algunos detalles pueden cambiar entre versiones.
+
+## Descripción general
+
+Este nodo de configuración es el **bridge Matter en sí**: ejecuta el servidor Matter que Alexa, Google Home, Apple Home (o cualquier controlador Matter) emparejan **una sola vez**. Cada nodo **Matter Bridge device** de tus flows apunta aquí y aparece en las apps como un dispositivo del bridge.
+
+## Configuración
+
+|Campo|Descripción|
+|--|--|
+| Nombre | El nombre de este nodo de configuración en Node-RED |
+| Nombre del bridge Matter | Cómo se llama el bridge en las apps Matter |
+| Puerto | Puerto UDP del servidor Matter (por defecto 5540). Cada bridge necesita su propio puerto, por lo que puedes ejecutar **varios bridges independientes** |
+
+## Emparejamiento
+
+1. Haz **deploy**, espera unos segundos y vuelve a abrir este nodo.
+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).
+
+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.
+
+## 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.
+- Los nodos de dispositivo añadidos/renombrados/eliminados se detectan en pocos segundos, sin volver a emparejar.
+</script>

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

@@ -0,0 +1,20 @@
+{
+  "matterbridge-config": {
+    "properties": {
+      "title": "Bridge Matter",
+      "intro": "Este nodo de configuración es el bridge Matter en sí: Alexa, Google Home, Apple Home (o cualquier controlador Matter) lo emparejan una vez y ven todos los dispositivos KNX que le conectes. Añade nodos \"Matter Bridge device\" en tus flows y apúntalos aquí. Haz deploy primero y vuelve a abrir para obtener el código.",
+      "node-config-input-name": "Nombre",
+      "bridge_name": "Nombre del bridge Matter",
+      "port": "Puerto",
+      "pairing_title": "Emparejamiento (Alexa, Google Home, Apple Home...)",
+      "not_running": "El bridge Matter aún no está en ejecución. Haz deploy, espera unos segundos y pulsa actualizar.",
+      "commissioned": "Bridge emparejado con estos controladores:",
+      "awaiting": "Esperando emparejamiento. Escanea el código QR o introduce el código manual en tu app Matter:",
+      "qr_link": "Abrir el código QR en el navegador",
+      "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."
+    }
+  }
+}

package/nodes/locales/fr/knxUltimateMatterBridge.html

@@ -0,0 +1,53 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterBridge">
+# Matter Bridge device (BETA)
+
+> Ce nœud est en **BETA** : il fonctionne, mais des détails peuvent encore changer entre les versions.
+
+## Vue d'ensemble
+
+Chaque nœud Matter Bridge device expose **un appareil KNX comme appareil Matter** : les contrôleurs appairés (Alexa, Google Home, Apple Home...) le voient, avec le nom que vous avez choisi, prêt pour le contrôle par app et à la voix. Pointez-le vers un nœud de configuration **Bridge Matter** (le bridge lui-même, appairé une seule fois - le QR d'appairage vit là-bas) et ajoutez autant de nœuds d'appareil que vous voulez, n'importe où dans vos flux.
+
+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.
+
+## Configuration
+
+|Champ|Description|
+|--|--|
+| Bridge Matter | Le nœud de configuration Bridge Matter auquel appartient cet appareil |
+| GW KNX | Passerelle KNX utilisée pour les télégrammes. **Optionnel** : sans elle, l'appareil fonctionne en mode flow uniquement via les PIN du nœud. Sélectionnée automatiquement si le projet n'a qu'une passerelle |
+| Nom | Ce qu'Alexa & Co. affichent et utilisent pour les commandes vocales |
+| Type d'appareil | Le type d'appareil Matter (voir ci-dessous) ; il détermine quels champs d'adresse de groupe apparaissent |
+| Lire l'état au démarrage | Envoie un `GroupValue_Read` aux GA d'état au démarrage, pour peupler les attributs Matter |
+
+## Types d'appareil et adresses de groupe
+
+|Type|Adresses de groupe|
+|--|--|
+| Lumière On/Off, Prise | GA commande On/Off, GA état On/Off (DPT 1.001) |
+| Lumière variable | + GA commande/état variation % (DPT 5.001) |
+| 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) |
+| 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 |
+| Détecteur de fuite d'eau | GA état fuite (DPT 1.005) |
+| Capteur de qualité d'air (CO2) | GA état CO2 en ppm (DPT 9.008) ; la classe de qualité d'air (bonne/correcte/modérée/mauvaise...) est dérivée automatiquement |
+| Robot aspirateur | **Flow uniquement** : pas d'adresses de groupe. Activez les PIN du nœud : les commandes de l'assistant (« lance le nettoyage », pause/reprendre/retour à la base) arrivent sur la sortie comme `rvcmode`/`rvccommand` ; renvoyez l'état avec `msg.payload = { function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" }` et le mode avec `function: "rvcmode", value: "cleaning"\|"idle"` |
+
+- **GA de commande** : écrite sur le bus KNX quand l'assistant envoie une commande.
+- **GA d'état** : lue depuis le bus pour tenir à jour les attributs Matter (et les apps).
+
+## PIN du nœud
+
+Si vous activez les PIN entrée/sortie du nœud :
+
+- **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**.
+
+## Notes
+
+- L'identité Matter de l'appareil est liée à ce nœud : supprimer le nœud et en créer un nouveau fait apparaître un tout nouvel appareil dans les apps.
+- Les nœuds d'appareil ajoutés/renommés/supprimés sont pris en compte en quelques secondes, sans réappairer le bridge.
+</script>

package/nodes/locales/fr/knxUltimateMatterBridge.json

@@ -0,0 +1,83 @@
+{
+  "knxUltimateMatterBridge": {
+    "title": "Matter Bridge (BETA)",
+    "bridge_name": "Nom du bridge Matter",
+    "port": "Port",
+    "devices_help": "Ajoutez les appareils KNX à exposer sur Matter. Le \"Nom\" est celui qu'Alexa/Google/Apple affichent et utilisent pour les commandes vocales. GA de commande = écrite quand l'assistant envoie une commande ; GA d'état = lue depuis le bus pour tenir l'app à jour.",
+    "read_status_startup": "Lire les adresses de groupe d'état au démarrage",
+    "opt_yes": "Oui",
+    "opt_no": "Non",
+    "node_pins": "PIN entrée/sortie du nœud",
+    "node_pins_hide": "Masquer",
+    "node_pins_show": "Afficher les PIN entrée/sortie",
+    "fields": {
+      "type": "Type d'appareil",
+      "name": "Nom (affiché par Alexa & Co.)",
+      "name_placeholder": "ex. Lumière cuisine",
+      "invert": "Inverser la position %"
+    },
+    "functions": {
+      "fn_onoff_cmd": "GA commande On/Off",
+      "fn_onoff_status": "GA état On/Off",
+      "fn_level_cmd": "GA commande variation %",
+      "fn_level_status": "GA état variation %",
+      "fn_sensor_ga": "GA état du capteur",
+      "fn_updown": "GA commande Monter/Descendre",
+      "fn_stop": "GA commande Stop",
+      "fn_position_cmd": "GA commande position %",
+      "fn_position_status": "GA état position %",
+      "fn_currenttemp": "GA température actuelle",
+      "fn_setpoint_cmd": "GA commande consigne",
+      "fn_setpoint_status": "GA état consigne",
+      "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)",
+      "fn_ct_status": "GA état température de couleur (Kelvin)",
+      "fn_smoke_ga": "GA état alarme fumée",
+      "fn_co_ga": "GA état alarme CO (optionnel)",
+      "fn_leak_ga": "GA état fuite d'eau",
+      "fn_co2_ga": "GA état CO2 (ppm, DPT 9.008)",
+      "fn_fanspeed_cmd": "GA commande vitesse ventilateur %",
+      "fn_fanspeed_status": "GA état vitesse ventilateur %"
+    },
+    "types": {
+      "onofflight": "Lumière On/Off",
+      "dimmablelight": "Lumière variable",
+      "rgblight": "Lumière RGB (couleur)",
+      "colortemperaturelight": "Lumière blanc dynamique (température de couleur)",
+      "onoffplug": "Prise (on/off)",
+      "temperaturesensor": "Capteur de température",
+      "humiditysensor": "Capteur d'humidité",
+      "lightsensor": "Capteur de lumière (Lux)",
+      "occupancysensor": "Capteur de présence",
+      "contactsensor": "Capteur de contact",
+      "windowcovering": "Volet / Store",
+      "thermostat": "Thermostat (chauffage)",
+      "fan": "Ventilateur / VMC",
+      "smokecoalarm": "Détecteur fumée/CO",
+      "waterleakdetector": "Détecteur de fuite d'eau",
+      "airqualitysensor": "Capteur de qualité d'air (CO2)",
+      "robotvacuum": "Robot aspirateur (flow uniquement, via les PIN du nœud)"
+    },
+    "pairing": {
+      "title": "Appairage (Alexa, Google Home, Apple Home...)",
+      "not_running": "Le bridge Matter n'est pas encore démarré. Déployez, attendez quelques secondes puis cliquez sur actualiser.",
+      "commissioned": "Bridge appairé avec ces contrôleurs :",
+      "awaiting": "En attente d'appairage. Scannez le QR code ou saisissez le code manuel dans votre app Matter :",
+      "qr_link": "Ouvrir le QR code dans le navigateur",
+      "deploy_first": "Déployez d'abord ce nœud, 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."
+    },
+    "bridge": "Bridge Matter",
+    "device_name": "Nom (affiché par Alexa & Co.)",
+    "device_help": "Choisissez le type d'appareil et donnez-lui le nom que l'assistant vocal utilisera, puis remplissez les adresses de groupe. La passerelle KNX est optionnelle : sans elle, activez les PIN du nœud et pilotez l'appareil depuis le flux."
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "Nom",
+    "knx_gw": "GW KNX"
+  }
+}

package/nodes/locales/fr/knxUltimateMatterDevice.html

@@ -0,0 +1,56 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterDevice">
+# Appareil Matter (BETA)
+
+> Ce nœud est en **BETA** : il fonctionne, mais des détails peuvent encore changer entre les versions.
+
+## Vue d'ensemble
+
+Le nœud Matter Device fait le pont entre un **appareil Matter** et les **adresses de groupe KNX**. Le nœud opère via le nœud de configuration *Contrôleur Matter*, qui commissionne les appareils dans sa propre fabric Matter.
+
+- **Contrôlez** n'importe quel appareil Matter appairé depuis le bus KNX (on/off, variation, volets, thermostats, serrures, ...).
+- **Suivez** chaque attribut de l'appareil sur des adresses de groupe KNX (états, capteurs, mesure de puissance, batterie...).
+- Totalement générique : la liste des mappages est construite à partir des **endpoints/clusters réels** exposés par l'appareil.
+
+## Configuration
+
+|Champ|Description|
+|--|--|
+| GW KNX | Passerelle KNX utilisée pour les télégrammes |
+| Ctrl Matter | Le nœud de configuration Contrôleur Matter (où l'on appaire les appareils) |
+| Appareil | Choisissez l'appareil Matter appairé via l'autocomplétion |
+| Mappages | Une ligne par mappage adresse de groupe ↔ cluster Matter |
+| Lire l'état au démarrage | Si activé, le nœud émet les valeurs en cache au deploy/à la connexion |
+| PIN entrée/sortie | Active les broches Node-RED pour l'accès Matter brut |
+
+## Mappages
+
+La liste des cibles montre les fonctions prises en charge avec des noms compréhensibles comme *« Interrupteur On/Off »* ou *« Puissance instantanée (W) »*, filtrées selon ce que l'appareil expose réellement, avec la valeur actuelle entre crochets.
+
+Chaque ligne de mappage a une **direction** :
+
+- **KNX → Matter (commande)** : un télégramme reçu sur l'adresse de groupe invoque une commande du cluster Matter ou écrit un attribut. Exemple : GA `1/1/1` DPT 1.001 → `OnOff.on/off` (la valeur booléenne choisit automatiquement on ou off).
+- **Matter → KNX (état)** : quand l'attribut Matter souscrit change, sa valeur est convertie et écrite sur l'adresse de groupe. Les requêtes `GroupValue_Read` reçoivent la valeur en cache.
+
+Les clusters courants sont convertis automatiquement en valeurs adaptées à KNX :
+
+|Cluster|Conversion|
+|--|--|
+| OnOff | booléen (DPT 1.001) |
+| LevelControl | 0-254 ↔ pourcentage (DPT 5.001) |
+| WindowCovering | percent100ths ↔ pourcentage (DPT 5.001), monter/descendre (DPT 1.008) |
+| ColorControl | mireds ↔ Kelvin (DPT 7.600) |
+| Thermostat | centi-°C ↔ °C (DPT 9.001) |
+| Température/Humidité | centi-unités ↔ unités (DPT 9.001/9.007) |
+| Éclairement | échelle logarithmique ↔ Lux (DPT 9.004) |
+| PowerSource | demi-pourcent ↔ pourcentage batterie (DPT 5.001) |
+| Puissance/Énergie électrique | mW ↔ W (DPT 14.056), mWh ↔ kWh (DPT 13.013) |
+
+Les autres clusters/attributs passent tels quels ; le DPT choisi effectue l'encodage KNX final.
+
+## PIN du nœud
+
+Si vous activez les PIN du nœud :
+
+- **Entrée** : envoyez des commandes brutes : `msg.payload = { endpointId: 1, clusterId: 6, command: "toggle" }` ou des écritures d'attributs : `msg.payload = { endpointId: 1, clusterId: 8, attribute: "onLevel", value: 128 }`
+- **Sortie** : reçoit chaque changement d'attribut (`msg.matter` contient l'événement complet) et chaque événement de cluster (appuis de boutons, etc.).
+</script>

package/nodes/locales/fr/knxUltimateMatterDevice.json

@@ -0,0 +1,109 @@
+{
+  "knxUltimateMatterDevice": {
+    "title": "Appareil Matter (BETA)",
+    "paletteLabel": "Matter Device (BETA)",
+    "matter_controller": "Ctrl Matter",
+    "matter_device": "Appareil",
+    "device_placeholder": "Cliquez pour choisir un appareil Matter appairé",
+    "mapping_help": "Ajoutez une ligne par mappage. \"KNX → Matter\" invoque une commande du cluster (ou écrit un attribut) à l'arrivée d'un télégramme sur l'adresse de groupe. \"Matter → KNX\" écrit la valeur de l'attribut sur l'adresse de groupe à chaque changement (les demandes de lecture reçoivent la valeur en cache).",
+    "select_target": "-- sélectionnez la cible Matter --",
+    "stored_target": "Enregistré",
+    "read_status_startup": "Lire l'état au démarrage",
+    "opt_yes_emit": "Oui, et émettre les télégrammes KNX.",
+    "opt_no": "Non",
+    "node_pins": "PIN entrée/sortie du nœud",
+    "node_pins_hide": "Masquer",
+    "node_pins_show": "Afficher les PIN entrée/sortie",
+    "direction": {
+      "command": "KNX → Matter (commande)",
+      "status": "Matter → KNX (état)"
+    },
+    "fields": {
+      "direction": "Direction",
+      "target": "Endpoint / cluster / cible Matter",
+      "ga": "Adresse de groupe",
+      "dpt": "DPT",
+      "ganame": "Nom"
+    },
+    "no_simple_targets": "Aucune fonction prise en charge trouvée sur cet appareil (ou l'appareil n'est pas encore connecté).",
+    "endpoint": "Endpoint",
+    "friendly": {
+      "onoff_switch": "Interrupteur On/Off (allumer/éteindre)",
+      "onoff_toggle": "Inverser l'état (toggle)",
+      "onoff_state": "État On/Off",
+      "level_set": "Régler la luminosité / le niveau (%)",
+      "level_state": "Luminosité / niveau actuel (%)",
+      "colortemp_set": "Régler la température de couleur (Kelvin)",
+      "colortemp_state": "Température de couleur actuelle (Kelvin)",
+      "cover_updown": "Volet Monter/Descendre",
+      "cover_stop": "Volet Stop",
+      "cover_position_set": "Amener le volet en position (%)",
+      "cover_position_state": "Position actuelle du volet (%)",
+      "cover_tilt_set": "Incliner les lamelles (%)",
+      "cover_tilt_state": "Inclinaison actuelle des lamelles (%)",
+      "thermo_localtemp": "Température ambiante (°C)",
+      "thermo_heatsp_set": "Régler la consigne chauffage (°C)",
+      "thermo_coolsp_set": "Régler la consigne climatisation (°C)",
+      "thermo_heatsp_state": "Consigne chauffage (°C)",
+      "thermo_coolsp_state": "Consigne climatisation (°C)",
+      "fan_speed_set": "Régler la vitesse du ventilateur (%)",
+      "fan_speed_state": "Vitesse actuelle du ventilateur (%)",
+      "lock_cmd": "Verrouiller/Déverrouiller la serrure",
+      "lock_state": "État de la serrure (verrouillée)",
+      "temp_measured": "Température mesurée (°C)",
+      "humidity_measured": "Humidité relative (%)",
+      "illuminance_measured": "Éclairement (Lux)",
+      "occupancy_state": "Présence détectée",
+      "contact_state": "État du contact (fermé/ouvert)",
+      "battery_percent": "Niveau de batterie (%)",
+      "power_active": "Puissance instantanée (W)",
+      "power_voltage": "Tension (V)",
+      "power_current": "Courant (A)",
+      "energy_imported": "Énergie consommée (kWh)",
+      "identify_cmd": "Identifier l'appareil (clignotement)",
+      "switch_position": "Position du bouton"
+    },
+    "devtype": {
+      "onofflight": "Lumière On/Off",
+      "dimmablelight": "Lumière variable",
+      "colortemperaturelight": "Lumière à température de couleur",
+      "extendedcolorlight": "Lumière couleur",
+      "onoffpluginunit": "Prise (on/off)",
+      "dimmablepluginunit": "Prise (variable)",
+      "smartplug": "Prise connectée",
+      "contactsensor": "Capteur de contact",
+      "lightsensor": "Capteur de lumière",
+      "occupancysensor": "Capteur de présence",
+      "temperaturesensor": "Capteur de température",
+      "humiditysensor": "Capteur d'humidité",
+      "pressuresensor": "Capteur de pression",
+      "flowsensor": "Capteur de débit",
+      "doorlock": "Serrure",
+      "windowcovering": "Volet/Store",
+      "thermostat": "Thermostat",
+      "fan": "Ventilateur",
+      "genericswitch": "Bouton/Interrupteur",
+      "airqualitysensor": "Capteur de qualité d'air",
+      "smokecoalarm": "Détecteur fumée/CO",
+      "waterleakdetector": "Détecteur de fuite d'eau",
+      "roomairconditioner": "Climatiseur",
+      "airpurifier": "Purificateur d'air",
+      "speaker": "Haut-parleur",
+      "pumpcontroller": "Pompe",
+      "onofflightswitch": "Interrupteur",
+      "dimmerswitch": "Interrupteur variateur",
+      "colordimmerswitch": "Variateur couleur",
+      "powersource": "Alimentation",
+      "electricalsensor": "Capteur électrique",
+      "bridgednode": "Appareil ponté",
+      "aggregator": "Bridge/Agrégateur",
+      "rootnode": "Nœud racine"
+    }
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "Nom",
+    "knx_gw": "GW KNX"
+  }
+}

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

@@ -0,0 +1,25 @@
+<script type="text/markdown" data-help-name="matter-config">
+# Contrôleur Matter
+
+## Vue d'ensemble
+
+Ce nœud de configuration est un **contrôleur Matter** complet : il crée sa propre *fabric* Matter et y appaire (commissionne) vos appareils Matter. Les appareils appairés sont ensuite disponibles pour les nœuds **Matter Device**, qui les mappent sur des adresses de groupe KNX.
+
+Le contrôleur communique avec les appareils via le **réseau IP** (WiFi, Ethernet ou Thread via un border router). L'appairage Bluetooth n'est pas pris en charge : l'appareil doit déjà être joignable sur le réseau.
+
+## Appairer un appareil
+
+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.
+
+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.
+
+## 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.
+
+## 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).
+</script>

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

@@ -0,0 +1,26 @@
+{
+  "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",
+      "pairing_help": "Saisissez le code d'appairage manuel à 11 chiffres (ex. 3497-011-2332) ou le contenu du QR code (MT:....). L'appareil doit être joignable sur le réseau IP (WiFi/Ethernet ou Thread via border router). S'il est déjà appairé à un autre contrôleur (Alexa, Google, Apple), utilisez sa fonction \"partager/appairer avec un autre hub\" pour obtenir un nouveau code.",
+      "pairing_code": "Code d'appairage",
+      "pair_button": "APPAIRER",
+      "devices_title": "Appareils appairés",
+      "col_name": "Nom",
+      "col_product": "Produit",
+      "col_state": "État",
+      "no_devices": "Aucun appareil appairé pour le moment.",
+      "unpair_confirm": "Supprimer (retirer) l'appareil",
+      "unpair_ok": "Appareil supprimé.",
+      "deploy_first": "Déployez d'abord ce nœud de configuration, puis réessayez.",
+      "pairing_code_missing": "Veuillez saisir un code d'appairage.",
+      "pairing_wait": "Appairage en cours. Cela peut prendre jusqu'à une minute...",
+      "pairing_failed": "Échec de l'appairage",
+      "pairing_ok": "Appareil appairé avec succès !"
+    }
+  }
+}