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)