FATFS简介

#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 LfnBuf[_MAX_LFN + 1]; //这个是与长文件名支持相关的。

#define NAMEBUF(sp,lp) BYTE sp[12]; WCHAR *lp = LfnBuf

#define INITBUF(dj,sp,lp) dj.fn = sp; dj.lfn = lp

下面都是函数的定义，很多只在内部使用。

Static void mem_cpy (void* dst, const void* src, int cnt) {

char *d = (char*)dst;

const char *s = (const char *)src;

while (cnt--) *d++ = *s++;

} //接下来还定义了几个内存操作的函数，这个函数实现了从一块内存到另一块的复制，下面还有mem_set（）对一块内存进行清0或设置操作；mem_cmp（）比较内存的多个字节是否相同，相同返回0；chk_chr（）检测字符串中是否存在某个字符，存在则返回该字符。

FRESULT move_window (

FATFS *fs,

DWORD sector

)//简单阅读了一下源代码，应该是改变文件系统的当前工作扇区，如果想要操作的扇区就是当前扇区，什么事不做；如果不是，则将原扇区写回；如果是FAT表，还得写入备份区。

这个函数内部使用，外部无法引用。

FRESULT sync (

FATFS *fs

)//这个函数用于更新FAT32文件系统的FSI_Sector。什么含义还不太清楚。

DWORD get_fat (

FATFS *fs,

DWORD clst

)

if (move_window(fs, fsect + (clst / (SS(fs) / 4)))) break; 获取簇号码对应的FAT扇区

return LD_DWORD(&fs->win[((WORD)clst * 4) & (SS(fs) - 1)]) & 0x0FFFFFFF; //这个函数应该是获取簇的下一个连接簇。

综合起来，这个函数应该是获取下一簇，感觉这个函数名起得不太好。get_nextcluster感觉更好一点。

FRESULT put_fat (

FATFS *fs,

DWORD clst,

DWORD val

)//上个函数是获取连接簇，这个是写入新的连接信息。

FRESULT remove_chain (

FATFS *fs,

DWORD clst

)//将下一簇号写为0，也就是该文件的簇到此为止，同时系统的自由簇增加1.

DWORD create_chain (

FATFS *fs,

DWORD clst

)//跟上一个相反，在该簇的位置写入新的下一簇簇号。

DWORD clust2sect (

FATFS *fs,

DWORD clst

) //这个函数是将簇号转变为对应的扇区号。

clst * fs->csize + fs->database; //这个是算法

FRESULT dir_seek (

DIR *dj,

WORD idx

)//这个函数的最终目的是根据索引号找到目录项所在簇、所在扇区、并是目录对象的对象指针指向文件系统对象窗口扇区的对应位置。

FRESULT dir_next (

DIR *dj,

BOOL streach

)//

FRESULT dir_read (

DIR *dj

)

FRESULT dir_register (

DIR *dj

)

FRESULT dir_remove (

DIR *dj

)

//以上这些函数都是对目录项的操作函数。

FRESULT create_name (

DIR *dj,

const XCHAR **path )

//这个函数太长了，具体用到的时候再说吧。

void get_fileinfo (

DIR *dj,

FILINFO *fno )

该函数用于获取文件状态信息。主要是从文件的目录项中获取信息。

FRESULT follow_path (

DIR *dj,

const XCHAR *path

)

该函数给定一个全路径，得到相应的目录对象。

BYTE check_fs (

FATFS *fs,

DWORD sect )

该函数用于读取BOOT扇区，检查是否FAT文件系统。

FRESULT auto_mount (

const XCHAR **path,

FATFS **rfs,

BYTE chk_wp )

这个函数的功能不太明白。

FRESULT validate (

FATFS *fs,

WORD id

)//检查是否合法的文件系统。

FRESULT f_mount (

BYTE vol,

FATFS *fs )

这是一个很重要的函数，装载文件系统。也是从这个函数开始，对外输出供用户调用。

if (vol >= _DRIVES)现在只支持卷号0.

FatFs[vol] = fs;将参数文件系统对象指针赋给全局文件对象指针。

后面的函数主要是对文件和目录进行操作，这里就不一一例举了。