文件系统源码分析文档格式.docx

1、移植时可以修改这部分代码，特别是某些定义与你所在工程的类型定义有冲突的时候。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 targ

2、et system./ 936 Simplified Chinese GBK （DBCS, OEM, Windows）跟据这个中国应该是936.打开option文件夹看一下。打开cc936.c文件，里面有一个很大的数组static const WCHAR uni2oem 。根据英文说明，这个数组用于unicode码和OEM码之间的相互转换。接下来又有两个函数ff_convert（）和ff_wtoupper（）具体执行码型转换和将字符转换为大写。XX一下：看OEM码什么意思。unicode是一种双字节字符编码，无论中文还是英文，或者其他语言统一到2个字节。与现有的任何编码（ASCII,GB等）都

3、不兼容。WindowsNT（2000）的内核即使用该编码，所有数据进入内核前转换成UNICODE,退出内核后在转换成版本相关的编码（通常称为OEM，在简体中文版下即为GB）.（XX所得）继续往下阅读。#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

4、 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,

5、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 081#define

6、_DF1E 0xFE#define _DS1S 040#define _DS1E 0x7E#define _DS2S 080#define _DS2E 0xFE接下来很大一部分都是与语言相关的因素，略过。/* Character code support macros */三个宏判断是否大写、小写、数字。#define IsUpper（c） （c）=A）&（c）=a=z#define IsDigit（c） （c）=0）&=9）#if _DF1S /* DBCS configuration */双字节编码相关的设定，暂时不理会它。#if _MULTI_PARTITION /* Multiple

7、partition configuration */该变量定义为1时，支持一个磁盘的多个分区。typedef struct _PARTITION BYTE pd; /* Physical drive# */ BYTE pt; /* Partition # （0-3） */ PARTITION;Extern const PARTITION Drives;/如果支持分区，则声明变量Drivers#define LD2PD（drv） （Drivesdrv.pd）/* 获得磁盘对应的物理磁盘#define LD2PT（drv） （Drivesdrv.pt）/*获得磁盘对应的分区#else /* Sin

8、gle 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/一般扇区长度取512字节。#define SS（fs） 512U#if _LFN_UNICODE & _USE_LFNtypedef WCHAR XCHAR; /* Unicode */ XCHAR是文件名的码型所用。#elsetyp

9、edef char XCHAR; /* SBCS, DBCS */#endiftypedef struct _FATFS_ BYTE fs_type; /* FAT sub type */ drive; /*对应实际驱动号01 */ csize; /* 每个簇的扇区数目 */先查一下簇的含义：应该是文件数据分配的基本单位。 n_fats; /* 文件分配表的数目 */FAT文件系统依次应该是：引导扇区、文件分配表两个、根目录区和数据区。 wflag; /* win dirty flag （1:must be written back） */文件是否改动的标志，为1时要回写。 WORD id;

10、/* File system mount ID 文件系统加载ID*/ n_rootdir; /* 根目录区目录项的数目 */#if _FS_REENTRANT _SYNC_t sobj; /* 允许重入，则定义同步对象 */#if _MAX_SS != 512 s_size; /* Sector size */#if !_FS_READONLY /文件为可写 fsi_flag; /* fsinfo dirty flag （1:/文件需要回写的标志 DWORD last_clust; /* Last allocated cluster */ free_clust; /* Number of fr

11、ee clusters */ fsi_sector; /* fsinfo sector */#if _FS_RPATH cdir; /* 使用相对路径，则要存储文件系统当前目录 sects_fat; /*文件分配表占用的扇区 max_clust; /* 最大簇数 fatbase; /*文件分配表开始扇区 dirbase; /* 如果是FAT32，根目录开始扇区需要首先得到。 database; /* 数据区开始扇区 winsect; /* Current sector appearing in the win */目前的扇区在win里面，这个win数组暂时还不知道含义。 win_MAX_SS;

12、/* Disk access window for Directory/FAT */这是一个win512数组，存储着一个扇区，好像作为扇区缓冲使用。 FATFS;typedef struct _DIR_ FATFS* fs;/* Pointer to the owner file system object */指向相应文件系统对象。 /* 文件系统加载ID*/ index; /* Current read/write index number */目前读写索引代码 sclust; /* Table start cluster （0:Static table） */文件数据区开始簇 clust

13、; /* Current cluster */ 目前处理的簇 sect; /* Current sector */ 目前簇里对应的扇区 BYTE* dir; /* Pointer to the current SFN entry in the win */ fn; /* Pointer to the SFN （in/out） file8,ext3,status1 */#if _USE_LFN WCHAR* lfn; /* Pointer to the LFN working buffer */ 指向长文件名缓冲。 lfn_idx; /* Last matched LFN index numbe

14、r （0xFFFF:No LFN） */ DIR;typedef struct _FIL_ /* Pointer to the owner file system object */ /* Owner file system mount ID */ flag; /* File status flags */文件状态标志 csect; /* Sector address in the cluster */扇区偏移 fptr; /* File R/W pointer */ 读写指针 fsize; /* File size */ org_clust; /* File start cluster */

15、文件开始簇 curr_clust; /* Current cluster */当前簇 dsect; /* Current data sector */文件当前扇区_FS_READONLY dir_sect; /* Sector containing the directory entry */该文件目录项对应所在的扇区 dir_ptr; /* Ponter to the directory entry in the window */_FS_TINY buf_MAX_SS;/* File R/W buffer */文件读写缓冲 FIL;/* File status structure */ty

16、pedef struct _FILINFO_ fdate; /* Last modified date */ ftime; /* Last modified time */ fattrib; /* Attribute */ char fname13; /* Short file name （8.3 format） */ XCHAR* lfname; /* Pointer to the LFN buffer */ int lfsize; /* Size of LFN buffer chrs */ FILINFO; 这个结构主要描述文件的状态信息，包括文件名13个字符（8+.+3+0）、属性、修改

17、时间等。接下来是函数的定义，先大概浏览一遍。FRESULT f_mount （BYTE, FATFS*）; /加载文件系统，BYTE参数是ID，后一个是文件系统定义。FRESULT f_open （FIL*, const XCHAR*, BYTE）;/打开文件，第一个参数是文件信息结构，第二个参数是文件名，第三是文件打开模式FRESULT f_read （FIL*, void*, UINT, UINT*）; /文件读取函数，参数1为文件对象（文件打开函数中得到），参数2为文件读取缓冲区，参数3为读取的字节数，参数4意义不清晰，等读到源代码就清楚了。FRESULT f_write （FIL*,

18、const void*, UINT, UINT*）;/写文件，参数跟读差不多FRESULT f_lseek （FIL*, DWORD）; /移动文件的读写指针，参数2应该是移动的数目。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 st

19、atus */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 */将缓冲区数据写回文件FRESULT f_unlink （const XCHAR*）; 删除目录中的一个文件FRESULT f_mkdir （const XCHAR*）; /*

20、 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 （FI

21、L*, UINT（*）（const BYTE*,UINT）, UINT, UINT*）; /* Forward data to the stream */ 这个函数还要提供一个回调函数。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 */应该说基本能明白这些函数用

22、于干什么。#if _USE_STRFUNCint 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） ?#if _FS_REENTRANT /如果定义了重入，则需要实现以下四个函数BOOL ff_cre_syncobj（BYTE, _SYNC_t*）; 创建同步对象BOOL ff_del_syncobj（_SYNC_t）; 删除同步对象BOOL ff_req_grant（_