码迷，mamicode.com
首页 > 其他好文 > 详细

ebox学习之SD & fat 配置

时间：2016-05-20 19:03:20      阅读：214      评论：0      收藏：0      [点我收藏+]

标签：

fatfs可配置项很多，相关的配置均在ffconfig.h文件中
    1. /*---------------------------------------------------------------------------/
    2. / Function Configurations 功能配置
    3. /---------------------------------------------------------------------------*/
    5. #define _FS_READONLY	0  //是否只读，只读模式下所有和写操作相关的api均被移除
    6. /* This option switches read-only configuration. (0:Read/Write or 1:Read-only)
    7. /  Read-only configuration removes writing API functions, f_write(), f_sync(),
    8. /  f_unlink(), f_mkdir(), f_chmod(), f_rename(), f_truncate(), f_getfree()
    9. /  and optional writing functions as well. */
    12. #define _FS_MINIMIZE	0 //通过移除基本API来裁剪代码，使代码最小
    13. /* This option defines minimization level to remove some basic API functions.
    14. /
    15. /   0: All basic functions are enabled. 所有基本功能有效
    16. /   1: f_stat(), f_getfree(), f_unlink(), f_mkdir(), f_chmod(), f_utime(),
    17. /      f_truncate() and f_rename() function are removed. 
    18. /   2: f_opendir(), f_readdir() and f_closedir() are removed in addition to 1.
    19. /      在1的基础上移除目录相关函数
    20. /   3: f_lseek() function is removed in addition to 2. 在2的基础上移除f_lseek函数 */
    23. #define	_USE_STRFUNC	0 // 是否使能字符串函数
    24. /* This option switches string functions, f_gets(), f_putc(), f_puts() and
    25. /  f_printf().
    26. /
    27. /  0: Disable string functions.
    28. /  1: Enable without LF-CRLF conversion. 使能字符串函数，但不包括LF-CRLF（不同系统下的换行）转换
    29. /  2: Enable with LF-CRLF conversion. */
    32. #define _USE_FIND		0  // 配置文件夹查找过滤及相关函数
    33. /* This option switches filtered directory read feature and related functions,
    34. /  f_findfirst() and f_findnext(). (0:Disable or 1:Enable) */
    36. #define	_USE_MKFS		0  
    2. /* This option switches f_mkfs() function. (0:Disable or 1:Enable) */
    5. #define	_USE_FASTSEEK	0 // 快速查找
    6. /* This option switches fast seek feature. (0:Disable or 1:Enable) */
    9. #define _USE_LABEL		0 // 磁盘卷标
    10. /* This option switches volume label functions, f_getlabel() and f_setlabel().
    11. /  (0:Disable or 1:Enable) */
    14. #define	_USE_FORWARD	0 // 数据流转法
    15. /* This option switches f_forward() function. (0:Disable or 1:Enable)
    16. /  To enable it, also _FS_TINY need to be set to 1. */
    19. /*---------------------------------------------------------------------------/
    20. / Locale and Namespace Configurations // 地区和命名空间配置
    21. /---------------------------------------------------------------------------*/
    23. #define _CODE_PAGE	932  // 配置目标系统OEM code
    24. /* This option specifies the OEM code page to be used on the target system.
    25. /  Incorrect setting of the code page can cause a file open failure.
    26. /  错误的配置会导致文件打开失败
    27. /   1   - ASCII (No extended character. Non-LFN cfg. only)
    28. /   437 - U.S.
    29. /   720 - Arabic
    30. /   737 - Greek
    31. /   771 - KBL
    32. /   775 - Baltic
    33. /   850 - Latin 1
    34. /   852 - Latin 2
    35. /   855 - Cyrillic
    36. /   857 - Turkish
    37. /   860 - Portuguese
    38. /   861 - Icelandic
    39. /   862 - Hebrew
    40. /   863 - Canadian French
    41. /   864 - Arabic
    42. /   865 - Nordic
    43. /   866 - Russian
    44. /   869 - Greek 2
    45. /   932 - Japanese (DBCS)
    46. /   936 - Simplified Chinese (DBCS)
    47. /   949 - Korean (DBCS)
    48. /   950 - Traditional Chinese (DBCS)
    49. */
    52. #define	_USE_LFN	0    // 长文件名
    53. #define	_MAX_LFN	255  // LFN缓冲区，LFN禁止时无效
    54. /* The _USE_LFN option switches the LFN feature.
    55. /
    56. /   0: Disable LFN feature. _MAX_LFN has no effect.
    57. /   1: Enable LFN with static working buffer on the BSS. Always NOT thread-safe. 
    58. /      启用LFN,并使用BSS上的静态缓冲区
    59. /   2: Enable LFN with dynamic working buffer on the STACK. 使用堆上的动态缓冲区
    60. /   3: Enable LFN with dynamic working buffer on the HEAP.
    61. /
    62. /  When enable the LFN feature, Unicode handling functions (option/unicode.c) must
    63. /  如果使用LFN功能，optin/unicode.c必须添加到工程里，
    64. /  be added to the project. The LFN working buffer occupies (_MAX_LFN + 1) * 2 bytes.
    65. /  When use stack for the working buffer, take care on stack overflow. When use heap
    66. /  memory for the working buffer, memory management functions, ff_memalloc() and
    67. /  ff_memfree(), must be added to the project. */
    70. #define	_LFN_UNICODE	0 // 编码类型
    71. /* This option switches character encoding on the API. (0:ANSI/OEM or 1:Unicode)
    72. /  To use Unicode string for the path name, enable LFN feature and set _LFN_UNICODE
    73. /  to 1. This option also affects behavior of string I/O functions. */
    76. #define _STRF_ENCODE	// 字符串I/O功能编码，仅在_LFN_UNICODE为1时有效
    77. /* When _LFN_UNICODE is 1, this option selects the character encoding on the file to
    78. /  be read/written via string I/O functions, f_gets(), f_putc(), f_puts and f_printf().
    79. /
    80. /  0: ANSI/OEM
    81. /  1: UTF-16LE
    82. /  2: UTF-16BE
    83. /  3: UTF-8
    84. /
    85. /  When _LFN_UNICODE is 0, this option has no effect. */
    88. #define _FS_RPATH	0 // 相对路径
    89. /* This option configures relative path feature.
    90. /
    91. /   0: Disable relative path feature and remove related functions.
    92. /   1: Enable relative path feature. f_chdir() and f_chdrive() are available.
    93. /   2: f_getcwd() function is available in addition to 1.
    94. /
    95. /  Note that directory items read via f_readdir() are affected by this option. */
    98. /*---------------------------------------------------------------------------/
    99. / Drive/Volume Configurations // 驱动器/卷标配置
    100. /---------------------------------------------------------------------------*/
    102. #define _VOLUMES	1
    103. /* Number of volumes (logical drives) to be used. */
    106. #define _STR_VOLUME_ID	0
    107. #define _VOLUME_STRS	"RAM","NAND","CF","SD1","SD2","USB1","USB2","USB3"
    108. /* _STR_VOLUME_ID option switches string volume ID feature.
    109. /  When _STR_VOLUME_ID is set to 1, also pre-defined strings can be used as drive
    110. /  number in the path name. _VOLUME_STRS defines the drive ID strings for each
    111. /  logical drives. Number of items must be equal to _VOLUMES. Valid characters for
    112. /  the drive ID strings are: A-Z and 0-9. */
    115. #define	_MULTI_PARTITION	0 // 多分区
    116. /* This option switches multi-partition feature. By default (0), each logical drive
    117. /  number is bound to the same physical drive number and only an FAT volume found on
    118. /  the physical drive will be mounted. When multi-partition feature is enabled (1),
    119. /  each logical drive number is bound to arbitrary physical drive and partition
    120. /  listed in the VolToPart[]. Also f_fdisk() funciton will be available. */
    123. #define	_MIN_SS		512  // 配置支持的扇区大小，硬盘和SD卡多为512.flash 和 光盘可能需要更大的
    124. #define	_MAX_SS		512
    125. /* These options configure the range of sector size to be supported. (512, 1024,
    126. /  2048 or 4096) Always set both 512 for most systems, all type of memory cards and
    127. /  harddisk. But a larger value may be required for on-board flash memory and some
    128. /  type of optical media. When _MAX_SS is larger than _MIN_SS, FatFs is configured
    129. /  to variable sector size and GET_SECTOR_SIZE command must be implemented to the
    130. /  disk_ioctl() function. */
    133. #define	_USE_TRIM	0
    134. /* This option switches ATA-TRIM feature. (0:Disable or 1:Enable)
    135. /  To enable Trim feature, also CTRL_TRIM command should be implemented to the
    136. /  disk_ioctl() function. */
    139. #define _FS_NOFSINFO	0 // 精确地剩余空间
    140. /* If you need to know correct free space on the FAT32 volume, set bit 0 of this
    141. /  option, and f_getfree() function at first time after volume mount will force
    142. /  a full FAT scan. Bit 1 controls the use of last allocated cluster number.
    143. /
    144. /  bit0=0: Use free cluster count in the FSINFO if available.
    145. /  bit0=1: Do not trust free cluster count in the FSINFO.
    146. /  bit1=0: Use last allocated cluster number in the FSINFO if available.
    147. /  bit1=1: Do not trust last allocated cluster number in the FSINFO.
    148. */
    152. /*---------------------------------------------------------------------------/
    153. / System Configurations 系统配置
    154. /---------------------------------------------------------------------------*/
    156. #define	_FS_TINY	0 // 最小缓冲区
    157. /* This option switches tiny buffer configuration. (0:Normal or 1:Tiny)
    158. /  At the tiny configuration, size of the file object (FIL) is reduced _MAX_SS
    159. /  bytes. Instead of private sector buffer eliminated from the file object,
    160. /  common sector buffer in the file system object (FATFS) is used for the file
    161. /  data transfer. */
    164. #define _FS_NORTC	0  // 是否使用时间戳 0-使用，1-禁止
    165. #define _NORTC_MON	1  // 禁用时间戳是使用预设的时间戳
    166. #define _NORTC_MDAY	1
    167. #define _NORTC_YEAR	2015
    168. /* The _FS_NORTC option switches timestamp feature. If the system does not have
    169. /  an RTC function or valid timestamp is not needed, set _FS_NORTC to 1 to disable
    170. /  the timestamp feature. All objects modified by FatFs will have a fixed timestamp
    171. /  defined by _NORTC_MON, _NORTC_MDAY and _NORTC_YEAR.
    172. /  When timestamp feature is enabled (_FS_NORTC == 0), get_fattime() function need
    173. /  to be added to the project to read current time form RTC. _NORTC_MON,
    174. /  _NORTC_MDAY and _NORTC_YEAR have no effect.  文件系统配置为只读时无效
    175. /  These options have no effect at read-only configuration (_FS_READONLY == 1). */
    178. #define	_FS_LOCK	0
    179. /* The _FS_LOCK option switches file lock feature to control duplicated file open
    180. /  and illegal operation to open objects. This option must be 0 when _FS_READONLY
    181. /  is 1.
    182. /
    183. /  0:  Disable file lock feature. To avoid volume corruption, application program
    184. /      should avoid illegal open, remove and rename to the open objects.
    185. /  >0: Enable file lock feature. The value defines how many files/sub-directories
    186. /      can be opened simultaneously under file lock control. Note that the file
    187. /      lock feature is independent of re-entrancy. */
    190. #define _FS_REENTRANT	0
    191. #define _FS_TIMEOUT		1000
    192. #define	_SYNC_t			HANDLE
    193. /* The _FS_REENTRANT option switches the re-entrancy (thread safe) of the FatFs
    194. /  module itself. Note that regardless of this option, file access to different
    195. /  volume is always re-entrant and volume control functions, f_mount(), f_mkfs()
    196. /  and f_fdisk() function, are always not re-entrant. Only file/directory access
    197. /  to the same volume is under control of this feature.
    198. /
    199. /   0: Disable re-entrancy. _FS_TIMEOUT and _SYNC_t have no effect.
    200. /   1: Enable re-entrancy. Also user provided synchronization handlers,
    201. /      ff_req_grant(), ff_rel_grant(), ff_del_syncobj() and ff_cre_syncobj()
    202. /      function, must be added to the project. Samples are available in
    203. /      option/syscall.c.
    204. /
    205. /  The _FS_TIMEOUT defines timeout period in unit of time tick.
    206. /  The _SYNC_t defines O/S dependent sync object type. e.g. HANDLE, ID, OS_EVENT*,
    207. /  SemaphoreHandle_t and etc.. A header file for O/S definitions needs to be
    208. /  included somewhere in the scope of ff.c. */
    211. #define _WORD_ACCESS	0 // 默认，一般不需要改
    212. /* The _WORD_ACCESS option is an only platform dependent option. It defines
    213. /  which access method is used to the word data on the FAT volume.
    214. /   Byte-By-Byte模式，可以用在所有平台   
    215. /   0: Byte-by-byte access. Always compatible with all platforms.
    216. /   1: Word access. Do not choose this unless under both the following conditions.
    217. /
    218. /  * Address misaligned memory access is always allowed to ALL instructions.
    219. /  * Byte order on the memory is little-endian.
    220. /
    221. /  If it is the case, _WORD_ACCESS can also be set to 1 to reduce code size.
    222. /  Following table shows allowable settings of some type of processors.
    223. /
    224. /  ARM7TDMI   0   *2          ColdFire   0    *1         V850E      0    *2
    225. /  Cortex-M3  0   *3          Z80        0/1             V850ES     0/1
    226. /  Cortex-M0  0   *2          x86        0/1             TLCS-870   0/1
    227. /  AVR        0/1             RX600(LE)  0/1             TLCS-900   0/1
    228. /  AVR32      0   *1          RL78       0    *2         R32C       0    *2
    229. /  PIC18      0/1             SH-2       0    *1         M16C       0/1
    230. /  PIC24      0   *2          H8S        0    *1         MSP430     0    *2
    231. /  PIC32      0   *1          H8/300H    0    *1         8051       0/1
    232. /
    233. /  *1:Big-endian. 大端模式
    234. /  *2:Unaligned memory access is not supported. 不支持非对齐访问
    235. /  *3:Some compilers generate LDM/STM for mem_cpy function. 某些编译器生成LDM/STM内存拷贝功能
    236. */
一般情况下，我们只要配置下面几项即可：
1  #define _FS_READONLY 如果不写入数据可以配置为只读
2 #define _USE_FIND 文件查找过滤
3 #define _CODE_PAGE 编码格式
4 #define _FS_NORTC 时间戳
5 #define _FS_RPATH 是否使用相对路径
6 #define _USE_LFN 0 是否使用长文件名




ebox学习之SD & fat 配置

标签：

原文地址：http://www.cnblogs.com/cat-li/p/5512880.html
踩
(0)
赞
(0)
   
举报
评论 一句话评论（0）
登录后才能评论！
分享档案
更多>
2021年07月29日 (22)
2021年07月28日 (40)
2021年07月27日 (32)
2021年07月26日 (79)
2021年07月23日 (29)
2021年07月22日 (30)
2021年07月21日 (42)
2021年07月20日 (16)
2021年07月19日 (90)
2021年07月16日 (35)
周排行
mamicode.com排行更多图片
更多
友情链接
兰亭集智   国之画   百度统计   站长统计   阿里云   chrome插件   新版天听网
关于我们 - 联系我们 - 留言反馈
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码！