Kurz-Information

Name	`UDP_Receive`
→POE-Typ	→Funktion
Kategorie	Weitere Systembausteine, Netzwerkbausteine , Baustein mit interner Fehlerdiagnose
Grafische Schnittstelle
Verfügbar ab	Version 1.105.0 (für logi.CAD 3) und Version 3.15.0 von logi.RTS – Anfangsvariante Dieser Baustein wird nur für diese →Zielsysteme oder Plattformen unterstützt: →Raspberry Pi, →Revolution Pi Plattform `WindowsX86` (inkl. integrierte SPS unter Windows) Version 1.109.0 (für logi.CAD 3) und Version 3.19.0 von logi.RTS Dieser Baustein wird nur für diese Zielsysteme oder Plattformen unterstützt: Raspberry Pi, Revolution Pi Plattform `WindowsX86` (inkl. integrierte SPS unter Windows) Plattform `LinuxX86` Version 2.0.5 (für Bibliothek `System`) – grafische Schnittstelle mit Ein-/Ausgangsvariable Version 3.5.0 (für Bibliothek `Standard`) – Einschränkung "keine Funktionsbausteine mit allgemeinen Datentypen"

Funktionalität

Der Baustein empfängt ein →UDP-Packet.

Eingänge, Ausgänge

	Bezeichner	→Datentyp	Beschreibung
Eingänge:	`handle`	`DINT`	UDP-Handle
Eingänge:	`flags`	`UDINT`	zusätzliche Flags zum Empfangen
Ein-/Ausgänge (VAR_IN_OUT):	`data`	`REAL`, `LREAL`, `USINT`, `UINT`, `UDINT`, `ULINT`, `SINT`, `INT`, `DINT`, `LINT`, `TIME`, `BOOL`, `BYTE`, `WORD`, `DWORD`, `LWORD`, `STRING`, `CHAR`, `DATE_AND_TIME`, `DATE`, `TIME_OF_DAY`, ein →anwenderdefinierter Datentyp oder ein →Funktionsbaustein Einschränkung: Bei →ARRAY-Datentypen sind nur ein-dimensionale Arrays zulässig. Weitere Einschränkung: Bei Funktionsbausteinen sind keine Funktionsbausteine mit einem →allgemeinen Datentyp zulässig. Als Folge dieser Einschränkung können Sie die folgenden Bausteine nicht als Eingang des aktuellen Bausteins verwenden: LIMITER_O, LIMITER_U, FORCEMRK, MAX_HOLD, MIN_HOLD und →Vendor-Funktionsbausteine , die mit einem allgemeinen Datentyp deklariert sind Falls Sie dennoch Instanzen von diesen Funktionsbausteinen verwenden, kommt es beim Erstellen der Anwendung zu einem Linker-Fehler.	Inhalt des erhaltenen UDP-Pakets
Ausgänge:	`sourceAddress`	`DWORD`	Quelladresse des erhaltenen UDP-Pakets in Netzwerk-Byte-Reihenfolge (englisch: network byte order) Beispiel: Der empfangene Wert `16#0100007F` entspricht der Quelladresse `127.0.0.1`. Verwenden Sie den `INET_NTOA`-Baustein, um die Adresse zu konvertieren.
	`sourcePort`	`UINT`	Quellport des erhaltenen UDP-Pakets in Host-Byte-Reihenfolge (englisch: host byte order) Beispiel: Der empfangene Wert `1125` entspricht dem Quellport `1125`.
	`lengthOfReceivedData`	`UDINT`	Länge des erhaltenen UDP-Pakets
	`rc`	`UDINT`	Status der UDP-Operation: `16#00000000`: Die Operation ist erfolgreich. `16#81000001`: Der Flag ist ungültig. `16#81000002`: Der Handle ist ungültig. `16#81000006`: Die Daten können nicht empfangen werden.

Der Eingang EN und der Ausgang ENO sind für den →Aufruf des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN und zum Ausgang ENO.

Informieren Sie sich unter:

"Bausteine für sichere Logik", ob dieser Baustein für das Entwickeln von sicherheitsrelevanten Anwendungen unterstützt wird.
"Kennzeichnung von sicherer Logik im FBS-Editor", welche Auswirkung die Verwendung des Bausteins als Baustein für sichere Logik hat.

Interne Fehlerdiagnose für Baustein

Der Baustein prüft die folgenden Fehlerfälle:

Der Flag ist ungültig.
Der Handle ist ungültig.
Die Daten können nicht empfangen werden.

In einem solchen Fehlerfall wird der Ausgang ENO des Bausteins auf den Wert FALSE (oder eine Entsprechung) zurückgesetzt. Zusätzlich liefert der Ausgang rc den entsprechenden Status (siehe die vorhergehende Tabelle).

Beispiel für Verwendung im ST-Editor

Siehe "UDP_Open-Baustein".

Bei der Erstellung Ihrer Anwendung im ST-Editor erstellen Sie den Aufruf eines Bausteins, indem Sie den laut Syntax erforderlichen Text eintippen oder die Inhaltshilfe verwenden.