FB_TlsSocketListen

FB_TlsSocketListen 1:

Mit dem Funktionsbaustein FB_TLsSocketListen kann über den TwinCAT TCP/IP Connection Server ein neuer, über TLS abgesicherter Listener-Socket geöffnet werden. Über einen Listener-Socket kann der TwinCAT TCP/IP Connection Server nach ankommenden Verbindungsanforderungen von Remote‑Clients horchen. Das mit dem Funktionsbaustein FB_TlsSocketCreate erzeugte Socket-Handle kann anschließend von dem Funktionsbaustein FB_SocketAccept verwendet werden, um eine eingehende Clientanforderung zu akzeptieren. Ein nicht mehr benötigter Listener-Socket wird mit dem Funktionsbaustein FB_SocketClose geschlossen. Auf einem Rechner kann nur ein Listener-Socket mit der gleichen IP-Portnummer geöffnet werden. Programmierbeispiele zur Verwendung dieses Funktionsbausteins finden Sie in unseren Samples.

FB_TlsSocketListen 2: Eingänge

VAR_INPUT
    sSrvNetId  : T_AmsNetId:='';
    sLocalHost : T_IPv4Addr:='';
    nLocalPort : UDINT:=0;
    flags      : ST_TlsListenFlags:=DEFAULT_TLSLISTENFLAGS;
    bExecute   : BOOL;
    tTimeout   : TIME:=T#5s;
END_VAR

Name

Typ

Beschreibung

hListener

T_HSOCKET

Socket-Handle, welches über den Funktionsbaustein FB_TlsSocketCreate erzeugt wurde.

sSrvNetId

T_AmsNetId

String mit der Netzwerkadresse des TwinCAT TCP/IP Connection Servers. Für den lokalen Rechner (default) kann auch ein Leerstring angegeben werden.

sLocalHost

T_IPv4Addr

Local-Server IP-Adresse (Ipv4) als String (z. B. 172.13.15.2). Für einen Server auf dem lokalen Rechner (default) kann auch ein Leerstring angegeben werden.

nLocalPort

UDINT

Local-Server IP-Port (z. B. 200).

flags

ST_TlsListenFlags

Zusätzliche (optionale) Server-Verbindungseinstellungen.

bExecute

BOOL

Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.

tTimeout

TIME 

Maximale Zeit, die bei der Ausführung des Funktionsbausteins nicht überschritten werden darf.

FB_TlsSocketListen 3: Ein-/Ausgänge

VAR_IN_OUT
    hListener : T_HSOCKET;
END_VAR

Name

Typ

Beschreibung

hListener

T_HSOCKET

Verbindungshandle zum neuen Listener-Socket.

FB_TlsSocketListen 4: Ausgänge

VAR_OUTPUT
    bBusy  : BOOL;
    bError : BOOL;
    nErrId : UDINT;
END_VAR

Name

Typ

Beschreibung

bBusy

BOOL

Bei aktiviertem Funktionsbaustein ist diese Ausgabe aktiv. Sie bleibt bis zur Quittierung aktiv.

bError

BOOL

Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.

nErrId

UDINT

Dieser Parameter liefert bei einem gesetzten bError-Ausgang die TwinCAT TCP/IP Connection Server Fehlernummer.

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS Bibliotheken (Kategoriegruppe)

TF6310 v3.3.15.0 oder neuer TwinCAT v3.1.0

PC oder CX (x86, x64, Arm®)

Tc2_TcpIp (Communication)