FATFS简介

BYTE csect; 扇区偏移

DWORD fptr; 读写指针

DWORD fsize;

DWORD org_clust; 文件开始簇

DWORD curr_clust; 当前簇

DWORD dsect; 文件当前扇区

#if !_FS_READONLY

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

BYTE* dir_ptr;

#endif

#if !_FS_TINY

BYTE buf[_MAX_SS];文件读写缓冲

#endif

} FIL;

typedef struct _FILINFO_ {

DWORD fsize;

WORD fdate;

WORD ftime;

BYTE fattrib;

char fname[13];

#if _USE_LFN

XCHAR* lfname;

int lfsize;

#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*); 删除目录中的一个文件

FRESULT f_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);

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

#if _USE_STRFUNC

int f_putc (int, FIL*);

int f_puts (const char*, FIL*);

int f_printf (FIL*, const char*, ...);

char* f_gets (char*, int, FIL*);

#define f_eof(fp) (((fp)->fptr == (fp)->fsize) ? 1 : 0)

#define f_error(fp) (((fp)->flag & FA__ERROR) ? 1 : 0)

#if _FS_REENTRANT //如果定义了重入，则需要实现以下四个函数

BOOL ff_cre_syncobj(BYTE, _SYNC_t*); 创建同步对象

BOOL ff_del_syncobj(_SYNC_t); 删除同步对象

BOOL ff_req_grant(_SYNC_t); 申请同步对象

void ff_rel_grant(_SYNC_t); 释放同步对象。

#endif

3、diskio.h文件

typedef BYTE DSTATUS;

typedef DRESULT; //首先定义了两个变量，各个函数都有用到。

BOOL assign_drives (int argc, char *argv[]); //这个函数不知道干吗

DSTATUS disk_initialize (BYTE); //磁盘初始化

DSTATUS disk_status (BYTE); //获取磁盘状态

DRESULT disk_read (BYTE, BYTE*, DWORD, BYTE);

#if _READONLY == 0

DRESULT disk_write (BYTE, const BYTE*, DWORD, BYTE);

#endif

DRESULT disk_ioctl (BYTE, BYTE, void*); //磁盘控制

接下来还有一些常数的定义，具体用到时在看。

4、diskio.c的结构

DSTATUS disk_initialize ( BYTE drv )

{

DSTATUS stat;

int result;

switch (drv) {

case ATA :

result = ATA_disk_initialize();

// translate the reslut code here

return stat;

case MMC :

result = MMC_disk_initialize();

// translate the reslut code here

return stat;

case USB :

result = USB_disk_initialize();

// translate the reslut code here

return stat;

}

return STA_NOINIT;

}

函数基本都像这样，drv表示磁盘的类型。没有实现，用户必须实现这部分代码。

5、ff.c文件简单浏览

#include "ff.h"

#include "diskio.h"

#define ENTER_FF(fs) { if (!lock_fs(fs)) return FR_TIMEOUT; } //获取文件系统同步对象，不成功返回超时，成功，继续执行。

#define LEAVE_FF(fs, res) { unlock_fs(fs, res); return res; } //释放文件系统同步对象。

Static FATFS *FatFs[_DRIVES]; //定义一个文件系统对象指针数组，当然一般我们也就用到一个元素。

Static WORD Lfn