FatFs模块程序移植手册(未完待续)

FatFs模块程序移植手册

1. 如何移植？

基本情况

FatFs模块假设有以下的移植条件

l ANSI C

FatFs模块是用ANSI C(89)书写的中间件。它不依赖于任何平台，只要编译器符合ANSI C就可以。

l Interger类型的大小

FatFs模块假设char/short/long类型的大小分别是8/16/32位并且int是16位或者32位。这些内容定义在integer.h文件中，这对于大多数编译器来说不成问题。当和现有定义发生任何冲突时，你必须要小心处理。

需要处理那些函数？

你只需要提供FatFs模块所需的低级别磁盘I/O函数。如果目标系统中已经存在一个磁盘模块在工作，你仅需要实现对应于FatFs模块的功能函数。否则的话，你需要移植一个磁盘模块并从头实现它。不是所有定义的函数都需要实现。比如，磁盘写入函数在只读模式下就不需要实现。下面的表格列出了根据配置选项哪些函数需要实现。

函数	什么时候需要实现	注意事项
disk_initialize disk_status disk_read	Always	磁盘I/O 函数。 Ffsample.zip中有示例。 网络上也有好多实现版本。
disk_write get_fattime disk_ioctl (CTRL_SYNC)	_FS_READONLY == 0
disk_ioctl (GET_SECTOR_COUNT) disk_ioctl (GET_BLOCK_SIZE)	_USE_MKFS == 1
disk_ioctl (GET_SECTOR_SIZE)	_MAX_SS > 512
disk_ioctl (CTRL_ERASE_SECTOR)	_USE_ERASE == 1
ff_convert ff_wtoupper	_USE_LFN >= 1	支持Unicode函数。
ff_cre_syncobj ff_del_syncobj ff_req_grant ff_rel_grant	_FS_REENTRANT == 1	系统依赖函数。
ff_mem_alloc ff_mem_free	_USE_LFN == 3

2. 限制

l FAT子类型：FAT12、FAT16和FAT32。

l 打开文件的数量：无限制，由系统可利用的内存来决定。

l 卷的数量：最多10个。

l 文件大小：依赖于FAT规格。（1-4G字节）

l 卷大小：依赖于FAT规格。（512字节/扇区时最高2T）

l 簇大小：依赖于FAT规格。（512字节/扇区时最高64K）

l 扇区大小：依赖于FAT规格。（最高4K字节）

3. 内存使用情况

	ARM7 32bit	ARM7 Thumb	Crotex-M3 Thumb-2	AVR	H8/300H	PIC24	RL78	V850ES	SH-2A	RX62N	IA-32
Compiler	GCC	GCC	GCC	GCC	CH38	C30	CC78K0R	CA850	SHC	RXC	VC6
_WORD_ACCESS	0	0	0	1	0	0	0	1	0	1	1
Text (Full, R/W)	10459	7201	6623	12646	10686	11466	12967	7732	8752	5747	7545
Text (Min, R/W)	6503	4745	4297	8306	6986	7440	8745	4938	5576	3746	4923
Text (Full, R/O)	4535	3181	2869	5960	4876	5286	6060	3554	3804	2659	3450
Text (Min, R/0)	3303	2493	2171	4366	3770	3984	4604	3684	2940	2025	2664
Bss	D*4 + 2	D*4 + 2	D*4 + 2	D*2 + 2	D*4 + 2	D*2 + 2	D*2 + 2	D*4 + 2	D*4 + 2	D*4 + 2	D*4 + 2
Work area (_FS_TINY == 0)	V*560 + F*550	V*560 + F*550	V*560 + F*550	V*560 + F*554	V*560 + F*550	V*560 + F*554	V*560 + F*554	V*560 + F*554	V*560 + F*554	V*560 + F*550	V*560 + F*550
Work area (_FS_TINY == 1)	V*560 + F*36	V*560 + F*36	V*560 + F*36	V*560 + F*32	V*560 + F*36	V*560 + F*32	V*560 + F*32	V*560 + F*36	V*560 + F*36	V*560 + F*36	V*560 + F*36

一些目标系统的内存使用情况有以下情况。内存大小以字节为单位。V代表挂载的卷的数量，F表示打开文件的数量。所有的示例都在代码大小上进行了优化。

_FS_READONLY     0 (R/W), 1 (R/O)
_FS_MINIMIZE     0 (Full function), 3 (Minimized function)
_USE_STRFUNC     0 (Disable string functions)
_USE_MKFS        0 (Disable f_mkfs function)
_USE_FORWARD     0 (Disable f_forward function)
_USE_FASTSEEK    0 (Disable fast seek feature)
_CODE_PAGE       932 (Japanese Shift-JIS)
_USE_LFN         0 (Disable LFN)
_MAX_SS          512 (Fixed sector size)
_FS_RPATH        0 (Disable relative path)
_VOLUMES         D (Number of logical drives to be used)
_MULTI_PARTITION 0 (Single partition per drive)
_FS_REENTRANT    0 (Disable reentrancy)
_FS_SHARE        0 (Disable shareing control)

4. 模块大小的减少

下表展示了根据配置选项可以移除的API函数，以减少模块大小。

Function

_FS_MINIMIZE

_FS_READONLY

_USE_STRFUNC

_FS_RPATH

_USE_MKFS

_USE_FORWARD

_MULTI_PARTITION

0

1

2

3

0

1

0

1/2

0

1

2

0

1

0

1

0/1

2

F_mout

F_open

F_close

F_read

F_write

X

F_sysn

X

F_lseek

X

F_opendir

X

X

F_readdir

X

X

F_stat

X

X

X

F_getfree

X

X

X

X

F_truncate

X

X

X

X

F_unlink

X

X

X

X

F_mkdir

X

X

X

X

F_chmod

X

X

X

X

F_utime

X

X

X

X

f_rename

X

X

x

X

F_chidir

X

F_chdrive

X

F_getcwd

X

x

F_mkfs

X

X

F_fdisk

X

X

x

F_forward

x

F_putc

X

x

F_puts

X

X

F_printf

X

X

F_gets

X

5. 长文件名

FatFs模块开始从R0.07版本开始支持长文件名。短文件名和长文件名两者的对于文件的区别除了f_readdir函数以外是透明的。设置_USE_LFN为1,2或者3来使能长文件名并且添加ff_convert()和ff_wtoupper()函数到工程中来支持unicode。长文件名特性额外需要一个特定的工作缓冲区。这个缓冲区大小可以根据内存的大小由_MAX_LFN来配置。长文件名的大小可达255个字节，所以_MAX_LFN需要设置为255以支持长文件名所有的特性操作。如果对于给定的文件名，工作缓冲区的大小不足的话，文件函数会返回FR_INVALID_NAME的错误值。当需要设置长文件名的重入特性时，_USE_LFN需要设置为2或者3。这时，文件函数从栈或者堆中申请工作缓冲区。工作缓冲区占用(_MAX_LFN+1)*2个字节。

6. Unicode API

7. 重入

8. 重复的文件访问

9. 有效文件访问的性能

10. 闪存介质的注意事项

11. 临界区

12. FatFs的许可

未完待续.....