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

package/nodes/locales/it/knxUltimateMatterBridge.json

@@ -0,0 +1,80 @@
+{
+  "knxUltimateMatterBridge": {
+    "title": "Matter Bridge (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.",
+    "read_status_startup": "Leggi i GA di stato all'avvio",
+    "opt_yes": "Sì",
+    "opt_no": "No",
+    "node_pins": "PIN Input/Output del nodo",
+    "node_pins_hide": "Nascondi",
+    "node_pins_show": "Mostra i PIN input/output del nodo",
+    "fields": {
+      "type": "Tipo dispositivo",
+      "name": "Nome (mostrato da Alexa & Co.)",
+      "name_placeholder": "es. Luce cucina",
+      "invert": "Inverti posizione %"
+    },
+    "functions": {
+      "fn_onoff_cmd": "GA comando On/Off",
+      "fn_onoff_status": "GA stato On/Off",
+      "fn_level_cmd": "GA comando dimmer %",
+      "fn_level_status": "GA stato dimmer %",
+      "fn_sensor_ga": "GA stato sensore",
+      "fn_updown": "GA comando Su/Giù",
+      "fn_stop": "GA comando Stop",
+      "fn_position_cmd": "GA comando posizione %",
+      "fn_position_status": "GA stato posizione %",
+      "fn_currenttemp": "GA temperatura attuale",
+      "fn_setpoint_cmd": "GA comando setpoint",
+      "fn_setpoint_status": "GA stato setpoint",
+      "fn_rgb_cmd": "GA comando colore RGB (DPT 232.600)",
+      "fn_rgb_status": "GA stato colore RGB (DPT 232.600)",
+      "fn_ct_cmd": "GA comando temperatura colore (Kelvin)",
+      "fn_ct_status": "GA stato temperatura colore (Kelvin)",
+      "fn_smoke_ga": "GA stato allarme fumo",
+      "fn_co_ga": "GA stato allarme CO (opzionale)",
+      "fn_leak_ga": "GA stato allagamento",
+      "fn_co2_ga": "GA stato CO2 (ppm, DPT 9.008)",
+      "fn_fanspeed_cmd": "GA comando velocità ventola %",
+      "fn_fanspeed_status": "GA stato velocità ventola %"
+    },
+    "types": {
+      "onofflight": "Luce On/Off",
+      "dimmablelight": "Luce dimmerabile",
+      "rgblight": "Luce RGB (colore)",
+      "colortemperaturelight": "Luce bianco dinamico (temperatura colore)",
+      "onoffplug": "Presa (on/off)",
+      "temperaturesensor": "Sensore temperatura",
+      "humiditysensor": "Sensore umidità",
+      "lightsensor": "Sensore luminosità (Lux)",
+      "occupancysensor": "Sensore presenza",
+      "contactsensor": "Sensore contatto",
+      "windowcovering": "Tapparella / Tenda",
+      "thermostat": "Termostato (riscaldamento)",
+      "fan": "Ventola / VMC",
+      "smokecoalarm": "Rilevatore fumo/CO",
+      "waterleakdetector": "Rilevatore allagamento",
+      "airqualitysensor": "Sensore qualità aria (CO2)",
+      "robotvacuum": "Robot aspirapolvere (solo-flow, via PIN del nodo)"
+    },
+    "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:",
+      "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, poi clicca aggiorna.",
+      "reset_button": "Reset abbinamento",
+      "reset_confirm": "Rimuovere TUTTI i controller abbinati e riavviare l'abbinamento? I dispositivi spariranno da Alexa/Google/Apple.",
+      "reset_ok": "Abbinamento resettato. Il bridge è di nuovo in attesa di abbinamento."
+    }
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "Nome",
+    "knx_gw": "GW KNX"
+  }
+}

package/nodes/locales/it/knxUltimateMatterDevice.html

@@ -0,0 +1,56 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterDevice">
+# Dispositivo Matter (BETA)
+
+> Questo nodo è in **BETA**: funziona, ma alcuni dettagli potrebbero cambiare tra una release e l'altra.
+
+## Panoramica
+
+Il nodo Matter Device fa da ponte tra un **dispositivo Matter** e gli **indirizzi di gruppo KNX**. Il nodo opera tramite il nodo di configurazione *Matter Controller*, che associa (commissiona) i dispositivi nella propria fabric Matter.
+
+- **Controlla** qualsiasi dispositivo Matter associato dal bus KNX (on/off, dimmerazione, tapparelle, termostati, serrature, ...).
+- **Riporta** ogni attributo del dispositivo sugli indirizzi di gruppo KNX (stati, sensori, misure di potenza, batteria...).
+- Completamente generico: la lista delle mappature è costruita dagli **endpoint/cluster reali** esposti dal dispositivo.
+
+## Configurazione
+
+|Campo|Descrizione|
+|--|--|
+| GW KNX | Gateway KNX usato per i telegrammi |
+| Ctrl Matter | Il nodo di configurazione Matter Controller (dove associ i dispositivi) |
+| Dispositivo | Scegli il dispositivo Matter associato dalla lista con autocompletamento |
+| Mappature | Una riga per ogni mappatura indirizzo di gruppo ↔ cluster Matter |
+| Leggi lo stato all'avvio | Se abilitato, il nodo emette i valori correnti in cache al deploy/connessione |
+| PIN Input/Output del nodo | Abilita i pin input/output Node-RED per l'accesso Matter grezzo |
+
+## Mappature
+
+La lista delle destinazioni mostra le funzioni supportate con nomi comprensibili come *"Interruttore On/Off"* o *"Potenza istantanea consumata (W)"*, filtrate su ciò che il dispositivo espone realmente e con il valore attuale tra parentesi quadre.
+
+Ogni riga di mappatura ha una **direzione**:
+
+- **KNX → Matter (comando)**: un telegramma ricevuto sull'indirizzo di gruppo invoca un comando del cluster Matter o scrive un attributo. Esempio: GA `1/1/1` DPT 1.001 → `OnOff.on/off` (il payload booleano seleziona automaticamente on oppure off).
+- **Matter → KNX (stato)**: quando l'attributo Matter sottoscritto cambia, il valore viene convertito e scritto sull'indirizzo di gruppo. Le richieste `GroupValue_Read` ricevono in risposta il valore in cache.
+
+I cluster più comuni vengono convertiti automaticamente in valori adatti a KNX:
+
+|Cluster|Conversione|
+|--|--|
+| OnOff | booleano (DPT 1.001) |
+| LevelControl | 0-254 ↔ percentuale (DPT 5.001) |
+| WindowCovering | percent100ths ↔ percentuale (DPT 5.001), su/giù (DPT 1.008) |
+| ColorControl | mired ↔ Kelvin (DPT 7.600) |
+| Thermostat | centi-°C ↔ °C (DPT 9.001) |
+| Temperatura/Umidità | centi-unità ↔ unità (DPT 9.001/9.007) |
+| Luminosità | scala logaritmica ↔ Lux (DPT 9.004) |
+| PowerSource | mezzi-percento ↔ percentuale batteria (DPT 5.001) |
+| Potenza/Energia elettrica | mW ↔ W (DPT 14.056), mWh ↔ kWh (DPT 13.013) |
+
+Gli altri cluster/attributi passano senza conversione; il DPT che scegli esegue la codifica KNX finale.
+
+## PIN del nodo
+
+Se abiliti i PIN del nodo:
+
+- **Input**: invia comandi grezzi: `msg.payload = { endpointId: 1, clusterId: 6, command: "toggle" }` oppure scritture di attributi: `msg.payload = { endpointId: 1, clusterId: 8, attribute: "onLevel", value: 128 }`
+- **Output**: riceve ogni variazione di attributo (`msg.matter` contiene l'evento completo) e ogni evento dei cluster (pressioni di pulsanti ecc.).
+</script>

package/nodes/locales/it/knxUltimateMatterDevice.json

@@ -0,0 +1,109 @@
+{
+  "knxUltimateMatterDevice": {
+    "title": "Dispositivo Matter (BETA)",
+    "paletteLabel": "Matter Device (BETA)",
+    "matter_controller": "Ctrl Matter",
+    "matter_device": "Dispositivo",
+    "device_placeholder": "Clicca per scegliere un dispositivo Matter associato",
+    "mapping_help": "Aggiungi una riga per ogni mappatura. \"KNX → Matter\" invoca un comando del cluster (o scrive un attributo) quando arriva un telegramma sull'indirizzo di gruppo. \"Matter → KNX\" scrive il valore dell'attributo sull'indirizzo di gruppo ad ogni variazione (le richieste di lettura ricevono il valore in cache).",
+    "select_target": "-- seleziona la destinazione Matter --",
+    "stored_target": "Salvato",
+    "read_status_startup": "Leggi lo stato all'avvio",
+    "opt_yes_emit": "Sì, ed emetti i telegrammi KNX.",
+    "opt_no": "No",
+    "node_pins": "PIN Input/Output del nodo",
+    "node_pins_hide": "Nascondi",
+    "node_pins_show": "Mostra i PIN input/output del nodo",
+    "direction": {
+      "command": "KNX → Matter (comando)",
+      "status": "Matter → KNX (stato)"
+    },
+    "fields": {
+      "direction": "Direzione",
+      "target": "Endpoint / cluster / destinazione Matter",
+      "ga": "Indirizzo di gruppo",
+      "dpt": "DPT",
+      "ganame": "Nome"
+    },
+    "no_simple_targets": "Nessuna funzione supportata trovata su questo dispositivo (o il dispositivo non è ancora connesso).",
+    "endpoint": "Endpoint",
+    "friendly": {
+      "onoff_switch": "Interruttore On/Off (accendi/spegni)",
+      "onoff_toggle": "Inverti stato (toggle)",
+      "onoff_state": "Stato On/Off",
+      "level_set": "Imposta luminosità / livello (%)",
+      "level_state": "Luminosità / livello attuale (%)",
+      "colortemp_set": "Imposta temperatura colore (Kelvin)",
+      "colortemp_state": "Temperatura colore attuale (Kelvin)",
+      "cover_updown": "Tapparella Su/Giù",
+      "cover_stop": "Tapparella Stop",
+      "cover_position_set": "Porta tapparella in posizione (%)",
+      "cover_position_state": "Posizione attuale tapparella (%)",
+      "cover_tilt_set": "Inclina lamelle (%)",
+      "cover_tilt_state": "Inclinazione attuale lamelle (%)",
+      "thermo_localtemp": "Temperatura ambiente (°C)",
+      "thermo_heatsp_set": "Imposta setpoint riscaldamento (°C)",
+      "thermo_coolsp_set": "Imposta setpoint raffrescamento (°C)",
+      "thermo_heatsp_state": "Setpoint riscaldamento (°C)",
+      "thermo_coolsp_state": "Setpoint raffrescamento (°C)",
+      "fan_speed_set": "Imposta velocità ventola (%)",
+      "fan_speed_state": "Velocità ventola attuale (%)",
+      "lock_cmd": "Blocca/Sblocca serratura",
+      "lock_state": "Stato serratura (bloccata)",
+      "temp_measured": "Temperatura misurata (°C)",
+      "humidity_measured": "Umidità relativa (%)",
+      "illuminance_measured": "Luminosità ambiente (Lux)",
+      "occupancy_state": "Presenza rilevata",
+      "contact_state": "Stato contatto (chiuso/aperto)",
+      "battery_percent": "Livello batteria (%)",
+      "power_active": "Potenza istantanea consumata (W)",
+      "power_voltage": "Tensione (V)",
+      "power_current": "Corrente (A)",
+      "energy_imported": "Energia consumata (kWh)",
+      "identify_cmd": "Identifica dispositivo (lampeggio)",
+      "switch_position": "Posizione pulsante"
+    },
+    "devtype": {
+      "onofflight": "Luce On/Off",
+      "dimmablelight": "Luce dimmerabile",
+      "colortemperaturelight": "Luce bianco dinamico",
+      "extendedcolorlight": "Luce colorata",
+      "onoffpluginunit": "Presa (on/off)",
+      "dimmablepluginunit": "Presa (dimmerabile)",
+      "smartplug": "Presa smart",
+      "contactsensor": "Sensore contatto",
+      "lightsensor": "Sensore luminosità",
+      "occupancysensor": "Sensore presenza",
+      "temperaturesensor": "Sensore temperatura",
+      "humiditysensor": "Sensore umidità",
+      "pressuresensor": "Sensore pressione",
+      "flowsensor": "Sensore flusso",
+      "doorlock": "Serratura",
+      "windowcovering": "Tapparella/Tenda",
+      "thermostat": "Termostato",
+      "fan": "Ventilatore",
+      "genericswitch": "Pulsante/Interruttore",
+      "airqualitysensor": "Sensore qualità aria",
+      "smokecoalarm": "Rilevatore fumo/CO",
+      "waterleakdetector": "Rilevatore perdite acqua",
+      "roomairconditioner": "Condizionatore",
+      "airpurifier": "Purificatore aria",
+      "speaker": "Altoparlante",
+      "pumpcontroller": "Pompa",
+      "onofflightswitch": "Interruttore luce",
+      "dimmerswitch": "Interruttore dimmer",
+      "colordimmerswitch": "Interruttore dimmer colore",
+      "powersource": "Alimentazione",
+      "electricalsensor": "Sensore elettrico",
+      "bridgednode": "Dispositivo bridged",
+      "aggregator": "Bridge/Aggregatore",
+      "rootnode": "Nodo radice"
+    }
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "Nome",
+    "knx_gw": "GW KNX"
+  }
+}

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

@@ -0,0 +1,25 @@
+<script type="text/markdown" data-help-name="matter-config">
+# Controller Matter
+
+## Panoramica
+
+Questo nodo di configurazione è un **controller Matter** completo: crea una propria *fabric* Matter e vi associa (commissiona) i tuoi dispositivi Matter. I dispositivi associati diventano poi disponibili ai nodi **Matter Device**, che li mappano sugli indirizzi di gruppo KNX.
+
+Il controller comunica con i dispositivi tramite la **rete IP** (WiFi, Ethernet, oppure Thread attraverso un border router). Il commissioning via Bluetooth non è supportato: il dispositivo deve essere già raggiungibile in rete.
+
+## Associare un dispositivo
+
+1. Fai prima il **deploy** di questo nodo di configurazione (il controller deve essere in esecuzione).
+2. Riapri il nodo e inserisci il **codice di abbinamento**: il codice manuale a 11 cifre (es. `3497-011-2332`) oppure il contenuto del QR code (`MT:....`).
+3. Clicca **ASSOCIA**. Il commissioning può richiedere fino a un minuto.
+
+Se il dispositivo è nuovo di fabbrica e supporta solo il commissioning Bluetooth, associalo prima con l'app del produttore o con un altro controller Matter (Alexa, Google Home, Apple Home), poi usa la funzione **"condividi / abbina con altro hub"** di quel controller per generare un nuovo codice di abbinamento per KNX-Ultimate. In questo modo il dispositivo entra in più fabric contemporaneamente.
+
+## Archiviazione
+
+Le credenziali della fabric e i dispositivi associati sono salvati nella cartella `knxultimatestorage/matter` dentro la directory utente di Node-RED. Cancellando quella cartella si perdono tutte le associazioni.
+
+## Rimuovere un dispositivo
+
+Usa il pulsante cestino nella lista dei dispositivi associati. Il controller prova a decommissionare correttamente il dispositivo; se non è raggiungibile, viene comunque rimosso dalla fabric (potrebbe poi servire un reset di fabbrica del dispositivo).
+</script>

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

@@ -0,0 +1,26 @@
+{
+  "matter-config": {
+    "properties": {
+      "title": "Controller Matter",
+      "intro": "Questo nodo è un controller Matter (con una propria fabric). Associa qui i tuoi dispositivi Matter, poi usa il nodo \"Matter Device\" per mapparli sugli indirizzi di gruppo KNX. Fai prima il deploy del nodo, poi torna qui per associare i dispositivi.",
+      "node-config-input-name": "Nome",
+      "fabric_label": "Etichetta fabric",
+      "pairing_title": "Associa un nuovo dispositivo",
+      "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",
+      "pair_button": "ASSOCIA",
+      "devices_title": "Dispositivi associati",
+      "col_name": "Nome",
+      "col_product": "Prodotto",
+      "col_state": "Stato",
+      "no_devices": "Nessun dispositivo ancora associato.",
+      "unpair_confirm": "Rimuovere (decommissionare) il dispositivo",
+      "unpair_ok": "Dispositivo rimosso.",
+      "deploy_first": "Fai prima il deploy di questo nodo di configurazione, poi riprova.",
+      "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!"
+    }
+  }
+}

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

@@ -0,0 +1,64 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterBridge">
+# Matter Bridge (BETA)
+
+> 此节点处于 **BETA** 阶段：可以正常工作，但细节可能在版本之间发生变化。
+
+## 概述
+
+Matter Bridge 节点将 **KNX 组地址作为 Matter 设备**公开：Alexa、Google Home、Apple Home（或任何 Matter 控制器）只需配对此桥接器**一次**，即可看到您配置的所有 KNX 设备（使用您输入的名称），随时可通过 App 和语音控制。
+
+这与 *Matter Device* 节点方向相反：那里是 KNX 控制 Matter 设备，这里是 Matter 控制器控制 KNX。
+
+## 配置
+
+|字段|说明|
+|--|--|
+| KNX 网关 | 用于报文的 KNX 网关。**可选**：没有网关时桥接器以纯 Flow 模式工作——启用节点引脚并用 Flow 消息驱动每个设备 |
+| Matter 桥接器名称 | 桥接器本身在 Matter App 中显示的名称 |
+| 端口 | Matter 服务器的 UDP 端口（默认 5540）。每个 Node-RED 实例只能有一个桥接器节点。 |
+| 设备 | 在 Matter 上公开的 KNX 虚拟设备（见下文） |
+| 启动时读取状态组地址 | 启动时向每个状态 GA 发送 `GroupValue_Read`，以填充 Matter 属性 |
+
+## 设备
+
+每一行都是 Alexa 等显示的一个设备。选择**类型**，输入助手将使用的**名称**，然后填写组地址（带 ETS 自动补全）：
+
+|类型|组地址|
+|--|--|
+| 开关灯、插座 | 开/关命令 GA、开/关状态 GA (DPT 1.001) |
+| 调光灯 | + 调光 % 命令/状态 GA (DPT 5.001) |
+| RGB 彩色灯 | + RGB 颜色命令/状态 GA (DPT 232.600)。Matter 颜色（hue/saturation 或 XY，来自 App 的色轮）与 KNX RGB 三元组相互转换 |
+| 色温灯 | + 色温命令/状态 GA，开尔文 (DPT 7.600) |
+| 窗帘/卷帘 | 上/下 (DPT 1.008)、停止 (DPT 1.017)、位置 % 命令/状态 (DPT 5.001)、可选位置反转 |
+| 温控器（采暖） | 当前温度 GA、设定点命令/状态 GA (DPT 9.001) |
+| 风扇/新风 | 速度 % 命令/状态 GA (DPT 5.001) |
+| 传感器（温度、湿度、光照、人体、门磁） | 各一个状态 GA |
+| 烟雾/CO 报警器 | 烟雾报警状态 GA + 可选 CO 报警状态 GA (DPT 1.005)：手机上的紧急通知 |
+| 漏水探测器 | 漏水状态 GA (DPT 1.005) |
+| 空气质量传感器 (CO2) | CO2 状态 GA，ppm (DPT 9.008)；空气质量等级（好/一般/中等/差...）自动推导 |
+| 扫地机器人 | **仅 Flow**：无组地址。启用节点引脚：助手的命令（"开始清扫"、暂停/继续/回充）作为 `rvcmode`/`rvccommand` 到达输出；用 `msg.payload = { device, function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" }` 报告状态，用 `function: "rvcmode", value: "cleaning"\|"idle"` 报告模式。用任何 Node-RED 节点集成您的 Roomba/Roborock 并公开给 Alexa/Apple |
+
+- **命令 GA**：助手发送命令时写入 KNX 总线。
+- **状态 GA**：从总线读取，保持 Matter 属性（和 App）更新。
+
+## 配对
+
+1. **部署**，等待几秒，然后重新打开节点。
+2. 配对面板显示**二维码**和**手动配对码**：在 Alexa / Google Home / Apple Home 中扫描或输入（"添加 Matter 设备"）。
+3. 多个控制器可以与同一个桥接器配对（Matter 多 fabric）。
+
+**重置配对**按钮会移除所有已配对的控制器并重新开始配对广播。
+
+## 节点引脚
+
+如果启用节点的输入/输出引脚：
+
+- **输入**：从 Flow 更新虚拟设备的 Matter 状态，无需经过 KNX 总线：`msg.payload = { device: "厨房灯", function: "onoff", value: true }`（`device` 接受名称或内部 id；`function` 为 `onoff`、`level`、`position`、`temperature`、`humidity`、`illuminance`、`occupancy`、`contact`、`currenttemp`、`setpoint` 之一）。适合把 Flow 中计算的值（如虚拟传感器）公开给 Alexa 等。
+- **输出**：从 Matter 控制器收到的每个命令都转发到 Flow：`msg.topic` = 设备名称，`msg.payload` = 值，`msg.matter` = 原始命令。没有命令 GA 的设备成为**纯 Flow 设备**：命令到达您的 Flow，由您决定如何处理。
+
+## 说明
+
+- Node-RED 主机必须启用 **IPv6 link-local**（Matter 标准要求），并且控制器可在本地网络访问到它。
+- 桥接器身份保存在 Node-RED 用户目录的 `knxultimatestorage/matter` 中：重新部署**不**需要重新配对。
+- 设备重命名和新增会被控制器自动识别；移除的设备会从 App 中消失。
+</script>

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

@@ -0,0 +1,80 @@
+{
+  "knxUltimateMatterBridge": {
+    "title": "Matter Bridge (BETA)",
+    "bridge_name": "Matter 桥接器名称",
+    "port": "端口",
+    "devices_help": "添加要在 Matter 上公开的 KNX 设备。\"名称\"是 Alexa/Google/Apple 显示并用于语音命令的名称。命令 GA = 助手发送命令时写入；状态 GA = 从总线读取以保持 App 更新。",
+    "read_status_startup": "启动时读取状态组地址",
+    "opt_yes": "是",
+    "opt_no": "否",
+    "node_pins": "节点输入/输出引脚",
+    "node_pins_hide": "隐藏",
+    "node_pins_show": "显示节点输入/输出引脚",
+    "fields": {
+      "type": "设备类型",
+      "name": "名称（Alexa 等显示）",
+      "name_placeholder": "例如 厨房灯",
+      "invert": "反转位置 %"
+    },
+    "functions": {
+      "fn_onoff_cmd": "开/关 命令 GA",
+      "fn_onoff_status": "开/关 状态 GA",
+      "fn_level_cmd": "调光 % 命令 GA",
+      "fn_level_status": "调光 % 状态 GA",
+      "fn_sensor_ga": "传感器状态 GA",
+      "fn_updown": "上/下 命令 GA",
+      "fn_stop": "停止 命令 GA",
+      "fn_position_cmd": "位置 % 命令 GA",
+      "fn_position_status": "位置 % 状态 GA",
+      "fn_currenttemp": "当前温度 GA",
+      "fn_setpoint_cmd": "设定点 命令 GA",
+      "fn_setpoint_status": "设定点 状态 GA",
+      "fn_rgb_cmd": "RGB 颜色命令 GA (DPT 232.600)",
+      "fn_rgb_status": "RGB 颜色状态 GA (DPT 232.600)",
+      "fn_ct_cmd": "色温命令 GA（开尔文）",
+      "fn_ct_status": "色温状态 GA（开尔文）",
+      "fn_smoke_ga": "烟雾报警状态 GA",
+      "fn_co_ga": "CO 报警状态 GA（可选）",
+      "fn_leak_ga": "漏水状态 GA",
+      "fn_co2_ga": "CO2 状态 GA（ppm，DPT 9.008）",
+      "fn_fanspeed_cmd": "风扇速度 % 命令 GA",
+      "fn_fanspeed_status": "风扇速度 % 状态 GA"
+    },
+    "types": {
+      "onofflight": "开关灯",
+      "dimmablelight": "调光灯",
+      "rgblight": "RGB 彩色灯",
+      "colortemperaturelight": "色温灯（可调白光）",
+      "onoffplug": "插座（开/关）",
+      "temperaturesensor": "温度传感器",
+      "humiditysensor": "湿度传感器",
+      "lightsensor": "光照传感器 (Lux)",
+      "occupancysensor": "人体传感器",
+      "contactsensor": "门磁传感器",
+      "windowcovering": "窗帘 / 卷帘",
+      "thermostat": "温控器（采暖）",
+      "fan": "风扇 / 新风",
+      "smokecoalarm": "烟雾/CO 报警器",
+      "waterleakdetector": "漏水探测器",
+      "airqualitysensor": "空气质量传感器 (CO2)",
+      "robotvacuum": "扫地机器人（仅 Flow，通过节点引脚）"
+    },
+    "pairing": {
+      "title": "配对（Alexa、Google Home、Apple Home...）",
+      "not_running": "Matter 桥接器尚未运行。请先部署，等待几秒后点击刷新。",
+      "commissioned": "桥接器已与以下控制器配对：",
+      "awaiting": "等待配对。请在您的 Matter App 中扫描二维码或输入手动配对码：",
+      "qr_link": "在浏览器中打开二维码",
+      "deploy_first": "请先部署此节点，然后点击刷新。",
+      "reset_button": "重置配对",
+      "reset_confirm": "移除所有已配对的控制器并重新开始配对？设备将从 Alexa/Google/Apple 中消失。",
+      "reset_ok": "配对已重置。桥接器重新进入配对模式。"
+    }
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "名称",
+    "knx_gw": "KNX 网关"
+  }
+}

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

@@ -0,0 +1,56 @@
+<script type="text/markdown" data-help-name="knxUltimateMatterDevice">
+# Matter 设备 (BETA)
+
+> 此节点处于 **BETA** 阶段：可以正常工作，但细节可能在版本之间发生变化。
+
+## 概述
+
+Matter Device 节点在 **Matter 设备**和 **KNX 组地址**之间架起桥梁。该节点通过 *Matter 控制器*配置节点工作，后者将设备调试进自己的 Matter fabric。
+
+- 从 KNX 总线**控制**任何已配对的 Matter 设备（开/关、调光、窗帘、温控器、门锁等）。
+- 在 KNX 组地址上**跟踪**设备的每个属性（状态反馈、传感器、功率测量、电池等）。
+- 完全通用：映射列表基于设备**真实暴露的端点/集群**构建。
+
+## 配置
+
+|字段|说明|
+|--|--|
+| KNX 网关 | 用于报文的 KNX 网关 |
+| Matter 控制器 | Matter 控制器配置节点（在那里配对设备） |
+| 设备 | 通过自动补全选择已配对的 Matter 设备 |
+| 映射 | 每行一个组地址 ↔ Matter 集群映射 |
+| 启动时读取状态 | 启用后，节点在部署/连接时发送当前缓存的值 |
+| 节点输入/输出引脚 | 启用 Node-RED 引脚以进行原始 Matter 访问 |
+
+## 映射
+
+目标列表以易懂的名称显示支持的功能，例如*"开/关"*或*"瞬时功率 (W)"*，按设备实际暴露的功能过滤，并在方括号中显示当前值。
+
+每行映射有一个**方向**：
+
+- **KNX → Matter（命令）**：组地址上收到的报文调用 Matter 集群命令或写入属性。示例：GA `1/1/1` DPT 1.001 → `OnOff.on/off`（布尔值自动选择开或关）。
+- **Matter → KNX（状态）**：订阅的 Matter 属性变化时，其值被转换并写入组地址。`GroupValue_Read` 请求以缓存值应答。
+
+常见集群自动转换为适合 KNX 的值：
+
+|集群|转换|
+|--|--|
+| OnOff | 布尔 (DPT 1.001) |
+| LevelControl | 0-254 ↔ 百分比 (DPT 5.001) |
+| WindowCovering | percent100ths ↔ 百分比 (DPT 5.001)，上/下 (DPT 1.008) |
+| ColorControl | mireds ↔ 开尔文 (DPT 7.600) |
+| Thermostat | 厘°C ↔ °C (DPT 9.001) |
+| 温度/湿度 | 厘单位 ↔ 单位 (DPT 9.001/9.007) |
+| 照度 | 对数刻度 ↔ Lux (DPT 9.004) |
+| PowerSource | 半百分比 ↔ 电池百分比 (DPT 5.001) |
+| 电功率/电能 | mW ↔ W (DPT 14.056)，mWh ↔ kWh (DPT 13.013) |
+
+其他集群/属性原样传递；您选择的 DPT 执行最终的 KNX 编码。
+
+## 节点引脚
+
+如果启用节点引脚：
+
+- **输入**：发送原始命令：`msg.payload = { endpointId: 1, clusterId: 6, command: "toggle" }` 或属性写入：`msg.payload = { endpointId: 1, clusterId: 8, attribute: "onLevel", value: 128 }`
+- **输出**：接收每个属性变化（`msg.matter` 包含完整事件）和每个集群事件（按钮按下等）。
+</script>

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

@@ -0,0 +1,109 @@
+{
+  "knxUltimateMatterDevice": {
+    "title": "Matter 设备 (BETA)",
+    "paletteLabel": "Matter Device (BETA)",
+    "matter_controller": "Matter 控制器",
+    "matter_device": "设备",
+    "device_placeholder": "点击选择已配对的 Matter 设备",
+    "mapping_help": "每个映射添加一行。\"KNX → Matter\" 在组地址收到报文时调用集群命令（或写入属性）。\"Matter → KNX\" 在属性变化时将其值写入组地址（读请求以缓存值应答）。",
+    "select_target": "-- 选择 Matter 目标 --",
+    "stored_target": "已保存",
+    "read_status_startup": "启动时读取状态",
+    "opt_yes_emit": "是，并发送 KNX 报文。",
+    "opt_no": "否",
+    "node_pins": "节点输入/输出引脚",
+    "node_pins_hide": "隐藏",
+    "node_pins_show": "显示节点输入/输出引脚",
+    "direction": {
+      "command": "KNX → Matter（命令）",
+      "status": "Matter → KNX（状态）"
+    },
+    "fields": {
+      "direction": "方向",
+      "target": "Matter 端点 / 集群 / 目标",
+      "ga": "组地址",
+      "dpt": "DPT",
+      "ganame": "名称"
+    },
+    "no_simple_targets": "此设备上未找到支持的功能（或设备尚未连接）。",
+    "endpoint": "端点",
+    "friendly": {
+      "onoff_switch": "开/关（打开/关闭）",
+      "onoff_toggle": "切换状态（toggle）",
+      "onoff_state": "开/关状态",
+      "level_set": "设置亮度 / 级别 (%)",
+      "level_state": "当前亮度 / 级别 (%)",
+      "colortemp_set": "设置色温（开尔文）",
+      "colortemp_state": "当前色温（开尔文）",
+      "cover_updown": "窗帘 上/下",
+      "cover_stop": "窗帘 停止",
+      "cover_position_set": "窗帘移动到位置 (%)",
+      "cover_position_state": "当前窗帘位置 (%)",
+      "cover_tilt_set": "叶片倾斜 (%)",
+      "cover_tilt_state": "当前叶片倾斜 (%)",
+      "thermo_localtemp": "室内温度 (°C)",
+      "thermo_heatsp_set": "设置采暖设定点 (°C)",
+      "thermo_coolsp_set": "设置制冷设定点 (°C)",
+      "thermo_heatsp_state": "采暖设定点 (°C)",
+      "thermo_coolsp_state": "制冷设定点 (°C)",
+      "fan_speed_set": "设置风扇速度 (%)",
+      "fan_speed_state": "当前风扇速度 (%)",
+      "lock_cmd": "上锁/解锁",
+      "lock_state": "锁状态（已上锁）",
+      "temp_measured": "测量温度 (°C)",
+      "humidity_measured": "相对湿度 (%)",
+      "illuminance_measured": "照度 (Lux)",
+      "occupancy_state": "检测到人员",
+      "contact_state": "触点状态（闭合/断开）",
+      "battery_percent": "电池电量 (%)",
+      "power_active": "瞬时功率 (W)",
+      "power_voltage": "电压 (V)",
+      "power_current": "电流 (A)",
+      "energy_imported": "累计耗电量 (kWh)",
+      "identify_cmd": "识别设备（闪烁）",
+      "switch_position": "按钮位置"
+    },
+    "devtype": {
+      "onofflight": "开关灯",
+      "dimmablelight": "调光灯",
+      "colortemperaturelight": "色温灯",
+      "extendedcolorlight": "彩色灯",
+      "onoffpluginunit": "插座（开/关）",
+      "dimmablepluginunit": "插座（可调光）",
+      "smartplug": "智能插座",
+      "contactsensor": "门磁传感器",
+      "lightsensor": "光照传感器",
+      "occupancysensor": "人体传感器",
+      "temperaturesensor": "温度传感器",
+      "humiditysensor": "湿度传感器",
+      "pressuresensor": "压力传感器",
+      "flowsensor": "流量传感器",
+      "doorlock": "门锁",
+      "windowcovering": "窗帘",
+      "thermostat": "温控器",
+      "fan": "风扇",
+      "genericswitch": "按钮/开关",
+      "airqualitysensor": "空气质量传感器",
+      "smokecoalarm": "烟雾/CO 报警器",
+      "waterleakdetector": "漏水探测器",
+      "roomairconditioner": "空调",
+      "airpurifier": "空气净化器",
+      "speaker": "音箱",
+      "pumpcontroller": "水泵",
+      "onofflightswitch": "灯开关",
+      "dimmerswitch": "调光开关",
+      "colordimmerswitch": "彩色调光开关",
+      "powersource": "电源",
+      "electricalsensor": "电量传感器",
+      "bridgednode": "桥接设备",
+      "aggregator": "桥接器/聚合器",
+      "rootnode": "根节点"
+    }
+  },
+  "common": {
+    "ga": "GA",
+    "dpt": "DPT",
+    "name": "名称",
+    "knx_gw": "KNX 网关"
+  }
+}

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

@@ -0,0 +1,25 @@
+<script type="text/markdown" data-help-name="matter-config">
+# Matter 控制器
+
+## 概述
+
+此配置节点是一个完整的 **Matter 控制器**：它创建自己的 Matter *fabric* 并将您的 Matter 设备配对（调试）进来。配对后的设备可供 **Matter Device** 节点使用，将它们映射到 KNX 组地址。
+
+控制器通过 **IP 网络**（WiFi、以太网或经边界路由器的 Thread）与设备通信。不支持蓝牙配对：设备必须已经可以通过网络访问。
+
+## 配对设备
+
+1. 先**部署**此配置节点（控制器必须已运行）。
+2. 重新打开节点并输入**配对码**：11 位手动配对码（例如 `3497-011-2332`）或二维码内容（`MT:....`）。
+3. 点击**配对**。调试过程最多可能需要一分钟。
+
+如果设备是全新的且仅支持蓝牙配对，请先用厂商 App 或其他 Matter 控制器（Alexa、Google Home、Apple Home）配对，然后使用其**"与其他中枢共享/配对"**功能为 KNX-Ultimate 生成新的配对码。这样设备可以同时加入多个 fabric。
+
+## 存储
+
+Fabric 凭据和已配对设备保存在 Node-RED 用户目录下的 `knxultimatestorage/matter` 文件夹中。删除该文件夹将移除所有配对。
+
+## 移除设备
+
+使用已配对设备列表中的垃圾桶按钮。控制器会尝试正确地解除设备调试；如果设备无法访问，仍会从 fabric 中移除（之后可能需要对设备进行恢复出厂设置）。
+</script>