FATFS是一個為小型嵌入式系統設計的通用FAT(File Allocation Table)文件系統模塊。FatFs 的編寫遵循ANSI C,並且完全與磁盤I/O層分開。因此,它獨立(不依賴)於硬件架構。它可以被嵌入到低成本的微控制器中,如AVR, 8051, PIC, ARM, Z80, 68K 等等,而不需要做任何修改。
FatFS文件系統包含了文件
ff.h :文件系統實現頭文件,定義有文件系統所需的數據結構
diskio.h :底層驅動頭文件,就一些狀態宏的定義和底層驅動函數的申明
integer.h:僅實現數據類型重定義,增加系統的可移植性
ffconf.h :文件系統配置
ff.c :文件系統實現。
diskio.c 底層驅動
FatFs 提供下面的函數API:
f_mount - 注冊/注銷一個工作區域(Work Area)
f_open - 打開/創建一個文件f_close - 關閉一個文件
f_read - 讀文件f_write - 寫文件
f_lseek - 移動文件讀/寫指針
f_truncate - 截斷文件
f_sync - 沖洗緩沖數據 Flush Cached Data
f_opendir - 打開一個目錄
f_readdir - 讀取目錄條目
f_getfree - 獲取空閑簇 Get Free Clusters
f_stat - 獲取文件狀態
f_mkdir - 創建一個目錄
f_unlink - 刪除一個文件或目錄
f_chmod - 改變屬性(Attribute)
f_utime - 改變時間戳(Timestamp)
f_rename - 重命名/移動一個文件或文件夾
f_mkfs - 在驅動器上創建一個文件系統
f_forward - 直接轉移文件數據到一個數據流 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層分開,因此需要下面的函數來實現底層物理磁盤的讀寫與獲取當前時間。底層磁盤I/O模塊並不是FatFs的一部分,並且必須由用戶提供。
disk_initialize - Initialize disk drive 初始化磁盤驅動器
disk_status - Get disk status 獲取磁盤狀態
disk_read - Read sector(s) 讀扇區
disk_write - Write sector(s) 寫扇區
disk_ioctl - Control device dependent features 設備相關的控制特性
get_fattime - Get current time 獲取當前時間
FatFS系統特性
打開文件數量:無限制,與可用內存有關。 卷(volume)數量:最多10個。
文件大小:與FAT規范有關(最大4G-1字節)。
卷大小:與FAT規范有關(在512字節/扇區上,最大2T字節)
簇(Cluster)大小:與FAT規范有關(在512字節/扇區上,最大64K字節) 扇區(Sector)大小:與FAT規范有關(最大4K字節)
創建文件並讀寫的使用例程
1)f_mount(0, &fatFS);
2)f_mkfs(0,1,512); //創建文件系統
FRESULT f_mkfs (
BYTE Drive,
BYTE PartitioningRule,
WORD AllocSize );
分區規則:當給定0時,首先在驅動器上的第一個扇區創建一個分區表,然后文件系統被創建在分區上。這被稱為FDISK格式化,用於硬盤和存儲卡。當給定1時,文件系統從第一個扇區開始創建,而沒有分區表。這被稱為超級軟盤(SFD)格式化,用於軟盤和可移動磁盤。
3)f_getfree("0:", &fre_clust, &fs2) //獲得磁盤存儲空間大小
4)f_open(&file1, "/srcfile.txt", FA_OPEN_ALWAYS | FA_READ | FA_WRITE); //打開文件
FIL file1;
5)f_puts(cDataBuf, &file1); //將cDataBuf[]數據寫入 文件srcfile.txt
6)f_sync (&file1); //刷新文件
7)f_lseek(&file1, 0); //從文件 偏移字節0出開始讀文件
8)f_read(&file1, buffer, 10,&r); //讀出10個字節到 buffer[]中
9)f_close(&file1); //操作完成 關閉文件
創建目錄例程
1) f_chdir("0:"); //切換到根目錄
2)f_mkdir("folder"); //創建目錄 folder
3)f_open(&file1, "folder/oldname2.txt", FA_CREATE_ALWAYS | FA_WRITE); //打開folder目錄下的文件
4)f_close(&file1); //關閉文件