當前位置：首頁 > 运维知识 > windows >内容正文

windows

FATFS文件系统框架及源码分析

發(fā)布時間：2025/6/15 windows 35 豆豆

生活随笔收集整理的這篇文章主要介紹了 FATFS文件系统框架及源码分析小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.

FATFS是一個為小型嵌入式系統(tǒng)設計的通用FAT(File Allocation Table)文件系統(tǒng)模塊。FatFs 的編寫遵循ANSI C，并且完全與磁盤I/O層分開。因此，它獨立(不依賴)于硬件架構。它可以被嵌入到低成本的微控制器中，如AVR, 8051, PIC, ARM, Z80, 68K 等等，而不需要做任何修改。

1.FatFS文件系統(tǒng)包含了文件

ff.h：文件系統(tǒng)實現(xiàn)頭文件，定義有文件系統(tǒng)所需的數(shù)據(jù)結(jié)構
diskio.h：底層驅(qū)動頭文件，就一些狀態(tài)宏的定義和底層驅(qū)動函數(shù)的申明
integer.h：僅實現(xiàn)數(shù)據(jù)類型重定義,增加系統(tǒng)的可移植性
ffconf.h：文件系統(tǒng)配置
ff.c：文件系統(tǒng)實現(xiàn)。
diskio.c ：底層驅(qū)動

2.源代碼閱讀次序：
先讀integer.h,了解所用的數(shù)據(jù)類型，然后是ff.h,了解文件系統(tǒng)所用的數(shù)據(jù)結(jié)構和各種函數(shù)聲明，
然后是diskio.h，了解與介質(zhì)相關的數(shù)據(jù)結(jié)構和操作函數(shù)。
再把ff.c和diskio.c兩個文件所實現(xiàn)的函數(shù)大致掃描一遍。
最后根據(jù)用戶應用層程序調(diào)用函數(shù)的次序仔細閱讀相關代碼。

3.FatFs 提供下面的函數(shù)API：
f_mount - 注冊/注銷一個工作區(qū)域（Work Area）
f_open - 打開/創(chuàng)建一個文件f_close - 關閉一個文件
f_read - 讀文件f_write - 寫文件
f_lseek - 移動文件讀/寫指針
f_truncate - 截斷文件
f_sync - 沖洗緩沖數(shù)據(jù) Flush Cached Data
f_opendir - 打開一個目錄
f_readdir - 讀取目錄條目
f_getfree - 獲取空閑簇 Get Free Clusters
f_stat - 獲取文件狀態(tài)
f_mkdir - 創(chuàng)建一個目錄
f_unlink - 刪除一個文件或目錄
f_chmod - 改變屬性（Attribute）
f_utime - 改變時間戳（Timestamp）
f_rename - 重命名/移動一個文件或文件夾
f_mkfs - 在驅(qū)動器上創(chuàng)建一個文件系統(tǒng)
f_forward - 直接轉(zhuǎn)移文件數(shù)據(jù)到一個數(shù)據(jù)流 Forward file data to the stream directly
f_gets - 讀一個字符串
f_putc - 寫一個字符
f_puts - 寫一個字符串
f_printf - 寫一個格式化的字符磁盤I/O接口
f_tell - 獲取當前讀/寫指針
f_eof - 測試一個文件是否到達文件末尾
f_size - 獲取一個文件大小
f_error - 測試一個文件是否出錯
因為FatFs模塊完全與磁盤I/O層分開，因此需要下面的函數(shù)來實現(xiàn)底層物理磁盤的讀寫與獲取當前時間。底層磁盤I/O模塊并不是FatFs的一部分，并且必須由用戶提供。
disk_initialize - Initialize disk drive 初始化磁盤驅(qū)動器
disk_status - Get disk status 獲取磁盤狀態(tài)
disk_read - Read sector(s) 讀扇區(qū)
disk_write - Write sector(s) 寫扇區(qū)
disk_ioctl - Control device dependent features 設備相關的控制特性
get_fattime - Get current time 獲取當前時間

4.FatFS系統(tǒng)特性
打開文件數(shù)量：無限制，與可用內(nèi)存有關。卷（volume）數(shù)量：最多10個。?
文件大小：與FAT規(guī)范有關（最大4G-1字節(jié)）。?
卷大小：與FAT規(guī)范有關（在512字節(jié)/扇區(qū)上，最大2T字節(jié)）?

簇（Cluster）大小：與FAT規(guī)范有關（在512字節(jié)/扇區(qū)上，最大64K字節(jié)）扇區(qū)（Sector）大小：與FAT規(guī)范有關（最大4K字節(jié)）

fatfs文件系統(tǒng)源碼分析

一、概述?

1、目的
在移植之前，先將源代碼大概的閱讀一遍，主要是了解文件系統(tǒng)的結(jié)構、各個函數(shù)的功能和接口、與移植相關的代碼等等。
2、準備工作
在官方網(wǎng)站下載了0.07c版本的源代碼，利用記事本進行閱讀。

二、源代碼的結(jié)構
1、源代碼組成
?? 源代碼壓縮包解壓后，共兩個文件夾，doc是說明，src里就是代碼。src文件夾里共五個文件和一個文件夾。文件夾是option，還有00readme.txt、diskio.c、diskio.h、ff.c、ff.h、integer.h。對比網(wǎng)上的文章，版本已經(jīng)不同了，已經(jīng)沒有所謂的tff.c和tff.h了，估計現(xiàn)在都采用條件編譯解決這個問題了，當然文件更少，可能編譯選項可能越復雜。

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代碼，這是個通用文件系統(tǒng)可以在各種介質(zhì)上使用。我們移植時針對具體存儲設備提供底層代碼。接下來做了版權聲明-可以自由使用和傳播。然后對版本的變遷做了說明。

3、源代碼閱讀次序
? 先讀integer.h,了解所用的數(shù)據(jù)類型，然后是ff.h,了解文件系統(tǒng)所用的數(shù)據(jù)結(jié)構和各種函數(shù)聲明，然后是diskio.h，了解與介質(zhì)相關的數(shù)據(jù)結(jié)構和操作函數(shù)。再把ff.c和diskio.c兩個文件所實現(xiàn)的函數(shù)大致掃描一遍。最后根據(jù)用戶應用層程序調(diào)用函數(shù)的次序仔細閱讀相關代碼。

三、源代碼閱讀
1、integer.h頭文件?
這個文件主要是類型聲明。以下是部分代碼。
typedef int??? INT;
typedef unsigned int UINT;
typedef signed char? CHAR;/* These types must be 8-bit integer */
都是用typedef做類型定義。移植時可以修改這部分代碼，特別是某些定義與你所在工程的類型定義有沖突的時候。

2、ff.h頭文件
以下是部分代碼的分析
#include “integer.h”?使用integer.h的類型定義
#ifndef _FATFS
#define _FATFS 0x007C??版本號007c，0.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)跟據(jù)這個中國應該是936.
打開option文件夾看一下。打開cc936.c文件，里面有一個很大的數(shù)組static const WCHAR uni2oem[] 。

根據(jù)英文說明，這個數(shù)組用于unicode碼和OEM碼之間的相互轉(zhuǎn)換。
接下來又有兩個函數(shù)ff_convert()和ff_wtoupper()具體執(zhí)行碼型轉(zhuǎn)換和將字符轉(zhuǎn)換為大寫。百度一下：看OEM碼什么意思。
unicode是一種雙字節(jié)字符編碼，無論中文還是英文，或者其他語言統(tǒng)一到2個字節(jié)。與現(xiàn)有的任何編碼（ASCII,GB等）都不兼容。WindowsNT(2000)的內(nèi)核即使用該編碼，所有數(shù)據(jù)進入內(nèi)核前轉(zhuǎn)換成UNICODE,退出內(nèi)核后在轉(zhuǎn)換成版本相關的編碼（通常稱為OEM，在簡體中文版下即為GB).（百度所得）
繼續(xù)往下閱讀。

#define _USE_LFN 1???//這個估計是長文件名支持了，以前的0.06版本好像是不支持。
#define _MAX_LFN 255?//最長支持255個雙字節(jié)字符。

#define _FS_RPATH 0??//是否文件相對路徑選項。
/* When _FS_RPATH is set to 1, relative path feature is enabled and f_chdir,
/? f_chdrive function are available.? //有些函數(shù)會受影響。
/? Note that output of the f_readdir fnction is affected by this option. */

#define _FS_REENTRANT 0??//如果要支持文件系統(tǒng)可重入，必須加入幾個函數(shù)。
#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 */?三個宏判斷是否大寫、小寫、數(shù)字。
#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 */雙字節(jié)編碼相關的設定，暫時不理會它。

#if _MULTI_PARTITION???????? /* Multiple partition configuration */

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

typedef struct _PARTITION {

?????? BYTE pd;???? /* Physical drive# */

?????? BYTE pt;????? /* Partition # (0-3) */

} PARTITION;

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

#define LD2PD(drv) (Drives[drv].pd)??????/* 獲得磁盤對應的物理磁盤

#define LD2PT(drv) (Drives[drv].pt)???????/*獲得磁盤對應的分區(qū)

#else???????????????????????????????????????? /* Single partition configuration */

#define LD2PD(drv) (drv)? /* Physical drive# is equal to the logical drive# */

#define LD2PT(drv) 0??????? /* Always mounts the 1st partition */

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

#define?? SS(fs)???? 512U

#if _LFN_UNICODE && _USE_LFN

typedef WCHAR XCHAR;?????? /* Unicode */ XCHAR是文件名的碼型所用。

#else

typedef char XCHAR;??????? /* SBCS, DBCS */

#endif

typedef struct _FATFS_ {

?????? BYTE??? fs_type;???????? /* FAT sub type */

?????? BYTE??? drive;???????????? /*對應實際驅(qū)動號01— */

?????? BYTE??? csize;???????????? /* 每個簇的扇區(qū)數(shù)目?*/

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

?????? BYTE??? n_fats;?????????? /*?文件分配表的數(shù)目?*/

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

?????? BYTE??? wflag;??????????? /* win[] dirty flag (1:must be written back) */

//文件是否改動的標志，為1時要回寫。

?????? WORD? id;???????????????? /* File system mount ID 文件系統(tǒng)加載ID*/

?????? WORD? n_rootdir;????? /* 根目錄區(qū)目錄項的數(shù)目?*/

#if _FS_REENTRANT

?????? _SYNC_t???? sobj;????????????? /* 允許重入，則定義同步對象?*/

#endif

#if _MAX_SS != 512

?????? WORD? s_size;?????????? /* Sector size */

#endif

#if !_FS_READONLY? //文件為可寫

?????? BYTE??? fsi_flag;?? /* fsinfo dirty flag (1:must be written back) */

//文件需要回寫的標志

?????? DWORD????? last_clust;????? /* Last allocated cluster */

?????? DWORD????? free_clust;????? /* Number of free clusters */

?????? DWORD????? fsi_sector;????? /* fsinfo sector */

#endif

#if _FS_RPATH

?????? DWORD????? cdir;????????????? /* 使用相對路徑，則要存儲文件系統(tǒng)當前目錄

#endif

?????? DWORD????? sects_fat;?????? /*文件分配表占用的扇區(qū)

?????? DWORD????? max_clust;???? /* 最大簇數(shù)

?????? DWORD????? fatbase;? /*文件分配表開始扇區(qū)

?????? DWORD????? dirbase;? /*? 如果是FAT32，根目錄開始扇區(qū)需要首先得到。

?????? DWORD????? database;?????? /* 數(shù)據(jù)區(qū)開始扇區(qū)

?????? DWORD????? winsect;? /* Current sector appearing in the win[] */

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

?????? BYTE??? win[_MAX_SS];/* Disk access window for Directory/FAT */

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

} FATFS;

typedef struct _DIR_ {

?????? FATFS* fs;/* Pointer to the owner file system object */指向相應文件系統(tǒng)對象。

?????? WORD? id;???????????????? /* 文件系統(tǒng)加載ID*/

?????? WORD? index;???? /* Current read/write index number */目前讀寫索引代碼

?????? DWORD????? sclust;???? /* Table start cluster (0:Static table) */文件數(shù)據(jù)區(qū)開始簇

?????? DWORD????? clust;???????????? /* Current cluster */ 目前處理的簇

?????? DWORD????? sect;????????????? /* Current sector */ 目前簇里對應的扇區(qū)

?????? BYTE*? dir;? /* Pointer to the current SFN entry in the win[] */

?????? BYTE*? fn;???????????????? /* Pointer to the SFN (in/out) {file[8],ext[3],status[1]} */

#if _USE_LFN

?????? WCHAR*???? lfn;?? /* Pointer to the LFN working buffer */ 指向長文件名緩沖。

?????? WORD? lfn_idx;?? /* Last matched LFN index number (0xFFFF:No LFN) */

#endif

} DIR;

typedef struct _FIL_ {

?????? FATFS* fs;????????????????? /* Pointer to the owner file system object */

?????? WORD? id;???????????????? /* Owner file system mount ID */

?????? BYTE??? flag;??????? /* File status flags */文件狀態(tài)標志

?????? BYTE??? csect;??????????? /* Sector address in the cluster */扇區(qū)偏移

?????? DWORD????? fptr;??????? /* File R/W pointer */ 讀寫指針

?????? DWORD????? fsize;????????????? /* File size */

?????? DWORD????? org_clust;????? /* File start cluster */文件開始簇

?????? DWORD????? curr_clust;???? /* Current cluster */當前簇

?????? DWORD????? dsect;??????????? /* Current data sector */文件當前扇區(qū)

#if !_FS_READONLY

?????? DWORD????? dir_sect; /* Sector containing the directory entry */該文件目錄項對應所在的扇區(qū)

?????? BYTE*? dir_ptr;?? /* Ponter to the directory entry in the window */

#endif

#if !_FS_TINY

?????? BYTE??? buf[_MAX_SS];/* File R/W buffer */文件讀寫緩沖

#endif

} FIL;

/* File status structure */

typedef struct _FILINFO_ {

?????? DWORD????? fsize;????????????? /* File size */

?????? WORD? fdate;???????????? /* Last modified date */

?????? WORD? ftime;???????????? /* Last modified time */

?????? BYTE??? fattrib;??? /* Attribute */

?????? char fname[13];???? /* Short file name (8.3 format) */

#if _USE_LFN

?????? XCHAR*????? lfname;????????? /* Pointer to the LFN buffer */

?????? int?? lfsize;???????????? /* Size of LFN buffer [chrs] */

#endif

} FILINFO; 這個結(jié)構主要描述文件的狀態(tài)信息，包括文件名13個字符（8+.+3+\0）、屬性、修改時間等。

接下來是函數(shù)的定義，先大概瀏覽一遍。

FRESULT f_mount (BYTE, FATFS*);??? //加載文件系統(tǒng)，BYTE參數(shù)是ID，后一個是文件系統(tǒng)定義。

FRESULT f_open (FIL*, const XCHAR*, BYTE);//打開文件，第一個參數(shù)是文件信息結(jié)構，第二個參數(shù)是文件名，第三是文件打開模式

FRESULT f_read (FIL*, void*, UINT, UINT*);?? //文件讀取函數(shù)，參數(shù)1為文件對象（文件打開函數(shù)中得到），參數(shù)2為文件讀取緩沖區(qū)，參數(shù)3為讀取的字節(jié)數(shù)，參數(shù)4意義不清晰，等讀到源代碼就清楚了。

FRESULT f_write (FIL*, const void*, UINT, UINT*);//寫文件，參數(shù)跟讀差不多

FRESULT f_lseek (FIL*, DWORD); //移動文件的讀寫指針，參數(shù)2應該是移動的數(shù)目。

FRESULT f_close (FIL*);??????????????? /* Close an open file object */

FRESULT f_opendir (DIR*, const XCHAR*);????? 打開目錄，返回目錄對象

FRESULT f_readdir (DIR*, FILINFO*);????????????? 讀取目錄，獲得文件信息

FRESULT f_stat (const XCHAR*, FILINFO*);??????????????????????? /* Get file status */

FRESULT f_getfree (const XCHAR*, DWORD*, FATFS**);?? /* Get number of free clusters on the drive */

FRESULT f_truncate (FIL*);?????????????????? /* Truncate file */

FRESULT f_sync (FIL*);?? /* Flush cached data of a writing file */將緩沖區(qū)數(shù)據(jù)寫回文件

FRESULT f_unlink (const XCHAR*);??????????? 刪除目錄中的一個文件

FRESULT???? f_mkdir (const XCHAR*);??????? /* Create a new directory */

FRESULT f_chmod (const XCHAR*, BYTE, BYTE); /* Change attriburte of the file/dir */

FRESULT f_utime (const XCHAR*, const FILINFO*);????? /* Change timestamp of the file/dir */

FRESULT f_rename (const XCHAR*, const XCHAR*);??? /* Rename/Move a file or directory */

FRESULT f_forward (FIL*, UINT(*)(const BYTE*,UINT), UINT, UINT*); /* Forward data to the stream */ 這個函數(shù)還要提供一個回調(diào)函數(shù)。

FRESULT f_mkfs (BYTE, BYTE, WORD);????????? /* Create a file system on the drive */

FRESULT f_chdir (const XCHAR*);????? /* Change current directory */改變當前目錄

FRESULT f_chdrive (BYTE);?????????? /* Change current drive */

應該說基本能明白這些函數(shù)用于干什么。

#if _USE_STRFUNC

int f_putc (int, FIL*);??????????????????????????????????????????????????? /* Put a character to the file */

int f_puts (const char*, FIL*);?????????????????????????????????????? /* Put a string to the file */

int f_printf (FIL*, const char*, …);???????????????????????? /* Put a formatted string to the file */

char* f_gets (char*, int, FIL*);????????????????????????????? /* Get a string from the file */

#define f_eof(fp) (((fp)->fptr == (fp)->fsize) ? 1 : 0)

#define f_error(fp) (((fp)->flag & FA__ERROR) ? 1 : 0)

#if _FS_REENTRANT? //如果定義了重入，則需要實現(xiàn)以下四個函數(shù)

BOOL ff_cre_syncobj(BYTE, _SYNC_t*); 創(chuàng)建同步對象

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;? //首先定義了兩個變量，各個函數(shù)都有用到。

BOOL assign_drives (int argc, char *argv[]); //這個函數(shù)不知道干嗎

DSTATUS disk_initialize (BYTE); //磁盤初始化

DSTATUS disk_status (BYTE); //獲取磁盤狀態(tài)

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*); //磁盤控制

接下來還有一些常數(shù)的定義，具體用到時在看。

4、diskio.c的結(jié)構

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;

}

函數(shù)基本都像這樣，drv表示磁盤的類型。沒有實現(xiàn)，用戶必須實現(xiàn)這部分代碼。

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; } //獲取文件系統(tǒng)同步對象，不成功返回超時，成功，繼續(xù)執(zhí)行。

#define?? LEAVE_FF(fs, res)???? { unlock_fs(fs, res); return res; } //釋放文件系統(tǒng)同步對象。

Static? FATFS *FatFs[_DRIVES]; //定義一個文件系統(tǒng)對象指針數(shù)組，當然一般我們也就用到一個元素。

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

下面都是函數(shù)的定義，很多只在內(nèi)部使用。

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++;

} //接下來還定義了幾個內(nèi)存操作的函數(shù)，這個函數(shù)實現(xiàn)了從一塊內(nèi)存到另一塊的復制，下面還有mem_set（）對一塊內(nèi)存進行清0或設置操作；mem_cmp（）比較內(nèi)存的多個字節(jié)是否相同，相同返回0；chk_chr（）檢測字符串中是否存在某個字符，存在則返回該字符。

FRESULT move_window (

?????? FATFS *fs,?????????? /* File system object */

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

)//簡單閱讀了一下源代碼，應該是改變文件系統(tǒng)的當前工作扇區(qū)，如果想要操作的扇區(qū)就是當前扇區(qū)，什么事不做；如果不是，則將原扇區(qū)寫回；如果是FAT表，還得寫入備份區(qū)。

這個函數(shù)內(nèi)部使用，外部無法引用。

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

?????? FATFS *fs???? /* File system object */

)//這個函數(shù)用于更新FAT32文件系統(tǒng)的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扇區(qū)

?????? return LD_DWORD(&fs->win[((WORD)clst * 4) & (SS(fs) - 1)]) & 0x0FFFFFFF; //這個函數(shù)應該是獲取簇的下一個連接簇。

綜合起來，這個函數(shù)應該是獲取下一簇，感覺這個函數(shù)名起得不太好。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 */

)//上個函數(shù)是獲取連接簇，這個是寫入新的連接信息。

FRESULT remove_chain (

?????? FATFS *fs,????????????????? /* File system object */

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

)//將下一簇號寫為0，也就是該文件的簇到此為止，同時系統(tǒng)的自由簇增加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. */

)//跟上一個相反，在該簇的位置寫入新的下一簇簇號。

DWORD clust2sect (? /* !=0: Sector number, 0: Failed – invalid cluster# */

?????? FATFS *fs,?????????? /* File system object */

?????? DWORD clst????????????? /* Cluster# to be converted */

) //這個函數(shù)是將簇號轉(zhuǎn)變?yōu)閷纳葏^(qū)號。

clst * fs->csize + fs->database; //這個是算法

FRESULT dir_seek (

?????? DIR *dj,??????? /* Pointer to directory object */

?????? WORD idx?????????? /* Directory index number */

)//這個函數(shù)的最終目的是根據(jù)索引號找到目錄項所在簇、所在扇區(qū)、并是目錄對象的對象指針指向文件系統(tǒng)對象窗口扇區(qū)的對應位置。

FRESULT dir_next (?? /* FR_OK:Succeeded, FR_NO_FILE:End of table, FR_DENIED:EOT and could not streach */

?????? DIR *dj,??????? /* Pointer to directory object */

?????? BOOL streach????? /* FALSE: Do not streach table, TRUE: Streach table if needed /

) //移動當前目錄項，根據(jù)索引，源代碼簡單看了一下，作用還不是很清晰，先放過。

接下來有5個函數(shù)與長文件名有關，這里先跳過。

FRESULT dir_find (

?????? DIR *dj??????????????? /* Pointer to the directory object linked to the file name */

)//

FRESULT dir_read (

?????? DIR *dj??????????????? /* Pointer to the directory object that pointing the entry to be read */

)

FRESULT dir_register (????? /* FR_OK:Successful, FR_DENIED:No free?entry or too many SFN collision, FR_DISK_ERR:Disk error */

?????? DIR *dj?????????????????????? /* Target directory with object name to be created */

)

FRESULT dir_remove (???? /* FR_OK: Successful, FR_DISK_ERR: A disk error */

?????? DIR *dj?????????????????????? /* Directory object pointing the entry to be removed */

)

//以上這些函數(shù)都是對目錄項的操作函數(shù)。

FRESULT create_name (

?????? DIR *dj,?????????????? /* Pointer to the directory object */

?????? const XCHAR **path? /* Pointer to pointer to the segment in the path string */)

//這個函數(shù)太長了，具體用到的時候再說吧。

void get_fileinfo (???????? /* No return code */

?????? DIR *dj,?????????????? /* Pointer to the directory object */

?????? FILINFO *fno????????? /* Pointer to store the file information */)

該函數(shù)用于獲取文件狀態(tài)信息。主要是從文件的目錄項中獲取信息。

FRESULT follow_path (???? /* FR_OK(0): successful, !=0: error code */

?????? DIR *dj,?????????????? /* Directory object to return last directory and found object */

?????? const XCHAR *path?? /* Full-path string to find a file or directory */

)

該函數(shù)給定一個全路徑，得到相應的目錄對象。

BYTE check_fs (? /* 0:The FAT boot record, 1:Valid boot record but not an FAT, 2:Not a boot record, 3:Error */

?????? FATFS *fs,??? /* File system object */

?????? DWORD sect????? /* Sector# (lba) to check if it is an FAT boot record or not */)

該函數(shù)用于讀取BOOT扇區(qū)，檢查是否FAT文件系統(tǒng)。

FRESULT auto_mount (???? /* FR_OK(0): successful, !=0: any error occured */

?????? const XCHAR **path,?????? /* Pointer to pointer to the path name (drive number) */

?????? FATFS **rfs,????????????? /* Pointer to pointer to the found file system object */

?????? BYTE chk_wp?????????????????? /* !=0: Check media write protection for write access */)

這個函數(shù)的功能不太明白。

FRESULT validate (??? /* FR_OK(0): The object is valid, !=0: Invalid */

?????? FATFS *fs,?????????? /* Pointer to the file system object */

?????? WORD id?????????????????? /* Member id of the target object to be checked */

)//檢查是否合法的文件系統(tǒng)。

FRESULT f_mount (

?????? BYTE vol,??????????? /* Logical drive number to be mounted/unmounted */

?????? FATFS *fs??????????? /* Pointer to new file system object (NULL for unmount)*/)

這是一個很重要的函數(shù)，裝載文件系統(tǒng)。也是從這個函數(shù)開始，對外輸出供用戶調(diào)用。

if (vol >= _DRIVES)現(xiàn)在只支持卷號0.

FatFs[vol] = fs;將參數(shù)文件系統(tǒng)對象指針賦給全局文件對象指針。

后面的函數(shù)主要是對文件和目錄進行操作，這里就不一一例舉了。

一、概述?
1、目的
在移植之前，先將源代碼大概的閱讀一遍，主要是了解文件系統(tǒng)的結(jié)構、各個函數(shù)的功能和接口、與移植相關的代碼等等。
2、準備工作
在官方網(wǎng)站下載了0.07c版本的源代碼，利用記事本進行閱讀。