HUE Ultimate
每个 Hue 设备使用一个 Controller
控制灯具、灯组、插座和场景,或接收按钮、运动/接触传感器和环境传感器的事件。选择 Hue 资源后,Controller 会显示其可用功能。
节点直接使用 Node-RED 消息:msg.topic 标识功能,msg.payload 提供数值。无需安装 KNX Ultimate。
安装
此公开测试版向所有人开放。通过 管理节点面板 → 安装 安装本包,然后重启 Node-RED。也可以在 Node-RED 用户目录(通常为 ~/.node-red)中执行以下命令。需要 Node.js 20.18.1 或更高版本及 Node-RED 3.1.1 或更高版本。只有需要 KNX 集成时才安装 node-red-contrib-knx-ultimate。
npm install node-red-contrib-hue-ultimate
使用 Node-RED 消息
启用输入/输出端口,在命令和状态字段中填写 topic 名称。将 KNX 网关留空;此时不需要 DPT,因此相应字段会隐藏。命令和状态应使用不同的 topic。名称必须精确匹配,不支持通配符。
KNX 模式
本包也可以与 KNX Ultimate 配合使用。 集成为原生功能:安装
node-red-contrib-knx-ultimate并选择其网关,即可启用 KNX 模式。同一组映射字段将使用组地址和 DPT,并提供已导入 ETS 项目的地址建议。命令和状态直接通过总线传输,这些映射无需额外的 Function 节点。
| 设置 | Node-RED 消息 | KNX 模式 |
|---|---|---|
| KNX 网关 | 留空 | 选择已有网关 |
| 映射字段 | 精确匹配的 topic,例如 living-room/on |
组地址,例如 1/1/1 |
| DPT | 隐藏且不使用 | 选择正确的数据点类型 |
| 命令与状态 | 通过 msg.topic 和 msg.payload |
通过 KNX 总线 |
选择网关时,请将已保存的 topic 替换为实际组地址,并选择正确的 DPT。已选择的网关离线时,节点仍保持 KNX 模式。要恢复使用 Node-RED 消息,请清空网关并重新配置 topic。
迁移现有流程
先备份完整的 Node-RED 用户目录。保留 KNX Ultimate 7,安装新包并重启。选择 Back up and convert,检查流程并点击 Deploy,然后再升级到 KNX Ultimate 8。节点 ID、连线和配置引用会保留。下载的 JSON 不包含受保护的凭据。
旧版独立 Hue 节点和多模式 Controller 均可转换。对应功能会保留,共用的 Hue Bridge 配置也会转换。