|
||||||||
|
|
|
|
|
|
|
FreeRTOS+FAT is still in the lab
FreeRTOS+FAT is already in use in commercial products and we encourage you to try it yourself. Be aware however that FreeRTOS+FAT was acquired by Real Time Engineers Ltd., and is still being documented and updated to ensure it meets our strict quality standards. Please use the forum for support, or contact us directly if you have a specific business interest. FF_CreateIOManager()
ff_ioman.h
|
typedef struct xFF_CREATION_PARAMETERS
{
/* If the memory to use as the IO manager's cache is provided by the application
writer then pass a pointer to the memory in pucCacheMemory. If the memory to
use as the IO manager's cache is to be allocated by the IO manager then pass
NULL in pucCacheMemory. */
uint8_t *pucCacheMemory;
/* The size of the cache memory. ulMemorySize is specified in bytes and must
be a multiple of ulSectorSize. */
uint32_t ulMemorySize;
/* Sector size, which is the unit for reading from and writing to the disk.
A sector size of 512 bytes is normal. */
BaseType_t ulSectorSize;
/* The function used to write a sector to the disk. */
FF_WriteBlock_t fnWriteBlocks;
/* The function used to read a sector from the disk. */
FF_ReadBlock_t fnReadBlocks;
/* The parameter to pass into the read sector and write sector functions -
basically a pointer back to the FF_Disk_t structure that contains the IO
manager. */
FF_Disk_t *pxDisk;
/* The semaphore used to protect the data structures on the media must be
created using the xSemaphoreCreateRecursiveMutex() API function. */
void *pvSemaphore;
/* If the media driver is not re-entant then set xBlockDeviceIsReentrant to
pdFALSE - in which case the semaphore will also be used to protect access to
the media driver's read and write functions. */
BaseType_t xBlockDeviceIsReentrant;
} FF_CreationParameters_t;
The FF_CreationParameters_t structure
|
Parameters:
| pxParameters |
A structure of type FF_CreationParameters_t, which
defines the IO manager being created.
|
| pxError |
Used to pass out an error code.
|
If the IO manager was created successfully then a pointer to the created IO manager is returned and *pxError is set to FF_ERR_NONE. If the IO manager was not created successfully then NULL is returned and *pxError is set to an error code. FF_GetErrMessage() converts error codes into error descriptions.
Example usage:
The page that documents how to create a FreeRTOS+FAT media driver also demonstrates how to use the FF_CreateIOManger() function.