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

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

Navigazione: Home Panoramica: ChangelogFAQSicurezzaDocs: Barra lingue Nodo KNX Dispositivo: GatewayDispositivoProtezioni Altri Nodi KNX: Scene ControllerWatchDogLoggerGlobal ContextAlerterControllo CaricoViewerAuto ResponderTraduttore HAIoT Bridge HUE: BridgeLuceBatteriaPulsanteContattoAggiornamento SWSensore LuceMovimentoScenaTap DialTemperaturaConnettività Zigbee Esempi: 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 Contribuisci alla Wiki: Link


WatchDog

Controlla la connessione al Gateway o a uno specifico dispositivo KNX e consente azioni automatiche in caso di problemi.

Cosa fa

  1. 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).
  2. 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).
  3. Forza connessione/disconnessione del gateway verso il BUS KNX.

Verifiche a livello Ethernet e a livello KNX Twisted Pair

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.

Impostazioni (SETTINGS)

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.


Opzioni avanzate

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.

Messaggi in uscita dal WatchDog

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

Vedi qui.

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

Messaggi di ingresso (INPUT)

Il WatchDog accetta input dal flow ed emette output verso il flow. Di seguito il formato dei messaggi da inviare/attesi.

Avviare e fermare il WatchDog

START

msg.start = true;
return msg;

STOP

msg.start = false;
return msg;

Modificare al volo le impostazioni del KNX/IP Router/Interface

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;

Vedi anche

Sample WatchDog

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