/* File system object structure (FATFS) */
typedef struct {
BYTE fs_type; /* FAT子类型,一般在mount时用,置0表示未挂载*/
BYTE drv; /* 物理驱动号,一般为0*/
BYTE csize; /* 每个簇的扇区数目(1,2,4...128) */
BYTE n_fats; /* 文件分配表的数目(1,2) */
/*FAT文件系统依次为:引导扇区、两个文件分配表、根目录区和数据区*/
BYTE wflag; /* 标记文件是否被改动过,为1时要回写*/
BYTE fsi_flag; /* 标记文件系统信息是否被改动过,为1时要回写*/
WORD id; /* 文件系统挂载ID */
WORD n_rootdir; /* 根目录区入口(目录项)的个数(用于FAT12/16)*/
#if _MAX_SS != 512
WORD ssize; /* 每扇区的字节数(用于扇区大于512Byte的flash) */
#endif
#if _FS_REENTRANT
_SYNC_t sobj; /* 允许重入,即定义同步对象,用在tiny中*/
#endif
#if !_FS_READONLY
DWORD last_clust; /* 最后一个被分配的簇*/
DWORD free_clust; /* 空闲簇的个数*/
DWORD fsi_sector; /* 存放fsinfo的扇区(用于FAT32) */
#endif
#if _FS_RPATH
DWORD cdir; /* 允许相对路径时用,存储当前目录起始簇(0:root)*/
#endif
DWORD n_fatent; /* FAT入口数(簇的数目 + 2)*/
DWORD fsize; /* 每个FAT所占扇区*/
DWORD fatbase; /* FAT起始扇区*/
DWORD dirbase; /* 根目录起始扇区(FAT32:Cluster#) */
DWORD database; /* 数据目录起始扇区*/
DWORD winsect; /* 当前缓冲区中存储的扇区号*/
BYTE win[_MAX_SS]; /* 单个扇区缓存*/
} FATFS;
文件结构
typedef struct {
FATFS* fs; /* 所在的fs指针*/
WORD id; /* 所在的fs挂载编号*/
BYTE flag; /* 文件状态*/
BYTE pad1; /* 不知道含义,也未见程序使用*/
DWORD fptr; /* 文件读写指针*/
DWORD fsize; /* 大小*/
DWORD sclust; /* 文件起始簇(fsize=0时为0) */
DWORD clust; /* 当前簇*/
DWORD dsect; /* 当前数据扇区*/
#if !_FS_READONLY
DWORD dir_sect; /* 包含目录项的扇区 */
BYTE* dir_ptr; /* Ponter to the directory entry in the window */
#endif
#if _USE_FASTSEEK
DWORD* cltbl; /*指向簇链接映射表的指针*/
#endif
#if _FS_SHARE
UINT lockid; /* File lock ID (index of file semaphore table) */
#endif
#if !_FS_TINY
BYTE buf[_MAX_SS]; /* File data read/write buffer */
#endif
} FIL;
目录结构
typedef struct {
FATFS* fs; /* 同上*/
WORD id;
WORD index; /* 当前读写索引号 */
DWORD sclust; /* 文件数据区开始簇*/
DWORD clust; /* 当前簇*/
DWORD sect; /* 当前扇区*/
BYTE* dir; /* 扇区缓存中当前SFN入口指针,SFN含义未知,猜测和LFN类似,与文件名相关*/
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