FB_TlsSocketListen

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.
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 | 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. |
Ein-/Ausgänge
VAR_IN_OUT
hListener : T_HSOCKET;
END_VAR
Name | Typ | Beschreibung |
---|---|---|
hListener | T_HSOCKET | Verbindungshandle zum neuen Listener-Socket. |
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) |