Command Set for EA PLC Series

Files / Access to FLASH #F

Commands to handle file access on the built-in FLASH.

Folder / Directory

Files

General commands

Folder / Directory

Create folder

The command creates a new folder. The <Path> parameter specifies the name and location.

Delete folder

The command deletes a folder. The <Path> parameter specifies the name and location.

Set working directory

The command sets the current working directory. With path </> you reach the root directory.

Files

Open file for writing

The command opens (write only) or creates a file. The Position (32-bit value) indicates the write position in the file.

Close file (write operation)

The command closes an open file (write operation). The writing process is completed and it is ensured that all data has been written.

Optionally the file time and date can be set (details see command #FFT).

The CRC16 can be used to check the file integrity. The module can calculate crc16 with the help of calculations.

Set write position in file

The command sets the write Position (32-bit value) at the specified position in the file. If the value is <0, the position is calculated from the end of the file

See also fposW()

Write data to file

The command writes a Number (32-bit value) of Binary data to the opened file. This command is unsuitable for macro programming. It is used to transfer binary data via the interface.

Write ASCII-String to file

The command writes an ASCII string (8 bits per character) into the open file.

Write Unicode-String to file

The command writes a Unicode string (16 bits per character) into the open file.

Write register values to file

The command writes the register value (Register-ID) to the open file. The value can be read out with the #FRR command. 5 bytes are required for each register.

Write string register values to file

The command writes the content of the string register (String-ID) to the open file. The string can be read out with the command #FRS. 2 · (n + 1) bytes (n = number of letters) are required for each register.

Write array to file

The command writes the content of the array (Array-ID) to the open file. The string can be read out with the command #FRY. For each integer or float array 6+4-n bytes (n=length of the array) are needed. A Unicode StringArray requires 11 + (Maximum Entrysize * Length of the array) bytes.

Write binary data from register to file (from V1.3)

The command writes the contents of the register (Register ID) in binary format to the open file. The register can be read out with the command #FRV.

Write binary data from numeric array to file (from V1.3)

The command writes the contents of a numeric array (Array ID) in binary format to the open file. The numeric array can be read out with the command #FRX.

Write binary data from string array to file (from V1.3)

The command writes the contents of a string array (Array ID) in binary format to the open file. The string array can be read out with the command #FRQ.

Open file for reading

The command opens (read only) a file. The Position (32-bit value) indicates the read position in the file.

Close file (read operation)

The command closes an open file (read operation).

Set read position in file

The command sets the read Position (32-bit value) at the specific position in the file. If the value is <0, the position is calculated from the end of the file

See also fposR()

Read ASCII string and write into string register

The command reads an ASCII string (8 bits per character) up to the character "\n" and stores it in a string register (String-ID).

Read Unicode string and write into string register

The command reads a Unicode string (16 bits per character) up to the character "\n" and stores it in a string register (String-ID).

Load data into register

The command reads back a register written with #FRW and saves it in the register (Register-ID).

Load data into string register

The command reads back a string register written with #FRS and saves it in the string register (String-ID).

Read data (8-Bit) and write into string register

The command reads a Number (1 ... 250) of bytes and saves it in the string register (String-ID).

Read data (16-Bit) and write into string register

The command reads a Number (1 ... 250) of Words and saves it in the string register (String-ID).

Read data into array

The command reads back an array written with #FWY and saves it in the array (Array-ID).

Read binary data into register

The command reads back a binary register written with #FWV and saves it in the register (Register-ID).

Read binary data into numeric array

The command reads back a binary numeric array written with #FWX and saves it in the register (Array-ID).

Read binary data into string array

The command reads back a binary string array written with #FWQ and saves it in the register (Array-ID).

Delete file

The command deletes a file (<Filename>)

General commands

Rename file/folder

The command changes the specified <Path> to a new name (<New Filename> is only the new name, without path).

Copy file/folder

The command copies the specified folder, the specified file (<Path>) to a new location (<New Path>).

Move file/folder

The command moves the specified folder, the specified file (<Path>) to a new location (<New Path>).

Change time stamp of file/folder

The command changes the time stamp of the folder or the file (<Path>):

Example for calculation:

Time = (Hour<<11) + (Minute<<5) + (Second>>1);

Date = ((Year-1980)<<9) + (Month<<5) + Day;

See also fatT(datetime), fatD(datetime), fattime(Fat-Time, Fat-Date)

Change attributes of file/folder

The command sets the Attributes of the folder / file. The attributes can be set simultaneously with bit coding.

See also fileA()

Calculate and save CRC16 in FAT

The command sets the CRC16 to the file filename. It's possible to write a manually calculated crc16.

Load file names into string register

The command saves all file names from the <Path> in the string register (String-ID = ID ... IDn). The number is stored in the register (Register ID = ID). (You can search with patterns ?/* e.g. * .txt stores all text files)

Load subdirectories into string register

The command saves all folder names that are in the  <Path> in the string register (String-ID = ID ... IDn). The number is stored in the register Rregister ID = ID). (You can search with patterns ?/*, e.g. *New* stores all directories in which the word "New" occurs)

Load file names into string array

The command saves all folder names that are in the <Pfad> in the string array (Array-ID).

Load subdirectories into string array

The command saves all folder names that are in the <Pfad> in the string array (Array-ID).

Formats FLASH memory

The SD card or FLASH will be formatted. Attention: all data will be lost and the encryption will be removed. The parameter must be specified exactly identical.