Michael Spencer
/
LaOS
Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
FATFileSystem/ffconf.h@1:f5ac63519541, 2014-03-05 (annotated)
- Committer:
- Michael J. Spencer
- Date:
- Wed Mar 05 06:14:02 2014 -0800
- Revision:
- 1:f5ac63519541
Initial commit.
Who changed what in which revision?
| User | Revision | Line number | New contents of line |
|---|---|---|---|
| Michael J. Spencer |
1:f5ac63519541 | 1 | /*---------------------------------------------------------------------------/ |
| Michael J. Spencer |
1:f5ac63519541 | 2 | / FatFs - FAT file system module configuration file R0.09 (C)ChaN, 2011 |
| Michael J. Spencer |
1:f5ac63519541 | 3 | /----------------------------------------------------------------------------/ |
| Michael J. Spencer |
1:f5ac63519541 | 4 | / |
| Michael J. Spencer |
1:f5ac63519541 | 5 | / CAUTION! Do not forget to make clean the project after any changes to |
| Michael J. Spencer |
1:f5ac63519541 | 6 | / the configuration options. |
| Michael J. Spencer |
1:f5ac63519541 | 7 | / |
| Michael J. Spencer |
1:f5ac63519541 | 8 | /----------------------------------------------------------------------------*/ |
| Michael J. Spencer |
1:f5ac63519541 | 9 | #ifndef _FFCONF |
| Michael J. Spencer |
1:f5ac63519541 | 10 | #define _FFCONF 6502 /* Revision ID */ |
| Michael J. Spencer |
1:f5ac63519541 | 11 | |
| Michael J. Spencer |
1:f5ac63519541 | 12 | |
| Michael J. Spencer |
1:f5ac63519541 | 13 | /*---------------------------------------------------------------------------/ |
| Michael J. Spencer |
1:f5ac63519541 | 14 | / Functions and Buffer Configurations |
| Michael J. Spencer |
1:f5ac63519541 | 15 | /----------------------------------------------------------------------------*/ |
| Michael J. Spencer |
1:f5ac63519541 | 16 | |
| Michael J. Spencer |
1:f5ac63519541 | 17 | #define _FS_TINY 0 /* 0:Normal or 1:Tiny */ |
| Michael J. Spencer |
1:f5ac63519541 | 18 | /* When _FS_TINY is set to 1, FatFs uses the sector buffer in the file system |
| Michael J. Spencer |
1:f5ac63519541 | 19 | / object instead of the sector buffer in the individual file object for file |
| Michael J. Spencer |
1:f5ac63519541 | 20 | / data transfer. This reduces memory consumption 512 bytes each file object. */ |
| Michael J. Spencer |
1:f5ac63519541 | 21 | |
| Michael J. Spencer |
1:f5ac63519541 | 22 | |
| Michael J. Spencer |
1:f5ac63519541 | 23 | #define _FS_READONLY 0 /* 0:Read/Write or 1:Read only */ |
| Michael J. Spencer |
1:f5ac63519541 | 24 | /* Setting _FS_READONLY to 1 defines read only configuration. This removes |
| Michael J. Spencer |
1:f5ac63519541 | 25 | / writing functions, f_write, f_sync, f_unlink, f_mkdir, f_chmod, f_rename, |
| Michael J. Spencer |
1:f5ac63519541 | 26 | / f_truncate and useless f_getfree. */ |
| Michael J. Spencer |
1:f5ac63519541 | 27 | |
| Michael J. Spencer |
1:f5ac63519541 | 28 | |
| Michael J. Spencer |
1:f5ac63519541 | 29 | #define _FS_MINIMIZE 0 /* 0 to 3 */ |
| Michael J. Spencer |
1:f5ac63519541 | 30 | /* The _FS_MINIMIZE option defines minimization level to remove some functions. |
| Michael J. Spencer |
1:f5ac63519541 | 31 | / |
| Michael J. Spencer |
1:f5ac63519541 | 32 | / 0: Full function. |
| Michael J. Spencer |
1:f5ac63519541 | 33 | / 1: f_stat, f_getfree, f_unlink, f_mkdir, f_chmod, f_truncate and f_rename |
| Michael J. Spencer |
1:f5ac63519541 | 34 | / are removed. |
| Michael J. Spencer |
1:f5ac63519541 | 35 | / 2: f_opendir and f_readdir are removed in addition to 1. |
| Michael J. Spencer |
1:f5ac63519541 | 36 | / 3: f_lseek is removed in addition to 2. */ |
| Michael J. Spencer |
1:f5ac63519541 | 37 | |
| Michael J. Spencer |
1:f5ac63519541 | 38 | |
| Michael J. Spencer |
1:f5ac63519541 | 39 | #define _USE_STRFUNC 0 /* 0:Disable or 1-2:Enable */ |
| Michael J. Spencer |
1:f5ac63519541 | 40 | /* To enable string functions, set _USE_STRFUNC to 1 or 2. */ |
| Michael J. Spencer |
1:f5ac63519541 | 41 | |
| Michael J. Spencer |
1:f5ac63519541 | 42 | |
| Michael J. Spencer |
1:f5ac63519541 | 43 | #define _USE_MKFS 1 /* 0:Disable or 1:Enable */ |
| Michael J. Spencer |
1:f5ac63519541 | 44 | /* To enable f_mkfs function, set _USE_MKFS to 1 and set _FS_READONLY to 0 */ |
| Michael J. Spencer |
1:f5ac63519541 | 45 | |
| Michael J. Spencer |
1:f5ac63519541 | 46 | |
| Michael J. Spencer |
1:f5ac63519541 | 47 | #define _USE_FORWARD 0 /* 0:Disable or 1:Enable */ |
| Michael J. Spencer |
1:f5ac63519541 | 48 | /* To enable f_forward function, set _USE_FORWARD to 1 and set _FS_TINY to 1. */ |
| Michael J. Spencer |
1:f5ac63519541 | 49 | |
| Michael J. Spencer |
1:f5ac63519541 | 50 | |
| Michael J. Spencer |
1:f5ac63519541 | 51 | #define _USE_FASTSEEK 0 /* 0:Disable or 1:Enable */ |
| Michael J. Spencer |
1:f5ac63519541 | 52 | /* To enable fast seek feature, set _USE_FASTSEEK to 1. */ |
| Michael J. Spencer |
1:f5ac63519541 | 53 | |
| Michael J. Spencer |
1:f5ac63519541 | 54 | |
| Michael J. Spencer |
1:f5ac63519541 | 55 | |
| Michael J. Spencer |
1:f5ac63519541 | 56 | /*---------------------------------------------------------------------------/ |
| Michael J. Spencer |
1:f5ac63519541 | 57 | / Locale and Namespace Configurations |
| Michael J. Spencer |
1:f5ac63519541 | 58 | /----------------------------------------------------------------------------*/ |
| Michael J. Spencer |
1:f5ac63519541 | 59 | |
| Michael J. Spencer |
1:f5ac63519541 | 60 | #define _CODE_PAGE 858 |
| Michael J. Spencer |
1:f5ac63519541 | 61 | /* The _CODE_PAGE specifies the OEM code page to be used on the target system. |
| Michael J. Spencer |
1:f5ac63519541 | 62 | / Incorrect setting of the code page can cause a file open failure. |
| Michael J. Spencer |
1:f5ac63519541 | 63 | / |
| Michael J. Spencer |
1:f5ac63519541 | 64 | / 932 - Japanese Shift-JIS (DBCS, OEM, Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 65 | / 936 - Simplified Chinese GBK (DBCS, OEM, Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 66 | / 949 - Korean (DBCS, OEM, Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 67 | / 950 - Traditional Chinese Big5 (DBCS, OEM, Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 68 | / 1250 - Central Europe (Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 69 | / 1251 - Cyrillic (Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 70 | / 1252 - Latin 1 (Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 71 | / 1253 - Greek (Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 72 | / 1254 - Turkish (Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 73 | / 1255 - Hebrew (Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 74 | / 1256 - Arabic (Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 75 | / 1257 - Baltic (Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 76 | / 1258 - Vietnam (OEM, Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 77 | / 437 - U.S. (OEM) |
| Michael J. Spencer |
1:f5ac63519541 | 78 | / 720 - Arabic (OEM) |
| Michael J. Spencer |
1:f5ac63519541 | 79 | / 737 - Greek (OEM) |
| Michael J. Spencer |
1:f5ac63519541 | 80 | / 775 - Baltic (OEM) |
| Michael J. Spencer |
1:f5ac63519541 | 81 | / 850 - Multilingual Latin 1 (OEM) |
| Michael J. Spencer |
1:f5ac63519541 | 82 | / 858 - Multilingual Latin 1 + Euro (OEM) |
| Michael J. Spencer |
1:f5ac63519541 | 83 | / 852 - Latin 2 (OEM) |
| Michael J. Spencer |
1:f5ac63519541 | 84 | / 855 - Cyrillic (OEM) |
| Michael J. Spencer |
1:f5ac63519541 | 85 | / 866 - Russian (OEM) |
| Michael J. Spencer |
1:f5ac63519541 | 86 | / 857 - Turkish (OEM) |
| Michael J. Spencer |
1:f5ac63519541 | 87 | / 862 - Hebrew (OEM) |
| Michael J. Spencer |
1:f5ac63519541 | 88 | / 874 - Thai (OEM, Windows) |
| Michael J. Spencer |
1:f5ac63519541 | 89 | / 1 - ASCII only (Valid for non LFN cfg.) |
| Michael J. Spencer |
1:f5ac63519541 | 90 | */ |
| Michael J. Spencer |
1:f5ac63519541 | 91 | |
| Michael J. Spencer |
1:f5ac63519541 | 92 | |
| Michael J. Spencer |
1:f5ac63519541 | 93 | #define _USE_LFN 1 /* 0 to 3 */ |
| Michael J. Spencer |
1:f5ac63519541 | 94 | #define _MAX_LFN 255 /* Maximum LFN length to handle (12 to 255) */ |
| Michael J. Spencer |
1:f5ac63519541 | 95 | /* The _USE_LFN option switches the LFN support. |
| Michael J. Spencer |
1:f5ac63519541 | 96 | / |
| Michael J. Spencer |
1:f5ac63519541 | 97 | / 0: Disable LFN feature. _MAX_LFN and _LFN_UNICODE have no effect. |
| Michael J. Spencer |
1:f5ac63519541 | 98 | / 1: Enable LFN with static working buffer on the BSS. Always NOT reentrant. |
| Michael J. Spencer |
1:f5ac63519541 | 99 | / 2: Enable LFN with dynamic working buffer on the STACK. |
| Michael J. Spencer |
1:f5ac63519541 | 100 | / 3: Enable LFN with dynamic working buffer on the HEAP. |
| Michael J. Spencer |
1:f5ac63519541 | 101 | / |
| Michael J. Spencer |
1:f5ac63519541 | 102 | / The LFN working buffer occupies (_MAX_LFN + 1) * 2 bytes. To enable LFN, |
| Michael J. Spencer |
1:f5ac63519541 | 103 | / Unicode handling functions ff_convert() and ff_wtoupper() must be added |
| Michael J. Spencer |
1:f5ac63519541 | 104 | / to the project. When enable to use heap, memory control functions |
| Michael J. Spencer |
1:f5ac63519541 | 105 | / ff_memalloc() and ff_memfree() must be added to the project. */ |
| Michael J. Spencer |
1:f5ac63519541 | 106 | |
| Michael J. Spencer |
1:f5ac63519541 | 107 | |
| Michael J. Spencer |
1:f5ac63519541 | 108 | #define _LFN_UNICODE 0 /* 0:ANSI/OEM or 1:Unicode */ |
| Michael J. Spencer |
1:f5ac63519541 | 109 | /* To switch the character code set on FatFs API to Unicode, |
| Michael J. Spencer |
1:f5ac63519541 | 110 | / enable LFN feature and set _LFN_UNICODE to 1. */ |
| Michael J. Spencer |
1:f5ac63519541 | 111 | |
| Michael J. Spencer |
1:f5ac63519541 | 112 | |
| Michael J. Spencer |
1:f5ac63519541 | 113 | #define _FS_RPATH 0 /* 0 to 2 */ |
| Michael J. Spencer |
1:f5ac63519541 | 114 | /* The _FS_RPATH option configures relative path feature. |
| Michael J. Spencer |
1:f5ac63519541 | 115 | / |
| Michael J. Spencer |
1:f5ac63519541 | 116 | / 0: Disable relative path feature and remove related functions. |
| Michael J. Spencer |
1:f5ac63519541 | 117 | / 1: Enable relative path. f_chdrive() and f_chdir() are available. |
| Michael J. Spencer |
1:f5ac63519541 | 118 | / 2: f_getcwd() is available in addition to 1. |
| Michael J. Spencer |
1:f5ac63519541 | 119 | / |
| Michael J. Spencer |
1:f5ac63519541 | 120 | / Note that output of the f_readdir fnction is affected by this option. */ |
| Michael J. Spencer |
1:f5ac63519541 | 121 | |
| Michael J. Spencer |
1:f5ac63519541 | 122 | |
| Michael J. Spencer |
1:f5ac63519541 | 123 | |
| Michael J. Spencer |
1:f5ac63519541 | 124 | /*---------------------------------------------------------------------------/ |
| Michael J. Spencer |
1:f5ac63519541 | 125 | / Physical Drive Configurations |
| Michael J. Spencer |
1:f5ac63519541 | 126 | /----------------------------------------------------------------------------*/ |
| Michael J. Spencer |
1:f5ac63519541 | 127 | |
| Michael J. Spencer |
1:f5ac63519541 | 128 | #define _VOLUMES 4 |
| Michael J. Spencer |
1:f5ac63519541 | 129 | /* Number of volumes (logical drives) to be used. */ |
| Michael J. Spencer |
1:f5ac63519541 | 130 | |
| Michael J. Spencer |
1:f5ac63519541 | 131 | |
| Michael J. Spencer |
1:f5ac63519541 | 132 | #define _MAX_SS 512 /* 512, 1024, 2048 or 4096 */ |
| Michael J. Spencer |
1:f5ac63519541 | 133 | /* Maximum sector size to be handled. |
| Michael J. Spencer |
1:f5ac63519541 | 134 | / Always set 512 for memory card and hard disk but a larger value may be |
| Michael J. Spencer |
1:f5ac63519541 | 135 | / required for on-board flash memory, floppy disk and optical disk. |
| Michael J. Spencer |
1:f5ac63519541 | 136 | / When _MAX_SS is larger than 512, it configures FatFs to variable sector size |
| Michael J. Spencer |
1:f5ac63519541 | 137 | / and GET_SECTOR_SIZE command must be implememted to the disk_ioctl function. */ |
| Michael J. Spencer |
1:f5ac63519541 | 138 | |
| Michael J. Spencer |
1:f5ac63519541 | 139 | |
| Michael J. Spencer |
1:f5ac63519541 | 140 | #define _MULTI_PARTITION 0 /* 0:Single partition, 1/2:Enable multiple partition */ |
| Michael J. Spencer |
1:f5ac63519541 | 141 | /* When set to 0, each volume is bound to the same physical drive number and |
| Michael J. Spencer |
1:f5ac63519541 | 142 | / it can mount only first primaly partition. When it is set to 1, each volume |
| Michael J. Spencer |
1:f5ac63519541 | 143 | / is tied to the partitions listed in VolToPart[]. */ |
| Michael J. Spencer |
1:f5ac63519541 | 144 | |
| Michael J. Spencer |
1:f5ac63519541 | 145 | |
| Michael J. Spencer |
1:f5ac63519541 | 146 | #define _USE_ERASE 0 /* 0:Disable or 1:Enable */ |
| Michael J. Spencer |
1:f5ac63519541 | 147 | /* To enable sector erase feature, set _USE_ERASE to 1. CTRL_ERASE_SECTOR command |
| Michael J. Spencer |
1:f5ac63519541 | 148 | / should be added to the disk_ioctl functio. */ |
| Michael J. Spencer |
1:f5ac63519541 | 149 | |
| Michael J. Spencer |
1:f5ac63519541 | 150 | |
| Michael J. Spencer |
1:f5ac63519541 | 151 | |
| Michael J. Spencer |
1:f5ac63519541 | 152 | /*---------------------------------------------------------------------------/ |
| Michael J. Spencer |
1:f5ac63519541 | 153 | / System Configurations |
| Michael J. Spencer |
1:f5ac63519541 | 154 | /----------------------------------------------------------------------------*/ |
| Michael J. Spencer |
1:f5ac63519541 | 155 | |
| Michael J. Spencer |
1:f5ac63519541 | 156 | #define _WORD_ACCESS 0 /* 0 or 1 */ |
| Michael J. Spencer |
1:f5ac63519541 | 157 | /* Set 0 first and it is always compatible with all platforms. The _WORD_ACCESS |
| Michael J. Spencer |
1:f5ac63519541 | 158 | / option defines which access method is used to the word data on the FAT volume. |
| Michael J. Spencer |
1:f5ac63519541 | 159 | / |
| Michael J. Spencer |
1:f5ac63519541 | 160 | / 0: Byte-by-byte access. |
| Michael J. Spencer |
1:f5ac63519541 | 161 | / 1: Word access. Do not choose this unless following condition is met. |
| Michael J. Spencer |
1:f5ac63519541 | 162 | / |
| Michael J. Spencer |
1:f5ac63519541 | 163 | / When the byte order on the memory is big-endian or address miss-aligned word |
| Michael J. Spencer |
1:f5ac63519541 | 164 | / access results incorrect behavior, the _WORD_ACCESS must be set to 0. |
| Michael J. Spencer |
1:f5ac63519541 | 165 | / If it is not the case, the value can also be set to 1 to improve the |
| Michael J. Spencer |
1:f5ac63519541 | 166 | / performance and code size. |
| Michael J. Spencer |
1:f5ac63519541 | 167 | */ |
| Michael J. Spencer |
1:f5ac63519541 | 168 | |
| Michael J. Spencer |
1:f5ac63519541 | 169 | |
| Michael J. Spencer |
1:f5ac63519541 | 170 | /* A header file that defines sync object types on the O/S, such as |
| Michael J. Spencer |
1:f5ac63519541 | 171 | / windows.h, ucos_ii.h and semphr.h, must be included prior to ff.h. */ |
| Michael J. Spencer |
1:f5ac63519541 | 172 | |
| Michael J. Spencer |
1:f5ac63519541 | 173 | #define _FS_REENTRANT 0 /* 0:Disable or 1:Enable */ |
| Michael J. Spencer |
1:f5ac63519541 | 174 | #define _FS_TIMEOUT 1000 /* Timeout period in unit of time ticks */ |
| Michael J. Spencer |
1:f5ac63519541 | 175 | #define _SYNC_t HANDLE /* O/S dependent type of sync object. e.g. HANDLE, OS_EVENT*, ID and etc.. */ |
| Michael J. Spencer |
1:f5ac63519541 | 176 | |
| Michael J. Spencer |
1:f5ac63519541 | 177 | /* The _FS_REENTRANT option switches the reentrancy (thread safe) of the FatFs module. |
| Michael J. Spencer |
1:f5ac63519541 | 178 | / |
| Michael J. Spencer |
1:f5ac63519541 | 179 | / 0: Disable reentrancy. _SYNC_t and _FS_TIMEOUT have no effect. |
| Michael J. Spencer |
1:f5ac63519541 | 180 | / 1: Enable reentrancy. Also user provided synchronization handlers, |
| Michael J. Spencer |
1:f5ac63519541 | 181 | / ff_req_grant, ff_rel_grant, ff_del_syncobj and ff_cre_syncobj |
| Michael J. Spencer |
1:f5ac63519541 | 182 | / function must be added to the project. */ |
| Michael J. Spencer |
1:f5ac63519541 | 183 | |
| Michael J. Spencer |
1:f5ac63519541 | 184 | |
| Michael J. Spencer |
1:f5ac63519541 | 185 | #define _FS_SHARE 0 /* 0:Disable or >=1:Enable */ |
| Michael J. Spencer |
1:f5ac63519541 | 186 | /* To enable file shareing feature, set _FS_SHARE to 1 or greater. The value |
| Michael J. Spencer |
1:f5ac63519541 | 187 | defines how many files can be opened simultaneously. */ |
| Michael J. Spencer |
1:f5ac63519541 | 188 | |
| Michael J. Spencer |
1:f5ac63519541 | 189 | |
| Michael J. Spencer |
1:f5ac63519541 | 190 | #endif /* _FFCONFIG */ |