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

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/fr/knxUltimateMatterBridge.html

@@ -0,0 +1,64 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterBridge">
+# Matter Bridge (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 Bridge expose les **adresses de groupe KNX comme appareils Matter** : Alexa, Google Home, Apple Home (ou n'importe quel contrôleur Matter) appairent ce bridge **une seule fois** et voient tous vos appareils KNX configurés, avec les noms que vous avez choisis, prêts pour le contrôle par app et à la voix.
+
+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|
+|--|--|
+| GW KNX | Passerelle KNX utilisée pour les télégrammes. **Optionnel** : sans passerelle, le bridge fonctionne en mode flow uniquement — activez les PIN du nœud et pilotez chaque appareil avec des messages du flow |
+| Nom du bridge Matter | Le nom du bridge lui-même dans les apps Matter |
+| Port | Port UDP du serveur Matter (5540 par défaut). Un seul nœud bridge par instance Node-RED. |
+| Appareils | Les appareils KNX virtuels exposés sur Matter (voir ci-dessous) |
+| Lire les GA d'état au démarrage | Envoie un `GroupValue_Read` à chaque GA d'état au démarrage, pour peupler les attributs Matter |
+
+## Appareils
+
+Chaque ligne est un appareil affiché par Alexa & Co. Choisissez le **type**, donnez-lui le **nom** que l'assistant utilisera, puis remplissez les adresses de groupe (avec autocomplétion ETS) :
+
+|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 = { device, function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" }` et le mode avec `function: "rvcmode", value: "cleaning"\|"idle"`. Intégrez votre Roomba/Roborock avec n'importe quel nœud Node-RED et exposez-le à Alexa/Apple |
+
+- **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).
+
+## Appairage
+
+1. **Déployez**, attendez quelques secondes, puis rouvrez le nœud.
+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).
+
+Le bouton **Réinitialiser l'appairage** supprime tous les contrôleurs appairés et relance l'annonce d'appairage.
+
+## PIN du nœud
+
+Si vous activez les PIN entrée/sortie du nœud :
+
+- **Entrée** : mettez à jour l'état Matter d'un appareil virtuel depuis le flow, sans passer par le bus KNX : `msg.payload = { device: "Lumière cuisine", function: "onoff", value: true }` (`device` accepte le nom ou l'id interne ; `function` est l'une de `onoff`, `level`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`). Utile pour exposer à Alexa & Co. des valeurs calculées dans le flow (ex. un capteur virtuel).
+- **Sortie** : chaque commande reçue d'un contrôleur Matter est transmise au flow : `msg.topic` = nom de l'appareil, `msg.payload` = valeur, `msg.matter` = la commande brute. Les appareils sans GA de commande deviennent des **appareils flow uniquement** : la commande arrive dans votre flow et vous décidez quoi en faire.
+
+## Notes
+
+- L'hôte Node-RED doit avoir **IPv6 link-local** activé (exigence standard de Matter) et être joignable par le contrôleur sur le réseau local.
+- L'identité du bridge est enregistrée dans `knxultimatestorage/matter` du répertoire utilisateur de Node-RED : les re-deploys ne nécessitent PAS de nouvel appairage.
+- Les renommages et ajouts d'appareils sont pris en compte automatiquement par les contrôleurs ; un appareil supprimé disparaît des apps.
+</script>

package/nodes/locales/fr/knxUltimateMatterBridge.json

@@ -0,0 +1,80 @@
+{
+  "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."
+    }
+  },
+  "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 !"
+    }
+  }
+}

package/nodes/locales/it/knxUltimateMatterBridge.html

@@ -0,0 +1,64 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterBridge">
+# Matter Bridge (BETA)
+
+> Questo nodo è in **BETA**: funziona, ma alcuni dettagli potrebbero cambiare tra una release e l'altra.
+
+## Panoramica
+
+Il nodo Matter Bridge espone gli **indirizzi di gruppo KNX come dispositivi Matter**: Alexa, Google Home, Apple Home (o qualunque controller Matter) associano questo bridge **una sola volta** e vedono tutti i dispositivi KNX configurati, con i nomi che hai scelto, pronti per il controllo da app e vocale.
+
+È la direzione opposta del nodo *Matter Device*: lì KNX controlla un dispositivo Matter, qui i controller Matter controllano KNX.
+
+## Configurazione
+
+|Campo|Descrizione|
+|--|--|
+| GW KNX | Gateway KNX usato per i telegrammi. **Opzionale**: senza gateway il bridge funziona in modalità solo-flow — abilita i PIN del nodo e piloti ogni dispositivo con i messaggi del flow |
+| Nome del bridge Matter | Come viene chiamato il bridge stesso nelle app Matter |
+| Porta | Porta UDP del server Matter (default 5540). Un solo nodo bridge per istanza Node-RED. |
+| Dispositivi | I dispositivi virtuali KNX esposti su Matter (vedi sotto) |
+| Leggi i GA di stato all'avvio | Invia una `GroupValue_Read` a ogni GA di stato all'avvio, per popolare gli attributi Matter |
+
+## Dispositivi
+
+Ogni riga è un dispositivo mostrato da Alexa & Co. Scegli il **tipo**, dagli il **nome** che l'assistente userà, poi compila gli indirizzi di gruppo (con autocompletamento ETS):
+
+|Tipo|Indirizzi di gruppo|
+|--|--|
+| Luce On/Off, Presa | GA comando On/Off, GA stato On/Off (DPT 1.001) |
+| Luce dimmerabile | + GA comando/stato dimmer % (DPT 5.001) |
+| 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) |
+| 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 |
+| Rilevatore allagamento | GA stato allagamento (DPT 1.005) |
+| Sensore qualità aria (CO2) | GA stato CO2 in ppm (DPT 9.008); la classe qualità aria (buona/discreta/moderata/scarsa...) è derivata automaticamente |
+| Robot aspirapolvere | **Solo-flow**: nessun indirizzo di gruppo. Abilita i PIN del nodo: i comandi dell'assistente ("avvia pulizia", pausa/riprendi/torna alla base) arrivano sull'output come `rvcmode`/`rvccommand`; riporta lo stato con `msg.payload = { device, function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" }` e la modalità con `function: "rvcmode", value: "cleaning"\|"idle"`. Integra il tuo Roomba/Roborock con qualsiasi nodo Node-RED ed esponilo ad Alexa/Apple |
+
+- **GA comando**: scritto sul bus KNX quando l'assistente invia un comando.
+- **GA stato**: letto dal bus per tenere aggiornati gli attributi Matter (e le app).
+
+## Abbinamento
+
+1. Fai il **deploy**, attendi qualche secondo, poi riapri il nodo.
+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).
+
+Il pulsante **Reset abbinamento** rimuove tutti i controller abbinati e riavvia l'advertising di abbinamento.
+
+## PIN del nodo
+
+Se abiliti i PIN input/output del nodo:
+
+- **Input**: aggiorna lo stato Matter di un dispositivo virtuale dal flow, senza passare dal bus KNX: `msg.payload = { device: "Luce cucina", function: "onoff", value: true }` (`device` accetta il nome o l'id interno; `function` è una tra `onoff`, `level`, `position`, `temperature`, `humidity`, `illuminance`, `occupancy`, `contact`, `currenttemp`, `setpoint`). Utile per esporre ad Alexa & Co. valori calcolati nel flow (es. un sensore virtuale).
+- **Output**: ogni comando ricevuto da un controller Matter viene inoltrato al flow: `msg.topic` = nome del dispositivo, `msg.payload` = valore, `msg.matter` = il comando grezzo. I dispositivi senza GA di comando diventano **dispositivi solo-flow**: il comando arriva al tuo flow e decidi tu cosa farne.
+
+## Note
+
+- L'host Node-RED deve avere **IPv6 link-local** attivo (requisito standard Matter) ed essere raggiungibile dal controller sulla rete locale.
+- L'identità del bridge è salvata in `knxultimatestorage/matter` nella directory utente di Node-RED: i re-deploy NON richiedono un nuovo abbinamento.
+- Rinomina e aggiunta di dispositivi vengono recepite automaticamente dai controller; se rimuovi un dispositivo, sparisce dalle app.
+</script>