|
| 1 | +FatFs Module Source Files R0.10c (C)ChaN, 2014 |
| 2 | + |
| 3 | + |
| 4 | +FILES |
| 5 | + |
| 6 | + ffconf.h Configuration file for FatFs module. |
| 7 | + ff.h Common include file for FatFs and application module. |
| 8 | + ff.c FatFs module. |
| 9 | + diskio.h Common include file for FatFs and disk I/O module. |
| 10 | + diskio.c An example of glue function to attach existing disk I/O module to FatFs. |
| 11 | + integer.h Integer type definitions for FatFs. |
| 12 | + option Optional external functions. |
| 13 | + |
| 14 | + Low level disk I/O module is not included in this archive because the FatFs |
| 15 | + module is only a generic file system layer and not depend on any specific |
| 16 | + storage device. You have to provide a low level disk I/O module that written |
| 17 | + to control your storage device. |
| 18 | + |
| 19 | + |
| 20 | + |
| 21 | +AGREEMENTS |
| 22 | + |
| 23 | + FatFs module is an open source software to implement FAT file system to |
| 24 | + small embedded systems. This is a free software and is opened for education, |
| 25 | + research and commercial developments under license policy of following trems. |
| 26 | + |
| 27 | + Copyright (C) 2014, ChaN, all right reserved. |
| 28 | + |
| 29 | + * The FatFs module is a free software and there is NO WARRANTY. |
| 30 | + * No restriction on use. You can use, modify and redistribute it for |
| 31 | + personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY. |
| 32 | + * Redistributions of source code must retain the above copyright notice. |
| 33 | + |
| 34 | + |
| 35 | + |
| 36 | +REVISION HISTORY |
| 37 | + |
| 38 | + Feb 26, 2006 R0.00 Prototype |
| 39 | + |
| 40 | + Apr 29, 2006 R0.01 First release. |
| 41 | + |
| 42 | + Jun 01, 2006 R0.02 Added FAT12. |
| 43 | + Removed unbuffered mode. |
| 44 | + Fixed a problem on small (<32M) patition. |
| 45 | + |
| 46 | + Jun 10, 2006 R0.02a Added a configuration option _FS_MINIMUM. |
| 47 | + |
| 48 | + Sep 22, 2006 R0.03 Added f_rename. |
| 49 | + Changed option _FS_MINIMUM to _FS_MINIMIZE. |
| 50 | + |
| 51 | + Dec 11, 2006 R0.03a Improved cluster scan algolithm to write files fast. |
| 52 | + Fixed f_mkdir creates incorrect directory on FAT32. |
| 53 | + |
| 54 | + Feb 04, 2007 R0.04 Supported multiple drive system. (FatFs) |
| 55 | + Changed some APIs for multiple drive system. |
| 56 | + Added f_mkfs. (FatFs) |
| 57 | + Added _USE_FAT32 option. (Tiny-FatFs) |
| 58 | + |
| 59 | + Apr 01, 2007 R0.04a Supported multiple partitions on a plysical drive. (FatFs) |
| 60 | + Fixed an endian sensitive code in f_mkfs. (FatFs) |
| 61 | + Added a capability of extending the file size to f_lseek. |
| 62 | + Added minimization level 3. |
| 63 | + Fixed a problem that can collapse a sector when recreate an |
| 64 | + existing file in any sub-directory at non FAT32 cfg. (Tiny-FatFs) |
| 65 | + |
| 66 | + May 05, 2007 R0.04b Added _USE_NTFLAG option. |
| 67 | + Added FSInfo support. |
| 68 | + Fixed some problems corresponds to FAT32. (Tiny-FatFs) |
| 69 | + Fixed DBCS name can result FR_INVALID_NAME. |
| 70 | + Fixed short seek (0 < ofs <= csize) collapses the file object. |
| 71 | + |
| 72 | + Aug 25, 2007 R0.05 Changed arguments of f_read, f_write. |
| 73 | + Changed arguments of f_mkfs. (FatFs) |
| 74 | + Fixed f_mkfs on FAT32 creates incorrect FSInfo. (FatFs) |
| 75 | + Fixed f_mkdir on FAT32 creates incorrect directory. (FatFs) |
| 76 | + |
| 77 | + Feb 03, 2008 R0.05a Added f_truncate(). |
| 78 | + Added f_utime(). |
| 79 | + Fixed off by one error at FAT sub-type determination. |
| 80 | + Fixed btr in f_read() can be mistruncated. |
| 81 | + Fixed cached sector is not flushed when create and close without write. |
| 82 | + |
| 83 | + Apr 01, 2008 R0.06 Added f_forward(). (Tiny-FatFs) |
| 84 | + Added string functions: fputc(), fputs(), fprintf() and fgets(). |
| 85 | + Improved performance of f_lseek() on move to the same or following cluster. |
| 86 | + |
| 87 | + Apr 01, 2009, R0.07 Merged Tiny-FatFs as a buffer configuration option. |
| 88 | + Added long file name support. |
| 89 | + Added multiple code page support. |
| 90 | + Added re-entrancy for multitask operation. |
| 91 | + Added auto cluster size selection to f_mkfs(). |
| 92 | + Added rewind option to f_readdir(). |
| 93 | + Changed result code of critical errors. |
| 94 | + Renamed string functions to avoid name collision. |
| 95 | + |
| 96 | + Apr 14, 2009, R0.07a Separated out OS dependent code on reentrant cfg. |
| 97 | + Added multiple sector size support. |
| 98 | + |
| 99 | + Jun 21, 2009, R0.07c Fixed f_unlink() may return FR_OK on error. |
| 100 | + Fixed wrong cache control in f_lseek(). |
| 101 | + Added relative path feature. |
| 102 | + Added f_chdir(). |
| 103 | + Added f_chdrive(). |
| 104 | + Added proper case conversion for extended characters. |
| 105 | + |
| 106 | + Nov 03, 2009 R0.07e Separated out configuration options from ff.h to ffconf.h. |
| 107 | + Added a configuration option, _LFN_UNICODE. |
| 108 | + Fixed f_unlink() fails to remove a sub-dir on _FS_RPATH. |
| 109 | + Fixed name matching error on the 13 char boundary. |
| 110 | + Changed f_readdir() to return the SFN with always upper case on non-LFN cfg. |
| 111 | + |
| 112 | + May 15, 2010, R0.08 Added a memory configuration option. (_USE_LFN) |
| 113 | + Added file lock feature. (_FS_SHARE) |
| 114 | + Added fast seek feature. (_USE_FASTSEEK) |
| 115 | + Changed some types on the API, XCHAR->TCHAR. |
| 116 | + Changed fname member in the FILINFO structure on Unicode cfg. |
| 117 | + String functions support UTF-8 encoding files on Unicode cfg. |
| 118 | + |
| 119 | + Aug 16,'10 R0.08a Added f_getcwd(). (_FS_RPATH = 2) |
| 120 | + Added sector erase feature. (_USE_ERASE) |
| 121 | + Moved file lock semaphore table from fs object to the bss. |
| 122 | + Fixed a wrong directory entry is created on non-LFN cfg when the given name contains ';'. |
| 123 | + Fixed f_mkfs() creates wrong FAT32 volume. |
| 124 | + |
| 125 | + Jan 15,'11 R0.08b Fast seek feature is also applied to f_read() and f_write(). |
| 126 | + f_lseek() reports required table size on creating CLMP. |
| 127 | + Extended format syntax of f_printf function. |
| 128 | + Ignores duplicated directory separators in given path names. |
| 129 | + |
| 130 | + Sep 06,'11 R0.09 f_mkfs() supports multiple partition to finish the multiple partition feature. |
| 131 | + Added f_fdisk(). (_MULTI_PARTITION = 2) |
| 132 | + |
| 133 | + Aug 27,'12 R0.09a Fixed assertion failure due to OS/2 EA on FAT12/16. |
| 134 | + Changed f_open() and f_opendir() reject null object pointer to avoid crash. |
| 135 | + Changed option name _FS_SHARE to _FS_LOCK. |
| 136 | + |
| 137 | + Jan 23,'13 R0.09b Added f_getlabel() and f_setlabel(). (_USE_LABEL) |
| 138 | + |
| 139 | + Oct 02,'13 R0.10 Added selection of character encoding on the file. (_STRF_ENCODE) |
| 140 | + Added f_closedir(). |
| 141 | + Added forced full FAT scan for f_getfree(). (_FS_NOFSINFO) |
| 142 | + Added forced mount feature with changes of f_mount(). |
| 143 | + Improved behavior of volume auto detection. |
| 144 | + Improved write throughput of f_puts() and f_printf(). |
| 145 | + Changed argument of f_chdrive(), f_mkfs(), disk_read() and disk_write(). |
| 146 | + Fixed f_write() can be truncated when the file size is close to 4GB. |
| 147 | + Fixed f_open(), f_mkdir() and f_setlabel() can return incorrect error code. |
| 148 | + |
| 149 | + Jan 15,'14 R0.10a Added arbitrary strings as drive number in the path name. (_STR_VOLUME_ID) |
| 150 | + Added a configuration option of minimum sector size. (_MIN_SS) |
| 151 | + 2nd argument of f_rename() can have a drive number and it will be ignored. |
| 152 | + Fixed f_mount() with forced mount fails when drive number is >= 1. |
| 153 | + Fixed f_close() invalidates the file object without volume lock. |
| 154 | + Fixed f_closedir() returns but the volume lock is left acquired. |
| 155 | + Fixed creation of an entry with LFN fails on too many SFN collisions. |
| 156 | + |
| 157 | + Mar 19,'14 R0.10b Fixed a hard error in the disk I/O layer can collapse the directory entry. |
| 158 | + Fixed LFN entry is not deleted on delete/rename an object with lossy converted SFN. |
| 159 | + |
| 160 | + Nov 09,'14 R0.10c Added a configuration option for the platforms without RTC. (_FS_NORTC) |
| 161 | + Fixed volume label created by Mac OS X cannot be retrieved with f_getlabel(). |
| 162 | + Fixed a potential problem of FAT access that can appear on disk error. |
| 163 | + Fixed null pointer dereference on attempting to delete the root direcotry. |
0 commit comments