新聞中心

FATFS簡介

作者: 時(shí)間:2016-11-25 來源:網(wǎng)絡(luò) 收藏
一、概述

1、目的
在移植之前,先將源代碼大概的閱讀一遍,主要是了解文件系統(tǒng)的結(jié)構(gòu)、各個(gè)函數(shù)的功能和接口、與移植

本文引用地址:http://butianyuan.cn/article/201611/321529.htm

相關(guān)的代碼等等。
2、準(zhǔn)備工作
在官方網(wǎng)站下載了0.07c版本的源代碼,利用記事本進(jìn)行閱讀。

二、源代碼的結(jié)構(gòu)
1、源代碼組成
源代碼壓縮包解壓后,共兩個(gè)文件夾,doc是說明,src里就是代碼。src文件夾里共五個(gè)文件和一個(gè)文

件夾。文件夾是option,還有00readme.txt、diskio.c、diskio.h、ff.c、ff.h、integer.h。對(duì)比網(wǎng)上

的文章,版本已經(jīng)不同了,已經(jīng)沒有所謂的tff.c和tff.h了,估計(jì)現(xiàn)在都采用條件編譯解決這個(gè)問題了,

當(dāng)然文件更少,可能編譯選項(xiàng)可能越復(fù)雜。

2、00readme.txt的說明
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代碼,這是個(gè)通用文件系統(tǒng)可以在各種介質(zhì)

上使用。我們移植時(shí)針對(duì)具體存儲(chǔ)設(shè)備提供底層代碼。
接下來做了版權(quán)聲明-可以自由使用和傳播。
然后對(duì)版本的變遷做了說明。

3、源代碼閱讀次序
先讀integer.h,了解所用的數(shù)據(jù)類型,然后是ff.h,了解文件系統(tǒng)所用的數(shù)據(jù)結(jié)構(gòu)和各種函數(shù)聲明,然

后是diskio.h,了解與介質(zhì)相關(guān)的數(shù)據(jù)結(jié)構(gòu)和操作函數(shù)。再把ff.c和diskio.c兩個(gè)文件所實(shí)現(xiàn)的函數(shù)大致

掃描一遍。最后根據(jù)用戶應(yīng)用層程序調(diào)用函數(shù)的次序仔細(xì)閱讀相關(guān)代碼。

三、源代碼閱讀
1、integer.h頭文件
這個(gè)文件主要是類型聲明。以下是部分代碼。
typedef int INT;
typedef unsigned int UINT;
typedef signed char CHAR;
都是用typedef做類型定義。移植時(shí)可以修改這部分代碼,特別是某些定義與你所在工程的類型定義有沖

突的時(shí)候。

2、ff.h頭文件
以下是部分代碼的分析
#include "integer.h" 使用integer.h的類型定義
#ifndef _FATFS
#define _FATFS 0x007C 版本號(hào)007c,0.07c
#define _WORD_ACCESS 0 //如果定義為1,則可以使用word訪問。
中間有一些看著說明很容易弄清楚意思。這里就不例舉了。

#define _CODE_PAGE 936

#define _FS_REENTRANT 0 //如果要支持文件系統(tǒng)可重入,必須加入幾個(gè)函數(shù)。
#define _TIMEOUT 1000
#define _SYNC_t HANDLE

#elif _CODE_PAGE == 936
#define _DF1S 0x81
#define _DF1E 0xFE
#define _DS1S 0x40
#define _DS1E 0x7E
#define _DS2S 0x80
#define _DS2E 0xFE
接下來很大一部分都是與語言相關(guān)的因素,略過。

三個(gè)宏判斷是否大寫、小寫、數(shù)字。
#define IsUpper(c) (((c)>=A)&&((c)<=Z))
#define IsLower(c) (((c)>=a)&&((c)<=z))
#define IsDigit(c) (((c)>=0)&&((c)<=9))

#if _DF1S 雙字節(jié)編碼相關(guān)的設(shè)定,暫時(shí)不理會(huì)它。

#if _MULTI_PARTITION

//該變量定義為1時(shí),支持一個(gè)磁盤的多個(gè)分區(qū)。

typedef struct _PARTITION {

BYTE pd;

BYTE pt;

} PARTITION;

Extern const PARTITION Drives[];//如果支持分區(qū),則聲明變量Drivers

#define LD2PD(drv) (Drives[drv].pd)

#define LD2PD(drv) (drv)

#define LD2PT(drv) 0

#if _MAX_SS == 512 //一般扇區(qū)長度取512字節(jié)。

#define SS(fs) 512U

#if _LFN_UNICODE && _USE_LFN

typedef WCHAR XCHAR; XCHAR是文件名的碼型所用。

#else

typedef char XCHAR;

#endif

typedef struct _FATFS_ {

BYTE fs_type;

BYTE drive;

BYTE csize;

先查一下簇的含義:應(yīng)該是文件數(shù)據(jù)分配的基本單位。

BYTE n_fats;

FAT文件系統(tǒng)依次應(yīng)該是:引導(dǎo)扇區(qū)、文件分配表兩個(gè)、根目錄區(qū)和數(shù)據(jù)區(qū)。

BYTE wflag;

//文件是否改動(dòng)的標(biāo)志,為1時(shí)要回寫。

WORD id;

WORD n_rootdir;

#if _FS_REENTRANT

_SYNC_t sobj;

#endif

#if _MAX_SS != 512

WORD s_size;

#endif

#if !_FS_READONLY //文件為可寫

BYTE fsi_flag;

//文件需要回寫的標(biāo)志

DWORD last_clust;

DWORD free_clust;

DWORD fsi_sector;

#endif

#if _FS_RPATH

DWORD cdir;

//目前的扇區(qū)在win[]里面,這個(gè)win[]數(shù)組暫時(shí)還不知道含義。

BYTE win[_MAX_SS];

//這是一個(gè)win[512]數(shù)組,存儲(chǔ)著一個(gè)扇區(qū),好像作為扇區(qū)緩沖使用。

} FATFS;

typedef struct _DIR_ {

FATFS* fs;指向相應(yīng)文件系統(tǒng)對(duì)象。

WORD id;

WORD index; 目前讀寫索引代碼

DWORD sclust; 文件數(shù)據(jù)區(qū)開始簇

DWORD clust; 目前處理的簇

DWORD sect; 目前簇里對(duì)應(yīng)的扇區(qū)

BYTE* dir;

BYTE* fn;

#if _USE_LFN

WCHAR* lfn; 指向長文件名緩沖。

WORD lfn_idx;

#endif

} DIR;

typedef struct _FIL_ {

FATFS* fs;

WORD id;

BYTE flag; 文件狀態(tài)標(biāo)志

BYTE csect; 扇區(qū)偏移

DWORD fptr; 讀寫指針

DWORD fsize;

DWORD org_clust; 文件開始簇

DWORD curr_clust; 當(dāng)前簇

DWORD dsect; 文件當(dāng)前扇區(qū)

#if !_FS_READONLY

DWORD dir_sect; 該文件目錄項(xiàng)對(duì)應(yīng)所在的扇區(qū)

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; 這個(gè)結(jié)構(gòu)主要描述文件的狀態(tài)信息,包括文件名13個(gè)字符(8+.+3+