Node-RED 与 KNX 相遇
Expose KNX to Matter (BETA)
此节点处于 BETA 阶段：可以正常工作，但细节可能在版本之间发生变化。
概述
每个 Expose KNX to Matter 节点将一个 KNX 设备公开为 Matter 设备：已配对的控制器（Alexa、Google Home、Apple Home…）会以您输入的名称看到它，随时可通过 App 和语音控制。将它指向一个 Matter 桥接器配置节点（真正的桥接器，只需配对一次 - 配对二维码在那里），然后在流程中随意添加任意数量的设备节点。
这与 Matter Device 节点方向相反：那里是 KNX 控制 Matter 设备，这里是 Matter 控制器控制 KNX。
桥接器配对后更改设备类型会改变 Matter 端点结构。控制器可能会将旧端点保留为不可达；此时请重置并重新配对桥接器，或创建新的公开设备。
配置
| 字段 | 说明 |
|---|---|
| Matter 桥接器 | 此设备所属的 Matter 桥接器配置节点 |
| KNX 网关 | 用于报文的 KNX 网关。可选：没有网关时，设备通过节点引脚以纯 Flow 模式工作。项目中只有一个网关时会自动选择 |
| 名称 | Alexa 等显示并用于语音命令的名称 |
| 设备类型 | Matter 设备类型（见下文）；决定显示哪些组地址字段 |
| 启动时读取状态 | 启动时向状态 GA 发送 GroupValue_Read，以填充 Matter 属性 |
设备类型与组地址
| 类型 | 组地址 |
|---|---|
| 开关灯、插座 | 开/关命令 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 = { function: "rvcstate", value: "running"\|"docked"\|"charging"\|"paused"\|"error" } 报告状态，用 function: "rvcmode", value: "cleaning"\|"idle" 报告模式 |
- 命令 GA：助手发送命令时写入 KNX 总线。
- 状态 GA：从总线读取，保持 Matter 属性（和 App）更新。
高级兼容性
这些选项只会在适用于所选类型时显示。调光设备可以忽略某些控制器在 On 后立即发送的亮度命令。对于窗帘，交换打开 / 关闭会同时反转 KNX 二进制命令和百分比方向。窗帘滑块防抖会在写入 KNX 前合并快速的中间目标：0 使用自适应窗口（首个命令 400 ms，后续命令 150 ms）；1–5000 使用固定窗口。窗帘还可先乐观更新 Matter 位置，再由 KNX 状态 GA 修正。
节点引脚
如果启用节点的输入/输出引脚：
- 输入：从 Flow 更新 Matter 状态，无需经过 KNX 总线：
msg.payload = { function: "onoff", value: true }（function为onoff、level、rgb、colortemp、position、temperature、humidity、illuminance、occupancy、contact、currenttemp、setpoint、fanspeed、smoke、co、leak、co2、rvcstate、rvcmode之一）。适合把 Flow 中计算的值（如虚拟传感器）公开给 Alexa 等。 - 输出：从 Matter 控制器收到的每个命令都转发到 Flow：
msg.topic= 设备名称，msg.payload= 值，msg.matter= 原始命令。没有命令 GA 的设备成为纯 Flow 设备。
说明
- 设备的 Matter 身份与此节点绑定：删除节点并新建一个后，App 会看到一个全新的设备。
- 添加/重命名/移除的设备节点会在几秒内被已配对的控制器识别，无需重新配对桥接器。