FATFS简介
1、目的
在移植之前,先将源代码大概的阅读一遍,主要是了解文件系统的结构、各个函数的功能和接口、与移植
相关的代码等等。
2、准备工作
在官方网站下载了0.07c版本的源代码,利用记事本进行阅读。
二、源代码的结构
1、源代码组成
件夹。文件夹是option,还有00readme.txt、diskio.c、diskio.h、ff.c、ff.h、integer.h。对比网上
的文章,版本已经不同了,已经没有所谓的tff.c和tff.h了,估计现在都采用条件编译解决这个问题了,
当然文件更少,可能编译选项可能越复杂。
2、00readme.txt的说明
上使用。我们移植时针对具体存储设备提供底层代码。
3、源代码阅读次序
后是diskio.h,了解与介质相关的数据结构和操作函数。再把ff.c和diskio.c两个文件所实现的函数大致
扫描一遍。最后根据用户应用层程序调用函数的次序仔细阅读相关代码。
三、源代码阅读
1、integer.h头文件
这个文件主要是类型声明。以下是部分代码。
typedef int
typedef unsigned int UINT;
typedef signed char
都是用typedef做类型定义。移植时可以修改这部分代码,特别是某些定义与你所在工程的类型定义有冲
突的时候。
2、ff.h头文件
以下是部分代码的分析
#include "integer.h" 使用integer.h的类型定义
#ifndef _FATFS
#define _FATFS 0x007C
#define _WORD_ACCESS 0 //如果定义为1,则可以使用word访问。
中间有一些看着说明很容易弄清楚意思。这里就不例举了。
#define _CODE_PAGE 936
#define _FS_REENTRANT 0
#define _TIMEOUT
#define _SYNC_t
#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 {
} PARTITION;
Extern
#define LD2PD(drv) (Drives[drv].pd)
#define LD2PD(drv) (drv)
#define LD2PT(drv) 0
#if _MAX_SS == 512
#define
#if _LFN_UNICODE && _USE_LFN
typedef WCHAR XCHAR;
#else
typedef char XCHAR;
#endif
typedef struct _FATFS_ {
先查一下簇的含义:应该是文件数据分配的基本单位。
FAT文件系统依次应该是:引导扇区、文件分配表两个、根目录区和数据区。
//文件是否改动的标志,为1时要回写。
#if _FS_REENTRANT
#endif
#if _MAX_SS != 512
#endif
#if !_FS_READONLY
//文件需要回写的标志
#endif
#if _FS_RPATH
//目前的扇区在win[]里面,这个win[]数组暂时还不知道含义。
//这是一个win[512]数组,存储着一个扇区,好像作为扇区缓冲使用。
} FATFS;
typedef struct _DIR_ {
#if _USE_LFN
#endif
} DIR;
typedef struct _FIL_ {
#if !_FS_READONLY
#endif
#if !_FS_TINY
#endif
} FIL;
typedef struct _FILINFO_ {
#if _USE_LFN
#endif
} FILINFO; 这个结构主要描述文件的状态信息,包括文件名13个字符(8+.+3+ )、属性、修改时间等。
接下来是函数的定义,先大概浏览一遍。
FRESULT f_mount (BYTE, FATFS*);
FRESULT f_open (FIL*, const XCHAR*, BYTE);//打开文件,第一个参数是文件信息结构,第二个参数是文件名,第三是文件打开模式
FRESULT f_read (FIL*, void*, UINT, UINT*);
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
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);
应该说基本能明白这些函数用于干什么。
评论