WatchDog（看门狗）

用于检测与网关或特定 KNX 设备的连接状况，并在出现故障时执行自动化操作。

功能

周期性发送报文并等待应答，若总线连接异常则向流程输出消息。提供两种检测级别（见下）。
通过消息修改配置节点（Config-Node）的网关参数，实现 KNX/IP 路由器/接口的切换（如主备切换）。
强制与 KNX 总线建立/断开连接。

以太网层与 KNX 双绞线层检测

WatchDog 提供两级检测：

以太网级：仅检测 KNX-Ultimate 与 KNX/IP 接口（Unicast）之间的连通性。
以太网 + KNX-TP：检查整条链路（以太网→TP）。需一个能响应读取请求的物理设备。

适合用于错误/连接故障告警（邮件通知、自动切换备份网关等）。

设置（SETTINGS）

属性	说明
Gateway	选择的 KNX 网关。
Group Address to monitor	用于发送与监测的组地址；DPT 必须为 1.x（布尔）。
Name	节点名称。
Auto start the watchdog timer	在部署/启动时自动启动定时器。
Check level	见上。

Check level

Ethernet：检测 KNX-Ultimate（Unicast）与 KNX/IP 接口之间的连接。

Ethernet + KNX TP：完整检测（支持路由器/接口）。向物理设备发送 Read 并等待 Response；以太网或 TP 的任何故障都会被上报。请在 ETS 中为某个执行器配置一条会响应读取的状态 GA。

高级选项

属性	说明
Retry interval (in seconds)	以秒为单位的检测间隔。
Number of retry before giving an error	连续失败多少次后报告错误。

WatchDog 的输出

当内部检测发现故障，或某个 KNX-Ultimate 节点在流程中上报错误时，WatchDog 会输出消息。

WatchDog 自身连接问题

详见此处

msg = {
  type: "BUSError",
  checkPerformed: "Ethernet" // 或 "Eth+KNX",
  nodeid: "23HJ.2355",
  payload: true,
  description: "..."
}

你的某个 KNX-Ultimate 节点出现异常

msg = {
  type: "NodeError",
  checkPerformed: "Self KNX-Ultimate node reporting a red color status",
  nodeid: "23HJ.2355",
  payload: true,
  description: "...",
  completeError: {
    nodeid: "23HJ.2355",
    topic: "0/1/1",
    devicename: "Kitchen Light",
    GA: "0/1/1"
  }
}

通过 setGatewayConfig 修改网关配置

msg = {
  type: "setGatewayConfig",
  checkPerformed: "The Watchdog node changed the gateway configuration.",
  nodeid: "23HJ.2355",
  payload: true,
  description: "New Config issued to the gateway. IP:224.0.23.12 Port:3671 PhysicalAddress:15.15.1\nBindLocalInterface:Auto",
  completeError: ""
}

强制连接/断开

msg = {
  type: "connectGateway",
  checkPerformed: "The Watchdog issued a connection/disconnection to the gateway.",
  nodeid: "23HJ.2355",
  payload: true, // true=连接，false=断开
  description: "Connection",
  completeError: ""
}

输入消息（INPUT）

启动/停止 WatchDog

msg.start = true; return msg; // 启动

msg.start = false; return msg; // 停止

运行期修改 KNX/IP 网关设置

通过 msg.setGatewayConfig 更改 IP/Port/PhysicalAddress/Protocol 等；配置节点会应用并重连。Node-RED 重启后恢复为配置节点中的设置。所有参数均为可选。

msg.setGatewayConfig = { IP:"224.0.23.12", Port:3671, PhysicalAddress:"15.15.1", BindToEthernetInterface:"Auto",
  Protocol:"Multicast", importCSV:`"Group name" "Address" "Central" "Unfiltered" "Description" "DatapointType" "Security"
"Attuatori luci" "0/-/-" "" "" "" "" "Auto"
"Luci primo piano" "0/0/-" "" "" "" "" "Auto"
"Luce camera da letto" "0/0/1" "" "" "" "DPST-1-1" "Auto"` };
return msg;

仅更改 IP：

msg.setGatewayConfig = { IP:"224.0.23.12" }; return msg;

强制断开并禁用自动重连

msg.connectGateway = false; return msg;

强制连接并启用自动重连

msg.connectGateway = true; return msg;

参见

Sample WatchDog