FatFs文件系统及其接口函数详解.pdf

《FatFs文件系统及其接口函数详解.pdf》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、FatFs文件系统API函数详解2016年12月22日本文详细介绍FatFs文件系统接口函数（API）的参数以及使用方法，部分函数配有使用范例，便于阅读理解，可供相关人员作为参考。FatFs文件系统及其接口函数一、简介FatFS是一个为小型嵌入式系统设计的通用FAT(FileAllocationTable)文件系统模块。FatFs的编写遵循ANSIC，并且完全与磁盘I/O层分开。因此，它独立(不依赖)于硬件架构。它可以被嵌入到低成本的微控制器中，如AVR,8051,PIC,ARM,Z80,68K等等，而不需

2、要做任何修改。特点Windows兼容的FAT文件系统不依赖于平台，易于移植代码和工作区占用空间非常小多种配置选项：多卷(物理驱动器和分区)多ANSI/OEM代码页，包括DBCS在ANSI/OEM或Unicode中长文件名的支持RTOS的支持多扇区大小的支持只读，最少API，I/O缓冲区等等二、应用程序接口FatFs模块为应用程序提供了下列函数，这些函数描述了FatFs能对FAT卷执行哪些操作。1.f_mount函数1.1功能在FatFs模块上注册/注销一个工作区(文件系统对象)1.2原型FRESUL

3、Tf_mount(BYTEDrive,/*逻辑驱动器号*/FATFS*FileSystemObject/*工作区指针*/);1.3参数第1页共22页Drive：注册/注销工作区的逻辑驱动器号(0-9)。FileSystemObject：工作区(文件系统对象)指针。返回值：FR_OK(0)函数成功。FR_INVALID_DRIVE驱动器号无效1.4详细描述f_mount函数在FatFs模块上注册/注销一个工作区。在使用任何其他文件函数之前，必须使用该函数为每个卷注册一个工作区。要注销一个工作区，只要指定Fil

4、eSystemObject为NULL即可，然后该工作区可以被丢弃。该函数只初始化给定的工作区，以及将该工作区的地址注册到内部表中，不访问磁盘I/O层。卷装入过程是在f_mount函数后或存储介质改变后的第一次文件访问时完成的。2.f_open函数2.1功能创建/打开一个用于访问文件的文件对象2.2原型FRESULTf_open(FIL*FileObject,/*空白文件对象结构指针*/constXCHAR*FileName,/*文件名指针*/BYTEModeFlags/*模式标志*/);2.3参数FileO

5、bject：将被创建的文件对象结构的指针。FileName：NULL结尾的字符串指针，该字符串指定了将被创建或打开的文件名。ModeFlags：指定文件的访问类型和打开方法。它是由下列标志的一个组合指定的。模式描述指定读访问对象。可以从文件中读取数据。FA_READ与FA_WRITE结合可以进行读写访问。指定写访问对象。可以向文件中写入数据。FA_WRITE与FA_READ结合可以进行读写访问。FA_OPEN_EXISTING打开文件。如果文件不存在，则打开失败。(默认)FA_OPEN_ALWAYS如果文件

6、存在，则打开；否则，创建一个新文件。FA_CREATE_NEW创建一个新文件。如果文件已存在，则创建失败。FA_CREATE_ALWAYS创建一个新文件。如果文件已存在，则它将被截断并覆盖。注意：当_FS_READONLY==1时，模式标志FA_WRITE,FA_CREATE_ALWAYS,FA_CREATE_NEW,FA_OPEN_ALWAYS是无效的。返回值FR_OK(0)函数成功，该文件对象有效。FR_NO_FILE找不到该文件。FR_NO_PATH找不到该路径。FR_INVALID_NAME文件名无

7、效。FR_INVALID_DRIVE驱动器号无效。FR_EXIST该文件已存在。FR_DENIED由于下列原因，所需的访问被拒绝：以写模式打开一个只读文件。第2页共22页由于存在一个同名的只读文件或目录，而导致文件无法被创建。由于目录表或磁盘已满，而导致文件无法被创建。FR_NOT_READY由于驱动器中没有存储介质或任何其他原因，而导致磁盘驱动器无法工作。FR_WRITE_PROTECTED在存储介质被写保护的情况下，以写模式打开或创建文件对象。FR_DISK_ERR由于底层磁盘I/O接口函数中的一

8、个错误，而导致该函数失败。FR_INT_ERR由于一个错误的FAT结构或一个内部错误，而导致该函数失败。FR_NOT_ENABLED逻辑驱动器没有工作区。FR_NO_FILESYSTEM磁盘上没有有效地FAT卷。2.4详细描述如果函数成功，则创建一个文件对象。该文件对象被后续的读/写函数用来访问文件。如果想要关闭一个打开的文件对象，则使用f_close函数。如果不关闭修改后的文件，那么文件可能会崩溃。在使用任何文