From 79c4ebd2aefb3681f6125fb9bdb6105322c009dd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Felix=20=22xq=22=20Quei=C3=9Fner?= Date: Wed, 7 Jan 2026 20:52:55 +0100 Subject: [PATCH 1/7] Upgrade fatfs to R0.15b --- vendor/fatfs/README.md | 1 - vendor/fatfs/documents/00index_e.html | 29 +- vendor/fatfs/documents/css_e.css | 12 +- vendor/fatfs/documents/doc/appnote.html | 356 ++--- vendor/fatfs/documents/doc/chdir.html | 3 +- vendor/fatfs/documents/doc/chdrive.html | 3 +- vendor/fatfs/documents/doc/chmod.html | 5 +- vendor/fatfs/documents/doc/close.html | 3 +- vendor/fatfs/documents/doc/closedir.html | 3 +- vendor/fatfs/documents/doc/config.html | 54 +- vendor/fatfs/documents/doc/dinit.html | 3 +- vendor/fatfs/documents/doc/dioctl.html | 16 +- vendor/fatfs/documents/doc/dread.html | 10 +- vendor/fatfs/documents/doc/dstat.html | 3 +- vendor/fatfs/documents/doc/dwrite.html | 6 +- vendor/fatfs/documents/doc/eof.html | 3 +- vendor/fatfs/documents/doc/error.html | 3 +- vendor/fatfs/documents/doc/expand.html | 15 +- vendor/fatfs/documents/doc/fattime.html | 2 - vendor/fatfs/documents/doc/fdisk.html | 21 +- vendor/fatfs/documents/doc/filename.html | 19 +- vendor/fatfs/documents/doc/findfirst.html | 18 +- vendor/fatfs/documents/doc/findnext.html | 3 +- vendor/fatfs/documents/doc/forward.html | 15 +- vendor/fatfs/documents/doc/getcwd.html | 3 +- vendor/fatfs/documents/doc/getfree.html | 2 - vendor/fatfs/documents/doc/getlabel.html | 4 +- vendor/fatfs/documents/doc/gets.html | 7 +- vendor/fatfs/documents/doc/lseek.html | 24 +- vendor/fatfs/documents/doc/mkdir.html | 3 +- vendor/fatfs/documents/doc/mkfs.html | 35 +- vendor/fatfs/documents/doc/mount.html | 15 +- vendor/fatfs/documents/doc/open.html | 40 +- vendor/fatfs/documents/doc/opendir.html | 7 +- vendor/fatfs/documents/doc/printf.html | 228 +-- vendor/fatfs/documents/doc/putc.html | 3 +- vendor/fatfs/documents/doc/puts.html | 5 +- vendor/fatfs/documents/doc/rc.html | 18 +- vendor/fatfs/documents/doc/read.html | 11 +- vendor/fatfs/documents/doc/readdir.html | 68 +- vendor/fatfs/documents/doc/rename.html | 2 - vendor/fatfs/documents/doc/sdir.html | 3 +- vendor/fatfs/documents/doc/setcp.html | 2 - vendor/fatfs/documents/doc/setlabel.html | 11 +- vendor/fatfs/documents/doc/sfatfs.html | 2 - vendor/fatfs/documents/doc/sfile.html | 3 +- vendor/fatfs/documents/doc/sfileinfo.html | 15 +- vendor/fatfs/documents/doc/size.html | 3 +- vendor/fatfs/documents/doc/stat.html | 20 +- vendor/fatfs/documents/doc/sync.html | 5 +- vendor/fatfs/documents/doc/tell.html | 3 +- vendor/fatfs/documents/doc/truncate.html | 4 +- vendor/fatfs/documents/doc/unlink.html | 4 +- vendor/fatfs/documents/doc/utime.html | 17 +- vendor/fatfs/documents/doc/write.html | 11 +- vendor/fatfs/documents/res/app5.c | 2 +- vendor/fatfs/documents/res/uniconv.zip | Bin 0 -> 4175 bytes vendor/fatfs/documents/updates.html | 544 +++++++ vendor/fatfs/documents/updates.txt | 286 ---- vendor/fatfs/ff15b.zip | Bin 0 -> 2381044 bytes vendor/fatfs/source/00history.txt | 24 + vendor/fatfs/source/00readme.txt | 2 +- vendor/fatfs/source/ff.c | 1739 +++++++++++---------- vendor/fatfs/source/ff.h | 142 +- vendor/fatfs/source/ffconf.h | 100 +- vendor/fatfs/source/ffsystem.c | 224 +-- vendor/fatfs/source/ffunicode.c | 44 +- 67 files changed, 2393 insertions(+), 1898 deletions(-) delete mode 100644 vendor/fatfs/README.md create mode 100644 vendor/fatfs/documents/res/uniconv.zip create mode 100644 vendor/fatfs/documents/updates.html delete mode 100644 vendor/fatfs/documents/updates.txt create mode 100644 vendor/fatfs/ff15b.zip diff --git a/vendor/fatfs/README.md b/vendor/fatfs/README.md deleted file mode 100644 index c5ddf05..0000000 --- a/vendor/fatfs/README.md +++ /dev/null @@ -1 +0,0 @@ -Offline copy of the download http://www.elm-chan.org/fsw/ff/00index_e.html with the original source files. diff --git a/vendor/fatfs/documents/00index_e.html b/vendor/fatfs/documents/00index_e.html index 81185ac..a984b5f 100644 --- a/vendor/fatfs/documents/00index_e.html +++ b/vendor/fatfs/documents/00index_e.html @@ -17,7 +17,7 @@

FatFs - Generic FAT Filesystem Module

layer -

FatFs is a generic FAT/exFAT filesystem module for small embedded systems. The FatFs module is written in compliance with ANSI C (C89) and completely separated from the disk I/O layer. Therefore it is independent of the platform. It can be incorporated into small microcontrollers with limited resource, such as 8051, PIC, AVR, ARM, Z80, RX and etc. Also Petit FatFs module for tiny microcontrollers is available here.

+

FatFs is a generic FAT/exFAT filesystem module for small embedded systems. The FatFs module is written in compliance with ANSI C (C89) and completely separated from the disk control layer. Therefore it is independent of the platforms and storage devices. It can be incorporated into small microcontrollers with limited resource, such as 8051, PIC, AVR, ARM, Z80, RX and etc. Also Petit FatFs module for tiny microcontrollers is available here🔗.

Features

@@ -76,7 +79,7 @@

Required Functions

disk_ioctl (GET_SECTOR_SIZE)FF_MAX_SS != FF_MIN_SS disk_ioctl (CTRL_TRIM)FF_USE_TRIM == 1 ff_uni2oem
ff_oem2uni
ff_wtoupperFF_USE_LFN != 0Unicode support functions.
Add optional module ffunicode.c to the project. -ff_cre_syncobj
ff_del_syncobj
ff_req_grant
ff_rel_grantFF_FS_REENTRANT == 1O/S dependent functions.
Sample code is available in ffsystem.c. +ff_mutex_create
ff_mutex_delete
ff_mutex_take
ff_mutex_giveFF_FS_REENTRANT == 1O/S dependent functions.
Sample code is available in ffsystem.c. ff_mem_alloc
ff_mem_freeFF_USE_LFN == 3

FatFs cares about neither what kind of storage device is used nor how it is implemented. Only a requirement is that it is a block device read/written in fixed-size blocks that accessible via the disk I/O functions defined above.

@@ -103,17 +106,17 @@

Memory Usage

ARM7
32bitARM7
ThumbCM3
Thumb-2AVRH8/300HPIC24RL78V850ESSH-2ARX600IA-32 CompilerGCCGCCGCCGCCCH38C30CC78K0RCA850SHCRXCMSC -.text (Def, R/W)10.4k6.7k6.1k12.5k11.0k11.6k13.0k8.9k9.2k6.5k8.9k -.text (Min, R/W) 7.0k4.7k4.2k 8.5k 7.6k 8.1k 9.5k6.2k6.4k4.6k6.4k -.text (Def, R/O) 4.9k3.2k2.7k 6.1k 5.2k 5.5k 6.5k4.3k4.2k3.2k4.3k -.text (Min, R/O) 3.7k2.5k2.1k 4.4k 4.0k 4.3k 5.1k3.4k3.3k2.5k3.5k +.text (Def, R/W)10.5k6.7k6.1k12.6k11.0k11.4k13.0k8.9k9.2k6.5k8.9k +.text (Min, R/W) 7.0k4.7k4.2k 8.5k 7.6k 7.9k 9.4k6.3k6.4k4.7k6.3k +.text (Def, R/O) 4.9k3.2k2.8k 6.1k 5.2k 5.5k 6.5k4.4k4.2k3.2k4.3k +.text (Min, R/O) 3.7k2.5k2.1k 4.4k 4.0k 4.2k 5.0k3.4k3.3k2.5k3.4k .bssV*4 + 2V*4 + 2V*4 + 2V*2 + 2V*4 + 2V*2 + 2V*2 + 2V*4 + 2V*4 + 2V*4 + 2V*4 + 2 Work area
(FF_FS_TINY == 0)V*564
+ F*552V*564
+ F*552V*564
+ F*552V*560
+ F*546V*560
+ F*546V*560
+ F*546V*560
+ F*546V*564
+ F*552V*564
+ F*552V*564
+ F*552V*564
+ F*552 Work area
(FF_FS_TINY == 1)V*564
+ F*40V*564
+ F*40V*564
+ F*40V*560
+ F*34V*560
+ F*34V*560
+ F*34V*560
+ F*34V*564
+ F*40V*564
+ F*40V*564
+ F*40V*564
+ F*40

These are the memory usage of FatFs module without lower layer on some target systems in following condition. V denotes number of mounted volumes and F denotes number of open files. Every samples here are optimezed in code size.

-FatFs R0.14b options:
+FatFs R0.15b options:
 FF_FS_READONLY   0 (R/W, read/write) or 1 (R/O, read only)
 FF_FS_MINIMIZE   0 (Def, with all basic functions) or 3 (Min, with fully minimized)
 FF_FS_TINY       0 (Default) or 1 (Tiny file object)
@@ -166,169 +169,170 @@ 
Reducing Module Size

 
 

 
Long File Name

-
FatFs module supports the long file name (LFN) extension of the FAT filesystem. The two different file names, short file name (SFN) and LFN, of a file is transparent on the API. The support for LFN feature is disabled by default. To enable the LFN, set FF_USE_LFN to 1, 2 or 3, and add ffunicode.c to the project. The LFN feature requiers a certain working buffer. The buffer size can be configured by FF_MAX_LFN according to the available memory. The length of LFN can be up to 255 characters, so that the FF_MAX_LFN should be set to 255 for any existing file names. If the size of working buffer is insufficient for the input file name, the file function fails with FR_INVALID_NAME. When use any re-entry to the API with LFN feature in RTOS environment, FF_USE_LFN must be set to 2 or 3. In this case, the file function allocates the working buffer on the stack or heap. The LFN working buffer occupies (FF_MAX_LFN + 1) * 2 bytes and additional (FF_MAX_LFN + 44) / 15 * 32 bytes when exFAT is enabled.

-
Impact upon Module Size

-
-
-
-
-
-
-
-
-
-
With LFN at CM3 + gcc
FF_CODE_PAGECode size
437-869 (SBCS)+3.3k
932 (Japanese)+62k
936 (Simplified Chinese)+177k
949 (Korean)+140k
950 (Traditional Chinese)+111k
0 (All code pages)+486k

-
When the LFN is enabled, the module size will be increased depends on the configured code page. Right table shows the increment of code size in some code pages. Especially, in the CJK region, tens of thousands of characters are being used. Unfortunately, it requires a huge OEM-Unicode bidirectional conversion table and the module size will be drastically increased as shown in the table.

-
As the result, the FatFs with LFN enabled with DBCS code pages will not able to be ported on the most 8-bit MCU systems. If the target system is in legacy-free, in only Unicode and any ANSI/OEM code is not used at all, the code page setting gets meaningless. You will able to reduce the code size by configureing FatFs for Unicode API with any SBCS code page.

-
There ware some restrictions on using LFN for open source project, because the LFN extension on the FAT filesystem was a patent of Microsoft Corporation. However the related patents all have expired and using the LFN feature is free for any projects.

-

-
-

-
Unicode API

-
By default, FatFs uses ANSI/OEM code set on the API even in LFN configuration. FatFs can also switch the character encoding on the API to Unicode by configuration option FF_LFN_UNICODE. This means that FatFs is compliant with the full featured LFN specification. The data type TCHAR specifies path name strings on the API is an alias of either char(ANSI/OEM or UTF-8), WCHAR(UTF-16) or DWORD(UTF-32) depends on that option. For more information, refer to the description in the file name.

-
Note that setting of code page, FF_CODE_PAGE, has actually no meaning when FatFs is configured for the Unicode API. It should be set 437 to reduce the module size. However it still affects code conversion of string I/O functions when FF_STRF_ENCODE == 0, and also backward compatibility with legacy systems. In this case, the code page may need to be configured properly if it is considered a problem.

-

-
-

-
exFAT Filesystem

-
The exFAT (Microsoft's Extended File Allocation Table) filesystem is a succession of the FAT/FAT32 filesystem which has been widely used in embedded systems, consumer devices and portable storage media. It is adopted by SDA (SD Association) as the filesystem for SDXC card, 64 GB and larger, and they are being shipped with this format. Therefore the exFAT is one of the standard filesystems for removable media as well as FAT. The exFAT filesystem allows the file size beyond the 4 GB limit what FAT filesystem allows up to and some filesystem overhead, especially cluster allocation delay, are reduced as well. These features allow to record the large data without dividing into some files and improve the write throughput to the file.

-
Note that the exFAT filesystem is a patent of Microsoft Corporation. The exFAT feature of FatFs is an implementation based on US. Pat. App. Pub. No. 2009/0164440 A1. FatFs module can switch the exFAT on or off by a configuration option, FF_FS_EXFAT. When enable the exFAT for the commercial products, a license by Microsoft will be needed depends on the final destination of the products.

-
Remarks: Enabling exFAT discards C89 compatibility and it wants C99 because of need for 64-bit integer type.

-

-
-

-
64-bit LBA

-
LBA (Logical Block Addressing) is an addressing method to specify the location of data block, called sector, on the storage media. It is a simple linear address beginning from 0 as the first sector, 1 as the second sector and so on. The host system does not need to consider how the data block is located and managed in the storage device. FatFs supports only LBA for the media access. 32-bit LBA is a common size in the most LBA scheme. It can address up to 232 sectors, 2 TB in 512 bytes/sector. When a storage device larger than 2 TB is used, larger sector size or 64-bit LBA will be needed to address the entire sectors of the storage device.

-
By default, FatFs works in 32-bit LBA for media access. FatFs can also switch it to 64-bit LBA by a configuration option FF_LBA64. It also enables GPT (GUID Partition Table) for partiotion management on the storage device. For further information about GPT, refer to f_mkfs and f_fdisk function.

-

-
-

-
Re-entrancy

-
The file operations of two tasks to the different volumes each other is always re-entrant regardless of the configurations except when LFN is enabled with static working buffer (FF_USE_LFN = 1). It can work concurrently without any mutual exclusion.

-
The file operations of two tasks to the same volume is not re-entrant in default. FatFs can also be configured to make it thread-safe by option FF_FS_REENTRANT. In this case, also the OS dependent synchronization control functions, ff_cre_syncobj/ff_del_syncobj/ff_req_grant/ff_rel_grant, need to be added to the project. There are some examples in the ffsystem.c. When a file function is called while the volume is being accessed by another task, the file function to the volume will be suspended until that task leaves the file function. If the wait time exceeded a period defined by FF_TIMEOUT, the file function will abort with FR_TIMEOUT. The timeout feature might not be supported on the some RTOSs.

-
There is an exception on the re-entrancy for f_mount/f_mkfs function. These volume management functions are not re-entrant to the same volume. When use these functions, other tasks need to avoid to access the volume.

-

-
-
-
-
-
-
-
-
-
FunctionCase 1Case 2Case 3
disk_statusYesYesYes(*)
disk_initializeNoYesYes(*)
disk_readNoYesYes(*)
disk_writeNoYesYes(*)
disk_ioctlNoYesYes(*)
get_fattimeNoYesYes

-
-Case 1: Same volume.

-Case 2: Different volume on the same drive.

-Case 3: Different volume on the different drive.

-(*) In only different drive number.
-
-

-
Remarks: This section describes on the re-entrancy of the FatFs module itself. The FF_FS_REENTRANT option enables only exclusive use of each filesystem objects and FatFs does not that prevent to re-enter the storage device control functions. Thus the device control layer needs to be always thread-safe when FatFs API is re-entered for different volumes. Right table shows which control function can be re-entered when FatFs API is re-entered on some conditions.

-

-
-

-
Duplicated File Open

-
FatFs module does not support the read/write collision control of duplicated open to a file. The duplicated open is permitted only when each of open method to a file is read mode. The duplicated open with one or more write mode to a file is always prohibited, and also open file must not be renamed or deleted. A violation of these rules can cause data collaption.

-
The file lock control can be enabled by FF_FS_LOCK option. The value of option defines the number of open objects to manage simultaneously. In this case, if any opening, renaming or removing against the file shareing rule that described above is attempted, the file function will be rejected with FR_LOCKED. If number of open objects, files and sub-directories, is equal to FF_FS_LOCK, an extra f_open/f_opendir function will fail with FR_TOO_MANY_OPEN_FILES.

-

-
-

-
Performance Effective File Access

-
For good read/write throughput on the small embedded systems with limited size of memory, application programmer should consider what process is done in the FatFs module. The file data on the volume is transferred in following sequence by f_read function.

-
Figure 1. Sector unaligned read (short)

-
-

-
Figure 2. Sector unaligned read (long)

-
-

-
Figure 3. Fully sector aligned read

-
-

-
The file I/O buffer is a sector buffer to read/write a part of data on the sector. The sector buffer is either file private sector buffer on each file object or shared sector buffer in the filesystem object. The buffer configuration option FF_FS_TINY determins which sector buffer is used for the file data transfer. When tiny buffer configuration (1) is selected, data memory consumption is reduced FF_MAX_SS bytes each file object. In this case, FatFs module uses only a sector buffer in the filesystem object for file data transfer and FAT/directory access. The disadvantage of the tiny buffer configuration is: the FAT data cached in the sector buffer will be lost by file data transfer and it must be reloaded at every cluster boundary. However it will be suitable for most application from view point of the decent performance and low memory comsumption.

-
Figure 1 shows that a partial sector, sector unaligned part of the file, is transferred via the file I/O buffer. At long data transfer shown in Figure 2, middle of transfer data that covers one or more sector is transferred to the application buffer directly. Figure 3 shows that the case of entier transfer data is aligned to the sector boundary. In this case, file I/O buffer is not used. On the direct transfer, the maximum extent of sectors are read with disk_read function at a time but the multiple sector transfer is divided at cluster boundary even if it is contiguous.

-
Therefore taking effort to sector aligned read/write accesss eliminates buffered data transfer and the read/write performance will be improved. Besides the effect, cached FAT data will not be flushed by file data transfer at the tiny configuration, so that it can achieve same performance as non-tiny configuration with small memory footprint.

-

-
-

-
Considerations on Flash Memory Media

-
To maximize the write performance of flash memory media, such as SDC, CFC and U Disk, it must be controlled in consideration of its characteristitcs.

-
Using Mutiple-Sector Write

-

-Figure 6. Comparison between Multiple/Single Sector Write

-fig.6
-

-
The write throughput of the flash memory media becomes the worst at single sector write transaction. The write throughput increases as the number of sectors per a write transaction as shown in Figure 6. This effect more appers at faster interface speed and the performance ratio often becomes grater than ten. This result is clearly explaining how fast is multiple block write (W:16K, 32 sectors) than single block write (W:100, 1 sector), and also larger card tends to be slow at single block write. Number of write transactions also affects life time of the flash memory media. When compared at same amount of write data, the single sector write in Figure 6 above wears flash memory media 16 times more than multiple sector write in Figure 6 below. Single sector write is pretty pain for the flash memory media.

-
Therefore the application program should write the data in large block as possible. The ideal write chunk size and alighment is size of sector, and size of cluster is the best. Of course all layers between the application and the storage device must have consideration on multiple sector write, however most of open-source memory card drivers lack it. Do not split a multiple sector write request into single sector write transactions or the write throughput gets poor. Note that FatFs module and its sample disk drivers supprt multiple sector read/write operation. 

-
Forcing Memory Erase

-
When remove a file with f_unlink function, the data clusters occupied by the file are marked 'free' on the FAT. But the data sectors containing the file data are not that applied any process, so that the file data left occupies a part of the flash memory array as 'live block'. If the file data can be erased on removing the file, those data blocks will be turned into the free block pool. This may skip internal block erase operation to the data block on next write operation. As the result the write performance might be improved. FatFs can manage this function by setting FF_USE_TRIM to 1. Note that because this effect is from an expectation of internal process of the storage device, it is not that always effective. Most applications will not need this function. Also f_unlink function can take a time when remove a large file.

-

-
-

-
Critical Section

-
If a write operation to the FAT volume is interrupted due to an accidental failure, such as sudden blackout, wrong media removal and unrecoverable disk error, the FAT structure on the volume can be broken. Following images shows the critical section of the FatFs module.

-

-Figure 4. Long critical section

-fig.4
-

-

-Figure 5. Minimized critical section

-fig.5
-

-

-
An interruption in the red section can cause a cross link; as a result, the object being changed can be lost. If an interruption in the yellow section is occured, there is one or more possibility listed below.

-
    
-
  • The file data being rewrited is collapsed.
    • 
-
  • The file being appended returns initial state.
    • 
-
  • The file created as new is gone.
    • 
-
  • The file created as new or overwritten remains but no content.
    • 
-
  • Efficiency of disk use gets worse due to lost clusters.
    • 
-

-
Each case does not affect any file not opened in write mode. To minimize risk of data loss, the critical section can be minimized by minimizing the time that file is opened in write mode or using f_sync function as shown in Figure 5.

-

-
-

-
Various Usable Functions for FatFs Projects

-
These are examples of extended use of FatFs APIs. New item will be added when useful code example is found.

-
    
-
  1. Open or Create File for Append (superseded by FA_OPEN_APPEND flag added at R0.12)
    2. 
-
  2. Delete Non-empty Sub-directory (for R0.12 and later)
    3. 
-
  3. Create Contiguous File (superseded by f_expand function added at R0.12)
    4. 
-
  4. Test if the File is Contiguous or Not
    5. 
-
  5. Compatibility Checker for Storage Device Control Module
    6. 
-
  6. Performance Checker for Storage Device Control Module
    7. 
-
  7. FAT Volume Image Creator (Pre-creating built-in FAT volume)
    8. 
-
  8. Virtual Drive Feature (refer to lpc176x/ in ffsample.zip)
    9. 
-
  9. Embedded Unicode String Utilities (OEMxxx→Unicode, Unicode→OEMxxx, Unicode→Unicode)
    10. 
-

-

-
-

-
About FatFs License

-
FatFs has being developped as a personal project of the author, ChaN. It is free from the code anyone else wrote at current release. Following code block shows a copy of the FatFs license document that included in the source files.

-
-/*----------------------------------------------------------------------------/
-/  FatFs - Generic FAT Filesystem Module  Rx.xx                               /
-/-----------------------------------------------------------------------------/
-/
-/ Copyright (C) 20xx, ChaN, all right reserved.
-/
-/ FatFs module is an open source software. Redistribution and use of FatFs in
-/ source and binary forms, with or without modification, are permitted provided
-/ that the following condition is met:
-/
-/ 1. Redistributions of source code must retain the above copyright notice,
-/    this condition and the following disclaimer.
-/
-/ This software is provided by the copyright holder and contributors "AS IS"
-/ and any warranties related to this software are DISCLAIMED.
-/ The copyright owner or contributors be NOT LIABLE for any damages caused
-/ by use of this software.
-/----------------------------------------------------------------------------*/
-

-
Therefore FatFs license is one of the BSD-style licenses but there is a significant feature. FatFs is mainly intended for embedded systems. In order to extend the usability for commercial products, the redistributions of FatFs in binary form, such as embedded code, binary library and any forms without source code, does not need to include about FatFs in the documentations. This is equivalent to the 1-clause BSD license. Of course FatFs is compatible with the most of open source software licenses includes GNU GPL. When you redistribute the FatFs source code with any changes or create a fork, the license can also be changed to GNU GPL, BSD-style license or any open source software license that compatible with FatFs license.

-

-
-
Return Home

-
-
+
FatFs module supports the long file name (LFN) extension of the FAT filesystem. The two different file names, short file name (SFN) and LFN, of a file are transparent on the API. The support for LFN feature is disabled by default. To enable the LFN, set FF_USE_LFN to 1, 2 or 3, and add ffunicode.c to the project. The LFN feature requiers a certain working buffer. The buffer size can be configured by FF_MAX_LFN according to the available memory. The LFN specification allows the length of LFN up to 255 characters, so that the FF_MAX_LFN should be set to 255 for every existing file name. If the size of working buffer is insufficient for the input file name, the file function fails with FR_INVALID_NAME. When use any re-entry to the file API with LFN feature in RTOS environment, FF_USE_LFN must be set to 2 or 3. In this case, the file function allocates the working buffer on the stack or heap. The LFN working buffer occupies (FF_MAX_LFN + 1) * 2 bytes and additional (FF_MAX_LFN + 44) / 15 * 32 bytes when exFAT is enabled.

+
Code Page and Module Size

+
+
+
+
+
+
+
+
+
+
With LFN at CM3 + gcc
FF_CODE_PAGECode size
437-869 (SBCS)+3.3k
932 (Japanese)+62k
936 (Simplified Chinese)+177k
949 (Korean)+140k
950 (Traditional Chinese)+111k
0 (All code pages)+486k

+
When the LFN is enabled, the module size will be increased depends on the configured code page. Right table shows the increment of code size in some code pages. Especially, in the CJK region, tens of thousands of characters are being used. Unfortunately, it requires a huge OEM-Unicode bidirectional conversion table and the module size will be drastically increased as shown in the table.

+
As the result, the FatFs with LFN enabled with DBCS code pages will not able to be ported on the most 8-bit MCU systems. If the target system is in legacy-free, in only Unicode and any ANSI/OEM code is not used at all, the code page setting is meaningless. You will able to reduce the code size by configureing FatFs for Unicode API with some SBCS code page.

+
There ware some restrictions on using the LFN in open source project, because the LFN extension on the FAT filesystem was a patent of Microsoft Corporation. However the related patents all have expired and using the LFN feature is free for any project.

+
+ +
+

Unicode API

+

By default, FatFs uses ANSI/OEM code set on the API even in LFN configuration. FatFs can also switch the character encoding on the API to Unicode by configuration option FF_LFN_UNICODE. This means that FatFs is compliant with the full featured LFN specification. The data type TCHAR specifies path name strings on the API is an alias of either char(ANSI/OEM or UTF-8), WCHAR(UTF-16) or DWORD(UTF-32) depends on that option. For more information, refer to the description in the file name.

+

Note that setting of code page, FF_CODE_PAGE, has actually no meaning when FatFs is configured for the Unicode API. It should be set 437 to reduce the module size. However it still affects code conversion of string I/O functions when FF_STRF_ENCODE == 0, and also backward compatibility with legacy systems. In this case, the code page may need to be configured properly if it is considered a problem.

+
+ +
+

exFAT Filesystem

+

The exFAT (Microsoft's Extended File Allocation Table) filesystem is a succession of the FAT/FAT32 filesystem which has been widely used in embedded systems, consumer devices and portable storage media. It is adopted by SDA (SD Association) as the filesystem for SDXC card, 64 GB and larger, and they are being shipped with this format. Therefore the exFAT is one of the standard filesystems for removable media as well as FAT. The exFAT filesystem allows the file size beyond the 4 GB limit what FAT filesystem allows up to and some filesystem overhead, especially cluster allocation delay, are reduced as well. These features allow to record the large data without dividing into some files and improve the write throughput to the file.

+

Note that the exFAT filesystem is a patent of Microsoft Corporation. The exFAT feature of FatFs is an implementation based on US. Pat. App. Pub. No. 2009/0164440 A1. FatFs module can switch the exFAT on or off by a configuration option, FF_FS_EXFAT. When enable the exFAT for the commercial products, a license by Microsoft will be needed depends on the final destination of the products.

+

Remarks: Enabling exFAT discards C89 compatibility and it wants C99 because of need for 64-bit integer type.

+
+ +
+

64-bit LBA

+

LBA (Logical Block Addressing) is an addressing method to specify the location of data block, called sector, on the storage media. It is a simple linear address beginning from 0 as the first sector, 1 as the second sector and so on. The host system does not need to consider how the data block is located and managed in the storage device. FatFs supports only LBA for the media access. 32-bit LBA is a common size in the most LBA scheme. It can address up to 232 sectors, 2 TB in 512 bytes/sector. When a storage device larger than 2 TB is used, larger sector size or 64-bit LBA will be needed to address the entire sectors of the storage device.

+

By default, FatFs works in 32-bit LBA for media access. FatFs can also switch it to 64-bit LBA by a configuration option FF_LBA64. It also enables GPT (GUID Partition Table) for partition management on the storage device. For further information about GPT, refer to f_mkfs and f_fdisk function.

+
+ +
+

Re-entrancy

+

The file operations of two tasks to the different volumes each other is always re-entrant and it can work concurrently without any mutual exclusion regardless of the configurations except when LFN is enabled with static working buffer (FF_USE_LFN = 1).

+

The file operations of two tasks to the same volume is not thread-safe by default. FatFs can also be configured to make it thread-safe by an option FF_FS_REENTRANT. When a file function is called while the volume is being accessed by another task, the file function to the volume will be suspended until that task leaves the file function. If the wait time exceeded a period defined by FF_TIMEOUT, the file function will abort with FR_TIMEOUT. The timeout feature might not be supported on the some OSs. To enable this feature, OS dependent synchronization control functions, ff_mutex_create/ff_mutex_delete/ff_mutex_take/ff_mutex_give, need to be added to the project. There is an example code in the ffsystem.c for some OSs.

+

Note that there is an exception on the re-entrancy for f_mount and f_mkfs function. You will know why it is. These volume management functions are always not thread-safe to the volume being processed. When use these functions, other tasks need to avoid to access the corresponding volume.

+
+ + + + + + + + +
FunctionCase 1Case 2Case 3
disk_statusYesYesYes(*)
disk_initializeNoYesYes(*)
disk_readNoYesYes(*)
disk_writeNoYesYes(*)
disk_ioctlNoYesYes(*)
get_fattimeNoYesYes
+ +Case 1: Same volume.
+Case 2: Different volume on the same drive.
+Case 3: Different volume on the different drive.
+(*) In only different drive number. + +
+

Remarks: This section describes on the re-entrancy of the FatFs module itself. The FF_FS_REENTRANT option enables only exclusive use of each filesystem objects and FatFs does not that prevent to re-enter the storage device control functions. Thus the device control layer needs to be always thread-safe when FatFs API is re-entered for different volumes. Right table shows which control function can be re-entered when FatFs API is re-entered on some conditions.

+
+ +
+

Duplicated File Open

+

FatFs module does not support the read/write collision control of duplicated open to a file. The duplicated open is permitted only when each of open method to a file is read mode. The duplicated open with one or more write mode to a file is always prohibited, and also open file must not be renamed or deleted. A violation of these rules can cause data collaption.

+

The file lock control can be enabled by FF_FS_LOCK option. The value of option defines the number of open objects to manage simultaneously. In this case, if any opening, renaming or removing against the file shareing rule that described above is attempted, the file function will be rejected with FR_LOCKED. If number of open objects, files and sub-directories, is equal to FF_FS_LOCK, an extra f_open/f_opendir function will fail with FR_TOO_MANY_OPEN_FILES.

+
+ +
+

Performance Effective File Access

+

For good read/write throughput on the small embedded systems with limited size of memory, application programmer should consider what process is done in the FatFs module. The file data on the volume is transferred in following sequence by f_read function.

+

Figure 1. Sector unaligned read (short)
+ +

+

Figure 2. Sector unaligned read (long)
+ +

+

Figure 3. Fully sector aligned read
+ +

+

The file I/O buffer is a sector buffer to read/write a part of data on the sector. The sector buffer is either file private sector buffer on each file object or shared sector buffer in the filesystem object. The buffer configuration option FF_FS_TINY determins which sector buffer is used for the file data transfer. When tiny buffer configuration (1) is selected, data memory consumption is reduced FF_MAX_SS bytes each file object. In this case, FatFs module uses only a sector buffer in the filesystem object for file data transfer and FAT/directory access. The disadvantage of the tiny buffer configuration is: the FAT data cached in the sector buffer will be lost by file data transfer and it must be reloaded at every cluster boundary. However it will be suitable for most application from view point of the decent performance and low memory comsumption.

+

Figure 1 shows that a partial sector, sector unaligned part of the file, is transferred via the file I/O buffer. At long data transfer shown in Figure 2, middle of transfer data that covers one or more sector is transferred to the application buffer directly. Figure 3 shows that the case of entier transfer data is aligned to the sector boundary. In this case, file I/O buffer is not used. On the direct transfer, the maximum extent of sectors are read with disk_read function at a time but the multiple sector transfer is divided at cluster boundary even if it is contiguous.

+

Therefore taking effort to sector aligned read/write accesss eliminates buffered data transfer and the read/write performance will be improved. Besides the effect, cached FAT data will not be flushed by file data transfer at the tiny configuration, so that it can achieve same performance as non-tiny configuration with small memory footprint.

+
+ +
+

Considerations on Flash Memory Media

+

To maximize the write performance of flash memory media, such as SDC, CFC and U Disk, it must be controlled in consideration of its characteristitcs.

+

Using Mutiple-Sector Write

+
+Figure 6. Comparison between Multiple/Single Sector Write
+fig.6 +
+

The write throughput of the flash memory media becomes the worst at single sector write transaction. The write throughput increases as the number of sectors per a write transaction as shown in Figure 6. This effect more appers at faster interface speed and the performance ratio often becomes grater than ten. This result is clearly explaining how fast is multiple block write (W:16K, 32 sectors) than single block write (W:100, 1 sector), and also larger card tends to be slow at single block write. Number of write transactions also affects life time of the flash memory media. When compared at same amount of write data, the single sector write in Figure 6 above wears flash memory media 16 times more than multiple sector write in Figure 6 below. Single sector write is pretty pain for the flash memory media.

+

Therefore the application program should write the data in large block as possible. The ideal write chunk size and alighment is size of sector, and size of cluster is the best. Of course all layers between the application and the storage device must have consideration on multiple sector write, however most of open-source memory card drivers lack it. Do not split a multiple sector write request into single sector write transactions or the write throughput gets poor. Note that FatFs module and its sample disk drivers supprt multiple sector read/write operation.

+

Forcing Memory Erase

+

When remove a file with f_unlink function, the data clusters occupied by the file are marked 'free' on the FAT. But the data sectors containing the file data are not that applied any process, so that the file data left occupies a part of the flash memory array as 'live block'. If the file data can be erased on removing the file, those data blocks will be turned into the free block pool. This may skip internal block erase operation to the data block on next write operation. As the result the write performance might be improved. FatFs can manage this function by setting FF_USE_TRIM to 1. Note that because this effect is from an expectation of internal process of the storage device, it is not that always effective. Most applications will not need this function. Also f_unlink function can take a time when remove a large file.

+
+ +
+

Critical Section

+

If a write operation to the FAT volume is interrupted due to an accidental failure, such as sudden blackout, wrong media removal and unrecoverable disk error, the FAT structure on the volume can be broken. Following images shows the critical section of the FatFs module.

+
+Figure 4. Long critical section
+fig.4 +
+
+Figure 5. Minimized critical section
+fig.5 +
+
+

An interruption in the red section can cause a cross link; as a result, the object being changed can be lost. If an interruption in the yellow section is occured, there is one or more possibility listed below.

+ +

Each case does not affect any file not opened in write mode. To minimize risk of data loss, the critical section can be minimized by minimizing the time that file is opened in write mode or using f_sync function as shown in Figure 5.

+
+ +
+

Various Usable Functions for FatFs Projects

+

These are examples of extended use of FatFs APIs. New item will be added when useful code example is found.

+
    +
  1. Open or Create File for Append (superseded by FA_OPEN_APPEND flag added at R0.12)
    2. +
  2. Delete Non-empty Sub-directory (for R0.12 and later)
    3. +
  3. Create Contiguous File (superseded by f_expand function added at R0.12)
    4. +
  4. Test if the File is Contiguous or Not
    5. +
  5. Compatibility Checker for Storage Device Control Module
    6. +
  6. Performance Checker for Storage Device Control Module
    7. +
  7. FAT Volume Image Creator (Pre-creating built-in FAT volume)
    8. +
  8. Virtual Drive Feature (refer to lpc176x/ in ffsample.zip)
    9. +
  9. Embedded Unicode String Utilities (OEMxxx→Unicode, Unicode→OEMxxx, Unicode→Unicode)
    10. +
+
+ +
+

About FatFs License

+

FatFs has being developped as a personal project of the author, ChaN. It is free from the code anyone else wrote at current release. Following code block shows a copy of the FatFs license document that included in the source files.

+
+/*----------------------------------------------------------------------------/
+/  FatFs - Generic FAT Filesystem Module  Rx.xx                               /
+/-----------------------------------------------------------------------------/
+/
+/ Copyright (C) 20xx, ChaN, all right reserved.
+/
+/ FatFs module is an open source software. Redistribution and use of FatFs in
+/ source and binary forms, with or without modification, are permitted provided
+/ that the following condition is met:
+/
+/ 1. Redistributions of source code must retain the above copyright notice,
+/    this condition and the following disclaimer.
+/
+/ This software is provided by the copyright holder and contributors "AS IS"
+/ and any warranties related to this software are DISCLAIMED.
+/ The copyright owner or contributors be NOT LIABLE for any damages caused
+/ by use of this software.
+/----------------------------------------------------------------------------*/
+
+

Therefore FatFs license is one of the BSD-style licenses but there is a significant feature. FatFs is mainly intended for embedded systems. In order to extend the usability for commercial products, the redistributions of FatFs in binary form, such as embedded code, binary library and any forms without source code, does not need to include about FatFs in the documentations. This is equivalent to the 1-clause BSD license. Of course FatFs is compatible with the most of open source software licenses includes GNU GPL. When you redistribute the FatFs source code with any changes or create a fork, the license can also be changed to GNU GPL, BSD-style license or any open source software license that compatible with FatFs license.

+
+ + +

Return

+ + diff --git a/vendor/fatfs/documents/doc/chdir.html b/vendor/fatfs/documents/doc/chdir.html index 93e116c..a91ab0f 100644 --- a/vendor/fatfs/documents/doc/chdir.html +++ b/vendor/fatfs/documents/doc/chdir.html @@ -3,8 +3,6 @@ - - FatFs - f_chdir @@ -83,6 +81,7 @@

See Also

f_chdrive, f_getcwd

+

Return

diff --git a/vendor/fatfs/documents/doc/chdrive.html b/vendor/fatfs/documents/doc/chdrive.html index 4dfc7d8..fd821c4 100644 --- a/vendor/fatfs/documents/doc/chdrive.html +++ b/vendor/fatfs/documents/doc/chdrive.html @@ -3,8 +3,6 @@ - - FatFs - f_chdrive @@ -65,6 +63,7 @@

See Also

f_chdir, f_getcwd

+

Return

diff --git a/vendor/fatfs/documents/doc/chmod.html b/vendor/fatfs/documents/doc/chmod.html index 91e520f..b7173fd 100644 --- a/vendor/fatfs/documents/doc/chmod.html +++ b/vendor/fatfs/documents/doc/chmod.html @@ -3,8 +3,6 @@ - - FatFs - f_chmod @@ -27,7 +25,7 @@

f_chmod

Parameters

path
-
Pointer to the null-terminated string that specifies an object to be changed
+
Pointer to the null-terminated string that specifies an object to be changed. If a null pointer is given, the function fails with FR_INVALID_OBJECT.
attr
Attribute flags to be set in one or more combination of the following flags. The specified flags are set and others are cleard.
@@ -84,6 +82,7 @@

Example

+

Return

diff --git a/vendor/fatfs/documents/doc/close.html b/vendor/fatfs/documents/doc/close.html index f4cd2df..3fe9827 100644 --- a/vendor/fatfs/documents/doc/close.html +++ b/vendor/fatfs/documents/doc/close.html @@ -3,8 +3,6 @@ - -FatFs - f_close @@ -60,6 +58,7 @@

See Also

f_open, f_read, f_write, f_sync, FIL, FATFS

+

Return

diff --git a/vendor/fatfs/documents/doc/closedir.html b/vendor/fatfs/documents/doc/closedir.html index 3f5df57..bf4febe 100644 --- a/vendor/fatfs/documents/doc/closedir.html +++ b/vendor/fatfs/documents/doc/closedir.html @@ -3,8 +3,6 @@ - -FatFs - f_closedir @@ -59,6 +57,7 @@

See Also

f_opendir, f_readdir, DIR

+

Return

diff --git a/vendor/fatfs/documents/doc/config.html b/vendor/fatfs/documents/doc/config.html index a4c7814..d3977df 100644 --- a/vendor/fatfs/documents/doc/config.html +++ b/vendor/fatfs/documents/doc/config.html @@ -3,15 +3,13 @@ - -FatFs - Configuration Options

Configuration Options

-

There are many options to configure the functions of FatFs for requirement of each project. The configuration options are defined in the ffconf.h.

+

There are many options to configure the features of FatFs for various requirements of each project. The configuration options are defined in ffconf.h.

  • Function Configurations
      @@ -58,6 +56,7 @@

      Configuration Options

    • FF_FS_EXFAT
    • FF_FS_NORTC
    • FF_NORTC_MON, FF_NORTC_MDAY, FF_NORTC_YEAR
      • +
    • FF_FS_CTIME
    • FF_FS_NOFSINFO
    • FF_FS_LOCK
    • FF_FS_REENTRANT
      • @@ -105,29 +104,29 @@

      FF_USE_FORWARD

      Disable (0) or Enable (1) f_forward function.

      FF_USE_STRFUNC

      -

      This option switches string functions, f_gets, f_putc, f_puts and f_printf. These functions are equivalents of regular string stream I/O functions in POSIX. If sprintf is available and code conversion is not needed, f_write with sprintf will be efficient in code size and performance rather than f_printf.

      +

      This option switches string I/O functions, f_gets, f_putc, f_puts and f_printf. These functions are the equivalents of regular string stream I/O functions in POSIX. If sprintf is available and code conversion is not needed, f_write with sprintf will be efficient in code size and performance better than f_printf. When enable this feature, stdarg.h is included in ff.c.

- - + +
ValueDescription
0Disable string functions.
1Enable string functions without LF-CRLF conversion.
2Enable string functions with LF-CRLF conversion.
1Enable string functions without LF - CRLF conversion.
2Enable string functions with LF - CRLF conversion.

This option switches support for long long integer argument in f_printf.

-

Disable (0) or Enable (1). C standard needs to be C99 or later to enable this feature.

+

Disable (0) or Enable (1). When enable this feature, C standard needs to be C99 or later. This option has no effect when FF_USE_STRFUNC == 0.

-

This option switches support for floating point argument in f_printf. C standard needs to be C99 or later to enable this feature.

+

This option switches support for floating point argument in f_printf. When enable this feature, C standard needs to be C99 or later and math.h is included in ff.c. This option has no effect when FF_USE_STRFUNC == 0.

- +
ValueDescription
0Disable floating point argument.
1Enable floating point argument in type 'f', 'e' and 'E'.
2Enable with decimal separator ',' instead of '.'.
2Same as 1 but with decimal separator ',' instead of '.' in output string.

FF_STRF_ENCODE

-

When character encoding on the API is Unicode (FF_LFN_UNICODE >= 1), string I/O functions enabled by FF_USE_STRFUNC convert the character encoding in it. This option defines the assumption of character encoding on the file to be read/written via those functions. When LFN is not enabled or FF_LFN_UNICODE == 0, the string functions work without any code conversion and this option has no effect.

+

When the character encoding on the API is Unicode (FF_LFN_UNICODE >= 1), string I/O functions enabled by FF_USE_STRFUNC convert the character encoding in it. This option defines the assumption of character encoding on the file to be read/written via the string I/O functions. When LFN is not enabled or FF_LFN_UNICODE == 0, the string I/O functions work without any code conversion and this option has no effect.

@@ -210,8 +209,8 @@

FF_FS_RPATH

This option configures relative path function. For more information, read here.

ValueCharacter encoding on the file
0ANSI/OEM in current code page
- - + +
ValueDescription
0Disable relative path function and remove related functions.
1Enable relative path function. f_chdir and f_chdrive function is available.
0Disable relative path and remove related functions.
1Enable relative path. f_chdir and f_chdrive function is available.
2f_getcwd function is available in addition to 1
@@ -228,9 +227,9 @@

FF_STR_VOLUME_ID

This option switches the support for string volume ID. When arbitrary string for the volume ID is enabled for the drive prefix, also pre-defined strings by FF_VOLUME_STRS or user defined strings can be used as drive prefix in the path name. Numeric drive number is always valid regardless of this option, and also either format of drive prefix can be enabled by this option.

- - - + + +
ValueDescriptionExample
0Only DOS/Windows style drive prefix in numeric ID can be used.1:/filename
1Also DOS/Windows style drive prefix in string ID can be used.flash:/filename
2Also Unix style drive prefix in string ID can be used./flash/filename
0DOS/Windows style drive prefix in numeric ID.1:/filename
10 + DOS/Windows style drive prefix in arbitry string ID.flash:/filename
20 + Unix style drive prefix in arbitry string ID./flash/filename

FF_VOLUME_STRS

@@ -241,7 +240,7 @@

FF_VOLUME_STRS

FF_MULTI_PARTITION

-

Disable (0) or Enable (1). This option switches multi-partition function. By default (0), each logical drive number is bound to the same physical drive number and only a volume in the physical drive is mounted. When enabled, each logical drive is bound to the partition on the physical drive listed in the user defined partition resolution table VolToPart[]. Also f_fdisk funciton will be available. For more information, read here.

+

This option switches multi-partition featuer. By default (0), each logical drive number is bound to the same physical drive number and only one volume found in the physical drive is mounted. When it is enabled (1), each logical drive is bound to the specific partition listed in the user defined partition resolution table VolToPart[]. Also f_fdisk funciton is available to create the arbitrary partitions on the physical drive. For more information, read here.

FF_MIN_SS, FF_MAX_SS

This set of options defines the extent of sector size used for the low level disk I/O interface, disk_read and disk_write function. Valid values are 512, 1024, 2048 and 4096. FF_MIN_SS defines minimum sector size and FF_MAX_SS defines the maximum sector size. Always set both 512 for memory card and harddisk. But a larger value may be required for on-board flash memory and some type of optical media. When FF_MAX_SS > FF_MIN_SS, support of variable sector size is enabled and GET_SECTOR_SIZE command needs to be implemented to the disk_ioctl function.

@@ -250,7 +249,7 @@

FF_LBA64

This option switches media access interface to 64-bit LBA and enables GUID Partition Table (GPT) for partition management, Enabled (1) or Disabled (0). exFAT filesystem needs to be enabled to enable this feature.

FF_MIN_GPT

-

This option specifies the threshold of determination of partitioning format when create patitions on the drive in f_mkfs and f_fdisk function. When number of sectors on the drive is equal or larger than this value, the drive will be partitioned in GPT. This option has no effect when FF_LBA64 == 0.

+

This option specifies the threshold of determination of partitioning format when create patitions on the drive in f_mkfs and f_fdisk function. When number of available sectors is equal or larger than this value, the drive will be partitioned in GPT. This option has no effect when FF_LBA64 == 0.

FF_USE_TRIM

Disable (0) or Enable (1). This option switches ATA-TRIM function. To enable Trim function, also CTRL_TRIM command should be implemented to the disk_ioctl function.

@@ -268,13 +267,16 @@

FF_FS_EXFAT

This option switches support for exFAT filesystem in addition to the FAT/FAT32 filesystem, Enabled (1) or Disabled (0). To enable exFAT, also LFN must be enabled and configureing FF_LFN_UNICODE >= 1 and FF_MAX_LFN == 255 is recommended for full-featured exFAT function. Note that enabling exFAT discards ANSI C (C89) compatibility and wants C99 because of need for 64-bit integer type.

FF_FS_NORTC

-

Use RTC (0) or Do not use RTC (1). This option controls timestamp function. If the system does not have any RTC function or valid timestamp is not needed, set FF_FS_NORTC to 1 to disable the timestamp function. Every objects modified by FatFs will have a fixed timestamp defined by FF_NORTC_MON, FF_NORTC_MDAY and FF_NORTC_YEAR. To use the timestamp function, set FF_FS_NORTC == 0 and add get_fattime function to the project to get current time form the RTC. This option has no effect in read-only configuration.

+

Use RTC (0) or Do not use RTC (1). This option controls timestamp featuer. If the system does not have an RTC or valid timestamp is not needed, set FF_FS_NORTC to 1 to disable the timestamp function. Every objects modified by FatFs will have a constant timestamp defined by FF_NORTC_MON, FF_NORTC_MDAY and FF_NORTC_YEAR. To use the timestamp featuer, set FF_FS_NORTC == 0 and add get_fattime function to the project to get current time form the RTC. This option has no effect in read-only configuration.

FF_NORTC_MON, FF_NORTC_MDAY, FF_NORTC_YEAR

This set of options defines the time to be used in no RTC systems. This option has no effect in read-only configuration or FF_FS_NORTC == 0.

+

FF_FS_CTIME

+

This option enables (1) or disables (0) to access the file creation time with FILINFO structure.

+

FF_FS_NOFSINFO

-

0 to 3. 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 a full FAT scan. Bit 1 controls the use of last allocated cluster number for new allocation.

+

0 to 3. 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 the volume mounted will force a full FAT scan. Bit 1 controls the use of last allocated cluster number for new allocation.

@@ -284,24 +286,22 @@

FF_FS_NOFSINFO

ValueDescription
bit0=0Use free cluster count in the FSINFO if available.

FF_FS_LOCK

-

This option switches file lock function to control duplicated file open and illegal operations to open objects. Note that the file lock function is independent of re-entrancy. This option must be 0 in read-only configuration.

+

This option switches file lock feature to control duplicated file open and illegal operations to the open objects. Note that this feature is independent of re-entrancy. This option must be 0 in read-only configuration.

- - + +
ValueDescription
0Disable file lock function. To avoid collapsing file by wrong file operation, application program needs to avoid illegal open, remove and rename to the open objects.
>0Enable file lock function. The value defines how many files/sub-directories can be opened simultaneously under the file lock control. Illigal operations to the open object will be rejected with FR_LOCKED.
0Disable file lock feature. To avoid to collapse files due to wrong file operations, application program needs to avoid illegal open, remove and rename to the open objects.
>0Enable file lock feature. The value defines how many files/sub-directories can be opened simultaneously under the file lock feature. Illigal operations to the open object will be rejected with FR_LOCKED.

FF_FS_REENTRANT

-

Disable (0) or Enable (1). This option switches the re-entrancy (thread safe) of the FatFs module itself. Note that file/directory access to the different volume is always re-entrant and it can work simultaneously regardless of this option, however, volume management functions, f_mount, f_mkfs and f_fdisk, are always not re-entrant. Only file/directory access to the same volume, in other words, exclusive use of each filesystem object, is under control of this function. To enable this feature, also user provided synchronization handlers, ff_req_grant, ff_rel_grant, ff_del_syncobj and ff_cre_syncobj, need to be added to the project. Sample code is available in ffsystem.c.

+

Disable (0) or Enable (1). This option switches the re-entrancy (thread safe) of the FatFs module itself. Note that file/directory access to the different volume is always re-entrant and it can work simultaneously regardless of this option, however, volume management functions, f_mount, f_mkfs and f_fdisk, are always not re-entrant. Only file/directory access to the same volume, in other words, exclusive use of each filesystem object, is under control in this feature. To enable this feature, also user provided synchronization handlers, ff_mutex_take, ff_mutex_give, ff_mutex_create and ff_mutex_delete, need to be added to the project. Sample code is available in ffsystem.c.

FF_FS_TIMEOUT

-

Number of time ticks to abort the file function with FR_TIMEOUT when wait time is too long. This option has no effect when FF_FS_REENTRANT == 0.

- -

FF_SYNC_t

-

This option defines O/S dependent sync object type. e.g. HANDLE, ID, OS_EVENT*, SemaphoreHandle_t and etc. A header file for O/S definitions needs to be included somewhere in the scope of ff.c. This option has no effect when FF_FS_REENTRANT == 0.

+

Number of O/S time ticks to abort the file function with FR_TIMEOUT when the wait time exceeds this period. This option has no effect when FF_FS_REENTRANT == 0.

+

Return

diff --git a/vendor/fatfs/documents/doc/dinit.html b/vendor/fatfs/documents/doc/dinit.html index c668c66..688118c 100644 --- a/vendor/fatfs/documents/doc/dinit.html +++ b/vendor/fatfs/documents/doc/dinit.html @@ -3,8 +3,6 @@ - - FatFs - disk_initialize @@ -41,6 +39,7 @@

Description

Remarks: This function needs to be under control of FatFs module. Application program MUST NOT call this function while FatFs is in use, or FAT structure on the volume can be broken. To re-initialize the filesystem, use f_mount function instead.

+

Return

diff --git a/vendor/fatfs/documents/doc/dioctl.html b/vendor/fatfs/documents/doc/dioctl.html index 5208782..3c45bc9 100644 --- a/vendor/fatfs/documents/doc/dioctl.html +++ b/vendor/fatfs/documents/doc/dioctl.html @@ -3,8 +3,6 @@ - - FatFs - disk_ioctl @@ -57,11 +55,11 @@

Description

- - - - - + + + + +
Standard ioctl command used by FatFs
CommandDescription
CTRL_SYNCMakes sure that the device has finished pending write process. If the disk I/O layer or storage device has a write-back cache, the dirty cache data must be committed to media immediately. Nothing to do for this command if each write operation to the media is completed within the disk_write function.
GET_SECTOR_COUNTRetrieves number of available sectors, the largest allowable LBA + 1, on the drive into the LBA_t variable pointed by buff. This command is used by f_mkfs and f_fdisk function to determine the size of volume/partition to be created. It is required when FF_USE_MKFS == 1.
GET_SECTOR_SIZERetrieves sector size, minimum data unit for generic read/write, into the WORD variable pointed by buff. Valid sector sizes are 512, 1024, 2048 and 4096. This command is required only if FF_MAX_SS > FF_MIN_SS. When FF_MAX_SS == FF_MIN_SS, this command will be never used and the read/write function must work in FF_MAX_SS bytes/sector.
GET_BLOCK_SIZERetrieves erase block size of the flash memory media in unit of sector into the DWORD variable pointed by buff. The allowable value is 1 to 32768 in power of 2. Return 1 if the value is unknown or non flash memory media. This command is used by only f_mkfs function and it attempts to align data area on the erase block boundary. It is required when FF_USE_MKFS == 1.
CTRL_TRIMInforms the device that the data on the block of sectors is no longer needed and it can be erased. The sector block is specified in an LBA_t array {<Start LBA>, <End LBA>} pointed by buff. This is an identical command to Trim of ATA device. Nothing to do for this command if this funcion is not supported or not a flash memory device. FatFs does not check the result code and the file function is not affected even if the sector block was not erased well. This command is called on remove a cluster chain and in the f_mkfs function. It is required when FF_USE_TRIM == 1.
CTRL_SYNCMakes sure that the device has finished pending write process. If the disk I/O layer or storage device has a write-back cache, the dirty cache data must be committed to the medium immediately. Nothing to do for this command if each write operation to the medium is completed in the disk_write function.
GET_SECTOR_COUNTRetrieves number of available sectors (the largest allowable LBA + 1) on the drive into the LBA_t variable that pointed by buff. This command is used by f_mkfs and f_fdisk function to determine the size of volume/partition to be created.
GET_SECTOR_SIZERetrieves sector size (minimum data unit for generic read/write) into the WORD variable that pointed by buff. Valid sector sizes are 512, 1024, 2048 and 4096. This command is required only if FF_MAX_SS > FF_MIN_SS. When FF_MAX_SS == FF_MIN_SS, this command will never be used and the disk_read and disk_write function must work in FF_MAX_SS bytes/sector.
GET_BLOCK_SIZERetrieves erase block size in unit of sector of the flash memory media into the DWORD variable that pointed by buff. The allowable value is 1 to 32768 in power of 2. Return 1 if it is unknown or in non flash memory media. This command is used by f_mkfs function with block size not specified and it attempts to align the data area on the suggested block boundary. Note that FatFs does not have FTL (flash translation layer), so that either disk I/O layter or storage device must have an FTL in it.
CTRL_TRIMInforms the disk I/O layter or the storage device that the data on the block of sectors is no longer needed and it can be erased. The sector block is specified in an LBA_t array {<Start LBA>, <End LBA>} that pointed by buff. This is an identical command to Trim of ATA device. Nothing to do for this command if this funcion is not supported or not a flash memory device. FatFs does not check the result code and the file function is not affected even if the sector block was not erased well. This command is called on remove a cluster chain and in the f_mkfs function. It is required when FF_USE_TRIM == 1.

FatFs will never use any device dependent command nor user defined command. Following table shows an example of non-standard commands which may be useful for some applications.

@@ -73,9 +71,9 @@

Description

CTRL_POWER_OFFPuts the device off state. Shut-down the power to the device and deinitialize the device interface if needed. STA_NOINIT in the current status flags must be set. The device goes active state by disk_initialize function. CTRL_LOCKLocks media eject mechanism. CTRL_UNLOCKUnlocks media eject mechanism. -CTRL_EJECTEjects media cartridge. STA_NOINIT and STA_NODISK in status flag are set after the function succeeded. +CTRL_EJECTEjects media cartridge. STA_NOINIT and STA_NODISK in status flag are set after the function succeeds. CTRL_GET_SMARTReads SMART information. -MMC_GET_TYPEGets card type. The type flags, bit0:MMCv3, bit1:SDv1, bit2:SDv2+ and bit3:LBA, is stored to a BYTE variable pointed by buff. (MMC/SDC specific command) +MMC_GET_TYPEGets card type. The type flags, bit0:MMCv3, bit1:SDv1, bit2:SDv2+ and bit3:LBA, is stored to a BYTE variable pointed by buff. (MMC/SDC specific command) MMC_GET_CSDReads CSD register and sets it into a 16-byte buffer pointed by buff. (MMC/SDC specific command) MMC_GET_CIDReads CID register and sets it into a 16-byte buffer pointed by buff. (MMC/SDC specific command) MMC_GET_OCRReads OCR register and sets it into a 4-byte buffer pointed by buff. (MMC/SDC specific command) diff --git a/vendor/fatfs/documents/doc/dread.html b/vendor/fatfs/documents/doc/dread.html index 46d2860..c87c9db 100644 --- a/vendor/fatfs/documents/doc/dread.html +++ b/vendor/fatfs/documents/doc/dread.html @@ -3,8 +3,6 @@ - - FatFs - disk_read @@ -13,7 +11,7 @@

disk_read

-

The disk_read function is called to read data from the sector(s) of storage device.

+

The disk_read function is called to read data from the storage device.

 DRESULT disk_read (
   BYTE pdrv,     /* [IN] Physical drive number */
@@ -56,14 +54,14 @@ 
Return Value

 
 

 
Description

-
Read/write operation to the generic storage devices, such as memory card, hadddisk and optical disk, is done in unit of block of data bytes called sector. FatFs supports the sector size in range of 512 to 4096 bytes. When FatFs is configured for fixed sector size (FF_MIN_SS == FF_MAX_SS, this is the most case), the generic read/write function must work at the sector size only. When FatFs is configured for variable sector size (FF_MIN_SS < FF_MAX_SS), the sector size of medium is inquired with disk_ioctl function after disk_initialize function succeeded.

+
Read/write operation to the generic storage devices, such as memory card, hadddisk and optical disk, is done in unit of block of data bytes called sector. FatFs supports the sector size in range of 512 to 4096 bytes. When FatFs is configured for fixed sector size (FF_MIN_SS == FF_MAX_SS, this is the most case), the generic read/write function must work at this sector size only. When FatFs is configured for variable sector size (FF_MIN_SS < FF_MAX_SS), the sector size of medium is inquired with disk_ioctl function after disk_initialize function succeeds.

 
There are some considerations about the memory addres passed via buff. It is not that always aligned with the word boundary, because the argument is defined as BYTE*. The unaligned transfer request can occure at direct transfer. If the bus architecture, especially DMA controller, does not allow unaligned memory access, it should be solved in this function. If it is the case, there are some workarounds described below to avoid this issue.

 
    
 
  • Convert word transfer to byte transfer with some trick in this function. - Recommended.
    • 
 
  • On the f_read() calls, avoid long read request that includes a whole of sector. - Any direct transfer never occures.
    • 
-
  • On the f_read(fp, dat, btw, bw) calls, make sure that (((UINT)dat & 3) == (f_tell(fp) & 3)) is true. - Word alignment of buff is guaranteed.
    • 
+
  • On the f_read(fp, data, btw, bw) calls, make sure that (((UINT)data & 3) == (f_tell(fp) & 3)) is true. - Word alignment of buff is guaranteed.
    • 
 

-
Also the memory area may be out of reach in DMA. This is the case if it is located on the tightly coupled memory which is usually used for stack. Use double buffered transfer, or avoid to define file I/O buffer, FATFS and FIL structure as local variables where on the stack.

+
Also the memory area may be out of reach in DMA. This is the case if it is located on the tightly coupled memory which is usually used for stack. Use double buffered transfer, or avoid to define file I/O buffer, FATFS and FIL structure as local variables where on the stack.

 
Generally, a multiple sector read request must not be split into single sector transactions to the storage device, or read throughput gets worse.

 

 
diff --git a/vendor/fatfs/documents/doc/dstat.html b/vendor/fatfs/documents/doc/dstat.html
index a891489..404ca24 100644
--- a/vendor/fatfs/documents/doc/dstat.html
+++ b/vendor/fatfs/documents/doc/dstat.html
@@ -3,8 +3,6 @@
 
 
 
-
-
 
 FatFs - disk_status
 
@@ -43,6 +41,7 @@ 
Return Values
+

Return

diff --git a/vendor/fatfs/documents/doc/dwrite.html b/vendor/fatfs/documents/doc/dwrite.html index 1007284..eaf314d 100644 --- a/vendor/fatfs/documents/doc/dwrite.html +++ b/vendor/fatfs/documents/doc/dwrite.html @@ -3,8 +3,6 @@ - - FatFs - disk_write @@ -13,7 +11,7 @@

disk_write

-

The disk_write function is called to write data to the sector(s) of storage device.

+

The disk_write function is called to write data to the storage device.

 DRESULT disk_write (
   BYTE pdrv,        /* [IN] Physical drive number */
@@ -60,7 +58,7 @@ 
Return Values

 
Description

 
The specified memory address is not that always aligned to word boundary because the argument is defined as BYTE*. For more information, refer to the description of disk_read function.

 
Generally, a multiple sector write request (count > 1) must not be split into single sector transactions to the storage device, or the file write throughput will be drastically decreased.

-
FatFs expects delayed write function of the disk control layer. The write operation to the media does not need to be completed when return from this function by what write operation is in progress or data is only stored into the write-back cache. But write data on the buff is invalid after return from this function. The write completion request is done by CTRL_SYNC command of disk_ioctl function. Therefore, if a delayed write function is implemented, the write throughput of the filesystem will be improved.

+
FatFs expects the disk control layer may have a delayed write feature. The write operation to the media does not need to be completed when return from this function by what media write operation is in progress or data is stored into the write-back cache. The write data on the buff is invalid after return from this function. The write completion request is done by CTRL_SYNC command of disk_ioctl function. Therefore, if a delayed write feature is implemented, the write throughput of the filesystem will be improved.

 
Remarks: Application program MUST NOT call this function, or FAT structure on the volume can be collapsed.
diff --git a/vendor/fatfs/documents/doc/eof.html b/vendor/fatfs/documents/doc/eof.html index efacfbf..549ae4e 100644 --- a/vendor/fatfs/documents/doc/eof.html +++ b/vendor/fatfs/documents/doc/eof.html @@ -3,8 +3,6 @@ - - FatFs - f_eof @@ -57,6 +55,7 @@

See Also

f_open, f_lseek, FIL

+

Return

diff --git a/vendor/fatfs/documents/doc/error.html b/vendor/fatfs/documents/doc/error.html index bee9685..b122dc2 100644 --- a/vendor/fatfs/documents/doc/error.html +++ b/vendor/fatfs/documents/doc/error.html @@ -3,8 +3,6 @@ - - FatFs - f_error @@ -57,6 +55,7 @@

See Also

f_open, FIL

+

Return

diff --git a/vendor/fatfs/documents/doc/expand.html b/vendor/fatfs/documents/doc/expand.html index 7620ba9..86a0824 100644 --- a/vendor/fatfs/documents/doc/expand.html +++ b/vendor/fatfs/documents/doc/expand.html @@ -3,8 +3,6 @@ - - FatFs - f_expand @@ -28,7 +26,7 @@

f_expand

Parameters

fp
-
Pointer to the open file object.
+
Pointer to the open file object. If a null pointer is given, the function fails with FR_INVALID_OBJECT.
fsz
Number of bytes in size to prepare or allocate for the file. The data type FSIZE_t is an alias of either DWORD(32-bit) or QWORD(64-bit) depends on the configuration option FF_FS_EXFAT.
opt
@@ -61,7 +59,7 @@

Description

When opt is 0, the function finds a contiguous data area and set it as suggested point for next allocation. The subsequent cluster allocation begins at top of the contiguous area found by this function. Thus the file allocation is guaranteed be contiguous and without allocation delay until the file size reaches this size unless any other changes to the volume is performed.

The contiguous file has an advantage for time-critical read/write operations. It eliminates some overheads in the filesystem and the storage device caused by random access for fragmented file.

-

Also the contiguous file can be easily accessed directly via low-level disk functions. However, this is not recommended in consideration of portability and future compatibility. If the file has not been confirmed be contiguous, use this function to examine if the file is contiguous or not.

+

The contiguou files can easily be accessed via low-level disk functions. However, this is not recommended in consideration of portability and future compatibility. If the file has not been confirmed be contiguous, use this function to examine if the file is contiguous or not.

@@ -76,16 +74,16 @@

Example

/* Creating a contiguous file */ /* Create a new file */ - res = f_open(fp = malloc(sizeof (FIL)), "file.dat", FA_WRITE|FA_CREATE_ALWAYS); + res = f_open(fp = malloc(sizeof (FIL)), "file.dat", FA_WRITE|FA_CREATE_ALWAYS); if (res) { /* Check if the file has been opened */ free(fp); die("Failed to open the file."); } - /* Alloacte a 100 MiB of contiguous area to the file */ + /* Allocate a 100 MiB of contiguous area to the file */ res = f_expand(fp, 104857600, 1); if (res) { /* Check if the file has been expanded */ - f_close(fp); + f_close(fp); free(fp); die("Failed to allocate contiguous area."); } @@ -101,7 +99,7 @@

Example

lba = fp->obj.fs->database + fp->obj.fs->csize * (fp->obj.sclust - 2); /* Write 2048 sectors from top of the file at a time */ - res = disk_write(drv, buffer, lba, 2048); + res = disk_write(drv, data, lba, 2048);
@@ -112,6 +110,7 @@

See Also

f_open, f_lseek, FIL

+

Return

diff --git a/vendor/fatfs/documents/doc/fattime.html b/vendor/fatfs/documents/doc/fattime.html index 002733a..227c06e 100644 --- a/vendor/fatfs/documents/doc/fattime.html +++ b/vendor/fatfs/documents/doc/fattime.html @@ -3,8 +3,6 @@ - - FatFs - get_fattime diff --git a/vendor/fatfs/documents/doc/fdisk.html b/vendor/fatfs/documents/doc/fdisk.html index d8c40bd..1f0fd49 100644 --- a/vendor/fatfs/documents/doc/fdisk.html +++ b/vendor/fatfs/documents/doc/fdisk.html @@ -3,8 +3,6 @@ - - FatFs - f_fdisk @@ -49,7 +47,7 @@

Return Values

Description

-

The f_fdisk function creates partitions on the physical drive. The partitioning format can be in generic MBR or GPT. The partition map table specifies how to divide the physical drive. The first item specifies the size of the first partition and the partitions are located on the drive in order of from the first item. When the value of item is less than or equal to 100, it specifies the partition size in percentage of the entire drive space. When it is larger than 100, it specifies number of sectors. The partition map table is terminated by a zero, no space is remaining for next allocation or 4th partition is created in MBR format. If the specified size is larger than remaining space on the drive, the partition is truncated at end of the drive.

+

The f_fdisk function creates partitions on the physical drive. The partitioning format can be in generic MBR or GPT. The partition map table specifies how to divide the physical drive. The first item specifies the size of the first partition and the partitions are located on the drive in order of from the first item. When the value of item is less than or equal to 100, it specifies the partition size in percentage of the entire drive space. When it is larger than 100, it specifies number of sectors. The partition map table is terminated by a zero, 4th partition in MBR format or no remainin space for next allocation. If the specified size is larger than remaining space on the drive, the partition is truncated at end of the drive.

By default, partitions are created in MBR format. It can create upto four primary partitions on a drive. GPT format is used to create the partitions when 64-bit LBA is enabled (FF_LBA64 = 1) and the drive size is equal to or larger than FF_MIN_GPT sectors. It can create over ten partitions on a drive.

@@ -64,23 +62,23 @@

Example

/* Volume mapping table defined by user (required when FF_MULTI_PARTITION == 1) */ PARTITION VolToPart[FF_VOLUMES] = { - {0, 1}, /* "0:" ==> 1st partition in PD#0 */ - {0, 2}, /* "1:" ==> 2nd partition in PD#0 */ - {1, 0} /* "2:" ==> PD#1 as removable drive */ + {0, 1}, /* "0:" ==> 1st partition in physical drive 0 */ + {0, 2}, /* "1:" ==> 2nd partition in physical drive 0 */ + {1, 0} /* "2:" ==> Physical drive 1 as removable drive */ }; 
     /* Initialize a brand-new disk drive mapped to physical drive 0 */
 
     BYTE work[FF_MAX_SS];         /* Working buffer */
-    LBA_t plist[] = {50, 50, 0};  /* Divide the drive into two partitions */
-                 /* {0x10000000, 100}; 256M sectors for 1st partition and left all for 2nd partition */
+    LBA_t plist[] = {50, 50, 0};  /* Divide the drive by 2 */
+                 /* {0x10000000, 100}; 256M sectors for the 1st partition and the remaining for the 2nd partition */
                  /* {20, 20, 20, 0}; 20% for 3 partitions each and remaing space is left not allocated */
 
-    f_fdisk(0, plist, work);                    /* Divide physical drive 0 */
+    f_fdisk(0, plist, work);            /* Divide the physical drive 0 */
 
-    f_mkfs("0:", 0, work, sizeof work); /* Create FAT volume on the logical drive 0 */
-    f_mkfs("1:", 0, work, sizeof work); /* Create FAT volume on the logical drive 1 */
+    f_mkfs("0:", 0, work, sizeof work); /* Create FAT volume on the logical drive 0 */
+    f_mkfs("1:", 0, work, sizeof work); /* Create FAT volume on the logical drive 1 */
@@ -90,6 +88,7 @@

See Also

Volume management, f_mkfs

+

Return

diff --git a/vendor/fatfs/documents/doc/filename.html b/vendor/fatfs/documents/doc/filename.html index 5e4f48a..bf28457 100644 --- a/vendor/fatfs/documents/doc/filename.html +++ b/vendor/fatfs/documents/doc/filename.html @@ -3,8 +3,6 @@ - - FatFs - Path Names @@ -36,15 +34,15 @@

Format of the Path Names

/..Invalid nameThe root directory (sticks the top level)

Also the drive prefix can be in pre-defined arbitrary string. When the option FF_STR_VOLUME_ID == 1, also arbitrary string volume ID can be used as drive prefix. e.g. "flash:file1.txt", "ram:temp.dat" or "sd:". If the srting does not match any volume ID, the function fails with FR_INVALID_DRIVE.

-

When FF_STR_VOLUME_ID == 2, Unix style drive prefix can be used. e.g. "/flash/file1.txt", "/ram/temp.dat" or "/sd". If a heading separator is exist, it is treated as start of drive prefix and in absolute path. Any form as "root directory in current drive" and "current directory in specified drive" cannot be used. Double dot name cannot traverse the drives such as "/flash/../ram/foo.dat".

+

When FF_STR_VOLUME_ID == 2, Unix style drive prefix can be used. e.g. "/flash/file1.txt", "/ram/temp.dat" or "/sd". If a heading separator is exist, it is treated as an absolute path with a heading node ID. Any form as "root directory in current drive" and "current directory in specified drive" cannot be used. Double dot name cannot traverse the volumes such as "/flash/../ram/foo.dat".

Remark: In this revision, double dot name ".." cannot follow the parent directory on the exFAT volume. It will work as "." and stay there.

Legal Characters and Case Sensitivity

In the generic FAT filesystems, the legal characters for object name (file/directory name) are, 0-9 A-Z ! # $ % & ' ( ) - @ ^ _ ` { } ~ in ASCII and extended characters \x80 to \xFF. In the FAT filesystems with LFN extention, also + , ; = [ ], white space and extended characters U+000080 to U+10FFFF are legal for the object name. White spaces and dots can be placed anywhere in the path name except end of the name. Trailing white spaces and dots are ignored.

-

FAT filesystem is case-insensitive to the object names on the volume. Object name on the FAT volume is compared in case-insensitive. For instance, these three names, file.txt, File.Txt and FILE.TXT, are identical on the FAT filesystem. This is applied to extended charactres as well. When an object is created on the FAT volume, up converted name is recorded to the SFN entry, and the raw name is recorded to the LFN entry when LFN extension is exist.

-

As for the MS-DOS and PC DOS for CJK (DOS/DBCS), extended characters ware recorded to the SFN entry without up-case conversion and compared in case-sensitive. This causes a problem on compatibility with Windows system when the object with extended characters is created on the volume by DOS/DBCS system; therfore the object names with DBCS extended characters should not be used on the FAT volume shared by those systems. FatFs works with case-sensitive to the extended characters in only non-LFN with DBCS configuration (DOS/DBCS specs). But in LFN configuration, FatFs works with case-insensitive to the extended character (WindowsNT specs).

+

FAT filesystem is case-insensitive to the object names on the volume. Object names on the FAT volume are compared in case-insensitive. For instance, these three names, file.txt, File.Txt and FILE.TXT, are identical on the FAT filesystem. This is applied to extended charactres as well. When an object is created on the FAT volume, up converted name is recorded to the SFN entry, and the original name is recorded to the LFN entry if LFN extension is enabled.

+

On the MS-DOS and PC DOS for Chinese, Japanese and Korean (DOS/DBCS), extended characters are recorded to the SFN entry without up-case conversion and compared in case-sensitive. This causes a problem on compatibility with Windows system when the object with extended characters is created on the volume by DOS/DBCS system; therfore the object names with DBCS extended characters should not be used on the FAT volume shared by those systems. FatFs works with case-sensitive to the extended characters in only non-LFN with DBCS configuration (DOS/DBCS specs). However, FatFs works with case-insensitive to the extended character (WindowsNT specs) in LFN configuration.

@@ -61,7 +59,7 @@

Unicode API

Volume Management

-

By default, each logical drive is associated with the physical drive in same drive number. An FAT volume on the physical drive is serched in the volume mount process. It reads boot sectors and checks it if it is an FAT boot sector in order of LBA 0 as SFD format, 1st partition, 2nd partition, 3rd partition, ..., as MBR or GPT format.

+

By default, each logical drive is associated with the physical drive in same drive number. An FAT volume on the physical drive is serched in the volume mount process. It reads boot sectors and checks it if it is an FAT VBR in order of LBA 0 as SFD format, 1st partition, 2nd partition, 3rd partition, ..., as MBR or GPT format.

When multiple partition feature is enabled, FF_MULTI_PARTITION = 1, each individual logical drive is associated with arbitrary partition or physical drive specified by volume management table, VolToPart[]. The table needs to be defined by user to resolve mappings of the logical drive numbers and the associated partitions or drives. Following code is an example of the volume management table.

 Example: "0:", "1:" and "2:" are associated with three partitions on the physical drive 0 (a non-removable drive)
@@ -73,8 +71,10 @@ 
Volume Management

     {0, 3},     /* "2:" ==> 3rd partition on the pd#0 */
     {1, 0}      /* "3:" ==> pd#1 as removable drive (auto-search) */
 };
+
+
+relationship between logical drive and physical drive
-
relationship between logical drive and physical drive

There are some considerations when enable the multi-partition configuration.

  • The physical drive that hosts two or more mounted partitions should be non-removable, or all volumes on the drive must be unmounted when remove the medium.
    • @@ -82,11 +82,12 @@

    Volume Management

  • On the MBR format drive, up to four primary partitions (1-4) can be specified. The partition number 1 specifies the first item in the partition table and the partition number 2 specifies the second one, and so on. The logical patitions (5-) in the extended partition is not supported.
  • On the GPT format drive, the partition number 1 specifies the first Microsoft BDP found in the partition table and the partition number 2 specifies the second one found, and so on.
  • Windows 10 earlier than 1703 does not support multiple volumes on the physical drive with removable class. Only the first parition found on the drive will be mounted. Windows OS does not support SFD format on the physical drive with non-removable class.
    • -
  • Some systems manage the on-board storage in non-standard partition format and each partition is mapped as physical drive in disk_* functions. For such system, FF_MULTI_PARTITION should be always 0.
    • -
  • For further information about the volume management, refer to the description in f_fdisk and f_mkfs.
    • +
  • Some systems manage the on-board storage in non-standard partition format and each partition is mapped as physical drive in disk_* functions. For such system, FF_MULTI_PARTITION should be always 0 and use FM_SFD flag in f_mkfs.
    • +
  • For further information about the volume management, refer to the description in f_mkfs and f_fdisk.
+

Return

diff --git a/vendor/fatfs/documents/doc/findfirst.html b/vendor/fatfs/documents/doc/findfirst.html index 0cd1704..79d04fa 100644 --- a/vendor/fatfs/documents/doc/findfirst.html +++ b/vendor/fatfs/documents/doc/findfirst.html @@ -3,8 +3,6 @@ - - FatFs - f_findfirst @@ -28,7 +26,7 @@

f_findfirst

Parameters

dp
-
Pointer to the blank directory object.
+
Pointer to the blank directory object. If a null pointer is given, the function fails with FR_INVALID_OBJECT.
fno
Pointer to the file information structure to store the information about the found item.
path
@@ -62,18 +60,18 @@

Return Values

Description

After the directory specified by path could be opened, it starts to search the directory for items with the matching pattern specified by pattern. If the first item is found, the information about the item is stored into the file information structure fno. If not found, fno->fname[] has a null string.

-

The matching pattern string can contain wildcard terms. For example:

+

The matching pattern string can contain wildcards. For example:

  • ? - An any character.
  • ??? - An any string in length of three characters.
  • * - An any string in length of zero or longer.
  • ????* - An any string in length of four characters or longer.
-

Since the matching algorithm uses recursion, number of wildcard terms in the matching pattern is limited to four to limit the stack usage. Any pattern with too many wildcard terms does not match any name. In LFN configuration, only fname[] is tested when FF_USE_FIND == 1 and also altname[] is tested when FF_USE_FIND == 2. There are some differences listed below between FatFs and standard systems in matching condition.

+

Since the matching algorithm uses recursion, number of wildcards in the matching pattern is limited to four to limit the stack usage. The pattern with too many wildcards does not match any name. In LFN configuration, only fname[] is tested when FF_USE_FIND == 1 and also altname[] is tested when FF_USE_FIND == 2. There are some differences listed below between FatFs and standard systems in matching condition.

    -
  • "*.*" never matches any name without extension while it matches any name with or without extension in standard systems.
    • -
  • Any pattern terminated with a dot never matches any name while it matches the name without extensiton in standard systems.
    • -
  • DBCS extended characters are compared in case-sensitive when LFN is enabled with ANSI/OEM code API.
    • +
  • "*.*" does not match any name without extension while it matches any name with or without extension in standard systems.
    • +
  • The pattern terminated with a dot does not match any name while it matches the name without extensiton in standard systems.
    • +
  • DBCS extended characters are compared in case-sensitive when LFN is enabled with !FF_LFN_UNICODE.
@@ -99,10 +97,10 @@

Examples

while (fr == FR_OK && fno.fname[0]) { /* Repeat while an item is found */ printf("%s\n", fno.fname); /* Print the object name */ - fr = f_findnext(&dj, &fno); /* Search for next item */ + fr = f_findnext(&dj, &fno); /* Search for next item */ } - f_closedir(&dj); + f_closedir(&dj); }
diff --git a/vendor/fatfs/documents/doc/findnext.html b/vendor/fatfs/documents/doc/findnext.html index f39f0fb..1800f61 100644 --- a/vendor/fatfs/documents/doc/findnext.html +++ b/vendor/fatfs/documents/doc/findnext.html @@ -3,8 +3,6 @@ - - FatFs - f_findnext @@ -64,6 +62,7 @@

See Also

f_findfirst, f_closedir, DIR, FILINFO

+

Return

diff --git a/vendor/fatfs/documents/doc/forward.html b/vendor/fatfs/documents/doc/forward.html index 97a793d..056a48e 100644 --- a/vendor/fatfs/documents/doc/forward.html +++ b/vendor/fatfs/documents/doc/forward.html @@ -3,8 +3,6 @@ - - FatFs - f_forward @@ -28,13 +26,13 @@

f_forward

Parameters

fp
-
Pointer to the open file object.
+
Pointer to the open file object. If a null pointer is given, the function fails with FR_INVALID_OBJECT.
func
Pointer to the user-defined data streaming function. For details, refer to the sample code.
btf
Number of bytes to forward in range of UINT.
bf
-
Pointer to the UINT variable to return number of bytes forwarded.
+
Pointer to the variable in UINT type to return number of bytes forwarded.
@@ -54,7 +52,7 @@

Return Values

Description

-

The f_forward function reads the data from the file and forward it to the outgoing stream without data buffer. This is suitable for small memory system because it does not require any data buffer at application module. The file pointer of the file object increases in number of bytes forwarded. In case of *bf is less than btf without error, it means the requested bytes could not be transferred due to end of file or stream goes busy during data transfer.

+

The f_forward function reads the data from the file and forward it to the outgoing stream. This function is suitable for small memory system, because it does not require any data buffer in the application module. The file pointer of the file object advances in number of bytes forwarded. In case of *bf is less than btf without error, it means the requested size of data could not be transferred due to end of file or stream goes busy during data transfer.

@@ -109,11 +107,11 @@

Example

UINT dmy; /* Open the audio file in read only mode */ - rc = f_open(&fil, fn, FA_READ); + rc = f_open(&fil, fn, FA_READ); if (rc) return rc; /* Repeat until the file pointer reaches end of the file */ - while (rc == FR_OK && !f_eof(&fil)) { + while (rc == FR_OK && !f_eof(&fil)) { /* some processes... */ @@ -122,7 +120,7 @@

Example

} /* Close the file and return */ - f_close(&fil); + f_close(&fil); return rc; } @@ -134,6 +132,7 @@

See Also

f_open, fgets, f_write, f_close, FIL

+

Return

diff --git a/vendor/fatfs/documents/doc/getcwd.html b/vendor/fatfs/documents/doc/getcwd.html index 6eb9a58..22a31e1 100644 --- a/vendor/fatfs/documents/doc/getcwd.html +++ b/vendor/fatfs/documents/doc/getcwd.html @@ -3,8 +3,6 @@ - - FatFs - f_getcwd @@ -78,6 +76,7 @@

See Also

f_chdrive, f_chdir

+

Return

diff --git a/vendor/fatfs/documents/doc/getfree.html b/vendor/fatfs/documents/doc/getfree.html index 5e4f419..ac378a7 100644 --- a/vendor/fatfs/documents/doc/getfree.html +++ b/vendor/fatfs/documents/doc/getfree.html @@ -3,8 +3,6 @@ - - FatFs - f_getfree diff --git a/vendor/fatfs/documents/doc/getlabel.html b/vendor/fatfs/documents/doc/getlabel.html index 0ec6d0d..d7d3362 100644 --- a/vendor/fatfs/documents/doc/getlabel.html +++ b/vendor/fatfs/documents/doc/getlabel.html @@ -3,8 +3,6 @@ - - FatFs - f_getlabel @@ -27,7 +25,7 @@

f_getlabel

Parameters

path
-
Pointer to the null-terminated string that specifies the logical drive. Null-string specifies the default drive.
+
Pointer to the null-terminated string that specifies the logical drive. Null-string specifies the default drive. If a null pointer is given, the function fails with FR_INVALID_DRIVE.
label
Pointer to the buffer to store the volume label. If the volume has no label, a null-string will be returned. Set null pointer if this information is not needed. The buffer size should be shown below at least to avoid buffer overflow.
diff --git a/vendor/fatfs/documents/doc/gets.html b/vendor/fatfs/documents/doc/gets.html index 89d9560..f4a22ca 100644 --- a/vendor/fatfs/documents/doc/gets.html +++ b/vendor/fatfs/documents/doc/gets.html @@ -3,8 +3,6 @@ - -FatFs - f_gets @@ -45,13 +43,13 @@

Return Values

Description

The read operation continues until a '\n' is stored, reached end of the file or the buffer is filled with len - 1 characters. The read string is terminated with a '\0'. When no character to read or any error occured during read operation, it returns a null pointer. The status of EOF and error can be examined with f_eof and f_error function.

-

When FatFs is configured to Unicode API (FF_LFN_UNICODE >= 1), data types on the srting fuctions, f_putc, f_puts, f_printf and f_gets, is also switched to Unicode. The character encoding on the file to be read via this function is assumed as FF_STRF_ENCODE. If the character encoding on the file differs from that on the API, it is converted in this function. In this case, input characters with wrong encoding will be lost.

+

When FatFs is configured to Unicode API (FF_LFN_UNICODE >= 1), data types on the srting fuctions, f_putc, f_puts, f_printf and f_gets, is also switched to Unicode. The character encoding on the file to be read via this function is assumed as FF_STRF_ENCODE. If the character encoding differs between file data and API, it is converted in this function. Input characters with wrong encoding for output will be lost.

QuickInfo

-

This is a wrapper function of f_read function. Available when FF_USE_STRFUNC >= 1. When it is set to 2, '\r's contained in the file are stripped out.

+

This is a wrapper function of f_read function. Available when FF_USE_STRFUNC >= 1. When it is set to 2, '\r's contained in the read data are stripped off.

@@ -60,6 +58,7 @@

See Also

f_open, f_read, f_putc, f_puts, f_printf, f_close, FIL

+

Return

diff --git a/vendor/fatfs/documents/doc/lseek.html b/vendor/fatfs/documents/doc/lseek.html index ffd1f62..9740b8c 100644 --- a/vendor/fatfs/documents/doc/lseek.html +++ b/vendor/fatfs/documents/doc/lseek.html @@ -3,8 +3,6 @@ - -FatFs - f_lseek @@ -32,7 +30,7 @@

f_lseek

Parameters

fp
-
Pointer to the open file object.
+
Pointer to the open file object. If a null pointer is given, the function fails with FR_INVALID_OBJECT.
ofs
Byte offset from top of the file to set read/write pointer. The data type FSIZE_t is an alias of either DWORD(32-bit) or QWORD(64-bit) depends on the configuration option FF_FS_EXFAT.
@@ -53,17 +51,18 @@

Return Values

Description

-

File read/write ponter in the open file object points the data byte to be read/written at next read/write operation. It advances as the number of bytes read/written. The f_lseek function moves the file read/write pointer without any read/write operation to the file. The f_rewind function is impremented as a macro.

+

File read/write ponter in the open file object points the data byte to be read/written at next read/write operation. It advances as the number of bytes read/written. The f_lseek function moves the file read/write pointer without read/write operation to the file. The f_rewind function is impremented as a macro.

 #define f_rewind(fp) f_lseek((fp), 0)
-

If an offset beyond the file size is specified in write mode, the file size is expanded to the specified offset. The file data in the expanded part is undefined, because no data is written to the file in this process. This is suitable to pre-allocate a data area to the file quickly for fast write operation. When a contiguous data area needs to be allocated to the file, use f_expand function instead. After the f_lseek function succeeded, the current read/write pointer should be checked in order to make sure the read/write pointer has been moved correctry. In case of the read/write pointer is not pointing expected offset, either of followings has been occured.

+

When an offset beyond the file size is specified in write mode, the file size is expanded to the specified offset in this function. The file data in the expanded part is undefined, because no data is written to the file in this process. Be careful about these behaviours differ from POSIX fseek function. This is suitable to pre-allocate a data area to the file for subsequent fast write operation. If a contiguous data area needs to be allocated to the file, use f_expand function instead.

+

After the f_lseek function succeeded, the current read/write pointer should be checked in order to make sure the read/write pointer has been moved correctry. In case of the read/write pointer is not pointing expected offset, either of followings has been occured.

  • End of file. The specified ofs was clipped at end of the file in read-only mode.
  • Disk full. There is no free space on the volume to expand the file.
-

The fast seek feature enables fast backward/long seek operations without FAT access by using an on-memory CLMT (cluster link map table). It is applied to f_read and f_write function as well, however, the file size cannot be expanded by f_write, f_lseek function while the file is at fast seek mode.

-

The fast seek mode is available when FF_USE_FASTSEEK = 1. The CLMT must be created into the DWORD array prior to use the fast seek mode. To create the CLMT, set address of the DWORD array to the member cltbl in the open file object, set the size of array in unit of items to the cltbl[0] and then call f_lseek function with ofs = CREATE_LINKMAP. After the function succeeded, no FAT access is occured in subsequent f_read, f_write, f_lseek function to the file. The number of items used or required is returned into the cltbl[0]. The number of items needed is (number of the file fragments + 1) * 2. For example, 12 items in the array will be used for the file fragmented in 5 portions. If the function failed with FR_NOT_ENOUGH_CORE, the size of given array is insufficient for the file.

+

The fast seek feature enables fast backward/long seek operations without FAT access by using an on-memory CLMT (cluster link map table). It is applied to f_read and f_write function as well, however, the file size cannot be expanded by f_write, f_lseek function while the file is in fast seek mode.

+

The fast seek mode is available when FF_USE_FASTSEEK = 1. The CLMT must be created into a DWORD array prior to use the fast seek mode. To create the CLMT, set address of the DWORD array to the member cltbl in the open file object, set the size of array in unit of items to the cltbl[0] and then call f_lseek function with ofs = CREATE_LINKMAP. The number of items used or required is returned into the cltbl[0]. The number of items needed is (number of the file fragments + 1) * 2. For example, 12 items in the array will be used for the file fragmented in 5 portions. If the function failed with FR_NOT_ENOUGH_CORE, the size of given array is insufficient for the file. After the function succeeded, no FAT access is occured in subsequent f_read, f_write, f_lseek function to the file. To disable the fast seek mode, set null pointer to the cltbl.

@@ -78,7 +77,7 @@

Example

     /* Open file */
     fp = malloc(sizeof (FIL));
-    res = f_open(fp, "file.dat", FA_READ|FA_WRITE);
+    res = f_open(fp, "file.dat", FA_READ|FA_WRITE);
     if (res) ...
 
     /* Set read/write pointer to 5000 */
@@ -96,15 +95,15 @@ 
Example

 
 /* Cluster pre-allocation (to prevent buffer overrun on streaming write) */
 
-    res = f_open(fp, recfile, FA_CREATE_NEW | FA_WRITE);   /* Create a file */
+    res = f_open(fp, recfile, FA_CREATE_NEW | FA_WRITE);   /* Create a file */
 
     res = f_lseek(fp, PRE_SIZE);             /* Expand file size (cluster pre-allocation) */
-    if (res || f_tell(fp) != PRE_SIZE) ...   /* Check if the file has been expanded successfly */
+    if (res || f_tell(fp) != PRE_SIZE) ...   /* Check if the file has been expanded successfly */
 
     res = f_lseek(fp, OFS_DATA);             /* Record data stream with free from cluster allocation delay */
     ...                                      /* Write operation should be aligned to sector boundary to optimize the write throughput */
 
-    res = f_truncate(fp);                    /* Truncate unused area */
+    res = f_truncate(fp);                    /* Truncate unused area */
     res = f_lseek(fp, OFS_HEADER);           /* Set file header */
     ...
 
@@ -115,7 +114,7 @@ 
Example

 
     DWORD clmt[SZ_TBL];                    /* Cluster link map table buffer */
 
-    res = f_open(fp, fname, FA_READ | FA_WRITE);   /* Open a file */
+    res = f_open(fp, fname, FA_READ | FA_WRITE);   /* Open a file */
 
     res = f_lseek(fp, ofs1);               /* This is normal seek (cltbl is nulled on file open) */
 
@@ -134,6 +133,7 @@ 
See Also

 
f_open, f_truncate, f_expand, FIL

 
 
+
 
Return

 
 
diff --git a/vendor/fatfs/documents/doc/mkdir.html b/vendor/fatfs/documents/doc/mkdir.html
index de32f83..7027cd8 100644
--- a/vendor/fatfs/documents/doc/mkdir.html
+++ b/vendor/fatfs/documents/doc/mkdir.html
@@ -3,8 +3,6 @@
 
 
 
-
-
 
 FatFs - f_mkdir
 
@@ -75,6 +73,7 @@ 
Example

 

 
 
+
 
Return

 
 
diff --git a/vendor/fatfs/documents/doc/mkfs.html b/vendor/fatfs/documents/doc/mkfs.html
index 3f3bd70..411c863 100644
--- a/vendor/fatfs/documents/doc/mkfs.html
+++ b/vendor/fatfs/documents/doc/mkfs.html
@@ -3,8 +3,6 @@
 
 
 
-
-
 
 FatFs - f_mkfs
 
@@ -30,23 +28,23 @@ 
Parameters

 
path

 
Pointer to the null-terminated string specifies the logical drive to be formatted. If it does not have a drive number in it, it means to specify the default drive. The logical drive may or may not have been mounted for the format process.

 
opt

-
Specifies the format option structure MKFS_PARM holding format options. If a null pointer is given, it gives the function all options in default value. The structure has five members described below:

+
Specifies the format option structure MKFS_PARM holding format options. If a null pointer is given, it gives the function every option in default value. The structure has five members in order of described below:

 

 
BYTE fmt

-
Specifies combination of FAT type flags, FM_FAT, FM_FAT32, FM_EXFAT and bitwise-or of these three, FM_ANY. FM_EXFAT is ignored when exFAT is not enabled. These flags specify which FAT type to be created on the volume. If two or more types are specified, one out of them will be selected depends on the volume size and au_size. The flag FM_SFD specifies to create the volume on the drive in SFD format. The default value is FM_ANY.

-
DWORD au_size

-
Specifies size of the allocation unit (cluter) in unit of byte. The valid value is power of 2 between sector size and 128 * sector size inclusive for FAT/FAT32 volume, or up to 16 MB for exFAT volume. If a zero (default value) or any invalid value is given, the function uses default allocation unit size depends on the volume size.

-
UINT n_align

-
Specifies alignment of the volume data area (file allocation pool, usually erase block boundary of flash memory media) in unit of sector. The valid value for this member is between 1 and 32768 inclusive in power of 2. If a zero (the default value) or any invalid value is given, the function obtains the block size from lower layer with disk_ioctl function.

+
Specifies a combination of FAT type flags, FM_FAT, FM_FAT32, FM_EXFAT and bitwise-or of these three, FM_ANY. FM_EXFAT is ignored when exFAT is not enabled. These flags specify which type of FAT volume to be created. If two or more types are specified, one out of them will be selected depends on the volume size and au_size. The flag FM_SFD specifies to create the volume on the drive in SFD format. The default value is FM_ANY.

 
BYTE n_fat

 
Specifies number of FAT copies on the FAT/FAT32 volume. Valid value for this member is 1 or 2. The default value (0) and any invaid value gives 1. If the FAT type is exFAT, this member has no effect.

+
UINT align

+
Specifies alignment of the volume data area (file allocation pool, usually erase block boundary of flash memory media) in unit of sector. The valid value for this member is between 1 and 32768 inclusive in power of 2. If a zero (the default value) or an invalid value is given, the function obtains the block size from lower layer with disk_ioctl function.

 
UINT n_root

 
Specifies number of root directory entries on the FAT volume. Valid value for this member is up to 32768 and aligned to sector size / 32. The default value (0) and any invaid value gives 512. If the FAT type is FAT32 or exFAT, this member has no effect.

+
DWORD au_size

+
Specifies size of the cluster (allocation unit) in unit of byte. The valid value for this member is between sector size and 128 * sector size inclusive in power of 2 for FAT/FAT32 volume and up to 16 MB in power of 2 for exFAT volume. If a zero (default value) or an invalid value is given, the function uses a default cluster size depends on the volume size.

 

 
work

-
Pointer to the working buffer used for the format process. If a null pointer is given with FF_USE_LFN == 3, the function obtains a memory block for the working buffer in this function.

+
Pointer to the working buffer used for the format process. If a null pointer is given with FF_USE_LFN == 3, the function uses a len bytes of heap memory in this function.

 
len

-
Size of the working buffer in unit of byte. It needs to be FF_MAX_SS at least. Plenty of working buffer reduces number of write transactions to the drive and the format process will finish quickly.

+
Size of the working buffer in unit of byte. It needs to be FF_MAX_SS at least. Plenty of working buffer reduces number of write transactions to the drive, thus the format process will finish quickly.

 
 
 
@@ -69,9 +67,9 @@ 
Description

 
The FAT sub-type, FAT12/FAT16/FAT32, of FAT volume except exFAT is determined by only number of clusters on the volume and nothing else, according to the FAT specification issued by Microsoft. Thus the FAT sub-type of created volume depends on the volume size and the cluster size. In case of the combination of FAT type and cluter size specified by argument is not valid for the volume size, the function will fail with FR_MKFS_ABORTED.

 
The allocation unit, also known as cluster, is a unit of disk space allocation for files. When the size of allocation unit is 32768 bytes, a file with 100 bytes in size occupies 32768 bytes of disk space. The space efficiency of disk usage gets worse as increasing size of allocation unit, but, on the other hand, the read/write performance increases. Therefore the size of allocation unit is a trade-off between space efficiency and performance. For the large volumes in GB order, 32768 bytes or larger, automatically selected by default, is recommended for most case unless extremely many small files are created in the volume.

 
When the logical drive to be formatted is associated with a physical drive (FF_MULTI_PARTITION == 0 or VolToPart[].pt == 0) and FM_SFD flag is not specified, a partition occupies entire drive space is created and then the FAT volume is created in the partition. When FM_SFD flag is specified, the FAT volume is created without any disk partitioning.

-
When the logical drive to be formatted is associated with a specific partition by multiple partition feature (FF_MULTI_PARTITION == 1 and VolToPart[].pt > 0), the FAT volume is created in the partition of the physical drive specified by volume mapping table and FM_SFD flag is ignored. The hosting physical drive needs to be partitioned with f_fdisk function or any partitioning tool prior to create the FAT volume with this function. If the partition is not exist, the function aborts with FR_MKFS_ABORTED.

-
There are three standard disk partitioning formats, MBR, GPT and SFD. The MBR format, also known as FDISK format, is usually used for harddisk, memory card and U disk. It can divide a physical drive into one or more partitions with a partition table. The GPT, GUID Partition Table, is a newly defined patitioning format for large storage devices. FatFs suppors the GPT only when 64-bit LBA is enabled. The SFD, Super-Floppy Disk, is non-partitioned disk format. The FAT volume is located at LBA 0 and occupies the entire physical drive without any disk partitioning. It is usually used for floppy disk, optical disk and most super-floppy media. Some combination of systems and media support only either partitioned format or non-partitioned format and the other is not supported.

-
Some systems manage the partitions in the on-board storage in non-standard format. The partitions are mapped as physical drives identified by pdrv in disk_* functions. For such systems, SFD format is suitable to create the FAT volume in the partition.

+
When the logical drive to be formatted is associated with a specific partition by multiple partition feature (FF_MULTI_PARTITION == 1 and VolToPart[].pt > 0), the FAT volume is created in the partition of the physical drive specified by volume mapping table and FM_SFD flag is ignored. The hosting physical drive needs to be partitioned with f_fdisk function or some partitioning tool prior to create the FAT volume with this function. If the partition is not exist, the function fails with FR_MKFS_ABORTED.

+
There are three standard disk partitioning formats, MBR, GPT and SFD. The MBR format, also known as FDISK format, is usually used for harddisk, memory card and U disk. It can divide a physical drive into one or more partitions with a partition table. The GPT, GUID Partition Table, is a newly defined patitioning format for large storage devices. FatFs suppors the GPT only when 64-bit LBA is enabled. The SFD, Super-Floppy Disk, is non-partitioned disk format. The FAT volume is located at LBA 0 and occupies the entire physical drive without disk partitioning. It is usually used for floppy disk, optical disk and most super-floppy media. Some combination of systems and media support only either partitioned format or non-partitioned format and the other is not supported.

+
Some systems manage the partitions of on-board storage in non-standard format. The partitions are mapped as physical drives identified by pdrv in disk_* functions. For such systems, SFD format is suitable to create the FAT volume in the partition.

 
 
 

@@ -97,21 +95,21 @@ 
Example

     if (res) ...
 
     /* Give a work area to the default drive */
-    f_mount(&fs, "", 0);
+    f_mount(&fs, "", 0);
 
     /* Create a file as new */
-    res = f_open(&fil, "hello.txt", FA_CREATE_NEW | FA_WRITE);
+    res = f_open(&fil, "hello.txt", FA_CREATE_NEW | FA_WRITE);
     if (res) ...
 
     /* Write a message */
-    f_write(&fil, "Hello, World!\r\n", 15, &bw);
+    f_write(&fil, "Hello, World!\r\n", 15, &bw);
     if (bw != 15) ...
 
     /* Close the file */
-    f_close(&fil);
+    f_close(&fil);
 
     /* Unregister work area */
-    f_mount(0, "", 0);
+    f_mount(0, "", 0);
 
     ...
@@ -122,6 +120,7 @@

See Also

Example of volume size and format parameters, Volume management, f_fdisk

+

Return

diff --git a/vendor/fatfs/documents/doc/mount.html b/vendor/fatfs/documents/doc/mount.html index 57f40be..f0383b9 100644 --- a/vendor/fatfs/documents/doc/mount.html +++ b/vendor/fatfs/documents/doc/mount.html @@ -3,8 +3,6 @@ - -FatFs - f_mount @@ -92,19 +90,19 @@

Example

FATFS *fs; /* Ponter to the filesystem object */ - fs = malloc(sizeof (FATFS)); /* Get work area for the volume */ - f_mount(fs, "", 0); /* Mount the default drive */ + fs = malloc(sizeof (FATFS)); /* Get work area for the volume */ + f_mount(fs, "", 0); /* Mount the default drive */ - f_open(... /* Here any file API can be used */ + f_open(... /* Here any file API can be used */ ... - f_mount(fs, "", 0); /* Re-mount the default drive to reinitialize the filesystem */ + f_mount(fs, "", 0); /* Re-mount the default drive to reinitialize the filesystem */ ... - f_mount(0, "", 0); /* Unmount the default drive */ - free(fs); /* Here the work area can be discarded */ + f_unmount(""); /* Unmount the default drive */ + free(fs); /* Here the work area can be discarded */ ... } @@ -117,6 +115,7 @@

See Also

f_open, FATFS

+

Return

diff --git a/vendor/fatfs/documents/doc/open.html b/vendor/fatfs/documents/doc/open.html index dd2a6e6..b533249 100644 --- a/vendor/fatfs/documents/doc/open.html +++ b/vendor/fatfs/documents/doc/open.html @@ -3,8 +3,6 @@ - -FatFs - f_open @@ -27,19 +25,19 @@

f_open

Parameters

fp
-
Pointer to the blank file object structure.
+
Pointer to the blank file object structure. If a null pointer is given, the function fails with FR_INVALID_OBJECT.
path
-
Pointer to the null-terminated string that specifies the file name to open or create.
+
Pointer to the null-terminated string that specifies the file name to open or create. If a null pointer is given, the function fails with FR_INVALID_DRIVE.
mode
Mode flags that specifies the type of access and open method for the file. It is specified by a combination of following flags.
- - - - + + + +
FlagsMeaning
FA_READSpecifies read access to the file. Data can be read from the file.
FA_WRITESpecifies write access to the file. Data can be written to the file. Combine with FA_READ for read-write access.
FA_OPEN_EXISTINGOpens a file. The function fails if the file is not existing. (Default)
FA_CREATE_NEWCreates a new file. The function fails with FR_EXIST if the file is existing.
FA_CREATE_ALWAYSCreates a new file. If the file is existing, it will be truncated and overwritten.
FA_OPEN_ALWAYSOpens the file if it is existing. If not, a new file will be created.
FA_OPEN_EXISTINGOpens the file. The function fails if the file is not existing. (Default)
FA_CREATE_ALWAYSCreates a new file. If the file is existing, the file is truncated and overwritten.
FA_CREATE_NEWCreates a new file. The function fails if the file is existing.
FA_OPEN_ALWAYSOpens the file. If it is not exist, a new file is created.
FA_OPEN_APPENDSame as FA_OPEN_ALWAYS except the read/write pointer is set end of the file.
Mode flags in POSIX fopen() function corresponds to FatFs mode flags as follows:
@@ -86,7 +84,8 @@

Return Values

Description

-

The f_open function opens a file and creates a file object. The file object is used for subsequent read/write operations to the file to identify the file. Open file should be closed with f_close function after the session of the file access. If any change to the file is made and not closed prior to power down, media removal or re-mount, or the file can be collapsed.

+

The f_open function opens a file and creates a file object. It is the identifier for subsequent read/write operations to the file. After the function succeeded, the file object is valid. If the function failed, the file object is set invalid.

+

Open file should be closed with f_close function after the session of the file access. If any change to the file has been made and not closed prior to power off, media removal or re-mount, or the file can be collapsed.

If duplicated file open is needed, read here carefully. However duplicated open of a file with any write mode flag is always prohibited.

@@ -112,19 +111,19 @@

Example

/* Give a work area to the default drive */ - f_mount(&FatFs, "", 0); + f_mount(&FatFs, "", 0); /* Open a text file */ fr = f_open(&fil, "message.txt", FA_READ); if (fr) return (int)fr; /* Read every line and display it */ - while (f_gets(line, sizeof line, &fil)) { + while (f_gets(line, sizeof line, &fil)) { printf(line); } /* Close the file */ - f_close(&fil); + f_close(&fil); return 0; } @@ -142,8 +141,8 @@

Example

/* Give work areas to each logical drive */ - f_mount(&fs0, "0:", 0); - f_mount(&fs1, "1:", 0); + f_mount(&fs0, "0:", 0); + f_mount(&fs1, "1:", 0); /* Open source file on the drive 1 */ fr = f_open(&fsrc, "1:file.bin", FA_READ); @@ -155,19 +154,19 @@

Example

/* Copy source to destination */ for (;;) { - fr = f_read(&fsrc, buffer, sizeof buffer, &br); /* Read a chunk of data from the source file */ + fr = f_read(&fsrc, buffer, sizeof buffer, &br); /* Read a chunk of data from the source file */ if (br == 0) break; /* error or eof */ - fr = f_write(&fdst, buffer, br, &bw); /* Write it to the destination file */ + fr = f_write(&fdst, buffer, br, &bw); /* Write it to the destination file */ if (bw < br) break; /* error or disk full */ } /* Close open files */ - f_close(&fsrc); - f_close(&fdst); + f_close(&fsrc); + f_close(&fdst); /* Unregister work area prior to discard it */ - f_unmount("0:"); - f_unmount("1:"); + f_unmount("0:"); + f_unmount("1:"); return (int)fr; } @@ -180,6 +179,7 @@

See Also

f_read, f_write, f_close, FIL, FATFS

+

Return

diff --git a/vendor/fatfs/documents/doc/opendir.html b/vendor/fatfs/documents/doc/opendir.html index 215c37a..1955bc3 100644 --- a/vendor/fatfs/documents/doc/opendir.html +++ b/vendor/fatfs/documents/doc/opendir.html @@ -3,8 +3,6 @@ - - FatFs - f_opendir @@ -26,9 +24,9 @@

f_opendir

Parameters

dp
-
Pointer to the blank directory object to create a new one.
+
Pointer to the blank directory object to create a new one. If a null pointer is given, the function fails with FR_INVALID_OBJECT.
path
-
Pointer to the null-terminated string that specifies the directory name to be opened.
+
Pointer to the null-terminated string that specifies the directory name to be opened. If a null pointer is given, the function fails with FR_INVALID_DRIVE.
@@ -70,6 +68,7 @@

See Also

f_readdir, f_closedir, DIR

+

Return

diff --git a/vendor/fatfs/documents/doc/printf.html b/vendor/fatfs/documents/doc/printf.html index 557fb57..c1e1f29 100644 --- a/vendor/fatfs/documents/doc/printf.html +++ b/vendor/fatfs/documents/doc/printf.html @@ -1,114 +1,114 @@ - - - - - - - - -FatFs - f_printf - - - - -
-

f_printf

-

The f_printf function writes formatted string to the file.

-
-int f_printf (
-  FIL* fp,          /* [IN] File object */
-  const TCHAR* fmt, /* [IN] Format stirng */
-  ...
-);
-
-
- -
-

Parameters

-
-
fp
-
Pointer to the open file object structure.
-
fmt
-
Pointer to the null '\0' terminated format string. The terminator character will not be output.
-
...
-
Optional arguments...
- -
-
- - -
-

Return Values

-

When the string was written successfuly, it returns number of character encoding units written to the file. When the function failed due to disk full or an error, a negative value will be returned.

-
- - -
-

Description

-

The format control directive is a sub-set of standard library shown as follows:

-
-    %[flag][width][precision][size]type
-
-
-
flag
Padding options. A - specifies left-aligned. A 0 specifies zero padded. The default setting is in right-aligned and space padded.
-
width
Minimum width of the field, 1-99 or *. If the width of generated string is less than the specified value, rest field is padded with spaces or zeros. An * specifies the value comes from an argument in int type.
-
precision
Specifies number of fractional digits or maximum width of string, .0-.99 or .*. If number is omitted, it will be same as .0. Default setting is 6 for number and no limit for string.
-
size
Specifies size of integer argument, l(long) and ll(long long). If sizeof (long) == sizeof (int) is true (this is typical of 32-bit systems), prefix l can be omitted for long integer argument. The default size is int for integer arrument and floating point argument is always assumed double.
-
type
Specifies type of the output format and the argument as shown below. The length of generated string is in assumtion of int is 32-bit. - - - - - - - - - - - -
TypeFormatArgumentLength
cCharacterint,
long,
long long		1 character.
dSigned decimal1 to 11 (20 for ll) characters.
uUnsigned decimal1 to 10 (20 for ll) characters.
oUnsigned octal1 to 11 (22 for ll) characters.
x XUnsigned hexdecimal1 to 8 (16 for ll) characters.
bUnsigned binary1 to 32 characters. Limited to lower 32 digits when ll is specified.
sStringTCHAR*As input string. Null pointer generates a null string.
fFloating point
(decimal)		double1 to 31 characters. If the number of characters exceeds 31, it writes "±OV". Not a number and infinite write "NaN" and "±INF".
e EFloating point
(e notation)		4 to 31 characters. If the number of characters exceeds 31 or exponent exceeds +99, it writes "±OV".
-
-
-

When FatFs is configured for Unicode API (FF_LFN_UNICODE >= 1), character encoding on the string fuctions, f_putc, f_puts, f_printf and f_gets function, is also switched to Unicode. The Unicode characters in multiple encoding unit, such as surrogate pair and multi-byte sequence, should not be divided into two function calls, or the character will be lost. The character encoding on the file to be written via this function is selected by FF_STRF_ENCODE. The characters with wrong encoding or invalid for the output encoding will be lost.

-
- - -
-

QuickInfo

-

This is a wrapper function of f_write function. Available when FF_FS_READONLY == 0 and FF_USE_STRFUNC >= 1. When FF_USE_STRFUNC == 2, '\n's in the generated string are written as '\r'+'\n' each.

-
- - -
-

Example

-
-    f_printf(fp, "%d", 1234);             /* "1234" */
-    f_printf(fp, "%6d,%3d%%", -200, 5);   /* "  -200,  5%" */
-    f_printf(fp, "%-6u", 100);            /* "100   " */
-    f_printf(fp, "%ld", 12345678);        /* "12345678" */
-    f_printf(fp, "%llu", 0x100000000);    /* "4294967296"   (FF_PRINT_LLI) */
-    f_printf(fp, "%lld", -1LL);           /* "-1"           (FF_PRINT_LLI) */
-    f_printf(fp, "%04x", 0xA3);           /* "00a3" */
-    f_printf(fp, "%08lX", 0x123ABC);      /* "00123ABC" */
-    f_printf(fp, "%016b", 0x550F);        /* "0101010100001111" */
-    f_printf(fp, "%*d", 6, 100);          /* "   100" */
-    f_printf(fp, "%s", "abcdefg");        /* "abcdefg" */
-    f_printf(fp, "%5s", "abc");           /* "  abc" */
-    f_printf(fp, "%-5s", "abc");          /* "abc  " */
-    f_printf(fp, "%.5s", "abcdefg");      /* "abcde" */
-    f_printf(fp, "%-5.2s", "abcdefg");    /* "ab   " */
-    f_printf(fp, "%c", 'a');              /* "a" */
-    f_printf(fp, "%12f", 10.0);           /* "   10.000000" (FF_PRINT_FLOAT) */
-    f_printf(fp, "%.4E", 123.45678);      /* "1.2346E+02"   (FF_PRINT_FLOAT) */
-
-
- - -
-

See Also

-

f_open, f_putc, f_puts, f_gets, f_close, FIL

-
- -

Return

- - + + + + + + +FatFs - f_printf + + + + +
+

f_printf

+

The f_printf function writes formatted string to the file.

+
+int f_printf (
+  FIL* fp,          /* [IN] File object */
+  const TCHAR* fmt, /* [IN] Format stirng */
+  ...
+);
+
+
+ +
+

Parameters

+
+
fp
+
Pointer to the open file object structure.
+
fmt
+
Pointer to the null '\0' terminated format string. The terminator character will not be output.
+
...
+
Optional arguments...
+ +
+
+ + +
+

Return Values

+

When the string was written successfuly, it returns number of character encoding units written to the file. When the function failed due to disk full or an error, a negative value will be returned.

+
+ + +
+

Description

+

The format control directive is a sub-set of standard library shown as follows:

+
+    %[flag][width][precision][size]type
+
+
+
flag
Padding option. A - specifies left-aligned. A 0 specifies zero padded. The default setting is in right-aligned and space padded.
+
width
Minimum width of the field, 1-99 or *. If the width of generated string is less than the minimum width, rest field is padded with spaces or zeros. An * specifies the value comes from an argument in int type. The default setting is zero.
+
precision
Specifies number of fractional digits or maximum width of string, .0-.99 or .*. If the number is omitted, it is same as .0. Default setting is 6 for number and no limit for string.
+
size
Specifies size of integer argument, l(long) and ll(long long). If sizeof (long) == sizeof (int) is true (this is typical of 32-bit systems), prefix l can be omitted for long integer argument. The default size is int for integer argument and floating point argument is always assumed double as the default argument promotion.
+
type
Specifies type of the output format and the argument as shown below. The length of generated string is in assumtion of int is 32-bit. + + + + + + + + + + + +
TypeFormatArgumentLength
cCharacterint,
long,
long long		1 character.
dSigned decimal1 to 11 (20 for ll) characters.
uUnsigned decimal1 to 10 (20 for ll) characters.
oUnsigned octal1 to 11 (22 for ll) characters.
x XUnsigned hexdecimal1 to 8 (16 for ll) characters.
bUnsigned binary1 to 32 characters. Limited to lower 32 digits when ll is specified.
sStringTCHAR*As input string. A null pointer generates a zero-length string.
fFloating point
(decimal)		double1 to 31 characters. If the number of characters exceeds 31, it writes "±OV". Not a number and infinite value write "NaN" and "±INF" respectively.
e EFloating point
(e notation)		4 to 31 characters. If the number of characters exceeds 31 or exponent exceeds +99, it writes "±OV".
+
+
+

When FatFs is configured for Unicode API (FF_LFN_UNICODE >= 1), character encoding on the string fuctions, f_putc, f_puts, f_printf and f_gets function, is also switched to Unicode. The Unicode characters in multiple encoding unit, such as surrogate pair and multi-byte sequence, should not be divided into two function calls, or the character will be lost. The character encoding on the file to be written via this function is selected by FF_STRF_ENCODE. If the character encoding differs between file data and API, it is converted in this function. Input characters with wrong encoding for output will be lost.

+

If sprintf is used in the project and code conversion is not needed, f_write with sprintf will be efficient in code size and performance rather than f_printf.

+
+ + +
+

QuickInfo

+

This is a wrapper function of f_write function. Available when FF_FS_READONLY == 0 and FF_USE_STRFUNC >= 1. When FF_USE_STRFUNC == 2, '\n's in the generated string are written as '\r'+'\n' each.

+
+ + +
+

Example

+
+    f_printf(fp, "%d", 1234);             /* "1234" */
+    f_printf(fp, "%6d,%3d%%", -200, 5);   /* "  -200,  5%" */
+    f_printf(fp, "%-6u", 100);            /* "100   " */
+    f_printf(fp, "%ld", 12345678);        /* "12345678" */
+    f_printf(fp, "%llu", 0x100000000);    /* "4294967296"   (FF_PRINT_LLI) */
+    f_printf(fp, "%lld", -1LL);           /* "-1"           (FF_PRINT_LLI) */
+    f_printf(fp, "%04x", 0xA3);           /* "00a3" */
+    f_printf(fp, "%08lX", 0x123ABC);      /* "00123ABC" */
+    f_printf(fp, "%016b", 0x550F);        /* "0101010100001111" */
+    f_printf(fp, "%*d", 6, 100);          /* "   100" */
+    f_printf(fp, "%s", "abcdefg");        /* "abcdefg" */
+    f_printf(fp, "%5s", "abc");           /* "  abc" */
+    f_printf(fp, "%-5s", "abc");          /* "abc  " */
+    f_printf(fp, "%.5s", "abcdefg");      /* "abcde" */
+    f_printf(fp, "%-5.2s", "abcdefg");    /* "ab   " */
+    f_printf(fp, "%c", 'a');              /* "a" */
+    f_printf(fp, "%12f", 10.0);           /* "   10.000000" (FF_PRINT_FLOAT) */
+    f_printf(fp, "%.4E", 123.45678);      /* "1.2346E+02"   (FF_PRINT_FLOAT) */
+
+
+ + +
+

See Also

+

f_open, f_putc, f_puts, f_gets, f_close, FIL

+
+ + +

Return

+ + diff --git a/vendor/fatfs/documents/doc/putc.html b/vendor/fatfs/documents/doc/putc.html index 747b5fd..e48fbb1 100644 --- a/vendor/fatfs/documents/doc/putc.html +++ b/vendor/fatfs/documents/doc/putc.html @@ -3,8 +3,6 @@ - - FatFs - f_putc @@ -55,6 +53,7 @@

See Also

f_open, f_puts, f_printf, f_gets, f_close, FIL

+

Return

diff --git a/vendor/fatfs/documents/doc/puts.html b/vendor/fatfs/documents/doc/puts.html index 3695942..2def40f 100644 --- a/vendor/fatfs/documents/doc/puts.html +++ b/vendor/fatfs/documents/doc/puts.html @@ -3,8 +3,6 @@ - - FatFs - f_puts @@ -41,7 +39,7 @@

Return Value

Description

-

When FatFs is configured for Unicode API (FF_LFN_UNICODE >= 1), character encoding on the string fuctions, f_putc, f_puts, f_printf and f_gets function, is also switched to Unicode. The input Unicode characters in multiple encoding unit, such as surrogate pair and multi-byte sequence, should not be divided into two function calls, or the character will be lost. The character encoding on the file to be written via this functions is selected by FF_STRF_ENCODE. The characters with wrong encoding or invalid for the output encoding will be lost.

+

When FatFs is configured for Unicode API (FF_LFN_UNICODE >= 1), character encoding on the string fuctions, f_putc, f_puts, f_printf and f_gets function, is also switched to Unicode. The input Unicode characters in multiple encoding unit, such as surrogate pair and multi-byte sequence, should not be divided into two function calls, or the character will be lost. The character encoding on the file to be written via this functions is selected by FF_STRF_ENCODE. If the character encoding differs between file data and API, it is converted in this function. Input characters with wrong encoding for output will be lost.

@@ -56,6 +54,7 @@

See Also

f_open, f_putc, f_printf, f_gets, f_close, FIL

+

Return

diff --git a/vendor/fatfs/documents/doc/rc.html b/vendor/fatfs/documents/doc/rc.html index 52b496c..89823ec 100644 --- a/vendor/fatfs/documents/doc/rc.html +++ b/vendor/fatfs/documents/doc/rc.html @@ -3,8 +3,6 @@ - - FatFs - API Return Code @@ -49,7 +47,7 @@

Return Code of API Functions

Could not find the path. A directory in the path name could not be found.
FR_INVALID_NAME
-
The given string is invalid as the path name. One of the following possibilities is suspected. +
The given string is invalid as a path name. One of the following possibilities is suspected.
  • There is a character not allowed for the file name.
  • The file name is out of 8.3 format. (at non-LFN cfg.)
    • @@ -66,8 +64,8 @@

    Return Code of API Functions

  • Deleting the non-empty directory or current directory. (f_unlink)
  • Reading the file opened without FA_READ flag. (f_read)
  • Any modification to the file opened without FA_WRITE flag. (f_write, f_truncate, f_expand)
    • -
  • Could not create the object due to root directory full or disk full. (f_open, f_mkfs)
    • -
  • Could not allocate a contiguous area to the file. (f_expand)
    • +
  • Could not create the object due to root directory full or disk full. (f_open, f_mkdir)
    • +
  • Could not find a contiguous area for the file. (f_expand)
@@ -75,10 +73,10 @@

Return Code of API Functions

Name collision. An object with the same name is already existing in the directory.
FR_INVALID_OBJECT
-
The file/directory object is invalid or a null pointer is given. There are some reasons as follows: +
The file/directory object is invalid or the pointer is null. There are some reasons as follows:
    -
  • It has been closed, or the structure has been collapsed.
    • -
  • It has been invalidated. Open objects on the volume are invalidated by voulme mount process.
    • +
  • The file/directory has been closed.
    • +
  • The file/directory object has been invalidated or the structure has been collapsed. Open objects on the volume will be invalidated by a voulme mount process.
  • Physical drive is not ready to work due to a media removal.
@@ -93,8 +91,9 @@

Return Code of API Functions

Work area for the logical drive has not been registered by f_mount function.
FR_NO_FILESYSTEM
-
No valid FAT volume could not be found in the drive. One of the following possibilities is suspected. +
Valid FAT volume could not be found in the drive. One of the following possibilities is suspected.
    +
  • The FAT volume on the drive is collapsed.
  • Wrong lower layer implementation.
  • Wrong VolToPart[] settings. (FF_MULTI_PARTITION = 1)
@@ -129,6 +128,7 @@

Return Code of API Functions

The given parameter is invalid or there is an inconsistent for the volume.
+

Return

diff --git a/vendor/fatfs/documents/doc/read.html b/vendor/fatfs/documents/doc/read.html index 8ad2a1b..0dd7f53 100644 --- a/vendor/fatfs/documents/doc/read.html +++ b/vendor/fatfs/documents/doc/read.html @@ -3,8 +3,6 @@ - - FatFs - f_read @@ -28,13 +26,13 @@

f_read

Parameters

fp
-
Pointer to the open file object.
+
Pointer to the open file object structure. If a null pointer is given, the function fails with FR_INVALID_OBJECT.
buff
Pointer to the buffer to store the read data.
btr
-
Number of bytes to read in range of UINT type. If you need to read data fast, you should read data in large chunk as possible.
+
Number of bytes to read in range of UINT type. If the file needs to be read fast, it should be read in large chunk as possible.
br
-
Pointer to the UINT variable that receives number of bytes read. This value is always valid after the function call regardless of the function return code. If the return value is equal to btr, the function return code should be FR_OK.
+
Pointer to the variable in UINT type that receives number of bytes read. This value is always valid after the function call regardless of the function return code. If the return value is equal to btr, the function return code should be FR_OK.
@@ -54,7 +52,7 @@

Return Values

Description

-

The function starts to read data from the file at the file offset pointed by read/write pointer. The read/write pointer advances as number of bytes read. After the function succeeded, *br should be checked to detect end of the file. In case of *br < btr, it means the read/write pointer reached end of the file during read operation.

+

The function starts to read data from the file at the file offset pointed by read/write pointer of the file object. The read/write pointer advances as number of bytes read. After the function succeeded, *br should be checked to detect end of the file. In case of *br < btr, it means the read/write pointer hit end of the file during read operation.

@@ -75,6 +73,7 @@

See Also

f_open, fgets, f_write, f_close, FIL

+

Return

diff --git a/vendor/fatfs/documents/doc/readdir.html b/vendor/fatfs/documents/doc/readdir.html index 52a96b9..9ff76c4 100644 --- a/vendor/fatfs/documents/doc/readdir.html +++ b/vendor/fatfs/documents/doc/readdir.html @@ -3,8 +3,6 @@ - - FatFs - f_readdir @@ -53,19 +51,19 @@

Return Values

Description

-

The f_readdir function reads a directory item, informations about the object, from the open directory. Items in the directory can be read in sequence by f_readdir function calls. When all items in the directory have been read and no item to read, a null string is stored into the fno->fname[] without any error. When a null pointer is given to the fno, the read index of the directory object is rewinded. The f_rewinddir function is implemented as a macro.

+

The f_readdir function reads a directory item, informations about the object, from the open directory. Items in the directory can be read by f_readdir function calls in order of the directory table. When all items in the directory have been read and no item to read any more, a null string in fno->fname[] will be returned without an error. If a null pointer is given to the fno, the read index of the directory object will be rewound. The f_rewinddir function is implemented as a macro.

 #define f_rewinddir(dp) f_readdir((dp), 0)
-

When LFN is enabled, a member altname[] is defined in the file information structure to store the short file name of the object. If the long file name is not accessible due to a reason listed below, short file name is stored to the fname[] and the altname[] has a null string.

+

When LFN is enabled, a member altname[] is defined in the file information structure to store the short file name of the object. If the long file name is not accessible due to any reason listed below, short file name is stored to the fname[] and the altname[] has a null string.

    -
  • The item has no LFN. (Not the case in exFAT volume)
    • -
  • FF_MAX_LFN is insufficient to handle the LFN. (Not the case in FF_MAX_LFN == 255)
    • +
  • The item has no LFN. (Not the case on the exFAT volume)
    • +
  • FF_MAX_LFN is insufficient to handle the LFN. (Not the case when FF_MAX_LFN == 255)
  • FF_LFN_BUF is insufficient to store the LFN.
    • -
  • The LFN contains some character not defined in current CP. (Not the case in FF_LFN_UNICODE != 0)
    • +
  • The LFN contains some character not defined in current CP. (Not the case when FF_LFN_UNICODE != 0)
-

There is an issue on read directories in exFAT volume. The exFAT does not support short file name. This means no name can be returned on the condition above. If it is the case, "?" is returned as the file name to indicate that the object is not accessible. To avoid this problem, configure FatFs FF_LFN_UNICODE != 0 and FF_MAX_LFN == 255 to support the full feature of LFN specification.

-

Dot entries ("." and "..") in the sub-directory of FAT volume are filtered out and they will never appear in the read items because exFAT lacks dot entries in the sub-directory.

+

There is an issue on read the directories on the exFAT volume. The exFAT does not support short file name. This means no name can be returned on the condition above. If it is the case, "?" is returned as the file name to indicate that the object is not accessible. To avoid this problem, configure FatFs FF_LFN_UNICODE != 0 and FF_MAX_LFN == 255 to support the full feature of LFN specification.

+

Dot entries ("." and "..") in the sub-directory of FAT volume are filtered out and they will never appear in the read items because of the consistency with exFAT which lacks dot entries in the sub-directory.

@@ -78,6 +76,41 @@

QuickInfo

Sample Code

+/* List contents of a directory */
+
+FRESULT list_dir (const char *path)
+{
+    FRESULT res;
+    DIR dir;
+    FILINFO fno;
+    int nfile, ndir;
+
+
+    res = f_opendir(&dir, path);                   /* Open the directory */
+    if (res == FR_OK) {
+        nfile = ndir = 0;
+        for (;;) {
+            res = f_readdir(&dir, &fno);           /* Read a directory item */
+            if (fno.fname[0] == 0) break;          /* Error or end of dir */
+            if (fno.fattrib & AM_DIR) {            /* It is a directory */
+                printf("   <DIR>   %s\n", fno.fname);
+                ndir++;
+            } else {                               /* It is a file */
+                printf("%10u %s\n", fno.fsize, fno.fname);
+                nfile++;
+            }
+        }
+        f_closedir(&dir);
+        printf("%d dirs, %d files.\n", ndir, nfile);
+    } else {
+        printf("Failed to open \"%s\". (%u)\n", path, res);
+    }
+    return res;
+}
+
+
+/* Recursive scan of all items in the directory */
+
 FRESULT scan_files (
     char* path        /* Start node to be scanned (***also used as work area***) */
 )
@@ -88,22 +121,22 @@ 
Sample Code

     static FILINFO fno;
 
 
-    res = f_opendir(&dir, path);                       /* Open the directory */
+    res = f_opendir(&dir, path);                   /* Open the directory */
     if (res == FR_OK) {
         for (;;) {
-            res = f_readdir(&dir, &fno);                   /* Read a directory item */
-            if (res != FR_OK || fno.fname[0] == 0) break;  /* Break on error or end of dir */
-            if (fno.fattrib & AM_DIR) {                    /* It is a directory */
+            res = f_readdir(&dir, &fno);           /* Read a directory item */
+            if (fno.fname[0] == 0) break;          /* Break on error or end of dir */
+            if (fno.fattrib & AM_DIR) {            /* The item is a directory */
                 i = strlen(path);
                 sprintf(&path[i], "/%s", fno.fname);
-                res = scan_files(path);                    /* Enter the directory */
+                res = scan_files(path);            /* Enter the directory */
                 if (res != FR_OK) break;
                 path[i] = 0;
-            } else {                                       /* It is a file. */
+            } else {                               /* The item is a file. */
                 printf("%s/%s\n", path, fno.fname);
             }
         }
-        f_closedir(&dir);
+        f_closedir(&dir);
     }
 
     return res;
@@ -117,7 +150,7 @@ 
Sample Code

     char buff[256];
 
 
-    res = f_mount(&fs, "", 1);
+    res = f_mount(&fs, "", 1);
     if (res == FR_OK) {
         strcpy(buff, "/");
         res = scan_files(buff);
@@ -134,6 +167,7 @@ 
See Also

 
f_opendir, f_closedir, f_stat, FILINFO, DIR
+

Return

diff --git a/vendor/fatfs/documents/doc/rename.html b/vendor/fatfs/documents/doc/rename.html index 326af0d..9919bd8 100644 --- a/vendor/fatfs/documents/doc/rename.html +++ b/vendor/fatfs/documents/doc/rename.html @@ -3,8 +3,6 @@ - - FatFs - f_rename diff --git a/vendor/fatfs/documents/doc/sdir.html b/vendor/fatfs/documents/doc/sdir.html index eb18cc3..d137a07 100644 --- a/vendor/fatfs/documents/doc/sdir.html +++ b/vendor/fatfs/documents/doc/sdir.html @@ -3,8 +3,6 @@ - - FatFs - DIR @@ -33,6 +31,7 @@

DIR

+

Return

diff --git a/vendor/fatfs/documents/doc/setcp.html b/vendor/fatfs/documents/doc/setcp.html index a1d124b..9d5c774 100644 --- a/vendor/fatfs/documents/doc/setcp.html +++ b/vendor/fatfs/documents/doc/setcp.html @@ -3,8 +3,6 @@ - - FatFs - f_setcp diff --git a/vendor/fatfs/documents/doc/setlabel.html b/vendor/fatfs/documents/doc/setlabel.html index 9eb5e78..8871268 100644 --- a/vendor/fatfs/documents/doc/setlabel.html +++ b/vendor/fatfs/documents/doc/setlabel.html @@ -3,8 +3,6 @@ - - FatFs - f_setlabel @@ -25,7 +23,7 @@

f_setlabel

Parameters

label
-
Pointer to the null-terminated string that specifies the volume label to be set.
+
Pointer to the null-terminated string that specifies the volume label to be set. If a null pointer is given, the function fails with FR_INVALID_DRIVE.
@@ -49,7 +47,7 @@

Return Values

Description

-

When the string has a drive prefix, the volume label will be set to the volume specified by the drive prefix. Unix style volume ID cannot be used to specify the volume. If drive number is not specified, the volume label will be set to the default drive. If length of the given volume label is zero, the volume label on the volume will be removed. The format of the volume label is as shown below:

+

When the string has a drive prefix, the volume label will be set to the volume specified by the drive prefix. If drive number is not specified, the volume label will be set to the default drive. If length of the given volume label is zero, the volume label on the volume will be removed. The format of the volume label is as shown below:

  • Up to 11 bytes long as conversion of OEM code page at FAT volume.
  • Up to 11 characters long at exFAT volume.
    • @@ -57,7 +55,7 @@

    Description

  • Allowable characters for exFAT volume are: characters allowed for LFN includes dot. Low-case characters are preserved.
  • Spaces can be embedded anywhere in the volume label. Trailing spaces are truncated off at FAT volume.
-

Remark: The standard system (Windows) has a problem at the volume label with a heading \xE5 on the FAT volume. To avoid this problem, this function rejects such volume label as invalid name.

+

Remark: The standard system (Windows) has a problem in the volume label with a heading \xE5 on the FAT volume. To avoid this problem, this function rejects such volume label as invalid name.

@@ -77,6 +75,9 @@

Example

/* Remove volume label of the drive 2 */ f_setlabel("2:"); + + /* Set volume label in Unix style volume id */ + f_setlabel("/tfcard/LOG DISK");
diff --git a/vendor/fatfs/documents/doc/sfatfs.html b/vendor/fatfs/documents/doc/sfatfs.html index 6ecd6e5..b002ccf 100644 --- a/vendor/fatfs/documents/doc/sfatfs.html +++ b/vendor/fatfs/documents/doc/sfatfs.html @@ -3,8 +3,6 @@ - - FatFs - FATFS diff --git a/vendor/fatfs/documents/doc/sfile.html b/vendor/fatfs/documents/doc/sfile.html index 9234d32..c361483 100644 --- a/vendor/fatfs/documents/doc/sfile.html +++ b/vendor/fatfs/documents/doc/sfile.html @@ -3,8 +3,6 @@ - - FatFs - FIL @@ -38,6 +36,7 @@

FIL

+

Return

diff --git a/vendor/fatfs/documents/doc/sfileinfo.html b/vendor/fatfs/documents/doc/sfileinfo.html index db0f45e..33bd3ae 100644 --- a/vendor/fatfs/documents/doc/sfileinfo.html +++ b/vendor/fatfs/documents/doc/sfileinfo.html @@ -3,8 +3,6 @@ - - FatFs - FILINFO @@ -19,6 +17,10 @@

FILINFO

FSIZE_t fsize; /* File size */ WORD fdate; /* Last modified date */ WORD ftime; /* Last modified time */ +#if FF_FS_CRTIME + WORD crdate; /* Created date */ + WORD crtime; /* Created time */ +#endif BYTE fattrib; /* Attribute */ #if FF_USE_LFN TCHAR altname[FF_SFN_BUF + 1]; /* Alternative object name */ @@ -56,6 +58,12 @@

Members

Second / 2 (0..29)
+
crdate
+
The date when the file/directory was created. This member is available when FF_FS_CRTIME = 1. +
+
crtime
+
The time when the file/directory was created. This member is available when FF_FS_CRTIME = 1 +
fattrib
The attribute flags in combination of:
@@ -68,11 +76,12 @@

Members

fname[]
-
Null-terminated object name. A null string is stored when no item to read and it indicates this structure is invalid. The size of fname[] and altname[] each can be configured in LFN configuration.
+
Null-terminated object name is stored. If no item to read or an error occured in the function, a null string is stored to indicate this structure is invalid. The size of fname[] and altname[] each can be configured in LFN configuration.
altname[]
Alternative object name is stored if available. This member is not available in non-LFN configuration.
+

Return

diff --git a/vendor/fatfs/documents/doc/size.html b/vendor/fatfs/documents/doc/size.html index 0be1a76..6946145 100644 --- a/vendor/fatfs/documents/doc/size.html +++ b/vendor/fatfs/documents/doc/size.html @@ -3,8 +3,6 @@ - - FatFs - f_size @@ -57,6 +55,7 @@

See Also

f_open, f_lseek, FIL

+

Return

diff --git a/vendor/fatfs/documents/doc/stat.html b/vendor/fatfs/documents/doc/stat.html index 2c2680a..75c59eb 100644 --- a/vendor/fatfs/documents/doc/stat.html +++ b/vendor/fatfs/documents/doc/stat.html @@ -3,8 +3,6 @@ - - FatFs - f_stat @@ -26,7 +24,7 @@

f_stat

Parameters

path
-
Pointer to the null-terminated string that specifies the object to get its information. The object must not be the root direcotry.
+
Pointer to the null-terminated string that specifies the object to get its information. The object must not be the root direcotry. If a null pointer is given, the function fails with FR_INVALID_DRIVE.
fno
Pointer to the blank FILINFO structure to store the information of the object. Set null pointer if this information is not needed.
@@ -54,7 +52,8 @@

Return Values

Description

-

The f_stat function checks the existence of a file or sub-directory in the directory. If not exist, the function returns with FR_NO_FILE. If exist, the function returns with FR_OK and the informations about the object, size, timestamp and attribute, is stored to the file information structure. For details of the file information, refer to the FILINFO structure and f_readdir function.

+

The f_stat function checks the existence of a file or sub-directory. If it is not exist, the function returns with FR_NO_FILE. If it is exist, the function returns with FR_OK and the informations about the object, size, timestamp and attribute, is stored to the file information structure. For details of the file information, refer to the FILINFO structure and f_readdir function.

+

Note that the file information comes from the meta data in the directory. If the file has been opend and modified, the file will need to be synced or closed in order to obtain the latest file information. This function cannot be used to retrieve the long file name with the short file name.

@@ -69,16 +68,17 @@

Example

     FRESULT fr;
     FILINFO fno;
+    const char *fname = "file.txt";
 
 
-    printf("Test for 'file.txt'...\n");
+    printf("Test for \"%s\"...\n", fname);
 
-    fr = f_stat("file.txt", &fno);
+    fr = f_stat(fname, &fno);
     switch (fr) {
 
     case FR_OK:
         printf("Size: %lu\n", fno.fsize);
-        printf("Timestamp: %u/%02u/%02u, %02u:%02u\n",
+        printf("Timestamp: %u-%02u-%02u, %02u:%02u\n",
                (fno.fdate >> 9) + 1980, fno.fdate >> 5 & 15, fno.fdate & 31,
                fno.ftime >> 11, fno.ftime >> 5 & 63);
         printf("Attributes: %c%c%c%c%c\n",
@@ -90,7 +90,8 @@ 
Example

         break;
 
     case FR_NO_FILE:
-        printf("It is not exist.\n");
+    case FR_NO_PATH:
+        printf("\"%s\" is not exist.\n", fname);
         break;
 
     default:
@@ -101,10 +102,11 @@ 
Example

 
 
 

-
References

+
See Also

 
f_opendir, f_readdir, FILINFO

 

 
+
 
Return

 
 
diff --git a/vendor/fatfs/documents/doc/sync.html b/vendor/fatfs/documents/doc/sync.html
index 9fb42a0..f135c5b 100644
--- a/vendor/fatfs/documents/doc/sync.html
+++ b/vendor/fatfs/documents/doc/sync.html
@@ -3,8 +3,6 @@
 
 
 
-
-
 
 FatFs - f_sync
 
@@ -68,7 +66,7 @@ 
Description

 w - f_write()
 S - f_sync()
-

However there is no sense in f_sync function immediataly before f_close function because it performs f_sync function in it. In other words, the differnce between those functions is that the file object is invalidated or not.

+

However there is no sense in f_sync function jsut before f_close function, because the f_close performs f_sync in it. Actually, the differnce between these functions is that the file object is invalidated or not.

@@ -83,6 +81,7 @@

See Also

f_close, Critical section

+

Return

diff --git a/vendor/fatfs/documents/doc/tell.html b/vendor/fatfs/documents/doc/tell.html index 075f033..c40ebe5 100644 --- a/vendor/fatfs/documents/doc/tell.html +++ b/vendor/fatfs/documents/doc/tell.html @@ -3,8 +3,6 @@ - - FatFs - f_tell @@ -57,6 +55,7 @@

See Also

f_open, f_lseek, FIL

+

Return

diff --git a/vendor/fatfs/documents/doc/truncate.html b/vendor/fatfs/documents/doc/truncate.html index 0ac012f..bbc335b 100644 --- a/vendor/fatfs/documents/doc/truncate.html +++ b/vendor/fatfs/documents/doc/truncate.html @@ -3,8 +3,6 @@ - - FatFs - f_truncate @@ -25,7 +23,7 @@

f_truncate

Parameter

fp
-
Pointer to the open file object to be truncated.
+
Pointer to the open file object to be truncated. If a null pointer is given, the function fails with FR_INVALID_OBJECT.
diff --git a/vendor/fatfs/documents/doc/unlink.html b/vendor/fatfs/documents/doc/unlink.html index 7809648..f8e1d20 100644 --- a/vendor/fatfs/documents/doc/unlink.html +++ b/vendor/fatfs/documents/doc/unlink.html @@ -3,8 +3,6 @@ - - FatFs - f_unlink @@ -25,7 +23,7 @@

f_unlink

Parameter

path
-
Pointer to a null-terminated string that specifies the file or sub-directory to be removed.
+
Pointer to a null-terminated string that specifies the file or sub-directory to be removed. If a null pointer is given, the function fails with FR_INVALID_DRIVE.
diff --git a/vendor/fatfs/documents/doc/utime.html b/vendor/fatfs/documents/doc/utime.html index 40e39eb..08a89e3 100644 --- a/vendor/fatfs/documents/doc/utime.html +++ b/vendor/fatfs/documents/doc/utime.html @@ -3,8 +3,6 @@ - - FatFs - f_utime @@ -17,7 +15,7 @@

f_utime

 FRESULT f_utime (
   const TCHAR* path,  /* [IN] Object name */
-  const FILINFO* fno  /* [IN] Time and data to be set */
+  const FILINFO* fno  /* [IN] Time and date to be set */
 );
@@ -26,9 +24,9 @@

f_utime

Parameters

path
-
Pointer to the null-terminated string that specifies an object to be changed.
+
Pointer to the null-terminated string that specifies an object to be changed. If a null pointer is given, the function fails with FR_INVALID_DRIVE.
fno
-
Pointer to the file information structure that has a timestamp to be set in member fdate and ftime. Do not care any other members.
+
Pointer to the file information structure that has new timestamps to be set in the members. fdate and ftime are for the last modified time. When FF_FS_CRTIME = 1, crdate and crtime for the created time are available in addition. Every timestamp is in local time. If fdate or crdate is invalid (0), the modified time or created time is left unchanged respectively. Do not care any other member.
@@ -63,7 +61,7 @@

Description

Example

 FRESULT set_timestamp (
-    char *obj,     /* Pointer to the file name */
+    const char *fname,     /* Pointer to the file name */
     int year,
     int month,
     int mday,
@@ -76,8 +74,10 @@ 
Example

 
     fno.fdate = (WORD)(((year - 1980) * 512U) | month * 32U | mday);
     fno.ftime = (WORD)(hour * 2048U | min * 32U | sec / 2U);
-
-    return f_utime(obj, &fno);
+#if FF_FS_CRTIME
+    fno.crdate = 0;   /* Do not change created time in this code */
+#endif
+    return f_utime(fname, &fno);
 }
@@ -94,6 +94,7 @@

See Also

f_stat, FILINFO

+

Return

diff --git a/vendor/fatfs/documents/doc/write.html b/vendor/fatfs/documents/doc/write.html index 4897bf8..78d525e 100644 --- a/vendor/fatfs/documents/doc/write.html +++ b/vendor/fatfs/documents/doc/write.html @@ -3,8 +3,6 @@ - - FatFs - f_write @@ -28,13 +26,13 @@

f_write

Parameters

fp
-
Pointer to the open file object structure.
+
Pointer to the open file object structure. If a null pointer is given, the function fails with FR_INVALID_OBJECT.
buff
Pointer to the data to be written.
btw
-
Specifies number of bytes to write in range of UINT type. If you need to write data fast, you should write data in large chunk as possible.
+
Specifies number of bytes to write in range of UINT type. If the data needs to be written fast, it should be written in large chunk as possible.
bw
-
Pointer to the UINT variable that receives the number of bytes written. This value is always valid after the function call regardless of the function return code. If the return value is equal to btw, the function return code should be FR_OK.
+
Pointer to the variable in UINT type that receives the number of bytes written. This value is always valid after the function call regardless of the function return code. If the return value is equal to btw, the function return code should be FR_OK.
@@ -54,7 +52,7 @@

Return Values

Description

-

The function starts to write data to the file at the file offset pointed by read/write pointer. The read/write pointer advances as number of bytes written. After the function succeeded, *bw should be checked to detect the disk full. In case of *bw < btw, it means the volume got full during the write operation. The function can take a time when the volume is full or close to full.

+

The function starts to write data to the file at the file offset pointed by read/write pointer of the file object. The read/write pointer advances as number of bytes written. After the function succeeded, *bw should be checked to detect the disk full. In case of *bw < btw, it means the volume got full during the write operation. The function can take a time when the volume is full or close to full.

@@ -75,6 +73,7 @@

See Also

f_open, f_read, fputc, fputs, fprintf, f_close, FIL

+

Return

diff --git a/vendor/fatfs/documents/res/app5.c b/vendor/fatfs/documents/res/app5.c index 9190dad..2739019 100644 --- a/vendor/fatfs/documents/res/app5.c +++ b/vendor/fatfs/documents/res/app5.c @@ -13,7 +13,7 @@ FRESULT test_contiguous_file ( *cont = 0; - fr = f_lseek(fp, 0); /* Validates and prepares the file */ + fr = f_rewind(fp); /* Validates and prepares the file */ if (fr != FR_OK) return fr; #if FF_MAX_SS == FF_MIN_SS diff --git a/vendor/fatfs/documents/res/uniconv.zip b/vendor/fatfs/documents/res/uniconv.zip new file mode 100644 index 0000000000000000000000000000000000000000..be7d84f3f2d452afa3dffce86346e67533855f71 GIT binary patch literal 4175 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 x4< literal 0 HcmV?d00001 diff --git a/vendor/fatfs/documents/updates.html b/vendor/fatfs/documents/updates.html new file mode 100644 index 0000000..e97fa9d --- /dev/null +++ b/vendor/fatfs/documents/updates.html @@ -0,0 +1,544 @@ + + + + + + + +FatFs - Updates and Migration Notes + + +

Updates and Migration Notes

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
RevisionUpdatesMigration Notes
R0.15b
Jun 21, 2025		 +Added support for timestamp of created time. (FF_FS_CRTIME)
+Fixed FatFs fails to load the FsInfo in FAT32 volumes and the f_getfree always be forced a full FAT scan which takes a long time. (appeared at R0.15a)
+		 +Small changes to the f_utime function to support for the timestamp of created time.
+
R0.15a
Nov 22, 2024		 +Fixed a complie error when FF_FS_LOCK != 0. (appeared at R0.15)
+Fixed a potential issue when work FatFs concurrency with FF_FS_REENTRANT, FF_VOLUMES >= 2 and FF_FS_LOCK > 0.
+Made f_setlabel accept a volume label with Unix style volume ID when FF_STR_VOLUME_ID == 2.
+Made FatFs update PercInUse field in exFAT VBR. (A preceding f_getfree is needed for the accuracy)
+		 +
R0.15
Nov 6, 2022		 +Changed user provided synchronization functions in order to completely eliminate the platform dependency from FatFs code.
+Fixed a potential error in f_mount when FF_FS_REENTRANT.
+Fixed file lock control FF_FS_LOCK is not mutal excluded when FF_FS_REENTRANT && FF_VOLUMES > 1 is true.
+Fixed f_mkfs creates broken exFAT volume when the size of volume is >= 2^32 sectors.
+Fixed string functions cannot write the unicode characters not in BMP when FF_LFN_UNICODE == 2 (UTF-8).
+Fixed a compatibility issue in identification of GPT header.
+		 +User provided synchronization functions, ff_cre_syncobj, ff_del_syncobj, ff_req_grant and ff_rel_grant, needed when FF_FS_REENTRANT are replaced with ff_mutex_create, ff_mutex_delete, ff_mutex_take and ff_mutex_give respectively. For example, see ffsystem.c.
+FF_SYNC_t is removed from the configuration options.
+
R0.14b
Apr 17, 2021		 +Made FatFs uses standard library string.h for copy, compare and search instead of built-in string functions.
+Added support for long long integer and floating point to f_printf. (FF_STRF_LLI and FF_STRF_FP)
+Made path name parser ignores the terminating separator to allow "dir/".
+Improved the compatibility in Unix style path name feature.
+Fixed the file gets dead-locked when f_open failed with certain conditions. (appeared at R0.12a)
+Fixed f_mkfs can create wrong exFAT volume due to a timing dependent error. (appeared at R0.12)
+Fixed code page 855 cannot be set by f_setcp. (appeared at R0.13)
+Fixed some compiler warnings.
+		 +From this revision, FatFs depends on string.h.
+
R0.14a
Dec 05, 2020		 +Limited number of recursive calls in f_findnext to prevent stack overflow.
+Fixed old floppy disks formatted with MS-DOS 2.x and 3.x cannot be mounted.
+Fixed some compiler warnings.
+		 +Number of wildcards in the matching pattern in f_findfirst is limited to 4.
+
R0.14
Oct 14, 2019		 +Added support for 64-bit LBA and GUID partition table (FF_LBA64)
+Changed some API functions, f_mkfs and f_fdisk.
+Fixed f_open cannot find the file with file name in length of FF_MAX_LFN characters.
+Fixed f_readdir cannot retrieve long file names in length of FF_MAX_LFN - 1 characters.
+Fixed f_readdir returns file names with wrong case conversion. (appeared at R0.12)
+Fixed f_mkfs can fail to create exFAT volume in the second partition. (appeared at R0.12)
+		 +Usage of f_mkfs and f_fdisk is changed and some features are added to these functions.
+
R0.13c
Oct 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)
+		 +From this revision, FatFs depends on stdint.h in C99 or later.
+integer.h is removed.
+
R0.13b
Apr 07, 2018		 +Added support for UTF-32 encoding on the API. (FF_LFN_UNICODE = 3)
+Added support for Unix style volume prefix. (FF_STR_VOLUME_ID = 2)
+Fixed accesing objects in 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)
+		 +
R0.13a
Oct 14, 2017		 +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 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_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)
+		 +
R0.13
May 21, 2017		 +Prefix of configuration item names are changed from "_" to "FF_".
+Added f_setcp, run-time code page configuration. (FF_CODE_PAGE = 0)
+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 exFAT 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 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)
+		 +ASCII only configuration, FF_CODE_PAGE = 1, is removed. Use FF_CODE_PAGE = 437 instead.
+
R0.12c
Mar 04, 2017		 +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.
+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)
+		 +
R0.12b
Sep 4, 2016		 +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 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 f_mkfs creating exFAT volume with too small cluster size can collapse unallocated memory. (appeared at R0.12a)
+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 some internal errors in f_expand and f_lseek. (appeared at R0.12)
+		 +
R0.12a
Jul 10, 2016		 +Added support for creating exFAT volume with some changes of f_mkfs.
+Added a file open method FA_OPEN_APPEND.
+f_forward is available regardless of _FS_TINY.
+Fixed f_mkfs creates broken volume. (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.
+		 +Usage of f_mkfs is changed.
+
R0.12
Apr 12, 2016		 +Added support for exFAT file system. (_FS_EXFAT)
+Added f_expand. (_USE_EXPAND)
+Changed some members in FINFO and behavior of f_readdir.
+Added a configuration option _USE_CHMOD.
+Fixed errors in the case conversion teble of Unicode (cc*.c).
+		 +Usage and members of FINFO sructure used in f_readdir is changed.
+Dot entries in the sub-directory are never appear in f_readdir.
+".." does not work as path name in exFAT volume.
+f_getcwd does not work in exFAT volume.
+Many members in FIL and DIR structure are changed.
+To use f_chmod, _USE_CHMOD needs to be set.
+_WORD_ACCESS is removed from the configuration options.
+
R0.11a
Sep 5, 2015		 +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)
+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).
+		 +Removed some code pages actually not exist on the standard systems. (_CODE_PAGE)
+
R0.11
Feb 9, 2015		 +Added f_findfirst and f_findnext. (_USE_FIND)
+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)
+		 +
R0.10c
Nov 9, 2014		 +Added a configuration option for the platforms without RTC. (_FS_NORTC)
+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 null pointer dereference on attempting to delete the root direcotry. (appeared at R0.08)
+		 +
R0.10b
May 19, 2014		 +Fixed a hard error in the disk I/O layer can collapse the directory entry.
+Fixed LFN entry is not deleted on delete/rename an object with its lossy converted SFN. (appeared at R0.07)
+		 +
R0.10a
Jan 15, 2014		 +Added arbitrary strings as drive number in the path name. (_STR_VOLUME_ID)
+Added an option for minimum sector size. (_MIN_SS)
+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 larger than 0. (appeared at R0.10)
+Fixed f_close invalidates the file object without volume lock.
+Fixed volume lock is left acquired after return from f_closedir. (appeared at R0.10)
+Fixed creation of a directory entry with LFN fails on too many SFN collisions. (appeared at R0.07)
+		 +
R0.10
Oct 2, 2013		 +Added an option for character encoding on the file. (_STRF_ENCODE)
+Added f_closedir.
+Added forced full FAT scan option for f_getfree. (_FS_NOFSINFO)
+Added forced mount option with changes of f_mount.
+Improved behavior of volume auto detection.
+Improved write throughput of f_puts and f_printf.
+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 4 GB.
+Fixed f_open, f_mkdir and f_setlabel can return incorrect result code on error.
+		 +
R0.09b
Jan 24, 2013		 +Added f_getlabel and f_setlabel. (_USE_LABEL)
+		 +
R0.09a
Aug 27, 2012		 +Fixed assertion failure due to OS/2 EA on FAT12/16 volume.
+Changed file functions reject null object pointer to avoid crash.
+Changed option name _FS_SHARE to _FS_LOCK.
+		 +
R0.09
Sep 6, 2011		 +f_mkfs supports multiple partition on a physical drive.
+Added f_fdisk. (_MULTI_PARTITION = 2)
+		 +
R0.08b
Jan 15, 2011		 +Fast seek function is also applied to f_read and f_write.
+f_lseek reports required table size on creating CLMP.
+Extended format syntax of f_printf.
+Ignores duplicated directory separators in given path names.
+		 +
R0.08a
Aug 16, 2010		 +Added f_getcwd. (_FS_RPATH = 2)
+Added sector erase function. (_USE_ERASE)
+Moved file lock semaphore table from fs object to the bss.
+Fixed f_mkdir creates wrong directory on non-LFN cfg when the given name contains ';'.
+Fixed f_mkfs creates wrong FAT32 volume.
+		 +
R0.08
May 15, 2010		 +Added an option to _USE_LFN
+Added support of file lock. (_FS_SHARE)
+Added fast seek function. (_USE_FASTSEEK)
+Changed a type name on the API, XCHAR to TCHAR.
+Changed member, fname, in the FILINFO on Unicode cfg.
+String functions support UTF-8 encoding files on Unicode cfg.
+		 +
R0.07e
Nov 3, 2009		 +Separated out configuration options from ff.h to ffconf.h.
+Added a configuration option, _LFN_UNICODE.
+Fixed f_unlink fails to remove a sub-dir on _FS_RPATH.
+Fixed name matching error on the 13 char boundary.
+Changed f_readdir to return the SFN with always upper case on non-LFN cfg.
+		 +
R0.07c
Jan 21, 2009		 +Fixed f_unlink may return FR_OK on error.
+Fixed wrong cache control in f_lseek.
+Added support of relative path.
+Added f_chdir.
+Added f_chdrive.
+Added proper case conversion to extended characters.
+		 +
R0.07a
Apr 14, 2009		 +Separated out OS dependent code on re-entrant configuration.
+Added multiple sector size support.
+		 +
R0.07
Apr 1, 2009		 +Merged Tiny-FatFs into FatFs as a buffer configuration option.
+Added support for long file extension.
+Added multiple code page support.
+Added re-entrancy for multitask operation.
+Added auto cluster size selection to f_mkfs.
+Added rewind option to f_readdir.
+Changed result code of critical errors.
+Renamed string functions to avoid name collision.
+		 +
R0.06
Apr 1, 2008		 +Added f_forward. (Tiny-FatFs)
+Added string functions: f_gets, f_putc, f_puts and f_printf.
+Improved performance of f_lseek on moving to the same or following cluster.
+		 +
R0.05a
Feb 3, 2008		 +Added f_truncate.
+Added f_utime.
+Fixed off by one error at FAT sub-type determination.
+Fixed btr in f_read can be mistruncated.
+Fixed cached sector is left not flushed when create and close without write.
+		 +
R0.05
Aug 26, 2007		 +Changed arguments of f_read, f_write.
+Changed arguments of f_mkfs. (FatFs)
+Fixed f_mkfs on FAT32 creates incorrect FSInfo. (FatFs)
+Fixed f_mkdir on FAT32 creates broken directory. (FatFs)
+		 +
R0.04b
May 5, 2007		 +Added _USE_NTFLAG option.
+Added support for FSInfo in FAT32 volume.
+Fixed some problems corresponds to FAT32. (Tiny-FatFs)
+Fixed DBCS name can result FR_INVALID_NAME.
+Fixed short seek (<= csize) collapses the file object.
+		 +
R0.04a
Apr 1, 2007		 +Supported multiple partitions on a plysical drive. (FatFs)
+Added minimization level 3.
+Added a capability of extending file size to f_lseek.
+Fixed an endian sensitive code in f_mkfs. (FatFs)
+Fixed a problem corresponds to FAT32 support. (Tiny-FatFs)
+		 +
R0.04
Feb 4, 2007		 +Supported multiple drive system. (FatFs)
+Changed some APIs for multiple drive system.
+Added f_mkfs. (FatFs)
+Added _USE_FAT32 option. (Tiny-FatFs)
+		 +
R0.03a
Dec 11, 2006		 +Improved cluster scan algolithm to write files fast.
+Fixed f_mkdir creates broken directory on FAT32.
+		 +
R0.03
Sep 22, 2006		 +Added f_rename. +Changed option _FS_MINIMUM to _FS_MINIMIZE.
+		 +
R0.02a
Jun 10, 2006		 +Added a configuration option _FS_MINIMUM.
+		 +
R0.02
Jun 01, 2006		 +Added FAT12.
+Removed unbuffered mode.
+Fixed a problem on small (<32M) patition.
+		 +
R0.01
Apr 29, 2006		 +First release.
+		 +
+

Return

+ + diff --git a/vendor/fatfs/documents/updates.txt b/vendor/fatfs/documents/updates.txt deleted file mode 100644 index 60b6e1a..0000000 --- a/vendor/fatfs/documents/updates.txt +++ /dev/null @@ -1,286 +0,0 @@ -R0.14b (April 17, 2021) - Made FatFs uses standard library for copy, compare and search instead of built-in string functions. - Added support for long long integer and floating point to f_printf(). (FF_STRF_LLI and FF_STRF_FP) - Made path name parser ignore the terminating separator to allow "dir/". - Improved the compatibility in Unix style path name feature. - Fixed the file gets dead-locked when f_open() failed with some conditions. (appeared at R0.12a) - Fixed f_mkfs() can create wrong exFAT volume due to a timing dependent error. (appeared at R0.12) - Fixed code page 855 cannot be set by f_setcp(). - Fixed some compiler warnings. - - -R0.14a (December 05, 2020) - Limited number of recursive calls in f_findnext(). - Fixed old floppy disks formatted with MS-DOS 2.x and 3.x cannot be mounted. - Fixed some compiler warnings. - - -R0.14 (October 14, 2019) - Added support for 64-bit LBA and GUID partition table (FF_LBA64) - Changed some API functions, f_mkfs() and f_fdisk(). - Fixed f_open() function cannot find the file with file name in length of FF_MAX_LFN characters. - Fixed f_readdir() function cannot retrieve long file names in length of FF_MAX_LFN - 1 characters. - Fixed f_readdir() function returns file names with wrong case conversion. (appeared at R0.12) - Fixed f_mkfs() function can fail to create exFAT volume in the second partition. (appeared at R0.12) - -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) - - -R0.13b (April 07, 2018) - Added support for UTF-32 encoding on the API. (FF_LFN_UNICODE = 3) - Added support for Unix style volume prefix. (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 f_setlabel() does not reject some invalid characters. (appeared at R0.09b) - - -R0.13a (October 14, 2017) - 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 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_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) - - -R0.13 (May 21, 2017) - Changed heading character of configuration keywords "_" to "FF_". - 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) - 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 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 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) - - -R0.12c (March 04, 2017) - 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. - 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) - - -R0.12b (September 4, 2016) - 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 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 f_mkfs() creating exFAT volume with too small cluster size can collapse unallocated memory. (appeared at R0.12a) - 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 some internal errors in f_expand() and f_lseek(). (appeared at R0.12) - - -R0.12a (July 10, 2016) - 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. - f_forward() is available regardless of _FS_TINY. - Fixed f_mkfs() creates wrong volume. (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. - - -R0.12 (April 12, 2016) - Added support for exFAT file system. (_FS_EXFAT) - Added f_expand(). (_USE_EXPAND) - Changed some members in FINFO structure and behavior of f_readdir(). - Added an option _USE_CHMOD and removed an option _WORD_ACCESS. - Fixed errors in the case conversion teble of Unicode (cc*.c). - - -R0.11a (September 5, 2015) - 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) - 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 Unicode (cc*.c). - - -R0.11 (February 9, 2015) - Added f_findfirst() and f_findnext(). (_USE_FIND) - 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) - - -R0.10c (November 9, 2014) - Added a configuration option for the platforms without RTC. (_FS_NORTC) - 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 null pointer dereference on attempting to delete the root direcotry. (appeared at R0.08) - - -R0.10b (May 19, 2014) - Fixed a hard error in the disk I/O layer can collapse the directory entry. - Fixed LFN entry is not deleted on delete/rename an object with its lossy converted SFN. (appeared at R0.07) - - -R0.10a (January 15, 2014) - Added arbitrary strings as drive number in the path name. (_STR_VOLUME_ID) - Added an option for minimum sector size. (_MIN_SS) - 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 larger than 0. (appeared at R0.10) - Fixed f_close() invalidates the file object without volume lock. - Fixed volume lock is left acquired after return from f_closedir(). (appeared at R0.10) - Fixed creation of a directory entry with LFN fails on too many SFN collisions. (appeared at R0.07) - - -R0.10 (October 2, 2013) - Added an option for character encoding on the file. (_STRF_ENCODE) - Added f_closedir(). - Added forced full FAT scan option for f_getfree(). (_FS_NOFSINFO) - Added forced mount option with changes of f_mount(). - Improved behavior of volume auto detection. - Improved write throughput of f_puts() and f_printf(). - 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_open(), f_mkdir() and f_setlabel() can return incorrect result code on error. - - -R0.09b (January 24, 2013) - Added f_getlabel() and f_setlabel(). (_USE_LABEL = 1) - - -R0.09a (August 27, 2012) - Fixed assertion failure due to OS/2 EA on FAT12/16 volume. - Changed file functions reject null object pointer to avoid crash. - Changed option name _FS_SHARE to _FS_LOCK. - - -R0.09 (September 6, 2011) - f_mkfs() supports multiple partition on a physical drive. - Added f_fdisk(). (_MULTI_PARTITION = 2) - - -R0.08b (January 15, 2011) - Fast seek function is also applied to f_read() and f_write(). - f_lseek() reports required table size on creating CLMP. - Extended format syntax of f_printf(). - Ignores duplicated directory separators in given path names. - - -R0.08a (August 16, 2010) - Added f_getcwd(). (_FS_RPATH = 2) - Added sector erase function. (_USE_ERASE) - Moved file lock semaphore table from fs object to the bss. - Fixed a wrong directory entry is created on non-LFN cfg when the given name contains ';'. - Fixed f_mkfs() creates wrong FAT32 volume. - - -R0.08 (May 15, 2010) - Added a memory configuration option. (_USE_LFN) - Added support of file lock. (_FS_SHARE) - Added fast seek function. (_USE_FASTSEEK) - Changed some types on the API, XCHAR->TCHAR. - Changed fname member in the FILINFO structure on Unicode cfg. - String functions support UTF-8 encoding files on Unicode cfg. - - -R0.07e (November 3, 2009) - Separated out configuration options from ff.h to ffconf.h. - Added a configuration option, _LFN_UNICODE. - Fixed f_unlink() fails to remove a sub-dir on _FS_RPATH. - Fixed name matching error on the 13 char boundary. - Changed f_readdir() to return the SFN with always upper case on non-LFN cfg. - - -R0.07c (Junuary 21, 2009) - Fixed f_unlink() may return FR_OK on error. - Fixed wrong cache control in f_lseek(). - Added support of relative path. - Added f_chdir(). - Added f_chdrive(). - Added proper case conversion to extended characters. - - -R0.07a (April 14, 2009) - Separated out OS dependent code on re-entrant configuration. - Added multiple sector size support. - - -R0.07 (April 1, 2009) - Merged Tiny-FatFs into FatFs as a buffer configuration option. - Added long file name support. - Added multiple code page support. - Added re-entrancy for multitask operation. - Added auto cluster size selection to f_mkfs(). - Added rewind option to f_readdir(). - Changed result code of critical errors. - Renamed string functions to avoid name collision. - - -R0.06 (April 1, 2008) - Added f_forward. (Tiny-FatFs) - Added string functions: fgets, fputc, fputs and fprintf. - Improved performance of f_lseek on moving to the same or following cluster. - - -R0.05a (February 3, 2008) - Added f_truncate. - Added f_utime. - Fixed off by one error at FAT sub-type determination. - Fixed btr in f_read can be mistruncated. - Fixed cached sector is left not flushed when create and close without write. - - -R0.05 (August 26, 2007) - Changed arguments of f_read, f_write. - Changed arguments of f_mkfs. (FatFs) - Fixed f_mkfs on FAT32 creates incorrect FSInfo. (FatFs) - Fixed f_mkdir on FAT32 creates incorrect directory. (FatFs) - - -R0.04b (May 5, 2007) - Added _USE_NTFLAG option. - Added FSInfo support. - Fixed some problems corresponds to FAT32. (Tiny-FatFs) - Fixed DBCS name can result FR_INVALID_NAME. - Fixed short seek (<= csize) collapses the file object. - - -R0.04a (April 1, 2007) - Supported multiple partitions on a plysical drive. (FatFs) - Added minimization level 3. - Added a capability of extending file size to f_lseek. - Fixed an endian sensitive code in f_mkfs. (FatFs) - Fixed a problem corresponds to FAT32 support. (Tiny-FatFs) - - -R0.04 (February 4, 2007) - Supported multiple drive system. (FatFs) - Changed some APIs for multiple drive system. - Added f_mkfs. (FatFs) - Added _USE_FAT32 option. (Tiny-FatFs) - - -R0.03a (December 11, 2006) - Improved cluster scan algolithm to write files fast. - Fixed f_mkdir creates incorrect directory on FAT32. - - -R0.03 (September 22, 2006) - Added f_rename. - Changed option _FS_MINIMUM to _FS_MINIMIZE. - - -R0.02a (June 10, 2006) - Added a configuration option _FS_MINIMUM. - - -R0.02 (Jun 01, 2006) - Added FAT12. - Removed unbuffered mode. - Fixed a problem on small (<32M) patition. - - -R0.01 (April 29, 2006) - First release - - -R0.00 (February 26, 2006) - Prototype (not released) - diff --git a/vendor/fatfs/ff15b.zip b/vendor/fatfs/ff15b.zip new file mode 100644 index 0000000000000000000000000000000000000000..069a97055894e9e6c88552265624e09a3158b624 GIT binary patch literal 2381044 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
+tv)*cEkzW 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
AVL(0_JnY6ELX`aQ5infY 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