Open File

\i S O byte::handle byte::mode string::filename

Parameter	Type	Range	Description
handle	byte	0 ... 3	unique identifier for the opened file
mode	byte	ASCII: 'R', 'W', 'A'	mode to open the file
filename	file	DOS filename (8.3 format)	name and path of the file

Opens a file specified with filename from the SD card and assigns handle, according to the following values for mode:

ASCII	Hex	Description
R	0x52	Open file in read only mode.
W	0x57	Create file and set file pointer to 0. If the file already exists, it will be deleted and created anew.
A	0x41	The file will be opened or created for modifying or appending. The file pointer will be set after the last byte of the file by default.

Note

A maximum of 4 files can be opened at once.
filename is a 0 terminated string describing the name and path for the file to be opened.
If mode is other than 'R', 'W' or 'A', the file is opened in read only mode.
All files have to be named in 8.3 format in order to be accessible.
When creating a new file with this command, the filename as well as its extension will be converted to uppercase as long as at least one uppercase letter is present in the corresponding string.
If you want to open an existing file to add data, the append mode (mode = A) has to be chosen. To edit the existing data you have to manually set the file pointer to the desired position (see Set Position in File).
All opened files will automatically be closed by the commands Reset All or Reboot Panel Controller.

Response:

[ACK]

Example

\iSO\0R/DIR1/DIR2/BACKGR~1.RII\0

This will open the file "BACKGROUND.RII" in directory "DIR2" which in turn is located in the directory "DIR1", which is located in the root of the SD-Card. The file will be opened via the first handle (0) and be in read-only mode.

Not supported by: DPC3050, DPC3020, DPC2060, DPC10xx