Write (FB; Prefix filwr)¶

FUNCTION_BLOCK Write EXTENDS CBM.ETrigToA

This function block writes data into the file, which was previously opened via ”FILE.Open”. The contents of the memory area indicated by pointer ”pBuffer” should not be modified during the write action! The size of the structure of the memory containing the bytes to be written as well as the number of bytes to be written will not be checked.

If the stability of the pointer on the data structures and their contents cannot be guaranteed in case of an online change, an online change must be avoided with the help of functions from the ”CAA_Application library”.

InOut:

Scope	Name	Type	Comment	Inherited from
Input	`xExecute`	`BOOL`	Rising edge: Action starts Falling edge: Resets outputs If a falling edge occurs before the function block has completed its action, the outputs operate in the usual manner and are only reset if either the action is completed or in the event of an error. In this case, the corresponding output values (`xDone`, `xError`) are present at the outputs for exactly one cycle.	ETrigToA
	`xAbort`	`BOOL`	`TRUE`: Action is stopped immediately and all outputs are reset to their initial values.	ETrigToA
	`udiTimeOut`	`UDINT`	Defines the time (µs) after which an FB (e.g. requiring an external acknowledgement) aborts operation due to a timeout with error message.	ETrigToA
Output	`xDone`	`BOOL`	`TRUE`: Action successfully completed	ETrigToA
	`xBusy`	`BOOL`	`TRUE`: Function block active	ETrigToA
	`xError`	`BOOL`	`TRUE`: Error occurred, function block aborts action `FALSE`: No error	ETrigToA
	`xAborted`	`BOOL`	`TRUE` : Action aborted by user	ETrigToA
Input	`hFile`	`CAA.HANDLE`	File handle
	`pBuffer`	`CAA.PVOID`	The address from where the data can be obtained, can be determined with the help of operator ADR.
	`szSize`	`CAA.SIZE`	Number of bytes to be written (can be determined via operator SIZEOF)
Output	`eError`	ERROR	Local library error ID (0: no error; 5101: time out)