本页目录
KNXnet/IP 隧道主站
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 和载荷。 |
验证重点
将测试组地址 1/2/3 绑定到一位开关量；与 ETS 组监视器中的同一报文值比较。
排障差异
- 隧道连接成功不代表组地址或 DPT 正确；Boolean 不支持数组，字符串需 len，不能用通用整数类型猜测 DPT。