UDP_SEND

Typ	Funktionsbaustein
Beschreibung	Der Funktionsbaustein wird für das Senden von UDP-Datagrammen (UDP = Universal Datagram Protocol) an ein UDP-fähiges Ethernet-Gerät über einen IP-Socket verwendet. Der IP-Socket muss zuerst mit Hilfe des Funktionsbausteins UDP_SOCKET geöffnet werden, bevor Daten gesendet werden können. Jeder einzelne Sendevorgang wird durch eine steigende Flanke am Eingang REQ angestoßen. In diesem Zyklus kopiert der Funktionsbaustein die Werte der an DATA angeschlossenen Variable in einen internen Buffer. Der Ausgang BUSY wird auf TRUE gesetzt, solange Daten aus dem internen Buffer gesendet werden. Solange BUSY = TRUE ist, wird der Eingang REQ ignoriert. Das Übertragen von neuen Daten, die während des laufenden Übertragungszyklus an DATA verfügbar sind, kann nur mit einer steigenden Flanke am Eingang REQ angestoßen werden, nachdem der Ausgang BUSY auf FALSE gesetzt wurde. Tritt während der Ausführung des Funktionsbausteins ein Fehler auf, wird der Ausgang ERROR für die Dauer eines Zyklus auf TRUE gesetzt. Der zugehörige Fehlercode wird in diesem Zyklus am Ausgang STATUS angezeigt. Der Datenempfänger (das Gerät) wird über die Parameter DEST_IP (IP-Adresse des Empfängers) und DEST_PORT (Portnummer des Empfängers) vorgegeben. WARNUNG Unbeabsichtigter Betriebszustand des Geräts Stellen Sie sicher, dass das Ändern der Ausgangsdaten nicht zu einem ungewollten oder gefährlichen Verhalten des Gesamtsystems führen kann.1 1 Wenn Sie die Anwendungslogik auf der Simulation ausführen, werden durch die Funktionsbausteine echte Verbindungen zu anderen Geräten/Servern aufgebaut. Dadurch können gegebenenfalls Ausgänge und Variablen, die mit echter Hardware verbunden sind, gesetzt werden und somit zu echten Beschädigungen der Maschine führen.
Hinweise	Der mit dem Funktionsbaustein UDP_SOCKET geöffnete IP-Socket kann nur für den Aufruf des Funktionsbausteins UDP_SEND verwendet werden, solange der Ausgang ACTIVE des Funktionsbausteins UDP_SOCKET gesetzt ist. Das Aufrufen des Funktionsbausteins UDP_SEND während ACTIVE = FALSE ist, führt zu einem Fehler am Funktionsbaustein UDP_SEND (ERROR = TRUE und STATUS-Code = 0xC210). Stellen Sie bei Steuerungen mit integrierter Firewall sicher, dass die Firewall nicht die für die Kommunikation benötigten Ports blockiert. Andernfalls kann keine Verbindung hergestellt werden. Alle verwendeten IP-Adressen sind IPv4-Adressen. IPv4-Adressen bestehen aus 4 Zahlen (Werte von 0 bis 255), die durch Punkte voneinander getrennt sind. Funktionsbausteine müssen instanziiert werden. Der FB-Instanzname muss in der 'Variablen'-Tabelle der POE deklariert werden, in welcher der FB verwendet werden soll. Der Instanzname muss innerhalb der POE eindeutig sein.
Parameter	Eingänge REQ Datentyp: BOOL Beschreibung: Mit einer steigenden Flanke am Eingang REQ wird die Übertragung der an DATA anliegenden Daten angestoßen. Der Eingang wird ignoriert, solange Daten gesendet werden (BUSY = TRUE). Alle anderen Eingangsparameter werden mit steigender Flanke am REQ-Eingang ausgewertet, sofern BUSY = FALSE ist. HANDLE Datentyp: DWORD Beschreibung: Sockethandle, das mit dem Funktionsbaustein UDP_SOCKET geöffnet wurde (siehe auch obenstehende Hinweise). Der Parameter wird nur in dem Zyklus ausgewertet, in dem am Parameter REQ eine steigende Flanke erkannt wird. DEST_IP Datentyp: STRING Beschreibung: IP-Adresse (IPv4-Adresse) des Geräts, an das die im DATA-Buffer gespeicherten Daten gesendet werden sollen. Der Parameter wird nur in dem Zyklus ausgewertet, in dem am Parameter REQ eine steigende Flanke erkannt wird. DEST_PORT Datentyp: UINT Beschreibung: Portnummer des Geräts, an das die im DATA-Buffer gespeicherten Daten gesendet werden sollen. Der Parameter wird nur in dem Zyklus ausgewertet, in dem am Parameter REQ eine steigende Flanke erkannt wird. DATA_CNT Datentyp: UDINT Beschreibung: Anzahl an Bytes im internen Buffer (DATA), die gesendet werden sollen (DATA_CNT = DATA_CouNT). Es können maximal 2147483647 Bytes gesendet werden. Dieser Grenzwert ist nur ein theoretischer Wert. In der Praxis bildet die maximale Größe der angeschlossenen Variable den Grenzwert. Der Parameter wird nur in dem Zyklus ausgewertet, in dem am Parameter REQ eine steigende Flanke erkannt wird. Für DATA_CNT = UDINT#16#FFFFFFFF wird die komplette an DATA angeschlossene Variable gesendet. Tipp: Sie können mit der Funktion SIZEOF die Größe der Variable, d.h. die Anzahl der für die Variable im Speicher der Steuerung reservierten Bytes ermitteln. Ein-/Ausgang DATA Datentyp: ANY Beschreibung: Datenpuffer mit den Daten, die an das Gerät mit der IP-Adresse (DEST_IP) und der Portnummer (DEST_PORT) gesendet werden sollen. Die Daten werden als Byte-Stream übertragen. Es erfolgt keine Little-/Big-Endian-Konvertierung. Ist die angeschlossene Variable ein STRUCT (oder ARRAY OF STRUCT), enthält der Byte-Strom eventuell Padding Bytes. Ausgänge DONE Datentyp: BOOL Beschreibung: Der Ausgang wird auf TRUE gesetzt, wenn die Daten erfolgreich gesendet wurden. Der Ausgang wird für genau einen Zyklus gesetzt. BUSY Datentyp: BOOL Beschreibung: Der Ausgang wird auf TRUE gesetzt, solange versucht wird, Daten zu senden. Der Eingang REQ wird ignoriert, solange der Ausgang BUSY gesetzt ist. ERROR Datentyp: BOOL Beschreibung: Bei einem Fehler wird der Ausgang ERROR auf TRUE gesetzt. Der zugehörige Fehlercode kann am Ausgang STATUS ausgelesen werden, solange ERROR = TRUE ist. Falls ein Fehler erkannt wurde, wird dieser Ausgang für nur einen Zyklus TRUE. Der Fehlercode muss in diesem Zyklus am Ausgang STATUS gelesen werden. Siehe Fehlercodes / Statuscodes für Ethernet-FBs. STATUS Datentyp: WORD Beschreibung: Liefert den Fehlercode im Fehlerfall (ERROR = TRUE) oder den aktuellen Status des Funktionsbausteins (ERROR = FALSE). Fehlercodes beginnen mit 16#Cxxx und Statuscodes mit 16#8xxx. Siehe Fehlercodes / Statuscodes für Ethernet-FBs.