WRREC

Type	Function block
Description	The function block is used to write a data record to a Profinet IO device. The block is executed by REQ = TRUE. The Profinet address ID of the device/slot/subslot to which the data record is written is specified with the ID input. The INDEX input identifies the data record to be written. The length of the data record to be written (in byte) is specified with the LEN input. The DONE output indicates whether the data record has been successfully written to the Profinet IO device. The values of the RECORD and LEN parameters shall not be changed as long as BUSY = TRUE. If an error occurs during execution of the function block, the ERROR output is set to TRUE. The STATUS output indicates the error code.
Notes	Before calling the function block, an Application Relation (AR) with the communication partner should be completely established. All parameters have to be set. A maximum of 32 instances of the function block is allowed in the PLCnext Engineer project. Function blocks have to be instantiated. The instance name of the function block has to be declared in the 'Variables' table of the POU where the FB is going to be used. The instance name must be unique within the POU.
Parameters	Inputs REQ Data type: BOOL Description: With REQ = TRUE the function block is executed. If no error occurs during execution, the DONE output is set to TRUE and the program execution continues. If an error occurs during execution, the ERROR output is set to TRUE and DONE is set to FALSE. ID Data type: DWORD Description: Profinet address ID of the device/slot/subslot. See also function blocks ADDRESS_TO_ID and ID_TO_ADDRESS. The unique Node ID of the Profinet submodule should be connected to the input. PLCnext Engineer automatically assigns a Node ID to each Profinet submodule on insertion of the module. The Node ID is shown in the 'Submodule List' editor of the Profinet submodule node. You can also use the ADDRESS_TO_ID function block to obtain the Node ID. INDEX Data type: INT Description: Identifies the data record to be written. Write accesses to indexes greater than 0x7FFF are not allowed. LEN Data type: INT Description: Size in bytes of the data to be written that are applied to the RECORD input/output. This value may not be changed as long as BUSY = TRUE. Input/Output RECORD Data type: ANY Description: Input to which the data to be written are applied. The number of bytes to be written must be set with the LEN input. This value may not be changed as long as BUSY = TRUE. A byte array has to be applied to RECORD. Outputs DONE Data type: BOOL Description: Indicates whether an error occurred when executing the function block. 0   Error occurred. 1   No error occurred. The RECORD data has been successfully written. BUSY Data type: BOOL Description: Indicates whether the function block is currently executed. 0   Function currently not executed. 1   Function is currently being executed. If the service is not acknowledged within 15 seconds, a timeout will occur. During this time BUSY is TRUE. ERROR Data type: BOOL Description: If an error occurs, the ERROR output is set to TRUE. The STATUS output indicates the error code. STATUS Data type: DWORD Description: Error value. Only valid for ERROR = TRUE. See below for a description of the error codes. If BUSY = TRUE, the output contains the value of the last FB call or the value 0.
Error codes	Error codes at the STATUS output Note Error codes which are not listed here are Profinet specific. For information on these error codes, refer to the Profinet specification or the Profinet device manual. Error code (hex) Meaning 0x0000 No error occurred. 0xF001 Too many instances used. 0xF002 Error during initialization of the function block. 0xF003 Invalid ID. 0xF004 Invalid HANDLE/ID. 0xF005 Resources conflict. 0xF006 A function block internal task could not be generated. 0xF007 Too many instances used. 0xF008 Invalid type of a parameter. 0xF009 Invalid parameter value. 0xF00A Unallowed parameter. 0xF00B Invalid length specified. 0xF00C ID could not be created (too many IDs). 0xF00D No entry found that matches the specified ID. 0xF00F No further entries found. 0xF010 Entry in use. 0xF011 Alarm acknowledgement could not be done. 0xF012 Error reading the AR parameters (1st time). 0xF013 Negative acknowledgement received for the execution of a Profinet service. 0xF014 Invalid length for parameter LEN/MLEN or/and data record in RECORD input/output too short. 0xF015 The service used to read the data record from the RECORD input/output could not be run. 0xF016 The service used to write the data record from the RECORD input/output could not be run. 0xF017 Service acknowledgement not received. 0xF018 Invalid INDEX used to access the data record in the RECORD input/output of the Profinet IO device, for example, INDEX greater than 0x7FFF. 0xF019 Unknown command code. 0xF01A Error when starting the Application Relation (AR). 0xF01B Error when stopping the Application Relation (AR). 0xF01C Notification of stopped Application Relation (AR) failed. 0xF01D Setting the "Drive BF" flag failed. 0xF01E Error reading the AR parameters (2nd time).