Update FatFs to R0.13c

This commit is contained in:
hexkyz 2019-07-01 20:12:30 +01:00
parent 6f85b11fcc
commit e3b968fa80
30 changed files with 70663 additions and 70602 deletions

View File

@ -1,324 +1,330 @@
---------------------------------------------------------------------------- ----------------------------------------------------------------------------
Revision history of FatFs module Revision history of FatFs module
---------------------------------------------------------------------------- ----------------------------------------------------------------------------
R0.00 (February 26, 2006) R0.00 (February 26, 2006)
Prototype. Prototype.
R0.01 (April 29, 2006) R0.01 (April 29, 2006)
The first release. The first release.
R0.02 (June 01, 2006) R0.02 (June 01, 2006)
Added FAT12 support. Added FAT12 support.
Removed unbuffered mode. Removed unbuffered mode.
Fixed a problem on small (<32M) partition. Fixed a problem on small (<32M) partition.
R0.02a (June 10, 2006) R0.02a (June 10, 2006)
Added a configuration option (_FS_MINIMUM). Added a configuration option (_FS_MINIMUM).
R0.03 (September 22, 2006) R0.03 (September 22, 2006)
Added f_rename(). Added f_rename().
Changed option _FS_MINIMUM to _FS_MINIMIZE. Changed option _FS_MINIMUM to _FS_MINIMIZE.
R0.03a (December 11, 2006) R0.03a (December 11, 2006)
Improved cluster scan algorithm to write files fast. Improved cluster scan algorithm to write files fast.
Fixed f_mkdir() creates incorrect directory on FAT32. Fixed f_mkdir() creates incorrect directory on FAT32.
R0.04 (February 04, 2007) R0.04 (February 04, 2007)
Added f_mkfs(). Added f_mkfs().
Supported multiple drive system. Supported multiple drive system.
Changed some interfaces for multiple drive system. Changed some interfaces for multiple drive system.
Changed f_mountdrv() to f_mount(). Changed f_mountdrv() to f_mount().
R0.04a (April 01, 2007) R0.04a (April 01, 2007)
Supported multiple partitions on a physical drive. Supported multiple partitions on a physical drive.
Added a capability of extending file size to f_lseek(). Added a capability of extending file size to f_lseek().
Added minimization level 3. Added minimization level 3.
Fixed an endian sensitive code in f_mkfs(). Fixed an endian sensitive code in f_mkfs().
R0.04b (May 05, 2007) R0.04b (May 05, 2007)
Added a configuration option _USE_NTFLAG. Added a configuration option _USE_NTFLAG.
Added FSINFO support. Added FSINFO support.
Fixed DBCS name can result FR_INVALID_NAME. Fixed DBCS name can result FR_INVALID_NAME.
Fixed short seek (<= csize) collapses the file object. Fixed short seek (<= csize) collapses the file object.
R0.05 (August 25, 2007) R0.05 (August 25, 2007)
Changed arguments of f_read(), f_write() and f_mkfs(). Changed arguments of f_read(), f_write() and f_mkfs().
Fixed f_mkfs() on FAT32 creates incorrect FSINFO. Fixed f_mkfs() on FAT32 creates incorrect FSINFO.
Fixed f_mkdir() on FAT32 creates incorrect directory. Fixed f_mkdir() on FAT32 creates incorrect directory.
R0.05a (February 03, 2008) R0.05a (February 03, 2008)
Added f_truncate() and f_utime(). Added f_truncate() and f_utime().
Fixed off by one error at FAT sub-type determination. Fixed off by one error at FAT sub-type determination.
Fixed btr in f_read() can be mistruncated. Fixed btr in f_read() can be mistruncated.
Fixed cached sector is not flushed when create and close without write. Fixed cached sector is not flushed when create and close without write.
R0.06 (April 01, 2008) R0.06 (April 01, 2008)
Added fputc(), fputs(), fprintf() and fgets(). Added fputc(), fputs(), fprintf() and fgets().
Improved performance of f_lseek() on moving to the same or following cluster. Improved performance of f_lseek() on moving to the same or following cluster.
R0.07 (April 01, 2009) R0.07 (April 01, 2009)
Merged Tiny-FatFs as a configuration option. (_FS_TINY) Merged Tiny-FatFs as a configuration option. (_FS_TINY)
Added long file name feature. (_USE_LFN) Added long file name feature. (_USE_LFN)
Added multiple code page feature. (_CODE_PAGE) Added multiple code page feature. (_CODE_PAGE)
Added re-entrancy for multitask operation. (_FS_REENTRANT) Added re-entrancy for multitask operation. (_FS_REENTRANT)
Added auto cluster size selection to f_mkfs(). Added auto cluster size selection to f_mkfs().
Added rewind option to f_readdir(). Added rewind option to f_readdir().
Changed result code of critical errors. Changed result code of critical errors.
Renamed string functions to avoid name collision. Renamed string functions to avoid name collision.
R0.07a (April 14, 2009) R0.07a (April 14, 2009)
Septemberarated out OS dependent code on reentrant cfg. Septemberarated out OS dependent code on reentrant cfg.
Added multiple sector size feature. Added multiple sector size feature.
R0.07c (June 21, 2009) R0.07c (June 21, 2009)
Fixed f_unlink() can return FR_OK on error. Fixed f_unlink() can return FR_OK on error.
Fixed wrong cache control in f_lseek(). Fixed wrong cache control in f_lseek().
Added relative path feature. Added relative path feature.
Added f_chdir() and f_chdrive(). Added f_chdir() and f_chdrive().
Added proper case conversion to extended character. Added proper case conversion to extended character.
R0.07e (November 03, 2009) R0.07e (November 03, 2009)
Septemberarated out configuration options from ff.h to ffconf.h. Septemberarated out configuration options from ff.h to ffconf.h.
Fixed f_unlink() fails to remove a sub-directory on _FS_RPATH. Fixed f_unlink() fails to remove a sub-directory on _FS_RPATH.
Fixed name matching error on the 13 character boundary. Fixed name matching error on the 13 character boundary.
Added a configuration option, _LFN_UNICODE. Added a configuration option, _LFN_UNICODE.
Changed f_readdir() to return the SFN with always upper case on non-LFN cfg. Changed f_readdir() to return the SFN with always upper case on non-LFN cfg.
R0.08 (May 15, 2010) R0.08 (May 15, 2010)
Added a memory configuration option. (_USE_LFN = 3) Added a memory configuration option. (_USE_LFN = 3)
Added file lock feature. (_FS_SHARE) Added file lock feature. (_FS_SHARE)
Added fast seek feature. (_USE_FASTSEEK) Added fast seek feature. (_USE_FASTSEEK)
Changed some types on the API, XCHAR->TCHAR. Changed some types on the API, XCHAR->TCHAR.
Changed .fname in the FILINFO structure on Unicode cfg. Changed .fname in the FILINFO structure on Unicode cfg.
String functions support UTF-8 encoding files on Unicode cfg. String functions support UTF-8 encoding files on Unicode cfg.
R0.08a (August 16, 2010) R0.08a (August 16, 2010)
Added f_getcwd(). (_FS_RPATH = 2) Added f_getcwd(). (_FS_RPATH = 2)
Added sector erase feature. (_USE_ERASE) Added sector erase feature. (_USE_ERASE)
Moved file lock semaphore table from fs object to the bss. Moved file lock semaphore table from fs object to the bss.
Fixed f_mkfs() creates wrong FAT32 volume. Fixed f_mkfs() creates wrong FAT32 volume.
R0.08b (January 15, 2011) R0.08b (January 15, 2011)
Fast seek feature is also applied to f_read() and f_write(). Fast seek feature is also applied to f_read() and f_write().
f_lseek() reports required table size on creating CLMP. f_lseek() reports required table size on creating CLMP.
Extended format syntax of f_printf(). Extended format syntax of f_printf().
Ignores duplicated directory separators in given path name. Ignores duplicated directory separators in given path name.
R0.09 (September 06, 2011) R0.09 (September 06, 2011)
f_mkfs() supports multiple partition to complete the multiple partition feature. f_mkfs() supports multiple partition to complete the multiple partition feature.
Added f_fdisk(). Added f_fdisk().
R0.09a (August 27, 2012) R0.09a (August 27, 2012)
Changed f_open() and f_opendir() reject null object pointer to avoid crash. Changed f_open() and f_opendir() reject null object pointer to avoid crash.
Changed option name _FS_SHARE to _FS_LOCK. Changed option name _FS_SHARE to _FS_LOCK.
Fixed assertion failure due to OS/2 EA on FAT12/16 volume. Fixed assertion failure due to OS/2 EA on FAT12/16 volume.
R0.09b (January 24, 2013) R0.09b (January 24, 2013)
Added f_setlabel() and f_getlabel(). Added f_setlabel() and f_getlabel().
R0.10 (October 02, 2013) R0.10 (October 02, 2013)
Added selection of character encoding on the file. (_STRF_ENCODE) Added selection of character encoding on the file. (_STRF_ENCODE)
Added f_closedir(). Added f_closedir().
Added forced full FAT scan for f_getfree(). (_FS_NOFSINFO) Added forced full FAT scan for f_getfree(). (_FS_NOFSINFO)
Added forced mount feature with changes of f_mount(). Added forced mount feature with changes of f_mount().
Improved behavior of volume auto detection. Improved behavior of volume auto detection.
Improved write throughput of f_puts() and f_printf(). Improved write throughput of f_puts() and f_printf().
Changed argument of f_chdrive(), f_mkfs(), disk_read() and disk_write(). Changed argument of f_chdrive(), f_mkfs(), disk_read() and disk_write().
Fixed f_write() can be truncated when the file size is close to 4GB. Fixed f_write() can be truncated when the file size is close to 4GB.
Fixed f_open(), f_mkdir() and f_setlabel() can return incorrect value on error. Fixed f_open(), f_mkdir() and f_setlabel() can return incorrect value on error.
R0.10a (January 15, 2014) R0.10a (January 15, 2014)
Added arbitrary strings as drive number in the path name. (_STR_VOLUME_ID) Added arbitrary strings as drive number in the path name. (_STR_VOLUME_ID)
Added a configuration option of minimum sector size. (_MIN_SS) Added a configuration option of minimum sector size. (_MIN_SS)
2nd argument of f_rename() can have a drive number and it will be ignored. 2nd argument of f_rename() can have a drive number and it will be ignored.
Fixed f_mount() with forced mount fails when drive number is >= 1. (appeared at R0.10) Fixed f_mount() with forced mount fails when drive number is >= 1. (appeared at R0.10)
Fixed f_close() invalidates the file object without volume lock. Fixed f_close() invalidates the file object without volume lock.
Fixed f_closedir() returns but the volume lock is left acquired. (appeared at R0.10) Fixed f_closedir() returns but the volume lock is left acquired. (appeared at R0.10)
Fixed creation of an entry with LFN fails on too many SFN collisions. (appeared at R0.07) Fixed creation of an entry with LFN fails on too many SFN collisions. (appeared at R0.07)
R0.10b (May 19, 2014) R0.10b (May 19, 2014)
Fixed a hard error in the disk I/O layer can collapse the directory entry. Fixed a hard error in the disk I/O layer can collapse the directory entry.
Fixed LFN entry is not deleted when delete/rename an object with lossy converted SFN. (appeared at R0.07) Fixed LFN entry is not deleted when delete/rename an object with lossy converted SFN. (appeared at R0.07)
R0.10c (November 09, 2014) R0.10c (November 09, 2014)
Added a configuration option for the platforms without RTC. (_FS_NORTC) Added a configuration option for the platforms without RTC. (_FS_NORTC)
Changed option name _USE_ERASE to _USE_TRIM. Changed option name _USE_ERASE to _USE_TRIM.
Fixed volume label created by Mac OS X cannot be retrieved with f_getlabel(). (appeared at R0.09b) Fixed volume label created by Mac OS X cannot be retrieved with f_getlabel(). (appeared at R0.09b)
Fixed a potential problem of FAT access that can appear on disk error. Fixed a potential problem of FAT access that can appear on disk error.
Fixed null pointer dereference on attempting to delete the root direcotry. (appeared at R0.08) Fixed null pointer dereference on attempting to delete the root direcotry. (appeared at R0.08)
R0.11 (February 09, 2015) R0.11 (February 09, 2015)
Added f_findfirst(), f_findnext() and f_findclose(). (_USE_FIND) Added f_findfirst(), f_findnext() and f_findclose(). (_USE_FIND)
Fixed f_unlink() does not remove cluster chain of the file. (appeared at R0.10c) Fixed f_unlink() does not remove cluster chain of the file. (appeared at R0.10c)
Fixed _FS_NORTC option does not work properly. (appeared at R0.10c) Fixed _FS_NORTC option does not work properly. (appeared at R0.10c)
R0.11a (September 05, 2015) R0.11a (September 05, 2015)
Fixed wrong media change can lead a deadlock at thread-safe configuration. Fixed wrong media change can lead a deadlock at thread-safe configuration.
Added code page 771, 860, 861, 863, 864, 865 and 869. (_CODE_PAGE) Added code page 771, 860, 861, 863, 864, 865 and 869. (_CODE_PAGE)
Removed some code pages actually not exist on the standard systems. (_CODE_PAGE) Removed some code pages actually not exist on the standard systems. (_CODE_PAGE)
Fixed errors in the case conversion teble of code page 437 and 850 (ff.c). Fixed errors in the case conversion teble of code page 437 and 850 (ff.c).
Fixed errors in the case conversion teble of Unicode (cc*.c). Fixed errors in the case conversion teble of Unicode (cc*.c).
R0.12 (April 12, 2016) R0.12 (April 12, 2016)
Added support for exFAT file system. (_FS_EXFAT) Added support for exFAT file system. (_FS_EXFAT)
Added f_expand(). (_USE_EXPAND) Added f_expand(). (_USE_EXPAND)
Changed some members in FINFO structure and behavior of f_readdir(). Changed some members in FINFO structure and behavior of f_readdir().
Added an option _USE_CHMOD. Added an option _USE_CHMOD.
Removed an option _WORD_ACCESS. Removed an option _WORD_ACCESS.
Fixed errors in the case conversion table of Unicode (cc*.c). Fixed errors in the case conversion table of Unicode (cc*.c).
R0.12a (July 10, 2016) R0.12a (July 10, 2016)
Added support for creating exFAT volume with some changes of f_mkfs(). Added support for creating exFAT volume with some changes of f_mkfs().
Added a file open method FA_OPEN_APPEND. An f_lseek() following f_open() is no longer needed. Added a file open method FA_OPEN_APPEND. An f_lseek() following f_open() is no longer needed.
f_forward() is available regardless of _FS_TINY. f_forward() is available regardless of _FS_TINY.
Fixed f_mkfs() creates wrong volume. (appeared at R0.12) Fixed f_mkfs() creates wrong volume. (appeared at R0.12)
Fixed wrong memory read in create_name(). (appeared at R0.12) Fixed wrong memory read in create_name(). (appeared at R0.12)
Fixed compilation fails at some configurations, _USE_FASTSEEK and _USE_FORWARD. Fixed compilation fails at some configurations, _USE_FASTSEEK and _USE_FORWARD.
R0.12b (September 04, 2016) R0.12b (September 04, 2016)
Made f_rename() be able to rename objects with the same name but case. Made f_rename() be able to rename objects with the same name but case.
Fixed an error in the case conversion teble of code page 866. (ff.c) Fixed an error in the case conversion teble of code page 866. (ff.c)
Fixed writing data is truncated at the file offset 4GiB on the exFAT volume. (appeared at R0.12) Fixed writing data is truncated at the file offset 4GiB on the exFAT volume. (appeared at R0.12)
Fixed creating a file in the root directory of exFAT volume can fail. (appeared at R0.12) Fixed creating a file in the root directory of exFAT volume can fail. (appeared at R0.12)
Fixed f_mkfs() creating exFAT volume with too small cluster size can collapse unallocated memory. (appeared at R0.12) Fixed f_mkfs() creating exFAT volume with too small cluster size can collapse unallocated memory. (appeared at R0.12)
Fixed wrong object name can be returned when read directory at Unicode cfg. (appeared at R0.12) Fixed wrong object name can be returned when read directory at Unicode cfg. (appeared at R0.12)
Fixed large file allocation/removing on the exFAT volume collapses allocation bitmap. (appeared at R0.12) Fixed large file allocation/removing on the exFAT volume collapses allocation bitmap. (appeared at R0.12)
Fixed some internal errors in f_expand() and f_lseek(). (appeared at R0.12) Fixed some internal errors in f_expand() and f_lseek(). (appeared at R0.12)
R0.12c (March 04, 2017) R0.12c (March 04, 2017)
Improved write throughput at the fragmented file on the exFAT volume. Improved write throughput at the fragmented file on the exFAT volume.
Made memory usage for exFAT be able to be reduced as decreasing _MAX_LFN. Made memory usage for exFAT be able to be reduced as decreasing _MAX_LFN.
Fixed successive f_getfree() can return wrong count on the FAT12/16 volume. (appeared at R0.12) Fixed successive f_getfree() can return wrong count on the FAT12/16 volume. (appeared at R0.12)
Fixed configuration option _VOLUMES cannot be set 10. (appeared at R0.10c) Fixed configuration option _VOLUMES cannot be set 10. (appeared at R0.10c)
R0.13 (May 21, 2017) R0.13 (May 21, 2017)
Changed heading character of configuration keywords "_" to "FF_". Changed heading character of configuration keywords "_" to "FF_".
Removed ASCII-only configuration, FF_CODE_PAGE = 1. Use FF_CODE_PAGE = 437 instead. Removed ASCII-only configuration, FF_CODE_PAGE = 1. Use FF_CODE_PAGE = 437 instead.
Added f_setcp(), run-time code page configuration. (FF_CODE_PAGE = 0) Added f_setcp(), run-time code page configuration. (FF_CODE_PAGE = 0)
Improved cluster allocation time on stretch a deep buried cluster chain. Improved cluster allocation time on stretch a deep buried cluster chain.
Improved processing time of f_mkdir() with large cluster size by using FF_USE_LFN = 3. Improved processing time of f_mkdir() with large cluster size by using FF_USE_LFN = 3.
Improved NoFatChain flag of the fragmented file to be set after it is truncated and got contiguous. Improved NoFatChain flag of the fragmented file to be set after it is truncated and got contiguous.
Fixed archive attribute is left not set when a file on the exFAT volume is renamed. (appeared at R0.12) Fixed archive attribute is left not set when a file on the exFAT volume is renamed. (appeared at R0.12)
Fixed exFAT FAT entry can be collapsed when write or lseek operation to the existing file is done. (appeared at R0.12c) Fixed exFAT FAT entry can be collapsed when write or lseek operation to the existing file is done. (appeared at R0.12c)
Fixed creating a file can fail when a new cluster allocation to the exFAT directory occures. (appeared at R0.12c) Fixed creating a file can fail when a new cluster allocation to the exFAT directory occures. (appeared at R0.12c)
R0.13a (October 14, 2017) R0.13a (October 14, 2017)
Added support for UTF-8 encoding on the API. (FF_LFN_UNICODE = 2) Added support for UTF-8 encoding on the API. (FF_LFN_UNICODE = 2)
Added options for file name output buffer. (FF_LFN_BUF, FF_SFN_BUF). Added options for file name output buffer. (FF_LFN_BUF, FF_SFN_BUF).
Added dynamic memory allocation option for working buffer of f_mkfs() and f_fdisk(). Added dynamic memory allocation option for working buffer of f_mkfs() and f_fdisk().
Fixed f_fdisk() and f_mkfs() create the partition table with wrong CHS parameters. (appeared at R0.09) Fixed f_fdisk() and f_mkfs() create the partition table with wrong CHS parameters. (appeared at R0.09)
Fixed f_unlink() can cause lost clusters at fragmented file on the exFAT volume. (appeared at R0.12c) Fixed f_unlink() can cause lost clusters at fragmented file on the exFAT volume. (appeared at R0.12c)
Fixed f_setlabel() rejects some valid characters for exFAT volume. (appeared at R0.12) Fixed f_setlabel() rejects some valid characters for exFAT volume. (appeared at R0.12)
R0.13b (April 07, 2018) R0.13b (April 07, 2018)
Added support for UTF-32 encoding on the API. (FF_LFN_UNICODE = 3) Added support for UTF-32 encoding on the API. (FF_LFN_UNICODE = 3)
Added support for Unix style volume ID. (FF_STR_VOLUME_ID = 2) Added support for Unix style volume ID. (FF_STR_VOLUME_ID = 2)
Fixed accesing any object on the exFAT root directory beyond the cluster boundary can fail. (appeared at R0.12c) Fixed accesing any object on the exFAT root directory beyond the cluster boundary can fail. (appeared at R0.12c)
Fixed f_setlabel() does not reject some invalid characters. (appeared at R0.09b) Fixed f_setlabel() does not reject some invalid characters. (appeared at R0.09b)
R0.13c (October 14, 2018)
Supported stdint.h for C99 and later. (integer.h was included in ff.h)
Fixed reading a directory gets infinite loop when the last directory entry is not empty. (appeared at R0.12)
Fixed creating a sub-directory in the fragmented sub-directory on the exFAT volume collapses FAT chain of the parent directory. (appeared at R0.12)
Fixed f_getcwd() cause output buffer overrun when the buffer has a valid drive number. (appeared at R0.13b)

View File

@ -1,22 +1,21 @@
FatFs Module Source Files R0.13b FatFs Module Source Files R0.13c
FILES FILES
00readme.txt This file. 00readme.txt This file.
00history.txt Revision history. 00history.txt Revision history.
ff.c FatFs module. ff.c FatFs module.
ffconf.h Configuration file of FatFs module. ffconf.h Configuration file of FatFs module.
ff.h Common include file for FatFs and application module. ff.h Common include file for FatFs and application module.
diskio.h Common include file for FatFs and disk I/O module. diskio.h Common include file for FatFs and disk I/O module.
diskio.c An example of glue function to attach existing disk I/O module to FatFs. diskio.c An example of glue function to attach existing disk I/O module to FatFs.
integer.h Integer type definitions for FatFs. ffunicode.c Optional Unicode utility functions.
ffunicode.c Optional Unicode utility functions. ffsystem.c An example of optional O/S related functions.
ffsystem.c An example of optional O/S related functions.
Low level disk I/O module is not included in this archive because the FatFs
Low level disk I/O module is not included in this archive because the FatFs module is only a generic file system layer and it does not depend on any specific
module is only a generic file system layer and it does not depend on any specific storage device. You need to provide a low level disk I/O module written to
storage device. You need to provide a low level disk I/O module written to control the storage device that attached to the target system.
control the storage device that attached to the target system.

View File

@ -1,95 +1,100 @@
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* Low level disk I/O module skeleton for FatFs (C)ChaN, 2016 */ /* Low level disk I/O module skeleton for FatFs (C)ChaN, 2016 */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* If a working storage control module is available, it should be */ /* If a working storage control module is available, it should be */
/* attached to the FatFs via a glue function rather than modifying it. */ /* attached to the FatFs via a glue function rather than modifying it. */
/* This is an example of glue functions to attach various exsisting */ /* This is an example of glue functions to attach various exsisting */
/* storage control modules to the FatFs module with a defined API. */ /* storage control modules to the FatFs module with a defined API. */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
#include <stdbool.h> #include <stdbool.h>
#include <string.h> #include <string.h>
#include "diskio.h" /* FatFs lower layer API */ #include "ff.h" /* Obtains integer types */
#include "../../fs_utils.h" #include "diskio.h" /* Declarations of disk functions */
#include "../../fs_utils.h"
/*-----------------------------------------------------------------------*/
/* Get Drive Status */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* Get Drive Status */
DSTATUS disk_status ( /*-----------------------------------------------------------------------*/
BYTE pdrv /* Physical drive nmuber to identify the drive */
) DSTATUS disk_status (
{ BYTE pdrv /* Physical drive nmuber to identify the drive */
return 0; )
} {
return 0;
}
/*-----------------------------------------------------------------------*/
/* Inidialize a Drive */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* Inidialize a Drive */
DSTATUS disk_initialize ( /*-----------------------------------------------------------------------*/
BYTE pdrv /* Physical drive nmuber to identify the drive */
) DSTATUS disk_initialize (
{ BYTE pdrv /* Physical drive nmuber to identify the drive */
return 0; )
} {
return 0;
}
/*-----------------------------------------------------------------------*/
/* Read Sector(s) */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* Read Sector(s) */
DRESULT disk_read ( /*-----------------------------------------------------------------------*/
BYTE pdrv, /* Physical drive nmuber to identify the drive */
BYTE *buff, /* Data buffer to store read data */ DRESULT disk_read (
DWORD sector, /* Start sector in LBA */ BYTE pdrv, /* Physical drive nmuber to identify the drive */
UINT count /* Number of sectors to read */ BYTE *buff, /* Data buffer to store read data */
) DWORD sector, /* Start sector in LBA */
{ UINT count /* Number of sectors to read */
switch (pdrv) { )
case 0: {
return sdmmc_device_read(&g_sd_device, sector, count, (void *)buff) ? RES_OK : RES_ERROR; switch (pdrv) {
default: case 0:
return RES_PARERR; return sdmmc_device_read(&g_sd_device, sector, count, (void *)buff) ? RES_OK : RES_ERROR;
} default:
} return RES_PARERR;
}
}
/*-----------------------------------------------------------------------*/
/* Write Sector(s) */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* Write Sector(s) */
DRESULT disk_write ( /*-----------------------------------------------------------------------*/
BYTE pdrv, /* Physical drive nmuber to identify the drive */
const BYTE *buff, /* Data to be written */ #if FF_FS_READONLY == 0
DWORD sector, /* Start sector in LBA */
UINT count /* Number of sectors to write */ DRESULT disk_write (
) BYTE pdrv, /* Physical drive nmuber to identify the drive */
{ const BYTE *buff, /* Data to be written */
switch (pdrv) { DWORD sector, /* Start sector in LBA */
case 0: UINT count /* Number of sectors to write */
return sdmmc_device_write(&g_sd_device, sector, count, (void *)buff) ? RES_OK : RES_ERROR; )
default: {
return RES_PARERR; switch (pdrv) {
} case 0:
} return sdmmc_device_write(&g_sd_device, sector, count, (void *)buff) ? RES_OK : RES_ERROR;
default:
return RES_PARERR;
}
/*-----------------------------------------------------------------------*/ }
/* Miscellaneous Functions */
/*-----------------------------------------------------------------------*/ #endif
DRESULT disk_ioctl (
BYTE pdrv, /* Physical drive nmuber (0..) */ /*-----------------------------------------------------------------------*/
BYTE cmd, /* Control code */ /* Miscellaneous Functions */
void *buff /* Buffer to send/receive control data */ /*-----------------------------------------------------------------------*/
)
{ DRESULT disk_ioctl (
return RES_OK; BYTE pdrv, /* Physical drive nmuber (0..) */
} BYTE cmd, /* Control code */
void *buff /* Buffer to send/receive control data */
)
{
return RES_OK;
}

View File

@ -1,80 +1,77 @@
/*-----------------------------------------------------------------------/ /*-----------------------------------------------------------------------/
/ Low level disk interface modlue include file (C)ChaN, 2014 / / Low level disk interface modlue include file (C)ChaN, 2014 /
/-----------------------------------------------------------------------*/ /-----------------------------------------------------------------------*/
#ifndef _DISKIO_DEFINED #ifndef _DISKIO_DEFINED
#define _DISKIO_DEFINED #define _DISKIO_DEFINED
#ifdef __cplusplus #ifdef __cplusplus
extern "C" { extern "C" {
#endif #endif
#include "integer.h" /* Status of Disk Functions */
typedef BYTE DSTATUS;
/* Status of Disk Functions */ /* Results of Disk Functions */
typedef BYTE DSTATUS; typedef enum {
RES_OK = 0, /* 0: Successful */
/* Results of Disk Functions */ RES_ERROR, /* 1: R/W Error */
typedef enum { RES_WRPRT, /* 2: Write Protected */
RES_OK = 0, /* 0: Successful */ RES_NOTRDY, /* 3: Not Ready */
RES_ERROR, /* 1: R/W Error */ RES_PARERR /* 4: Invalid Parameter */
RES_WRPRT, /* 2: Write Protected */ } DRESULT;
RES_NOTRDY, /* 3: Not Ready */
RES_PARERR /* 4: Invalid Parameter */
} DRESULT; /*---------------------------------------*/
/* Prototypes for disk control functions */
/*---------------------------------------*/
/* Prototypes for disk control functions */ DSTATUS disk_initialize (BYTE pdrv);
DSTATUS disk_status (BYTE pdrv);
DRESULT disk_read (BYTE pdrv, BYTE* buff, DWORD sector, UINT count);
DSTATUS disk_initialize (BYTE pdrv); DRESULT disk_write (BYTE pdrv, const BYTE* buff, DWORD sector, UINT count);
DSTATUS disk_status (BYTE pdrv); DRESULT disk_ioctl (BYTE pdrv, BYTE cmd, void* buff);
DRESULT disk_read (BYTE pdrv, BYTE* buff, DWORD sector, UINT count);
DRESULT disk_write (BYTE pdrv, const BYTE* buff, DWORD sector, UINT count);
DRESULT disk_ioctl (BYTE pdrv, BYTE cmd, void* buff); /* Disk Status Bits (DSTATUS) */
#define STA_NOINIT 0x01 /* Drive not initialized */
/* Disk Status Bits (DSTATUS) */ #define STA_NODISK 0x02 /* No medium in the drive */
#define STA_PROTECT 0x04 /* Write protected */
#define STA_NOINIT 0x01 /* Drive not initialized */
#define STA_NODISK 0x02 /* No medium in the drive */
#define STA_PROTECT 0x04 /* Write protected */ /* Command code for disk_ioctrl fucntion */
/* Generic command (Used by FatFs) */
/* Command code for disk_ioctrl fucntion */ #define CTRL_SYNC 0 /* Complete pending write process (needed at FF_FS_READONLY == 0) */
#define GET_SECTOR_COUNT 1 /* Get media size (needed at FF_USE_MKFS == 1) */
/* Generic command (Used by FatFs) */ #define GET_SECTOR_SIZE 2 /* Get sector size (needed at FF_MAX_SS != FF_MIN_SS) */
#define CTRL_SYNC 0 /* Complete pending write process (needed at FF_FS_READONLY == 0) */ #define GET_BLOCK_SIZE 3 /* Get erase block size (needed at FF_USE_MKFS == 1) */
#define GET_SECTOR_COUNT 1 /* Get media size (needed at FF_USE_MKFS == 1) */ #define CTRL_TRIM 4 /* Inform device that the data on the block of sectors is no longer used (needed at FF_USE_TRIM == 1) */
#define GET_SECTOR_SIZE 2 /* Get sector size (needed at FF_MAX_SS != FF_MIN_SS) */
#define GET_BLOCK_SIZE 3 /* Get erase block size (needed at FF_USE_MKFS == 1) */ /* Generic command (Not used by FatFs) */
#define CTRL_TRIM 4 /* Inform device that the data on the block of sectors is no longer used (needed at FF_USE_TRIM == 1) */ #define CTRL_POWER 5 /* Get/Set power status */
#define CTRL_LOCK 6 /* Lock/Unlock media removal */
/* Generic command (Not used by FatFs) */ #define CTRL_EJECT 7 /* Eject media */
#define CTRL_POWER 5 /* Get/Set power status */ #define CTRL_FORMAT 8 /* Create physical format on the media */
#define CTRL_LOCK 6 /* Lock/Unlock media removal */
#define CTRL_EJECT 7 /* Eject media */ /* MMC/SDC specific ioctl command */
#define CTRL_FORMAT 8 /* Create physical format on the media */ #define MMC_GET_TYPE 10 /* Get card type */
#define MMC_GET_CSD 11 /* Get CSD */
/* MMC/SDC specific ioctl command */ #define MMC_GET_CID 12 /* Get CID */
#define MMC_GET_TYPE 10 /* Get card type */ #define MMC_GET_OCR 13 /* Get OCR */
#define MMC_GET_CSD 11 /* Get CSD */ #define MMC_GET_SDSTAT 14 /* Get SD status */
#define MMC_GET_CID 12 /* Get CID */ #define ISDIO_READ 55 /* Read data form SD iSDIO register */
#define MMC_GET_OCR 13 /* Get OCR */ #define ISDIO_WRITE 56 /* Write data to SD iSDIO register */
#define MMC_GET_SDSTAT 14 /* Get SD status */ #define ISDIO_MRITE 57 /* Masked write data to SD iSDIO register */
#define ISDIO_READ 55 /* Read data form SD iSDIO register */
#define ISDIO_WRITE 56 /* Write data to SD iSDIO register */ /* ATA/CF specific ioctl command */
#define ISDIO_MRITE 57 /* Masked write data to SD iSDIO register */ #define ATA_GET_REV 20 /* Get F/W revision */
#define ATA_GET_MODEL 21 /* Get model name */
/* ATA/CF specific ioctl command */ #define ATA_GET_SN 22 /* Get serial number */
#define ATA_GET_REV 20 /* Get F/W revision */
#define ATA_GET_MODEL 21 /* Get model name */ #ifdef __cplusplus
#define ATA_GET_SN 22 /* Get serial number */ }
#endif
#ifdef __cplusplus
} #endif
#endif
#endif

File diff suppressed because it is too large Load Diff

View File

@ -1,376 +1,405 @@
/*----------------------------------------------------------------------------/ /*----------------------------------------------------------------------------/
/ FatFs - Generic FAT Filesystem module R0.13b / / FatFs - Generic FAT Filesystem module R0.13c /
/-----------------------------------------------------------------------------/ /-----------------------------------------------------------------------------/
/ /
/ Copyright (C) 2018, ChaN, all right reserved. / Copyright (C) 2018, ChaN, all right reserved.
/ /
/ FatFs module is an open source software. Redistribution and use of FatFs in / FatFs module is an open source software. Redistribution and use of FatFs in
/ source and binary forms, with or without modification, are permitted provided / source and binary forms, with or without modification, are permitted provided
/ that the following condition is met: / that the following condition is met:
/ 1. Redistributions of source code must retain the above copyright notice, / 1. Redistributions of source code must retain the above copyright notice,
/ this condition and the following disclaimer. / this condition and the following disclaimer.
/ /
/ This software is provided by the copyright holder and contributors "AS IS" / This software is provided by the copyright holder and contributors "AS IS"
/ and any warranties related to this software are DISCLAIMED. / and any warranties related to this software are DISCLAIMED.
/ The copyright owner or contributors be NOT LIABLE for any damages caused / The copyright owner or contributors be NOT LIABLE for any damages caused
/ by use of this software. / by use of this software.
/ /
/----------------------------------------------------------------------------*/ /----------------------------------------------------------------------------*/
#ifndef FF_DEFINED #ifndef FF_DEFINED
#define FF_DEFINED 63463 /* Revision ID */ #define FF_DEFINED 86604 /* Revision ID */
#ifdef __cplusplus #ifdef __cplusplus
extern "C" { extern "C" {
#endif #endif
#include "integer.h" /* Basic integer types */ #include "ffconf.h" /* FatFs configuration options */
#include "ffconf.h" /* FatFs configuration options */
#if FF_DEFINED != FFCONF_DEF
#if FF_DEFINED != FFCONF_DEF #error Wrong configuration file (ffconf.h).
#error Wrong configuration file (ffconf.h). #endif
#endif
/* Integer types used for FatFs API */
/* Definitions of volume management */ #if defined(_WIN32) /* Main development platform */
#define FF_INTDEF 2
#if FF_MULTI_PARTITION /* Multiple partition configuration */ #include <windows.h>
typedef struct { typedef unsigned __int64 QWORD;
BYTE pd; /* Physical drive number */ #elif (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || defined(__cplusplus) /* C99 or later */
BYTE pt; /* Partition: 0:Auto detect, 1-4:Forced partition) */ #define FF_INTDEF 2
} PARTITION; #include <stdint.h>
extern PARTITION VolToPart[]; /* Volume - Partition resolution table */ typedef unsigned int UINT; /* int must be 16-bit or 32-bit */
#endif typedef unsigned char BYTE; /* char must be 8-bit */
typedef uint16_t WORD; /* 16-bit unsigned integer */
#if FF_STR_VOLUME_ID typedef uint16_t WCHAR; /* 16-bit unsigned integer */
#ifndef FF_VOLUME_STRS typedef uint32_t DWORD; /* 32-bit unsigned integer */
extern const char* VolumeStr[FF_VOLUMES]; /* User defied volume ID */ typedef uint64_t QWORD; /* 64-bit unsigned integer */
#endif #else /* Earlier than C99 */
#endif #define FF_INTDEF 1
typedef unsigned int UINT; /* int must be 16-bit or 32-bit */
typedef unsigned char BYTE; /* char must be 8-bit */
typedef unsigned short WORD; /* 16-bit unsigned integer */
/* Type of path name strings on FatFs API */ typedef unsigned short WCHAR; /* 16-bit unsigned integer */
typedef unsigned long DWORD; /* 32-bit unsigned integer */
#ifndef _INC_TCHAR #endif
#define _INC_TCHAR
#if FF_USE_LFN && FF_LFN_UNICODE == 1 /* Unicode in UTF-16 encoding */ /* Definitions of volume management */
typedef WCHAR TCHAR;
#define _T(x) L ## x #if FF_MULTI_PARTITION /* Multiple partition configuration */
#define _TEXT(x) L ## x typedef struct {
#elif FF_USE_LFN && FF_LFN_UNICODE == 2 /* Unicode in UTF-8 encoding */ BYTE pd; /* Physical drive number */
typedef char TCHAR; BYTE pt; /* Partition: 0:Auto detect, 1-4:Forced partition) */
#define _T(x) u8 ## x } PARTITION;
#define _TEXT(x) u8 ## x extern PARTITION VolToPart[]; /* Volume - Partition resolution table */
#elif FF_USE_LFN && FF_LFN_UNICODE == 3 /* Unicode in UTF-32 encoding */ #endif
typedef DWORD TCHAR;
#define _T(x) U ## x #if FF_STR_VOLUME_ID
#define _TEXT(x) U ## x #ifndef FF_VOLUME_STRS
#elif FF_USE_LFN && (FF_LFN_UNICODE < 0 || FF_LFN_UNICODE > 3) extern const char* VolumeStr[FF_VOLUMES]; /* User defied volume ID */
#error Wrong FF_LFN_UNICODE setting #endif
#else /* ANSI/OEM code in SBCS/DBCS */ #endif
typedef char TCHAR;
#define _T(x) x
#define _TEXT(x) x
#endif /* Type of path name strings on FatFs API */
#endif #ifndef _INC_TCHAR
#define _INC_TCHAR
#if FF_USE_LFN && FF_LFN_UNICODE == 1 /* Unicode in UTF-16 encoding */
/* Type of file size variables */ typedef WCHAR TCHAR;
#define _T(x) L ## x
#if FF_FS_EXFAT #define _TEXT(x) L ## x
typedef QWORD FSIZE_t; #elif FF_USE_LFN && FF_LFN_UNICODE == 2 /* Unicode in UTF-8 encoding */
#else typedef char TCHAR;
typedef DWORD FSIZE_t; #define _T(x) u8 ## x
#endif #define _TEXT(x) u8 ## x
#elif FF_USE_LFN && FF_LFN_UNICODE == 3 /* Unicode in UTF-32 encoding */
typedef DWORD TCHAR;
#define _T(x) U ## x
/* Filesystem object structure (FATFS) */ #define _TEXT(x) U ## x
#elif FF_USE_LFN && (FF_LFN_UNICODE < 0 || FF_LFN_UNICODE > 3)
typedef struct { #error Wrong FF_LFN_UNICODE setting
BYTE fs_type; /* Filesystem type (0:N/A) */ #else /* ANSI/OEM code in SBCS/DBCS */
BYTE pdrv; /* Physical drive number */ typedef char TCHAR;
BYTE n_fats; /* Number of FATs (1 or 2) */ #define _T(x) x
BYTE wflag; /* win[] flag (b0:dirty) */ #define _TEXT(x) x
BYTE fsi_flag; /* FSINFO flags (b7:disabled, b0:dirty) */ #endif
WORD id; /* Volume mount ID */
WORD n_rootdir; /* Number of root directory entries (FAT12/16) */ #endif
WORD csize; /* Cluster size [sectors] */
#if FF_MAX_SS != FF_MIN_SS
WORD ssize; /* Sector size (512, 1024, 2048 or 4096) */
#endif /* Type of file size variables */
#if FF_USE_LFN
WCHAR* lfnbuf; /* LFN working buffer */ #if FF_FS_EXFAT
#endif #if FF_INTDEF != 2
#if FF_FS_EXFAT #error exFAT feature wants C99 or later
BYTE* dirbuf; /* Directory entry block scratchpad buffer for exFAT */ #endif
#endif typedef QWORD FSIZE_t;
#if FF_FS_REENTRANT #else
FF_SYNC_t sobj; /* Identifier of sync object */ typedef DWORD FSIZE_t;
#endif #endif
#if !FF_FS_READONLY
DWORD last_clst; /* Last allocated cluster */
DWORD free_clst; /* Number of free clusters */
#endif /* Filesystem object structure (FATFS) */
#if FF_FS_RPATH
DWORD cdir; /* Current directory start cluster (0:root) */ typedef struct {
#if FF_FS_EXFAT BYTE fs_type; /* Filesystem type (0:not mounted) */
DWORD cdc_scl; /* Containing directory start cluster (invalid when cdir is 0) */ BYTE pdrv; /* Associated physical drive */
DWORD cdc_size; /* b31-b8:Size of containing directory, b7-b0: Chain status */ BYTE n_fats; /* Number of FATs (1 or 2) */
DWORD cdc_ofs; /* Offset in the containing directory (invalid when cdir is 0) */ BYTE wflag; /* win[] flag (b0:dirty) */
#endif BYTE fsi_flag; /* FSINFO flags (b7:disabled, b0:dirty) */
#endif WORD id; /* Volume mount ID */
DWORD n_fatent; /* Number of FAT entries (number of clusters + 2) */ WORD n_rootdir; /* Number of root directory entries (FAT12/16) */
DWORD fsize; /* Size of an FAT [sectors] */ WORD csize; /* Cluster size [sectors] */
DWORD volbase; /* Volume base sector */ #if FF_MAX_SS != FF_MIN_SS
DWORD fatbase; /* FAT base sector */ WORD ssize; /* Sector size (512, 1024, 2048 or 4096) */
DWORD dirbase; /* Root directory base sector/cluster */ #endif
DWORD database; /* Data base sector */ #if FF_USE_LFN
DWORD winsect; /* Current sector appearing in the win[] */ WCHAR* lfnbuf; /* LFN working buffer */
BYTE win[FF_MAX_SS]; /* Disk access window for Directory, FAT (and file data at tiny cfg) */ #endif
} FATFS; #if FF_FS_EXFAT
BYTE* dirbuf; /* Directory entry block scratchpad buffer for exFAT */
#endif
#if FF_FS_REENTRANT
/* Object ID and allocation information (FFOBJID) */ FF_SYNC_t sobj; /* Identifier of sync object */
#endif
typedef struct { #if !FF_FS_READONLY
FATFS* fs; /* Pointer to the hosting volume of this object */ DWORD last_clst; /* Last allocated cluster */
WORD id; /* Hosting volume mount ID */ DWORD free_clst; /* Number of free clusters */
BYTE attr; /* Object attribute */ #endif
BYTE stat; /* Object chain status (b1-0: =0:not contiguous, =2:contiguous, =3:flagmented in this session, b2:sub-directory stretched) */ #if FF_FS_RPATH
DWORD sclust; /* Object data start cluster (0:no cluster or root directory) */ DWORD cdir; /* Current directory start cluster (0:root) */
FSIZE_t objsize; /* Object size (valid when sclust != 0) */ #if FF_FS_EXFAT
#if FF_FS_EXFAT DWORD cdc_scl; /* Containing directory start cluster (invalid when cdir is 0) */
DWORD n_cont; /* Size of first fragment - 1 (valid when stat == 3) */ DWORD cdc_size; /* b31-b8:Size of containing directory, b7-b0: Chain status */
DWORD n_frag; /* Size of last fragment needs to be written to FAT (valid when not zero) */ DWORD cdc_ofs; /* Offset in the containing directory (invalid when cdir is 0) */
DWORD c_scl; /* Containing directory start cluster (valid when sclust != 0) */ #endif
DWORD c_size; /* b31-b8:Size of containing directory, b7-b0: Chain status (valid when c_scl != 0) */ #endif
DWORD c_ofs; /* Offset in the containing directory (valid when file object and sclust != 0) */ DWORD n_fatent; /* Number of FAT entries (number of clusters + 2) */
#endif DWORD fsize; /* Size of an FAT [sectors] */
#if FF_FS_LOCK DWORD volbase; /* Volume base sector */
UINT lockid; /* File lock ID origin from 1 (index of file semaphore table Files[]) */ DWORD fatbase; /* FAT base sector */
#endif DWORD dirbase; /* Root directory base sector/cluster */
} FFOBJID; DWORD database; /* Data base sector */
#if FF_FS_EXFAT
DWORD bitbase; /* Allocation bitmap base sector */
#endif
/* File object structure (FIL) */ DWORD winsect; /* Current sector appearing in the win[] */
BYTE win[FF_MAX_SS]; /* Disk access window for Directory, FAT (and file data at tiny cfg) */
typedef struct { } FATFS;
FFOBJID obj; /* Object identifier (must be the 1st member to detect invalid object pointer) */
BYTE flag; /* File status flags */
BYTE err; /* Abort flag (error code) */
FSIZE_t fptr; /* File read/write pointer (Zeroed on file open) */ /* Object ID and allocation information (FFOBJID) */
DWORD clust; /* Current cluster of fpter (invalid when fptr is 0) */
DWORD sect; /* Sector number appearing in buf[] (0:invalid) */ typedef struct {
#if !FF_FS_READONLY FATFS* fs; /* Pointer to the hosting volume of this object */
DWORD dir_sect; /* Sector number containing the directory entry (not used at exFAT) */ WORD id; /* Hosting volume mount ID */
BYTE* dir_ptr; /* Pointer to the directory entry in the win[] (not used at exFAT) */ BYTE attr; /* Object attribute */
#endif BYTE stat; /* Object chain status (b1-0: =0:not contiguous, =2:contiguous, =3:fragmented in this session, b2:sub-directory stretched) */
#if FF_USE_FASTSEEK DWORD sclust; /* Object data start cluster (0:no cluster or root directory) */
DWORD* cltbl; /* Pointer to the cluster link map table (nulled on open, set by application) */ FSIZE_t objsize; /* Object size (valid when sclust != 0) */
#endif #if FF_FS_EXFAT
#if !FF_FS_TINY DWORD n_cont; /* Size of first fragment - 1 (valid when stat == 3) */
BYTE buf[FF_MAX_SS]; /* File private data read/write window */ DWORD n_frag; /* Size of last fragment needs to be written to FAT (valid when not zero) */
#endif DWORD c_scl; /* Containing directory start cluster (valid when sclust != 0) */
} FIL; DWORD c_size; /* b31-b8:Size of containing directory, b7-b0: Chain status (valid when c_scl != 0) */
DWORD c_ofs; /* Offset in the containing directory (valid when file object and sclust != 0) */
#endif
#if FF_FS_LOCK
/* Directory object structure (DIR) */ UINT lockid; /* File lock ID origin from 1 (index of file semaphore table Files[]) */
#endif
typedef struct { } FFOBJID;
FFOBJID obj; /* Object identifier */
DWORD dptr; /* Current read/write offset */
DWORD clust; /* Current cluster */
DWORD sect; /* Current sector (0:Read operation has terminated) */ /* File object structure (FIL) */
BYTE* dir; /* Pointer to the directory item in the win[] */
BYTE fn[12]; /* SFN (in/out) {body[8],ext[3],status[1]} */ typedef struct {
#if FF_USE_LFN FFOBJID obj; /* Object identifier (must be the 1st member to detect invalid object pointer) */
DWORD blk_ofs; /* Offset of current entry block being processed (0xFFFFFFFF:Invalid) */ BYTE flag; /* File status flags */
#endif BYTE err; /* Abort flag (error code) */
#if FF_USE_FIND FSIZE_t fptr; /* File read/write pointer (Zeroed on file open) */
const TCHAR* pat; /* Pointer to the name matching pattern */ DWORD clust; /* Current cluster of fpter (invalid when fptr is 0) */
#endif DWORD sect; /* Sector number appearing in buf[] (0:invalid) */
} DIR; #if !FF_FS_READONLY
DWORD dir_sect; /* Sector number containing the directory entry (not used at exFAT) */
BYTE* dir_ptr; /* Pointer to the directory entry in the win[] (not used at exFAT) */
#endif
/* File information structure (FILINFO) */ #if FF_USE_FASTSEEK
DWORD* cltbl; /* Pointer to the cluster link map table (nulled on open, set by application) */
typedef struct { #endif
FSIZE_t fsize; /* File size */ #if !FF_FS_TINY
WORD fdate; /* Modified date */ BYTE buf[FF_MAX_SS]; /* File private data read/write window */
WORD ftime; /* Modified time */ #endif
BYTE fattrib; /* File attribute */ } FIL;
#if FF_USE_LFN
TCHAR altname[FF_SFN_BUF + 1];/* Altenative file name */
TCHAR fname[FF_LFN_BUF + 1]; /* Primary file name */
#else /* Directory object structure (DIR) */
TCHAR fname[12 + 1]; /* File name */
#endif typedef struct {
} FILINFO; FFOBJID obj; /* Object identifier */
DWORD dptr; /* Current read/write offset */
DWORD clust; /* Current cluster */
DWORD sect; /* Current sector (0:Read operation has terminated) */
/* File function return code (FRESULT) */ BYTE* dir; /* Pointer to the directory item in the win[] */
BYTE fn[12]; /* SFN (in/out) {body[8],ext[3],status[1]} */
typedef enum { #if FF_USE_LFN
FR_OK = 0, /* (0) Succeeded */ DWORD blk_ofs; /* Offset of current entry block being processed (0xFFFFFFFF:Invalid) */
FR_DISK_ERR, /* (1) A hard error occurred in the low level disk I/O layer */ #endif
FR_INT_ERR, /* (2) Assertion failed */ #if FF_USE_FIND
FR_NOT_READY, /* (3) The physical drive cannot work */ const TCHAR* pat; /* Pointer to the name matching pattern */
FR_NO_FILE, /* (4) Could not find the file */ #endif
FR_NO_PATH, /* (5) Could not find the path */ } DIR;
FR_INVALID_NAME, /* (6) The path name format is invalid */
FR_DENIED, /* (7) Access denied due to prohibited access or directory full */
FR_EXIST, /* (8) Access denied due to prohibited access */
FR_INVALID_OBJECT, /* (9) The file/directory object is invalid */ /* File information structure (FILINFO) */
FR_WRITE_PROTECTED, /* (10) The physical drive is write protected */
FR_INVALID_DRIVE, /* (11) The logical drive number is invalid */ typedef struct {
FR_NOT_ENABLED, /* (12) The volume has no work area */ FSIZE_t fsize; /* File size */
FR_NO_FILESYSTEM, /* (13) There is no valid FAT volume */ WORD fdate; /* Modified date */
FR_MKFS_ABORTED, /* (14) The f_mkfs() aborted due to any problem */ WORD ftime; /* Modified time */
FR_TIMEOUT, /* (15) Could not get a grant to access the volume within defined period */ BYTE fattrib; /* File attribute */
FR_LOCKED, /* (16) The operation is rejected according to the file sharing policy */ #if FF_USE_LFN
FR_NOT_ENOUGH_CORE, /* (17) LFN working buffer could not be allocated */ TCHAR altname[FF_SFN_BUF + 1];/* Altenative file name */
FR_TOO_MANY_OPEN_FILES, /* (18) Number of open files > FF_FS_LOCK */ TCHAR fname[FF_LFN_BUF + 1]; /* Primary file name */
FR_INVALID_PARAMETER /* (19) Given parameter is invalid */ #else
} FRESULT; TCHAR fname[12 + 1]; /* File name */
#endif
} FILINFO;
/*--------------------------------------------------------------*/
/* FatFs module application interface */
/* File function return code (FRESULT) */
FRESULT f_open (FIL* fp, const TCHAR* path, BYTE mode); /* Open or create a file */
FRESULT f_close (FIL* fp); /* Close an open file object */ typedef enum {
FRESULT f_read (FIL* fp, void* buff, UINT btr, UINT* br); /* Read data from the file */ FR_OK = 0, /* (0) Succeeded */
FRESULT f_write (FIL* fp, const void* buff, UINT btw, UINT* bw); /* Write data to the file */ FR_DISK_ERR, /* (1) A hard error occurred in the low level disk I/O layer */
FRESULT f_lseek (FIL* fp, FSIZE_t ofs); /* Move file pointer of the file object */ FR_INT_ERR, /* (2) Assertion failed */
FRESULT f_truncate (FIL* fp); /* Truncate the file */ FR_NOT_READY, /* (3) The physical drive cannot work */
FRESULT f_sync (FIL* fp); /* Flush cached data of the writing file */ FR_NO_FILE, /* (4) Could not find the file */
FRESULT f_opendir (DIR* dp, const TCHAR* path); /* Open a directory */ FR_NO_PATH, /* (5) Could not find the path */
FRESULT f_closedir (DIR* dp); /* Close an open directory */ FR_INVALID_NAME, /* (6) The path name format is invalid */
FRESULT f_readdir (DIR* dp, FILINFO* fno); /* Read a directory item */ FR_DENIED, /* (7) Access denied due to prohibited access or directory full */
FRESULT f_findfirst (DIR* dp, FILINFO* fno, const TCHAR* path, const TCHAR* pattern); /* Find first file */ FR_EXIST, /* (8) Access denied due to prohibited access */
FRESULT f_findnext (DIR* dp, FILINFO* fno); /* Find next file */ FR_INVALID_OBJECT, /* (9) The file/directory object is invalid */
FRESULT f_mkdir (const TCHAR* path); /* Create a sub directory */ FR_WRITE_PROTECTED, /* (10) The physical drive is write protected */
FRESULT f_unlink (const TCHAR* path); /* Delete an existing file or directory */ FR_INVALID_DRIVE, /* (11) The logical drive number is invalid */
FRESULT f_rename (const TCHAR* path_old, const TCHAR* path_new); /* Rename/Move a file or directory */ FR_NOT_ENABLED, /* (12) The volume has no work area */
FRESULT f_stat (const TCHAR* path, FILINFO* fno); /* Get file status */ FR_NO_FILESYSTEM, /* (13) There is no valid FAT volume */
FRESULT f_chmod (const TCHAR* path, BYTE attr, BYTE mask); /* Change attribute of a file/dir */ FR_MKFS_ABORTED, /* (14) The f_mkfs() aborted due to any problem */
FRESULT f_utime (const TCHAR* path, const FILINFO* fno); /* Change timestamp of a file/dir */ FR_TIMEOUT, /* (15) Could not get a grant to access the volume within defined period */
FRESULT f_chdir (const TCHAR* path); /* Change current directory */ FR_LOCKED, /* (16) The operation is rejected according to the file sharing policy */
FRESULT f_chdrive (const TCHAR* path); /* Change current drive */ FR_NOT_ENOUGH_CORE, /* (17) LFN working buffer could not be allocated */
FRESULT f_getcwd (TCHAR* buff, UINT len); /* Get current directory */ FR_TOO_MANY_OPEN_FILES, /* (18) Number of open files > FF_FS_LOCK */
FRESULT f_getfree (const TCHAR* path, DWORD* nclst, FATFS** fatfs); /* Get number of free clusters on the drive */ FR_INVALID_PARAMETER /* (19) Given parameter is invalid */
FRESULT f_getlabel (const TCHAR* path, TCHAR* label, DWORD* vsn); /* Get volume label */ } FRESULT;
FRESULT f_setlabel (const TCHAR* label); /* Set volume label */
FRESULT f_forward (FIL* fp, UINT(*func)(const BYTE*,UINT), UINT btf, UINT* bf); /* Forward data to the stream */
FRESULT f_expand (FIL* fp, FSIZE_t szf, BYTE opt); /* Allocate a contiguous block to the file */
FRESULT f_mount (FATFS* fs, const TCHAR* path, BYTE opt); /* Mount/Unmount a logical drive */ /*--------------------------------------------------------------*/
FRESULT f_mkfs (const TCHAR* path, BYTE opt, DWORD au, void* work, UINT len); /* Create a FAT volume */ /* FatFs module application interface */
FRESULT f_fdisk (BYTE pdrv, const DWORD* szt, void* work); /* Divide a physical drive into some partitions */
FRESULT f_setcp (WORD cp); /* Set current code page */ FRESULT f_open (FIL* fp, const TCHAR* path, BYTE mode); /* Open or create a file */
int f_putc (TCHAR c, FIL* fp); /* Put a character to the file */ FRESULT f_close (FIL* fp); /* Close an open file object */
int f_puts (const TCHAR* str, FIL* cp); /* Put a string to the file */ FRESULT f_read (FIL* fp, void* buff, UINT btr, UINT* br); /* Read data from the file */
int f_printf (FIL* fp, const TCHAR* str, ...); /* Put a formatted string to the file */ FRESULT f_write (FIL* fp, const void* buff, UINT btw, UINT* bw); /* Write data to the file */
TCHAR* f_gets (TCHAR* buff, int len, FIL* fp); /* Get a string from the file */ FRESULT f_lseek (FIL* fp, FSIZE_t ofs); /* Move file pointer of the file object */
FRESULT f_truncate (FIL* fp); /* Truncate the file */
#define f_eof(fp) ((int)((fp)->fptr == (fp)->obj.objsize)) FRESULT f_sync (FIL* fp); /* Flush cached data of the writing file */
#define f_error(fp) ((fp)->err) FRESULT f_opendir (DIR* dp, const TCHAR* path); /* Open a directory */
#define f_tell(fp) ((fp)->fptr) FRESULT f_closedir (DIR* dp); /* Close an open directory */
#define f_size(fp) ((fp)->obj.objsize) FRESULT f_readdir (DIR* dp, FILINFO* fno); /* Read a directory item */
#define f_rewind(fp) f_lseek((fp), 0) FRESULT f_findfirst (DIR* dp, FILINFO* fno, const TCHAR* path, const TCHAR* pattern); /* Find first file */
#define f_rewinddir(dp) f_readdir((dp), 0) FRESULT f_findnext (DIR* dp, FILINFO* fno); /* Find next file */
#define f_rmdir(path) f_unlink(path) FRESULT f_mkdir (const TCHAR* path); /* Create a sub directory */
#define f_unmount(path) f_mount(0, path, 0) FRESULT f_unlink (const TCHAR* path); /* Delete an existing file or directory */
FRESULT f_rename (const TCHAR* path_old, const TCHAR* path_new); /* Rename/Move a file or directory */
#ifndef EOF FRESULT f_stat (const TCHAR* path, FILINFO* fno); /* Get file status */
#define EOF (-1) FRESULT f_chmod (const TCHAR* path, BYTE attr, BYTE mask); /* Change attribute of a file/dir */
#endif FRESULT f_utime (const TCHAR* path, const FILINFO* fno); /* Change timestamp of a file/dir */
FRESULT f_chdir (const TCHAR* path); /* Change current directory */
FRESULT f_chdrive (const TCHAR* path); /* Change current drive */
FRESULT f_getcwd (TCHAR* buff, UINT len); /* Get current directory */
FRESULT f_getfree (const TCHAR* path, DWORD* nclst, FATFS** fatfs); /* Get number of free clusters on the drive */
/*--------------------------------------------------------------*/ FRESULT f_getlabel (const TCHAR* path, TCHAR* label, DWORD* vsn); /* Get volume label */
/* Additional user defined functions */ FRESULT f_setlabel (const TCHAR* label); /* Set volume label */
FRESULT f_forward (FIL* fp, UINT(*func)(const BYTE*,UINT), UINT btf, UINT* bf); /* Forward data to the stream */
/* RTC function */ FRESULT f_expand (FIL* fp, FSIZE_t fsz, BYTE opt); /* Allocate a contiguous block to the file */
#if !FF_FS_READONLY && !FF_FS_NORTC FRESULT f_mount (FATFS* fs, const TCHAR* path, BYTE opt); /* Mount/Unmount a logical drive */
DWORD get_fattime (void); FRESULT f_mkfs (const TCHAR* path, BYTE opt, DWORD au, void* work, UINT len); /* Create a FAT volume */
#endif FRESULT f_fdisk (BYTE pdrv, const DWORD* szt, void* work); /* Divide a physical drive into some partitions */
FRESULT f_setcp (WORD cp); /* Set current code page */
/* LFN support functions */ int f_putc (TCHAR c, FIL* fp); /* Put a character to the file */
#if FF_USE_LFN >= 1 /* Code conversion (defined in unicode.c) */ int f_puts (const TCHAR* str, FIL* cp); /* Put a string to the file */
WCHAR ff_oem2uni (WCHAR oem, WORD cp); /* OEM code to Unicode conversion */ int f_printf (FIL* fp, const TCHAR* str, ...); /* Put a formatted string to the file */
WCHAR ff_uni2oem (DWORD uni, WORD cp); /* Unicode to OEM code conversion */ TCHAR* f_gets (TCHAR* buff, int len, FIL* fp); /* Get a string from the file */
DWORD ff_wtoupper (DWORD uni); /* Unicode upper-case conversion */
#endif #define f_eof(fp) ((int)((fp)->fptr == (fp)->obj.objsize))
#if FF_USE_LFN == 3 /* Dynamic memory allocation */ #define f_error(fp) ((fp)->err)
void* ff_memalloc (UINT msize); /* Allocate memory block */ #define f_tell(fp) ((fp)->fptr)
void ff_memfree (void* mblock); /* Free memory block */ #define f_size(fp) ((fp)->obj.objsize)
#endif #define f_rewind(fp) f_lseek((fp), 0)
#define f_rewinddir(dp) f_readdir((dp), 0)
/* Sync functions */ #define f_rmdir(path) f_unlink(path)
#if FF_FS_REENTRANT #define f_unmount(path) f_mount(0, path, 0)
int ff_cre_syncobj (BYTE vol, FF_SYNC_t* sobj); /* Create a sync object */
int ff_req_grant (FF_SYNC_t sobj); /* Lock sync object */ #ifndef EOF
void ff_rel_grant (FF_SYNC_t sobj); /* Unlock sync object */ #define EOF (-1)
int ff_del_syncobj (FF_SYNC_t sobj); /* Delete a sync object */ #endif
#endif
/*--------------------------------------------------------------*/
/*--------------------------------------------------------------*/ /* Additional user defined functions */
/* Flags and offset address */
/* RTC function */
#if !FF_FS_READONLY && !FF_FS_NORTC
/* File access mode and open method flags (3rd argument of f_open) */ DWORD get_fattime (void);
#define FA_READ 0x01 #endif
#define FA_WRITE 0x02
#define FA_OPEN_EXISTING 0x00 /* LFN support functions */
#define FA_CREATE_NEW 0x04 #if FF_USE_LFN >= 1 /* Code conversion (defined in unicode.c) */
#define FA_CREATE_ALWAYS 0x08 WCHAR ff_oem2uni (WCHAR oem, WORD cp); /* OEM code to Unicode conversion */
#define FA_OPEN_ALWAYS 0x10 WCHAR ff_uni2oem (DWORD uni, WORD cp); /* Unicode to OEM code conversion */
#define FA_OPEN_APPEND 0x30 DWORD ff_wtoupper (DWORD uni); /* Unicode upper-case conversion */
#endif
/* Fast seek controls (2nd argument of f_lseek) */ #if FF_USE_LFN == 3 /* Dynamic memory allocation */
#define CREATE_LINKMAP ((FSIZE_t)0 - 1) void* ff_memalloc (UINT msize); /* Allocate memory block */
void ff_memfree (void* mblock); /* Free memory block */
/* Format options (2nd argument of f_mkfs) */ #endif
#define FM_FAT 0x01
#define FM_FAT32 0x02 /* Sync functions */
#define FM_EXFAT 0x04 #if FF_FS_REENTRANT
#define FM_ANY 0x07 int ff_cre_syncobj (BYTE vol, FF_SYNC_t* sobj); /* Create a sync object */
#define FM_SFD 0x08 int ff_req_grant (FF_SYNC_t sobj); /* Lock sync object */
void ff_rel_grant (FF_SYNC_t sobj); /* Unlock sync object */
/* Filesystem type (FATFS.fs_type) */ int ff_del_syncobj (FF_SYNC_t sobj); /* Delete a sync object */
#define FS_FAT12 1 #endif
#define FS_FAT16 2
#define FS_FAT32 3
#define FS_EXFAT 4
/* File attribute bits for directory entry (FILINFO.fattrib) */ /*--------------------------------------------------------------*/
#define AM_RDO 0x01 /* Read only */ /* Flags and offset address */
#define AM_HID 0x02 /* Hidden */
#define AM_SYS 0x04 /* System */
#define AM_DIR 0x10 /* Directory */ /* File access mode and open method flags (3rd argument of f_open) */
#define AM_ARC 0x20 /* Archive */ #define FA_READ 0x01
#define FA_WRITE 0x02
#define FA_OPEN_EXISTING 0x00
#ifdef __cplusplus #define FA_CREATE_NEW 0x04
} #define FA_CREATE_ALWAYS 0x08
#endif #define FA_OPEN_ALWAYS 0x10
#define FA_OPEN_APPEND 0x30
#endif /* FF_DEFINED */
/* Fast seek controls (2nd argument of f_lseek) */
#define CREATE_LINKMAP ((FSIZE_t)0 - 1)
/* Format options (2nd argument of f_mkfs) */
#define FM_FAT 0x01
#define FM_FAT32 0x02
#define FM_EXFAT 0x04
#define FM_ANY 0x07
#define FM_SFD 0x08
/* Filesystem type (FATFS.fs_type) */
#define FS_FAT12 1
#define FS_FAT16 2
#define FS_FAT32 3
#define FS_EXFAT 4
/* File attribute bits for directory entry (FILINFO.fattrib) */
#define AM_RDO 0x01 /* Read only */
#define AM_HID 0x02 /* Hidden */
#define AM_SYS 0x04 /* System */
#define AM_DIR 0x10 /* Directory */
#define AM_ARC 0x20 /* Archive */
#ifdef __cplusplus
}
#endif
#endif /* FF_DEFINED */

View File

@ -1,289 +1,288 @@
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ FatFs - Configuration file / FatFs Functional Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FFCONF_DEF 63463 /* Revision ID */ #define FFCONF_DEF 86604 /* Revision ID */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ Function Configurations / Function Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_FS_READONLY 0 #define FF_FS_READONLY 0
/* This option switches read-only configuration. (0:Read/Write or 1:Read-only) /* This option switches read-only configuration. (0:Read/Write or 1:Read-only)
/ Read-only configuration removes writing API functions, f_write(), f_sync(), / Read-only configuration removes writing API functions, f_write(), f_sync(),
/ f_unlink(), f_mkdir(), f_chmod(), f_rename(), f_truncate(), f_getfree() / f_unlink(), f_mkdir(), f_chmod(), f_rename(), f_truncate(), f_getfree()
/ and optional writing functions as well. */ / and optional writing functions as well. */
#define FF_FS_MINIMIZE 0 #define FF_FS_MINIMIZE 0
/* This option defines minimization level to remove some basic API functions. /* This option defines minimization level to remove some basic API functions.
/ /
/ 0: Basic functions are fully enabled. / 0: Basic functions are fully enabled.
/ 1: f_stat(), f_getfree(), f_unlink(), f_mkdir(), f_truncate() and f_rename() / 1: f_stat(), f_getfree(), f_unlink(), f_mkdir(), f_truncate() and f_rename()
/ are removed. / are removed.
/ 2: f_opendir(), f_readdir() and f_closedir() are removed in addition to 1. / 2: f_opendir(), f_readdir() and f_closedir() are removed in addition to 1.
/ 3: f_lseek() function is removed in addition to 2. */ / 3: f_lseek() function is removed in addition to 2. */
#define FF_USE_STRFUNC 2 #define FF_USE_STRFUNC 2
/* This option switches string functions, f_gets(), f_putc(), f_puts() and f_printf(). /* This option switches string functions, f_gets(), f_putc(), f_puts() and f_printf().
/ /
/ 0: Disable string functions. / 0: Disable string functions.
/ 1: Enable without LF-CRLF conversion. / 1: Enable without LF-CRLF conversion.
/ 2: Enable with LF-CRLF conversion. */ / 2: Enable with LF-CRLF conversion. */
#define FF_USE_FIND 0 #define FF_USE_FIND 0
/* This option switches filtered directory read functions, f_findfirst() and /* This option switches filtered directory read functions, f_findfirst() and
/ f_findnext(). (0:Disable, 1:Enable 2:Enable with matching altname[] too) */ / f_findnext(). (0:Disable, 1:Enable 2:Enable with matching altname[] too) */
#define FF_USE_MKFS 0 #define FF_USE_MKFS 0
/* This option switches f_mkfs() function. (0:Disable or 1:Enable) */ /* This option switches f_mkfs() function. (0:Disable or 1:Enable) */
#define FF_USE_FASTSEEK 0 #define FF_USE_FASTSEEK 0
/* This option switches fast seek function. (0:Disable or 1:Enable) */ /* This option switches fast seek function. (0:Disable or 1:Enable) */
#define FF_USE_EXPAND 0 #define FF_USE_EXPAND 0
/* This option switches f_expand function. (0:Disable or 1:Enable) */ /* This option switches f_expand function. (0:Disable or 1:Enable) */
#define FF_USE_CHMOD 0 #define FF_USE_CHMOD 0
/* This option switches attribute manipulation functions, f_chmod() and f_utime(). /* This option switches attribute manipulation functions, f_chmod() and f_utime().
/ (0:Disable or 1:Enable) Also FF_FS_READONLY needs to be 0 to enable this option. */ / (0:Disable or 1:Enable) Also FF_FS_READONLY needs to be 0 to enable this option. */
#define FF_USE_LABEL 0 #define FF_USE_LABEL 0
/* This option switches volume label functions, f_getlabel() and f_setlabel(). /* This option switches volume label functions, f_getlabel() and f_setlabel().
/ (0:Disable or 1:Enable) */ / (0:Disable or 1:Enable) */
#define FF_USE_FORWARD 0 #define FF_USE_FORWARD 0
/* This option switches f_forward() function. (0:Disable or 1:Enable) */ /* This option switches f_forward() function. (0:Disable or 1:Enable) */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ Locale and Namespace Configurations / Locale and Namespace Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_CODE_PAGE 850 #define FF_CODE_PAGE 850
/* This option specifies the OEM code page to be used on the target system. /* This option specifies the OEM code page to be used on the target system.
/ Incorrect code page setting can cause a file open failure. / Incorrect code page setting can cause a file open failure.
/ /
/ 437 - U.S. / 437 - U.S.
/ 720 - Arabic / 720 - Arabic
/ 737 - Greek / 737 - Greek
/ 771 - KBL / 771 - KBL
/ 775 - Baltic / 775 - Baltic
/ 850 - Latin 1 / 850 - Latin 1
/ 852 - Latin 2 / 852 - Latin 2
/ 855 - Cyrillic / 855 - Cyrillic
/ 857 - Turkish / 857 - Turkish
/ 860 - Portuguese / 860 - Portuguese
/ 861 - Icelandic / 861 - Icelandic
/ 862 - Hebrew / 862 - Hebrew
/ 863 - Canadian French / 863 - Canadian French
/ 864 - Arabic / 864 - Arabic
/ 865 - Nordic / 865 - Nordic
/ 866 - Russian / 866 - Russian
/ 869 - Greek 2 / 869 - Greek 2
/ 932 - Japanese (DBCS) / 932 - Japanese (DBCS)
/ 936 - Simplified Chinese (DBCS) / 936 - Simplified Chinese (DBCS)
/ 949 - Korean (DBCS) / 949 - Korean (DBCS)
/ 950 - Traditional Chinese (DBCS) / 950 - Traditional Chinese (DBCS)
/ 0 - Include all code pages above and configured by f_setcp() / 0 - Include all code pages above and configured by f_setcp()
*/ */
#define FF_USE_LFN 1 #define FF_USE_LFN 1
#define FF_MAX_LFN 255 #define FF_MAX_LFN 255
/* The FF_USE_LFN switches the support for LFN (long file name). /* The FF_USE_LFN switches the support for LFN (long file name).
/ /
/ 0: Disable LFN. FF_MAX_LFN has no effect. / 0: Disable LFN. FF_MAX_LFN has no effect.
/ 1: Enable LFN with static working buffer on the BSS. Always NOT thread-safe. / 1: Enable LFN with static working buffer on the BSS. Always NOT thread-safe.
/ 2: Enable LFN with dynamic working buffer on the STACK. / 2: Enable LFN with dynamic working buffer on the STACK.
/ 3: Enable LFN with dynamic working buffer on the HEAP. / 3: Enable LFN with dynamic working buffer on the HEAP.
/ /
/ To enable the LFN, ffunicode.c needs to be added to the project. The LFN function / To enable the LFN, ffunicode.c needs to be added to the project. The LFN function
/ requiers certain internal working buffer occupies (FF_MAX_LFN + 1) * 2 bytes and / requiers certain internal working buffer occupies (FF_MAX_LFN + 1) * 2 bytes and
/ additional (FF_MAX_LFN + 44) / 15 * 32 bytes when exFAT is enabled. / additional (FF_MAX_LFN + 44) / 15 * 32 bytes when exFAT is enabled.
/ The FF_MAX_LFN defines size of the working buffer in UTF-16 code unit and it can / The FF_MAX_LFN defines size of the working buffer in UTF-16 code unit and it can
/ be in range of 12 to 255. It is recommended to be set 255 to fully support LFN / be in range of 12 to 255. It is recommended to be set 255 to fully support LFN
/ specification. / specification.
/ When use stack for the working buffer, take care on stack overflow. When use heap / When use stack for the working buffer, take care on stack overflow. When use heap
/ memory for the working buffer, memory management functions, ff_memalloc() and / memory for the working buffer, memory management functions, ff_memalloc() and
/ ff_memfree() in ffsystem.c, need to be added to the project. */ / ff_memfree() in ffsystem.c, need to be added to the project. */
#define FF_LFN_UNICODE 2 #define FF_LFN_UNICODE 2
/* This option switches the character encoding on the API when LFN is enabled. /* This option switches the character encoding on the API when LFN is enabled.
/ /
/ 0: ANSI/OEM in current CP (TCHAR = char) / 0: ANSI/OEM in current CP (TCHAR = char)
/ 1: Unicode in UTF-16 (TCHAR = WCHAR) / 1: Unicode in UTF-16 (TCHAR = WCHAR)
/ 2: Unicode in UTF-8 (TCHAR = char) / 2: Unicode in UTF-8 (TCHAR = char)
/ 3: Unicode in UTF-32 (TCHAR = DWORD) / 3: Unicode in UTF-32 (TCHAR = DWORD)
/ /
/ Also behavior of string I/O functions will be affected by this option. / Also behavior of string I/O functions will be affected by this option.
/ When LFN is not enabled, this option has no effect. */ / When LFN is not enabled, this option has no effect. */
#define FF_LFN_BUF 255 #define FF_LFN_BUF 255
#define FF_SFN_BUF 12 #define FF_SFN_BUF 12
/* This set of options defines size of file name members in the FILINFO structure /* This set of options defines size of file name members in the FILINFO structure
/ which is used to read out directory items. These values should be suffcient for / which is used to read out directory items. These values should be suffcient for
/ the file names to read. The maximum possible length of the read file name depends / the file names to read. The maximum possible length of the read file name depends
/ on character encoding. When LFN is not enabled, these options have no effect. */ / on character encoding. When LFN is not enabled, these options have no effect. */
#define FF_STRF_ENCODE 3 #define FF_STRF_ENCODE 3
/* When FF_LFN_UNICODE >= 1 with LFN enabled, string I/O functions, f_gets(), /* When FF_LFN_UNICODE >= 1 with LFN enabled, string I/O functions, f_gets(),
/ f_putc(), f_puts and f_printf() convert the character encoding in it. / f_putc(), f_puts and f_printf() convert the character encoding in it.
/ This option selects assumption of character encoding ON THE FILE to be / This option selects assumption of character encoding ON THE FILE to be
/ read/written via those functions. / read/written via those functions.
/ /
/ 0: ANSI/OEM in current CP / 0: ANSI/OEM in current CP
/ 1: Unicode in UTF-16LE / 1: Unicode in UTF-16LE
/ 2: Unicode in UTF-16BE / 2: Unicode in UTF-16BE
/ 3: Unicode in UTF-8 / 3: Unicode in UTF-8
*/ */
#define FF_FS_RPATH 0 #define FF_FS_RPATH 0
/* This option configures support for relative path. /* This option configures support for relative path.
/ /
/ 0: Disable relative path and remove related functions. / 0: Disable relative path and remove related functions.
/ 1: Enable relative path. f_chdir() and f_chdrive() are available. / 1: Enable relative path. f_chdir() and f_chdrive() are available.
/ 2: f_getcwd() function is available in addition to 1. / 2: f_getcwd() function is available in addition to 1.
*/ */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ Drive/Volume Configurations / Drive/Volume Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_VOLUMES 1 #define FF_VOLUMES 1
/* Number of volumes (logical drives) to be used. (1-10) */ /* Number of volumes (logical drives) to be used. (1-10) */
#define FF_STR_VOLUME_ID 0 #define FF_STR_VOLUME_ID 0
#define FF_VOLUME_STRS "sdmc" #define FF_VOLUME_STRS "sdmc"
/* FF_STR_VOLUME_ID switches support for volume ID in arbitrary strings. /* FF_STR_VOLUME_ID switches support for volume ID in arbitrary strings.
/ When FF_STR_VOLUME_ID is set to 1 or 2, arbitrary strings can be used as drive / When FF_STR_VOLUME_ID is set to 1 or 2, arbitrary strings can be used as drive
/ number in the path name. FF_VOLUME_STRS defines the volume ID strings for each / number in the path name. FF_VOLUME_STRS defines the volume ID strings for each
/ logical drives. Number of items must not be less than FF_VOLUMES. Valid / logical drives. Number of items must not be less than FF_VOLUMES. Valid
/ characters for the volume ID strings are A-Z, a-z and 0-9, however, they are / characters for the volume ID strings are A-Z, a-z and 0-9, however, they are
/ compared in case-insensitive. If FF_STR_VOLUME_ID >= 1 and FF_VOLUME_STRS is / compared in case-insensitive. If FF_STR_VOLUME_ID >= 1 and FF_VOLUME_STRS is
/ not defined, a user defined volume string table needs to be defined as: / not defined, a user defined volume string table needs to be defined as:
/ /
/ const char* VolumeStr[FF_VOLUMES] = {"ram","flash","sd","usb",... / const char* VolumeStr[FF_VOLUMES] = {"ram","flash","sd","usb",...
*/ */
#define FF_MULTI_PARTITION 0 #define FF_MULTI_PARTITION 0
/* This option switches support for multiple volumes on the physical drive. /* This option switches support for multiple volumes on the physical drive.
/ By default (0), each logical drive number is bound to the same physical drive / By default (0), each logical drive number is bound to the same physical drive
/ number and only an FAT volume found on the physical drive will be mounted. / number and only an FAT volume found on the physical drive will be mounted.
/ When this function is enabled (1), each logical drive number can be bound to / When this function is enabled (1), each logical drive number can be bound to
/ arbitrary physical drive and partition listed in the VolToPart[]. Also f_fdisk() / arbitrary physical drive and partition listed in the VolToPart[]. Also f_fdisk()
/ funciton will be available. */ / funciton will be available. */
#define FF_MIN_SS 512 #define FF_MIN_SS 512
#define FF_MAX_SS 512 #define FF_MAX_SS 512
/* This set of options configures the range of sector size to be supported. (512, /* This set of options configures the range of sector size to be supported. (512,
/ 1024, 2048 or 4096) Always set both 512 for most systems, generic memory card and / 1024, 2048 or 4096) Always set both 512 for most systems, generic memory card and
/ harddisk. But a larger value may be required for on-board flash memory and some / harddisk. But a larger value may be required for on-board flash memory and some
/ type of optical media. When FF_MAX_SS is larger than FF_MIN_SS, FatFs is configured / type of optical media. When FF_MAX_SS is larger than FF_MIN_SS, FatFs is configured
/ for variable sector size mode and disk_ioctl() function needs to implement / for variable sector size mode and disk_ioctl() function needs to implement
/ GET_SECTOR_SIZE command. */ / GET_SECTOR_SIZE command. */
#define FF_USE_TRIM 0 #define FF_USE_TRIM 0
/* This option switches support for ATA-TRIM. (0:Disable or 1:Enable) /* This option switches support for ATA-TRIM. (0:Disable or 1:Enable)
/ To enable Trim function, also CTRL_TRIM command should be implemented to the / To enable Trim function, also CTRL_TRIM command should be implemented to the
/ disk_ioctl() function. */ / disk_ioctl() function. */
#define FF_FS_NOFSINFO 0 #define FF_FS_NOFSINFO 0
/* If you need to know correct free space on the FAT32 volume, set bit 0 of this /* If you need to know correct free space on the FAT32 volume, set bit 0 of this
/ option, and f_getfree() function at first time after volume mount will force / option, and f_getfree() function at first time after volume mount will force
/ a full FAT scan. Bit 1 controls the use of last allocated cluster number. / a full FAT scan. Bit 1 controls the use of last allocated cluster number.
/ /
/ bit0=0: Use free cluster count in the FSINFO if available. / bit0=0: Use free cluster count in the FSINFO if available.
/ bit0=1: Do not trust free cluster count in the FSINFO. / bit0=1: Do not trust free cluster count in the FSINFO.
/ bit1=0: Use last allocated cluster number in the FSINFO if available. / bit1=0: Use last allocated cluster number in the FSINFO if available.
/ bit1=1: Do not trust last allocated cluster number in the FSINFO. / bit1=1: Do not trust last allocated cluster number in the FSINFO.
*/ */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ System Configurations / System Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_FS_TINY 0 #define FF_FS_TINY 0
/* This option switches tiny buffer configuration. (0:Normal or 1:Tiny) /* This option switches tiny buffer configuration. (0:Normal or 1:Tiny)
/ At the tiny configuration, size of file object (FIL) is shrinked FF_MAX_SS bytes. / At the tiny configuration, size of file object (FIL) is shrinked FF_MAX_SS bytes.
/ Instead of private sector buffer eliminated from the file object, common sector / Instead of private sector buffer eliminated from the file object, common sector
/ buffer in the filesystem object (FATFS) is used for the file data transfer. */ / buffer in the filesystem object (FATFS) is used for the file data transfer. */
#define FF_FS_EXFAT 1 #define FF_FS_EXFAT 1
/* This option switches support for exFAT filesystem. (0:Disable or 1:Enable) /* This option switches support for exFAT filesystem. (0:Disable or 1:Enable)
/ To enable exFAT, also LFN needs to be enabled. / To enable exFAT, also LFN needs to be enabled. (FF_USE_LFN >= 1)
/ Note that enabling exFAT discards ANSI C (C89) compatibility. */ / Note that enabling exFAT discards ANSI C (C89) compatibility. */
#define FF_FS_NORTC 1 #define FF_FS_NORTC 1
#define FF_NORTC_MON 1 #define FF_NORTC_MON 1
#define FF_NORTC_MDAY 1 #define FF_NORTC_MDAY 1
#define FF_NORTC_YEAR 2018 #define FF_NORTC_YEAR 2018
/* The option FF_FS_NORTC switches timestamp functiton. If the system does not have /* The option FF_FS_NORTC switches timestamp functiton. If the system does not have
/ any RTC function or valid timestamp is not needed, set FF_FS_NORTC = 1 to disable / any RTC function or valid timestamp is not needed, set FF_FS_NORTC = 1 to disable
/ the timestamp function. Every object modified by FatFs will have a fixed timestamp / the timestamp function. Every object modified by FatFs will have a fixed timestamp
/ defined by FF_NORTC_MON, FF_NORTC_MDAY and FF_NORTC_YEAR in local time. / defined by FF_NORTC_MON, FF_NORTC_MDAY and FF_NORTC_YEAR in local time.
/ To enable timestamp function (FF_FS_NORTC = 0), get_fattime() function need to be / To enable timestamp function (FF_FS_NORTC = 0), get_fattime() function need to be
/ added to the project to read current time form real-time clock. FF_NORTC_MON, / added to the project to read current time form real-time clock. FF_NORTC_MON,
/ FF_NORTC_MDAY and FF_NORTC_YEAR have no effect. / FF_NORTC_MDAY and FF_NORTC_YEAR have no effect.
/ These options have no effect at read-only configuration (FF_FS_READONLY = 1). */ / These options have no effect at read-only configuration (FF_FS_READONLY = 1). */
#define FF_FS_LOCK 0 #define FF_FS_LOCK 0
/* The option FF_FS_LOCK switches file lock function to control duplicated file open /* The option FF_FS_LOCK switches file lock function to control duplicated file open
/ and illegal operation to open objects. This option must be 0 when FF_FS_READONLY / and illegal operation to open objects. This option must be 0 when FF_FS_READONLY
/ is 1. / is 1.
/ /
/ 0: Disable file lock function. To avoid volume corruption, application program / 0: Disable file lock function. To avoid volume corruption, application program
/ should avoid illegal open, remove and rename to the open objects. / should avoid illegal open, remove and rename to the open objects.
/ >0: Enable file lock function. The value defines how many files/sub-directories / >0: Enable file lock function. The value defines how many files/sub-directories
/ can be opened simultaneously under file lock control. Note that the file / can be opened simultaneously under file lock control. Note that the file
/ lock control is independent of re-entrancy. */ / lock control is independent of re-entrancy. */
#define FF_FS_REENTRANT 0 /* #include <somertos.h> // O/S definitions */
#define FF_FS_TIMEOUT 1000 #define FF_FS_REENTRANT 0
#define FF_SYNC_t HANDLE #define FF_FS_TIMEOUT 1000
/* The option FF_FS_REENTRANT switches the re-entrancy (thread safe) of the FatFs #define FF_SYNC_t HANDLE
/ module itself. Note that regardless of this option, file access to different /* The option FF_FS_REENTRANT switches the re-entrancy (thread safe) of the FatFs
/ volume is always re-entrant and volume control functions, f_mount(), f_mkfs() / module itself. Note that regardless of this option, file access to different
/ and f_fdisk() function, are always not re-entrant. Only file/directory access / volume is always re-entrant and volume control functions, f_mount(), f_mkfs()
/ to the same volume is under control of this function. / and f_fdisk() function, are always not re-entrant. Only file/directory access
/ / to the same volume is under control of this function.
/ 0: Disable re-entrancy. FF_FS_TIMEOUT and FF_SYNC_t have no effect. /
/ 1: Enable re-entrancy. Also user provided synchronization handlers, / 0: Disable re-entrancy. FF_FS_TIMEOUT and FF_SYNC_t have no effect.
/ ff_req_grant(), ff_rel_grant(), ff_del_syncobj() and ff_cre_syncobj() / 1: Enable re-entrancy. Also user provided synchronization handlers,
/ function, must be added to the project. Samples are available in / ff_req_grant(), ff_rel_grant(), ff_del_syncobj() and ff_cre_syncobj()
/ option/syscall.c. / function, must be added to the project. Samples are available in
/ / option/syscall.c.
/ The FF_FS_TIMEOUT defines timeout period in unit of time tick. /
/ The FF_SYNC_t defines O/S dependent sync object type. e.g. HANDLE, ID, OS_EVENT*, / The FF_FS_TIMEOUT defines timeout period in unit of time tick.
/ SemaphoreHandle_t and etc. A header file for O/S definitions needs to be / The FF_SYNC_t defines O/S dependent sync object type. e.g. HANDLE, ID, OS_EVENT*,
/ included somewhere in the scope of ff.h. */ / SemaphoreHandle_t and etc. A header file for O/S definitions needs to be
/ included somewhere in the scope of ff.h. */
/* #include <windows.h> // O/S definitions */
/*--- End of configuration options ---*/
/*--- End of configuration options ---*/

View File

@ -1,171 +1,170 @@
/*------------------------------------------------------------------------*/ /*------------------------------------------------------------------------*/
/* Sample Code of OS Dependent Functions for FatFs */ /* Sample Code of OS Dependent Functions for FatFs */
/* (C)ChaN, 2017 */ /* (C)ChaN, 2018 */
/*------------------------------------------------------------------------*/ /*------------------------------------------------------------------------*/
#include "ff.h" #include "ff.h"
#if FF_USE_LFN == 3 /* Dynamic memory allocation */
#if FF_USE_LFN == 3 /* Dynamic memory allocation */
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Allocate a memory block */
/* Allocate a memory block */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/
void* ff_memalloc ( /* Returns pointer to the allocated memory block (null if not enough core) */
void* ff_memalloc ( /* Returns pointer to the allocated memory block (null on not enough core) */ UINT msize /* Number of bytes to allocate */
UINT msize /* Number of bytes to allocate */ )
) {
{ return malloc(msize); /* Allocate a new memory block with POSIX API */
return malloc(msize); /* Allocate a new memory block with POSIX API */ }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Free a memory block */
/* Free a memory block */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/
void ff_memfree (
void ff_memfree ( void* mblock /* Pointer to the memory block to free (nothing to do if null) */
void* mblock /* Pointer to the memory block to free (nothing to do for null) */ )
) {
{ free(mblock); /* Free the memory block with POSIX API */
free(mblock); /* Free the memory block with POSIX API */ }
}
#endif
#endif
#if FF_FS_REENTRANT /* Mutal exclusion */
#if FF_FS_REENTRANT /* Mutal exclusion */
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Create a Synchronization Object */
/* Create a Synchronization Object */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called in f_mount() function to create a new
/* This function is called in f_mount() function to create a new / synchronization object for the volume, such as semaphore and mutex.
/ synchronization object for the volume, such as semaphore and mutex. / When a 0 is returned, the f_mount() function fails with FR_INT_ERR.
/ When a 0 is returned, the f_mount() function fails with FR_INT_ERR. */
*/
//const osMutexDef_t Mutex[FF_VOLUMES]; /* Table of CMSIS-RTOS mutex */
//const osMutexDef_t Mutex[FF_VOLUMES]; /* CMSIS-RTOS */
int ff_cre_syncobj ( /* 1:Function succeeded, 0:Could not create the sync object */
int ff_cre_syncobj ( /* 1:Function succeeded, 0:Could not create the sync object */ BYTE vol, /* Corresponding volume (logical drive number) */
BYTE vol, /* Corresponding volume (logical drive number) */ FF_SYNC_t* sobj /* Pointer to return the created sync object */
FF_SYNC_t* sobj /* Pointer to return the created sync object */ )
) {
{ /* Win32 */
/* Win32 */ *sobj = CreateMutex(NULL, FALSE, NULL);
*sobj = CreateMutex(NULL, FALSE, NULL); return (int)(*sobj != INVALID_HANDLE_VALUE);
return (int)(*sobj != INVALID_HANDLE_VALUE);
/* uITRON */
/* uITRON */ // T_CSEM csem = {TA_TPRI,1,1};
// T_CSEM csem = {TA_TPRI,1,1}; // *sobj = acre_sem(&csem);
// *sobj = acre_sem(&csem); // return (int)(*sobj > 0);
// return (int)(*sobj > 0);
/* uC/OS-II */
/* uC/OS-II */ // OS_ERR err;
// OS_ERR err; // *sobj = OSMutexCreate(0, &err);
// *sobj = OSMutexCreate(0, &err); // return (int)(err == OS_NO_ERR);
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
/* FreeRTOS */ // *sobj = xSemaphoreCreateMutex();
// *sobj = xSemaphoreCreateMutex(); // return (int)(*sobj != NULL);
// return (int)(*sobj != NULL);
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // *sobj = osMutexCreate(&Mutex[vol]);
// *sobj = osMutexCreate(Mutex + vol); // return (int)(*sobj != NULL);
// return (int)(*sobj != NULL); }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Delete a Synchronization Object */
/* Delete a Synchronization Object */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called in f_mount() function to delete a synchronization
/* This function is called in f_mount() function to delete a synchronization / object that created with ff_cre_syncobj() function. When a 0 is returned,
/ object that created with ff_cre_syncobj() function. When a 0 is returned, / the f_mount() function fails with FR_INT_ERR.
/ the f_mount() function fails with FR_INT_ERR. */
*/
int ff_del_syncobj ( /* 1:Function succeeded, 0:Could not delete due to an error */
int ff_del_syncobj ( /* 1:Function succeeded, 0:Could not delete due to an error */ FF_SYNC_t sobj /* Sync object tied to the logical drive to be deleted */
FF_SYNC_t sobj /* Sync object tied to the logical drive to be deleted */ )
) {
{ /* Win32 */
/* Win32 */ return (int)CloseHandle(sobj);
return (int)CloseHandle(sobj);
/* uITRON */
/* uITRON */ // return (int)(del_sem(sobj) == E_OK);
// return (int)(del_sem(sobj) == E_OK);
/* uC/OS-II */
/* uC/OS-II */ // OS_ERR err;
// OS_ERR err; // OSMutexDel(sobj, OS_DEL_ALWAYS, &err);
// OSMutexDel(sobj, OS_DEL_ALWAYS, &err); // return (int)(err == OS_NO_ERR);
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
/* FreeRTOS */ // vSemaphoreDelete(sobj);
// vSemaphoreDelete(sobj); // return 1;
// return 1;
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // return (int)(osMutexDelete(sobj) == osOK);
// return (int)(osMutexDelete(sobj) == osOK); }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Request Grant to Access the Volume */
/* Request Grant to Access the Volume */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called on entering file functions to lock the volume.
/* This function is called on entering file functions to lock the volume. / When a 0 is returned, the file function fails with FR_TIMEOUT.
/ When a 0 is returned, the file function fails with FR_TIMEOUT. */
*/
int ff_req_grant ( /* 1:Got a grant to access the volume, 0:Could not get a grant */
int ff_req_grant ( /* 1:Got a grant to access the volume, 0:Could not get a grant */ FF_SYNC_t sobj /* Sync object to wait */
FF_SYNC_t sobj /* Sync object to wait */ )
) {
{ /* Win32 */
/* Win32 */ return (int)(WaitForSingleObject(sobj, FF_FS_TIMEOUT) == WAIT_OBJECT_0);
return (int)(WaitForSingleObject(sobj, FF_FS_TIMEOUT) == WAIT_OBJECT_0);
/* uITRON */
/* uITRON */ // return (int)(wai_sem(sobj) == E_OK);
// return (int)(wai_sem(sobj) == E_OK);
/* uC/OS-II */
/* uC/OS-II */ // OS_ERR err;
// OS_ERR err; // OSMutexPend(sobj, FF_FS_TIMEOUT, &err));
// OSMutexPend(sobj, FF_FS_TIMEOUT, &err)); // return (int)(err == OS_NO_ERR);
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
/* FreeRTOS */ // return (int)(xSemaphoreTake(sobj, FF_FS_TIMEOUT) == pdTRUE);
// return (int)(xSemaphoreTake(sobj, FF_FS_TIMEOUT) == pdTRUE);
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // return (int)(osMutexWait(sobj, FF_FS_TIMEOUT) == osOK);
// return (int)(osMutexWait(sobj, FF_FS_TIMEOUT) == osOK); }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Release Grant to Access the Volume */
/* Release Grant to Access the Volume */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called on leaving file functions to unlock the volume.
/* This function is called on leaving file functions to unlock the volume. */
*/
void ff_rel_grant (
void ff_rel_grant ( FF_SYNC_t sobj /* Sync object to be signaled */
FF_SYNC_t sobj /* Sync object to be signaled */ )
) {
{ /* Win32 */
/* Win32 */ ReleaseMutex(sobj);
ReleaseMutex(sobj);
/* uITRON */
/* uITRON */ // sig_sem(sobj);
// sig_sem(sobj);
/* uC/OS-II */
/* uC/OS-II */ // OSMutexPost(sobj);
// OSMutexPost(sobj);
/* FreeRTOS */
/* FreeRTOS */ // xSemaphoreGive(sobj);
// xSemaphoreGive(sobj);
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // osMutexRelease(sobj);
// osMutexRelease(sobj); }
}
#endif
#endif

File diff suppressed because it is too large Load Diff

View File

@ -1,36 +0,0 @@
/*-------------------------------------------*/
/* Integer type definitions for FatFs module */
/*-------------------------------------------*/
#ifndef FF_INTEGER
#define FF_INTEGER
#ifdef _WIN32 /* FatFs development platform */
#include <windows.h>
typedef unsigned __int64 QWORD;
#else /* Embedded platform */
/* These types MUST be 16-bit or 32-bit */
typedef int INT;
typedef unsigned int UINT;
/* This type MUST be 8-bit */
typedef unsigned char BYTE;
/* These types MUST be 16-bit */
typedef short SHORT;
typedef unsigned short WORD;
typedef unsigned short WCHAR;
/* These types MUST be 32-bit */
typedef long LONG;
typedef unsigned long DWORD;
/* This type MUST be 64-bit (Remove this for ANSI C (C89) compatibility) */
typedef unsigned long long QWORD;
#endif
#endif

View File

@ -1,324 +1,330 @@
---------------------------------------------------------------------------- ----------------------------------------------------------------------------
Revision history of FatFs module Revision history of FatFs module
---------------------------------------------------------------------------- ----------------------------------------------------------------------------
R0.00 (February 26, 2006) R0.00 (February 26, 2006)
Prototype. Prototype.
R0.01 (April 29, 2006) R0.01 (April 29, 2006)
The first release. The first release.
R0.02 (June 01, 2006) R0.02 (June 01, 2006)
Added FAT12 support. Added FAT12 support.
Removed unbuffered mode. Removed unbuffered mode.
Fixed a problem on small (<32M) partition. Fixed a problem on small (<32M) partition.
R0.02a (June 10, 2006) R0.02a (June 10, 2006)
Added a configuration option (_FS_MINIMUM). Added a configuration option (_FS_MINIMUM).
R0.03 (September 22, 2006) R0.03 (September 22, 2006)
Added f_rename(). Added f_rename().
Changed option _FS_MINIMUM to _FS_MINIMIZE. Changed option _FS_MINIMUM to _FS_MINIMIZE.
R0.03a (December 11, 2006) R0.03a (December 11, 2006)
Improved cluster scan algorithm to write files fast. Improved cluster scan algorithm to write files fast.
Fixed f_mkdir() creates incorrect directory on FAT32. Fixed f_mkdir() creates incorrect directory on FAT32.
R0.04 (February 04, 2007) R0.04 (February 04, 2007)
Added f_mkfs(). Added f_mkfs().
Supported multiple drive system. Supported multiple drive system.
Changed some interfaces for multiple drive system. Changed some interfaces for multiple drive system.
Changed f_mountdrv() to f_mount(). Changed f_mountdrv() to f_mount().
R0.04a (April 01, 2007) R0.04a (April 01, 2007)
Supported multiple partitions on a physical drive. Supported multiple partitions on a physical drive.
Added a capability of extending file size to f_lseek(). Added a capability of extending file size to f_lseek().
Added minimization level 3. Added minimization level 3.
Fixed an endian sensitive code in f_mkfs(). Fixed an endian sensitive code in f_mkfs().
R0.04b (May 05, 2007) R0.04b (May 05, 2007)
Added a configuration option _USE_NTFLAG. Added a configuration option _USE_NTFLAG.
Added FSINFO support. Added FSINFO support.
Fixed DBCS name can result FR_INVALID_NAME. Fixed DBCS name can result FR_INVALID_NAME.
Fixed short seek (<= csize) collapses the file object. Fixed short seek (<= csize) collapses the file object.
R0.05 (August 25, 2007) R0.05 (August 25, 2007)
Changed arguments of f_read(), f_write() and f_mkfs(). Changed arguments of f_read(), f_write() and f_mkfs().
Fixed f_mkfs() on FAT32 creates incorrect FSINFO. Fixed f_mkfs() on FAT32 creates incorrect FSINFO.
Fixed f_mkdir() on FAT32 creates incorrect directory. Fixed f_mkdir() on FAT32 creates incorrect directory.
R0.05a (February 03, 2008) R0.05a (February 03, 2008)
Added f_truncate() and f_utime(). Added f_truncate() and f_utime().
Fixed off by one error at FAT sub-type determination. Fixed off by one error at FAT sub-type determination.
Fixed btr in f_read() can be mistruncated. Fixed btr in f_read() can be mistruncated.
Fixed cached sector is not flushed when create and close without write. Fixed cached sector is not flushed when create and close without write.
R0.06 (April 01, 2008) R0.06 (April 01, 2008)
Added fputc(), fputs(), fprintf() and fgets(). Added fputc(), fputs(), fprintf() and fgets().
Improved performance of f_lseek() on moving to the same or following cluster. Improved performance of f_lseek() on moving to the same or following cluster.
R0.07 (April 01, 2009) R0.07 (April 01, 2009)
Merged Tiny-FatFs as a configuration option. (_FS_TINY) Merged Tiny-FatFs as a configuration option. (_FS_TINY)
Added long file name feature. (_USE_LFN) Added long file name feature. (_USE_LFN)
Added multiple code page feature. (_CODE_PAGE) Added multiple code page feature. (_CODE_PAGE)
Added re-entrancy for multitask operation. (_FS_REENTRANT) Added re-entrancy for multitask operation. (_FS_REENTRANT)
Added auto cluster size selection to f_mkfs(). Added auto cluster size selection to f_mkfs().
Added rewind option to f_readdir(). Added rewind option to f_readdir().
Changed result code of critical errors. Changed result code of critical errors.
Renamed string functions to avoid name collision. Renamed string functions to avoid name collision.
R0.07a (April 14, 2009) R0.07a (April 14, 2009)
Septemberarated out OS dependent code on reentrant cfg. Septemberarated out OS dependent code on reentrant cfg.
Added multiple sector size feature. Added multiple sector size feature.
R0.07c (June 21, 2009) R0.07c (June 21, 2009)
Fixed f_unlink() can return FR_OK on error. Fixed f_unlink() can return FR_OK on error.
Fixed wrong cache control in f_lseek(). Fixed wrong cache control in f_lseek().
Added relative path feature. Added relative path feature.
Added f_chdir() and f_chdrive(). Added f_chdir() and f_chdrive().
Added proper case conversion to extended character. Added proper case conversion to extended character.
R0.07e (November 03, 2009) R0.07e (November 03, 2009)
Septemberarated out configuration options from ff.h to ffconf.h. Septemberarated out configuration options from ff.h to ffconf.h.
Fixed f_unlink() fails to remove a sub-directory on _FS_RPATH. Fixed f_unlink() fails to remove a sub-directory on _FS_RPATH.
Fixed name matching error on the 13 character boundary. Fixed name matching error on the 13 character boundary.
Added a configuration option, _LFN_UNICODE. Added a configuration option, _LFN_UNICODE.
Changed f_readdir() to return the SFN with always upper case on non-LFN cfg. Changed f_readdir() to return the SFN with always upper case on non-LFN cfg.
R0.08 (May 15, 2010) R0.08 (May 15, 2010)
Added a memory configuration option. (_USE_LFN = 3) Added a memory configuration option. (_USE_LFN = 3)
Added file lock feature. (_FS_SHARE) Added file lock feature. (_FS_SHARE)
Added fast seek feature. (_USE_FASTSEEK) Added fast seek feature. (_USE_FASTSEEK)
Changed some types on the API, XCHAR->TCHAR. Changed some types on the API, XCHAR->TCHAR.
Changed .fname in the FILINFO structure on Unicode cfg. Changed .fname in the FILINFO structure on Unicode cfg.
String functions support UTF-8 encoding files on Unicode cfg. String functions support UTF-8 encoding files on Unicode cfg.
R0.08a (August 16, 2010) R0.08a (August 16, 2010)
Added f_getcwd(). (_FS_RPATH = 2) Added f_getcwd(). (_FS_RPATH = 2)
Added sector erase feature. (_USE_ERASE) Added sector erase feature. (_USE_ERASE)
Moved file lock semaphore table from fs object to the bss. Moved file lock semaphore table from fs object to the bss.
Fixed f_mkfs() creates wrong FAT32 volume. Fixed f_mkfs() creates wrong FAT32 volume.
R0.08b (January 15, 2011) R0.08b (January 15, 2011)
Fast seek feature is also applied to f_read() and f_write(). Fast seek feature is also applied to f_read() and f_write().
f_lseek() reports required table size on creating CLMP. f_lseek() reports required table size on creating CLMP.
Extended format syntax of f_printf(). Extended format syntax of f_printf().
Ignores duplicated directory separators in given path name. Ignores duplicated directory separators in given path name.
R0.09 (September 06, 2011) R0.09 (September 06, 2011)
f_mkfs() supports multiple partition to complete the multiple partition feature. f_mkfs() supports multiple partition to complete the multiple partition feature.
Added f_fdisk(). Added f_fdisk().
R0.09a (August 27, 2012) R0.09a (August 27, 2012)
Changed f_open() and f_opendir() reject null object pointer to avoid crash. Changed f_open() and f_opendir() reject null object pointer to avoid crash.
Changed option name _FS_SHARE to _FS_LOCK. Changed option name _FS_SHARE to _FS_LOCK.
Fixed assertion failure due to OS/2 EA on FAT12/16 volume. Fixed assertion failure due to OS/2 EA on FAT12/16 volume.
R0.09b (January 24, 2013) R0.09b (January 24, 2013)
Added f_setlabel() and f_getlabel(). Added f_setlabel() and f_getlabel().
R0.10 (October 02, 2013) R0.10 (October 02, 2013)
Added selection of character encoding on the file. (_STRF_ENCODE) Added selection of character encoding on the file. (_STRF_ENCODE)
Added f_closedir(). Added f_closedir().
Added forced full FAT scan for f_getfree(). (_FS_NOFSINFO) Added forced full FAT scan for f_getfree(). (_FS_NOFSINFO)
Added forced mount feature with changes of f_mount(). Added forced mount feature with changes of f_mount().
Improved behavior of volume auto detection. Improved behavior of volume auto detection.
Improved write throughput of f_puts() and f_printf(). Improved write throughput of f_puts() and f_printf().
Changed argument of f_chdrive(), f_mkfs(), disk_read() and disk_write(). Changed argument of f_chdrive(), f_mkfs(), disk_read() and disk_write().
Fixed f_write() can be truncated when the file size is close to 4GB. Fixed f_write() can be truncated when the file size is close to 4GB.
Fixed f_open(), f_mkdir() and f_setlabel() can return incorrect value on error. Fixed f_open(), f_mkdir() and f_setlabel() can return incorrect value on error.
R0.10a (January 15, 2014) R0.10a (January 15, 2014)
Added arbitrary strings as drive number in the path name. (_STR_VOLUME_ID) Added arbitrary strings as drive number in the path name. (_STR_VOLUME_ID)
Added a configuration option of minimum sector size. (_MIN_SS) Added a configuration option of minimum sector size. (_MIN_SS)
2nd argument of f_rename() can have a drive number and it will be ignored. 2nd argument of f_rename() can have a drive number and it will be ignored.
Fixed f_mount() with forced mount fails when drive number is >= 1. (appeared at R0.10) Fixed f_mount() with forced mount fails when drive number is >= 1. (appeared at R0.10)
Fixed f_close() invalidates the file object without volume lock. Fixed f_close() invalidates the file object without volume lock.
Fixed f_closedir() returns but the volume lock is left acquired. (appeared at R0.10) Fixed f_closedir() returns but the volume lock is left acquired. (appeared at R0.10)
Fixed creation of an entry with LFN fails on too many SFN collisions. (appeared at R0.07) Fixed creation of an entry with LFN fails on too many SFN collisions. (appeared at R0.07)
R0.10b (May 19, 2014) R0.10b (May 19, 2014)
Fixed a hard error in the disk I/O layer can collapse the directory entry. Fixed a hard error in the disk I/O layer can collapse the directory entry.
Fixed LFN entry is not deleted when delete/rename an object with lossy converted SFN. (appeared at R0.07) Fixed LFN entry is not deleted when delete/rename an object with lossy converted SFN. (appeared at R0.07)
R0.10c (November 09, 2014) R0.10c (November 09, 2014)
Added a configuration option for the platforms without RTC. (_FS_NORTC) Added a configuration option for the platforms without RTC. (_FS_NORTC)
Changed option name _USE_ERASE to _USE_TRIM. Changed option name _USE_ERASE to _USE_TRIM.
Fixed volume label created by Mac OS X cannot be retrieved with f_getlabel(). (appeared at R0.09b) Fixed volume label created by Mac OS X cannot be retrieved with f_getlabel(). (appeared at R0.09b)
Fixed a potential problem of FAT access that can appear on disk error. Fixed a potential problem of FAT access that can appear on disk error.
Fixed null pointer dereference on attempting to delete the root direcotry. (appeared at R0.08) Fixed null pointer dereference on attempting to delete the root direcotry. (appeared at R0.08)
R0.11 (February 09, 2015) R0.11 (February 09, 2015)
Added f_findfirst(), f_findnext() and f_findclose(). (_USE_FIND) Added f_findfirst(), f_findnext() and f_findclose(). (_USE_FIND)
Fixed f_unlink() does not remove cluster chain of the file. (appeared at R0.10c) Fixed f_unlink() does not remove cluster chain of the file. (appeared at R0.10c)
Fixed _FS_NORTC option does not work properly. (appeared at R0.10c) Fixed _FS_NORTC option does not work properly. (appeared at R0.10c)
R0.11a (September 05, 2015) R0.11a (September 05, 2015)
Fixed wrong media change can lead a deadlock at thread-safe configuration. Fixed wrong media change can lead a deadlock at thread-safe configuration.
Added code page 771, 860, 861, 863, 864, 865 and 869. (_CODE_PAGE) Added code page 771, 860, 861, 863, 864, 865 and 869. (_CODE_PAGE)
Removed some code pages actually not exist on the standard systems. (_CODE_PAGE) Removed some code pages actually not exist on the standard systems. (_CODE_PAGE)
Fixed errors in the case conversion teble of code page 437 and 850 (ff.c). Fixed errors in the case conversion teble of code page 437 and 850 (ff.c).
Fixed errors in the case conversion teble of Unicode (cc*.c). Fixed errors in the case conversion teble of Unicode (cc*.c).
R0.12 (April 12, 2016) R0.12 (April 12, 2016)
Added support for exFAT file system. (_FS_EXFAT) Added support for exFAT file system. (_FS_EXFAT)
Added f_expand(). (_USE_EXPAND) Added f_expand(). (_USE_EXPAND)
Changed some members in FINFO structure and behavior of f_readdir(). Changed some members in FINFO structure and behavior of f_readdir().
Added an option _USE_CHMOD. Added an option _USE_CHMOD.
Removed an option _WORD_ACCESS. Removed an option _WORD_ACCESS.
Fixed errors in the case conversion table of Unicode (cc*.c). Fixed errors in the case conversion table of Unicode (cc*.c).
R0.12a (July 10, 2016) R0.12a (July 10, 2016)
Added support for creating exFAT volume with some changes of f_mkfs(). Added support for creating exFAT volume with some changes of f_mkfs().
Added a file open method FA_OPEN_APPEND. An f_lseek() following f_open() is no longer needed. Added a file open method FA_OPEN_APPEND. An f_lseek() following f_open() is no longer needed.
f_forward() is available regardless of _FS_TINY. f_forward() is available regardless of _FS_TINY.
Fixed f_mkfs() creates wrong volume. (appeared at R0.12) Fixed f_mkfs() creates wrong volume. (appeared at R0.12)
Fixed wrong memory read in create_name(). (appeared at R0.12) Fixed wrong memory read in create_name(). (appeared at R0.12)
Fixed compilation fails at some configurations, _USE_FASTSEEK and _USE_FORWARD. Fixed compilation fails at some configurations, _USE_FASTSEEK and _USE_FORWARD.
R0.12b (September 04, 2016) R0.12b (September 04, 2016)
Made f_rename() be able to rename objects with the same name but case. Made f_rename() be able to rename objects with the same name but case.
Fixed an error in the case conversion teble of code page 866. (ff.c) Fixed an error in the case conversion teble of code page 866. (ff.c)
Fixed writing data is truncated at the file offset 4GiB on the exFAT volume. (appeared at R0.12) Fixed writing data is truncated at the file offset 4GiB on the exFAT volume. (appeared at R0.12)
Fixed creating a file in the root directory of exFAT volume can fail. (appeared at R0.12) Fixed creating a file in the root directory of exFAT volume can fail. (appeared at R0.12)
Fixed f_mkfs() creating exFAT volume with too small cluster size can collapse unallocated memory. (appeared at R0.12) Fixed f_mkfs() creating exFAT volume with too small cluster size can collapse unallocated memory. (appeared at R0.12)
Fixed wrong object name can be returned when read directory at Unicode cfg. (appeared at R0.12) Fixed wrong object name can be returned when read directory at Unicode cfg. (appeared at R0.12)
Fixed large file allocation/removing on the exFAT volume collapses allocation bitmap. (appeared at R0.12) Fixed large file allocation/removing on the exFAT volume collapses allocation bitmap. (appeared at R0.12)
Fixed some internal errors in f_expand() and f_lseek(). (appeared at R0.12) Fixed some internal errors in f_expand() and f_lseek(). (appeared at R0.12)
R0.12c (March 04, 2017) R0.12c (March 04, 2017)
Improved write throughput at the fragmented file on the exFAT volume. Improved write throughput at the fragmented file on the exFAT volume.
Made memory usage for exFAT be able to be reduced as decreasing _MAX_LFN. Made memory usage for exFAT be able to be reduced as decreasing _MAX_LFN.
Fixed successive f_getfree() can return wrong count on the FAT12/16 volume. (appeared at R0.12) Fixed successive f_getfree() can return wrong count on the FAT12/16 volume. (appeared at R0.12)
Fixed configuration option _VOLUMES cannot be set 10. (appeared at R0.10c) Fixed configuration option _VOLUMES cannot be set 10. (appeared at R0.10c)
R0.13 (May 21, 2017) R0.13 (May 21, 2017)
Changed heading character of configuration keywords "_" to "FF_". Changed heading character of configuration keywords "_" to "FF_".
Removed ASCII-only configuration, FF_CODE_PAGE = 1. Use FF_CODE_PAGE = 437 instead. Removed ASCII-only configuration, FF_CODE_PAGE = 1. Use FF_CODE_PAGE = 437 instead.
Added f_setcp(), run-time code page configuration. (FF_CODE_PAGE = 0) Added f_setcp(), run-time code page configuration. (FF_CODE_PAGE = 0)
Improved cluster allocation time on stretch a deep buried cluster chain. Improved cluster allocation time on stretch a deep buried cluster chain.
Improved processing time of f_mkdir() with large cluster size by using FF_USE_LFN = 3. Improved processing time of f_mkdir() with large cluster size by using FF_USE_LFN = 3.
Improved NoFatChain flag of the fragmented file to be set after it is truncated and got contiguous. Improved NoFatChain flag of the fragmented file to be set after it is truncated and got contiguous.
Fixed archive attribute is left not set when a file on the exFAT volume is renamed. (appeared at R0.12) Fixed archive attribute is left not set when a file on the exFAT volume is renamed. (appeared at R0.12)
Fixed exFAT FAT entry can be collapsed when write or lseek operation to the existing file is done. (appeared at R0.12c) Fixed exFAT FAT entry can be collapsed when write or lseek operation to the existing file is done. (appeared at R0.12c)
Fixed creating a file can fail when a new cluster allocation to the exFAT directory occures. (appeared at R0.12c) Fixed creating a file can fail when a new cluster allocation to the exFAT directory occures. (appeared at R0.12c)
R0.13a (October 14, 2017) R0.13a (October 14, 2017)
Added support for UTF-8 encoding on the API. (FF_LFN_UNICODE = 2) Added support for UTF-8 encoding on the API. (FF_LFN_UNICODE = 2)
Added options for file name output buffer. (FF_LFN_BUF, FF_SFN_BUF). Added options for file name output buffer. (FF_LFN_BUF, FF_SFN_BUF).
Added dynamic memory allocation option for working buffer of f_mkfs() and f_fdisk(). Added dynamic memory allocation option for working buffer of f_mkfs() and f_fdisk().
Fixed f_fdisk() and f_mkfs() create the partition table with wrong CHS parameters. (appeared at R0.09) Fixed f_fdisk() and f_mkfs() create the partition table with wrong CHS parameters. (appeared at R0.09)
Fixed f_unlink() can cause lost clusters at fragmented file on the exFAT volume. (appeared at R0.12c) Fixed f_unlink() can cause lost clusters at fragmented file on the exFAT volume. (appeared at R0.12c)
Fixed f_setlabel() rejects some valid characters for exFAT volume. (appeared at R0.12) Fixed f_setlabel() rejects some valid characters for exFAT volume. (appeared at R0.12)
R0.13b (April 07, 2018) R0.13b (April 07, 2018)
Added support for UTF-32 encoding on the API. (FF_LFN_UNICODE = 3) Added support for UTF-32 encoding on the API. (FF_LFN_UNICODE = 3)
Added support for Unix style volume ID. (FF_STR_VOLUME_ID = 2) Added support for Unix style volume ID. (FF_STR_VOLUME_ID = 2)
Fixed accesing any object on the exFAT root directory beyond the cluster boundary can fail. (appeared at R0.12c) Fixed accesing any object on the exFAT root directory beyond the cluster boundary can fail. (appeared at R0.12c)
Fixed f_setlabel() does not reject some invalid characters. (appeared at R0.09b) Fixed f_setlabel() does not reject some invalid characters. (appeared at R0.09b)
R0.13c (October 14, 2018)
Supported stdint.h for C99 and later. (integer.h was included in ff.h)
Fixed reading a directory gets infinite loop when the last directory entry is not empty. (appeared at R0.12)
Fixed creating a sub-directory in the fragmented sub-directory on the exFAT volume collapses FAT chain of the parent directory. (appeared at R0.12)
Fixed f_getcwd() cause output buffer overrun when the buffer has a valid drive number. (appeared at R0.13b)

View File

@ -1,22 +1,21 @@
FatFs Module Source Files R0.13b FatFs Module Source Files R0.13c
FILES FILES
00readme.txt This file. 00readme.txt This file.
00history.txt Revision history. 00history.txt Revision history.
ff.c FatFs module. ff.c FatFs module.
ffconf.h Configuration file of FatFs module. ffconf.h Configuration file of FatFs module.
ff.h Common include file for FatFs and application module. ff.h Common include file for FatFs and application module.
diskio.h Common include file for FatFs and disk I/O module. diskio.h Common include file for FatFs and disk I/O module.
diskio.c An example of glue function to attach existing disk I/O module to FatFs. diskio.c An example of glue function to attach existing disk I/O module to FatFs.
integer.h Integer type definitions for FatFs. ffunicode.c Optional Unicode utility functions.
ffunicode.c Optional Unicode utility functions. ffsystem.c An example of optional O/S related functions.
ffsystem.c An example of optional O/S related functions.
Low level disk I/O module is not included in this archive because the FatFs
Low level disk I/O module is not included in this archive because the FatFs module is only a generic file system layer and it does not depend on any specific
module is only a generic file system layer and it does not depend on any specific storage device. You need to provide a low level disk I/O module written to
storage device. You need to provide a low level disk I/O module written to control the storage device that attached to the target system.
control the storage device that attached to the target system.

View File

@ -1,121 +1,125 @@
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* Low level disk I/O module skeleton for FatFs (C)ChaN, 2016 */ /* Low level disk I/O module skeleton for FatFs (C)ChaN, 2016 */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* If a working storage control module is available, it should be */ /* If a working storage control module is available, it should be */
/* attached to the FatFs via a glue function rather than modifying it. */ /* attached to the FatFs via a glue function rather than modifying it. */
/* This is an example of glue functions to attach various exsisting */ /* This is an example of glue functions to attach various exsisting */
/* storage control modules to the FatFs module with a defined API. */ /* storage control modules to the FatFs module with a defined API. */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
#include <stdbool.h> #include <stdbool.h>
#include <string.h> #include <string.h>
#include "diskio.h" /* FatFs lower layer API */ #include "ff.h" /* Obtains integer types */
#include "ffconf.h" #include "diskio.h" /* Declarations of disk functions */
#include "../../device_partition.h" #include "ffconf.h"
#include "../../device_partition.h"
/* fs_dev.c */
extern device_partition_t *g_volume_to_devparts[FF_VOLUMES]; /* fs_dev.c */
extern device_partition_t *g_volume_to_devparts[FF_VOLUMES];
/*-----------------------------------------------------------------------*/
/* Get Drive Status */ /*-----------------------------------------------------------------------*/
/*-----------------------------------------------------------------------*/ /* Get Drive Status */
/*-----------------------------------------------------------------------*/
DSTATUS disk_status (
BYTE pdrv /* Physical drive nmuber to identify the drive */ DSTATUS disk_status (
) BYTE pdrv /* Physical drive nmuber to identify the drive */
{ )
device_partition_t *devpart = g_volume_to_devparts[pdrv]; {
if (devpart) device_partition_t *devpart = g_volume_to_devparts[pdrv];
return devpart->initialized ? RES_OK : STA_NOINIT; if (devpart)
else return devpart->initialized ? RES_OK : STA_NOINIT;
return STA_NODISK; else
} return STA_NODISK;
}
/*-----------------------------------------------------------------------*/
/* Inidialize a Drive */ /*-----------------------------------------------------------------------*/
/*-----------------------------------------------------------------------*/ /* Inidialize a Drive */
/*-----------------------------------------------------------------------*/
DSTATUS disk_initialize (
BYTE pdrv /* Physical drive nmuber to identify the drive */ DSTATUS disk_initialize (
) BYTE pdrv /* Physical drive nmuber to identify the drive */
{ )
/* We aren't using FF_MULTI_PARTITION, so pdrv = volume id. */ {
device_partition_t *devpart = g_volume_to_devparts[pdrv]; /* We aren't using FF_MULTI_PARTITION, so pdrv = volume id. */
if (!devpart) device_partition_t *devpart = g_volume_to_devparts[pdrv];
return STA_NODISK; if (!devpart)
else if (devpart->initializer) return STA_NODISK;
return devpart->initializer(devpart) ? STA_NOINIT : RES_OK; else if (devpart->initializer)
else return devpart->initializer(devpart) ? STA_NOINIT : RES_OK;
return RES_OK; else
} return RES_OK;
}
/*-----------------------------------------------------------------------*/
/* Read Sector(s) */ /*-----------------------------------------------------------------------*/
/*-----------------------------------------------------------------------*/ /* Read Sector(s) */
/*-----------------------------------------------------------------------*/
DRESULT disk_read (
BYTE pdrv, /* Physical drive nmuber to identify the drive */ DRESULT disk_read (
BYTE *buff, /* Data buffer to store read data */ BYTE pdrv, /* Physical drive nmuber to identify the drive */
DWORD sector, /* Start sector in LBA */ BYTE *buff, /* Data buffer to store read data */
UINT count /* Number of sectors to read */ DWORD sector, /* Start sector in LBA */
) UINT count /* Number of sectors to read */
{ )
/* We aren't using FF_MULTI_PARTITION, so pdrv = volume id. */ {
device_partition_t *devpart = g_volume_to_devparts[pdrv]; /* We aren't using FF_MULTI_PARTITION, so pdrv = volume id. */
if (!devpart) device_partition_t *devpart = g_volume_to_devparts[pdrv];
return RES_PARERR; if (!devpart)
else if (devpart->reader) return RES_PARERR;
return device_partition_read_data(devpart, buff, sector, count) ? RES_ERROR : RES_OK; else if (devpart->reader)
else return device_partition_read_data(devpart, buff, sector, count) ? RES_ERROR : RES_OK;
return RES_ERROR; else
} return RES_ERROR;
}
/*-----------------------------------------------------------------------*/
/* Write Sector(s) */ /*-----------------------------------------------------------------------*/
/*-----------------------------------------------------------------------*/ /* Write Sector(s) */
/*-----------------------------------------------------------------------*/
DRESULT disk_write (
BYTE pdrv, /* Physical drive nmuber to identify the drive */ #if FF_FS_READONLY == 0
const BYTE *buff, /* Data to be written */
DWORD sector, /* Start sector in LBA */ DRESULT disk_write (
UINT count /* Number of sectors to write */ BYTE pdrv, /* Physical drive nmuber to identify the drive */
) const BYTE *buff, /* Data to be written */
{ DWORD sector, /* Start sector in LBA */
/* We aren't using FF_MULTI_PARTITION, so pdrv = volume id. */ UINT count /* Number of sectors to write */
device_partition_t *devpart = g_volume_to_devparts[pdrv]; )
if (!devpart) {
return RES_PARERR; /* We aren't using FF_MULTI_PARTITION, so pdrv = volume id. */
else if (devpart->writer) device_partition_t *devpart = g_volume_to_devparts[pdrv];
return device_partition_write_data(devpart, buff, sector, count) ? RES_ERROR : RES_OK; if (!devpart)
else return RES_PARERR;
return RES_ERROR; else if (devpart->writer)
} return device_partition_write_data(devpart, buff, sector, count) ? RES_ERROR : RES_OK;
else
return RES_ERROR;
}
/*-----------------------------------------------------------------------*/
/* Miscellaneous Functions */ #endif
/*-----------------------------------------------------------------------*/
DRESULT disk_ioctl ( /*-----------------------------------------------------------------------*/
BYTE pdrv, /* Physical drive nmuber (0..) */ /* Miscellaneous Functions */
BYTE cmd, /* Control code */ /*-----------------------------------------------------------------------*/
void *buff /* Buffer to send/receive control data */
) DRESULT disk_ioctl (
{ BYTE pdrv, /* Physical drive nmuber (0..) */
device_partition_t *devpart = g_volume_to_devparts[pdrv]; BYTE cmd, /* Control code */
switch (cmd) { void *buff /* Buffer to send/receive control data */
case GET_SECTOR_SIZE: )
*(WORD *)buff = devpart ? (WORD)devpart->sector_size : 512; {
return RES_OK; device_partition_t *devpart = g_volume_to_devparts[pdrv];
default: switch (cmd) {
return RES_OK; case GET_SECTOR_SIZE:
} *(WORD *)buff = devpart ? (WORD)devpart->sector_size : 512;
} return RES_OK;
default:
return RES_OK;
}
}

View File

@ -1,80 +1,77 @@
/*-----------------------------------------------------------------------/ /*-----------------------------------------------------------------------/
/ Low level disk interface modlue include file (C)ChaN, 2014 / / Low level disk interface modlue include file (C)ChaN, 2014 /
/-----------------------------------------------------------------------*/ /-----------------------------------------------------------------------*/
#ifndef _DISKIO_DEFINED #ifndef _DISKIO_DEFINED
#define _DISKIO_DEFINED #define _DISKIO_DEFINED
#ifdef __cplusplus #ifdef __cplusplus
extern "C" { extern "C" {
#endif #endif
#include "integer.h" /* Status of Disk Functions */
typedef BYTE DSTATUS;
/* Status of Disk Functions */ /* Results of Disk Functions */
typedef BYTE DSTATUS; typedef enum {
RES_OK = 0, /* 0: Successful */
/* Results of Disk Functions */ RES_ERROR, /* 1: R/W Error */
typedef enum { RES_WRPRT, /* 2: Write Protected */
RES_OK = 0, /* 0: Successful */ RES_NOTRDY, /* 3: Not Ready */
RES_ERROR, /* 1: R/W Error */ RES_PARERR /* 4: Invalid Parameter */
RES_WRPRT, /* 2: Write Protected */ } DRESULT;
RES_NOTRDY, /* 3: Not Ready */
RES_PARERR /* 4: Invalid Parameter */
} DRESULT; /*---------------------------------------*/
/* Prototypes for disk control functions */
/*---------------------------------------*/
/* Prototypes for disk control functions */ DSTATUS disk_initialize (BYTE pdrv);
DSTATUS disk_status (BYTE pdrv);
DRESULT disk_read (BYTE pdrv, BYTE* buff, DWORD sector, UINT count);
DSTATUS disk_initialize (BYTE pdrv); DRESULT disk_write (BYTE pdrv, const BYTE* buff, DWORD sector, UINT count);
DSTATUS disk_status (BYTE pdrv); DRESULT disk_ioctl (BYTE pdrv, BYTE cmd, void* buff);
DRESULT disk_read (BYTE pdrv, BYTE* buff, DWORD sector, UINT count);
DRESULT disk_write (BYTE pdrv, const BYTE* buff, DWORD sector, UINT count);
DRESULT disk_ioctl (BYTE pdrv, BYTE cmd, void* buff); /* Disk Status Bits (DSTATUS) */
#define STA_NOINIT 0x01 /* Drive not initialized */
/* Disk Status Bits (DSTATUS) */ #define STA_NODISK 0x02 /* No medium in the drive */
#define STA_PROTECT 0x04 /* Write protected */
#define STA_NOINIT 0x01 /* Drive not initialized */
#define STA_NODISK 0x02 /* No medium in the drive */
#define STA_PROTECT 0x04 /* Write protected */ /* Command code for disk_ioctrl fucntion */
/* Generic command (Used by FatFs) */
/* Command code for disk_ioctrl fucntion */ #define CTRL_SYNC 0 /* Complete pending write process (needed at FF_FS_READONLY == 0) */
#define GET_SECTOR_COUNT 1 /* Get media size (needed at FF_USE_MKFS == 1) */
/* Generic command (Used by FatFs) */ #define GET_SECTOR_SIZE 2 /* Get sector size (needed at FF_MAX_SS != FF_MIN_SS) */
#define CTRL_SYNC 0 /* Complete pending write process (needed at FF_FS_READONLY == 0) */ #define GET_BLOCK_SIZE 3 /* Get erase block size (needed at FF_USE_MKFS == 1) */
#define GET_SECTOR_COUNT 1 /* Get media size (needed at FF_USE_MKFS == 1) */ #define CTRL_TRIM 4 /* Inform device that the data on the block of sectors is no longer used (needed at FF_USE_TRIM == 1) */
#define GET_SECTOR_SIZE 2 /* Get sector size (needed at FF_MAX_SS != FF_MIN_SS) */
#define GET_BLOCK_SIZE 3 /* Get erase block size (needed at FF_USE_MKFS == 1) */ /* Generic command (Not used by FatFs) */
#define CTRL_TRIM 4 /* Inform device that the data on the block of sectors is no longer used (needed at FF_USE_TRIM == 1) */ #define CTRL_POWER 5 /* Get/Set power status */
#define CTRL_LOCK 6 /* Lock/Unlock media removal */
/* Generic command (Not used by FatFs) */ #define CTRL_EJECT 7 /* Eject media */
#define CTRL_POWER 5 /* Get/Set power status */ #define CTRL_FORMAT 8 /* Create physical format on the media */
#define CTRL_LOCK 6 /* Lock/Unlock media removal */
#define CTRL_EJECT 7 /* Eject media */ /* MMC/SDC specific ioctl command */
#define CTRL_FORMAT 8 /* Create physical format on the media */ #define MMC_GET_TYPE 10 /* Get card type */
#define MMC_GET_CSD 11 /* Get CSD */
/* MMC/SDC specific ioctl command */ #define MMC_GET_CID 12 /* Get CID */
#define MMC_GET_TYPE 10 /* Get card type */ #define MMC_GET_OCR 13 /* Get OCR */
#define MMC_GET_CSD 11 /* Get CSD */ #define MMC_GET_SDSTAT 14 /* Get SD status */
#define MMC_GET_CID 12 /* Get CID */ #define ISDIO_READ 55 /* Read data form SD iSDIO register */
#define MMC_GET_OCR 13 /* Get OCR */ #define ISDIO_WRITE 56 /* Write data to SD iSDIO register */
#define MMC_GET_SDSTAT 14 /* Get SD status */ #define ISDIO_MRITE 57 /* Masked write data to SD iSDIO register */
#define ISDIO_READ 55 /* Read data form SD iSDIO register */
#define ISDIO_WRITE 56 /* Write data to SD iSDIO register */ /* ATA/CF specific ioctl command */
#define ISDIO_MRITE 57 /* Masked write data to SD iSDIO register */ #define ATA_GET_REV 20 /* Get F/W revision */
#define ATA_GET_MODEL 21 /* Get model name */
/* ATA/CF specific ioctl command */ #define ATA_GET_SN 22 /* Get serial number */
#define ATA_GET_REV 20 /* Get F/W revision */
#define ATA_GET_MODEL 21 /* Get model name */ #ifdef __cplusplus
#define ATA_GET_SN 22 /* Get serial number */ }
#endif
#ifdef __cplusplus
} #endif
#endif
#endif

File diff suppressed because it is too large Load Diff

View File

@ -1,376 +1,405 @@
/*----------------------------------------------------------------------------/ /*----------------------------------------------------------------------------/
/ FatFs - Generic FAT Filesystem module R0.13b / / FatFs - Generic FAT Filesystem module R0.13c /
/-----------------------------------------------------------------------------/ /-----------------------------------------------------------------------------/
/ /
/ Copyright (C) 2018, ChaN, all right reserved. / Copyright (C) 2018, ChaN, all right reserved.
/ /
/ FatFs module is an open source software. Redistribution and use of FatFs in / FatFs module is an open source software. Redistribution and use of FatFs in
/ source and binary forms, with or without modification, are permitted provided / source and binary forms, with or without modification, are permitted provided
/ that the following condition is met: / that the following condition is met:
/ 1. Redistributions of source code must retain the above copyright notice, / 1. Redistributions of source code must retain the above copyright notice,
/ this condition and the following disclaimer. / this condition and the following disclaimer.
/ /
/ This software is provided by the copyright holder and contributors "AS IS" / This software is provided by the copyright holder and contributors "AS IS"
/ and any warranties related to this software are DISCLAIMED. / and any warranties related to this software are DISCLAIMED.
/ The copyright owner or contributors be NOT LIABLE for any damages caused / The copyright owner or contributors be NOT LIABLE for any damages caused
/ by use of this software. / by use of this software.
/ /
/----------------------------------------------------------------------------*/ /----------------------------------------------------------------------------*/
#ifndef FF_DEFINED #ifndef FF_DEFINED
#define FF_DEFINED 63463 /* Revision ID */ #define FF_DEFINED 86604 /* Revision ID */
#ifdef __cplusplus #ifdef __cplusplus
extern "C" { extern "C" {
#endif #endif
#include "integer.h" /* Basic integer types */ #include "ffconf.h" /* FatFs configuration options */
#include "ffconf.h" /* FatFs configuration options */
#if FF_DEFINED != FFCONF_DEF
#if FF_DEFINED != FFCONF_DEF #error Wrong configuration file (ffconf.h).
#error Wrong configuration file (ffconf.h). #endif
#endif
/* Integer types used for FatFs API */
/* Definitions of volume management */ #if defined(_WIN32) /* Main development platform */
#define FF_INTDEF 2
#if FF_MULTI_PARTITION /* Multiple partition configuration */ #include <windows.h>
typedef struct { typedef unsigned __int64 QWORD;
BYTE pd; /* Physical drive number */ #elif (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || defined(__cplusplus) /* C99 or later */
BYTE pt; /* Partition: 0:Auto detect, 1-4:Forced partition) */ #define FF_INTDEF 2
} PARTITION; #include <stdint.h>
extern PARTITION VolToPart[]; /* Volume - Partition resolution table */ typedef unsigned int UINT; /* int must be 16-bit or 32-bit */
#endif typedef unsigned char BYTE; /* char must be 8-bit */
typedef uint16_t WORD; /* 16-bit unsigned integer */
#if FF_STR_VOLUME_ID typedef uint16_t WCHAR; /* 16-bit unsigned integer */
#ifndef FF_VOLUME_STRS typedef uint32_t DWORD; /* 32-bit unsigned integer */
extern const char* VolumeStr[FF_VOLUMES]; /* User defied volume ID */ typedef uint64_t QWORD; /* 64-bit unsigned integer */
#endif #else /* Earlier than C99 */
#endif #define FF_INTDEF 1
typedef unsigned int UINT; /* int must be 16-bit or 32-bit */
typedef unsigned char BYTE; /* char must be 8-bit */
typedef unsigned short WORD; /* 16-bit unsigned integer */
/* Type of path name strings on FatFs API */ typedef unsigned short WCHAR; /* 16-bit unsigned integer */
typedef unsigned long DWORD; /* 32-bit unsigned integer */
#ifndef _INC_TCHAR #endif
#define _INC_TCHAR
#if FF_USE_LFN && FF_LFN_UNICODE == 1 /* Unicode in UTF-16 encoding */ /* Definitions of volume management */
typedef WCHAR TCHAR;
#define _T(x) L ## x #if FF_MULTI_PARTITION /* Multiple partition configuration */
#define _TEXT(x) L ## x typedef struct {
#elif FF_USE_LFN && FF_LFN_UNICODE == 2 /* Unicode in UTF-8 encoding */ BYTE pd; /* Physical drive number */
typedef char TCHAR; BYTE pt; /* Partition: 0:Auto detect, 1-4:Forced partition) */
#define _T(x) u8 ## x } PARTITION;
#define _TEXT(x) u8 ## x extern PARTITION VolToPart[]; /* Volume - Partition resolution table */
#elif FF_USE_LFN && FF_LFN_UNICODE == 3 /* Unicode in UTF-32 encoding */ #endif
typedef DWORD TCHAR;
#define _T(x) U ## x #if FF_STR_VOLUME_ID
#define _TEXT(x) U ## x #ifndef FF_VOLUME_STRS
#elif FF_USE_LFN && (FF_LFN_UNICODE < 0 || FF_LFN_UNICODE > 3) extern const char* VolumeStr[FF_VOLUMES]; /* User defied volume ID */
#error Wrong FF_LFN_UNICODE setting #endif
#else /* ANSI/OEM code in SBCS/DBCS */ #endif
typedef char TCHAR;
#define _T(x) x
#define _TEXT(x) x
#endif /* Type of path name strings on FatFs API */
#endif #ifndef _INC_TCHAR
#define _INC_TCHAR
#if FF_USE_LFN && FF_LFN_UNICODE == 1 /* Unicode in UTF-16 encoding */
/* Type of file size variables */ typedef WCHAR TCHAR;
#define _T(x) L ## x
#if FF_FS_EXFAT #define _TEXT(x) L ## x
typedef QWORD FSIZE_t; #elif FF_USE_LFN && FF_LFN_UNICODE == 2 /* Unicode in UTF-8 encoding */
#else typedef char TCHAR;
typedef DWORD FSIZE_t; #define _T(x) u8 ## x
#endif #define _TEXT(x) u8 ## x
#elif FF_USE_LFN && FF_LFN_UNICODE == 3 /* Unicode in UTF-32 encoding */
typedef DWORD TCHAR;
#define _T(x) U ## x
/* Filesystem object structure (FATFS) */ #define _TEXT(x) U ## x
#elif FF_USE_LFN && (FF_LFN_UNICODE < 0 || FF_LFN_UNICODE > 3)
typedef struct { #error Wrong FF_LFN_UNICODE setting
BYTE fs_type; /* Filesystem type (0:N/A) */ #else /* ANSI/OEM code in SBCS/DBCS */
BYTE pdrv; /* Physical drive number */ typedef char TCHAR;
BYTE n_fats; /* Number of FATs (1 or 2) */ #define _T(x) x
BYTE wflag; /* win[] flag (b0:dirty) */ #define _TEXT(x) x
BYTE fsi_flag; /* FSINFO flags (b7:disabled, b0:dirty) */ #endif
WORD id; /* Volume mount ID */
WORD n_rootdir; /* Number of root directory entries (FAT12/16) */ #endif
WORD csize; /* Cluster size [sectors] */
#if FF_MAX_SS != FF_MIN_SS
WORD ssize; /* Sector size (512, 1024, 2048 or 4096) */
#endif /* Type of file size variables */
#if FF_USE_LFN
WCHAR* lfnbuf; /* LFN working buffer */ #if FF_FS_EXFAT
#endif #if FF_INTDEF != 2
#if FF_FS_EXFAT #error exFAT feature wants C99 or later
BYTE* dirbuf; /* Directory entry block scratchpad buffer for exFAT */ #endif
#endif typedef QWORD FSIZE_t;
#if FF_FS_REENTRANT #else
FF_SYNC_t sobj; /* Identifier of sync object */ typedef DWORD FSIZE_t;
#endif #endif
#if !FF_FS_READONLY
DWORD last_clst; /* Last allocated cluster */
DWORD free_clst; /* Number of free clusters */
#endif /* Filesystem object structure (FATFS) */
#if FF_FS_RPATH
DWORD cdir; /* Current directory start cluster (0:root) */ typedef struct {
#if FF_FS_EXFAT BYTE fs_type; /* Filesystem type (0:not mounted) */
DWORD cdc_scl; /* Containing directory start cluster (invalid when cdir is 0) */ BYTE pdrv; /* Associated physical drive */
DWORD cdc_size; /* b31-b8:Size of containing directory, b7-b0: Chain status */ BYTE n_fats; /* Number of FATs (1 or 2) */
DWORD cdc_ofs; /* Offset in the containing directory (invalid when cdir is 0) */ BYTE wflag; /* win[] flag (b0:dirty) */
#endif BYTE fsi_flag; /* FSINFO flags (b7:disabled, b0:dirty) */
#endif WORD id; /* Volume mount ID */
DWORD n_fatent; /* Number of FAT entries (number of clusters + 2) */ WORD n_rootdir; /* Number of root directory entries (FAT12/16) */
DWORD fsize; /* Size of an FAT [sectors] */ WORD csize; /* Cluster size [sectors] */
DWORD volbase; /* Volume base sector */ #if FF_MAX_SS != FF_MIN_SS
DWORD fatbase; /* FAT base sector */ WORD ssize; /* Sector size (512, 1024, 2048 or 4096) */
DWORD dirbase; /* Root directory base sector/cluster */ #endif
DWORD database; /* Data base sector */ #if FF_USE_LFN
DWORD winsect; /* Current sector appearing in the win[] */ WCHAR* lfnbuf; /* LFN working buffer */
BYTE win[FF_MAX_SS]; /* Disk access window for Directory, FAT (and file data at tiny cfg) */ #endif
} FATFS; #if FF_FS_EXFAT
BYTE* dirbuf; /* Directory entry block scratchpad buffer for exFAT */
#endif
#if FF_FS_REENTRANT
/* Object ID and allocation information (FFOBJID) */ FF_SYNC_t sobj; /* Identifier of sync object */
#endif
typedef struct { #if !FF_FS_READONLY
FATFS* fs; /* Pointer to the hosting volume of this object */ DWORD last_clst; /* Last allocated cluster */
WORD id; /* Hosting volume mount ID */ DWORD free_clst; /* Number of free clusters */
BYTE attr; /* Object attribute */ #endif
BYTE stat; /* Object chain status (b1-0: =0:not contiguous, =2:contiguous, =3:flagmented in this session, b2:sub-directory stretched) */ #if FF_FS_RPATH
DWORD sclust; /* Object data start cluster (0:no cluster or root directory) */ DWORD cdir; /* Current directory start cluster (0:root) */
FSIZE_t objsize; /* Object size (valid when sclust != 0) */ #if FF_FS_EXFAT
#if FF_FS_EXFAT DWORD cdc_scl; /* Containing directory start cluster (invalid when cdir is 0) */
DWORD n_cont; /* Size of first fragment - 1 (valid when stat == 3) */ DWORD cdc_size; /* b31-b8:Size of containing directory, b7-b0: Chain status */
DWORD n_frag; /* Size of last fragment needs to be written to FAT (valid when not zero) */ DWORD cdc_ofs; /* Offset in the containing directory (invalid when cdir is 0) */
DWORD c_scl; /* Containing directory start cluster (valid when sclust != 0) */ #endif
DWORD c_size; /* b31-b8:Size of containing directory, b7-b0: Chain status (valid when c_scl != 0) */ #endif
DWORD c_ofs; /* Offset in the containing directory (valid when file object and sclust != 0) */ DWORD n_fatent; /* Number of FAT entries (number of clusters + 2) */
#endif DWORD fsize; /* Size of an FAT [sectors] */
#if FF_FS_LOCK DWORD volbase; /* Volume base sector */
UINT lockid; /* File lock ID origin from 1 (index of file semaphore table Files[]) */ DWORD fatbase; /* FAT base sector */
#endif DWORD dirbase; /* Root directory base sector/cluster */
} FFOBJID; DWORD database; /* Data base sector */
#if FF_FS_EXFAT
DWORD bitbase; /* Allocation bitmap base sector */
#endif
/* File object structure (FIL) */ DWORD winsect; /* Current sector appearing in the win[] */
BYTE win[FF_MAX_SS]; /* Disk access window for Directory, FAT (and file data at tiny cfg) */
typedef struct { } FATFS;
FFOBJID obj; /* Object identifier (must be the 1st member to detect invalid object pointer) */
BYTE flag; /* File status flags */
BYTE err; /* Abort flag (error code) */
FSIZE_t fptr; /* File read/write pointer (Zeroed on file open) */ /* Object ID and allocation information (FFOBJID) */
DWORD clust; /* Current cluster of fpter (invalid when fptr is 0) */
DWORD sect; /* Sector number appearing in buf[] (0:invalid) */ typedef struct {
#if !FF_FS_READONLY FATFS* fs; /* Pointer to the hosting volume of this object */
DWORD dir_sect; /* Sector number containing the directory entry (not used at exFAT) */ WORD id; /* Hosting volume mount ID */
BYTE* dir_ptr; /* Pointer to the directory entry in the win[] (not used at exFAT) */ BYTE attr; /* Object attribute */
#endif BYTE stat; /* Object chain status (b1-0: =0:not contiguous, =2:contiguous, =3:fragmented in this session, b2:sub-directory stretched) */
#if FF_USE_FASTSEEK DWORD sclust; /* Object data start cluster (0:no cluster or root directory) */
DWORD* cltbl; /* Pointer to the cluster link map table (nulled on open, set by application) */ FSIZE_t objsize; /* Object size (valid when sclust != 0) */
#endif #if FF_FS_EXFAT
#if !FF_FS_TINY DWORD n_cont; /* Size of first fragment - 1 (valid when stat == 3) */
BYTE buf[FF_MAX_SS]; /* File private data read/write window */ DWORD n_frag; /* Size of last fragment needs to be written to FAT (valid when not zero) */
#endif DWORD c_scl; /* Containing directory start cluster (valid when sclust != 0) */
} FIL; DWORD c_size; /* b31-b8:Size of containing directory, b7-b0: Chain status (valid when c_scl != 0) */
DWORD c_ofs; /* Offset in the containing directory (valid when file object and sclust != 0) */
#endif
#if FF_FS_LOCK
/* Directory object structure (DIR) */ UINT lockid; /* File lock ID origin from 1 (index of file semaphore table Files[]) */
#endif
typedef struct { } FFOBJID;
FFOBJID obj; /* Object identifier */
DWORD dptr; /* Current read/write offset */
DWORD clust; /* Current cluster */
DWORD sect; /* Current sector (0:Read operation has terminated) */ /* File object structure (FIL) */
BYTE* dir; /* Pointer to the directory item in the win[] */
BYTE fn[12]; /* SFN (in/out) {body[8],ext[3],status[1]} */ typedef struct {
#if FF_USE_LFN FFOBJID obj; /* Object identifier (must be the 1st member to detect invalid object pointer) */
DWORD blk_ofs; /* Offset of current entry block being processed (0xFFFFFFFF:Invalid) */ BYTE flag; /* File status flags */
#endif BYTE err; /* Abort flag (error code) */
#if FF_USE_FIND FSIZE_t fptr; /* File read/write pointer (Zeroed on file open) */
const TCHAR* pat; /* Pointer to the name matching pattern */ DWORD clust; /* Current cluster of fpter (invalid when fptr is 0) */
#endif DWORD sect; /* Sector number appearing in buf[] (0:invalid) */
} DIR; #if !FF_FS_READONLY
DWORD dir_sect; /* Sector number containing the directory entry (not used at exFAT) */
BYTE* dir_ptr; /* Pointer to the directory entry in the win[] (not used at exFAT) */
#endif
/* File information structure (FILINFO) */ #if FF_USE_FASTSEEK
DWORD* cltbl; /* Pointer to the cluster link map table (nulled on open, set by application) */
typedef struct { #endif
FSIZE_t fsize; /* File size */ #if !FF_FS_TINY
WORD fdate; /* Modified date */ BYTE buf[FF_MAX_SS]; /* File private data read/write window */
WORD ftime; /* Modified time */ #endif
BYTE fattrib; /* File attribute */ } FIL;
#if FF_USE_LFN
TCHAR altname[FF_SFN_BUF + 1];/* Altenative file name */
TCHAR fname[FF_LFN_BUF + 1]; /* Primary file name */
#else /* Directory object structure (DIR) */
TCHAR fname[12 + 1]; /* File name */
#endif typedef struct {
} FILINFO; FFOBJID obj; /* Object identifier */
DWORD dptr; /* Current read/write offset */
DWORD clust; /* Current cluster */
DWORD sect; /* Current sector (0:Read operation has terminated) */
/* File function return code (FRESULT) */ BYTE* dir; /* Pointer to the directory item in the win[] */
BYTE fn[12]; /* SFN (in/out) {body[8],ext[3],status[1]} */
typedef enum { #if FF_USE_LFN
FR_OK = 0, /* (0) Succeeded */ DWORD blk_ofs; /* Offset of current entry block being processed (0xFFFFFFFF:Invalid) */
FR_DISK_ERR, /* (1) A hard error occurred in the low level disk I/O layer */ #endif
FR_INT_ERR, /* (2) Assertion failed */ #if FF_USE_FIND
FR_NOT_READY, /* (3) The physical drive cannot work */ const TCHAR* pat; /* Pointer to the name matching pattern */
FR_NO_FILE, /* (4) Could not find the file */ #endif
FR_NO_PATH, /* (5) Could not find the path */ } DIR;
FR_INVALID_NAME, /* (6) The path name format is invalid */
FR_DENIED, /* (7) Access denied due to prohibited access or directory full */
FR_EXIST, /* (8) Access denied due to prohibited access */
FR_INVALID_OBJECT, /* (9) The file/directory object is invalid */ /* File information structure (FILINFO) */
FR_WRITE_PROTECTED, /* (10) The physical drive is write protected */
FR_INVALID_DRIVE, /* (11) The logical drive number is invalid */ typedef struct {
FR_NOT_ENABLED, /* (12) The volume has no work area */ FSIZE_t fsize; /* File size */
FR_NO_FILESYSTEM, /* (13) There is no valid FAT volume */ WORD fdate; /* Modified date */
FR_MKFS_ABORTED, /* (14) The f_mkfs() aborted due to any problem */ WORD ftime; /* Modified time */
FR_TIMEOUT, /* (15) Could not get a grant to access the volume within defined period */ BYTE fattrib; /* File attribute */
FR_LOCKED, /* (16) The operation is rejected according to the file sharing policy */ #if FF_USE_LFN
FR_NOT_ENOUGH_CORE, /* (17) LFN working buffer could not be allocated */ TCHAR altname[FF_SFN_BUF + 1];/* Altenative file name */
FR_TOO_MANY_OPEN_FILES, /* (18) Number of open files > FF_FS_LOCK */ TCHAR fname[FF_LFN_BUF + 1]; /* Primary file name */
FR_INVALID_PARAMETER /* (19) Given parameter is invalid */ #else
} FRESULT; TCHAR fname[12 + 1]; /* File name */
#endif
} FILINFO;
/*--------------------------------------------------------------*/
/* FatFs module application interface */
/* File function return code (FRESULT) */
FRESULT f_open (FIL* fp, const TCHAR* path, BYTE mode); /* Open or create a file */
FRESULT f_close (FIL* fp); /* Close an open file object */ typedef enum {
FRESULT f_read (FIL* fp, void* buff, UINT btr, UINT* br); /* Read data from the file */ FR_OK = 0, /* (0) Succeeded */
FRESULT f_write (FIL* fp, const void* buff, UINT btw, UINT* bw); /* Write data to the file */ FR_DISK_ERR, /* (1) A hard error occurred in the low level disk I/O layer */
FRESULT f_lseek (FIL* fp, FSIZE_t ofs); /* Move file pointer of the file object */ FR_INT_ERR, /* (2) Assertion failed */
FRESULT f_truncate (FIL* fp); /* Truncate the file */ FR_NOT_READY, /* (3) The physical drive cannot work */
FRESULT f_sync (FIL* fp); /* Flush cached data of the writing file */ FR_NO_FILE, /* (4) Could not find the file */
FRESULT f_opendir (DIR* dp, const TCHAR* path); /* Open a directory */ FR_NO_PATH, /* (5) Could not find the path */
FRESULT f_closedir (DIR* dp); /* Close an open directory */ FR_INVALID_NAME, /* (6) The path name format is invalid */
FRESULT f_readdir (DIR* dp, FILINFO* fno); /* Read a directory item */ FR_DENIED, /* (7) Access denied due to prohibited access or directory full */
FRESULT f_findfirst (DIR* dp, FILINFO* fno, const TCHAR* path, const TCHAR* pattern); /* Find first file */ FR_EXIST, /* (8) Access denied due to prohibited access */
FRESULT f_findnext (DIR* dp, FILINFO* fno); /* Find next file */ FR_INVALID_OBJECT, /* (9) The file/directory object is invalid */
FRESULT f_mkdir (const TCHAR* path); /* Create a sub directory */ FR_WRITE_PROTECTED, /* (10) The physical drive is write protected */
FRESULT f_unlink (const TCHAR* path); /* Delete an existing file or directory */ FR_INVALID_DRIVE, /* (11) The logical drive number is invalid */
FRESULT f_rename (const TCHAR* path_old, const TCHAR* path_new); /* Rename/Move a file or directory */ FR_NOT_ENABLED, /* (12) The volume has no work area */
FRESULT f_stat (const TCHAR* path, FILINFO* fno); /* Get file status */ FR_NO_FILESYSTEM, /* (13) There is no valid FAT volume */
FRESULT f_chmod (const TCHAR* path, BYTE attr, BYTE mask); /* Change attribute of a file/dir */ FR_MKFS_ABORTED, /* (14) The f_mkfs() aborted due to any problem */
FRESULT f_utime (const TCHAR* path, const FILINFO* fno); /* Change timestamp of a file/dir */ FR_TIMEOUT, /* (15) Could not get a grant to access the volume within defined period */
FRESULT f_chdir (const TCHAR* path); /* Change current directory */ FR_LOCKED, /* (16) The operation is rejected according to the file sharing policy */
FRESULT f_chdrive (const TCHAR* path); /* Change current drive */ FR_NOT_ENOUGH_CORE, /* (17) LFN working buffer could not be allocated */
FRESULT f_getcwd (TCHAR* buff, UINT len); /* Get current directory */ FR_TOO_MANY_OPEN_FILES, /* (18) Number of open files > FF_FS_LOCK */
FRESULT f_getfree (const TCHAR* path, DWORD* nclst, FATFS** fatfs); /* Get number of free clusters on the drive */ FR_INVALID_PARAMETER /* (19) Given parameter is invalid */
FRESULT f_getlabel (const TCHAR* path, TCHAR* label, DWORD* vsn); /* Get volume label */ } FRESULT;
FRESULT f_setlabel (const TCHAR* label); /* Set volume label */
FRESULT f_forward (FIL* fp, UINT(*func)(const BYTE*,UINT), UINT btf, UINT* bf); /* Forward data to the stream */
FRESULT f_expand (FIL* fp, FSIZE_t szf, BYTE opt); /* Allocate a contiguous block to the file */
FRESULT f_mount (FATFS* fs, const TCHAR* path, BYTE opt); /* Mount/Unmount a logical drive */ /*--------------------------------------------------------------*/
FRESULT f_mkfs (const TCHAR* path, BYTE opt, DWORD au, void* work, UINT len); /* Create a FAT volume */ /* FatFs module application interface */
FRESULT f_fdisk (BYTE pdrv, const DWORD* szt, void* work); /* Divide a physical drive into some partitions */
FRESULT f_setcp (WORD cp); /* Set current code page */ FRESULT f_open (FIL* fp, const TCHAR* path, BYTE mode); /* Open or create a file */
int f_putc (TCHAR c, FIL* fp); /* Put a character to the file */ FRESULT f_close (FIL* fp); /* Close an open file object */
int f_puts (const TCHAR* str, FIL* cp); /* Put a string to the file */ FRESULT f_read (FIL* fp, void* buff, UINT btr, UINT* br); /* Read data from the file */
int f_printf (FIL* fp, const TCHAR* str, ...); /* Put a formatted string to the file */ FRESULT f_write (FIL* fp, const void* buff, UINT btw, UINT* bw); /* Write data to the file */
TCHAR* f_gets (TCHAR* buff, int len, FIL* fp); /* Get a string from the file */ FRESULT f_lseek (FIL* fp, FSIZE_t ofs); /* Move file pointer of the file object */
FRESULT f_truncate (FIL* fp); /* Truncate the file */
#define f_eof(fp) ((int)((fp)->fptr == (fp)->obj.objsize)) FRESULT f_sync (FIL* fp); /* Flush cached data of the writing file */
#define f_error(fp) ((fp)->err) FRESULT f_opendir (DIR* dp, const TCHAR* path); /* Open a directory */
#define f_tell(fp) ((fp)->fptr) FRESULT f_closedir (DIR* dp); /* Close an open directory */
#define f_size(fp) ((fp)->obj.objsize) FRESULT f_readdir (DIR* dp, FILINFO* fno); /* Read a directory item */
#define f_rewind(fp) f_lseek((fp), 0) FRESULT f_findfirst (DIR* dp, FILINFO* fno, const TCHAR* path, const TCHAR* pattern); /* Find first file */
#define f_rewinddir(dp) f_readdir((dp), 0) FRESULT f_findnext (DIR* dp, FILINFO* fno); /* Find next file */
#define f_rmdir(path) f_unlink(path) FRESULT f_mkdir (const TCHAR* path); /* Create a sub directory */
#define f_unmount(path) f_mount(0, path, 0) FRESULT f_unlink (const TCHAR* path); /* Delete an existing file or directory */
FRESULT f_rename (const TCHAR* path_old, const TCHAR* path_new); /* Rename/Move a file or directory */
#ifndef EOF FRESULT f_stat (const TCHAR* path, FILINFO* fno); /* Get file status */
#define EOF (-1) FRESULT f_chmod (const TCHAR* path, BYTE attr, BYTE mask); /* Change attribute of a file/dir */
#endif FRESULT f_utime (const TCHAR* path, const FILINFO* fno); /* Change timestamp of a file/dir */
FRESULT f_chdir (const TCHAR* path); /* Change current directory */
FRESULT f_chdrive (const TCHAR* path); /* Change current drive */
FRESULT f_getcwd (TCHAR* buff, UINT len); /* Get current directory */
FRESULT f_getfree (const TCHAR* path, DWORD* nclst, FATFS** fatfs); /* Get number of free clusters on the drive */
/*--------------------------------------------------------------*/ FRESULT f_getlabel (const TCHAR* path, TCHAR* label, DWORD* vsn); /* Get volume label */
/* Additional user defined functions */ FRESULT f_setlabel (const TCHAR* label); /* Set volume label */
FRESULT f_forward (FIL* fp, UINT(*func)(const BYTE*,UINT), UINT btf, UINT* bf); /* Forward data to the stream */
/* RTC function */ FRESULT f_expand (FIL* fp, FSIZE_t fsz, BYTE opt); /* Allocate a contiguous block to the file */
#if !FF_FS_READONLY && !FF_FS_NORTC FRESULT f_mount (FATFS* fs, const TCHAR* path, BYTE opt); /* Mount/Unmount a logical drive */
DWORD get_fattime (void); FRESULT f_mkfs (const TCHAR* path, BYTE opt, DWORD au, void* work, UINT len); /* Create a FAT volume */
#endif FRESULT f_fdisk (BYTE pdrv, const DWORD* szt, void* work); /* Divide a physical drive into some partitions */
FRESULT f_setcp (WORD cp); /* Set current code page */
/* LFN support functions */ int f_putc (TCHAR c, FIL* fp); /* Put a character to the file */
#if FF_USE_LFN >= 1 /* Code conversion (defined in unicode.c) */ int f_puts (const TCHAR* str, FIL* cp); /* Put a string to the file */
WCHAR ff_oem2uni (WCHAR oem, WORD cp); /* OEM code to Unicode conversion */ int f_printf (FIL* fp, const TCHAR* str, ...); /* Put a formatted string to the file */
WCHAR ff_uni2oem (DWORD uni, WORD cp); /* Unicode to OEM code conversion */ TCHAR* f_gets (TCHAR* buff, int len, FIL* fp); /* Get a string from the file */
DWORD ff_wtoupper (DWORD uni); /* Unicode upper-case conversion */
#endif #define f_eof(fp) ((int)((fp)->fptr == (fp)->obj.objsize))
#if FF_USE_LFN == 3 /* Dynamic memory allocation */ #define f_error(fp) ((fp)->err)
void* ff_memalloc (UINT msize); /* Allocate memory block */ #define f_tell(fp) ((fp)->fptr)
void ff_memfree (void* mblock); /* Free memory block */ #define f_size(fp) ((fp)->obj.objsize)
#endif #define f_rewind(fp) f_lseek((fp), 0)
#define f_rewinddir(dp) f_readdir((dp), 0)
/* Sync functions */ #define f_rmdir(path) f_unlink(path)
#if FF_FS_REENTRANT #define f_unmount(path) f_mount(0, path, 0)
int ff_cre_syncobj (BYTE vol, FF_SYNC_t* sobj); /* Create a sync object */
int ff_req_grant (FF_SYNC_t sobj); /* Lock sync object */ #ifndef EOF
void ff_rel_grant (FF_SYNC_t sobj); /* Unlock sync object */ #define EOF (-1)
int ff_del_syncobj (FF_SYNC_t sobj); /* Delete a sync object */ #endif
#endif
/*--------------------------------------------------------------*/
/*--------------------------------------------------------------*/ /* Additional user defined functions */
/* Flags and offset address */
/* RTC function */
#if !FF_FS_READONLY && !FF_FS_NORTC
/* File access mode and open method flags (3rd argument of f_open) */ DWORD get_fattime (void);
#define FA_READ 0x01 #endif
#define FA_WRITE 0x02
#define FA_OPEN_EXISTING 0x00 /* LFN support functions */
#define FA_CREATE_NEW 0x04 #if FF_USE_LFN >= 1 /* Code conversion (defined in unicode.c) */
#define FA_CREATE_ALWAYS 0x08 WCHAR ff_oem2uni (WCHAR oem, WORD cp); /* OEM code to Unicode conversion */
#define FA_OPEN_ALWAYS 0x10 WCHAR ff_uni2oem (DWORD uni, WORD cp); /* Unicode to OEM code conversion */
#define FA_OPEN_APPEND 0x30 DWORD ff_wtoupper (DWORD uni); /* Unicode upper-case conversion */
#endif
/* Fast seek controls (2nd argument of f_lseek) */ #if FF_USE_LFN == 3 /* Dynamic memory allocation */
#define CREATE_LINKMAP ((FSIZE_t)0 - 1) void* ff_memalloc (UINT msize); /* Allocate memory block */
void ff_memfree (void* mblock); /* Free memory block */
/* Format options (2nd argument of f_mkfs) */ #endif
#define FM_FAT 0x01
#define FM_FAT32 0x02 /* Sync functions */
#define FM_EXFAT 0x04 #if FF_FS_REENTRANT
#define FM_ANY 0x07 int ff_cre_syncobj (BYTE vol, FF_SYNC_t* sobj); /* Create a sync object */
#define FM_SFD 0x08 int ff_req_grant (FF_SYNC_t sobj); /* Lock sync object */
void ff_rel_grant (FF_SYNC_t sobj); /* Unlock sync object */
/* Filesystem type (FATFS.fs_type) */ int ff_del_syncobj (FF_SYNC_t sobj); /* Delete a sync object */
#define FS_FAT12 1 #endif
#define FS_FAT16 2
#define FS_FAT32 3
#define FS_EXFAT 4
/* File attribute bits for directory entry (FILINFO.fattrib) */ /*--------------------------------------------------------------*/
#define AM_RDO 0x01 /* Read only */ /* Flags and offset address */
#define AM_HID 0x02 /* Hidden */
#define AM_SYS 0x04 /* System */
#define AM_DIR 0x10 /* Directory */ /* File access mode and open method flags (3rd argument of f_open) */
#define AM_ARC 0x20 /* Archive */ #define FA_READ 0x01
#define FA_WRITE 0x02
#define FA_OPEN_EXISTING 0x00
#ifdef __cplusplus #define FA_CREATE_NEW 0x04
} #define FA_CREATE_ALWAYS 0x08
#endif #define FA_OPEN_ALWAYS 0x10
#define FA_OPEN_APPEND 0x30
#endif /* FF_DEFINED */
/* Fast seek controls (2nd argument of f_lseek) */
#define CREATE_LINKMAP ((FSIZE_t)0 - 1)
/* Format options (2nd argument of f_mkfs) */
#define FM_FAT 0x01
#define FM_FAT32 0x02
#define FM_EXFAT 0x04
#define FM_ANY 0x07
#define FM_SFD 0x08
/* Filesystem type (FATFS.fs_type) */
#define FS_FAT12 1
#define FS_FAT16 2
#define FS_FAT32 3
#define FS_EXFAT 4
/* File attribute bits for directory entry (FILINFO.fattrib) */
#define AM_RDO 0x01 /* Read only */
#define AM_HID 0x02 /* Hidden */
#define AM_SYS 0x04 /* System */
#define AM_DIR 0x10 /* Directory */
#define AM_ARC 0x20 /* Archive */
#ifdef __cplusplus
}
#endif
#endif /* FF_DEFINED */

View File

@ -1,289 +1,288 @@
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ FatFs - Configuration file / FatFs Functional Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FFCONF_DEF 63463 /* Revision ID */ #define FFCONF_DEF 86604 /* Revision ID */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ Function Configurations / Function Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_FS_READONLY 0 #define FF_FS_READONLY 0
/* This option switches read-only configuration. (0:Read/Write or 1:Read-only) /* This option switches read-only configuration. (0:Read/Write or 1:Read-only)
/ Read-only configuration removes writing API functions, f_write(), f_sync(), / Read-only configuration removes writing API functions, f_write(), f_sync(),
/ f_unlink(), f_mkdir(), f_chmod(), f_rename(), f_truncate(), f_getfree() / f_unlink(), f_mkdir(), f_chmod(), f_rename(), f_truncate(), f_getfree()
/ and optional writing functions as well. */ / and optional writing functions as well. */
#define FF_FS_MINIMIZE 0 #define FF_FS_MINIMIZE 0
/* This option defines minimization level to remove some basic API functions. /* This option defines minimization level to remove some basic API functions.
/ /
/ 0: Basic functions are fully enabled. / 0: Basic functions are fully enabled.
/ 1: f_stat(), f_getfree(), f_unlink(), f_mkdir(), f_truncate() and f_rename() / 1: f_stat(), f_getfree(), f_unlink(), f_mkdir(), f_truncate() and f_rename()
/ are removed. / are removed.
/ 2: f_opendir(), f_readdir() and f_closedir() are removed in addition to 1. / 2: f_opendir(), f_readdir() and f_closedir() are removed in addition to 1.
/ 3: f_lseek() function is removed in addition to 2. */ / 3: f_lseek() function is removed in addition to 2. */
#define FF_USE_STRFUNC 2 #define FF_USE_STRFUNC 2
/* This option switches string functions, f_gets(), f_putc(), f_puts() and f_printf(). /* This option switches string functions, f_gets(), f_putc(), f_puts() and f_printf().
/ /
/ 0: Disable string functions. / 0: Disable string functions.
/ 1: Enable without LF-CRLF conversion. / 1: Enable without LF-CRLF conversion.
/ 2: Enable with LF-CRLF conversion. */ / 2: Enable with LF-CRLF conversion. */
#define FF_USE_FIND 0 #define FF_USE_FIND 0
/* This option switches filtered directory read functions, f_findfirst() and /* This option switches filtered directory read functions, f_findfirst() and
/ f_findnext(). (0:Disable, 1:Enable 2:Enable with matching altname[] too) */ / f_findnext(). (0:Disable, 1:Enable 2:Enable with matching altname[] too) */
#define FF_USE_MKFS 0 #define FF_USE_MKFS 0
/* This option switches f_mkfs() function. (0:Disable or 1:Enable) */ /* This option switches f_mkfs() function. (0:Disable or 1:Enable) */
#define FF_USE_FASTSEEK 0 #define FF_USE_FASTSEEK 0
/* This option switches fast seek function. (0:Disable or 1:Enable) */ /* This option switches fast seek function. (0:Disable or 1:Enable) */
#define FF_USE_EXPAND 0 #define FF_USE_EXPAND 0
/* This option switches f_expand function. (0:Disable or 1:Enable) */ /* This option switches f_expand function. (0:Disable or 1:Enable) */
#define FF_USE_CHMOD 1 #define FF_USE_CHMOD 1
/* This option switches attribute manipulation functions, f_chmod() and f_utime(). /* This option switches attribute manipulation functions, f_chmod() and f_utime().
/ (0:Disable or 1:Enable) Also FF_FS_READONLY needs to be 0 to enable this option. */ / (0:Disable or 1:Enable) Also FF_FS_READONLY needs to be 0 to enable this option. */
#define FF_USE_LABEL 0 #define FF_USE_LABEL 0
/* This option switches volume label functions, f_getlabel() and f_setlabel(). /* This option switches volume label functions, f_getlabel() and f_setlabel().
/ (0:Disable or 1:Enable) */ / (0:Disable or 1:Enable) */
#define FF_USE_FORWARD 0 #define FF_USE_FORWARD 0
/* This option switches f_forward() function. (0:Disable or 1:Enable) */ /* This option switches f_forward() function. (0:Disable or 1:Enable) */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ Locale and Namespace Configurations / Locale and Namespace Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_CODE_PAGE 850 #define FF_CODE_PAGE 850
/* This option specifies the OEM code page to be used on the target system. /* This option specifies the OEM code page to be used on the target system.
/ Incorrect code page setting can cause a file open failure. / Incorrect code page setting can cause a file open failure.
/ /
/ 437 - U.S. / 437 - U.S.
/ 720 - Arabic / 720 - Arabic
/ 737 - Greek / 737 - Greek
/ 771 - KBL / 771 - KBL
/ 775 - Baltic / 775 - Baltic
/ 850 - Latin 1 / 850 - Latin 1
/ 852 - Latin 2 / 852 - Latin 2
/ 855 - Cyrillic / 855 - Cyrillic
/ 857 - Turkish / 857 - Turkish
/ 860 - Portuguese / 860 - Portuguese
/ 861 - Icelandic / 861 - Icelandic
/ 862 - Hebrew / 862 - Hebrew
/ 863 - Canadian French / 863 - Canadian French
/ 864 - Arabic / 864 - Arabic
/ 865 - Nordic / 865 - Nordic
/ 866 - Russian / 866 - Russian
/ 869 - Greek 2 / 869 - Greek 2
/ 932 - Japanese (DBCS) / 932 - Japanese (DBCS)
/ 936 - Simplified Chinese (DBCS) / 936 - Simplified Chinese (DBCS)
/ 949 - Korean (DBCS) / 949 - Korean (DBCS)
/ 950 - Traditional Chinese (DBCS) / 950 - Traditional Chinese (DBCS)
/ 0 - Include all code pages above and configured by f_setcp() / 0 - Include all code pages above and configured by f_setcp()
*/ */
#define FF_USE_LFN 1 #define FF_USE_LFN 1
#define FF_MAX_LFN 255 #define FF_MAX_LFN 255
/* The FF_USE_LFN switches the support for LFN (long file name). /* The FF_USE_LFN switches the support for LFN (long file name).
/ /
/ 0: Disable LFN. FF_MAX_LFN has no effect. / 0: Disable LFN. FF_MAX_LFN has no effect.
/ 1: Enable LFN with static working buffer on the BSS. Always NOT thread-safe. / 1: Enable LFN with static working buffer on the BSS. Always NOT thread-safe.
/ 2: Enable LFN with dynamic working buffer on the STACK. / 2: Enable LFN with dynamic working buffer on the STACK.
/ 3: Enable LFN with dynamic working buffer on the HEAP. / 3: Enable LFN with dynamic working buffer on the HEAP.
/ /
/ To enable the LFN, ffunicode.c needs to be added to the project. The LFN function / To enable the LFN, ffunicode.c needs to be added to the project. The LFN function
/ requiers certain internal working buffer occupies (FF_MAX_LFN + 1) * 2 bytes and / requiers certain internal working buffer occupies (FF_MAX_LFN + 1) * 2 bytes and
/ additional (FF_MAX_LFN + 44) / 15 * 32 bytes when exFAT is enabled. / additional (FF_MAX_LFN + 44) / 15 * 32 bytes when exFAT is enabled.
/ The FF_MAX_LFN defines size of the working buffer in UTF-16 code unit and it can / The FF_MAX_LFN defines size of the working buffer in UTF-16 code unit and it can
/ be in range of 12 to 255. It is recommended to be set 255 to fully support LFN / be in range of 12 to 255. It is recommended to be set 255 to fully support LFN
/ specification. / specification.
/ When use stack for the working buffer, take care on stack overflow. When use heap / When use stack for the working buffer, take care on stack overflow. When use heap
/ memory for the working buffer, memory management functions, ff_memalloc() and / memory for the working buffer, memory management functions, ff_memalloc() and
/ ff_memfree() in ffsystem.c, need to be added to the project. */ / ff_memfree() in ffsystem.c, need to be added to the project. */
#define FF_LFN_UNICODE 2 #define FF_LFN_UNICODE 2
/* This option switches the character encoding on the API when LFN is enabled. /* This option switches the character encoding on the API when LFN is enabled.
/ /
/ 0: ANSI/OEM in current CP (TCHAR = char) / 0: ANSI/OEM in current CP (TCHAR = char)
/ 1: Unicode in UTF-16 (TCHAR = WCHAR) / 1: Unicode in UTF-16 (TCHAR = WCHAR)
/ 2: Unicode in UTF-8 (TCHAR = char) / 2: Unicode in UTF-8 (TCHAR = char)
/ 3: Unicode in UTF-32 (TCHAR = DWORD) / 3: Unicode in UTF-32 (TCHAR = DWORD)
/ /
/ Also behavior of string I/O functions will be affected by this option. / Also behavior of string I/O functions will be affected by this option.
/ When LFN is not enabled, this option has no effect. */ / When LFN is not enabled, this option has no effect. */
#define FF_LFN_BUF 255 #define FF_LFN_BUF 255
#define FF_SFN_BUF 12 #define FF_SFN_BUF 12
/* This set of options defines size of file name members in the FILINFO structure /* This set of options defines size of file name members in the FILINFO structure
/ which is used to read out directory items. These values should be suffcient for / which is used to read out directory items. These values should be suffcient for
/ the file names to read. The maximum possible length of the read file name depends / the file names to read. The maximum possible length of the read file name depends
/ on character encoding. When LFN is not enabled, these options have no effect. */ / on character encoding. When LFN is not enabled, these options have no effect. */
#define FF_STRF_ENCODE 3 #define FF_STRF_ENCODE 3
/* When FF_LFN_UNICODE >= 1 with LFN enabled, string I/O functions, f_gets(), /* When FF_LFN_UNICODE >= 1 with LFN enabled, string I/O functions, f_gets(),
/ f_putc(), f_puts and f_printf() convert the character encoding in it. / f_putc(), f_puts and f_printf() convert the character encoding in it.
/ This option selects assumption of character encoding ON THE FILE to be / This option selects assumption of character encoding ON THE FILE to be
/ read/written via those functions. / read/written via those functions.
/ /
/ 0: ANSI/OEM in current CP / 0: ANSI/OEM in current CP
/ 1: Unicode in UTF-16LE / 1: Unicode in UTF-16LE
/ 2: Unicode in UTF-16BE / 2: Unicode in UTF-16BE
/ 3: Unicode in UTF-8 / 3: Unicode in UTF-8
*/ */
#define FF_FS_RPATH 2 #define FF_FS_RPATH 2
/* This option configures support for relative path. /* This option configures support for relative path.
/ /
/ 0: Disable relative path and remove related functions. / 0: Disable relative path and remove related functions.
/ 1: Enable relative path. f_chdir() and f_chdrive() are available. / 1: Enable relative path. f_chdir() and f_chdrive() are available.
/ 2: f_getcwd() function is available in addition to 1. / 2: f_getcwd() function is available in addition to 1.
*/ */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ Drive/Volume Configurations / Drive/Volume Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_VOLUMES 10 #define FF_VOLUMES 10
/* Number of volumes (logical drives) to be used. (1-10) */ /* Number of volumes (logical drives) to be used. (1-10) */
#define FF_STR_VOLUME_ID 1 #define FF_STR_VOLUME_ID 1
//#define FF_VOLUME_STRS "sdmc" //#define FF_VOLUME_STRS "sdmc"
/* FF_STR_VOLUME_ID switches support for volume ID in arbitrary strings. /* FF_STR_VOLUME_ID switches support for volume ID in arbitrary strings.
/ When FF_STR_VOLUME_ID is set to 1 or 2, arbitrary strings can be used as drive / When FF_STR_VOLUME_ID is set to 1 or 2, arbitrary strings can be used as drive
/ number in the path name. FF_VOLUME_STRS defines the volume ID strings for each / number in the path name. FF_VOLUME_STRS defines the volume ID strings for each
/ logical drives. Number of items must not be less than FF_VOLUMES. Valid / logical drives. Number of items must not be less than FF_VOLUMES. Valid
/ characters for the volume ID strings are A-Z, a-z and 0-9, however, they are / characters for the volume ID strings are A-Z, a-z and 0-9, however, they are
/ compared in case-insensitive. If FF_STR_VOLUME_ID >= 1 and FF_VOLUME_STRS is / compared in case-insensitive. If FF_STR_VOLUME_ID >= 1 and FF_VOLUME_STRS is
/ not defined, a user defined volume string table needs to be defined as: / not defined, a user defined volume string table needs to be defined as:
/ /
/ const char* VolumeStr[FF_VOLUMES] = {"ram","flash","sd","usb",... / const char* VolumeStr[FF_VOLUMES] = {"ram","flash","sd","usb",...
*/ */
#define FF_MULTI_PARTITION 0 #define FF_MULTI_PARTITION 0
/* This option switches support for multiple volumes on the physical drive. /* This option switches support for multiple volumes on the physical drive.
/ By default (0), each logical drive number is bound to the same physical drive / By default (0), each logical drive number is bound to the same physical drive
/ number and only an FAT volume found on the physical drive will be mounted. / number and only an FAT volume found on the physical drive will be mounted.
/ When this function is enabled (1), each logical drive number can be bound to / When this function is enabled (1), each logical drive number can be bound to
/ arbitrary physical drive and partition listed in the VolToPart[]. Also f_fdisk() / arbitrary physical drive and partition listed in the VolToPart[]. Also f_fdisk()
/ funciton will be available. */ / funciton will be available. */
#define FF_MIN_SS 512 #define FF_MIN_SS 512
#define FF_MAX_SS 4096 #define FF_MAX_SS 4096
/* This set of options configures the range of sector size to be supported. (512, /* This set of options configures the range of sector size to be supported. (512,
/ 1024, 2048 or 4096) Always set both 512 for most systems, generic memory card and / 1024, 2048 or 4096) Always set both 512 for most systems, generic memory card and
/ harddisk. But a larger value may be required for on-board flash memory and some / harddisk. But a larger value may be required for on-board flash memory and some
/ type of optical media. When FF_MAX_SS is larger than FF_MIN_SS, FatFs is configured / type of optical media. When FF_MAX_SS is larger than FF_MIN_SS, FatFs is configured
/ for variable sector size mode and disk_ioctl() function needs to implement / for variable sector size mode and disk_ioctl() function needs to implement
/ GET_SECTOR_SIZE command. */ / GET_SECTOR_SIZE command. */
#define FF_USE_TRIM 0 #define FF_USE_TRIM 0
/* This option switches support for ATA-TRIM. (0:Disable or 1:Enable) /* This option switches support for ATA-TRIM. (0:Disable or 1:Enable)
/ To enable Trim function, also CTRL_TRIM command should be implemented to the / To enable Trim function, also CTRL_TRIM command should be implemented to the
/ disk_ioctl() function. */ / disk_ioctl() function. */
#define FF_FS_NOFSINFO 0 #define FF_FS_NOFSINFO 0
/* If you need to know correct free space on the FAT32 volume, set bit 0 of this /* If you need to know correct free space on the FAT32 volume, set bit 0 of this
/ option, and f_getfree() function at first time after volume mount will force / option, and f_getfree() function at first time after volume mount will force
/ a full FAT scan. Bit 1 controls the use of last allocated cluster number. / a full FAT scan. Bit 1 controls the use of last allocated cluster number.
/ /
/ bit0=0: Use free cluster count in the FSINFO if available. / bit0=0: Use free cluster count in the FSINFO if available.
/ bit0=1: Do not trust free cluster count in the FSINFO. / bit0=1: Do not trust free cluster count in the FSINFO.
/ bit1=0: Use last allocated cluster number in the FSINFO if available. / bit1=0: Use last allocated cluster number in the FSINFO if available.
/ bit1=1: Do not trust last allocated cluster number in the FSINFO. / bit1=1: Do not trust last allocated cluster number in the FSINFO.
*/ */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ System Configurations / System Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_FS_TINY 0 #define FF_FS_TINY 0
/* This option switches tiny buffer configuration. (0:Normal or 1:Tiny) /* This option switches tiny buffer configuration. (0:Normal or 1:Tiny)
/ At the tiny configuration, size of file object (FIL) is shrinked FF_MAX_SS bytes. / At the tiny configuration, size of file object (FIL) is shrinked FF_MAX_SS bytes.
/ Instead of private sector buffer eliminated from the file object, common sector / Instead of private sector buffer eliminated from the file object, common sector
/ buffer in the filesystem object (FATFS) is used for the file data transfer. */ / buffer in the filesystem object (FATFS) is used for the file data transfer. */
#define FF_FS_EXFAT 1 #define FF_FS_EXFAT 1
/* This option switches support for exFAT filesystem. (0:Disable or 1:Enable) /* This option switches support for exFAT filesystem. (0:Disable or 1:Enable)
/ To enable exFAT, also LFN needs to be enabled. / To enable exFAT, also LFN needs to be enabled. (FF_USE_LFN >= 1)
/ Note that enabling exFAT discards ANSI C (C89) compatibility. */ / Note that enabling exFAT discards ANSI C (C89) compatibility. */
#define FF_FS_NORTC 1 #define FF_FS_NORTC 1
#define FF_NORTC_MON 1 #define FF_NORTC_MON 1
#define FF_NORTC_MDAY 1 #define FF_NORTC_MDAY 1
#define FF_NORTC_YEAR 2018 #define FF_NORTC_YEAR 2018
/* The option FF_FS_NORTC switches timestamp functiton. If the system does not have /* The option FF_FS_NORTC switches timestamp functiton. If the system does not have
/ any RTC function or valid timestamp is not needed, set FF_FS_NORTC = 1 to disable / any RTC function or valid timestamp is not needed, set FF_FS_NORTC = 1 to disable
/ the timestamp function. Every object modified by FatFs will have a fixed timestamp / the timestamp function. Every object modified by FatFs will have a fixed timestamp
/ defined by FF_NORTC_MON, FF_NORTC_MDAY and FF_NORTC_YEAR in local time. / defined by FF_NORTC_MON, FF_NORTC_MDAY and FF_NORTC_YEAR in local time.
/ To enable timestamp function (FF_FS_NORTC = 0), get_fattime() function need to be / To enable timestamp function (FF_FS_NORTC = 0), get_fattime() function need to be
/ added to the project to read current time form real-time clock. FF_NORTC_MON, / added to the project to read current time form real-time clock. FF_NORTC_MON,
/ FF_NORTC_MDAY and FF_NORTC_YEAR have no effect. / FF_NORTC_MDAY and FF_NORTC_YEAR have no effect.
/ These options have no effect at read-only configuration (FF_FS_READONLY = 1). */ / These options have no effect at read-only configuration (FF_FS_READONLY = 1). */
#define FF_FS_LOCK 0 #define FF_FS_LOCK 0
/* The option FF_FS_LOCK switches file lock function to control duplicated file open /* The option FF_FS_LOCK switches file lock function to control duplicated file open
/ and illegal operation to open objects. This option must be 0 when FF_FS_READONLY / and illegal operation to open objects. This option must be 0 when FF_FS_READONLY
/ is 1. / is 1.
/ /
/ 0: Disable file lock function. To avoid volume corruption, application program / 0: Disable file lock function. To avoid volume corruption, application program
/ should avoid illegal open, remove and rename to the open objects. / should avoid illegal open, remove and rename to the open objects.
/ >0: Enable file lock function. The value defines how many files/sub-directories / >0: Enable file lock function. The value defines how many files/sub-directories
/ can be opened simultaneously under file lock control. Note that the file / can be opened simultaneously under file lock control. Note that the file
/ lock control is independent of re-entrancy. */ / lock control is independent of re-entrancy. */
#define FF_FS_REENTRANT 0 /* #include <somertos.h> // O/S definitions */
#define FF_FS_TIMEOUT 1000 #define FF_FS_REENTRANT 0
#define FF_SYNC_t HANDLE #define FF_FS_TIMEOUT 1000
/* The option FF_FS_REENTRANT switches the re-entrancy (thread safe) of the FatFs #define FF_SYNC_t HANDLE
/ module itself. Note that regardless of this option, file access to different /* The option FF_FS_REENTRANT switches the re-entrancy (thread safe) of the FatFs
/ volume is always re-entrant and volume control functions, f_mount(), f_mkfs() / module itself. Note that regardless of this option, file access to different
/ and f_fdisk() function, are always not re-entrant. Only file/directory access / volume is always re-entrant and volume control functions, f_mount(), f_mkfs()
/ to the same volume is under control of this function. / and f_fdisk() function, are always not re-entrant. Only file/directory access
/ / to the same volume is under control of this function.
/ 0: Disable re-entrancy. FF_FS_TIMEOUT and FF_SYNC_t have no effect. /
/ 1: Enable re-entrancy. Also user provided synchronization handlers, / 0: Disable re-entrancy. FF_FS_TIMEOUT and FF_SYNC_t have no effect.
/ ff_req_grant(), ff_rel_grant(), ff_del_syncobj() and ff_cre_syncobj() / 1: Enable re-entrancy. Also user provided synchronization handlers,
/ function, must be added to the project. Samples are available in / ff_req_grant(), ff_rel_grant(), ff_del_syncobj() and ff_cre_syncobj()
/ option/syscall.c. / function, must be added to the project. Samples are available in
/ / option/syscall.c.
/ The FF_FS_TIMEOUT defines timeout period in unit of time tick. /
/ The FF_SYNC_t defines O/S dependent sync object type. e.g. HANDLE, ID, OS_EVENT*, / The FF_FS_TIMEOUT defines timeout period in unit of time tick.
/ SemaphoreHandle_t and etc. A header file for O/S definitions needs to be / The FF_SYNC_t defines O/S dependent sync object type. e.g. HANDLE, ID, OS_EVENT*,
/ included somewhere in the scope of ff.h. */ / SemaphoreHandle_t and etc. A header file for O/S definitions needs to be
/ included somewhere in the scope of ff.h. */
/* #include <windows.h> // O/S definitions */
/*--- End of configuration options ---*/
/*--- End of configuration options ---*/

View File

@ -1,171 +1,170 @@
/*------------------------------------------------------------------------*/ /*------------------------------------------------------------------------*/
/* Sample Code of OS Dependent Functions for FatFs */ /* Sample Code of OS Dependent Functions for FatFs */
/* (C)ChaN, 2017 */ /* (C)ChaN, 2018 */
/*------------------------------------------------------------------------*/ /*------------------------------------------------------------------------*/
#include "ff.h" #include "ff.h"
#if FF_USE_LFN == 3 /* Dynamic memory allocation */
#if FF_USE_LFN == 3 /* Dynamic memory allocation */
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Allocate a memory block */
/* Allocate a memory block */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/
void* ff_memalloc ( /* Returns pointer to the allocated memory block (null if not enough core) */
void* ff_memalloc ( /* Returns pointer to the allocated memory block (null on not enough core) */ UINT msize /* Number of bytes to allocate */
UINT msize /* Number of bytes to allocate */ )
) {
{ return malloc(msize); /* Allocate a new memory block with POSIX API */
return malloc(msize); /* Allocate a new memory block with POSIX API */ }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Free a memory block */
/* Free a memory block */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/
void ff_memfree (
void ff_memfree ( void* mblock /* Pointer to the memory block to free (nothing to do if null) */
void* mblock /* Pointer to the memory block to free (nothing to do for null) */ )
) {
{ free(mblock); /* Free the memory block with POSIX API */
free(mblock); /* Free the memory block with POSIX API */ }
}
#endif
#endif
#if FF_FS_REENTRANT /* Mutal exclusion */
#if FF_FS_REENTRANT /* Mutal exclusion */
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Create a Synchronization Object */
/* Create a Synchronization Object */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called in f_mount() function to create a new
/* This function is called in f_mount() function to create a new / synchronization object for the volume, such as semaphore and mutex.
/ synchronization object for the volume, such as semaphore and mutex. / When a 0 is returned, the f_mount() function fails with FR_INT_ERR.
/ When a 0 is returned, the f_mount() function fails with FR_INT_ERR. */
*/
//const osMutexDef_t Mutex[FF_VOLUMES]; /* Table of CMSIS-RTOS mutex */
//const osMutexDef_t Mutex[FF_VOLUMES]; /* CMSIS-RTOS */
int ff_cre_syncobj ( /* 1:Function succeeded, 0:Could not create the sync object */
int ff_cre_syncobj ( /* 1:Function succeeded, 0:Could not create the sync object */ BYTE vol, /* Corresponding volume (logical drive number) */
BYTE vol, /* Corresponding volume (logical drive number) */ FF_SYNC_t* sobj /* Pointer to return the created sync object */
FF_SYNC_t* sobj /* Pointer to return the created sync object */ )
) {
{ /* Win32 */
/* Win32 */ *sobj = CreateMutex(NULL, FALSE, NULL);
*sobj = CreateMutex(NULL, FALSE, NULL); return (int)(*sobj != INVALID_HANDLE_VALUE);
return (int)(*sobj != INVALID_HANDLE_VALUE);
/* uITRON */
/* uITRON */ // T_CSEM csem = {TA_TPRI,1,1};
// T_CSEM csem = {TA_TPRI,1,1}; // *sobj = acre_sem(&csem);
// *sobj = acre_sem(&csem); // return (int)(*sobj > 0);
// return (int)(*sobj > 0);
/* uC/OS-II */
/* uC/OS-II */ // OS_ERR err;
// OS_ERR err; // *sobj = OSMutexCreate(0, &err);
// *sobj = OSMutexCreate(0, &err); // return (int)(err == OS_NO_ERR);
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
/* FreeRTOS */ // *sobj = xSemaphoreCreateMutex();
// *sobj = xSemaphoreCreateMutex(); // return (int)(*sobj != NULL);
// return (int)(*sobj != NULL);
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // *sobj = osMutexCreate(&Mutex[vol]);
// *sobj = osMutexCreate(Mutex + vol); // return (int)(*sobj != NULL);
// return (int)(*sobj != NULL); }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Delete a Synchronization Object */
/* Delete a Synchronization Object */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called in f_mount() function to delete a synchronization
/* This function is called in f_mount() function to delete a synchronization / object that created with ff_cre_syncobj() function. When a 0 is returned,
/ object that created with ff_cre_syncobj() function. When a 0 is returned, / the f_mount() function fails with FR_INT_ERR.
/ the f_mount() function fails with FR_INT_ERR. */
*/
int ff_del_syncobj ( /* 1:Function succeeded, 0:Could not delete due to an error */
int ff_del_syncobj ( /* 1:Function succeeded, 0:Could not delete due to an error */ FF_SYNC_t sobj /* Sync object tied to the logical drive to be deleted */
FF_SYNC_t sobj /* Sync object tied to the logical drive to be deleted */ )
) {
{ /* Win32 */
/* Win32 */ return (int)CloseHandle(sobj);
return (int)CloseHandle(sobj);
/* uITRON */
/* uITRON */ // return (int)(del_sem(sobj) == E_OK);
// return (int)(del_sem(sobj) == E_OK);
/* uC/OS-II */
/* uC/OS-II */ // OS_ERR err;
// OS_ERR err; // OSMutexDel(sobj, OS_DEL_ALWAYS, &err);
// OSMutexDel(sobj, OS_DEL_ALWAYS, &err); // return (int)(err == OS_NO_ERR);
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
/* FreeRTOS */ // vSemaphoreDelete(sobj);
// vSemaphoreDelete(sobj); // return 1;
// return 1;
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // return (int)(osMutexDelete(sobj) == osOK);
// return (int)(osMutexDelete(sobj) == osOK); }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Request Grant to Access the Volume */
/* Request Grant to Access the Volume */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called on entering file functions to lock the volume.
/* This function is called on entering file functions to lock the volume. / When a 0 is returned, the file function fails with FR_TIMEOUT.
/ When a 0 is returned, the file function fails with FR_TIMEOUT. */
*/
int ff_req_grant ( /* 1:Got a grant to access the volume, 0:Could not get a grant */
int ff_req_grant ( /* 1:Got a grant to access the volume, 0:Could not get a grant */ FF_SYNC_t sobj /* Sync object to wait */
FF_SYNC_t sobj /* Sync object to wait */ )
) {
{ /* Win32 */
/* Win32 */ return (int)(WaitForSingleObject(sobj, FF_FS_TIMEOUT) == WAIT_OBJECT_0);
return (int)(WaitForSingleObject(sobj, FF_FS_TIMEOUT) == WAIT_OBJECT_0);
/* uITRON */
/* uITRON */ // return (int)(wai_sem(sobj) == E_OK);
// return (int)(wai_sem(sobj) == E_OK);
/* uC/OS-II */
/* uC/OS-II */ // OS_ERR err;
// OS_ERR err; // OSMutexPend(sobj, FF_FS_TIMEOUT, &err));
// OSMutexPend(sobj, FF_FS_TIMEOUT, &err)); // return (int)(err == OS_NO_ERR);
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
/* FreeRTOS */ // return (int)(xSemaphoreTake(sobj, FF_FS_TIMEOUT) == pdTRUE);
// return (int)(xSemaphoreTake(sobj, FF_FS_TIMEOUT) == pdTRUE);
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // return (int)(osMutexWait(sobj, FF_FS_TIMEOUT) == osOK);
// return (int)(osMutexWait(sobj, FF_FS_TIMEOUT) == osOK); }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Release Grant to Access the Volume */
/* Release Grant to Access the Volume */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called on leaving file functions to unlock the volume.
/* This function is called on leaving file functions to unlock the volume. */
*/
void ff_rel_grant (
void ff_rel_grant ( FF_SYNC_t sobj /* Sync object to be signaled */
FF_SYNC_t sobj /* Sync object to be signaled */ )
) {
{ /* Win32 */
/* Win32 */ ReleaseMutex(sobj);
ReleaseMutex(sobj);
/* uITRON */
/* uITRON */ // sig_sem(sobj);
// sig_sem(sobj);
/* uC/OS-II */
/* uC/OS-II */ // OSMutexPost(sobj);
// OSMutexPost(sobj);
/* FreeRTOS */
/* FreeRTOS */ // xSemaphoreGive(sobj);
// xSemaphoreGive(sobj);
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // osMutexRelease(sobj);
// osMutexRelease(sobj); }
}
#endif
#endif

File diff suppressed because it is too large Load Diff

View File

@ -1,36 +0,0 @@
/*-------------------------------------------*/
/* Integer type definitions for FatFs module */
/*-------------------------------------------*/
#ifndef FF_INTEGER
#define FF_INTEGER
#ifdef _WIN32 /* FatFs development platform */
#include <windows.h>
typedef unsigned __int64 QWORD;
#else /* Embedded platform */
/* These types MUST be 16-bit or 32-bit */
typedef int INT;
typedef unsigned int UINT;
/* This type MUST be 8-bit */
typedef unsigned char BYTE;
/* These types MUST be 16-bit */
typedef short SHORT;
typedef unsigned short WORD;
typedef unsigned short WCHAR;
/* These types MUST be 32-bit */
typedef long LONG;
typedef unsigned long DWORD;
/* This type MUST be 64-bit (Remove this for ANSI C (C89) compatibility) */
typedef unsigned long long QWORD;
#endif
#endif

View File

@ -1,324 +1,330 @@
---------------------------------------------------------------------------- ----------------------------------------------------------------------------
Revision history of FatFs module Revision history of FatFs module
---------------------------------------------------------------------------- ----------------------------------------------------------------------------
R0.00 (February 26, 2006) R0.00 (February 26, 2006)
Prototype. Prototype.
R0.01 (April 29, 2006) R0.01 (April 29, 2006)
The first release. The first release.
R0.02 (June 01, 2006) R0.02 (June 01, 2006)
Added FAT12 support. Added FAT12 support.
Removed unbuffered mode. Removed unbuffered mode.
Fixed a problem on small (<32M) partition. Fixed a problem on small (<32M) partition.
R0.02a (June 10, 2006) R0.02a (June 10, 2006)
Added a configuration option (_FS_MINIMUM). Added a configuration option (_FS_MINIMUM).
R0.03 (September 22, 2006) R0.03 (September 22, 2006)
Added f_rename(). Added f_rename().
Changed option _FS_MINIMUM to _FS_MINIMIZE. Changed option _FS_MINIMUM to _FS_MINIMIZE.
R0.03a (December 11, 2006) R0.03a (December 11, 2006)
Improved cluster scan algorithm to write files fast. Improved cluster scan algorithm to write files fast.
Fixed f_mkdir() creates incorrect directory on FAT32. Fixed f_mkdir() creates incorrect directory on FAT32.
R0.04 (February 04, 2007) R0.04 (February 04, 2007)
Added f_mkfs(). Added f_mkfs().
Supported multiple drive system. Supported multiple drive system.
Changed some interfaces for multiple drive system. Changed some interfaces for multiple drive system.
Changed f_mountdrv() to f_mount(). Changed f_mountdrv() to f_mount().
R0.04a (April 01, 2007) R0.04a (April 01, 2007)
Supported multiple partitions on a physical drive. Supported multiple partitions on a physical drive.
Added a capability of extending file size to f_lseek(). Added a capability of extending file size to f_lseek().
Added minimization level 3. Added minimization level 3.
Fixed an endian sensitive code in f_mkfs(). Fixed an endian sensitive code in f_mkfs().
R0.04b (May 05, 2007) R0.04b (May 05, 2007)
Added a configuration option _USE_NTFLAG. Added a configuration option _USE_NTFLAG.
Added FSINFO support. Added FSINFO support.
Fixed DBCS name can result FR_INVALID_NAME. Fixed DBCS name can result FR_INVALID_NAME.
Fixed short seek (<= csize) collapses the file object. Fixed short seek (<= csize) collapses the file object.
R0.05 (August 25, 2007) R0.05 (August 25, 2007)
Changed arguments of f_read(), f_write() and f_mkfs(). Changed arguments of f_read(), f_write() and f_mkfs().
Fixed f_mkfs() on FAT32 creates incorrect FSINFO. Fixed f_mkfs() on FAT32 creates incorrect FSINFO.
Fixed f_mkdir() on FAT32 creates incorrect directory. Fixed f_mkdir() on FAT32 creates incorrect directory.
R0.05a (February 03, 2008) R0.05a (February 03, 2008)
Added f_truncate() and f_utime(). Added f_truncate() and f_utime().
Fixed off by one error at FAT sub-type determination. Fixed off by one error at FAT sub-type determination.
Fixed btr in f_read() can be mistruncated. Fixed btr in f_read() can be mistruncated.
Fixed cached sector is not flushed when create and close without write. Fixed cached sector is not flushed when create and close without write.
R0.06 (April 01, 2008) R0.06 (April 01, 2008)
Added fputc(), fputs(), fprintf() and fgets(). Added fputc(), fputs(), fprintf() and fgets().
Improved performance of f_lseek() on moving to the same or following cluster. Improved performance of f_lseek() on moving to the same or following cluster.
R0.07 (April 01, 2009) R0.07 (April 01, 2009)
Merged Tiny-FatFs as a configuration option. (_FS_TINY) Merged Tiny-FatFs as a configuration option. (_FS_TINY)
Added long file name feature. (_USE_LFN) Added long file name feature. (_USE_LFN)
Added multiple code page feature. (_CODE_PAGE) Added multiple code page feature. (_CODE_PAGE)
Added re-entrancy for multitask operation. (_FS_REENTRANT) Added re-entrancy for multitask operation. (_FS_REENTRANT)
Added auto cluster size selection to f_mkfs(). Added auto cluster size selection to f_mkfs().
Added rewind option to f_readdir(). Added rewind option to f_readdir().
Changed result code of critical errors. Changed result code of critical errors.
Renamed string functions to avoid name collision. Renamed string functions to avoid name collision.
R0.07a (April 14, 2009) R0.07a (April 14, 2009)
Septemberarated out OS dependent code on reentrant cfg. Septemberarated out OS dependent code on reentrant cfg.
Added multiple sector size feature. Added multiple sector size feature.
R0.07c (June 21, 2009) R0.07c (June 21, 2009)
Fixed f_unlink() can return FR_OK on error. Fixed f_unlink() can return FR_OK on error.
Fixed wrong cache control in f_lseek(). Fixed wrong cache control in f_lseek().
Added relative path feature. Added relative path feature.
Added f_chdir() and f_chdrive(). Added f_chdir() and f_chdrive().
Added proper case conversion to extended character. Added proper case conversion to extended character.
R0.07e (November 03, 2009) R0.07e (November 03, 2009)
Septemberarated out configuration options from ff.h to ffconf.h. Septemberarated out configuration options from ff.h to ffconf.h.
Fixed f_unlink() fails to remove a sub-directory on _FS_RPATH. Fixed f_unlink() fails to remove a sub-directory on _FS_RPATH.
Fixed name matching error on the 13 character boundary. Fixed name matching error on the 13 character boundary.
Added a configuration option, _LFN_UNICODE. Added a configuration option, _LFN_UNICODE.
Changed f_readdir() to return the SFN with always upper case on non-LFN cfg. Changed f_readdir() to return the SFN with always upper case on non-LFN cfg.
R0.08 (May 15, 2010) R0.08 (May 15, 2010)
Added a memory configuration option. (_USE_LFN = 3) Added a memory configuration option. (_USE_LFN = 3)
Added file lock feature. (_FS_SHARE) Added file lock feature. (_FS_SHARE)
Added fast seek feature. (_USE_FASTSEEK) Added fast seek feature. (_USE_FASTSEEK)
Changed some types on the API, XCHAR->TCHAR. Changed some types on the API, XCHAR->TCHAR.
Changed .fname in the FILINFO structure on Unicode cfg. Changed .fname in the FILINFO structure on Unicode cfg.
String functions support UTF-8 encoding files on Unicode cfg. String functions support UTF-8 encoding files on Unicode cfg.
R0.08a (August 16, 2010) R0.08a (August 16, 2010)
Added f_getcwd(). (_FS_RPATH = 2) Added f_getcwd(). (_FS_RPATH = 2)
Added sector erase feature. (_USE_ERASE) Added sector erase feature. (_USE_ERASE)
Moved file lock semaphore table from fs object to the bss. Moved file lock semaphore table from fs object to the bss.
Fixed f_mkfs() creates wrong FAT32 volume. Fixed f_mkfs() creates wrong FAT32 volume.
R0.08b (January 15, 2011) R0.08b (January 15, 2011)
Fast seek feature is also applied to f_read() and f_write(). Fast seek feature is also applied to f_read() and f_write().
f_lseek() reports required table size on creating CLMP. f_lseek() reports required table size on creating CLMP.
Extended format syntax of f_printf(). Extended format syntax of f_printf().
Ignores duplicated directory separators in given path name. Ignores duplicated directory separators in given path name.
R0.09 (September 06, 2011) R0.09 (September 06, 2011)
f_mkfs() supports multiple partition to complete the multiple partition feature. f_mkfs() supports multiple partition to complete the multiple partition feature.
Added f_fdisk(). Added f_fdisk().
R0.09a (August 27, 2012) R0.09a (August 27, 2012)
Changed f_open() and f_opendir() reject null object pointer to avoid crash. Changed f_open() and f_opendir() reject null object pointer to avoid crash.
Changed option name _FS_SHARE to _FS_LOCK. Changed option name _FS_SHARE to _FS_LOCK.
Fixed assertion failure due to OS/2 EA on FAT12/16 volume. Fixed assertion failure due to OS/2 EA on FAT12/16 volume.
R0.09b (January 24, 2013) R0.09b (January 24, 2013)
Added f_setlabel() and f_getlabel(). Added f_setlabel() and f_getlabel().
R0.10 (October 02, 2013) R0.10 (October 02, 2013)
Added selection of character encoding on the file. (_STRF_ENCODE) Added selection of character encoding on the file. (_STRF_ENCODE)
Added f_closedir(). Added f_closedir().
Added forced full FAT scan for f_getfree(). (_FS_NOFSINFO) Added forced full FAT scan for f_getfree(). (_FS_NOFSINFO)
Added forced mount feature with changes of f_mount(). Added forced mount feature with changes of f_mount().
Improved behavior of volume auto detection. Improved behavior of volume auto detection.
Improved write throughput of f_puts() and f_printf(). Improved write throughput of f_puts() and f_printf().
Changed argument of f_chdrive(), f_mkfs(), disk_read() and disk_write(). Changed argument of f_chdrive(), f_mkfs(), disk_read() and disk_write().
Fixed f_write() can be truncated when the file size is close to 4GB. Fixed f_write() can be truncated when the file size is close to 4GB.
Fixed f_open(), f_mkdir() and f_setlabel() can return incorrect value on error. Fixed f_open(), f_mkdir() and f_setlabel() can return incorrect value on error.
R0.10a (January 15, 2014) R0.10a (January 15, 2014)
Added arbitrary strings as drive number in the path name. (_STR_VOLUME_ID) Added arbitrary strings as drive number in the path name. (_STR_VOLUME_ID)
Added a configuration option of minimum sector size. (_MIN_SS) Added a configuration option of minimum sector size. (_MIN_SS)
2nd argument of f_rename() can have a drive number and it will be ignored. 2nd argument of f_rename() can have a drive number and it will be ignored.
Fixed f_mount() with forced mount fails when drive number is >= 1. (appeared at R0.10) Fixed f_mount() with forced mount fails when drive number is >= 1. (appeared at R0.10)
Fixed f_close() invalidates the file object without volume lock. Fixed f_close() invalidates the file object without volume lock.
Fixed f_closedir() returns but the volume lock is left acquired. (appeared at R0.10) Fixed f_closedir() returns but the volume lock is left acquired. (appeared at R0.10)
Fixed creation of an entry with LFN fails on too many SFN collisions. (appeared at R0.07) Fixed creation of an entry with LFN fails on too many SFN collisions. (appeared at R0.07)
R0.10b (May 19, 2014) R0.10b (May 19, 2014)
Fixed a hard error in the disk I/O layer can collapse the directory entry. Fixed a hard error in the disk I/O layer can collapse the directory entry.
Fixed LFN entry is not deleted when delete/rename an object with lossy converted SFN. (appeared at R0.07) Fixed LFN entry is not deleted when delete/rename an object with lossy converted SFN. (appeared at R0.07)
R0.10c (November 09, 2014) R0.10c (November 09, 2014)
Added a configuration option for the platforms without RTC. (_FS_NORTC) Added a configuration option for the platforms without RTC. (_FS_NORTC)
Changed option name _USE_ERASE to _USE_TRIM. Changed option name _USE_ERASE to _USE_TRIM.
Fixed volume label created by Mac OS X cannot be retrieved with f_getlabel(). (appeared at R0.09b) Fixed volume label created by Mac OS X cannot be retrieved with f_getlabel(). (appeared at R0.09b)
Fixed a potential problem of FAT access that can appear on disk error. Fixed a potential problem of FAT access that can appear on disk error.
Fixed null pointer dereference on attempting to delete the root direcotry. (appeared at R0.08) Fixed null pointer dereference on attempting to delete the root direcotry. (appeared at R0.08)
R0.11 (February 09, 2015) R0.11 (February 09, 2015)
Added f_findfirst(), f_findnext() and f_findclose(). (_USE_FIND) Added f_findfirst(), f_findnext() and f_findclose(). (_USE_FIND)
Fixed f_unlink() does not remove cluster chain of the file. (appeared at R0.10c) Fixed f_unlink() does not remove cluster chain of the file. (appeared at R0.10c)
Fixed _FS_NORTC option does not work properly. (appeared at R0.10c) Fixed _FS_NORTC option does not work properly. (appeared at R0.10c)
R0.11a (September 05, 2015) R0.11a (September 05, 2015)
Fixed wrong media change can lead a deadlock at thread-safe configuration. Fixed wrong media change can lead a deadlock at thread-safe configuration.
Added code page 771, 860, 861, 863, 864, 865 and 869. (_CODE_PAGE) Added code page 771, 860, 861, 863, 864, 865 and 869. (_CODE_PAGE)
Removed some code pages actually not exist on the standard systems. (_CODE_PAGE) Removed some code pages actually not exist on the standard systems. (_CODE_PAGE)
Fixed errors in the case conversion teble of code page 437 and 850 (ff.c). Fixed errors in the case conversion teble of code page 437 and 850 (ff.c).
Fixed errors in the case conversion teble of Unicode (cc*.c). Fixed errors in the case conversion teble of Unicode (cc*.c).
R0.12 (April 12, 2016) R0.12 (April 12, 2016)
Added support for exFAT file system. (_FS_EXFAT) Added support for exFAT file system. (_FS_EXFAT)
Added f_expand(). (_USE_EXPAND) Added f_expand(). (_USE_EXPAND)
Changed some members in FINFO structure and behavior of f_readdir(). Changed some members in FINFO structure and behavior of f_readdir().
Added an option _USE_CHMOD. Added an option _USE_CHMOD.
Removed an option _WORD_ACCESS. Removed an option _WORD_ACCESS.
Fixed errors in the case conversion table of Unicode (cc*.c). Fixed errors in the case conversion table of Unicode (cc*.c).
R0.12a (July 10, 2016) R0.12a (July 10, 2016)
Added support for creating exFAT volume with some changes of f_mkfs(). Added support for creating exFAT volume with some changes of f_mkfs().
Added a file open method FA_OPEN_APPEND. An f_lseek() following f_open() is no longer needed. Added a file open method FA_OPEN_APPEND. An f_lseek() following f_open() is no longer needed.
f_forward() is available regardless of _FS_TINY. f_forward() is available regardless of _FS_TINY.
Fixed f_mkfs() creates wrong volume. (appeared at R0.12) Fixed f_mkfs() creates wrong volume. (appeared at R0.12)
Fixed wrong memory read in create_name(). (appeared at R0.12) Fixed wrong memory read in create_name(). (appeared at R0.12)
Fixed compilation fails at some configurations, _USE_FASTSEEK and _USE_FORWARD. Fixed compilation fails at some configurations, _USE_FASTSEEK and _USE_FORWARD.
R0.12b (September 04, 2016) R0.12b (September 04, 2016)
Made f_rename() be able to rename objects with the same name but case. Made f_rename() be able to rename objects with the same name but case.
Fixed an error in the case conversion teble of code page 866. (ff.c) Fixed an error in the case conversion teble of code page 866. (ff.c)
Fixed writing data is truncated at the file offset 4GiB on the exFAT volume. (appeared at R0.12) Fixed writing data is truncated at the file offset 4GiB on the exFAT volume. (appeared at R0.12)
Fixed creating a file in the root directory of exFAT volume can fail. (appeared at R0.12) Fixed creating a file in the root directory of exFAT volume can fail. (appeared at R0.12)
Fixed f_mkfs() creating exFAT volume with too small cluster size can collapse unallocated memory. (appeared at R0.12) Fixed f_mkfs() creating exFAT volume with too small cluster size can collapse unallocated memory. (appeared at R0.12)
Fixed wrong object name can be returned when read directory at Unicode cfg. (appeared at R0.12) Fixed wrong object name can be returned when read directory at Unicode cfg. (appeared at R0.12)
Fixed large file allocation/removing on the exFAT volume collapses allocation bitmap. (appeared at R0.12) Fixed large file allocation/removing on the exFAT volume collapses allocation bitmap. (appeared at R0.12)
Fixed some internal errors in f_expand() and f_lseek(). (appeared at R0.12) Fixed some internal errors in f_expand() and f_lseek(). (appeared at R0.12)
R0.12c (March 04, 2017) R0.12c (March 04, 2017)
Improved write throughput at the fragmented file on the exFAT volume. Improved write throughput at the fragmented file on the exFAT volume.
Made memory usage for exFAT be able to be reduced as decreasing _MAX_LFN. Made memory usage for exFAT be able to be reduced as decreasing _MAX_LFN.
Fixed successive f_getfree() can return wrong count on the FAT12/16 volume. (appeared at R0.12) Fixed successive f_getfree() can return wrong count on the FAT12/16 volume. (appeared at R0.12)
Fixed configuration option _VOLUMES cannot be set 10. (appeared at R0.10c) Fixed configuration option _VOLUMES cannot be set 10. (appeared at R0.10c)
R0.13 (May 21, 2017) R0.13 (May 21, 2017)
Changed heading character of configuration keywords "_" to "FF_". Changed heading character of configuration keywords "_" to "FF_".
Removed ASCII-only configuration, FF_CODE_PAGE = 1. Use FF_CODE_PAGE = 437 instead. Removed ASCII-only configuration, FF_CODE_PAGE = 1. Use FF_CODE_PAGE = 437 instead.
Added f_setcp(), run-time code page configuration. (FF_CODE_PAGE = 0) Added f_setcp(), run-time code page configuration. (FF_CODE_PAGE = 0)
Improved cluster allocation time on stretch a deep buried cluster chain. Improved cluster allocation time on stretch a deep buried cluster chain.
Improved processing time of f_mkdir() with large cluster size by using FF_USE_LFN = 3. Improved processing time of f_mkdir() with large cluster size by using FF_USE_LFN = 3.
Improved NoFatChain flag of the fragmented file to be set after it is truncated and got contiguous. Improved NoFatChain flag of the fragmented file to be set after it is truncated and got contiguous.
Fixed archive attribute is left not set when a file on the exFAT volume is renamed. (appeared at R0.12) Fixed archive attribute is left not set when a file on the exFAT volume is renamed. (appeared at R0.12)
Fixed exFAT FAT entry can be collapsed when write or lseek operation to the existing file is done. (appeared at R0.12c) Fixed exFAT FAT entry can be collapsed when write or lseek operation to the existing file is done. (appeared at R0.12c)
Fixed creating a file can fail when a new cluster allocation to the exFAT directory occures. (appeared at R0.12c) Fixed creating a file can fail when a new cluster allocation to the exFAT directory occures. (appeared at R0.12c)
R0.13a (October 14, 2017) R0.13a (October 14, 2017)
Added support for UTF-8 encoding on the API. (FF_LFN_UNICODE = 2) Added support for UTF-8 encoding on the API. (FF_LFN_UNICODE = 2)
Added options for file name output buffer. (FF_LFN_BUF, FF_SFN_BUF). Added options for file name output buffer. (FF_LFN_BUF, FF_SFN_BUF).
Added dynamic memory allocation option for working buffer of f_mkfs() and f_fdisk(). Added dynamic memory allocation option for working buffer of f_mkfs() and f_fdisk().
Fixed f_fdisk() and f_mkfs() create the partition table with wrong CHS parameters. (appeared at R0.09) Fixed f_fdisk() and f_mkfs() create the partition table with wrong CHS parameters. (appeared at R0.09)
Fixed f_unlink() can cause lost clusters at fragmented file on the exFAT volume. (appeared at R0.12c) Fixed f_unlink() can cause lost clusters at fragmented file on the exFAT volume. (appeared at R0.12c)
Fixed f_setlabel() rejects some valid characters for exFAT volume. (appeared at R0.12) Fixed f_setlabel() rejects some valid characters for exFAT volume. (appeared at R0.12)
R0.13b (April 07, 2018) R0.13b (April 07, 2018)
Added support for UTF-32 encoding on the API. (FF_LFN_UNICODE = 3) Added support for UTF-32 encoding on the API. (FF_LFN_UNICODE = 3)
Added support for Unix style volume ID. (FF_STR_VOLUME_ID = 2) Added support for Unix style volume ID. (FF_STR_VOLUME_ID = 2)
Fixed accesing any object on the exFAT root directory beyond the cluster boundary can fail. (appeared at R0.12c) Fixed accesing any object on the exFAT root directory beyond the cluster boundary can fail. (appeared at R0.12c)
Fixed f_setlabel() does not reject some invalid characters. (appeared at R0.09b) Fixed f_setlabel() does not reject some invalid characters. (appeared at R0.09b)
R0.13c (October 14, 2018)
Supported stdint.h for C99 and later. (integer.h was included in ff.h)
Fixed reading a directory gets infinite loop when the last directory entry is not empty. (appeared at R0.12)
Fixed creating a sub-directory in the fragmented sub-directory on the exFAT volume collapses FAT chain of the parent directory. (appeared at R0.12)
Fixed f_getcwd() cause output buffer overrun when the buffer has a valid drive number. (appeared at R0.13b)

View File

@ -1,22 +1,21 @@
FatFs Module Source Files R0.13b FatFs Module Source Files R0.13c
FILES FILES
00readme.txt This file. 00readme.txt This file.
00history.txt Revision history. 00history.txt Revision history.
ff.c FatFs module. ff.c FatFs module.
ffconf.h Configuration file of FatFs module. ffconf.h Configuration file of FatFs module.
ff.h Common include file for FatFs and application module. ff.h Common include file for FatFs and application module.
diskio.h Common include file for FatFs and disk I/O module. diskio.h Common include file for FatFs and disk I/O module.
diskio.c An example of glue function to attach existing disk I/O module to FatFs. diskio.c An example of glue function to attach existing disk I/O module to FatFs.
integer.h Integer type definitions for FatFs. ffunicode.c Optional Unicode utility functions.
ffunicode.c Optional Unicode utility functions. ffsystem.c An example of optional O/S related functions.
ffsystem.c An example of optional O/S related functions.
Low level disk I/O module is not included in this archive because the FatFs
Low level disk I/O module is not included in this archive because the FatFs module is only a generic file system layer and it does not depend on any specific
module is only a generic file system layer and it does not depend on any specific storage device. You need to provide a low level disk I/O module written to
storage device. You need to provide a low level disk I/O module written to control the storage device that attached to the target system.
control the storage device that attached to the target system.

View File

@ -1,95 +1,100 @@
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* Low level disk I/O module skeleton for FatFs (C)ChaN, 2016 */ /* Low level disk I/O module skeleton for FatFs (C)ChaN, 2016 */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* If a working storage control module is available, it should be */ /* If a working storage control module is available, it should be */
/* attached to the FatFs via a glue function rather than modifying it. */ /* attached to the FatFs via a glue function rather than modifying it. */
/* This is an example of glue functions to attach various exsisting */ /* This is an example of glue functions to attach various exsisting */
/* storage control modules to the FatFs module with a defined API. */ /* storage control modules to the FatFs module with a defined API. */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
#include <stdbool.h> #include <stdbool.h>
#include <string.h> #include <string.h>
#include "diskio.h" /* FatFs lower layer API */ #include "ff.h" /* Obtains integer types */
#include "../../fs_utils.h" #include "diskio.h" /* Declarations of disk functions */
#include "../../fs_utils.h"
/*-----------------------------------------------------------------------*/
/* Get Drive Status */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* Get Drive Status */
DSTATUS disk_status ( /*-----------------------------------------------------------------------*/
BYTE pdrv /* Physical drive nmuber to identify the drive */
) DSTATUS disk_status (
{ BYTE pdrv /* Physical drive nmuber to identify the drive */
return 0; )
} {
return 0;
}
/*-----------------------------------------------------------------------*/
/* Inidialize a Drive */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* Inidialize a Drive */
DSTATUS disk_initialize ( /*-----------------------------------------------------------------------*/
BYTE pdrv /* Physical drive nmuber to identify the drive */
) DSTATUS disk_initialize (
{ BYTE pdrv /* Physical drive nmuber to identify the drive */
return 0; )
} {
return 0;
}
/*-----------------------------------------------------------------------*/
/* Read Sector(s) */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* Read Sector(s) */
DRESULT disk_read ( /*-----------------------------------------------------------------------*/
BYTE pdrv, /* Physical drive nmuber to identify the drive */
BYTE *buff, /* Data buffer to store read data */ DRESULT disk_read (
DWORD sector, /* Start sector in LBA */ BYTE pdrv, /* Physical drive nmuber to identify the drive */
UINT count /* Number of sectors to read */ BYTE *buff, /* Data buffer to store read data */
) DWORD sector, /* Start sector in LBA */
{ UINT count /* Number of sectors to read */
switch (pdrv) { )
case 0: {
return sdmmc_device_read(&g_sd_device, sector, count, (void *)buff) ? RES_OK : RES_ERROR; switch (pdrv) {
default: case 0:
return RES_PARERR; return sdmmc_device_read(&g_sd_device, sector, count, (void *)buff) ? RES_OK : RES_ERROR;
} default:
} return RES_PARERR;
}
}
/*-----------------------------------------------------------------------*/
/* Write Sector(s) */
/*-----------------------------------------------------------------------*/ /*-----------------------------------------------------------------------*/
/* Write Sector(s) */
DRESULT disk_write ( /*-----------------------------------------------------------------------*/
BYTE pdrv, /* Physical drive nmuber to identify the drive */
const BYTE *buff, /* Data to be written */ #if FF_FS_READONLY == 0
DWORD sector, /* Start sector in LBA */
UINT count /* Number of sectors to write */ DRESULT disk_write (
) BYTE pdrv, /* Physical drive nmuber to identify the drive */
{ const BYTE *buff, /* Data to be written */
switch (pdrv) { DWORD sector, /* Start sector in LBA */
case 0: UINT count /* Number of sectors to write */
return sdmmc_device_write(&g_sd_device, sector, count, (void *)buff) ? RES_OK : RES_ERROR; )
default: {
return RES_PARERR; switch (pdrv) {
} case 0:
} return sdmmc_device_write(&g_sd_device, sector, count, (void *)buff) ? RES_OK : RES_ERROR;
default:
return RES_PARERR;
}
/*-----------------------------------------------------------------------*/ }
/* Miscellaneous Functions */
/*-----------------------------------------------------------------------*/ #endif
DRESULT disk_ioctl (
BYTE pdrv, /* Physical drive nmuber (0..) */ /*-----------------------------------------------------------------------*/
BYTE cmd, /* Control code */ /* Miscellaneous Functions */
void *buff /* Buffer to send/receive control data */ /*-----------------------------------------------------------------------*/
)
{ DRESULT disk_ioctl (
return RES_OK; BYTE pdrv, /* Physical drive nmuber (0..) */
} BYTE cmd, /* Control code */
void *buff /* Buffer to send/receive control data */
)
{
return RES_OK;
}

View File

@ -1,80 +1,77 @@
/*-----------------------------------------------------------------------/ /*-----------------------------------------------------------------------/
/ Low level disk interface modlue include file (C)ChaN, 2014 / / Low level disk interface modlue include file (C)ChaN, 2014 /
/-----------------------------------------------------------------------*/ /-----------------------------------------------------------------------*/
#ifndef _DISKIO_DEFINED #ifndef _DISKIO_DEFINED
#define _DISKIO_DEFINED #define _DISKIO_DEFINED
#ifdef __cplusplus #ifdef __cplusplus
extern "C" { extern "C" {
#endif #endif
#include "integer.h" /* Status of Disk Functions */
typedef BYTE DSTATUS;
/* Status of Disk Functions */ /* Results of Disk Functions */
typedef BYTE DSTATUS; typedef enum {
RES_OK = 0, /* 0: Successful */
/* Results of Disk Functions */ RES_ERROR, /* 1: R/W Error */
typedef enum { RES_WRPRT, /* 2: Write Protected */
RES_OK = 0, /* 0: Successful */ RES_NOTRDY, /* 3: Not Ready */
RES_ERROR, /* 1: R/W Error */ RES_PARERR /* 4: Invalid Parameter */
RES_WRPRT, /* 2: Write Protected */ } DRESULT;
RES_NOTRDY, /* 3: Not Ready */
RES_PARERR /* 4: Invalid Parameter */
} DRESULT; /*---------------------------------------*/
/* Prototypes for disk control functions */
/*---------------------------------------*/
/* Prototypes for disk control functions */ DSTATUS disk_initialize (BYTE pdrv);
DSTATUS disk_status (BYTE pdrv);
DRESULT disk_read (BYTE pdrv, BYTE* buff, DWORD sector, UINT count);
DSTATUS disk_initialize (BYTE pdrv); DRESULT disk_write (BYTE pdrv, const BYTE* buff, DWORD sector, UINT count);
DSTATUS disk_status (BYTE pdrv); DRESULT disk_ioctl (BYTE pdrv, BYTE cmd, void* buff);
DRESULT disk_read (BYTE pdrv, BYTE* buff, DWORD sector, UINT count);
DRESULT disk_write (BYTE pdrv, const BYTE* buff, DWORD sector, UINT count);
DRESULT disk_ioctl (BYTE pdrv, BYTE cmd, void* buff); /* Disk Status Bits (DSTATUS) */
#define STA_NOINIT 0x01 /* Drive not initialized */
/* Disk Status Bits (DSTATUS) */ #define STA_NODISK 0x02 /* No medium in the drive */
#define STA_PROTECT 0x04 /* Write protected */
#define STA_NOINIT 0x01 /* Drive not initialized */
#define STA_NODISK 0x02 /* No medium in the drive */
#define STA_PROTECT 0x04 /* Write protected */ /* Command code for disk_ioctrl fucntion */
/* Generic command (Used by FatFs) */
/* Command code for disk_ioctrl fucntion */ #define CTRL_SYNC 0 /* Complete pending write process (needed at FF_FS_READONLY == 0) */
#define GET_SECTOR_COUNT 1 /* Get media size (needed at FF_USE_MKFS == 1) */
/* Generic command (Used by FatFs) */ #define GET_SECTOR_SIZE 2 /* Get sector size (needed at FF_MAX_SS != FF_MIN_SS) */
#define CTRL_SYNC 0 /* Complete pending write process (needed at FF_FS_READONLY == 0) */ #define GET_BLOCK_SIZE 3 /* Get erase block size (needed at FF_USE_MKFS == 1) */
#define GET_SECTOR_COUNT 1 /* Get media size (needed at FF_USE_MKFS == 1) */ #define CTRL_TRIM 4 /* Inform device that the data on the block of sectors is no longer used (needed at FF_USE_TRIM == 1) */
#define GET_SECTOR_SIZE 2 /* Get sector size (needed at FF_MAX_SS != FF_MIN_SS) */
#define GET_BLOCK_SIZE 3 /* Get erase block size (needed at FF_USE_MKFS == 1) */ /* Generic command (Not used by FatFs) */
#define CTRL_TRIM 4 /* Inform device that the data on the block of sectors is no longer used (needed at FF_USE_TRIM == 1) */ #define CTRL_POWER 5 /* Get/Set power status */
#define CTRL_LOCK 6 /* Lock/Unlock media removal */
/* Generic command (Not used by FatFs) */ #define CTRL_EJECT 7 /* Eject media */
#define CTRL_POWER 5 /* Get/Set power status */ #define CTRL_FORMAT 8 /* Create physical format on the media */
#define CTRL_LOCK 6 /* Lock/Unlock media removal */
#define CTRL_EJECT 7 /* Eject media */ /* MMC/SDC specific ioctl command */
#define CTRL_FORMAT 8 /* Create physical format on the media */ #define MMC_GET_TYPE 10 /* Get card type */
#define MMC_GET_CSD 11 /* Get CSD */
/* MMC/SDC specific ioctl command */ #define MMC_GET_CID 12 /* Get CID */
#define MMC_GET_TYPE 10 /* Get card type */ #define MMC_GET_OCR 13 /* Get OCR */
#define MMC_GET_CSD 11 /* Get CSD */ #define MMC_GET_SDSTAT 14 /* Get SD status */
#define MMC_GET_CID 12 /* Get CID */ #define ISDIO_READ 55 /* Read data form SD iSDIO register */
#define MMC_GET_OCR 13 /* Get OCR */ #define ISDIO_WRITE 56 /* Write data to SD iSDIO register */
#define MMC_GET_SDSTAT 14 /* Get SD status */ #define ISDIO_MRITE 57 /* Masked write data to SD iSDIO register */
#define ISDIO_READ 55 /* Read data form SD iSDIO register */
#define ISDIO_WRITE 56 /* Write data to SD iSDIO register */ /* ATA/CF specific ioctl command */
#define ISDIO_MRITE 57 /* Masked write data to SD iSDIO register */ #define ATA_GET_REV 20 /* Get F/W revision */
#define ATA_GET_MODEL 21 /* Get model name */
/* ATA/CF specific ioctl command */ #define ATA_GET_SN 22 /* Get serial number */
#define ATA_GET_REV 20 /* Get F/W revision */
#define ATA_GET_MODEL 21 /* Get model name */ #ifdef __cplusplus
#define ATA_GET_SN 22 /* Get serial number */ }
#endif
#ifdef __cplusplus
} #endif
#endif
#endif

File diff suppressed because it is too large Load Diff

View File

@ -1,376 +1,405 @@
/*----------------------------------------------------------------------------/ /*----------------------------------------------------------------------------/
/ FatFs - Generic FAT Filesystem module R0.13b / / FatFs - Generic FAT Filesystem module R0.13c /
/-----------------------------------------------------------------------------/ /-----------------------------------------------------------------------------/
/ /
/ Copyright (C) 2018, ChaN, all right reserved. / Copyright (C) 2018, ChaN, all right reserved.
/ /
/ FatFs module is an open source software. Redistribution and use of FatFs in / FatFs module is an open source software. Redistribution and use of FatFs in
/ source and binary forms, with or without modification, are permitted provided / source and binary forms, with or without modification, are permitted provided
/ that the following condition is met: / that the following condition is met:
/ 1. Redistributions of source code must retain the above copyright notice, / 1. Redistributions of source code must retain the above copyright notice,
/ this condition and the following disclaimer. / this condition and the following disclaimer.
/ /
/ This software is provided by the copyright holder and contributors "AS IS" / This software is provided by the copyright holder and contributors "AS IS"
/ and any warranties related to this software are DISCLAIMED. / and any warranties related to this software are DISCLAIMED.
/ The copyright owner or contributors be NOT LIABLE for any damages caused / The copyright owner or contributors be NOT LIABLE for any damages caused
/ by use of this software. / by use of this software.
/ /
/----------------------------------------------------------------------------*/ /----------------------------------------------------------------------------*/
#ifndef FF_DEFINED #ifndef FF_DEFINED
#define FF_DEFINED 63463 /* Revision ID */ #define FF_DEFINED 86604 /* Revision ID */
#ifdef __cplusplus #ifdef __cplusplus
extern "C" { extern "C" {
#endif #endif
#include "integer.h" /* Basic integer types */ #include "ffconf.h" /* FatFs configuration options */
#include "ffconf.h" /* FatFs configuration options */
#if FF_DEFINED != FFCONF_DEF
#if FF_DEFINED != FFCONF_DEF #error Wrong configuration file (ffconf.h).
#error Wrong configuration file (ffconf.h). #endif
#endif
/* Integer types used for FatFs API */
/* Definitions of volume management */ #if defined(_WIN32) /* Main development platform */
#define FF_INTDEF 2
#if FF_MULTI_PARTITION /* Multiple partition configuration */ #include <windows.h>
typedef struct { typedef unsigned __int64 QWORD;
BYTE pd; /* Physical drive number */ #elif (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || defined(__cplusplus) /* C99 or later */
BYTE pt; /* Partition: 0:Auto detect, 1-4:Forced partition) */ #define FF_INTDEF 2
} PARTITION; #include <stdint.h>
extern PARTITION VolToPart[]; /* Volume - Partition resolution table */ typedef unsigned int UINT; /* int must be 16-bit or 32-bit */
#endif typedef unsigned char BYTE; /* char must be 8-bit */
typedef uint16_t WORD; /* 16-bit unsigned integer */
#if FF_STR_VOLUME_ID typedef uint16_t WCHAR; /* 16-bit unsigned integer */
#ifndef FF_VOLUME_STRS typedef uint32_t DWORD; /* 32-bit unsigned integer */
extern const char* VolumeStr[FF_VOLUMES]; /* User defied volume ID */ typedef uint64_t QWORD; /* 64-bit unsigned integer */
#endif #else /* Earlier than C99 */
#endif #define FF_INTDEF 1
typedef unsigned int UINT; /* int must be 16-bit or 32-bit */
typedef unsigned char BYTE; /* char must be 8-bit */
typedef unsigned short WORD; /* 16-bit unsigned integer */
/* Type of path name strings on FatFs API */ typedef unsigned short WCHAR; /* 16-bit unsigned integer */
typedef unsigned long DWORD; /* 32-bit unsigned integer */
#ifndef _INC_TCHAR #endif
#define _INC_TCHAR
#if FF_USE_LFN && FF_LFN_UNICODE == 1 /* Unicode in UTF-16 encoding */ /* Definitions of volume management */
typedef WCHAR TCHAR;
#define _T(x) L ## x #if FF_MULTI_PARTITION /* Multiple partition configuration */
#define _TEXT(x) L ## x typedef struct {
#elif FF_USE_LFN && FF_LFN_UNICODE == 2 /* Unicode in UTF-8 encoding */ BYTE pd; /* Physical drive number */
typedef char TCHAR; BYTE pt; /* Partition: 0:Auto detect, 1-4:Forced partition) */
#define _T(x) u8 ## x } PARTITION;
#define _TEXT(x) u8 ## x extern PARTITION VolToPart[]; /* Volume - Partition resolution table */
#elif FF_USE_LFN && FF_LFN_UNICODE == 3 /* Unicode in UTF-32 encoding */ #endif
typedef DWORD TCHAR;
#define _T(x) U ## x #if FF_STR_VOLUME_ID
#define _TEXT(x) U ## x #ifndef FF_VOLUME_STRS
#elif FF_USE_LFN && (FF_LFN_UNICODE < 0 || FF_LFN_UNICODE > 3) extern const char* VolumeStr[FF_VOLUMES]; /* User defied volume ID */
#error Wrong FF_LFN_UNICODE setting #endif
#else /* ANSI/OEM code in SBCS/DBCS */ #endif
typedef char TCHAR;
#define _T(x) x
#define _TEXT(x) x
#endif /* Type of path name strings on FatFs API */
#endif #ifndef _INC_TCHAR
#define _INC_TCHAR
#if FF_USE_LFN && FF_LFN_UNICODE == 1 /* Unicode in UTF-16 encoding */
/* Type of file size variables */ typedef WCHAR TCHAR;
#define _T(x) L ## x
#if FF_FS_EXFAT #define _TEXT(x) L ## x
typedef QWORD FSIZE_t; #elif FF_USE_LFN && FF_LFN_UNICODE == 2 /* Unicode in UTF-8 encoding */
#else typedef char TCHAR;
typedef DWORD FSIZE_t; #define _T(x) u8 ## x
#endif #define _TEXT(x) u8 ## x
#elif FF_USE_LFN && FF_LFN_UNICODE == 3 /* Unicode in UTF-32 encoding */
typedef DWORD TCHAR;
#define _T(x) U ## x
/* Filesystem object structure (FATFS) */ #define _TEXT(x) U ## x
#elif FF_USE_LFN && (FF_LFN_UNICODE < 0 || FF_LFN_UNICODE > 3)
typedef struct { #error Wrong FF_LFN_UNICODE setting
BYTE fs_type; /* Filesystem type (0:N/A) */ #else /* ANSI/OEM code in SBCS/DBCS */
BYTE pdrv; /* Physical drive number */ typedef char TCHAR;
BYTE n_fats; /* Number of FATs (1 or 2) */ #define _T(x) x
BYTE wflag; /* win[] flag (b0:dirty) */ #define _TEXT(x) x
BYTE fsi_flag; /* FSINFO flags (b7:disabled, b0:dirty) */ #endif
WORD id; /* Volume mount ID */
WORD n_rootdir; /* Number of root directory entries (FAT12/16) */ #endif
WORD csize; /* Cluster size [sectors] */
#if FF_MAX_SS != FF_MIN_SS
WORD ssize; /* Sector size (512, 1024, 2048 or 4096) */
#endif /* Type of file size variables */
#if FF_USE_LFN
WCHAR* lfnbuf; /* LFN working buffer */ #if FF_FS_EXFAT
#endif #if FF_INTDEF != 2
#if FF_FS_EXFAT #error exFAT feature wants C99 or later
BYTE* dirbuf; /* Directory entry block scratchpad buffer for exFAT */ #endif
#endif typedef QWORD FSIZE_t;
#if FF_FS_REENTRANT #else
FF_SYNC_t sobj; /* Identifier of sync object */ typedef DWORD FSIZE_t;
#endif #endif
#if !FF_FS_READONLY
DWORD last_clst; /* Last allocated cluster */
DWORD free_clst; /* Number of free clusters */
#endif /* Filesystem object structure (FATFS) */
#if FF_FS_RPATH
DWORD cdir; /* Current directory start cluster (0:root) */ typedef struct {
#if FF_FS_EXFAT BYTE fs_type; /* Filesystem type (0:not mounted) */
DWORD cdc_scl; /* Containing directory start cluster (invalid when cdir is 0) */ BYTE pdrv; /* Associated physical drive */
DWORD cdc_size; /* b31-b8:Size of containing directory, b7-b0: Chain status */ BYTE n_fats; /* Number of FATs (1 or 2) */
DWORD cdc_ofs; /* Offset in the containing directory (invalid when cdir is 0) */ BYTE wflag; /* win[] flag (b0:dirty) */
#endif BYTE fsi_flag; /* FSINFO flags (b7:disabled, b0:dirty) */
#endif WORD id; /* Volume mount ID */
DWORD n_fatent; /* Number of FAT entries (number of clusters + 2) */ WORD n_rootdir; /* Number of root directory entries (FAT12/16) */
DWORD fsize; /* Size of an FAT [sectors] */ WORD csize; /* Cluster size [sectors] */
DWORD volbase; /* Volume base sector */ #if FF_MAX_SS != FF_MIN_SS
DWORD fatbase; /* FAT base sector */ WORD ssize; /* Sector size (512, 1024, 2048 or 4096) */
DWORD dirbase; /* Root directory base sector/cluster */ #endif
DWORD database; /* Data base sector */ #if FF_USE_LFN
DWORD winsect; /* Current sector appearing in the win[] */ WCHAR* lfnbuf; /* LFN working buffer */
BYTE win[FF_MAX_SS]; /* Disk access window for Directory, FAT (and file data at tiny cfg) */ #endif
} FATFS; #if FF_FS_EXFAT
BYTE* dirbuf; /* Directory entry block scratchpad buffer for exFAT */
#endif
#if FF_FS_REENTRANT
/* Object ID and allocation information (FFOBJID) */ FF_SYNC_t sobj; /* Identifier of sync object */
#endif
typedef struct { #if !FF_FS_READONLY
FATFS* fs; /* Pointer to the hosting volume of this object */ DWORD last_clst; /* Last allocated cluster */
WORD id; /* Hosting volume mount ID */ DWORD free_clst; /* Number of free clusters */
BYTE attr; /* Object attribute */ #endif
BYTE stat; /* Object chain status (b1-0: =0:not contiguous, =2:contiguous, =3:flagmented in this session, b2:sub-directory stretched) */ #if FF_FS_RPATH
DWORD sclust; /* Object data start cluster (0:no cluster or root directory) */ DWORD cdir; /* Current directory start cluster (0:root) */
FSIZE_t objsize; /* Object size (valid when sclust != 0) */ #if FF_FS_EXFAT
#if FF_FS_EXFAT DWORD cdc_scl; /* Containing directory start cluster (invalid when cdir is 0) */
DWORD n_cont; /* Size of first fragment - 1 (valid when stat == 3) */ DWORD cdc_size; /* b31-b8:Size of containing directory, b7-b0: Chain status */
DWORD n_frag; /* Size of last fragment needs to be written to FAT (valid when not zero) */ DWORD cdc_ofs; /* Offset in the containing directory (invalid when cdir is 0) */
DWORD c_scl; /* Containing directory start cluster (valid when sclust != 0) */ #endif
DWORD c_size; /* b31-b8:Size of containing directory, b7-b0: Chain status (valid when c_scl != 0) */ #endif
DWORD c_ofs; /* Offset in the containing directory (valid when file object and sclust != 0) */ DWORD n_fatent; /* Number of FAT entries (number of clusters + 2) */
#endif DWORD fsize; /* Size of an FAT [sectors] */
#if FF_FS_LOCK DWORD volbase; /* Volume base sector */
UINT lockid; /* File lock ID origin from 1 (index of file semaphore table Files[]) */ DWORD fatbase; /* FAT base sector */
#endif DWORD dirbase; /* Root directory base sector/cluster */
} FFOBJID; DWORD database; /* Data base sector */
#if FF_FS_EXFAT
DWORD bitbase; /* Allocation bitmap base sector */
#endif
/* File object structure (FIL) */ DWORD winsect; /* Current sector appearing in the win[] */
BYTE win[FF_MAX_SS]; /* Disk access window for Directory, FAT (and file data at tiny cfg) */
typedef struct { } FATFS;
FFOBJID obj; /* Object identifier (must be the 1st member to detect invalid object pointer) */
BYTE flag; /* File status flags */
BYTE err; /* Abort flag (error code) */
FSIZE_t fptr; /* File read/write pointer (Zeroed on file open) */ /* Object ID and allocation information (FFOBJID) */
DWORD clust; /* Current cluster of fpter (invalid when fptr is 0) */
DWORD sect; /* Sector number appearing in buf[] (0:invalid) */ typedef struct {
#if !FF_FS_READONLY FATFS* fs; /* Pointer to the hosting volume of this object */
DWORD dir_sect; /* Sector number containing the directory entry (not used at exFAT) */ WORD id; /* Hosting volume mount ID */
BYTE* dir_ptr; /* Pointer to the directory entry in the win[] (not used at exFAT) */ BYTE attr; /* Object attribute */
#endif BYTE stat; /* Object chain status (b1-0: =0:not contiguous, =2:contiguous, =3:fragmented in this session, b2:sub-directory stretched) */
#if FF_USE_FASTSEEK DWORD sclust; /* Object data start cluster (0:no cluster or root directory) */
DWORD* cltbl; /* Pointer to the cluster link map table (nulled on open, set by application) */ FSIZE_t objsize; /* Object size (valid when sclust != 0) */
#endif #if FF_FS_EXFAT
#if !FF_FS_TINY DWORD n_cont; /* Size of first fragment - 1 (valid when stat == 3) */
BYTE buf[FF_MAX_SS]; /* File private data read/write window */ DWORD n_frag; /* Size of last fragment needs to be written to FAT (valid when not zero) */
#endif DWORD c_scl; /* Containing directory start cluster (valid when sclust != 0) */
} FIL; DWORD c_size; /* b31-b8:Size of containing directory, b7-b0: Chain status (valid when c_scl != 0) */
DWORD c_ofs; /* Offset in the containing directory (valid when file object and sclust != 0) */
#endif
#if FF_FS_LOCK
/* Directory object structure (DIR) */ UINT lockid; /* File lock ID origin from 1 (index of file semaphore table Files[]) */
#endif
typedef struct { } FFOBJID;
FFOBJID obj; /* Object identifier */
DWORD dptr; /* Current read/write offset */
DWORD clust; /* Current cluster */
DWORD sect; /* Current sector (0:Read operation has terminated) */ /* File object structure (FIL) */
BYTE* dir; /* Pointer to the directory item in the win[] */
BYTE fn[12]; /* SFN (in/out) {body[8],ext[3],status[1]} */ typedef struct {
#if FF_USE_LFN FFOBJID obj; /* Object identifier (must be the 1st member to detect invalid object pointer) */
DWORD blk_ofs; /* Offset of current entry block being processed (0xFFFFFFFF:Invalid) */ BYTE flag; /* File status flags */
#endif BYTE err; /* Abort flag (error code) */
#if FF_USE_FIND FSIZE_t fptr; /* File read/write pointer (Zeroed on file open) */
const TCHAR* pat; /* Pointer to the name matching pattern */ DWORD clust; /* Current cluster of fpter (invalid when fptr is 0) */
#endif DWORD sect; /* Sector number appearing in buf[] (0:invalid) */
} DIR; #if !FF_FS_READONLY
DWORD dir_sect; /* Sector number containing the directory entry (not used at exFAT) */
BYTE* dir_ptr; /* Pointer to the directory entry in the win[] (not used at exFAT) */
#endif
/* File information structure (FILINFO) */ #if FF_USE_FASTSEEK
DWORD* cltbl; /* Pointer to the cluster link map table (nulled on open, set by application) */
typedef struct { #endif
FSIZE_t fsize; /* File size */ #if !FF_FS_TINY
WORD fdate; /* Modified date */ BYTE buf[FF_MAX_SS]; /* File private data read/write window */
WORD ftime; /* Modified time */ #endif
BYTE fattrib; /* File attribute */ } FIL;
#if FF_USE_LFN
TCHAR altname[FF_SFN_BUF + 1];/* Altenative file name */
TCHAR fname[FF_LFN_BUF + 1]; /* Primary file name */
#else /* Directory object structure (DIR) */
TCHAR fname[12 + 1]; /* File name */
#endif typedef struct {
} FILINFO; FFOBJID obj; /* Object identifier */
DWORD dptr; /* Current read/write offset */
DWORD clust; /* Current cluster */
DWORD sect; /* Current sector (0:Read operation has terminated) */
/* File function return code (FRESULT) */ BYTE* dir; /* Pointer to the directory item in the win[] */
BYTE fn[12]; /* SFN (in/out) {body[8],ext[3],status[1]} */
typedef enum { #if FF_USE_LFN
FR_OK = 0, /* (0) Succeeded */ DWORD blk_ofs; /* Offset of current entry block being processed (0xFFFFFFFF:Invalid) */
FR_DISK_ERR, /* (1) A hard error occurred in the low level disk I/O layer */ #endif
FR_INT_ERR, /* (2) Assertion failed */ #if FF_USE_FIND
FR_NOT_READY, /* (3) The physical drive cannot work */ const TCHAR* pat; /* Pointer to the name matching pattern */
FR_NO_FILE, /* (4) Could not find the file */ #endif
FR_NO_PATH, /* (5) Could not find the path */ } DIR;
FR_INVALID_NAME, /* (6) The path name format is invalid */
FR_DENIED, /* (7) Access denied due to prohibited access or directory full */
FR_EXIST, /* (8) Access denied due to prohibited access */
FR_INVALID_OBJECT, /* (9) The file/directory object is invalid */ /* File information structure (FILINFO) */
FR_WRITE_PROTECTED, /* (10) The physical drive is write protected */
FR_INVALID_DRIVE, /* (11) The logical drive number is invalid */ typedef struct {
FR_NOT_ENABLED, /* (12) The volume has no work area */ FSIZE_t fsize; /* File size */
FR_NO_FILESYSTEM, /* (13) There is no valid FAT volume */ WORD fdate; /* Modified date */
FR_MKFS_ABORTED, /* (14) The f_mkfs() aborted due to any problem */ WORD ftime; /* Modified time */
FR_TIMEOUT, /* (15) Could not get a grant to access the volume within defined period */ BYTE fattrib; /* File attribute */
FR_LOCKED, /* (16) The operation is rejected according to the file sharing policy */ #if FF_USE_LFN
FR_NOT_ENOUGH_CORE, /* (17) LFN working buffer could not be allocated */ TCHAR altname[FF_SFN_BUF + 1];/* Altenative file name */
FR_TOO_MANY_OPEN_FILES, /* (18) Number of open files > FF_FS_LOCK */ TCHAR fname[FF_LFN_BUF + 1]; /* Primary file name */
FR_INVALID_PARAMETER /* (19) Given parameter is invalid */ #else
} FRESULT; TCHAR fname[12 + 1]; /* File name */
#endif
} FILINFO;
/*--------------------------------------------------------------*/
/* FatFs module application interface */
/* File function return code (FRESULT) */
FRESULT f_open (FIL* fp, const TCHAR* path, BYTE mode); /* Open or create a file */
FRESULT f_close (FIL* fp); /* Close an open file object */ typedef enum {
FRESULT f_read (FIL* fp, void* buff, UINT btr, UINT* br); /* Read data from the file */ FR_OK = 0, /* (0) Succeeded */
FRESULT f_write (FIL* fp, const void* buff, UINT btw, UINT* bw); /* Write data to the file */ FR_DISK_ERR, /* (1) A hard error occurred in the low level disk I/O layer */
FRESULT f_lseek (FIL* fp, FSIZE_t ofs); /* Move file pointer of the file object */ FR_INT_ERR, /* (2) Assertion failed */
FRESULT f_truncate (FIL* fp); /* Truncate the file */ FR_NOT_READY, /* (3) The physical drive cannot work */
FRESULT f_sync (FIL* fp); /* Flush cached data of the writing file */ FR_NO_FILE, /* (4) Could not find the file */
FRESULT f_opendir (DIR* dp, const TCHAR* path); /* Open a directory */ FR_NO_PATH, /* (5) Could not find the path */
FRESULT f_closedir (DIR* dp); /* Close an open directory */ FR_INVALID_NAME, /* (6) The path name format is invalid */
FRESULT f_readdir (DIR* dp, FILINFO* fno); /* Read a directory item */ FR_DENIED, /* (7) Access denied due to prohibited access or directory full */
FRESULT f_findfirst (DIR* dp, FILINFO* fno, const TCHAR* path, const TCHAR* pattern); /* Find first file */ FR_EXIST, /* (8) Access denied due to prohibited access */
FRESULT f_findnext (DIR* dp, FILINFO* fno); /* Find next file */ FR_INVALID_OBJECT, /* (9) The file/directory object is invalid */
FRESULT f_mkdir (const TCHAR* path); /* Create a sub directory */ FR_WRITE_PROTECTED, /* (10) The physical drive is write protected */
FRESULT f_unlink (const TCHAR* path); /* Delete an existing file or directory */ FR_INVALID_DRIVE, /* (11) The logical drive number is invalid */
FRESULT f_rename (const TCHAR* path_old, const TCHAR* path_new); /* Rename/Move a file or directory */ FR_NOT_ENABLED, /* (12) The volume has no work area */
FRESULT f_stat (const TCHAR* path, FILINFO* fno); /* Get file status */ FR_NO_FILESYSTEM, /* (13) There is no valid FAT volume */
FRESULT f_chmod (const TCHAR* path, BYTE attr, BYTE mask); /* Change attribute of a file/dir */ FR_MKFS_ABORTED, /* (14) The f_mkfs() aborted due to any problem */
FRESULT f_utime (const TCHAR* path, const FILINFO* fno); /* Change timestamp of a file/dir */ FR_TIMEOUT, /* (15) Could not get a grant to access the volume within defined period */
FRESULT f_chdir (const TCHAR* path); /* Change current directory */ FR_LOCKED, /* (16) The operation is rejected according to the file sharing policy */
FRESULT f_chdrive (const TCHAR* path); /* Change current drive */ FR_NOT_ENOUGH_CORE, /* (17) LFN working buffer could not be allocated */
FRESULT f_getcwd (TCHAR* buff, UINT len); /* Get current directory */ FR_TOO_MANY_OPEN_FILES, /* (18) Number of open files > FF_FS_LOCK */
FRESULT f_getfree (const TCHAR* path, DWORD* nclst, FATFS** fatfs); /* Get number of free clusters on the drive */ FR_INVALID_PARAMETER /* (19) Given parameter is invalid */
FRESULT f_getlabel (const TCHAR* path, TCHAR* label, DWORD* vsn); /* Get volume label */ } FRESULT;
FRESULT f_setlabel (const TCHAR* label); /* Set volume label */
FRESULT f_forward (FIL* fp, UINT(*func)(const BYTE*,UINT), UINT btf, UINT* bf); /* Forward data to the stream */
FRESULT f_expand (FIL* fp, FSIZE_t szf, BYTE opt); /* Allocate a contiguous block to the file */
FRESULT f_mount (FATFS* fs, const TCHAR* path, BYTE opt); /* Mount/Unmount a logical drive */ /*--------------------------------------------------------------*/
FRESULT f_mkfs (const TCHAR* path, BYTE opt, DWORD au, void* work, UINT len); /* Create a FAT volume */ /* FatFs module application interface */
FRESULT f_fdisk (BYTE pdrv, const DWORD* szt, void* work); /* Divide a physical drive into some partitions */
FRESULT f_setcp (WORD cp); /* Set current code page */ FRESULT f_open (FIL* fp, const TCHAR* path, BYTE mode); /* Open or create a file */
int f_putc (TCHAR c, FIL* fp); /* Put a character to the file */ FRESULT f_close (FIL* fp); /* Close an open file object */
int f_puts (const TCHAR* str, FIL* cp); /* Put a string to the file */ FRESULT f_read (FIL* fp, void* buff, UINT btr, UINT* br); /* Read data from the file */
int f_printf (FIL* fp, const TCHAR* str, ...); /* Put a formatted string to the file */ FRESULT f_write (FIL* fp, const void* buff, UINT btw, UINT* bw); /* Write data to the file */
TCHAR* f_gets (TCHAR* buff, int len, FIL* fp); /* Get a string from the file */ FRESULT f_lseek (FIL* fp, FSIZE_t ofs); /* Move file pointer of the file object */
FRESULT f_truncate (FIL* fp); /* Truncate the file */
#define f_eof(fp) ((int)((fp)->fptr == (fp)->obj.objsize)) FRESULT f_sync (FIL* fp); /* Flush cached data of the writing file */
#define f_error(fp) ((fp)->err) FRESULT f_opendir (DIR* dp, const TCHAR* path); /* Open a directory */
#define f_tell(fp) ((fp)->fptr) FRESULT f_closedir (DIR* dp); /* Close an open directory */
#define f_size(fp) ((fp)->obj.objsize) FRESULT f_readdir (DIR* dp, FILINFO* fno); /* Read a directory item */
#define f_rewind(fp) f_lseek((fp), 0) FRESULT f_findfirst (DIR* dp, FILINFO* fno, const TCHAR* path, const TCHAR* pattern); /* Find first file */
#define f_rewinddir(dp) f_readdir((dp), 0) FRESULT f_findnext (DIR* dp, FILINFO* fno); /* Find next file */
#define f_rmdir(path) f_unlink(path) FRESULT f_mkdir (const TCHAR* path); /* Create a sub directory */
#define f_unmount(path) f_mount(0, path, 0) FRESULT f_unlink (const TCHAR* path); /* Delete an existing file or directory */
FRESULT f_rename (const TCHAR* path_old, const TCHAR* path_new); /* Rename/Move a file or directory */
#ifndef EOF FRESULT f_stat (const TCHAR* path, FILINFO* fno); /* Get file status */
#define EOF (-1) FRESULT f_chmod (const TCHAR* path, BYTE attr, BYTE mask); /* Change attribute of a file/dir */
#endif FRESULT f_utime (const TCHAR* path, const FILINFO* fno); /* Change timestamp of a file/dir */
FRESULT f_chdir (const TCHAR* path); /* Change current directory */
FRESULT f_chdrive (const TCHAR* path); /* Change current drive */
FRESULT f_getcwd (TCHAR* buff, UINT len); /* Get current directory */
FRESULT f_getfree (const TCHAR* path, DWORD* nclst, FATFS** fatfs); /* Get number of free clusters on the drive */
/*--------------------------------------------------------------*/ FRESULT f_getlabel (const TCHAR* path, TCHAR* label, DWORD* vsn); /* Get volume label */
/* Additional user defined functions */ FRESULT f_setlabel (const TCHAR* label); /* Set volume label */
FRESULT f_forward (FIL* fp, UINT(*func)(const BYTE*,UINT), UINT btf, UINT* bf); /* Forward data to the stream */
/* RTC function */ FRESULT f_expand (FIL* fp, FSIZE_t fsz, BYTE opt); /* Allocate a contiguous block to the file */
#if !FF_FS_READONLY && !FF_FS_NORTC FRESULT f_mount (FATFS* fs, const TCHAR* path, BYTE opt); /* Mount/Unmount a logical drive */
DWORD get_fattime (void); FRESULT f_mkfs (const TCHAR* path, BYTE opt, DWORD au, void* work, UINT len); /* Create a FAT volume */
#endif FRESULT f_fdisk (BYTE pdrv, const DWORD* szt, void* work); /* Divide a physical drive into some partitions */
FRESULT f_setcp (WORD cp); /* Set current code page */
/* LFN support functions */ int f_putc (TCHAR c, FIL* fp); /* Put a character to the file */
#if FF_USE_LFN >= 1 /* Code conversion (defined in unicode.c) */ int f_puts (const TCHAR* str, FIL* cp); /* Put a string to the file */
WCHAR ff_oem2uni (WCHAR oem, WORD cp); /* OEM code to Unicode conversion */ int f_printf (FIL* fp, const TCHAR* str, ...); /* Put a formatted string to the file */
WCHAR ff_uni2oem (DWORD uni, WORD cp); /* Unicode to OEM code conversion */ TCHAR* f_gets (TCHAR* buff, int len, FIL* fp); /* Get a string from the file */
DWORD ff_wtoupper (DWORD uni); /* Unicode upper-case conversion */
#endif #define f_eof(fp) ((int)((fp)->fptr == (fp)->obj.objsize))
#if FF_USE_LFN == 3 /* Dynamic memory allocation */ #define f_error(fp) ((fp)->err)
void* ff_memalloc (UINT msize); /* Allocate memory block */ #define f_tell(fp) ((fp)->fptr)
void ff_memfree (void* mblock); /* Free memory block */ #define f_size(fp) ((fp)->obj.objsize)
#endif #define f_rewind(fp) f_lseek((fp), 0)
#define f_rewinddir(dp) f_readdir((dp), 0)
/* Sync functions */ #define f_rmdir(path) f_unlink(path)
#if FF_FS_REENTRANT #define f_unmount(path) f_mount(0, path, 0)
int ff_cre_syncobj (BYTE vol, FF_SYNC_t* sobj); /* Create a sync object */
int ff_req_grant (FF_SYNC_t sobj); /* Lock sync object */ #ifndef EOF
void ff_rel_grant (FF_SYNC_t sobj); /* Unlock sync object */ #define EOF (-1)
int ff_del_syncobj (FF_SYNC_t sobj); /* Delete a sync object */ #endif
#endif
/*--------------------------------------------------------------*/
/*--------------------------------------------------------------*/ /* Additional user defined functions */
/* Flags and offset address */
/* RTC function */
#if !FF_FS_READONLY && !FF_FS_NORTC
/* File access mode and open method flags (3rd argument of f_open) */ DWORD get_fattime (void);
#define FA_READ 0x01 #endif
#define FA_WRITE 0x02
#define FA_OPEN_EXISTING 0x00 /* LFN support functions */
#define FA_CREATE_NEW 0x04 #if FF_USE_LFN >= 1 /* Code conversion (defined in unicode.c) */
#define FA_CREATE_ALWAYS 0x08 WCHAR ff_oem2uni (WCHAR oem, WORD cp); /* OEM code to Unicode conversion */
#define FA_OPEN_ALWAYS 0x10 WCHAR ff_uni2oem (DWORD uni, WORD cp); /* Unicode to OEM code conversion */
#define FA_OPEN_APPEND 0x30 DWORD ff_wtoupper (DWORD uni); /* Unicode upper-case conversion */
#endif
/* Fast seek controls (2nd argument of f_lseek) */ #if FF_USE_LFN == 3 /* Dynamic memory allocation */
#define CREATE_LINKMAP ((FSIZE_t)0 - 1) void* ff_memalloc (UINT msize); /* Allocate memory block */
void ff_memfree (void* mblock); /* Free memory block */
/* Format options (2nd argument of f_mkfs) */ #endif
#define FM_FAT 0x01
#define FM_FAT32 0x02 /* Sync functions */
#define FM_EXFAT 0x04 #if FF_FS_REENTRANT
#define FM_ANY 0x07 int ff_cre_syncobj (BYTE vol, FF_SYNC_t* sobj); /* Create a sync object */
#define FM_SFD 0x08 int ff_req_grant (FF_SYNC_t sobj); /* Lock sync object */
void ff_rel_grant (FF_SYNC_t sobj); /* Unlock sync object */
/* Filesystem type (FATFS.fs_type) */ int ff_del_syncobj (FF_SYNC_t sobj); /* Delete a sync object */
#define FS_FAT12 1 #endif
#define FS_FAT16 2
#define FS_FAT32 3
#define FS_EXFAT 4
/* File attribute bits for directory entry (FILINFO.fattrib) */ /*--------------------------------------------------------------*/
#define AM_RDO 0x01 /* Read only */ /* Flags and offset address */
#define AM_HID 0x02 /* Hidden */
#define AM_SYS 0x04 /* System */
#define AM_DIR 0x10 /* Directory */ /* File access mode and open method flags (3rd argument of f_open) */
#define AM_ARC 0x20 /* Archive */ #define FA_READ 0x01
#define FA_WRITE 0x02
#define FA_OPEN_EXISTING 0x00
#ifdef __cplusplus #define FA_CREATE_NEW 0x04
} #define FA_CREATE_ALWAYS 0x08
#endif #define FA_OPEN_ALWAYS 0x10
#define FA_OPEN_APPEND 0x30
#endif /* FF_DEFINED */
/* Fast seek controls (2nd argument of f_lseek) */
#define CREATE_LINKMAP ((FSIZE_t)0 - 1)
/* Format options (2nd argument of f_mkfs) */
#define FM_FAT 0x01
#define FM_FAT32 0x02
#define FM_EXFAT 0x04
#define FM_ANY 0x07
#define FM_SFD 0x08
/* Filesystem type (FATFS.fs_type) */
#define FS_FAT12 1
#define FS_FAT16 2
#define FS_FAT32 3
#define FS_EXFAT 4
/* File attribute bits for directory entry (FILINFO.fattrib) */
#define AM_RDO 0x01 /* Read only */
#define AM_HID 0x02 /* Hidden */
#define AM_SYS 0x04 /* System */
#define AM_DIR 0x10 /* Directory */
#define AM_ARC 0x20 /* Archive */
#ifdef __cplusplus
}
#endif
#endif /* FF_DEFINED */

View File

@ -1,289 +1,288 @@
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ FatFs - Configuration file / FatFs Functional Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FFCONF_DEF 63463 /* Revision ID */ #define FFCONF_DEF 86604 /* Revision ID */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ Function Configurations / Function Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_FS_READONLY 0 #define FF_FS_READONLY 0
/* This option switches read-only configuration. (0:Read/Write or 1:Read-only) /* This option switches read-only configuration. (0:Read/Write or 1:Read-only)
/ Read-only configuration removes writing API functions, f_write(), f_sync(), / Read-only configuration removes writing API functions, f_write(), f_sync(),
/ f_unlink(), f_mkdir(), f_chmod(), f_rename(), f_truncate(), f_getfree() / f_unlink(), f_mkdir(), f_chmod(), f_rename(), f_truncate(), f_getfree()
/ and optional writing functions as well. */ / and optional writing functions as well. */
#define FF_FS_MINIMIZE 0 #define FF_FS_MINIMIZE 0
/* This option defines minimization level to remove some basic API functions. /* This option defines minimization level to remove some basic API functions.
/ /
/ 0: Basic functions are fully enabled. / 0: Basic functions are fully enabled.
/ 1: f_stat(), f_getfree(), f_unlink(), f_mkdir(), f_truncate() and f_rename() / 1: f_stat(), f_getfree(), f_unlink(), f_mkdir(), f_truncate() and f_rename()
/ are removed. / are removed.
/ 2: f_opendir(), f_readdir() and f_closedir() are removed in addition to 1. / 2: f_opendir(), f_readdir() and f_closedir() are removed in addition to 1.
/ 3: f_lseek() function is removed in addition to 2. */ / 3: f_lseek() function is removed in addition to 2. */
#define FF_USE_STRFUNC 2 #define FF_USE_STRFUNC 2
/* This option switches string functions, f_gets(), f_putc(), f_puts() and f_printf(). /* This option switches string functions, f_gets(), f_putc(), f_puts() and f_printf().
/ /
/ 0: Disable string functions. / 0: Disable string functions.
/ 1: Enable without LF-CRLF conversion. / 1: Enable without LF-CRLF conversion.
/ 2: Enable with LF-CRLF conversion. */ / 2: Enable with LF-CRLF conversion. */
#define FF_USE_FIND 0 #define FF_USE_FIND 0
/* This option switches filtered directory read functions, f_findfirst() and /* This option switches filtered directory read functions, f_findfirst() and
/ f_findnext(). (0:Disable, 1:Enable 2:Enable with matching altname[] too) */ / f_findnext(). (0:Disable, 1:Enable 2:Enable with matching altname[] too) */
#define FF_USE_MKFS 0 #define FF_USE_MKFS 0
/* This option switches f_mkfs() function. (0:Disable or 1:Enable) */ /* This option switches f_mkfs() function. (0:Disable or 1:Enable) */
#define FF_USE_FASTSEEK 0 #define FF_USE_FASTSEEK 0
/* This option switches fast seek function. (0:Disable or 1:Enable) */ /* This option switches fast seek function. (0:Disable or 1:Enable) */
#define FF_USE_EXPAND 0 #define FF_USE_EXPAND 0
/* This option switches f_expand function. (0:Disable or 1:Enable) */ /* This option switches f_expand function. (0:Disable or 1:Enable) */
#define FF_USE_CHMOD 0 #define FF_USE_CHMOD 0
/* This option switches attribute manipulation functions, f_chmod() and f_utime(). /* This option switches attribute manipulation functions, f_chmod() and f_utime().
/ (0:Disable or 1:Enable) Also FF_FS_READONLY needs to be 0 to enable this option. */ / (0:Disable or 1:Enable) Also FF_FS_READONLY needs to be 0 to enable this option. */
#define FF_USE_LABEL 0 #define FF_USE_LABEL 0
/* This option switches volume label functions, f_getlabel() and f_setlabel(). /* This option switches volume label functions, f_getlabel() and f_setlabel().
/ (0:Disable or 1:Enable) */ / (0:Disable or 1:Enable) */
#define FF_USE_FORWARD 0 #define FF_USE_FORWARD 0
/* This option switches f_forward() function. (0:Disable or 1:Enable) */ /* This option switches f_forward() function. (0:Disable or 1:Enable) */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ Locale and Namespace Configurations / Locale and Namespace Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_CODE_PAGE 850 #define FF_CODE_PAGE 850
/* This option specifies the OEM code page to be used on the target system. /* This option specifies the OEM code page to be used on the target system.
/ Incorrect code page setting can cause a file open failure. / Incorrect code page setting can cause a file open failure.
/ /
/ 437 - U.S. / 437 - U.S.
/ 720 - Arabic / 720 - Arabic
/ 737 - Greek / 737 - Greek
/ 771 - KBL / 771 - KBL
/ 775 - Baltic / 775 - Baltic
/ 850 - Latin 1 / 850 - Latin 1
/ 852 - Latin 2 / 852 - Latin 2
/ 855 - Cyrillic / 855 - Cyrillic
/ 857 - Turkish / 857 - Turkish
/ 860 - Portuguese / 860 - Portuguese
/ 861 - Icelandic / 861 - Icelandic
/ 862 - Hebrew / 862 - Hebrew
/ 863 - Canadian French / 863 - Canadian French
/ 864 - Arabic / 864 - Arabic
/ 865 - Nordic / 865 - Nordic
/ 866 - Russian / 866 - Russian
/ 869 - Greek 2 / 869 - Greek 2
/ 932 - Japanese (DBCS) / 932 - Japanese (DBCS)
/ 936 - Simplified Chinese (DBCS) / 936 - Simplified Chinese (DBCS)
/ 949 - Korean (DBCS) / 949 - Korean (DBCS)
/ 950 - Traditional Chinese (DBCS) / 950 - Traditional Chinese (DBCS)
/ 0 - Include all code pages above and configured by f_setcp() / 0 - Include all code pages above and configured by f_setcp()
*/ */
#define FF_USE_LFN 1 #define FF_USE_LFN 1
#define FF_MAX_LFN 255 #define FF_MAX_LFN 255
/* The FF_USE_LFN switches the support for LFN (long file name). /* The FF_USE_LFN switches the support for LFN (long file name).
/ /
/ 0: Disable LFN. FF_MAX_LFN has no effect. / 0: Disable LFN. FF_MAX_LFN has no effect.
/ 1: Enable LFN with static working buffer on the BSS. Always NOT thread-safe. / 1: Enable LFN with static working buffer on the BSS. Always NOT thread-safe.
/ 2: Enable LFN with dynamic working buffer on the STACK. / 2: Enable LFN with dynamic working buffer on the STACK.
/ 3: Enable LFN with dynamic working buffer on the HEAP. / 3: Enable LFN with dynamic working buffer on the HEAP.
/ /
/ To enable the LFN, ffunicode.c needs to be added to the project. The LFN function / To enable the LFN, ffunicode.c needs to be added to the project. The LFN function
/ requiers certain internal working buffer occupies (FF_MAX_LFN + 1) * 2 bytes and / requiers certain internal working buffer occupies (FF_MAX_LFN + 1) * 2 bytes and
/ additional (FF_MAX_LFN + 44) / 15 * 32 bytes when exFAT is enabled. / additional (FF_MAX_LFN + 44) / 15 * 32 bytes when exFAT is enabled.
/ The FF_MAX_LFN defines size of the working buffer in UTF-16 code unit and it can / The FF_MAX_LFN defines size of the working buffer in UTF-16 code unit and it can
/ be in range of 12 to 255. It is recommended to be set 255 to fully support LFN / be in range of 12 to 255. It is recommended to be set 255 to fully support LFN
/ specification. / specification.
/ When use stack for the working buffer, take care on stack overflow. When use heap / When use stack for the working buffer, take care on stack overflow. When use heap
/ memory for the working buffer, memory management functions, ff_memalloc() and / memory for the working buffer, memory management functions, ff_memalloc() and
/ ff_memfree() in ffsystem.c, need to be added to the project. */ / ff_memfree() in ffsystem.c, need to be added to the project. */
#define FF_LFN_UNICODE 2 #define FF_LFN_UNICODE 2
/* This option switches the character encoding on the API when LFN is enabled. /* This option switches the character encoding on the API when LFN is enabled.
/ /
/ 0: ANSI/OEM in current CP (TCHAR = char) / 0: ANSI/OEM in current CP (TCHAR = char)
/ 1: Unicode in UTF-16 (TCHAR = WCHAR) / 1: Unicode in UTF-16 (TCHAR = WCHAR)
/ 2: Unicode in UTF-8 (TCHAR = char) / 2: Unicode in UTF-8 (TCHAR = char)
/ 3: Unicode in UTF-32 (TCHAR = DWORD) / 3: Unicode in UTF-32 (TCHAR = DWORD)
/ /
/ Also behavior of string I/O functions will be affected by this option. / Also behavior of string I/O functions will be affected by this option.
/ When LFN is not enabled, this option has no effect. */ / When LFN is not enabled, this option has no effect. */
#define FF_LFN_BUF 255 #define FF_LFN_BUF 255
#define FF_SFN_BUF 12 #define FF_SFN_BUF 12
/* This set of options defines size of file name members in the FILINFO structure /* This set of options defines size of file name members in the FILINFO structure
/ which is used to read out directory items. These values should be suffcient for / which is used to read out directory items. These values should be suffcient for
/ the file names to read. The maximum possible length of the read file name depends / the file names to read. The maximum possible length of the read file name depends
/ on character encoding. When LFN is not enabled, these options have no effect. */ / on character encoding. When LFN is not enabled, these options have no effect. */
#define FF_STRF_ENCODE 3 #define FF_STRF_ENCODE 3
/* When FF_LFN_UNICODE >= 1 with LFN enabled, string I/O functions, f_gets(), /* When FF_LFN_UNICODE >= 1 with LFN enabled, string I/O functions, f_gets(),
/ f_putc(), f_puts and f_printf() convert the character encoding in it. / f_putc(), f_puts and f_printf() convert the character encoding in it.
/ This option selects assumption of character encoding ON THE FILE to be / This option selects assumption of character encoding ON THE FILE to be
/ read/written via those functions. / read/written via those functions.
/ /
/ 0: ANSI/OEM in current CP / 0: ANSI/OEM in current CP
/ 1: Unicode in UTF-16LE / 1: Unicode in UTF-16LE
/ 2: Unicode in UTF-16BE / 2: Unicode in UTF-16BE
/ 3: Unicode in UTF-8 / 3: Unicode in UTF-8
*/ */
#define FF_FS_RPATH 0 #define FF_FS_RPATH 0
/* This option configures support for relative path. /* This option configures support for relative path.
/ /
/ 0: Disable relative path and remove related functions. / 0: Disable relative path and remove related functions.
/ 1: Enable relative path. f_chdir() and f_chdrive() are available. / 1: Enable relative path. f_chdir() and f_chdrive() are available.
/ 2: f_getcwd() function is available in addition to 1. / 2: f_getcwd() function is available in addition to 1.
*/ */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ Drive/Volume Configurations / Drive/Volume Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_VOLUMES 1 #define FF_VOLUMES 1
/* Number of volumes (logical drives) to be used. (1-10) */ /* Number of volumes (logical drives) to be used. (1-10) */
#define FF_STR_VOLUME_ID 0 #define FF_STR_VOLUME_ID 0
#define FF_VOLUME_STRS "sdmc" #define FF_VOLUME_STRS "sdmc"
/* FF_STR_VOLUME_ID switches support for volume ID in arbitrary strings. /* FF_STR_VOLUME_ID switches support for volume ID in arbitrary strings.
/ When FF_STR_VOLUME_ID is set to 1 or 2, arbitrary strings can be used as drive / When FF_STR_VOLUME_ID is set to 1 or 2, arbitrary strings can be used as drive
/ number in the path name. FF_VOLUME_STRS defines the volume ID strings for each / number in the path name. FF_VOLUME_STRS defines the volume ID strings for each
/ logical drives. Number of items must not be less than FF_VOLUMES. Valid / logical drives. Number of items must not be less than FF_VOLUMES. Valid
/ characters for the volume ID strings are A-Z, a-z and 0-9, however, they are / characters for the volume ID strings are A-Z, a-z and 0-9, however, they are
/ compared in case-insensitive. If FF_STR_VOLUME_ID >= 1 and FF_VOLUME_STRS is / compared in case-insensitive. If FF_STR_VOLUME_ID >= 1 and FF_VOLUME_STRS is
/ not defined, a user defined volume string table needs to be defined as: / not defined, a user defined volume string table needs to be defined as:
/ /
/ const char* VolumeStr[FF_VOLUMES] = {"ram","flash","sd","usb",... / const char* VolumeStr[FF_VOLUMES] = {"ram","flash","sd","usb",...
*/ */
#define FF_MULTI_PARTITION 0 #define FF_MULTI_PARTITION 0
/* This option switches support for multiple volumes on the physical drive. /* This option switches support for multiple volumes on the physical drive.
/ By default (0), each logical drive number is bound to the same physical drive / By default (0), each logical drive number is bound to the same physical drive
/ number and only an FAT volume found on the physical drive will be mounted. / number and only an FAT volume found on the physical drive will be mounted.
/ When this function is enabled (1), each logical drive number can be bound to / When this function is enabled (1), each logical drive number can be bound to
/ arbitrary physical drive and partition listed in the VolToPart[]. Also f_fdisk() / arbitrary physical drive and partition listed in the VolToPart[]. Also f_fdisk()
/ funciton will be available. */ / funciton will be available. */
#define FF_MIN_SS 512 #define FF_MIN_SS 512
#define FF_MAX_SS 512 #define FF_MAX_SS 512
/* This set of options configures the range of sector size to be supported. (512, /* This set of options configures the range of sector size to be supported. (512,
/ 1024, 2048 or 4096) Always set both 512 for most systems, generic memory card and / 1024, 2048 or 4096) Always set both 512 for most systems, generic memory card and
/ harddisk. But a larger value may be required for on-board flash memory and some / harddisk. But a larger value may be required for on-board flash memory and some
/ type of optical media. When FF_MAX_SS is larger than FF_MIN_SS, FatFs is configured / type of optical media. When FF_MAX_SS is larger than FF_MIN_SS, FatFs is configured
/ for variable sector size mode and disk_ioctl() function needs to implement / for variable sector size mode and disk_ioctl() function needs to implement
/ GET_SECTOR_SIZE command. */ / GET_SECTOR_SIZE command. */
#define FF_USE_TRIM 0 #define FF_USE_TRIM 0
/* This option switches support for ATA-TRIM. (0:Disable or 1:Enable) /* This option switches support for ATA-TRIM. (0:Disable or 1:Enable)
/ To enable Trim function, also CTRL_TRIM command should be implemented to the / To enable Trim function, also CTRL_TRIM command should be implemented to the
/ disk_ioctl() function. */ / disk_ioctl() function. */
#define FF_FS_NOFSINFO 0 #define FF_FS_NOFSINFO 0
/* If you need to know correct free space on the FAT32 volume, set bit 0 of this /* If you need to know correct free space on the FAT32 volume, set bit 0 of this
/ option, and f_getfree() function at first time after volume mount will force / option, and f_getfree() function at first time after volume mount will force
/ a full FAT scan. Bit 1 controls the use of last allocated cluster number. / a full FAT scan. Bit 1 controls the use of last allocated cluster number.
/ /
/ bit0=0: Use free cluster count in the FSINFO if available. / bit0=0: Use free cluster count in the FSINFO if available.
/ bit0=1: Do not trust free cluster count in the FSINFO. / bit0=1: Do not trust free cluster count in the FSINFO.
/ bit1=0: Use last allocated cluster number in the FSINFO if available. / bit1=0: Use last allocated cluster number in the FSINFO if available.
/ bit1=1: Do not trust last allocated cluster number in the FSINFO. / bit1=1: Do not trust last allocated cluster number in the FSINFO.
*/ */
/*---------------------------------------------------------------------------/ /*---------------------------------------------------------------------------/
/ System Configurations / System Configurations
/---------------------------------------------------------------------------*/ /---------------------------------------------------------------------------*/
#define FF_FS_TINY 0 #define FF_FS_TINY 0
/* This option switches tiny buffer configuration. (0:Normal or 1:Tiny) /* This option switches tiny buffer configuration. (0:Normal or 1:Tiny)
/ At the tiny configuration, size of file object (FIL) is shrinked FF_MAX_SS bytes. / At the tiny configuration, size of file object (FIL) is shrinked FF_MAX_SS bytes.
/ Instead of private sector buffer eliminated from the file object, common sector / Instead of private sector buffer eliminated from the file object, common sector
/ buffer in the filesystem object (FATFS) is used for the file data transfer. */ / buffer in the filesystem object (FATFS) is used for the file data transfer. */
#define FF_FS_EXFAT 1 #define FF_FS_EXFAT 1
/* This option switches support for exFAT filesystem. (0:Disable or 1:Enable) /* This option switches support for exFAT filesystem. (0:Disable or 1:Enable)
/ To enable exFAT, also LFN needs to be enabled. / To enable exFAT, also LFN needs to be enabled. (FF_USE_LFN >= 1)
/ Note that enabling exFAT discards ANSI C (C89) compatibility. */ / Note that enabling exFAT discards ANSI C (C89) compatibility. */
#define FF_FS_NORTC 1 #define FF_FS_NORTC 1
#define FF_NORTC_MON 1 #define FF_NORTC_MON 1
#define FF_NORTC_MDAY 1 #define FF_NORTC_MDAY 1
#define FF_NORTC_YEAR 2018 #define FF_NORTC_YEAR 2018
/* The option FF_FS_NORTC switches timestamp functiton. If the system does not have /* The option FF_FS_NORTC switches timestamp functiton. If the system does not have
/ any RTC function or valid timestamp is not needed, set FF_FS_NORTC = 1 to disable / any RTC function or valid timestamp is not needed, set FF_FS_NORTC = 1 to disable
/ the timestamp function. Every object modified by FatFs will have a fixed timestamp / the timestamp function. Every object modified by FatFs will have a fixed timestamp
/ defined by FF_NORTC_MON, FF_NORTC_MDAY and FF_NORTC_YEAR in local time. / defined by FF_NORTC_MON, FF_NORTC_MDAY and FF_NORTC_YEAR in local time.
/ To enable timestamp function (FF_FS_NORTC = 0), get_fattime() function need to be / To enable timestamp function (FF_FS_NORTC = 0), get_fattime() function need to be
/ added to the project to read current time form real-time clock. FF_NORTC_MON, / added to the project to read current time form real-time clock. FF_NORTC_MON,
/ FF_NORTC_MDAY and FF_NORTC_YEAR have no effect. / FF_NORTC_MDAY and FF_NORTC_YEAR have no effect.
/ These options have no effect at read-only configuration (FF_FS_READONLY = 1). */ / These options have no effect at read-only configuration (FF_FS_READONLY = 1). */
#define FF_FS_LOCK 0 #define FF_FS_LOCK 0
/* The option FF_FS_LOCK switches file lock function to control duplicated file open /* The option FF_FS_LOCK switches file lock function to control duplicated file open
/ and illegal operation to open objects. This option must be 0 when FF_FS_READONLY / and illegal operation to open objects. This option must be 0 when FF_FS_READONLY
/ is 1. / is 1.
/ /
/ 0: Disable file lock function. To avoid volume corruption, application program / 0: Disable file lock function. To avoid volume corruption, application program
/ should avoid illegal open, remove and rename to the open objects. / should avoid illegal open, remove and rename to the open objects.
/ >0: Enable file lock function. The value defines how many files/sub-directories / >0: Enable file lock function. The value defines how many files/sub-directories
/ can be opened simultaneously under file lock control. Note that the file / can be opened simultaneously under file lock control. Note that the file
/ lock control is independent of re-entrancy. */ / lock control is independent of re-entrancy. */
#define FF_FS_REENTRANT 0 /* #include <somertos.h> // O/S definitions */
#define FF_FS_TIMEOUT 1000 #define FF_FS_REENTRANT 0
#define FF_SYNC_t HANDLE #define FF_FS_TIMEOUT 1000
/* The option FF_FS_REENTRANT switches the re-entrancy (thread safe) of the FatFs #define FF_SYNC_t HANDLE
/ module itself. Note that regardless of this option, file access to different /* The option FF_FS_REENTRANT switches the re-entrancy (thread safe) of the FatFs
/ volume is always re-entrant and volume control functions, f_mount(), f_mkfs() / module itself. Note that regardless of this option, file access to different
/ and f_fdisk() function, are always not re-entrant. Only file/directory access / volume is always re-entrant and volume control functions, f_mount(), f_mkfs()
/ to the same volume is under control of this function. / and f_fdisk() function, are always not re-entrant. Only file/directory access
/ / to the same volume is under control of this function.
/ 0: Disable re-entrancy. FF_FS_TIMEOUT and FF_SYNC_t have no effect. /
/ 1: Enable re-entrancy. Also user provided synchronization handlers, / 0: Disable re-entrancy. FF_FS_TIMEOUT and FF_SYNC_t have no effect.
/ ff_req_grant(), ff_rel_grant(), ff_del_syncobj() and ff_cre_syncobj() / 1: Enable re-entrancy. Also user provided synchronization handlers,
/ function, must be added to the project. Samples are available in / ff_req_grant(), ff_rel_grant(), ff_del_syncobj() and ff_cre_syncobj()
/ option/syscall.c. / function, must be added to the project. Samples are available in
/ / option/syscall.c.
/ The FF_FS_TIMEOUT defines timeout period in unit of time tick. /
/ The FF_SYNC_t defines O/S dependent sync object type. e.g. HANDLE, ID, OS_EVENT*, / The FF_FS_TIMEOUT defines timeout period in unit of time tick.
/ SemaphoreHandle_t and etc. A header file for O/S definitions needs to be / The FF_SYNC_t defines O/S dependent sync object type. e.g. HANDLE, ID, OS_EVENT*,
/ included somewhere in the scope of ff.h. */ / SemaphoreHandle_t and etc. A header file for O/S definitions needs to be
/ included somewhere in the scope of ff.h. */
/* #include <windows.h> // O/S definitions */
/*--- End of configuration options ---*/
/*--- End of configuration options ---*/

View File

@ -1,171 +1,170 @@
/*------------------------------------------------------------------------*/ /*------------------------------------------------------------------------*/
/* Sample Code of OS Dependent Functions for FatFs */ /* Sample Code of OS Dependent Functions for FatFs */
/* (C)ChaN, 2017 */ /* (C)ChaN, 2018 */
/*------------------------------------------------------------------------*/ /*------------------------------------------------------------------------*/
#include "ff.h" #include "ff.h"
#if FF_USE_LFN == 3 /* Dynamic memory allocation */
#if FF_USE_LFN == 3 /* Dynamic memory allocation */
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Allocate a memory block */
/* Allocate a memory block */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/
void* ff_memalloc ( /* Returns pointer to the allocated memory block (null if not enough core) */
void* ff_memalloc ( /* Returns pointer to the allocated memory block (null on not enough core) */ UINT msize /* Number of bytes to allocate */
UINT msize /* Number of bytes to allocate */ )
) {
{ return malloc(msize); /* Allocate a new memory block with POSIX API */
return malloc(msize); /* Allocate a new memory block with POSIX API */ }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Free a memory block */
/* Free a memory block */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/
void ff_memfree (
void ff_memfree ( void* mblock /* Pointer to the memory block to free (nothing to do if null) */
void* mblock /* Pointer to the memory block to free (nothing to do for null) */ )
) {
{ free(mblock); /* Free the memory block with POSIX API */
free(mblock); /* Free the memory block with POSIX API */ }
}
#endif
#endif
#if FF_FS_REENTRANT /* Mutal exclusion */
#if FF_FS_REENTRANT /* Mutal exclusion */
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Create a Synchronization Object */
/* Create a Synchronization Object */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called in f_mount() function to create a new
/* This function is called in f_mount() function to create a new / synchronization object for the volume, such as semaphore and mutex.
/ synchronization object for the volume, such as semaphore and mutex. / When a 0 is returned, the f_mount() function fails with FR_INT_ERR.
/ When a 0 is returned, the f_mount() function fails with FR_INT_ERR. */
*/
//const osMutexDef_t Mutex[FF_VOLUMES]; /* Table of CMSIS-RTOS mutex */
//const osMutexDef_t Mutex[FF_VOLUMES]; /* CMSIS-RTOS */
int ff_cre_syncobj ( /* 1:Function succeeded, 0:Could not create the sync object */
int ff_cre_syncobj ( /* 1:Function succeeded, 0:Could not create the sync object */ BYTE vol, /* Corresponding volume (logical drive number) */
BYTE vol, /* Corresponding volume (logical drive number) */ FF_SYNC_t* sobj /* Pointer to return the created sync object */
FF_SYNC_t* sobj /* Pointer to return the created sync object */ )
) {
{ /* Win32 */
/* Win32 */ *sobj = CreateMutex(NULL, FALSE, NULL);
*sobj = CreateMutex(NULL, FALSE, NULL); return (int)(*sobj != INVALID_HANDLE_VALUE);
return (int)(*sobj != INVALID_HANDLE_VALUE);
/* uITRON */
/* uITRON */ // T_CSEM csem = {TA_TPRI,1,1};
// T_CSEM csem = {TA_TPRI,1,1}; // *sobj = acre_sem(&csem);
// *sobj = acre_sem(&csem); // return (int)(*sobj > 0);
// return (int)(*sobj > 0);
/* uC/OS-II */
/* uC/OS-II */ // OS_ERR err;
// OS_ERR err; // *sobj = OSMutexCreate(0, &err);
// *sobj = OSMutexCreate(0, &err); // return (int)(err == OS_NO_ERR);
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
/* FreeRTOS */ // *sobj = xSemaphoreCreateMutex();
// *sobj = xSemaphoreCreateMutex(); // return (int)(*sobj != NULL);
// return (int)(*sobj != NULL);
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // *sobj = osMutexCreate(&Mutex[vol]);
// *sobj = osMutexCreate(Mutex + vol); // return (int)(*sobj != NULL);
// return (int)(*sobj != NULL); }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Delete a Synchronization Object */
/* Delete a Synchronization Object */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called in f_mount() function to delete a synchronization
/* This function is called in f_mount() function to delete a synchronization / object that created with ff_cre_syncobj() function. When a 0 is returned,
/ object that created with ff_cre_syncobj() function. When a 0 is returned, / the f_mount() function fails with FR_INT_ERR.
/ the f_mount() function fails with FR_INT_ERR. */
*/
int ff_del_syncobj ( /* 1:Function succeeded, 0:Could not delete due to an error */
int ff_del_syncobj ( /* 1:Function succeeded, 0:Could not delete due to an error */ FF_SYNC_t sobj /* Sync object tied to the logical drive to be deleted */
FF_SYNC_t sobj /* Sync object tied to the logical drive to be deleted */ )
) {
{ /* Win32 */
/* Win32 */ return (int)CloseHandle(sobj);
return (int)CloseHandle(sobj);
/* uITRON */
/* uITRON */ // return (int)(del_sem(sobj) == E_OK);
// return (int)(del_sem(sobj) == E_OK);
/* uC/OS-II */
/* uC/OS-II */ // OS_ERR err;
// OS_ERR err; // OSMutexDel(sobj, OS_DEL_ALWAYS, &err);
// OSMutexDel(sobj, OS_DEL_ALWAYS, &err); // return (int)(err == OS_NO_ERR);
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
/* FreeRTOS */ // vSemaphoreDelete(sobj);
// vSemaphoreDelete(sobj); // return 1;
// return 1;
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // return (int)(osMutexDelete(sobj) == osOK);
// return (int)(osMutexDelete(sobj) == osOK); }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Request Grant to Access the Volume */
/* Request Grant to Access the Volume */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called on entering file functions to lock the volume.
/* This function is called on entering file functions to lock the volume. / When a 0 is returned, the file function fails with FR_TIMEOUT.
/ When a 0 is returned, the file function fails with FR_TIMEOUT. */
*/
int ff_req_grant ( /* 1:Got a grant to access the volume, 0:Could not get a grant */
int ff_req_grant ( /* 1:Got a grant to access the volume, 0:Could not get a grant */ FF_SYNC_t sobj /* Sync object to wait */
FF_SYNC_t sobj /* Sync object to wait */ )
) {
{ /* Win32 */
/* Win32 */ return (int)(WaitForSingleObject(sobj, FF_FS_TIMEOUT) == WAIT_OBJECT_0);
return (int)(WaitForSingleObject(sobj, FF_FS_TIMEOUT) == WAIT_OBJECT_0);
/* uITRON */
/* uITRON */ // return (int)(wai_sem(sobj) == E_OK);
// return (int)(wai_sem(sobj) == E_OK);
/* uC/OS-II */
/* uC/OS-II */ // OS_ERR err;
// OS_ERR err; // OSMutexPend(sobj, FF_FS_TIMEOUT, &err));
// OSMutexPend(sobj, FF_FS_TIMEOUT, &err)); // return (int)(err == OS_NO_ERR);
// return (int)(err == OS_NO_ERR);
/* FreeRTOS */
/* FreeRTOS */ // return (int)(xSemaphoreTake(sobj, FF_FS_TIMEOUT) == pdTRUE);
// return (int)(xSemaphoreTake(sobj, FF_FS_TIMEOUT) == pdTRUE);
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // return (int)(osMutexWait(sobj, FF_FS_TIMEOUT) == osOK);
// return (int)(osMutexWait(sobj, FF_FS_TIMEOUT) == osOK); }
}
/*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* Release Grant to Access the Volume */
/* Release Grant to Access the Volume */ /*------------------------------------------------------------------------*/
/*------------------------------------------------------------------------*/ /* This function is called on leaving file functions to unlock the volume.
/* This function is called on leaving file functions to unlock the volume. */
*/
void ff_rel_grant (
void ff_rel_grant ( FF_SYNC_t sobj /* Sync object to be signaled */
FF_SYNC_t sobj /* Sync object to be signaled */ )
) {
{ /* Win32 */
/* Win32 */ ReleaseMutex(sobj);
ReleaseMutex(sobj);
/* uITRON */
/* uITRON */ // sig_sem(sobj);
// sig_sem(sobj);
/* uC/OS-II */
/* uC/OS-II */ // OSMutexPost(sobj);
// OSMutexPost(sobj);
/* FreeRTOS */
/* FreeRTOS */ // xSemaphoreGive(sobj);
// xSemaphoreGive(sobj);
/* CMSIS-RTOS */
/* CMSIS-RTOS */ // osMutexRelease(sobj);
// osMutexRelease(sobj); }
}
#endif
#endif

File diff suppressed because it is too large Load Diff

View File

@ -1,36 +0,0 @@
/*-------------------------------------------*/
/* Integer type definitions for FatFs module */
/*-------------------------------------------*/
#ifndef FF_INTEGER
#define FF_INTEGER
#ifdef _WIN32 /* FatFs development platform */
#include <windows.h>
typedef unsigned __int64 QWORD;
#else /* Embedded platform */
/* These types MUST be 16-bit or 32-bit */
typedef int INT;
typedef unsigned int UINT;
/* This type MUST be 8-bit */
typedef unsigned char BYTE;
/* These types MUST be 16-bit */
typedef short SHORT;
typedef unsigned short WORD;
typedef unsigned short WCHAR;
/* These types MUST be 32-bit */
typedef long LONG;
typedef unsigned long DWORD;
/* This type MUST be 64-bit (Remove this for ANSI C (C89) compatibility) */
typedef unsigned long long QWORD;
#endif
#endif