EA uniTFTs Series

Files on the internal memory #F

Commands to handle file access.

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.

Send working directory

The command places the current working directory in the send buffer. The feedback is structured as follows:

Send all folders and files (directory)

The command places all folders and files of the current working directory in the send buffer. The feedback is structured as follows:

Send all folders and files (directory) (ASCII)

The command places all folders and files of the current working directory in the send buffer as ASCII strings.

Send all folders (directory)

The command places all folders of the current working directory in the send buffer. The feedback is structured as follows:

Files

Attention:

Flash memories have limited erase / write cycles due to their design. The memory module used in the uniTFTs can typically safely execute 100,000 cycles. In order to write data, a block of memory may have to be erased, typically 30 ms are required for erasing, but it can take up to 400 ms. This must be taken into account in the macro sequence when write file commands are executed.

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. The filesize needs to be set. Resizing is possible afterwards (from V1.2).

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. If the time and date are specified or the time is set beforehand, the time stamp is set, otherwise 1.1.1980 remains and can be set later.

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 and send data

The command reads a Number (32-bit value) of bytes from the open file and places the data in the send buffer. The feedback is structured as follows:

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 (from V1.3)

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

Read binary data into numeric array (from V1.3)

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 (from V1.3)

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

Send file information

The command puts all information about the file (such as time stamp, size) in the send buffer. If the file does not exist, an empty string is returned, the remaining parameters are no longer transferred. The feedback is structured as follows:

See also fileS(), fileA(), fileT()

Rename file

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

Copy file

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

Move file

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

Change time stamp of file

The command changes the time stamp of 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

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

See also fileA()

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 (from V1.3)

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

Load subdirectories into string array (from V1.3)

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

Remove encryption (from V1.2)

The flash, encrypted by uniTFTDesigner, will be formatted (Attention: all data will be lost) and the encryption will be removed. The parameter must be specified exactly identical.