✕
✕

Connect

TwinCAT TIA
Geräte Herstellerübergreifende Geräte Open Protocol Geräte OpenProtocolDevices Ein Gerät

ns=2;s=DEPRAG Smart/Devices/General/OpenProtocol/OpenProtocolDevices/0/Connect

Stellt die Verbindung zu einem Open Protocol Gerät her. DEPRAG Smart agiert dabei als Open Protocol Client, der die Verbindung zu einem Open Protocol Server herstellt.

Parameter:

    Ip
    IP Adresse des Geräts, unter der der Open Protocol Server erreichbar ist.
    Port
    Port des Geräts, unter dem der Open Protocol Server erreichbar ist.
    TimeoutInSeconds
    Maximale Zeit in Sekunden für den Verbindungsaufbau zum Open Protocol Server. Kann innerhalb des Zeitintervalls keine Verbindung aufgebaut werden, wird ein Fehler ausgegeben.
    EnableKeepAlive
    Legt fest, ob Keep-Alive-Nachrichten versendet werden sollen, um zu überprüfen, ob die Verbindung zum Open Protocol Server noch besteht.
    Revision
    Beschreibt, wie die gesendete Nachricht zu interpretieren ist. Eine Nachricht kann verschiedene Änderungsstände (=Revision) haben.

Rückgabewert:

    Connect
    Eine Variable vom Typ OpcMethodReturnValueVoid. Die Methode hat keine befehlsspezifischen Rückgabewerte.

Beispiele:

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

Beckhoff Parameter:

    bOpenProtocolConnect
    Eine boolesche Variable, über welche die Ausführung des Connect-Befehls getriggert werden kann.
    OutputDataOpenProtocolConnect
    Eine Instanz der "ST_VoidOutputData" Struktur, in welche der Rückgabewert der Connect-Methode geschrieben wird.
    hrOpenProtocolConnect
    Hiermit kann die Ausführung des Befehls überwacht werden. Fehler-Codes haben den Typ "HRESULT".
    fbOpenProtocol
    Eine Instanz des, mit der DEPRAG Smart-Bibliothek gelieferten, "FB_OpenProtocol" Funktionsbausteins.
    sDeviceId
    Ein DINT-Wert, der das Gerät in der Liste, der am DEPRAG Smart OPC UA Server registrierten Geräte, identifiziert.
    sIp
    Eine STRING(255)-Variable, die die IP Adresse des Geräts enthält, unter der der Open Protocol Server erreichbar ist.
    nPort
    Eine DINT-Variable, welche den Port des Geräts beschreibt, unter dem der Open Protocol Server erreichbar ist.
    nTimeOutInSeconds
    Eine DINT-Variable, welche die maximale Zeit in Sekunden für den Verbindungsaufbau zum Open Protocol Server enthält.
    bEnableKeepAlive
    Eine boolesche Variable, die festlegt, ob Keep-Alive-Nachrichten versendet werden sollen.
    nRevision
    Eine DINT-Variable, welche beschreibt, wie die gesendete Nachricht zu interpretieren ist. Eine Nachricht kann verschiedene Änderungsstände (=Revision) haben.
    ConnectionHandle
    Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle". 


VAR
            bOpenProtocolConnect    : BOOL;
            OutputDataOpenProtocolConnect   : ST_VoidOutputData;
            hrOpenProtocolConnect    : HRESULT;

            fbOpenProtocol   : FB_OpenProtocol;
END_VAR

hrOpenProtocolConnect := fbOpenProtocol.Connect(
            bExecute    := bOpenProtocolConnect,
            ConnectionHandle := depragSmartConnection.ConnectionHandle,
            sDeviceId   := '0',
            sIp     := '000.000.000.000',
            nPort    := 4545,
            nTimeOutInSeconds  := 5,
            bEnableKeepAlive := TRUE,
            nRevision   := 1,
            OutputData   => OutputDataOpenProtocolConnect);
IF hrOpenProtocolConnect <> S_FALSE THEN 
            bOpenProtocolConnect := 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.