Nella versione 8 usa KNX Utility e seleziona WatchDog. Le impostazioni qui sotto descrivono questa funzione. Il vecchio nodo separato non è più incluso.

KNX Utility · Passare dalla versione 7

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 da monitorare GA a cui inviare il telegramma e da cui attendere risposta sul BUS KNX. Il Datapoint deve essere DPT 1.x (boolean).
Nome nodo Nome del nodo.
Avvia il watchdog automaticamente Avvio automatico del timer al deploy o all’avvio di Node-RED.
Ascolta gli errori dei nodi KNX-Ultimate Attiva per impostazione predefinita. Emette un NodeError quando un nodo KNX-Ultimate associato al gateway selezionato, incluso KNX Device, segnala uno stato di errore rosso. Disattivandola vengono soppressi solo questi messaggi NodeError; i controlli BUS e i messaggi di comando del WatchDog restano attivi.
Livello controllo (vedi Wiki) 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
Riprova ogni (in secondi) Intervallo (s) tra due verifiche: il nodo invia un telegramma al BUS con questa cadenza.
Dopo questo numero di tentativi, segnala l’errore Dopo questo numero di tentativi senza risposta, il nodo genera errore.

Messaggi in uscita dal WatchDog

Il WatchDog emette sempre i propri messaggi di controllo del BUS e di comando. Quando Ascolta gli errori dei nodi KNX-Ultimate è attiva, emette anche gli errori segnalati dai nodi KNX-Ultimate, incluso KNX Device, associati al gateway selezionato.

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

Quando l’ascolto è attivo e uno dei nodi KNX-Ultimate segnala un errore


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