Data Storage Elementary Functions

These DataStorage_EF elementary functions are supported in Control Expert for the M580 CPUs:

EF

CPU

Description

BMEP58•0•0

BMEH58•040

CLOSE_FILE

X

X

The CLOSE_FILE function closes the file identified by the file descriptor attribute. If another user is working on the same file via a different descriptor, the file remains open.

CREATE_FILE

X

The CREATE_FILE function creates a new file, assigns it the specified file name, and indicates the purposes for which the file is opened: read-only, write-only, read-write.

DELETE_FILE

X

The DELETE_FILE function deletes the specified file.

GET_FILE_INFO

X

X

The GET_FILE_INFO function retrieves information about a specified target file. Execute the OPEN_FILE function for the target file before executing the GET_FILE_INFO function, because the identity of the target file comes from the output parameter of the OPEN_FILE block.

GET_FREESIZE

X

X

The GET_FREESIZE function displays the amount of available space on the SD memory card.

OPEN_FILE

X

X (read only)

The OPEN_FILE function opens a specified existing file.

RD_FILE_TO_DATA

X

X

The RD_FILE_TO_DATA function enables reading data from a file, at the current position in the file, and copies the data to a direct address variable, a located variable, or an unlocated variable.

SEEK_FILE

X

X

The SEEK_FILE function sets the current byte offset in the file to a new specified offset position, which can be: the offset, the current position plus the offset, the file size plus the offset.

SET_FILE_ATTRIBUTES

X

The SET_FILE_ATTRIBUTES function sets the read-only status of a file attribute. Read-only status can be set or cleared. This function can be applies only to a file that is already open via the CREATE_FILE or OPEN_FILE function.

WR_DATA_TO_FILE

X

The WR_DATA_TO_FILE function enables the writing of the value of a direct address variable, a located variable, or an unlocated variable to a file. The value is written to the current position in the file. After the write, the current position in the file is updated.

X (supported)

(not supported)

For additional information on each function, refer to the chapter Implementing File Management.