RDREC

Typ	Funktionsbaustein
Beschreibung	Mit dem Funktionsbaustein kann ein Datensatz von einem Profinet IO-Gerät gelesen werden. Der Baustein wird mit REQ = TRUE ausgeführt. Die Adresse (ID) des Profinet Device/Slot/Subslot, von dem der Datensatz gelesen werden soll, wird am Eingang ID angegeben. Die Nummer des zu lesenden Datensatzes wird am Eingang INDEX angelegt. Die maximale Länge des zu lesenden Datensatzes in Bytes wird am Eingang MLEN spezifiziert. Der Ausgang VALID signalisiert das erfolgreiche Lesen des Datensatzes. Ist VALID = TRUE, wurde der gelesene Datensatz in den Parameter RECORD geschrieben. Tritt während der Ausführung des Funktionsbausteins ein Fehler auf, wird ERROR auf TRUE und VALID auf FALSE gesetzt. Der Ausgang STATUS zeigt den Fehlercode an.
Hinweise	Bevor der Funktionsbaustein aufgerufen wird, sollte eine Applikationsbeziehung (AR) zum Kommunikationspartner vollständig aufgebaut sein. Alle Ein- und Ausgänge müssen angeschlossen sein. In einem PLCnext Engineer-Projekt können maximal 32 Instanzen des Funktionsbausteins verwendet werden. 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: Wenn REQ = TRUE ist, wird der Funktionsbaustein ausgeführt. Tritt während der Ausführung kein Fehler auf, wird der Ausgang VALID auf TRUE gesetzt und das Programm wird weiter fortgesetzt. Tritt während der Ausführung ein Fehler auf, wird ERROR auf TRUE und VALID auf FALSE gesetzt. ID Datentyp: DWORD Beschreibung: Adresse (ID) des Profinet Device/Slot/Subslot. An den Eingang sollte die eindeutige Knoten-ID des Profinet-Submoduls angelegt werden. PLCnext Engineer weist jedem Profinet-Submodul beim Einfügen des Moduls in das Projekt automatisch eine Knoten-ID zu. Die Knoten-ID finden Sie im Editor 'Submodulliste' des Profinet-Submodulknotens. Sie können die Knoten-ID auch mit dem FB ADDRESS_TO_ID ermitteln. INDEX Datentyp: INT Beschreibung: Nummer des Datensatzes, der gelesen werden soll. Für Indizes größer 0x7FFF muss aufgrund des geforderten Datentyps INT entweder ein negativer Wert angelegt oder mit Hilfe der Funktion WORD_TO_INT der INDEX-Wert in einen INT-Wert umgewandelt werden. MLEN Datentyp: INT Beschreibung: Maximale Anzahl an Bytes, die aus dem Datensatz gelesen wurden. Die mit dem Ein-/Ausgang RECORD verbundene Variable muss mindestens diese Länge haben, andernfalls wird eine Fehlermeldung ausgegeben. Ein-/Ausgang RECORD Datentyp: ANY Beschreibung: Datensatz, der gelesen wurde. Ausgang LEN zeigt die Anzahl der Bytes an. An den Ein-/Ausgang muss ein Byte-Array angeschlossen werden. Ausgänge VALID Datentyp: BOOL Beschreibung: Zeigt an, ob bei der Ausführung des Funktionsbausteins ein Fehler aufgetreten ist. 0   Fehler aufgetreten. 1   Kein Fehler aufgetreten. Der gelesene Datensatz steht am Ein-/Ausgang RECORD an. BUSY Datentyp: BOOL Beschreibung: Zeigt an, ob der Funktionsbaustein gerade ausgeführt wird. 0   Der Funktionsbaustein wird nicht ausgeführt. 1   Der Funktionsbaustein wird gerade ausgeführt. Wenn innerhalb von 15 Sekunden keine Bestätigung des Dienstes empfangen wird, tritt ein Timeout auf. Während dieser Zeit ist BUSY = TRUE. ERROR Datentyp: BOOL Beschreibung: Bei einem Fehler wird der Ausgang ERROR auf TRUE gesetzt. Der Ausgang STATUS zeigt den Fehlercode an. STATUS Datentyp: DWORD Beschreibung: Fehlerwert. Nur gültig, wenn ERROR = TRUE. Eine Beschreibung der Fehlercodes finden Sie am Ende dieses Themas. Wenn BUSY = TRUE ist, enthält der Ausgang den Wert aus dem letzten Aufruf des FBs oder den Wert 0. LEN Datentyp: INT Beschreibung: Anzahl der gelesenen Bytes.
Fehlercodes	Fehlercodes am Ausgang STATUS Hinweis Fehlercodes, die hier nicht aufgeführt sind, sind Profinet-spezifisch. Informationen zu diesen Fehlercodes sind der Profinet-Spezifikation oder dem Handbuch zum Profinet-Gerät zu entnehmen. Fehlercode (hex) Bedeutung 0x0000 Kein Fehler aufgetreten. 0xF001 Zu viele Instanzen verwendet. 0xF002 Fehler beim Initialisieren des Funktionsbausteins. 0xF003 Ungültige ID. 0xF004 Ungültiges HANDLE/ID. 0xF005 Ressourcenkonflikt. 0xF006 Ein bausteininterner Task konnte nicht erzeugt werden. 0xF007 Zu viele Instanzen verwendet. 0xF008 Ungültiger Parametertyp. 0xF009 Ungültiger Parameterwert. 0xF00A Nicht erlaubter Parameter. 0xF00B Ungültige Länge. 0xF00C ID konnte nicht erzeugt werden (zu viele IDs). 0xF00D Kein Eintrag gefunden, der zur angegebenen ID passt. 0xF00F Keine weiteren Einträge gefunden. 0xF010 Eintrag in Verwendung. 0xF011 Alarmbestätigung konnte nicht ausgeführt werden. 0xF012 Auslesen der AR-Parameter nicht möglich (1. Versuch). 0xF013 Negative Bestätigung für die Ausführung eines Profinet-Dienstes erhalten. 0xF014 Ungültige Länge im Parameter LEN/MLEN oder/und Datensatz im Ein-/Ausgang RECORD zu klein. 0xF015 Der Dienst zum Lesen des Datensatzes am Ein-/Ausgang RECORD konnte nicht ausgeführt werden. 0xF016 Der Dienst zum Schreiben des Datensatzes am Ein-/Ausgang RECORD konnte nicht ausgeführt werden. 0xF017 Eine Dienstbestätigung ist ausgeblieben. 0xF018 Der INDEX für den Zugriff auf den Datensatz am Ein-/Ausgang RECORD auf dem Profinet IO-Gerät ist ungültig, z.B. INDEX größer als 0x7FFF. 0xF019 Unbekannter Befehlscode. 0xF01A Fehler beim Starten der Applikationsbeziehung (AR). 0xF01B Fehler beim Stoppen der Applikationsbeziehung (AR). 0xF01C Benachrichtigung über gestoppte Applikationsbeziehung (AR) fehlgeschlagen. 0xF01D Das Flag "BF ansteuern" konnte nicht gesetzt werden. 0xF01E Auslesen der AR-Parameter nicht möglich (2. Versuch).