node-red-contrib-knx-ultimate 5.2.4 → 6.0.0

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

@@ -8,6 +8,7 @@
       "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",
+      "pairing_name": "Nombre del dispositivo",
       "pair_button": "EMPAREJAR",
       "devices_title": "Dispositivos emparejados",
       "col_name": "Nombre",
@@ -20,7 +21,10 @@
       "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!"
+      "pairing_ok": "¡Dispositivo emparejado correctamente!",
+      "rename_button": "Renombrar",
+      "rename_prompt": "Nuevo nombre del dispositivo",
+      "rename_ok": "Dispositivo renombrado."
     }
   }
 }

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

@@ -10,6 +10,7 @@
       "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:",
+      "commissioned_hint": "El código QR está oculto porque el bridge ya está emparejado. Para añadir Alexa como otro controlador Matter, abre el modo de emparejamiento desde uno de los controladores listados arriba (por ejemplo Apple Home o Google Home) y luego añade un dispositivo Matter en Alexa. Usa Restablecer emparejamiento solo si quieres eliminar todos los controladores existentes y empezar de cero.",
       "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.",

package/nodes/locales/fr/knxUltimateMatterBridge.html

@@ -1,11 +1,11 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Matter Bridge device (BETA)
+# Expose KNX to Matter (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.
+Chaque nœud Expose KNX to Matter 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.
 
@@ -39,6 +39,10 @@ C'est la direction opposée du nœud *Matter Device* : là-bas KNX contrôle un
 - **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).
 
+## 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.
+
 ## PIN du nœud
 
 Si vous activez les PIN entrée/sortie du nœud :

package/nodes/locales/fr/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Matter Bridge (BETA)",
+    "title": "Expose KNX to Matter (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.",
@@ -10,12 +10,25 @@
     "node_pins": "PIN entrée/sortie du nœud",
     "node_pins_hide": "Masquer",
     "node_pins_show": "Afficher les PIN entrée/sortie",
+    "type_change_warning": "Changer le type d'appareil après l'appairage du bridge modifie la structure de l'endpoint Matter. Alexa/Google/Apple peuvent conserver l'ancien endpoint comme injoignable ; il peut être nécessaire de réinitialiser/réappairer le Matter Bridge ou de créer un nouvel appareil exposé.",
     "fields": {
       "type": "Type d'appareil",
       "name": "Nom (affiché par Alexa & Co.)",
       "name_placeholder": "ex. Lumière cuisine",
       "invert": "Inverser la position %"
     },
+    "advanced": {
+      "title": "Compatibilité avancée",
+      "help": " Utilisez ces options seulement lorsqu'un contrôleur Matter ou un actionneur KNX demande un traitement spécial.",
+      "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_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)"
+    },
     "functions": {
       "fn_onoff_cmd": "GA commande On/Off",
       "fn_onoff_status": "GA état On/Off",

package/nodes/locales/fr/knxUltimateMatterControllerDevice.html

@@ -0,0 +1,27 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
+# Control Matter from KNX (BETA)
+
+> Ce nœud est en **BETA** : le comportement peut changer pendant l amélioration de l'implémentation Matter.
+
+Ce nœud contrôle depuis KNX un endpoint Matter déjà appairé. Sélectionnez l'appareil Matter et l'éditeur détecte ses capacités, puis affiche uniquement les mappings KNX adaptés à cet endpoint.
+
+Il remplace les nœuds Matter séparés non publiés et conserve toute l'UI lumière lorsque l'endpoint sélectionné est une lumière.
+
+## Configuration
+
+|Champ|Description|
+|--|--|
+| KNX GW | Passerelle KNX utilisée pour écrire et répondre sur les adresses de groupe configurées. Elle peut rester vide si seule la sortie Node-RED est utilisée. |
+| Matter controller | Nœud de configuration Matter Controller dans lequel le périphérique a été appairé. |
+| Appareil Matter | Endpoint Matter choisi parmi les appareils appairés. L'UI est reconstruite à partir de ses capacités réelles. |
+| Switch / Prise / Lumière On-Off | Adresses de groupe commande et état On/Off, généralement DPT `1.001`. |
+| Contrôles lumière | Pour les endpoints lumière, l'UI lumière complète est utilisée : DIM relatif (DPT `3.007`), luminosité %, RGB/HSV, blanc réglable, luminosité/température à l'allumage, mode jour/nuit, niveau min/max et vitesse de variation. Les sections non supportées restent masquées. |
+| Capteurs | Les endpoints capteur affichent leur GA de mesure/état uniquement si elle est supportée : température, humidité, éclairement, occupation, contact et batterie. |
+| Read at startup | Publie la valeur Matter en cache au déploiement/démarrage ou quand le périphérique se reconnecte. |
+| Update local state from KNX write | Met à jour le cache local Matter/KNX lorsqu'un télégramme est écrit sur une GA KNX configurée. |
+| Node Input/Output PINs | Affiche les pins entrée/sortie Node-RED. L'entrée accepte les payloads booléens et les messages Matter dans `msg.payload` ou `msg.on.on`; la sortie émet les états. |
+
+## Comportement
+
+Le nœud garde un cache local depuis les mises à jour Matter et les écritures KNX, répond aux lectures KNX depuis ce cache et peut émettre/lire les valeurs au démarrage. Il n'écoute que les adresses de groupe configurées, donc le trafic KNX non lié est ignoré.
+</script>

package/nodes/locales/fr/knxUltimateMatterControllerDevice.json

@@ -0,0 +1,89 @@
+{
+  "knxUltimateMatterControllerDevice": {
+    "title": "Control Matter from KNX",
+    "node-input-name": "Nom",
+    "node-input-nameLightSwitch": "Commutateur (bit)",
+    "node-input-GALightSwitch": "Géorgie",
+    "node-input-dptLightSwitch": "dpt",
+    "node-input-nameLightState": "État (bit)",
+    "node-input-GALightState": "Géorgie",
+    "node-input-dptLightState": "dpt",
+    "node-input-hueLight": "Appareil Matter",
+    "paletteLabel": "Control Matter from KNX",
+    "no_devices": "Aucun appareil Matter trouvé. Vérifiez le contrôleur Matter et actualisez.",
+    "tabs": {
+      "switch": "Changer",
+      "dim": "Faible",
+      "tunable_white": "White à réglage réglable",
+      "rgb_hsv": "RVB / HSV",
+      "effects": "Effets",
+      "behaviour": "Comportement"
+    },
+    "control": "Contrôle",
+    "status": "Statut",
+    "night_lighting": "Éclairage nocturne",
+    "no_night_lighting": "Pas d'éclairage de nuit",
+    "get_current": "Prendre le courant",
+    "get_again": "Remonter",
+    "wait": "Attendez...",
+    "day_night": "Jour / nuit",
+    "invert_day_night": "Valeur de jour / nuit inversée",
+    "override_night_mode": "Forcer le mode jour",
+    "override_no": "Non",
+    "override_set_day_fast_this": "Passez au mode jour en éteignant rapidement la lumière (cette lumière uniquement)",
+    "override_set_day_fast_all": "Passer au mode jour en éteignant rapidement la lumière (appliquer sur tous les nœuds lumineux)",
+    "node_pins": "Broches d'entrée / sortie de nœud",
+    "node_pins_hide": "Cacher",
+    "node_pins_show": "Afficher les broches d'entrée / sortie du nœud",
+    "read_status_startup": "Lire l'état au démarrage",
+    "opt_no": "Non",
+    "opt_yes_emit": "Oui, et émettez des télégrammes KNX.",
+    "knx_brightness_status": "Statut de luminosité de KNX",
+    "knx_brightness_onhueoff": "Lorsque Hue Light est éteint, envoyez 0%. Lorsque Hue On, restaurez la valeur précédente (comportement KNX par défaut)",
+    "knx_brightness_no": "Laisser tel quel (comportement de teinte par défaut)",
+    "update_local_state_from_knx_write": "Mettre à jour l'état Hue local en cache à partir des écritures du bus KNX",
+    "update_local_state_from_knx_write_hint": "Active: reactions locales plus rapides et reponses immediates de lecture KNX plus coherentes. Desactive: le cache ne suit que les evenements reels du bridge Hue.",
+    "use_min_brightness": "Utilisez une luminosité minimale spécifiée dans la lumière des teintes",
+    "k_suffix": "K",
+    "temp_desc_2200": "(Début de la gamme Philips White Ambiance Lights)",
+    "temp_desc_2700": "(blanc chaud, intime, confortable, personnel, pour les salons)",
+    "temp_desc_3000": "(blanc doux, chaud, apaisant, pour les salles de bains et les cuisines)",
+    "temp_desc_3500_day": "(Blanc neutre, équilibré, amical, accueillant, pour les espaces de bureau et le commerce de détail)",
+    "temp_desc_3500_night": "(Non recommandé pour la nuit - blanc neutre, pour les espaces de bureau et la vente au détail)",
+    "temp_desc_4100_day": "(blanc frais, précis, propre, concentré, pour les garages et les épiceries)",
+    "temp_desc_4100_night": "(Non recommandé pour la nuit - blanc frais, précis, propre, concentré, pour les garages et les épiceries)",
+    "temp_desc_5000_day": "(blanc brillant, vibrant, croustillant, pour les entrepôts, les stades sportifs et les soins de santé)",
+    "temp_desc_5000_night": "(Non recommandé pour la nuit - blanc brillant, vibrant, croustillant, pour les entrepôts, les stades sportifs et les soins de santé)",
+    "temp_desc_6500_day": "(lumière du jour, alerte, énergique, pour l'agriculture intérieure)",
+    "temp_desc_6500_night": "(Non recommandé pour la nuit - lumière du jour, alerte, énergique, pour l'agriculture intérieure)",
+    "switch_on_behaviour": "Activer le comportement",
+    "none": "Aucun",
+    "switch_off": "(Éteindre)",
+    "select_color": "Sélectionner la couleur",
+    "select_temperature_brightness": "Sélectionnez la température et la luminosité",
+    "select_brightness": "Sélectionner la luminosité",
+    "effect_command": "Commande d'effet",
+    "effect_status": "État de l'effet",
+    "effect_mapping": "Mappages",
+    "effect_autofill": "Remplissez les effets disponibles",
+    "effect_tip": "Fournir des paires d'effets KNX Valeur / Hue. Lorsque la charge utile KNX entrante correspond à la valeur, l'effet sélectionné est appliqué à la lumière.",
+    "effect_tip_status": "Si une adresse de groupe d'état est configurée, l'effet de teinte actuel est émis en utilisant la valeur KNX mappée ou le nom d'effet.",
+    "effect_not_supported": "Cette lumière n'expose pas les effets de la teinte.",
+    "effect_knx_value_placeholder": "Valeur à correspondre",
+    "effect_base_label": "Effets de base non-hers",
+    "effect_native_label": "Effets natifs de la teinte",
+    "matter_controller": "Contrôleur Matter",
+    "matter_device": "Appareil Matter",
+    "matter_section": "Appareil Matter"
+  },
+  "common": {
+    "ga": "Géorgie",
+    "dpt": "Dpt",
+    "name": "Nom",
+    "youtube_sample": "Échantillon YouTube",
+    "knx_gw": "KNX GW",
+    "hue_bridge": "Hue Bridge",
+    "philips_hue": "Hue Philips",
+    "read": "Lire"
+  }
+}

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

@@ -8,6 +8,7 @@
       "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",
+      "pairing_name": "Nom de l'appareil",
       "pair_button": "APPAIRER",
       "devices_title": "Appareils appairés",
       "col_name": "Nom",
@@ -20,7 +21,10 @@
       "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 !"
+      "pairing_ok": "Appareil appairé avec succès !",
+      "rename_button": "Renommer",
+      "rename_prompt": "Nouveau nom de l'appareil",
+      "rename_ok": "Appareil renommé."
     }
   }
 }

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

@@ -10,6 +10,7 @@
       "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 :",
+      "commissioned_hint": "Le QR code est masqué car le bridge est déjà appairé. Pour ajouter Alexa comme autre contrôleur Matter, ouvrez le mode d'appairage depuis l'un des contrôleurs listés ci-dessus (par exemple Apple Home ou Google Home), puis ajoutez un appareil Matter dans Alexa. Utilisez Réinitialiser l'appairage uniquement si vous voulez supprimer tous les contrôleurs existants et repartir de zéro.",
       "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 de configuration, puis cliquez sur actualiser.",

package/nodes/locales/it/knxUltimateMatterBridge.html

@@ -1,11 +1,11 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Matter Bridge device (BETA)
+# Expose KNX to Matter (BETA)
 
 > Questo nodo è in **BETA**: funziona, ma alcuni dettagli potrebbero cambiare tra una release e l'altra.
 
 ## Panoramica
 
-Ogni nodo Matter Bridge device espone **un dispositivo KNX come dispositivo Matter**: i controller abbinati (Alexa, Google Home, Apple Home...) lo vedono, con il nome che hai scelto, pronto per il controllo da app e vocale. Puntalo a un nodo di configurazione **Bridge Matter** (il bridge vero e proprio, abbinato una sola volta - il QR di abbinamento vive lì) e aggiungi quanti nodi device vuoi, ovunque nei tuoi flow.
+Ogni nodo Expose KNX to Matter espone **un dispositivo KNX come dispositivo Matter**: i controller abbinati (Alexa, Google Home, Apple Home...) lo vedono, con il nome che hai scelto, pronto per il controllo da app e vocale. Puntalo a un nodo di configurazione **Bridge Matter** (il bridge vero e proprio, abbinato una sola volta - il QR di abbinamento vive lì) e aggiungi quanti nodi device vuoi, ovunque nei tuoi flow.
 
 È la direzione opposta del nodo *Matter Device*: lì KNX controlla un dispositivo Matter, qui i controller Matter controllano KNX.
 
@@ -39,6 +39,10 @@ Ogni nodo Matter Bridge device espone **un dispositivo KNX come dispositivo Matt
 - **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).
 
+## 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.
+
 ## PIN del nodo
 
 Se abiliti i PIN input/output del nodo:

package/nodes/locales/it/knxUltimateMatterBridge.json

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Matter Bridge (BETA)",
+    "title": "Expose KNX to Matter (BETA)",
     "bridge_name": "Nome del bridge Matter",
     "port": "Porta",
     "devices_help": "Aggiungi i dispositivi KNX da esporre su Matter. Il \"Nome\" è quello che Alexa/Google/Apple mostrano e usano per i comandi vocali. GA comando = scritto quando l'assistente invia un comando; GA stato = letto dal bus per tenere aggiornata l'app.",
@@ -10,12 +10,25 @@
     "node_pins": "PIN Input/Output del nodo",
     "node_pins_hide": "Nascondi",
     "node_pins_show": "Mostra i PIN input/output del nodo",
+    "type_change_warning": "Cambiare il tipo dispositivo dopo che il bridge è già stato abbinato modifica la struttura dell'endpoint Matter. Alexa/Google/Apple possono mantenere il vecchio endpoint come irraggiungibile; potrebbe servire resettare/riabbinare il Matter Bridge o creare un nuovo dispositivo esposto.",
     "fields": {
       "type": "Tipo dispositivo",
       "name": "Nome (mostrato da Alexa & Co.)",
       "name_placeholder": "es. Luce cucina",
       "invert": "Inverti posizione %"
     },
+    "advanced": {
+      "title": "Compatibilità avanzata",
+      "help": " Usa queste opzioni solo quando un controller Matter o un attuatore KNX richiede una gestione speciale.",
+      "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_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)"
+    },
     "functions": {
       "fn_onoff_cmd": "GA comando On/Off",
       "fn_onoff_status": "GA stato On/Off",

package/nodes/locales/it/knxUltimateMatterControllerDevice.html

@@ -0,0 +1,27 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
+# Control Matter from KNX (BETA)
+
+> Questo nodo è in **BETA**: il comportamento può cambiare mentre l'implementazione Matter viene rifinita.
+
+Questo nodo controlla da KNX un endpoint Matter già abbinato. Seleziona il dispositivo Matter e l'editor rileva le sue capability, mostrando solo le mappature KNX coerenti con quell'endpoint.
+
+Sostituisce i nodi Matter separati non pubblicati e mantiene tutta la UI luce quando l'endpoint selezionato è una luce.
+
+## Configurazione
+
+|Campo|Descrizione|
+|--|--|
+| KNX GW | Gateway KNX usato per scrivere e rispondere sugli indirizzi di gruppo configurati. Può restare vuoto se serve solo l'output Node-RED. |
+| Matter controller | Nodo di configurazione Matter Controller in cui il dispositivo è stato associato. |
+| Dispositivo Matter | Endpoint Matter selezionato tra i dispositivi abbinati. La UI viene ricostruita in base alle capability reali. |
+| Switch / Presa / Luce On-Off | Indirizzi di gruppo di comando e stato On/Off, di solito DPT `1.001`. |
+| Controlli luce | Per gli endpoint luce viene usata la stessa UI luce completa: DIM relativo (DPT `3.007`), luminosità %, RGB/HSV, bianco dinamico, luminosità/temperatura all'accensione, modalità giorno/notte, livello min/max e velocità dimmer. Le sezioni non supportate restano nascoste. |
+| Sensori | Gli endpoint sensore mostrano il relativo GA di misura/stato solo quando supportato: temperatura, umidità, illuminamento, presenza, contatto e batteria. |
+| Read at startup | Pubblica il valore Matter in cache al deploy/avvio o quando il dispositivo si riconnette. |
+| Update local state from KNX write | Aggiorna la cache locale Matter/KNX quando arriva una scrittura su un GA KNX configurato. |
+| Node Input/Output PINs | Mostra i pin input/output Node-RED. L'input accetta payload booleani e messaggi stile Matter in `msg.payload` o `msg.on.on`; l'output emette gli aggiornamenti di stato. |
+
+## Comportamento
+
+Il nodo mantiene una cache locale da aggiornamenti Matter e scritture KNX, risponde alle letture KNX dalla cache e può emettere/leggere i valori all'avvio. Ascolta solo gli indirizzi di gruppo configurati, quindi ignora il traffico KNX non pertinente.
+</script>

package/nodes/locales/it/knxUltimateMatterControllerDevice.json

@@ -0,0 +1,97 @@
+{
+  "knxUltimateMatterControllerDevice": {
+    "title": "Control Matter from KNX",
+    "node-input-name": "Nome",
+    "node-input-nameLightSwitch": "Switch (bit)",
+    "node-input-GALightSwitch": "GA",
+    "node-input-dptLightSwitch": "dpt",
+    "node-input-nameLightState": "Stato (bit)",
+    "node-input-GALightState": "GA",
+    "node-input-dptLightState": "dpt",
+    "node-input-hueLight": "Dispositivo Matter",
+    "paletteLabel": "Control Matter from KNX",
+    "no_devices": "Nessun dispositivo Matter trovato. Controlla il controller Matter e premi refresh.",
+    "tabs": {
+      "switch": "On/Off",
+      "dim": "Dimmer",
+      "tunable_white": "Bianco regolabile",
+      "rgb_hsv": "RGB/HSV",
+      "effects": "Effetti",
+      "behaviour": "Comportamento"
+    },
+    "control": "Comando",
+    "status": "Stato",
+    "night_lighting": "Illuminazione notturna",
+    "no_night_lighting": "Nessuna illuminazione notturna",
+    "get_current": "Ottieni corrente",
+    "get_again": "Ottieni di nuovo",
+    "wait": "Attendere...",
+    "locate_no_bridge": "Seleziona prima un bridge Hue",
+    "locate_no_device": "Seleziona prima un dispositivo Hue",
+    "locate_success": "Comando di localizzazione inviato",
+    "locate_started": "Modalità di localizzazione avviata. Premi di nuovo per fermarla (si ferma automaticamente dopo 10 minuti).",
+    "locate_stopped": "Modalità di localizzazione terminata.",
+    "locate_start_title": "Localizza il dispositivo Hue selezionato",
+    "locate_stop_title": "Ferma la modalità di localizzazione",
+    "locate_error": "Impossibile localizzare il dispositivo Hue",
+    "day_night": "Giorno/Notte",
+    "invert_day_night": "Inverti valore giorno/notte",
+    "override_night_mode": "Forza modalità diurna",
+    "override_no": "No",
+    "override_set_day_fast_this": "Passa a GIORNO spegnendo e riaccendendo velocemente (solo questa luce)",
+    "override_set_day_fast_all": "Passa a GIORNO spegnendo e riaccendendo velocemente (tutte le luci)",
+    "node_pins": "PIN di Input/Output del nodo",
+    "node_pins_hide": "Nascondi",
+    "node_pins_show": "Mostra PIN di input/output",
+    "read_status_startup": "Leggi lo stato all'avvio",
+    "opt_no": "No",
+    "opt_yes_emit": "Sì, ed emetti i telegrammi KNX.",
+    "knx_brightness_status": "Stato luminosità KNX",
+    "knx_brightness_onhueoff": "Se la luce HUE è spenta invia 0%. Se è accesa, ripristina il valore precedente (Comportamento KNX predefinito)",
+    "knx_brightness_no": "Lascia invariato (comportamento HUE predefinito)",
+    "update_local_state_from_knx_write": "Aggiorna lo stato HUE locale in cache dai write provenienti dal bus KNX",
+    "update_local_state_from_knx_write_hint": "Abilitato: reazioni locali piu rapide e risposte immediate ai read KNX piu coerenti. Disabilitato: la cache si aggiorna solo dagli eventi reali del bridge Hue.",
+    "use_min_brightness": "Usa la luminosità minima specificata nella luce HUE",
+    "k_suffix": "K",
+    "temp_desc_2200": "(inizio della gamma Philips White Ambiance)",
+    "temp_desc_2700": "(bianco caldo, intimo, accogliente, personale, per soggiorni)",
+    "temp_desc_3000": "(bianco tenue, caldo, rilassante, per bagni e cucine)",
+    "temp_desc_3500_day": "(bianco neutro, equilibrato, amichevole, invitante, per uffici e negozi)",
+    "temp_desc_3500_night": "(sconsigliato di notte - bianco neutro, per uffici e negozi)",
+    "temp_desc_4100_day": "(bianco freddo, preciso, pulito, focalizzato, per garage e supermercati)",
+    "temp_desc_4100_night": "(sconsigliato di notte - bianco freddo, preciso, pulito, focalizzato, per garage e supermercati)",
+    "temp_desc_5000_day": "(bianco brillante, vivace, nitido, per magazzini, stadi e sanità)",
+    "temp_desc_5000_night": "(sconsigliato di notte - bianco brillante, vivace, nitido, per magazzini, stadi e sanità)",
+    "temp_desc_6500_day": "(luce diurna, allerta, energizzante, per agricoltura indoor)",
+    "temp_desc_6500_night": "(sconsigliato di notte - luce diurna, allerta, energizzante, per agricoltura indoor)",
+    "switch_on_behaviour": "Comportamento all'accensione",
+    "none": "Nessuno",
+    "switch_off": "(Spegni)",
+    "select_color": "Seleziona colore",
+    "select_temperature_brightness": "Seleziona temperatura e luminosità",
+    "select_brightness": "Seleziona luminosità",
+    "effect_command": "Comando effetti",
+    "effect_status": "Stato effetti",
+    "effect_mapping": "Associazioni",
+    "effect_autofill": "Compila con gli effetti disponibili",
+    "effect_tip": "Definisci le coppie valore KNX / effetto Hue. Quando il valore KNX ricevuto coincide, viene attivato l'effetto selezionato.",
+    "effect_tip_status": "Se configuri lo stato, il nodo invierà su KNX l'effetto corrente (valore associato o nome).",
+    "effect_not_supported": "Questa lampada non espone effetti Hue.",
+    "effect_knx_value_placeholder": "Valore da confrontare",
+    "effect_base_label": "Effetti base non HUE",
+    "effect_native_label": "Effetti nativi HUE",
+    "matter_controller": "Controller Matter",
+    "matter_device": "Dispositivo Matter",
+    "matter_section": "Dispositivo Matter"
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "Nome",
+    "youtube_sample": "Esempio YouTube",
+    "knx_gw": "Gateway KNX",
+    "hue_bridge": "Hue Bridge",
+    "philips_hue": "Philips HUE",
+    "read": "Leggi"
+  }
+}

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

@@ -8,6 +8,7 @@
       "pairing_title": "Associa un nuovo dispositivo",
       "pairing_help": "Inserisci il codice di abbinamento manuale a 11 cifre (es. 3497-011-2332) o il contenuto del QR code (MT:....). Il dispositivo deve essere raggiungibile sulla rete IP (WiFi/Ethernet o Thread tramite border router). Se il dispositivo è già associato a un altro controller (Alexa, Google, Apple), usa la funzione \"condividi/abbina con altro hub\" per ottenere un nuovo codice.",
       "pairing_code": "Codice abbinamento",
+      "pairing_name": "Nome dispositivo",
       "pair_button": "ASSOCIA",
       "devices_title": "Dispositivi associati",
       "col_name": "Nome",
@@ -20,7 +21,11 @@
       "pairing_code_missing": "Inserisci un codice di abbinamento.",
       "pairing_wait": "Abbinamento in corso. Può richiedere fino a un minuto...",
       "pairing_failed": "Abbinamento fallito",
-      "pairing_ok": "Dispositivo associato con successo!"
+      "pairing_ok": "Dispositivo associato con successo!",
+      "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."
     }
   }
 }

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

@@ -10,6 +10,7 @@
       "pairing_title": "Abbinamento (Alexa, Google Home, Apple Home...)",
       "not_running": "Il bridge Matter non è ancora in esecuzione. Fai il deploy, attendi qualche secondo e clicca aggiorna.",
       "commissioned": "Bridge abbinato a questi controller:",
+      "commissioned_hint": "Il QR code è nascosto perché il bridge è già abbinato. Per aggiungere Alexa come altro controller Matter, apri la modalità di abbinamento da uno dei controller elencati sopra (per esempio Apple Home o Google Home), poi aggiungi un dispositivo Matter in Alexa. Usa Reset abbinamento solo se vuoi rimuovere tutti i controller esistenti e ripartire da zero.",
       "awaiting": "In attesa di abbinamento. Scansiona il QR code o inserisci il codice manuale nella tua app Matter:",
       "qr_link": "Apri il QR code nel browser",
       "deploy_first": "Fai prima il deploy di questo nodo di configurazione, poi clicca aggiorna.",

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

@@ -1,11 +1,11 @@
 <script type="text/markdown" data-help-name="knxUltimateMatterBridge">
-# Matter Bridge device (BETA)
+# Expose KNX to Matter (BETA)
 
 > 此节点处于 **BETA** 阶段：可以正常工作，但细节可能在版本之间发生变化。
 
 ## 概述
 
-每个 Matter Bridge device 节点将**一个 KNX 设备公开为 Matter 设备**：已配对的控制器（Alexa、Google Home、Apple Home...）会以您输入的名称看到它，随时可通过 App 和语音控制。将它指向一个 **Matter 桥接器**配置节点（真正的桥接器，只需配对一次 - 配对二维码在那里），然后在流程中随意添加任意数量的设备节点。
+每个 Expose KNX to Matter 节点将**一个 KNX 设备公开为 Matter 设备**：已配对的控制器（Alexa、Google Home、Apple Home...）会以您输入的名称看到它，随时可通过 App 和语音控制。将它指向一个 **Matter 桥接器**配置节点（真正的桥接器，只需配对一次 - 配对二维码在那里），然后在流程中随意添加任意数量的设备节点。
 
 这与 *Matter Device* 节点方向相反：那里是 KNX 控制 Matter 设备，这里是 Matter 控制器控制 KNX。
 
@@ -39,6 +39,10 @@
 - **命令 GA**：助手发送命令时写入 KNX 总线。
 - **状态 GA**：从总线读取，保持 Matter 属性（和 App）更新。
 
+## 高级兼容性
+
+这些选项只会在适用于所选类型时显示。调光设备可以忽略某些控制器在 `On` 后立即发送的亮度命令。窗帘可以在命令后乐观更新 Matter 位置，并在 KNX 状态 GA 报告真实位置时再修正。
+
 ## 节点引脚
 
 如果启用节点的输入/输出引脚：

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

@@ -1,6 +1,6 @@
 {
   "knxUltimateMatterBridge": {
-    "title": "Matter Bridge (BETA)",
+    "title": "Expose KNX to Matter (BETA)",
     "bridge_name": "Matter 桥接器名称",
     "port": "端口",
     "devices_help": "添加要在 Matter 上公开的 KNX 设备。\"名称\"是 Alexa/Google/Apple 显示并用于语音命令的名称。命令 GA = 助手发送命令时写入；状态 GA = 从总线读取以保持 App 更新。",
@@ -10,12 +10,25 @@
     "node_pins": "节点输入/输出引脚",
     "node_pins_hide": "隐藏",
     "node_pins_show": "显示节点输入/输出引脚",
+    "type_change_warning": "桥接器配对后更改设备类型会改变 Matter 端点结构。Alexa/Google/Apple 可能会将旧端点保留为不可达；可能需要重置/重新配对 Matter 桥接器，或创建一个新的公开设备。",
     "fields": {
       "type": "设备类型",
       "name": "名称（Alexa 等显示）",
       "name_placeholder": "例如 厨房灯",
       "invert": "反转位置 %"
     },
+    "advanced": {
+      "title": "高级兼容性",
+      "help": " 仅当 Matter 控制器或 KNX 执行器需要特殊处理时使用这些选项。",
+      "turn_on_behavior": "开灯行为",
+      "turn_on_ignore_level": "忽略 On 后立即发送的亮度",
+      "turn_on_forward_all": "转发每个亮度命令",
+      "ignore_level_ms": "On 后忽略亮度时间 (ms)",
+      "cover_update_mode": "窗帘状态更新",
+      "cover_optimistic": "乐观更新 Matter 位置",
+      "cover_wait_status": "仅等待 KNX 状态",
+      "cover_status_timeout": "窗帘状态超时 (ms)"
+    },
     "functions": {
       "fn_onoff_cmd": "开/关 命令 GA",
       "fn_onoff_status": "开/关 状态 GA",

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

@@ -0,0 +1,27 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterControllerDevice">
+# 从 KNX 控制 Matter (BETA)
+
+> 此节点为 **BETA**：Matter 实现继续完善时，行为可能会变化。
+
+此节点用于从 KNX 控制已经配对的 Matter endpoint。选择 Matter 设备后，编辑器会检测它的能力，并只显示与该 endpoint 匹配的 KNX 映射。
+
+它替代未发布的多个专用 Matter 控制节点；当选择的 endpoint 是灯时，仍保留完整的灯光 UI。
+
+## 配置
+
+|字段|说明|
+|--|--|
+| KNX GW | 用于写入并响应已配置组地址的 KNX 网关。如果只需要 Node-RED 输出，可以留空。 |
+| Matter controller | 设备已在其中配网的 Matter Controller 配置节点。 |
+| Matter device | 从已配对设备中选择的 Matter endpoint。UI 会根据真实能力重新构建。 |
+| Switch / 插座 / 灯 On-Off | On/Off 命令和状态组地址，通常使用 DPT `1.001`。 |
+| 灯光控制 | 对灯光 endpoint 使用完整灯光 UI：相对调光（DPT `3.007`）、亮度百分比、RGB/HSV、色温、开灯亮度/温度、日/夜模式、最小/最大调光等级和调光速度。不支持的部分会隐藏。 |
+| 传感器 | 传感器 endpoint 只在支持时显示对应测量/状态 GA：温度、湿度、照度、占用、接触和电池。 |
+| Read at startup | 在部署/启动或设备重新连接时发布缓存的 Matter 值。 |
+| Update local state from KNX write | 当配置的 KNX GA 收到写入 telegram 时，更新本地 Matter/KNX 缓存。 |
+| Node Input/Output PINs | 显示 Node-RED 输入/输出端口。输入接受布尔 payload，以及 `msg.payload` 或 `msg.on.on` 中的 Matter 风格消息；输出发送状态更新。 |
+
+## 行为
+
+节点根据 Matter 更新和 KNX 写入维护本地缓存，用该缓存响应 KNX 读取请求，并可在启动时读取/发送值。节点只监听已配置的组地址，因此会忽略无关的 KNX 流量。
+</script>