FreeRTOSFATConfig.h FAT 配置文件

Dear 丶 2023-02-19 08:22 21阅读 0赞

/\*  
\*FreeRTOS+FAT is an open source,   
\*thread aware and scalable FAT12/FAT16/FAT32 DOS/Windows compatible embedded FAT file system which was recently acquired by Real Time Engineers ltd.   
\*for use with and without the RTOS.  
\*FreeRTOS+FAT is already used in commercial products,   
\*and is the file system used in the FTP and HTTP server examples that are documented on the FreeRTOS+TCP pages.  
\*The standard C library style API includes a thread local errno value, and the lower level native API provides a rich set of detailed error codes.  
\*We are currently working hard on improving the embedded file system’s documentation,   
\*adding additional scalability options, and updating the source code to ensure it conforms with our strict coding standards.   
\*We encourage you to download FreeRTOS+FAT to try the embedded FAT file system for yourself while we continue this work.

\*Applications that use FreeRTOS+FAT must provide a FreeRTOSFATConfig.h header file – in which the parameters described on this page can be defined:  
\*\*\*/

\#ifndef FF\_FATCONFIG\_H  
\#define FF\_FATCONFIG\_H

\#define    SDIO\_USES\_DMA 0  
\#define BUS\_4BITS 1   
\#define USE\_SD\_CD 0

\#define FF\_PRINTF printf

//\#define ffconfigDEV\_PATH "/dev"  
//\#define ffconfigDEV\_SUPPORT 0

\#define configSD\_DETECT\_PIN                 GPIO\_PIN\_11  
\#define configSD\_DETECT\_GPIO\_PORT  GPIOC

/\*Must be set to either pdFREERTOS\_LITTLE\_ENDIAN or pdFREERTOS\_BIG\_ENDIAN,   
depending on the endian of the architecture on which FreeRTOS is running.\*/  
//大小端  
\#define ffconfigBYTE\_ORDER                                             pdFREERTOS\_LITTLE\_ENDIAN

/\*Set to 1 to maintain a current working directory (CWD) for each task that accesses the file system, allowing relative paths to be used.  
Set to 0 not to use a CWD, in which case full paths must be used for each file access.\*/  
//维护当前目录  
\#define ffconfigHAS\_CWD                                                    1

/\*Set to an index within FreeRTOS’s thread local storage array that is free for use by FreeRTOS+FAT.   
FreeRTOS+FAT will use two consecutive indexes from this that set by ffconfigCWD\_THREAD\_LOCAL\_INDEX.   
The number of thread local storage pointers provided by FreeRTOS is set by configNUM\_THREAD\_LOCAL\_STORAGE\_POINTERS in FreeRTOSConfig.h.\*/  
//本地线程数组索引  
\#define ffconfigCWD\_THREAD\_LOCAL\_INDEX                    0

/\*Set to 1 to include long file name support. Set to 0 to exclude long file name support.  
If long file name support is excluded then only 8.3 file names can be used. Long file names will be recognised, but ignored.  
Users should familiarise themselves with any patent issues that may potentially exist around the use of long file names in FAT file systems before enabling long file name support.\*/  
//长文件名  
\#define ffconfigLFN\_SUPPORT                                         1

/\*Only used when ffconfigLFN\_SUPPORT is set to 1.  
Set to 1 to include a file’s short name when listing a directory, i.e. when calling findfirst()/findnext().  
The short name will be stored in the ‘pcShortName’ field of FF\_DIRENT.  
Set to 0 to only include a file’s long name.\*/  
//短文件名  
\#define ffconfigINCLUDE\_SHORT\_NAME                            0

/\*Set to 1 to recognise and apply the case bits used by Windows XP+   
when using short file names – storing file names such as “readme.TXT” or “SETUP.exe” in a short-name entry.   
This is the recommended setting for maximum compatibility.  
Set to 0 to ignore the case bits.\*/  
\#define ffconfigSHORTNAME\_CASE                                    0

/\*Only used when ffconfigLFN\_SUPPORT is set to 1.  
Set to 1 to use UTF-16 (wide-characters) for file and directory names.  
Set to 0 to use either 8-bit ASCII or UTF-8 for file and directory names (see the ffconfigUNICODE\_UTF8\_SUPPORT).\*/  
\#define ffconfigUNICODE\_UTF16\_SUPPORT                        0

/\*Only used when ffconfigLFN\_SUPPORT is set to 1.  
Set to 1 to use UTF-8 encoding for file and directory names.  
Set to 0 to use either 8-bit ASCII or UTF-16 for file and directory names (see the ffconfig\_UTF\_16\_SUPPORT setting).\*/  
\#define ffconfigUNICODE\_UTF8\_SUPPORT                        1

/\*Set to 1 to include FAT12 support.  
Set to 0 to exclude FAT12 support.  
FAT16 and FAT32 are always enabled.\*/  
\#define ffconfigFAT12\_SUPPORT                                        0

/\*When writing and reading data, i/o becomes less efficient if sizes other than 512 bytes are being used.   
When set to 1 each file handle will allocate a 512-byte character buffer to facilitate “unaligned access”.\*/  
//当写入和读取数据时，如果使用的大小不是512字节，i/o的效率就会降低。当设置为1时，每个文件句柄将分配一个512字节的字符缓冲区，以促进“非对齐访问”。  
\#define ffconfigOPTIMISE\_UNALIGNED\_ACCESS                0

/\*Input and output to a disk uses buffers that are only flushed at the following times:  
When a new buffer is needed and no other buffers are available.  
When opening a buffer in READ mode for a sector that has just been changed.  
After creating, removing or closing a file or a directory.  
Normally this is quick enough and it is efficient.   
If ffconfigCACHE\_WRITE\_THROUGH is set to 1 then buffers will also be flushed each time a buffer is released – which is less efficient but more secure.\*/  
//如果设置为1，那么缓冲区也将在每次释放缓冲区时被刷新—这样效率较低，但更安全。  
\#define ffconfigCACHE\_WRITE\_THROUGH                            1

/\*In most cases, the FAT table has two identical copies on the disk, allowing the second copy to be used in the case of a read error.   
If Set to 1 to use both FATs – this is less efficient but more secure.  
Set to 0 to use only one FAT – the second FAT will never be written to.\*/  
\#define ffconfigWRITE\_BOTH\_FATS                                    1

/\*Set to 1 to have the number of free clusters and the first free cluster to be written to the FS info sector each time one of those values changes.  
Set to 0 not to store these values in the FS info sector, making booting slower, but making changes faster.\*/  
\#define ffconfigWRITE\_FREE\_COUNT                                1

/\*Set to 1 to maintain file and directory time stamps for creation, modify and last access.  
Set to 0 to exclude time stamps.  
If time support is used, the following function must be supplied:  
time\_t FreeRTOS\_time( time\_t \*pxTime );  
FreeRTOS\_time has the same semantics as the standard time() function.\*/  
\#define ffconfigTIME\_SUPPORT                                        0

/\*Set to 1 if the media is removable (such as a memory card).  
Set to 0 if the media is not removable.  
When set to 1 all file handles will be “invalidated” if the media is extracted.   
If set to 0 then file handles will not be invalidated.   
In that case the user will have to confirm that the media is still present before every access.\*/  
//如果介质是可移动的(如存储卡)，则设置为1。  
\#define ffconfigREMOVABLE\_MEDIA                                    1

/\*Set to 1 to determine the disk’s free space and the disk’s first free cluster when a disk is mounted.  
Set to 0 to find these two values when they are first needed. Determining the values can take some time.\*/  
\#define ffconfigMOUNT\_FIND\_FREE                                    1

/\*Set to 1 to ‘trust’ the contents of the ‘ulLastFreeCluster’ and ulFreeClusterCount fields.  
Set to 0 not to ‘trust’ these fields.\*/  
\#define ffconfigFSINFO\_TRUSTED                                    1  
      
/\*Set to 1 to store recent paths in a cache,   
enabling much faster access when the path is deep within a directory structure at the expense of additional RAM usage.  
Set to 0 to not use a path cache.\*/  
\#define ffconfigPATH\_CACHE                                            1

/\*Only used if ffconfigPATH\_CACHE is 1.  
Sets the maximum number of paths that can exist in the patch cache at any one time.\*/  
\#define ffconfigPATH\_CACHE\_DEPTH                                8

/\*Set to 1 to calculate a HASH value for each existing short file name.   
Use of HASH values can improve performance when working with large directories, or with files that have a similar name.  
Set to 0 not to calculate a HASH value.\*/  
\#define ffconfigHASH\_CACHE                                            0  
\#define ffconfigHASH\_CACHE\_DEPTH                                2  
/\*Only used if ffconfigHASH\_CACHE is set to 1  
Set to CRC8 or CRC16 to use 8-bit or 16-bit HASH values respectively.\*/  
\#define ffconfigHASH\_FUNCTION                                        CRC16

/\*Set to 1 to add a parameter to ff\_mkdir() that allows an entire directory tree to be created in one go,   
rather than having to create one directory in the tree at a time.   
For example mkdir( “/etc/settings/network”, pdTRUE );.   
Set to 0 to use the normal mkdir() semantics (without the additional parameter).\*/  
//可创建目录树  
\#define ffconfigMKDIR\_RECURSIVE                                    0

/\*Set to 1 for each call to fnReadBlocks and fnWriteBlocks to be performed with a semphore lock.  
Set to 0 for each call to fnReadBlocks and fnWriteBlocks not to use an additional semaphore.\*/  
\#define ffconfigBLKDEV\_USES\_SEM                                    0

/\*Set to a function that will be used for all dynamic memory allocations.   
Setting to pvPortMalloc() will use the same memory allocator as FreeRTOS.   
For example: \#define ffconfigMALLOC( size ) pvPortMalloc( size )\*/  
\#define ffconfigMALLOC( size )                                     pvPortMalloc( size )

/\*Set to a function that matches the above allocator defined with ffconfigMALLOC.   
Setting to vPortFree() will use the same memory free function as FreeRTOS.   
For example: \#define ffconfigFREE( ptr ) vPortFree( ptr )\*/  
\#define ffconfigFREE( ptr )                                         vPortFree( ptr )

/\*Set to 1 to calculate the free size and volume size as a 64-bit number.  
Set to 0 to calculate these values as a 32-bit number.\*/  
\#define ffconfig64\_NUM\_SUPPORT                                    1

/\*Defines the maximum number of partitions (and also logical partitions) that can be recognised.Defines how many drives can be combined in total. Should be set to at least 2.\*/  
\#define ffconfigMAX\_PARTITIONS                                    1

/\*Defines how many drives can be combined in total. Should be set to at least 2.\*/  
\#define ffconfigMAX\_FILE\_SYS                                        2

/\*In case the low-level driver returns an error ‘FF\_ERR\_DRIVER\_BUSY’,   
the library will pause for a number of ms, defined in ffconfigDRIVER\_BUSY\_SLEEP\_MS before re-trying.\*/  
\#define ffconfigDRIVER\_BUSY\_SLEEP\_MS                        20

/\*Set to 1 to include the ff\_fprintf() function in the build.  
Set to 0 to exclude the ff\_fprintf() function from the build.  
ff\_fprintf() is quite a heavy function because it allocates RAM and brings in a lot of string and variable argument handling code.   
If ff\_fprintf() is not being used then the code size can be reduced by setting ffconfigFPRINTF\_SUPPORT to 0.\*/  
\#define ffconfigFPRINTF\_SUPPORT                                    1

/\*ff\_fprintf() will allocate a buffer of this size in which it will create its formatted string. The buffer will be freed before the function exits.\*/  
\#define ffconfigFPRINTF\_BUFFER\_LENGTH                        128

/\*Set to 1 to inline some internal memory access functions.  
Set to 0 not to use inline memory access functions.\*/  
\#define ffconfigINLINE\_MEMORY\_ACCESS                        0

/\*Officially the only criteria to determine the FAT type (12, 16, or 32 bits) is the total number of clusters:  
if( ulNumberOfClusters < 4085 ) : Volume is FAT12  
if( ulNumberOfClusters < 65525 ) : Volume is FAT16  
if( ulNumberOfClusters >= 65525 ) : Volume is FAT32  
Not every formatted device follows the above rule.  
Set to 1 to perform additional checks over and above inspecting the number of clusters on a disk to determine the FAT type.  
Set to 0 to only look at the number of clusters on a disk to determine the FAT type.\*/  
\#define ffconfigFAT\_CHECK                                                1

/\*Sets the maximum length for file names,   
including the path. Note that the value of this define is directly related to the maximum stack use of the +FAT library.   
In some API’s, a character buffer of size ‘ffconfigMAX\_FILENAME’ will be declared on stack.\*/  
\#define ffconfigMAX\_FILENAME                                        (49+1)  
\#endif