it WatchDog Configuration - Supergiovane/node-red-contrib-knx-ultimate GitHub Wiki
🌐 Language: EN | IT | DE | FR | ES | 简体中文
Navigazione: Home Panoramica: Changelog • FAQ • Sicurezza • Docs: Barra lingue Nodo KNX Dispositivo: Gateway • Dispositivo • Protezioni Altri Nodi KNX: Scene Controller • WatchDog • Logger • Global Context • Alerter • Controllo Carico • Viewer • Auto Responder • Traduttore HA • IoT Bridge HUE: Bridge • Luce • Batteria • Pulsante • Contatto • Aggiornamento SW • Sensore Luce • Movimento • Scena • Tap Dial • Temperatura • Connettività Zigbee Esempi: Logger • Switch Light • Dimming • RGB color • RGBW color + White • Command a scene actuator • Datapoint 213.x 4x Setpoint • Datapoint 222.x 3x Setpoint • Datapoint 237.x DALI diags • Datapoint 2.x 1 bit proprity • Datapoint 22.x RCHH Status • Datetime to BUS • Read Status • Virtual Device • Subtype decoded • Alexa • Apple Homekit • Google Home • Switch on/off POE port of Unifi switch • Set configuration by msg • Scene Controller node • WatchDog node • Global Context node • Alerter node • Load control node • Viewer node • MySQL, InfluxDB, MQTT Sample Contribuisci alla Wiki: Link
Controlla la connessione al Gateway o a uno specifico dispositivo KNX e consente azioni automatiche in caso di problemi.
Cosa fa
- Verifica la salute della comunicazione KNX inviando periodicamente un telegramma, attende una risposta e invia un msg al flow se la connessione al BUS è interrotta. Due livelli di controllo (vedi sotto).
- Modifica via messaggio i parametri del nodo di configurazione (Config‑Node), quindi la connessione verso il tuo KNX/IP Router/Interface (es. switch tra due gateway per backup).
- Forza connessione/disconnessione del gateway verso il BUS KNX.
Il WatchDog ha due livelli di controllo.
- Primo livello: controlla solo la connessione tra KNX‑Ultimate e l'interfaccia KNX/IP in modalità unicast.
- Secondo livello: controlla l'intera catena, dal nodo Gateway KNX‑Ultimate alla rete Ethernet fino al KNX TP e viceversa; richiede un dispositivo fisico che risponda a richieste di lettura.
Il WatchDog è molto utile per notificare errori e problemi di connessione: puoi inviare un'email all'installatore KNX o passare automaticamente a un gateway di backup.
Proprietà | Descrizione |
---|---|
Gateway | Gateway KNX selezionato. |
Group Address to monitor | GA a cui inviare il telegramma e da cui attendere risposta sul BUS KNX. Il Datapoint deve essere DPT 1.x (boolean). |
Name | Nome del nodo. |
Auto start the watchdog timer | Avvio automatico del timer al deploy o all'avvio di Node‑RED. |
Check level | Vedi sotto. |
Check level
Ethernet: controlla la connessione tra il Gateway KNX‑Ultimate (in unicast) e la tua KNX/IP Interface.
Ethernet e KNX TP: controllo completo (KNX/IP Router o Interface). Verifica la comunicazione con un dispositivo fisico inviando una richiesta di lettura e attendendo una risposta. Qualsiasi problema lato Ethernet o KNX TP viene segnalato. Riserva una GA di "Status” in ETS su un attuatore che risponda ai Read.
Proprietà | Descrizione |
---|---|
Retry interval (in seconds) | Intervallo (s) tra due verifiche: il nodo invia un telegramma al BUS con questa cadenza. |
Number of retry before giving an error | Dopo questo numero di tentativi senza risposta, il nodo genera errore. |
Il nodo emette un messaggio quando riceve un errore da un qualsiasi nodo KNX‑Ultimate nel flow, oppure quando il watchdog interno intercetta un errore di comunicazione sul BUS KNX.
In caso di problema di connessione rilevato dal WatchDog
msg = {
type: "BUSError",
checkPerformed: "Ethernet" // oppure "Eth+KNX"
nodeid: "23HJ.2355",
payload: true,
description: "..."
}
In caso di errore di un tuo nodo 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"
}
}
Se viene richiamata una nuova configurazione gateway tramite 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: ""
}
Connessione/Disconnessione forzata
msg = {
type: "connectGateway",
checkPerformed: "The Watchdog issued a connection/disconnection to the gateway.",
nodeid: "23HJ.2355",
payload: true, // true=connessione, false=disconnessione
description: "Connection",
completeError: ""
}
Il WatchDog accetta input dal flow ed emette output verso il flow. Di seguito il formato dei messaggi da inviare/attesi.
START
msg.start = true;
return msg;
STOP
msg.start = false;
return msg;
Con msg.setGatewayConfig
puoi cambiare IP, Porta, Indirizzo Fisico, Protocollo, ecc., del gateway configurato nel Config‑Node. Il Config‑Node applica i parametri e si riconnette. Al riavvio di Node‑RED, le impostazioni tornano a quelle del Config‑Node.
Tutti i parametri sono opzionali.
// IP, Port, PhysicalAddress, BindToEthernetInterface ("Auto" o nome scheda, es. "en0"), Protocol: "TunnelUDP"|"TunnelTCP"|"Multicast"
// importCSV: contenuto ETS CSV/ESF (vedi wiki Gateway Config)
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;
Per cambiare solo l'IP:
msg.setGatewayConfig = { IP:"224.0.23.12" };
return msg;
Forzare disconnessione e disabilitare i tentativi di auto‑reconnect
msg.connectGateway = false;
return msg;
Forzare connessione e abilitare i tentativi di auto‑reconnect
msg.connectGateway = true;
return msg;