原创 FatFS源代码阅读分析（四）

3、diskio.h文件<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

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     /* Physical drive nmuber (0..) */)

{

       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"                     /* FatFs configurations and declarations */

#include "diskio.h"              /* Declarations of low level disk I/O functions */

#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,           /* File system object */

       DWORD sector   /* Sector number to make apperance in the fs->win[] */

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

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

FRESULT sync (  /* FR_OK: successful, FR_DISK_ERR: failed */

       FATFS *fs     /* File system object */

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

DWORD get_fat (       /* 0xFFFFFFFF:Disk error, 1:Interal error, Else:Cluster status */

       FATFS *fs,    /* File system object */

       DWORD clst       /* Cluster# to get the link information */

)

       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,    /* File system object */

       DWORD clst,      /* Cluster# to be changed in range of 2 to fs->max_clust - 1 */

       DWORD val /* New value to mark the cluster */

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

FRESULT remove_chain (

       FATFS *fs,                  /* File system object */

       DWORD clst                     /* Cluster# to remove a chain from */

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

DWORD create_chain (     /* 0:No free cluster, 1:Internal error, 0xFFFFFFFF:Disk error, >=2:New cluster# */

       FATFS *fs,                  /* File system object */

       DWORD clst                     /* Cluster# to stretch. 0 means create a new chain. */

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