fatfs文件系统源码分析
一、概述
1、目的
在移植之前,先将源代码大概的阅读一遍,主要是了解文件系统的结构、各个函数的功能和接口、与移植相关的代码等等。
2、准备工作
在下载了0.07c版本的源代码,利用记事本进行阅读。
二、源代码的结构
1、源代码组成
  源代码压缩包解压后,共两个文件夹,doc是说明,src里就是代码。src文件夹里共五个文件和一个文件夹。文件夹是option,还有diskio.cdiskio.hff.cff.hinteger.h
对比网上的文章,版本已经不同了,已经没有所谓的tff.ctff.h了,估计现在都采用条件编译解决这个问题了,当然文件更少,可能编译选项可能越复杂。
2的说明
  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.cdiskio.c两个文件所实现的函数大致扫描一遍。最后根据用户应用层程序调用函数的次序仔细阅读相关代码。
三、源代码阅读
1integer.h头文件
这个文件主要是类型声明。以下是部分代码。
typedef int    INT;
typedef unsigned int UINT;
typedef signed char  CHAR;/* These types must be 8-bit integer */
都是用typedef做类型定义。移植时可以修改这部分代码,特别是某些定义与你所在工程的类型定义有冲突的时候。
2ff.h头文件
以下是部分代码的分析
#include integer.h 使用integer.h的类型定义
#ifndef _FATFS
#define _FATFS 0x007C  版本号007c0.07c
#define _WORD_ACCESS 0 //如果定义为1,则可以使用word访问。中间有一些看着说明很容易弄清楚意思。这里就不例举了。
#define _CODE_PAGE 936
/* The _CODE_PAGE specifies the OEM code page to be used on the target system.
/  936  – Simplified Chinese GBK (DBCS, OEM, Windows)跟据这个中国应该是936.
打开option文件夹看一下。打开cc936.c文件,里面有一个很大的数组static const WCHAR uni2oem[]
根据英文说明,这个数组用于unicode码和OEM码之间的相互转换。
接下来又有两个函数ff_convert()ff_wtoupper()具体执行码型转换和将字符转换为大写。百度一下:看OEMsystem的头文件码什么意思。
unicode是一种双字节字符编码,无论中文还是英文,或者其他语言统一到2个字节。与现有的任何编码(ASCII,GB等)都不兼容。WindowsNT(2000)的内核即使用该编码,所有数据进入内核前转换成UNICODE,退出内核后在转换成版本相关的编码(通常称为OEM,在简体中文版下即为GB).(百度所得)
继续往下阅读。
#define _USE_LFN 1   //这个估计是长文件名支持了,以前的0.06版本好像是不支持。
#define _MAX_LFN 255 //最长支持255个双字节字符。
#define _FS_RPATH 0  //是否文件相对路径选项。
/* When _FS_RPATH is set to 1, relative path feature is enabled and f_chdir,
/  f_chdrive function are available.  //有些函数会受影响。
/  Note that output of the f_readdir fnction is affected by this option. */
#define _FS_REENTRANT 0  //如果要支持文件系统可重入,必须加入几个函数。
#define _TIMEOUT  1000 /* Timeout period in unit of time ticks of the OS */
#define _SYNC_t  HANDLE /* Type of sync object used on the OS. e.g. HANDLE,
OS_EVENT*, ID and etc.. */
/* To make the FatFs module re-entrant, set _FS_REENTRANT to 1 and add user
/  provided synchronization handlers, ff_req_grant, ff_rel_grant, ff_del_syncobj
/  and ff_cre_syncobj function to the project. */
#elif _CODE_PAGE == 936 /* Simplified Chinese GBK */
#define _DF1S 0×81
#define _DF1E 0xFE
#define _DS1S 0×40
#define _DS1E 0x7E
#define _DS2S 0×80
#define _DS2E 0xFE
接下来很大一部分都是与语言相关的因素,略过。
/* Character code support macros */ 三个宏判断是否大写、小写、数字。
#define IsUpper(c) (((c)>=A')&&((c)<=Z'))
#define IsLower(c) (((c)>=a')&&((c)<=z'))
#define IsDigit(c) (((c)>=0)&&((c)<=9))
#if _DF1S    /* DBCS configuration */双字节编码相关的设定,暂时不理会它。
#if _MULTI_PARTITION        /* Multiple partition configuration */
//该变量定义为1时,支持一个磁盘的多个分区。
typedef struct _PARTITION {
      BYTE pd;    /* Physical drive# */
      BYTE pt;      /* Partition # (0-3) */
} PARTITION;
Extern  const  PARTITION Drives[];//如果支持分区,则声明变量Drivers 
#define LD2PD(drv) (Drives[drv].pd)      /* 获得磁盘对应的物理磁盘
#define LD2PT(drv) (Drives[drv].pt)       /*获得磁盘对应的分区
#else                                        /* Single partition configuration */