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

来源：互联网发布：美工岗位要求编辑：程序博客网时间：2024/06/05 09:10

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

CH38

C30

CC78K0R

CA850

SHC

RXC

VC6

_WORD_ACCESS

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*2 + 2

D*4 + 2

D*2 + 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

1/2

0/1

F_mout

F_open

F_close

F_read

F_write

F_sysn

F_lseek

F_opendir

F_readdir

F_stat

F_getfree

F_truncate

F_unlink

F_mkdir

F_chmod

F_utime

f_rename

F_chidir

F_chdrive

F_getcwd

F_mkfs

F_fdisk

F_forward

F_putc

F_puts

F_printf

F_gets

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的许可

未完待续.....