YongChing Tee / FatFileSystem

forked

Dependents:   Lab3

Fork of FatFileSystemCpp by Igor Skochinsky

ffconf.h@2:5cdf6d5c3b68, 2013-03-06 (annotated)

Committer:
YongChingTee
Date:
Wed Mar 06 00:19:18 2013 +0000
Revision:
2:5cdf6d5c3b68
Parent:
0:6ceefe1c53e4 
first commit

Who changed what in which revision?

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