FATFS简介

1、目的
在移植之前，先将源代码大概的阅读一遍，主要是了解文件系统的结构、各个函数的功能和接口、与移植

相关的代码等等。
2、准备工作
在官方网站下载了0.07c版本的源代码，利用记事本进行阅读。

二、源代码的结构
1、源代码组成
源代码压缩包解压后，共两个文件夹，doc是说明，src里就是代码。src文件夹里共五个文件和一个文

件夹。文件夹是option，还有00readme.txt、diskio.c、diskio.h、ff.c、ff.h、integer.h。对比网上

的文章，版本已经不同了，已经没有所谓的tff.c和tff.h了，估计现在都采用条件编译解决这个问题了，

当然文件更少，可能编译选项可能越复杂。

2、00readme.txt的说明
Low level disk I/O module is not included in this archive because the FatFs
module is only a generic file system layer and not depend on any specific
storage device. You have to provide a low level disk I/O module that written
to control your storage device.主要是说不包含底层IO代码，这是个通用文件系统可以在各种介质

上使用。我们移植时针对具体存储设备提供底层代码。
接下来做了版权声明-可以自由使用和传播。
然后对版本的变迁做了说明。

3、源代码阅读次序
先读integer.h,了解所用的数据类型，然后是ff.h,了解文件系统所用的数据结构和各种函数声明，然

后是diskio.h，了解与介质相关的数据结构和操作函数。再把ff.c和diskio.c两个文件所实现的函数大致

扫描一遍。最后根据用户应用层程序调用函数的次序仔细阅读相关代码。

三、源代码阅读
1、integer.h头文件
这个文件主要是类型声明。以下是部分代码。
typedef intINT;
typedef unsigned int UINT;
typedef signed charCHAR;
都是用typedef做类型定义。移植时可以修改这部分代码，特别是某些定义与你所在工程的类型定义有冲

突的时候。

2、ff.h头文件
以下是部分代码的分析
#include "integer.h" 使用integer.h的类型定义
#ifndef _FATFS
#define _FATFS 0x007C版本号007c，0.07c
#define _WORD_ACCESS 0 //如果定义为1，则可以使用word访问。
中间有一些看着说明很容易弄清楚意思。这里就不例举了。

#define _CODE_PAGE 936

#define _FS_REENTRANT 0//如果要支持文件系统可重入，必须加入几个函数。
#define _TIMEOUT1000
#define _SYNC_tHANDLE

#elif _CODE_PAGE == 936
#define _DF1S 0x81
#define _DF1E 0xFE
#define _DS1S 0x40
#define _DS1E 0x7E
#define _DS2S 0x80
#define _DS2E 0xFE
接下来很大一部分都是与语言相关的因素，略过。

三个宏判断是否大写、小写、数字。
#define IsUpper(c) (((c)>=A)&&((c)<=Z))
#define IsLower(c) (((c)>=a)&&((c)<=z))
#define IsDigit(c) (((c)>=0)&&((c)<=9))

#if _DF1S双字节编码相关的设定，暂时不理会它。

#if _MULTI_PARTITION

//该变量定义为1时，支持一个磁盘的多个分区。

typedef struct _PARTITION {

BYTE pd;

BYTE pt;

} PARTITION;

ExternconstPARTITION Drives[];//如果支持分区，则声明变量Drivers

#define LD2PD(drv) (Drives[drv].pd)

#define LD2PD(drv) (drv)

#define LD2PT(drv) 0

#if _MAX_SS == 512//一般扇区长度取512字节。

#defineSS(fs)512U

#if _LFN_UNICODE && _USE_LFN

typedef WCHAR XCHAR;XCHAR是文件名的码型所用。

#else

typedef char XCHAR;

#endif

typedef struct _FATFS_ {

BYTEfs_type;

BYTEdrive;

BYTEcsize;

先查一下簇的含义：应该是文件数据分配的基本单位。

BYTEn_fats;

FAT文件系统依次应该是：引导扇区、文件分配表两个、根目录区和数据区。

BYTEwflag;

//文件是否改动的标志，为1时要回写。

WORDid;

WORDn_rootdir;

#if _FS_REENTRANT

_SYNC_tsobj;

#endif

#if _MAX_SS != 512

WORDs_size;

#endif

#if !_FS_READONLY//文件为可写

BYTEfsi_flag;

//文件需要回写的标志

DWORDlast_clust;

DWORDfree_clust;

DWORDfsi_sector;

#endif

#if _FS_RPATH

DWORDcdir;

//目前的扇区在win[]里面，这个win[]数组暂时还不知道含义。

BYTEwin[_MAX_SS];

//这是一个win[512]数组，存储着一个扇区，好像作为扇区缓冲使用。

} FATFS;

typedef struct _DIR_ {

FATFS* fs;指向相应文件系统对象。

WORDid;

WORDindex;目前读写索引代码

DWORDsclust;文件数据区开始簇

DWORDclust;目前处理的簇

DWORDsect;目前簇里对应的扇区

BYTE*dir;

BYTE*fn;

#if _USE_LFN

WCHAR*lfn;指向长文件名缓冲。

WORDlfn_idx;

#endif

} DIR;

typedef struct _FIL_ {

FATFS* fs;

WORDid;

BYTEflag;文件状态标志

BYTEcsect;扇区偏移

DWORDfptr;读写指针

DWORDfsize;

DWORDorg_clust;文件开始簇

DWORDcurr_clust;当前簇

DWORDdsect;文件当前扇区

#if !_FS_READONLY

DWORDdir_sect; 该文件目录项对应所在的扇区

BYTE*dir_ptr;

#endif

#if !_FS_TINY

BYTEbuf[_MAX_SS];文件读写缓冲

#endif

} FIL;

typedef struct _FILINFO_ {

DWORDfsize;

WORDfdate;

WORDftime;

BYTEfattrib;

char fname[13];

#if _USE_LFN

XCHAR*lfname;

intlfsize;

#endif

} FILINFO; 这个结构主要描述文件的状态信息，包括文件名13个字符（8+.+3+）、属性、修改时间等。

接下来是函数的定义，先大概浏览一遍。

FRESULT f_mount (BYTE, FATFS*);//加载文件系统，BYTE参数是ID，后一个是文件系统定义。

FRESULT f_open (FIL*, const XCHAR*, BYTE);//打开文件，第一个参数是文件信息结构，第二个参数是文件名，第三是文件打开模式

FRESULT f_read (FIL*, void*, UINT, UINT*);//文件读取函数，参数1为文件对象（文件打开函数中得到），参数2为文件读取缓冲区，参数3为读取的字节数，参数4意义不清晰，等读到源代码就清楚了。

FRESULT f_write (FIL*, const void*, UINT, UINT*);//写文件，参数跟读差不多

FRESULT f_lseek (FIL*, DWORD); //移动文件的读写指针，参数2应该是移动的数目。

FRESULT f_close (FIL*);

FRESULT f_opendir (DIR*, const XCHAR*);打开目录，返回目录对象

FRESULT f_readdir (DIR*, FILINFO*);读取目录，获得文件信息

FRESULT f_stat (const XCHAR*, FILINFO*);

FRESULT f_getfree (const XCHAR*, DWORD*, FATFS**);

FRESULT f_truncate (FIL*);

FRESULT f_sync (FIL*);将缓冲区数据写回文件

FRESULT f_unlink (const XCHAR*);删除目录中的一个文件

FRESULTf_mkdir (const XCHAR*);

FRESULT f_chmod (const XCHAR*, BYTE, BYTE);

FRESULT f_utime (const XCHAR*, const FILINFO*);

FRESULT f_rename (const XCHAR*, const XCHAR*);

FRESULT f_forward (FIL*, UINT(*)(const BYTE*,UINT), UINT, UINT*); 这个函数还要提供一个回调函数。

FRESULT f_mkfs (BYTE, BYTE, WORD);

FRESULT f_chdir (const XCHAR*);改变当前目录

FRESULT f_chdrive (BYTE);

应该说基本能明白这些函数用于干什么。