FB_SocketListen

FB_SocketListen 1:

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 auf ankommende Verbindungsanforderungen von Remote-Clients achten. Bei 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.

VAR_INPUT

VAR_INPUT
    sSrvNetId       : T_AmsNetId := '';
    sLocalHost      : STRING(15);
    nLocalPort      : UDINT;
    bExecute        : BOOL;
    tTimeout        : TIME := T#5s;
END_VAR

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

sLocalHost: Die 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: Der Local-Server IP-Port (z.B.: 200).

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

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

VAR_OUTPUT

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

bBusy: Dieser Ausgang wird bei der Aktivierung des Funktionsbausteins gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.

bError: Dieser Ausgang wird, nachdem der bBusy-Ausgang zurückgesetzt wurde, gesetzt, sollte ein Fehler bei der Übertragung des Kommandos erfolgen.

nErrId: Liefert bei einem gesetzten bError-Ausgang die TwinCAT TCP/IP Connection Server Fehlernummer.

hListener: Das Verbindungshandle zum neuen Listener-Socket.

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS Bibliotheken

Alle TwinCAT v2.8.0 Versionen und höher

PC oder CX (x86)

TcpIp.Lib

( Standard.Lib; TcBase.Lib; TcSystem.Lib werden automatisch eingebunden )

TwinCAT v2.10.0 Build >= 1301

CX (ARM)