[ ]
Real time embedded FreeRTOS mailing list 
Homepage FreeRTOS Labs FreeRTOS+TCP FreeRTOS+FAT FreeRTOS+POSIX Contact / Enquiries

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.


[FreeRTOS+FAT Native API Reference]

FF_Error_t FF_Partition( FF_Disk_t *pxDisk, FF_PartitionParameters *pxFormatParameters );

The media is the physical device on which files are stored. Examples of media suitable for use in an embedded file system include SD cards, solid state disks, NOR flash memory chips, NAND flash chips, and RAM chips.

Media cannot be used to hold a FreeRTOS+FAT file system until it has been partitioned.

Partitioning divides the media into multiple units, each of which is called a partition. Each partition can then be formatted to hold its own file system.

How the media is to be partitioned is described by a structure of type FF_PartitionParameters, which is shown below. A single partition that fills all available space on the media can be created by simply leaving the structure's xSizes and xPrimaryCount members at zero.

typedef enum _FF_SizeType
    /* xSizes within the FF_PartitionParameters structure are specified as a
    quotum (the sum of all xSizes is free, all disk space will be allocated). */

    /* xSizes within the FF_PartitionParameters structure are specified as a
    percentage of the total disk space (the sum of all xSizes must be <= 100%) */

    /* xSizes within the FF_PartitionParameters structure are specified as a
    number of sectors (the sum of all xSizes must be < ulSectorCount). */
} eSizeType_t;

typedef struct _FF_PartitionParameters
    /* The total number of sectors on the media, including hidden/reserved
    sectors. */
    uint32_t ulSectorCount;

    /* The number of sectors to keep free. */
    uint32_t ulHiddenSectors;

    /* The number of sectors to keep between partitions. */
    uint32_t ulInterSpace;

    /* The size of each partition - how the sizes are specified depends on the
    value of eSizeType. */
    BaseType_t xSizes[ FF_MAX_PARTITIONS ];

    /* The number of primary partitions to create. */
    BaseType_t xPrimaryCount;

    /* How the values within the xSizes array are specified. */
    eSizeType_t eSizeType;
} FF_PartitionParameters;
The FF_PartitionParameters and associated types


pxDisk   The FF_Disk_t structure that describes the media being partitioned.

FF_FormatParameters   A pointer to a structure that describes how the media will be partitioned.


If the media is successfully partitioned then FF_ERR_NONE is returned. If the media could not be partitioned then an error code is returned. FF_GetErrMessage() converts error codes into error descriptions.

Example usage:

#define PARTITION_NUMBER        0

static FF_Error_t prvPartitionAndFormatDisk( FF_Disk_t *pxDisk )
FF_PartitionParameters xPartition;
FF_Error_t xError;

    /* Media cannot be used until it has been partitioned.  In this
	case a single partition is to be created that fills all available space - so
	by clearing the xPartition structure to zero. */
    memset( &xPartition, 0x00, sizeof( xPartition ) );
    xPartition.ulSectorCount = pxDisk->ulNumberOfSectors;
    xPartition.ulHiddenSectors = HIDDEN_SECTOR_COUNT;
    xPartition.xPrimaryCount = PRIMARY_PARTITIONS;
    xPartition.eSizeType = eSizeIsQuota;

    /* Perform the partitioning. */
    xError = FF_Partition( pxDisk, &xPartition );

    /* Print out the result of the partition operation. */
    FF_PRINTF( "FF_Partition: FF_Format: %s\n", FF_GetErrMessage( xError ) );

    /* Was the disk partitioned successfully? */
    if( FF_isERR( xError ) == pdFALSE )
        /* The disk was partitioned successfully.  Format the first partition. */
        xError = FF_Format( pxDisk, ramPARTITION_NUMBER, pdTRUE, pdTRUE );

        /* Print out the result of the format operation. */
        FF_PRINTF( "FF_RAMDiskInit: FF_Format: %s\n", FF_GetErrMessage( xError ) );

    return xError;
Using the FF_Partition() and FF_Format() functions to partition the disk, then format a partition

[ Back to the top ]    [ About FreeRTOS ]    [ Privacy ]    [ FreeRTOS Labs Sitemap ]    [ Main FreeRTOS Sitemap ]    [ ]

Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.