FB_SocketListen

Mit dem Funktionsbaustein FB_SocketListen kann über den TwinCAT TCP/IP Connection Server ein neuer Listener-Socket geöffnet werden. Über einen Listener-Socket kann der TwinCAT TCP/IP Connection Server nach ankommenden Verbindungsanforderungen von Remote‑Clients horchen. Beim Erfolg wird am hListner-Ausgang das dazugehörige Verbindungshandle zurückgeliefert. Dieses Handle wird von dem Funktionsbaustein FB_SocketAccept benötigt. 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.

Eingänge

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

Name	Typ	Beschreibung
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 loka-len Rechner (default) kann auch ein Leerstring angegeben werden.
nLocalPort	UDINT	Local-Server IP-Port (z. B. 200).
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.

Ausgänge

VAR_OUTPUT
    bBusy      : BOOL;
    bError     : BOOL;
    nErrId     : UDINT;
    hListener  : T_HSOCKET;
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.
hListener	T_HSOCKET	Verbindungshandle zum neuen Listener-Socket.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.0	PC oder CX (x86, x64, Arm®)	Tc2_TcpIp (Communication)