KnxMaster
插件用途
KNXnet/IP 隧道组地址读写驱动
选择入口
进入“开发配置 → 采集配置”，创建设备并在“采集插件”中选择“KnxMaster”。
支持的通道和数据类型
| 通道类型 | 配置前检查 |
|---|---|
| UDP | 确认本地绑定地址、端口和防火墙规则，并核对报文来源。 |
可选数据类型： Boolean、Byte、Int16、UInt16、Int32、UInt32、Float、String
插件参数
KNX 主站只支持 UdpSession 通道；需要先创建 UDP 会话并配置本地绑定地址。读写超时、失败重试、写优先、数据解析顺序等公共字段按采集配置配置，当前默认数据解析顺序为 ABCD。
运行参数
| 参数 | 说明 |
|---|---|
| 隧道心跳间隔 | 默认：60000；填写：文本输入。隧道心跳间隔；单位为毫秒，默认 60000；必须大于零 |
启动目标时插件先建立 KNXnet/IP 隧道，随后按该间隔发送连接状态心跳；心跳失败会把隧道标记为离线并在下一次读取时重新握手。每个组地址变量独立读取，组值长度必须为 1～254 字节；Boolean 变量不能配置数组。
地址规则
- KNX 组地址必须使用 主/中/子 格式，例如 1/2/3；主组 0..31，中组 0..7，子组 0..255。读取长度和写入数据均为 1..254 字节。
- 字符串变量需要在地址中加入
len=长度转换选项，长度必须能使最终组值保持在 1～254 字节内。
设备调试
进入“开发配置 → 采集配置”，选择当前设备后点击“更多功能”并打开“调试”。
专用调试页
当前插件使用公共读写和消息面板验证 KNX 组地址与总线响应。
| 功能 | 作用 |
|---|---|
| 读写 | 按 KNX 组地址和数据点类型读取或写入测试值，并显示结果。写入前确认目标组地址用途。 |
| 消息 | 查看总线报文和协议日志，用于核对源地址、目标组地址、APCI 和载荷。 |
验证重点
使用一个已确认的现场地址执行读取，返回值、数据类型和字节顺序应与点表一致；可写点位写入后应按现场要求回读。
排障差异
- 地址读取失败：按本页地址规则逐项核对站号、寄存器或节点标识，并确认数据类型与设备点表一致。