IsReachable

TwinCAT TIA
Netzwerk Netzwerk-Werkzeuge

ns=2;s=DEPRAG Smart/Network/Tools/IsReachable

Mit diesem Befehl kann die Erreichbarkeit eines spezifizierten Ports an einer konfigurierten IP-Adresse überprüft werden.

Parameter:

    TimeOutInMilliseconds
    Maximale Zeitspanne in Millisekunden (nach dem Senden der Meldung) auf die auf eine Antwort von der HostAddresse gewartet wird. Wird die Zeitspanne überschritten, wird die Prüfung als nicht erreichbar abgebrochen.

Rückgabewert:

    IsReachable
    Eine Struktur-Variable vom Typ OpcMethodReturnValueBoolean. In der Eigenschaft Result sind die befehlsspezifischen Rückgabewerte enthalten.
      Result
      Eine boolesche Variable, die angibt, ob der spezifizierte Port der angegebenen HostAddress erreichbar ist.

Beispiele:

Neben den bereits erläuterten Parametern sind für die Implementierung in TwinCAT 3 nachfolgende Variablen anzulegen / zu übergeben:

Beckhoff Parameter:

    bIsReachable
    Eine boolesche Variable, über welche die Ausführung des IsReachable-Befehls getriggert werden kann.
    OutputDataIsReachable
    Eine Instanz der "ST_BoolOutputData" Struktur in welche der Rückgabewert der IsReachable-Methode geschrieben wird.
    hrIsReachable
    Hiermit kann die Ausführung des Befehls überwacht werden. Fehler-Codes haben den Typ "HRESULT".
    fbTools
    Eine Instanz des, mit der DEPRAG Smart-Bibliothek gelieferten, "FB_Tools" Funktionsbausteins.
    ConnectionHandle
    Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle".


VAR
    bIsReachable  : BOOL;
    OutputDataIsReachable : ST_BoolOutputData;
    hrIsReachable  : HRESULT;
 
    fbTools                  : FB_Tools;
END_VAR

hrIsReachable := fbTools.IsReachable(bIsReachable, depragSmartConnection.ConnectionHandle, '10.10.222.101', 8883, 5000, OutputData => OutputDataIsReachable);
IF hrIsReachable <> S_FALSE THEN 
    bIsReachable := FALSE;
END_IF
                                                    

Für Beispiele und Erklärungen bezüglich der Aufrufe von Knoten via Siemens TIA Portal sei an dieser Stelle auf den Unterpunkt "Siemens TIA Portal" in Abschnitt "Erste Schritte" verwiesen.