node-red-contrib-knx-ultimate
Version:
Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, KNX AI for diagnosticsand KNX routing between interfaces. Easy to use and highly configurable.
167 lines (115 loc) • 4.78 kB
HTML
<script type="text/markdown" data-help-name="knxUltimateWatchDog">
# WatchDog（看门狗）
用于检测与网关或特定 KNX 设备的连接状况，并在出现故障时执行自动化操作。
**功能**
1. 周期性发送报文并等待应答，若总线连接异常则向流程输出消息。提供两种检测级别（见下）。
2. 通过消息修改配置节点（Config-Node）的网关参数，实现 KNX/IP 路由器/接口的切换（如主备切换）。
3. 强制与 KNX 总线建立/断开连接。
## 以太网层与 KNX 双绞线层检测
WatchDog 提供两级检测：
- 以太网级：仅检测 KNX-Ultimate 与 KNX/IP 接口（Unicast）之间的连通性。
- 以太网 + KNX-TP：检查整条链路（以太网→TP）。需一个能响应读取请求的物理设备。
适合用于错误/连接故障告警（邮件通知、自动切换备份网关等）。
## 设置（SETTINGS）
| 属性 | 说明 |
|--|--|
| 网关 | 选择的 KNX 网关。|
| 需要监控的组地址 | 用于发送与监测的组地址；DPT 必须为 1.x（布尔）。|
| 节点名称 | 节点名称。|
| 自动启动看门狗定时器 | 在部署/启动时自动启动定时器。|
| 检查等级 (请查阅wiki) | 见上。|
**Check level**
> Ethernet：检测 KNX-Ultimate（Unicast）与 KNX/IP 接口之间的连接。<br/>
<img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/wiki/WatchDogEthernetLevel.png" width="90%"><br/>
> Ethernet + KNX TP：完整检测（支持路由器/接口）。向物理设备发送 Read 并等待 Response；以太网或 TP 的任何故障都会被上报。请在 ETS 中为某个执行器配置一条会响应读取的 **状态** GA。<br/>
<img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/wiki/WatchDogEthernetKNXTPLevel.png" width="90%"><br/>
## 高级选项
| 属性 | 说明 |
|--|--|
| 重试间隔 (秒) | 以秒为单位的检测间隔。|
| 出错前的重试次数 | 连续失败多少次后报告错误。|
# WatchDog 的输出
当内部检测发现故障，或某个 KNX-Ultimate 节点在流程中上报错误时，WatchDog 会输出消息。
**WatchDog 自身连接问题**
<a href="https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/WatchDog-Configuration" target="_blank">详见此处</a>
```javascript
msg = {
type: "BUSError",
checkPerformed: "Ethernet" // 或 "Eth+KNX",
nodeid: "23HJ.2355",
payload: true,
description: "..."
}
```
**你的某个 KNX-Ultimate 节点出现异常**
```javascript
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 修改网关配置**
```javascript
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: ""
}
```
**强制连接/断开**
```javascript
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
```javascript
msg.start = true; return msg; // 启动
```
```javascript
msg.start = false; return msg; // 停止
```
## 运行期修改 KNX/IP 网关设置
通过 `msg.setGatewayConfig` 更改 IP/Port/PhysicalAddress/Protocol 等；配置节点会应用并重连。Node-RED 重启后恢复为配置节点中的设置。所有参数均为可选。
```javascript
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：
```javascript
msg.setGatewayConfig = { IP:"224.0.23.12" }; return msg;
```
**强制断开并禁用自动重连**
```javascript
msg.connectGateway = false; return msg;
```
**强制连接并启用自动重连**
```javascript
msg.connectGateway = true; return msg;
```
## 参见
[Sample WatchDog](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---WatchDog)
</script>