SOCKET_INFO

Die SOCKET_INFO-Anweisung gibt Informationen für eine Socket-Instanz zurück, wie z. B. Fehlercodes und den Ausführungsstatus. Die Ausgänge werden synchron vom Programm-Scan aktualisiert.
Unterstützte Sprachen: Funktionsblockdiagramm, Kontaktplan und Strukturierter Text.
Diese Anweisung gilt für
Micro820
 L20E-,
Micro850
 L50E- und
Micro870
 L70E-Controller.
SOCKET_INFO
SOCKET_INFO
SOCKET_INFO-Parameter
Parameter
Parametertyp
Datentyp
Execute
Eingang
BOOL
Anweisungsblock aktivieren.
  • TRUE: Anstiegsflanke erkannt. Startet den Anweisungsblock unter der Voraussetzung, dass der letzte Vorgang abgeschlossen ist.
  • FALSE: Keine Anstiegsflanke erkannt.
Instance
Eingang
UDINT
Kopieren Sie den zurückgegebenen Socket-Handler einer SOCKET_CREATE- oder SOCKET_ACCEPT-Anweisung, um den entsprechenden Socket zu löschen.
  • Kopieren Sie für die Socket-Typen von UDP- und TCP-Client Socket den zurückgegebenen Socket-Handler aus einer SOCKET_CREATE-Anweisung.
  • Kopieren Sie für den Socket-Typ des TCP-Servers vom zurückgegebenen Socket-Handler aus einer SOCKET_ACCEPT-Anweisung.
Wenn Instance = 0 ist, wird eine Zusammenfassung aller Socket-Instanzen zurückgegeben.
ClrDiagCnt
Eingang
BOOL
  • TRUE: Zählerinformationen der Diagnose des Transmission Control Protocol (TCP) oder User Datagram Protocol (UDP) werden gelöscht.
  • FALSE: Kein Löschen der TCP- oder UDP-Zähler-Informationen.
Beispiel: TCP und UDP, OtherInfo Array-Index 1–6.
Wenn Instance = 0 ist, wird OtherInfo Array-Index 7–14 gelöscht.
Done
Ausgang
BOOL
Gibt an, wenn der Vorgang abgeschlossen ist.
  • TRUE: Vorgang erfolgreich abgeschlossen
  • FALSE: Vorgang wird ausgeführt oder eine Fehlerbedingung ist aufgetreten.
Die Ausgabe wird synchron vom Programm-Scan aktualisiert.
Busy
Ausgang
BOOL
  • TRUE: Der Vorgang ist nicht abgeschlossen.
  • FALSE: Vorgang ist abgeschlossen.
Die Ausgabe wird synchron vom Programm-Scan aktualisiert.
Error
Ausgang
BOOL
Gibt an, dass ein Fehler aufgetreten ist.
TRUE: Es wurde ein Fehler erkannt.
FALSE: Kein Fehler.
Die Ausgabe wird synchron vom Programm-Scan aktualisiert.
Status
Ausgang
SOCK_STATUS
Der Status wird mithilfe der Datentyp SOCK_STATUS definiert, welche ErrorID-, SubErrorID- und StatusBits-Informationen enthält.
Die Ausgabe wird synchron vom Programm-Scan aktualisiert.
SocketType
Ausgang
USINT
Socket-Instanztyp:
  • 0 - Nicht verwendet
  • 1 - TCP
  • 2 - UDP
Wenn Socket_Info Instance 0 ist, wird SocketType als 0 angezeigt.
StreamType
Ausgang
USINT
Socket-Streamtyp:
  • 0 - Kein
  • 1 - TCP-Server
  • 2 - TCP-Client
Wenn Socket_Info Instance 0 ist, wird StreamType als 0 angezeigt.
TxQueCnt
Ausgang
USINT
Anzahl von sich aktuell in der Warteschlange befindlichen Tx-Nachrichten.
Wenn Socket_Info Instance 0 ist, wird TxQueCnt als 0 angezeigt.
RxQueCnt
Ausgang
USINT
Anzahl von sich aktuell in der Warteschlange befindlichen Rx-Nachrichten.
Wenn Socket_Info Instance 0 ist, wird RxQueCnt als 0 angezeigt.
SocketState
Ausgang
USINT
Socket-Anweisungsstatusinformationen. Weitere Informationen siehe Socket-Maschinenstatus.
Wenn Socket_Info Instance 0 ist, wird SocketState als 0 angezeigt.
LocalAddr
Ausgang
SOCKETADDR_CFG
Lokale Adresse des Sockets. Weitere Informationen finden Sie unter Datentyp SOCKADDR_CFG.
Wenn Socket_Info Instance 0 ist, wird LocalAddr als 0 angezeigt.
RemoteAddr
Ausgang
SOCKETADDR_CFG
Remote-Adresse des Sockets. Weitere Informationen finden Sie unter Datentyp SOCKADDR_CFG.
RemoteAddr wird in folgenden Fällen als 0 angezeigt:
  • Socket_Info-Instanz ist 0.
  • UDP-Verbindungen (User Datagram Protocol) ohne SOCKET_OPEN.
  • UDP mit SOCKET_OPEN und deaktiviertem RxFilter.
OtherInfo
UDINT[1..15]
Socket-Instance als TCP konfiguriert, Array-Indexbeschreibung lautet:
  • 1 - Gesendete Pakete: Gesamtanzahl von über einen Socket gesendete TCP-Pakete.
  • 2 - Gesendete Byte: Gesamtanzahl von über einen Socket gesendete TCP-Byte.
  • 3 - Empfangene Pakete: Gesamtanzahl von über einen Socket empfangene TCP-Pakete.
  • 4 - Empfangene Byte: Gesamtanzahl von über einen Socket empfangene TCP-Byte.
  • 5 - Erneut übermittelte Pakete: Gesamtanzahl von erneut übermittelten TCP-Paketen.
  • 6 - Prüfsummenfehler: Gesamtanzahl von TCP-Paketen mit Prüfsummenfehlern auf einem Socket.
  • 7 - TCP-Status: Aktueller Status eines Sockets.
  • (8-11) – OtherInfo wird für TCP nicht unterstützt, es wird als 0 angezeigt.
  • 12 ,13,14,15 - werden als 0 angezeigt.
Socket-Instanz als UDP konfiguriert, Array-Indexbeschreibung lautet:
  • 1 - Gesendete Pakete: Gesamtanzahl von über einen Socket gesendete UDP-Pakete.
  • 2 - Gesendete Byte: Gesamtanzahl von über einen Socket gesendete UDP-Byte.
  • 3 - Empfangene Pakete: Gesamtanzahl von über einen Socket empfangene UDP-Pakete.
  • 4 - Empfangene Byte: Gesamtanzahl von über einen Socket empfangene UDP-Byte.
  • 5 - Gelöschte Pakete: Gesamtanzahl von empfangenen UDP-Pakten, die auf einem Socket aufgrund einer Überschreitung der maximalen Warteschlangengröße von 8 gelöscht wurden.
  • 6 - Prüfsummenfehler: Gesamtanzahl von UDP-Paketen mit Prüfsummenfehlern auf dem Socket.
  • 7-15 - werden als 0 angezeigt.
Socket-Instanz als 0 konfiguriert, Array-Indexbeschreibung lautet:
  • 1 - Anzahl verfügbarer Socket-Instanzen. Maximale Anzahl unterstützter Sockets.
  • 2 - Anzahl verwendeter Socket-Instanzen. Anzahl erfolgreich erstellter Sockets.
  • 3 - Anzahl von als TCP erstellter Socket-Instanzen.
  • 4 - Anzahl von als TCP-Client erstellter Socket-Instanzen.
  • 5 - Anzahl von als TCP-Server erstellter Socket-Instanzen.
  • 6 - Anzahl von als UDP erstellter Socket-Instanzen.
  • 7 - SOCKET_READ Erfolgszählung, wenn Socket-Instanz als TCP konfiguriert ist.
  • 8 - SOCKET_WRITE Erfolgszählung, wenn Socket-Instanz als TCP konfiguriert ist.
  • 9 - SOCKET_READ Fehlerzählung, wenn Socket-Instanz als TCP konfiguriert ist.
  • 10 - SOCKET_WRITE Fehlerzählung, wenn Socket-Instanz als TCP konfiguriert ist.
  • 11 - SOCKET_READ Erfolgszählung, wenn Socket-Instanz als UDP konfiguriert ist.
  • 12 - SOCKET_WRITE Erfolgszählung, wenn Socket-Instanz als UDP konfiguriert ist.
  • 13 - SOCKET_READ Fehlerzählung, wenn Socket-Instanz als UDP konfiguriert ist.
  • 14 - SOCKET_WRITE Fehlerzählung, wenn Socket-Instanz als UDP konfiguriert ist.
  • 15 - werden als 0 angezeigt.

SOCKET_INFO-Beispiele

Beispiel für ein SOCKET_INFO-Funktionsblockdiagramm
Beispiel für ein SOCKET_INFO-Funktionsblockdiagramm
Beispiel für einen SOCKET_INFO-Kontaktplan
Beispiel für einen SOCKET_INFO-Kontaktplan
Beispiel für strukturierten SOCKET_INFO-Text
Beispiel für strukturierten SOCKET_INFO-Text
Ergebnisse
Ergebnisse
Rückmeldung geben
Haben Sie Fragen oder Feedback zu dieser Dokumentation? Bitte geben Sie hier Ihr Feedback ab.
Normal