first 2016/02 SDFileSystemDMA inherited from Official SDFileSystem.
Dependents: SDFileSystemDMA-test DmdFullRGB_0_1
Fork of SDFileSystemDMA by
SDFileSystemDMA is enhanced SDFileSystem library for STM32 micros by using DMA functionality.
Max read transfer rate reaches over 2MByte/sec at 24MHz SPI clock if enough read buffer size is set.
Even though minimum read buffer size (512Byte) is set, read transfer rate will reach over 1MByte/sec at 24MHz SPI Clock.
( but depends on the ability of each SD card)
Test program is here.
https://developer.mbed.org/users/mimi3/code/SDFileSystemDMA-test/
Supported SPI port is shown below table.
(v): Verified. It works well.
(w): Probably it will work well. (not tested)
(c): Only compiled. (not tested)
(f): Over flash.
(r): Only read mode. (when _FS_READONLY==1)
(u) Under construction
(z): Dose not work.
Caution
If your board has SRAM less than or equal to 8KB, the buffer size must be set to 512 Bytes.
Supported Boards:
Cortex-M0
Board | SRAM | SPI1 | SPI2 | SPI3 |
---|---|---|---|---|
NUCLEO-F030R8 | 8KB | (v) | ||
DISCO-F051R8 | 8KB | (w) | ||
4KB | (f) | |||
NUCLEO-F042K6 | 6KB | (r) | ||
NUCLEO-F070RB | 16KB | (w) | ||
NUCLEO-F072RB | 16KB | (w) | ||
NUCLEO-F091RC | 32KB | (c) |
Cortex-L0
Board | SRAM | SPI1 | SPI2 | SPI3 |
---|---|---|---|---|
DISCO-L053C8 | 8KB | (c) | ||
NUCLEO-L053R8 | 8KB | (c) | ||
NUCLEO-L073RZ | 20KB | (c) |
Cortex-M3
Board | SRAM | SPI1 | SPI2 | SPI3 |
---|---|---|---|---|
DISCO-F100RB | 8KB | (v) | (v) | - |
BLUEPILL-F103CB | 20KB | (w) | (w) | - |
NUCLEO-F103RB | 20KB | (v) | (v) | - |
NUCLEO-L152RE | 80KB | (v) | (w) | - |
MOTE-L152RC | 32KB | (w) | (w) | - |
Cortex-M4
F3
Board | SRAM | SPI1 | SPI2 | SPI3 |
---|---|---|---|---|
DISCO-F303VC | 40KB | - | (v) | (v) |
NUCLEO-F303RE | 64KB | (w) | (w) | (w) |
NUCLEO-F302R8 | 16KB | - | - | (c) |
NUCLEO-F303K8 | 12KB | (c) | - | - |
DISCO-F334C8 | 12KB | (c) | - | - |
NUCLEO-F334R8 | 12KB | (c) | - | - |
F4
Board | SPI1 | SPI2 | SPI3 |
---|---|---|---|
ELMO-F411RE | (w) | - | (w) |
MTS-MDOT-F411RE | (u) | - | (u) |
MTS-DRAGONFLY-F411RE | (w) | - | (w) |
NUCLEO-F411RE | (v) | - | (v) |
NUCLEO-F401RE | (w) | - | (w) |
MTS-MDOT-F405RG | (u) | - | (u) |
NUCLEO-F410RB | (c) | - | (c) |
NUCLEO-F446RE | (c) | - | (c) |
NUCLEO-F429ZI | (c) | - | (c) |
B96B-F446VE | (c) | - | (c) |
NUCLEO-F446ZE | (c) | - | (c) |
DISCO-F429ZI | (u) | - | (u) |
DISCO-F469NI | (c) | - | (c) |
Information
This library is set to use "short file name" in SDFileSystemDMA/FATFileSystem/ChaN/ffconf.h . ( _USE_LFN=0)
You can change this option to _USE_LFN=1 .
FATFileSystem/ChaN/ffconf.h@38:7077795dbf81, 2017-01-22 (annotated)
- Committer:
- mimi3
- Date:
- Sun Jan 22 23:13:11 2017 +0900
- Revision:
- 38:7077795dbf81
- Parent:
- 10:b48d3ace55db
change: table.md
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
mimi3 | 10:b48d3ace55db | 1 | /*---------------------------------------------------------------------------/ |
mimi3 | 10:b48d3ace55db | 2 | / FatFs - FAT file system module configuration file R0.11a (C)ChaN, 2015 |
mimi3 | 10:b48d3ace55db | 3 | /---------------------------------------------------------------------------*/ |
mimi3 | 10:b48d3ace55db | 4 | |
mimi3 | 10:b48d3ace55db | 5 | #define _FFCONF 64180 /* Revision ID */ |
mimi3 | 10:b48d3ace55db | 6 | |
mimi3 | 10:b48d3ace55db | 7 | #define FFS_DBG 0 |
mimi3 | 10:b48d3ace55db | 8 | |
mimi3 | 10:b48d3ace55db | 9 | /*---------------------------------------------------------------------------/ |
mimi3 | 10:b48d3ace55db | 10 | / Function Configurations |
mimi3 | 10:b48d3ace55db | 11 | /---------------------------------------------------------------------------*/ |
mimi3 | 10:b48d3ace55db | 12 | |
mimi3 | 10:b48d3ace55db | 13 | #define _FS_READONLY 0 |
mimi3 | 10:b48d3ace55db | 14 | /* This option switches read-only configuration. (0:Read/Write or 1:Read-only) |
mimi3 | 10:b48d3ace55db | 15 | / Read-only configuration removes writing API functions, f_write(), f_sync(), |
mimi3 | 10:b48d3ace55db | 16 | / f_unlink(), f_mkdir(), f_chmod(), f_rename(), f_truncate(), f_getfree() |
mimi3 | 10:b48d3ace55db | 17 | / and optional writing functions as well. */ |
mimi3 | 10:b48d3ace55db | 18 | |
mimi3 | 10:b48d3ace55db | 19 | |
mimi3 | 10:b48d3ace55db | 20 | #define _FS_MINIMIZE 0 |
mimi3 | 10:b48d3ace55db | 21 | /* This option defines minimization level to remove some basic API functions. |
mimi3 | 10:b48d3ace55db | 22 | / |
mimi3 | 10:b48d3ace55db | 23 | / 0: All basic functions are enabled. |
mimi3 | 10:b48d3ace55db | 24 | / 1: f_stat(), f_getfree(), f_unlink(), f_mkdir(), f_chmod(), f_utime(), |
mimi3 | 10:b48d3ace55db | 25 | / f_truncate() and f_rename() function are removed. |
mimi3 | 10:b48d3ace55db | 26 | / 2: f_opendir(), f_readdir() and f_closedir() are removed in addition to 1. |
mimi3 | 10:b48d3ace55db | 27 | / 3: f_lseek() function is removed in addition to 2. */ |
mimi3 | 10:b48d3ace55db | 28 | |
mimi3 | 10:b48d3ace55db | 29 | |
mimi3 | 10:b48d3ace55db | 30 | #define _USE_STRFUNC 0 |
mimi3 | 10:b48d3ace55db | 31 | /* This option switches string functions, f_gets(), f_putc(), f_puts() and |
mimi3 | 10:b48d3ace55db | 32 | / f_printf(). |
mimi3 | 10:b48d3ace55db | 33 | / |
mimi3 | 10:b48d3ace55db | 34 | / 0: Disable string functions. |
mimi3 | 10:b48d3ace55db | 35 | / 1: Enable without LF-CRLF conversion. |
mimi3 | 10:b48d3ace55db | 36 | / 2: Enable with LF-CRLF conversion. */ |
mimi3 | 10:b48d3ace55db | 37 | |
mimi3 | 10:b48d3ace55db | 38 | |
mimi3 | 10:b48d3ace55db | 39 | #define _USE_FIND 0 |
mimi3 | 10:b48d3ace55db | 40 | /* This option switches filtered directory read feature and related functions, |
mimi3 | 10:b48d3ace55db | 41 | / f_findfirst() and f_findnext(). (0:Disable or 1:Enable) */ |
mimi3 | 10:b48d3ace55db | 42 | |
mimi3 | 10:b48d3ace55db | 43 | |
mimi3 | 10:b48d3ace55db | 44 | #define _USE_MKFS 1 |
mimi3 | 10:b48d3ace55db | 45 | /* This option switches f_mkfs() function. (0:Disable or 1:Enable) */ |
mimi3 | 10:b48d3ace55db | 46 | |
mimi3 | 10:b48d3ace55db | 47 | |
mimi3 | 10:b48d3ace55db | 48 | #define _USE_FASTSEEK 0 |
mimi3 | 10:b48d3ace55db | 49 | /* This option switches fast seek feature. (0:Disable or 1:Enable) */ |
mimi3 | 10:b48d3ace55db | 50 | |
mimi3 | 10:b48d3ace55db | 51 | |
mimi3 | 10:b48d3ace55db | 52 | #define _USE_LABEL 0 |
mimi3 | 10:b48d3ace55db | 53 | /* This option switches volume label functions, f_getlabel() and f_setlabel(). |
mimi3 | 10:b48d3ace55db | 54 | / (0:Disable or 1:Enable) */ |
mimi3 | 10:b48d3ace55db | 55 | |
mimi3 | 10:b48d3ace55db | 56 | |
mimi3 | 10:b48d3ace55db | 57 | #define _USE_FORWARD 0 |
mimi3 | 10:b48d3ace55db | 58 | /* This option switches f_forward() function. (0:Disable or 1:Enable) |
mimi3 | 10:b48d3ace55db | 59 | / To enable it, also _FS_TINY need to be set to 1. */ |
mimi3 | 10:b48d3ace55db | 60 | |
mimi3 | 10:b48d3ace55db | 61 | |
mimi3 | 10:b48d3ace55db | 62 | /*---------------------------------------------------------------------------/ |
mimi3 | 10:b48d3ace55db | 63 | / Locale and Namespace Configurations |
mimi3 | 10:b48d3ace55db | 64 | /---------------------------------------------------------------------------*/ |
mimi3 | 10:b48d3ace55db | 65 | |
mimi3 | 10:b48d3ace55db | 66 | #define _CODE_PAGE 850 |
mimi3 | 10:b48d3ace55db | 67 | /* This option specifies the OEM code page to be used on the target system. |
mimi3 | 10:b48d3ace55db | 68 | / Incorrect setting of the code page can cause a file open failure. |
mimi3 | 10:b48d3ace55db | 69 | / |
mimi3 | 10:b48d3ace55db | 70 | / 1 - ASCII (No extended character. Non-LFN cfg. only) |
mimi3 | 10:b48d3ace55db | 71 | / 437 - U.S. |
mimi3 | 10:b48d3ace55db | 72 | / 720 - Arabic |
mimi3 | 10:b48d3ace55db | 73 | / 737 - Greek |
mimi3 | 10:b48d3ace55db | 74 | / 771 - KBL |
mimi3 | 10:b48d3ace55db | 75 | / 775 - Baltic |
mimi3 | 10:b48d3ace55db | 76 | / 850 - Latin 1 |
mimi3 | 10:b48d3ace55db | 77 | / 852 - Latin 2 |
mimi3 | 10:b48d3ace55db | 78 | / 855 - Cyrillic |
mimi3 | 10:b48d3ace55db | 79 | / 857 - Turkish |
mimi3 | 10:b48d3ace55db | 80 | / 860 - Portuguese |
mimi3 | 10:b48d3ace55db | 81 | / 861 - Icelandic |
mimi3 | 10:b48d3ace55db | 82 | / 862 - Hebrew |
mimi3 | 10:b48d3ace55db | 83 | / 863 - Canadian French |
mimi3 | 10:b48d3ace55db | 84 | / 864 - Arabic |
mimi3 | 10:b48d3ace55db | 85 | / 865 - Nordic |
mimi3 | 10:b48d3ace55db | 86 | / 866 - Russian |
mimi3 | 10:b48d3ace55db | 87 | / 869 - Greek 2 |
mimi3 | 10:b48d3ace55db | 88 | / 932 - Japanese (DBCS) |
mimi3 | 10:b48d3ace55db | 89 | / 936 - Simplified Chinese (DBCS) |
mimi3 | 10:b48d3ace55db | 90 | / 949 - Korean (DBCS) |
mimi3 | 10:b48d3ace55db | 91 | / 950 - Traditional Chinese (DBCS) |
mimi3 | 10:b48d3ace55db | 92 | */ |
mimi3 | 10:b48d3ace55db | 93 | |
mimi3 | 10:b48d3ace55db | 94 | |
mimi3 | 10:b48d3ace55db | 95 | #define _USE_LFN 0 |
mimi3 | 10:b48d3ace55db | 96 | #define _MAX_LFN 255 |
mimi3 | 10:b48d3ace55db | 97 | /* The _USE_LFN option switches the LFN feature. |
mimi3 | 10:b48d3ace55db | 98 | / |
mimi3 | 10:b48d3ace55db | 99 | / 0: Disable LFN feature. _MAX_LFN has no effect. |
mimi3 | 10:b48d3ace55db | 100 | / 1: Enable LFN with static working buffer on the BSS. Always NOT thread-safe. |
mimi3 | 10:b48d3ace55db | 101 | / 2: Enable LFN with dynamic working buffer on the STACK. |
mimi3 | 10:b48d3ace55db | 102 | / 3: Enable LFN with dynamic working buffer on the HEAP. |
mimi3 | 10:b48d3ace55db | 103 | / |
mimi3 | 10:b48d3ace55db | 104 | / When enable the LFN feature, Unicode handling functions (option/unicode.c) must |
mimi3 | 10:b48d3ace55db | 105 | / be added to the project. The LFN working buffer occupies (_MAX_LFN + 1) * 2 bytes. |
mimi3 | 10:b48d3ace55db | 106 | / When use stack for the working buffer, take care on stack overflow. When use heap |
mimi3 | 10:b48d3ace55db | 107 | / memory for the working buffer, memory management functions, ff_memalloc() and |
mimi3 | 10:b48d3ace55db | 108 | / ff_memfree(), must be added to the project. */ |
mimi3 | 10:b48d3ace55db | 109 | |
mimi3 | 10:b48d3ace55db | 110 | |
mimi3 | 10:b48d3ace55db | 111 | #define _LFN_UNICODE 0 |
mimi3 | 10:b48d3ace55db | 112 | /* This option switches character encoding on the API. (0:ANSI/OEM or 1:Unicode) |
mimi3 | 10:b48d3ace55db | 113 | / To use Unicode string for the path name, enable LFN feature and set _LFN_UNICODE |
mimi3 | 10:b48d3ace55db | 114 | / to 1. This option also affects behavior of string I/O functions. */ |
mimi3 | 10:b48d3ace55db | 115 | |
mimi3 | 10:b48d3ace55db | 116 | |
mimi3 | 10:b48d3ace55db | 117 | #define _STRF_ENCODE 3 |
mimi3 | 10:b48d3ace55db | 118 | /* When _LFN_UNICODE is 1, this option selects the character encoding on the file to |
mimi3 | 10:b48d3ace55db | 119 | / be read/written via string I/O functions, f_gets(), f_putc(), f_puts and f_printf(). |
mimi3 | 10:b48d3ace55db | 120 | / |
mimi3 | 10:b48d3ace55db | 121 | / 0: ANSI/OEM |
mimi3 | 10:b48d3ace55db | 122 | / 1: UTF-16LE |
mimi3 | 10:b48d3ace55db | 123 | / 2: UTF-16BE |
mimi3 | 10:b48d3ace55db | 124 | / 3: UTF-8 |
mimi3 | 10:b48d3ace55db | 125 | / |
mimi3 | 10:b48d3ace55db | 126 | / When _LFN_UNICODE is 0, this option has no effect. */ |
mimi3 | 10:b48d3ace55db | 127 | |
mimi3 | 10:b48d3ace55db | 128 | |
mimi3 | 10:b48d3ace55db | 129 | #define _FS_RPATH 0 |
mimi3 | 10:b48d3ace55db | 130 | /* This option configures relative path feature. |
mimi3 | 10:b48d3ace55db | 131 | / |
mimi3 | 10:b48d3ace55db | 132 | / 0: Disable relative path feature and remove related functions. |
mimi3 | 10:b48d3ace55db | 133 | / 1: Enable relative path feature. f_chdir() and f_chdrive() are available. |
mimi3 | 10:b48d3ace55db | 134 | / 2: f_getcwd() function is available in addition to 1. |
mimi3 | 10:b48d3ace55db | 135 | / |
mimi3 | 10:b48d3ace55db | 136 | / Note that directory items read via f_readdir() are affected by this option. */ |
mimi3 | 10:b48d3ace55db | 137 | |
mimi3 | 10:b48d3ace55db | 138 | |
mimi3 | 10:b48d3ace55db | 139 | /*---------------------------------------------------------------------------/ |
mimi3 | 10:b48d3ace55db | 140 | / Drive/Volume Configurations |
mimi3 | 10:b48d3ace55db | 141 | /---------------------------------------------------------------------------*/ |
mimi3 | 10:b48d3ace55db | 142 | |
mimi3 | 10:b48d3ace55db | 143 | #define _VOLUMES 1 |
mimi3 | 10:b48d3ace55db | 144 | /* Number of volumes (logical drives) to be used. */ |
mimi3 | 10:b48d3ace55db | 145 | |
mimi3 | 10:b48d3ace55db | 146 | |
mimi3 | 10:b48d3ace55db | 147 | #define _STR_VOLUME_ID 0 |
mimi3 | 10:b48d3ace55db | 148 | #define _VOLUME_STRS "RAM","NAND","CF","SD1","SD2","USB1","USB2","USB3" |
mimi3 | 10:b48d3ace55db | 149 | /* _STR_VOLUME_ID option switches string volume ID feature. |
mimi3 | 10:b48d3ace55db | 150 | / When _STR_VOLUME_ID is set to 1, also pre-defined strings can be used as drive |
mimi3 | 10:b48d3ace55db | 151 | / number in the path name. _VOLUME_STRS defines the drive ID strings for each |
mimi3 | 10:b48d3ace55db | 152 | / logical drives. Number of items must be equal to _VOLUMES. Valid characters for |
mimi3 | 10:b48d3ace55db | 153 | / the drive ID strings are: A-Z and 0-9. */ |
mimi3 | 10:b48d3ace55db | 154 | |
mimi3 | 10:b48d3ace55db | 155 | |
mimi3 | 10:b48d3ace55db | 156 | #define _MULTI_PARTITION 0 |
mimi3 | 10:b48d3ace55db | 157 | /* This option switches multi-partition feature. By default (0), each logical drive |
mimi3 | 10:b48d3ace55db | 158 | / number is bound to the same physical drive number and only an FAT volume found on |
mimi3 | 10:b48d3ace55db | 159 | / the physical drive will be mounted. When multi-partition feature is enabled (1), |
mimi3 | 10:b48d3ace55db | 160 | / each logical drive number is bound to arbitrary physical drive and partition |
mimi3 | 10:b48d3ace55db | 161 | / listed in the VolToPart[]. Also f_fdisk() funciton will be available. */ |
mimi3 | 10:b48d3ace55db | 162 | |
mimi3 | 10:b48d3ace55db | 163 | |
mimi3 | 10:b48d3ace55db | 164 | #define _MIN_SS 512 |
mimi3 | 10:b48d3ace55db | 165 | #define _MAX_SS 512 |
mimi3 | 10:b48d3ace55db | 166 | /* These options configure the range of sector size to be supported. (512, 1024, |
mimi3 | 10:b48d3ace55db | 167 | / 2048 or 4096) Always set both 512 for most systems, all type of memory cards and |
mimi3 | 10:b48d3ace55db | 168 | / harddisk. But a larger value may be required for on-board flash memory and some |
mimi3 | 10:b48d3ace55db | 169 | / type of optical media. When _MAX_SS is larger than _MIN_SS, FatFs is configured |
mimi3 | 10:b48d3ace55db | 170 | / to variable sector size and GET_SECTOR_SIZE command must be implemented to the |
mimi3 | 10:b48d3ace55db | 171 | / disk_ioctl() function. */ |
mimi3 | 10:b48d3ace55db | 172 | |
mimi3 | 10:b48d3ace55db | 173 | |
mimi3 | 10:b48d3ace55db | 174 | #define _USE_TRIM 0 |
mimi3 | 10:b48d3ace55db | 175 | /* This option switches ATA-TRIM feature. (0:Disable or 1:Enable) |
mimi3 | 10:b48d3ace55db | 176 | / To enable Trim feature, also CTRL_TRIM command should be implemented to the |
mimi3 | 10:b48d3ace55db | 177 | / disk_ioctl() function. */ |
mimi3 | 10:b48d3ace55db | 178 | |
mimi3 | 10:b48d3ace55db | 179 | |
mimi3 | 10:b48d3ace55db | 180 | #define _FS_NOFSINFO 0 |
mimi3 | 10:b48d3ace55db | 181 | /* If you need to know correct free space on the FAT32 volume, set bit 0 of this |
mimi3 | 10:b48d3ace55db | 182 | / option, and f_getfree() function at first time after volume mount will force |
mimi3 | 10:b48d3ace55db | 183 | / a full FAT scan. Bit 1 controls the use of last allocated cluster number. |
mimi3 | 10:b48d3ace55db | 184 | / |
mimi3 | 10:b48d3ace55db | 185 | / bit0=0: Use free cluster count in the FSINFO if available. |
mimi3 | 10:b48d3ace55db | 186 | / bit0=1: Do not trust free cluster count in the FSINFO. |
mimi3 | 10:b48d3ace55db | 187 | / bit1=0: Use last allocated cluster number in the FSINFO if available. |
mimi3 | 10:b48d3ace55db | 188 | / bit1=1: Do not trust last allocated cluster number in the FSINFO. |
mimi3 | 10:b48d3ace55db | 189 | */ |
mimi3 | 10:b48d3ace55db | 190 | |
mimi3 | 10:b48d3ace55db | 191 | |
mimi3 | 10:b48d3ace55db | 192 | |
mimi3 | 10:b48d3ace55db | 193 | /*---------------------------------------------------------------------------/ |
mimi3 | 10:b48d3ace55db | 194 | / System Configurations |
mimi3 | 10:b48d3ace55db | 195 | /---------------------------------------------------------------------------*/ |
mimi3 | 10:b48d3ace55db | 196 | |
mimi3 | 10:b48d3ace55db | 197 | #define _FS_TINY 0 |
mimi3 | 10:b48d3ace55db | 198 | /* This option switches tiny buffer configuration. (0:Normal or 1:Tiny) |
mimi3 | 10:b48d3ace55db | 199 | / At the tiny configuration, size of the file object (FIL) is reduced _MAX_SS |
mimi3 | 10:b48d3ace55db | 200 | / bytes. Instead of private sector buffer eliminated from the file object, |
mimi3 | 10:b48d3ace55db | 201 | / common sector buffer in the file system object (FATFS) is used for the file |
mimi3 | 10:b48d3ace55db | 202 | / data transfer. */ |
mimi3 | 10:b48d3ace55db | 203 | |
mimi3 | 10:b48d3ace55db | 204 | |
mimi3 | 10:b48d3ace55db | 205 | #define _FS_NORTC 0 |
mimi3 | 10:b48d3ace55db | 206 | #define _NORTC_MON 1 |
mimi3 | 10:b48d3ace55db | 207 | #define _NORTC_MDAY 1 |
mimi3 | 10:b48d3ace55db | 208 | #define _NORTC_YEAR 2015 |
mimi3 | 10:b48d3ace55db | 209 | /* The _FS_NORTC option switches timestamp feature. If the system does not have |
mimi3 | 10:b48d3ace55db | 210 | / an RTC function or valid timestamp is not needed, set _FS_NORTC to 1 to disable |
mimi3 | 10:b48d3ace55db | 211 | / the timestamp feature. All objects modified by FatFs will have a fixed timestamp |
mimi3 | 10:b48d3ace55db | 212 | / defined by _NORTC_MON, _NORTC_MDAY and _NORTC_YEAR. |
mimi3 | 10:b48d3ace55db | 213 | / When timestamp feature is enabled (_FS_NORTC == 0), get_fattime() function need |
mimi3 | 10:b48d3ace55db | 214 | / to be added to the project to read current time form RTC. _NORTC_MON, |
mimi3 | 10:b48d3ace55db | 215 | / _NORTC_MDAY and _NORTC_YEAR have no effect. |
mimi3 | 10:b48d3ace55db | 216 | / These options have no effect at read-only configuration (_FS_READONLY == 1). */ |
mimi3 | 10:b48d3ace55db | 217 | |
mimi3 | 10:b48d3ace55db | 218 | |
mimi3 | 10:b48d3ace55db | 219 | #define _FS_LOCK 0 |
mimi3 | 10:b48d3ace55db | 220 | /* The _FS_LOCK option switches file lock feature to control duplicated file open |
mimi3 | 10:b48d3ace55db | 221 | / and illegal operation to open objects. This option must be 0 when _FS_READONLY |
mimi3 | 10:b48d3ace55db | 222 | / is 1. |
mimi3 | 10:b48d3ace55db | 223 | / |
mimi3 | 10:b48d3ace55db | 224 | / 0: Disable file lock feature. To avoid volume corruption, application program |
mimi3 | 10:b48d3ace55db | 225 | / should avoid illegal open, remove and rename to the open objects. |
mimi3 | 10:b48d3ace55db | 226 | / >0: Enable file lock feature. The value defines how many files/sub-directories |
mimi3 | 10:b48d3ace55db | 227 | / can be opened simultaneously under file lock control. Note that the file |
mimi3 | 10:b48d3ace55db | 228 | / lock feature is independent of re-entrancy. */ |
mimi3 | 10:b48d3ace55db | 229 | |
mimi3 | 10:b48d3ace55db | 230 | |
mimi3 | 10:b48d3ace55db | 231 | #define _FS_REENTRANT 0 |
mimi3 | 10:b48d3ace55db | 232 | #define _FS_TIMEOUT 1000 |
mimi3 | 10:b48d3ace55db | 233 | #define _SYNC_t HANDLE |
mimi3 | 10:b48d3ace55db | 234 | /* The _FS_REENTRANT option switches the re-entrancy (thread safe) of the FatFs |
mimi3 | 10:b48d3ace55db | 235 | / module itself. Note that regardless of this option, file access to different |
mimi3 | 10:b48d3ace55db | 236 | / volume is always re-entrant and volume control functions, f_mount(), f_mkfs() |
mimi3 | 10:b48d3ace55db | 237 | / and f_fdisk() function, are always not re-entrant. Only file/directory access |
mimi3 | 10:b48d3ace55db | 238 | / to the same volume is under control of this feature. |
mimi3 | 10:b48d3ace55db | 239 | / |
mimi3 | 10:b48d3ace55db | 240 | / 0: Disable re-entrancy. _FS_TIMEOUT and _SYNC_t have no effect. |
mimi3 | 10:b48d3ace55db | 241 | / 1: Enable re-entrancy. Also user provided synchronization handlers, |
mimi3 | 10:b48d3ace55db | 242 | / ff_req_grant(), ff_rel_grant(), ff_del_syncobj() and ff_cre_syncobj() |
mimi3 | 10:b48d3ace55db | 243 | / function, must be added to the project. Samples are available in |
mimi3 | 10:b48d3ace55db | 244 | / option/syscall.c. |
mimi3 | 10:b48d3ace55db | 245 | / |
mimi3 | 10:b48d3ace55db | 246 | / The _FS_TIMEOUT defines timeout period in unit of time tick. |
mimi3 | 10:b48d3ace55db | 247 | / The _SYNC_t defines O/S dependent sync object type. e.g. HANDLE, ID, OS_EVENT*, |
mimi3 | 10:b48d3ace55db | 248 | / SemaphoreHandle_t and etc.. A header file for O/S definitions needs to be |
mimi3 | 10:b48d3ace55db | 249 | / included somewhere in the scope of ff.c. */ |
mimi3 | 10:b48d3ace55db | 250 | |
mimi3 | 10:b48d3ace55db | 251 | |
mimi3 | 10:b48d3ace55db | 252 | #define _WORD_ACCESS 0 |
mimi3 | 10:b48d3ace55db | 253 | /* The _WORD_ACCESS option is an only platform dependent option. It defines |
mimi3 | 10:b48d3ace55db | 254 | / which access method is used to the word data on the FAT volume. |
mimi3 | 10:b48d3ace55db | 255 | / |
mimi3 | 10:b48d3ace55db | 256 | / 0: Byte-by-byte access. Always compatible with all platforms. |
mimi3 | 10:b48d3ace55db | 257 | / 1: Word access. Do not choose this unless under both the following conditions. |
mimi3 | 10:b48d3ace55db | 258 | / |
mimi3 | 10:b48d3ace55db | 259 | / * Address misaligned memory access is always allowed to ALL instructions. |
mimi3 | 10:b48d3ace55db | 260 | / * Byte order on the memory is little-endian. |
mimi3 | 10:b48d3ace55db | 261 | / |
mimi3 | 10:b48d3ace55db | 262 | / If it is the case, _WORD_ACCESS can also be set to 1 to reduce code size. |
mimi3 | 10:b48d3ace55db | 263 | / Following table shows allowable settings of some type of processors. |
mimi3 | 10:b48d3ace55db | 264 | / |
mimi3 | 10:b48d3ace55db | 265 | / ARM7TDMI 0 *2 ColdFire 0 *1 V850E 0 *2 |
mimi3 | 10:b48d3ace55db | 266 | / Cortex-M3 0 *3 Z80 0/1 V850ES 0/1 |
mimi3 | 10:b48d3ace55db | 267 | / Cortex-M0 0 *2 x86 0/1 TLCS-870 0/1 |
mimi3 | 10:b48d3ace55db | 268 | / AVR 0/1 RX600(LE) 0/1 TLCS-900 0/1 |
mimi3 | 10:b48d3ace55db | 269 | / AVR32 0 *1 RL78 0 *2 R32C 0 *2 |
mimi3 | 10:b48d3ace55db | 270 | / PIC18 0/1 SH-2 0 *1 M16C 0/1 |
mimi3 | 10:b48d3ace55db | 271 | / PIC24 0 *2 H8S 0 *1 MSP430 0 *2 |
mimi3 | 10:b48d3ace55db | 272 | / PIC32 0 *1 H8/300H 0 *1 8051 0/1 |
mimi3 | 10:b48d3ace55db | 273 | / |
mimi3 | 10:b48d3ace55db | 274 | / *1:Big-endian. |
mimi3 | 10:b48d3ace55db | 275 | / *2:Unaligned memory access is not supported. |
mimi3 | 10:b48d3ace55db | 276 | / *3:Some compilers generate LDM/STM for mem_cpy function. |
mimi3 | 10:b48d3ace55db | 277 | */ |
mimi3 | 10:b48d3ace55db | 278 | |
mimi3 | 10:b48d3ace55db | 279 | #define FLUSH_ON_NEW_CLUSTER 0 /* Sync the file on every new cluster */ |
mimi3 | 10:b48d3ace55db | 280 | #define FLUSH_ON_NEW_SECTOR 1 /* Sync the file on every new sector */ |
mimi3 | 10:b48d3ace55db | 281 | /* Only one of these two defines needs to be set to 1. If both are set to 0 |
mimi3 | 10:b48d3ace55db | 282 | the file is only sync when closed. |
mimi3 | 10:b48d3ace55db | 283 | Clusters are group of sectors (eg: 8 sectors). Flushing on new cluster means |
mimi3 | 10:b48d3ace55db | 284 | it would be less often than flushing on new sector. Sectors are generally |
mimi3 | 10:b48d3ace55db | 285 | 512 Bytes long. */ |