WRREC

Typ	Funktionsbaustein
Beschreibung	Mit dem Funktionsbaustein kann ein Datensatz auf ein Profinet IO-Gerät übertragen (geschrieben) werden. Der Baustein wird mit REQ = TRUE ausgeführt. Die Adresse (ID) des Profinet Device/Slot/Subslot, zu dem der Datensatz übertragen werden soll, wird am Eingang ID angegeben. Die Nummer des zu übertragenden Datensatzes wird am Eingang INDEX angelegt. Die Länge des zu übertragenden Datensatzes in Bytes wird am Eingang LEN spezifiziert. Der Ausgang DONE signalisiert das erfolgreiche Schreiben des Datensatzes auf das Profinet IO-Gerät. Solange BUSY = TRUE ist, sollten die Parameter RECORD und LEN nicht geändert werden. Tritt während der Ausführung des Funktionsbausteins ein Fehler auf, wird der Ausgang ERROR auf TRUE 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 bei der Ausführung kein Fehler auf, wird der Ausgang DONE auf TRUE gesetzt und das Programm wird weiter fortgesetzt. Tritt während der Ausführung ein Fehler auf, wird ERROR auf TRUE und DONE auf FALSE gesetzt. ID Datentyp: DWORD Beschreibung: Adresse (ID) des Profinet Device/Slot/Subslot. Siehe auch die Funktionsbausteine ADDRESS_TO_ID und ID_TO_ADDRESS. 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 geschrieben werden soll. Das Schreiben auf Indizes größer 0x7FFF ist nicht erlaubt. LEN Datentyp: INT Beschreibung: Größe der zu schreibenden Daten, die am Ein-/Ausgang RECORD anliegen. Der Wert darf nicht geändert werden, solange BUSY = TRUE ist. Ein-/Ausgang RECORD Datentyp: ANY Beschreibung: Datensatz. Die Anzahl der zu schreibenden Bytes muss am Eingang LEN angegeben werden. Der Wert darf nicht geändert werden, solange BUSY = TRUE ist. An den Ein-/Ausgang muss ein Byte-Array angeschlossen werden. Ausgänge DONE Datentyp: BOOL Beschreibung: Zeigt an, ob bei der Ausführung des Funktionsbausteins ein Fehler aufgetreten ist. 0   Fehler aufgetreten. 1   Kein Fehler aufgetreten. Der Datensatz an RECORD wurde erfolgreich übertragen. 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.
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).