]> cloudbase.mooo.com Git - z180-stamp.git/blobdiff - fatfs/src/00readme.txt
Merge branch 'chan-fatfs' into fatfs-integration
[z180-stamp.git] / fatfs / src / 00readme.txt
index b30f7d3879c6ec74e73825b034c461a8e8db97ea..42426a4011ac035dae282deb1bf6404ca67e5be4 100644 (file)
-FatFs Module Source Files R0.10c                      (C)ChaN, 2014\r
+FatFs Module Source Files R0.12a\r
 \r
 \r
 FILES\r
 \r
-  ffconf.h   Configuration file for FatFs module.\r
-  ff.h       Common include file for FatFs and application module.\r
-  ff.c       FatFs module.\r
-  diskio.h   Common include file for FatFs and disk I/O module.\r
-  diskio.c   An example of glue function to attach existing disk I/O module to FatFs.\r
-  integer.h  Integer type definitions for FatFs.\r
-  option     Optional external functions.\r
+  00readme.txt This file.\r
+  history.txt  Revision history.\r
+  ffconf.h     Configuration file for FatFs module.\r
+  ff.h         Common include file for FatFs and application module.\r
+  ff.c         FatFs module.\r
+  diskio.h     Common include file for FatFs and disk I/O module.\r
+  diskio.c     An example of glue function to attach existing disk I/O module to FatFs.\r
+  integer.h    Integer type definitions for FatFs.\r
+  option       Optional external functions.\r
+\r
 \r
   Low level disk I/O module is not included in this archive because the FatFs\r
   module is only a generic file system layer and not depend on any specific\r
   storage device. You have to provide a low level disk I/O module that written\r
-  to control your storage device.\r
-\r
-\r
-\r
-AGREEMENTS\r
-\r
- FatFs module is an open source software to implement FAT file system to\r
- small embedded systems. This is a free software and is opened for education,\r
- research and commercial developments under license policy of following trems.\r
-\r
-  Copyright (C) 2014, ChaN, all right reserved.\r
-\r
- * The FatFs module is a free software and there is NO WARRANTY.\r
- * No restriction on use. You can use, modify and redistribute it for\r
-   personal, non-profit or commercial product UNDER YOUR RESPONSIBILITY.\r
- * Redistributions of source code must retain the above copyright notice.\r
-\r
-\r
-\r
-REVISION HISTORY\r
-\r
-  Feb 26, 2006  R0.00  Prototype\r
-\r
-  Apr 29, 2006  R0.01  First release.\r
-\r
-  Jun 01, 2006  R0.02  Added FAT12.\r
-                       Removed unbuffered mode.\r
-                       Fixed a problem on small (<32M) patition.\r
-\r
-  Jun 10, 2006  R0.02a Added a configuration option _FS_MINIMUM.\r
-\r
-  Sep 22, 2006  R0.03  Added f_rename.\r
-                       Changed option _FS_MINIMUM to _FS_MINIMIZE.\r
-\r
-  Dec 11, 2006  R0.03a Improved cluster scan algolithm to write files fast.\r
-                       Fixed f_mkdir creates incorrect directory on FAT32.\r
-\r
-  Feb 04, 2007  R0.04  Supported multiple drive system. (FatFs)\r
-                       Changed some APIs for multiple drive system.\r
-                       Added f_mkfs. (FatFs)\r
-                       Added _USE_FAT32 option. (Tiny-FatFs)\r
-\r
-  Apr 01, 2007  R0.04a Supported multiple partitions on a plysical drive. (FatFs)\r
-                       Fixed an endian sensitive code in f_mkfs. (FatFs)\r
-                       Added a capability of extending the file size to f_lseek.\r
-                       Added minimization level 3.\r
-                       Fixed a problem that can collapse a sector when recreate an\r
-                       existing file in any sub-directory at non FAT32 cfg. (Tiny-FatFs)\r
-\r
-  May 05, 2007  R0.04b Added _USE_NTFLAG option.\r
-                       Added FSInfo support.\r
-                       Fixed some problems corresponds to FAT32. (Tiny-FatFs)\r
-                       Fixed DBCS name can result FR_INVALID_NAME.\r
-                       Fixed short seek (0 < ofs <= csize) collapses the file object.\r
-\r
-  Aug 25, 2007  R0.05  Changed arguments of f_read, f_write.\r
-                       Changed arguments of f_mkfs. (FatFs)\r
-                       Fixed f_mkfs on FAT32 creates incorrect FSInfo. (FatFs)\r
-                       Fixed f_mkdir on FAT32 creates incorrect directory. (FatFs)\r
-\r
-  Feb 03, 2008  R0.05a Added f_truncate().\r
-                       Added f_utime().\r
-                       Fixed off by one error at FAT sub-type determination.\r
-                       Fixed btr in f_read() can be mistruncated.\r
-                       Fixed cached sector is not flushed when create and close without write.\r
-\r
-  Apr 01, 2008  R0.06  Added f_forward(). (Tiny-FatFs)\r
-                       Added string functions: fputc(), fputs(), fprintf() and fgets().\r
-                       Improved performance of f_lseek() on move to the same or following cluster.\r
-\r
-  Apr 01, 2009, R0.07  Merged Tiny-FatFs as a buffer configuration option.\r
-                       Added long file name support.\r
-                       Added multiple code page support.\r
-                       Added re-entrancy for multitask operation.\r
-                       Added auto cluster size selection to f_mkfs().\r
-                       Added rewind option to f_readdir().\r
-                       Changed result code of critical errors.\r
-                       Renamed string functions to avoid name collision.\r
-\r
-  Apr 14, 2009, R0.07a Separated out OS dependent code on reentrant cfg.\r
-                       Added multiple sector size support.\r
-\r
-  Jun 21, 2009, R0.07c Fixed f_unlink() may return FR_OK on error.\r
-                       Fixed wrong cache control in f_lseek().\r
-                       Added relative path feature.\r
-                       Added f_chdir().\r
-                       Added f_chdrive().\r
-                       Added proper case conversion for extended characters.\r
-\r
-  Nov 03, 2009 R0.07e  Separated out configuration options from ff.h to ffconf.h.\r
-                       Added a configuration option, _LFN_UNICODE.\r
-                       Fixed f_unlink() fails to remove a sub-dir on _FS_RPATH.\r
-                       Fixed name matching error on the 13 char boundary.\r
-                       Changed f_readdir() to return the SFN with always upper case on non-LFN cfg.\r
-\r
-  May 15, 2010, R0.08  Added a memory configuration option. (_USE_LFN)\r
-                       Added file lock feature. (_FS_SHARE)\r
-                       Added fast seek feature. (_USE_FASTSEEK)\r
-                       Changed some types on the API, XCHAR->TCHAR.\r
-                       Changed fname member in the FILINFO structure on Unicode cfg.\r
-                       String functions support UTF-8 encoding files on Unicode cfg.\r
-\r
-  Aug 16,'10 R0.08a    Added f_getcwd(). (_FS_RPATH = 2)\r
-                       Added sector erase feature. (_USE_ERASE)\r
-                       Moved file lock semaphore table from fs object to the bss.\r
-                       Fixed a wrong directory entry is created on non-LFN cfg when the given name contains ';'.\r
-                       Fixed f_mkfs() creates wrong FAT32 volume.\r
-\r
-  Jan 15,'11 R0.08b    Fast seek feature is also applied to f_read() and f_write().\r
-                       f_lseek() reports required table size on creating CLMP.\r
-                       Extended format syntax of f_printf function.\r
-                       Ignores duplicated directory separators in given path names.\r
-\r
-  Sep 06,'11 R0.09     f_mkfs() supports multiple partition to finish the multiple partition feature.\r
-                       Added f_fdisk(). (_MULTI_PARTITION = 2)\r
-\r
-  Aug 27,'12 R0.09a    Fixed assertion failure due to OS/2 EA on FAT12/16.\r
-                       Changed f_open() and f_opendir() reject null object pointer to avoid crash.\r
-                       Changed option name _FS_SHARE to _FS_LOCK.\r
-\r
-  Jan 23,'13 R0.09b    Added f_getlabel() and f_setlabel(). (_USE_LABEL)\r
-\r
-  Oct 02,'13 R0.10     Added selection of character encoding on the file. (_STRF_ENCODE)\r
-                       Added f_closedir().\r
-                       Added forced full FAT scan for f_getfree(). (_FS_NOFSINFO)\r
-                       Added forced mount feature with changes of f_mount().\r
-                       Improved behavior of volume auto detection.\r
-                       Improved write throughput of f_puts() and f_printf().\r
-                       Changed argument of f_chdrive(), f_mkfs(), disk_read() and disk_write().\r
-                       Fixed f_write() can be truncated when the file size is close to 4GB.\r
-                       Fixed f_open(), f_mkdir() and f_setlabel() can return incorrect error code.\r
-\r
-  Jan 15,'14 R0.10a    Added arbitrary strings as drive number in the path name. (_STR_VOLUME_ID)\r
-                       Added a configuration option of minimum sector size. (_MIN_SS)\r
-                       2nd argument of f_rename() can have a drive number and it will be ignored.\r
-                       Fixed f_mount() with forced mount fails when drive number is >= 1.\r
-                       Fixed f_close() invalidates the file object without volume lock.\r
-                       Fixed f_closedir() returns but the volume lock is left acquired.\r
-                       Fixed creation of an entry with LFN fails on too many SFN collisions.\r
-\r
-  Mar 19,'14 R0.10b    Fixed a hard error in the disk I/O layer can collapse the directory entry.\r
-                       Fixed LFN entry is not deleted on delete/rename an object with lossy converted SFN.\r
+  to control the target storage device.\r
 \r
-  Nov 09,'14 R0.10c    Added a configuration option for the platforms without RTC. (_FS_NORTC)\r
-                       Fixed volume label created by Mac OS X cannot be retrieved with f_getlabel().\r
-                       Fixed a potential problem of FAT access that can appear on disk error.\r
-                       Fixed null pointer dereference on attempting to delete the root direcotry.\r