de WatchDog Configuration - Supergiovane/node-red-contrib-knx-ultimate GitHub Wiki

🌐 Language: EN | IT | DE | 简体中文

Navigation: Startseite Übersicht: ChangelogFAQSicherheitDoku: Sprachleiste KNX Geräteknoten: GatewayGerätKnotenschutz Weitere KNX‑Knoten: SzenencontrollerWatchDogLoggerGlobal ContextAlerterLaststeuerungViewerAuto‑ResponderHA‑Übersetzer HUE: BridgeLichtBatterieTasterKontaktGeräte‑SW‑UpdateLichtsensorBewegungSzeneTap DialTemperaturZigbee‑Konnektivität Beispiele: LoggerSwitch LightDimmingRGB colorRGBW color + WhiteCommand a scene actuatorDatapoint 213.x 4x SetpointDatapoint 222.x 3x SetpointDatapoint 237.x DALI diagsDatapoint 2.x 1 bit proprityDatapoint 22.x RCHH StatusDatetime to BUSRead StatusVirtual DeviceSubtype decodedAlexaApple HomekitGoogle HomeSwitch on/off POE port of Unifi switchSet configuration by msgScene Controller nodeWatchDog nodeGlobal Context nodeAlerter nodeLoad control nodeViewer nodeMySQL, InfluxDB, MQTT Sample


WatchDog

Überwacht die Verbindung zum Gateway oder zu einem bestimmten KNX‑Gerät und ermöglicht automatische Maßnahmen bei Störungen.

Funktion

  1. Prüft die KNX‑Kommunikation durch periodische Telegramme, wartet auf Antwort und sendet bei Ausfall eine Nachricht in den Flow. Zwei Prüf‑Levels (siehe unten).
  2. Ändert per Nachricht die Parameter des Config‑Nodes (KNX/IP‑Router/Interface), z. B. Umschalten auf ein Backup‑Gateway.
  3. Erzwingt Verbindungsaufbau/‑abbau des Gateways zum KNX‑BUS.

Prüfungen auf Ethernet‑Ebene und KNX‑Twisted‑Pair

Der WatchDog bietet zwei Prüfstufen:

  • Ethernet‑Level: prüft nur die Verbindung zwischen KNX‑Ultimate und KNX/IP‑Interface (Unicast).
  • Ethernet+KNX‑TP: prüft die gesamte Strecke bis zum TP‑Medium; erfordert ein physisches Gerät, das auf Read‑Requests antwortet.

Ideal zum Signalisieren von Fehlern/Verbindungsproblemen (E‑Mail, automatisches Failover auf Backup‑Gateway etc.).

Einstellungen (SETTINGS)

Property Beschreibung
Gateway Gewähltes KNX‑Gateway.
Group Address to monitor GA, an die gelesen wird und von der eine Antwort erwartet wird. DPT muss 1.x (Boolean) sein.
Name Node‑Name.
Auto start the watchdog timer Timer beim Deploy/Start automatisch starten.
Check level Siehe oben.

Check level

Ethernet: Verbindung zwischen KNX‑Ultimate (Unicast) und KNX/IP‑Interface.


Ethernet und KNX TP: Vollständige Prüfung (Router/Interface). Read an physisches Gerät, Antwort erwarten; Fehler auf Ethernet/TP werden gemeldet. In ETS eine Status‑GA einrichten, die auf Read antwortet.


Erweiterte Optionen

Property Beschreibung
Retry interval (in seconds) Intervall in Sekunden zwischen zwei Prüfungen.
Number of retry before giving an error Anzahl erfolgloser Versuche bis zur Fehlermeldung.

Ausgaben des WatchDog

Der Node gibt Nachrichten aus, wenn eigene Prüfungen Fehler melden oder wenn ein KNX‑Ultimate‑Node im Flow einen Fehlerstatus meldet.

Bei WatchDog‑eigenem Verbindungsproblem

Siehe hier.

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

Wenn einer deiner KNX‑Ultimate‑Nodes Probleme hat

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"
  }
}

Neue Gateway‑Konfiguration via 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: ""
}

Erzwungener Verbindungs‑Auf/Abbau

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

Eingangs‑Nachrichten (INPUT)

WatchDog starten/stoppen

msg.start = true; return msg; // Start
msg.start = false; return msg; // Stop

KNX/IP‑Gateway‑Einstellungen zur Laufzeit ändern

Mit msg.setGatewayConfig IP/Port/PhysicalAddress/Protocol usw. ändern; der Config‑Node übernimmt und verbindet neu. Beim Neustart gelten wieder die Config‑Node‑Werte. Alle Parameter optional.

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;

Nur IP ändern:

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

Verbindung trennen und Auto‑Reconnect deaktivieren

msg.connectGateway = false; return msg;

Verbindung herstellen und Auto‑Reconnect aktivieren

msg.connectGateway = true; return msg;

Siehe auch

Sample WatchDog

⚠️ **GitHub.com Fallback** ⚠️