Component: File (ESP32 SDMode) (File)

Author	Matrix Ltd.
Version	2.7
Category	File

File (ESP32 SDMode) component

File component allowing access to read and write files on an SD card using the ESP32 SD Mode IO allowing for high speed data transfer using 1-bit or 4-bit SD access.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_File_ESP32_SDMode.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_File_ESP32_SDMode.fcfx

Detailed description

No detailed description exists yet for this component

Examples

Line Following

Line following example using the Formula AllCode, works with objects on the simulation panel and on the real hardware.

FA-Line

Simulation with the API component

An example showing how to use the API component to drive the robot in simulation.

FA API Sim Demo

Macro reference

AppendByteToFile

	AppendByteToFile
- BYTE	Data
- BYTE	Return

AppendStringToFile

	AppendStringToFile
- STRING	Data_String
- BYTE	Return

CloseFile

	CloseFile
- VOID	Return

CreateFile

	CreateFile
- STRING	Filename
- BYTE	Return

DeleteFile

	DeleteFile
- STRING	Filename
- BYTE	Return

Initialise

	Initialise
Starts up the SD card interface and checks to see if a card is compatible. Returns: 0=OK, 255=No Card, 254=File System Fail
- BYTE	Return

MoveToNextFileSector

	MoveToNextFileSector
Not currently implemented on the RPI
- BYTE	ForceNextSector
- BYTE	Return

OpenFile

	OpenFile
Searches for and opens a file for reading or writing from within the current directory on the disk. Returns 0 for success.
- STRING	Filename
8.3 filename of the file we are trying to open e.g. "file.txt"
- BYTE	Return

OpenFolder

	OpenFolder
- STRING	Folder_Name
- BYTE	Return

ReadByteFromFile

	ReadByteFromFile
Reads a byte from the currently open file. Auto increments the position in the file. A return value of 0 may signify the end of the file has been reached (depending on the contents of the file).
- BYTE	Return

ReadByteFromIndex

	ReadByteFromIndex
Reads a byte of data from the local sector buffer. Return = Data byte read from the local sector buffer.
- ULONG	Address
- BYTE	Return

ReadFileLength

	ReadFileLength
Not currently implemented on the RPI
- INT	Return

ReadFileSize

	ReadFileSize
Reads the entire size of the current file in bytes.
- ULONG	Return

ReadStringFromFile

	ReadStringFromFile
Reads a string from the currently open file. Auto increments the position in the file. An empty string signifies the end of the file has been reached.
- UINT	NumBytes
Maximum number of bytes to attempt to read
- BYTE	EndChar
Ends the string if the value specified is found, default is 0
- STRING	Return

SetFileIndex

	SetFileIndex
- BYTE	File_Index
Range: 0 to 4
- VOID	Return

Uninitialise

	Uninitialise
Terminates connection to the SD card, unmounts the SD card and disabled the SD peripheral.
- VOID	Return

WriteByteToBuffer

	WriteByteToBuffer
Not currently implemented on the RPI
- UINT	Address
- BYTE	Data
- VOID	Return

WriteFileSector

	WriteFileSector
Not currently implemented on the RPI
- BYTE	Return

Property reference

	Properties
	Frequency
	File Count
Number of simultaneous files we want to access.
	SD Mode
	Buffer Size
Number of bytes to use as a read buffer to speed up file access.
	Directory Size
Number of bytes to use as a directory buffer to track the current directory.
	Simulation
	Sim Root Folder