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

FatFs 文件系统 API 函数详解 2016 年12 月22 日 本文详细介绍FatFs 文件系统接口函数（API ）的参数以及使用方法，部分函数配有使用范例，便于阅 读理解，可供相关人员作为参考。 FatFs 文件系统及其接口函数 一、简介 FatFS 是一个为小型嵌入式系统设计的通用FAT(File Allocation Table)文件系统模块。FatFs 的编写遵循ANSI C ，并且完全与 磁盘I/O 层分开。因此，它独立(不依赖)于硬件架构。它可以被嵌入到低成本的微控制器中，如AVR, 8051, PIC, ARM, Z80, 68K 等 等，而不需要做任何修改。 特点  Windows 兼容的FAT 文件系统  不依赖于平台，易于移植  代码和工作区占用空间非常小  多种配置选项： 多卷(物理驱动器和分区) 多ANSI/OEM 代码页，包括DBCS 在ANSI/OEM 或Unicode 中长文件名的支持 RTOS 的支持 多扇区大小的支持 只读，最少API ，I/O 缓冲区等等 二、应用程序接口 FatFs 模块为应用程序提供了下列函数，这些函数描述了FatFs 能对FAT 卷执行哪些操作。 1. f_mount 函数 1.1 功能 在FatFs 模块上注册/注销一个工作区(文件系统对象) 1.2 原型 FRESULT f_mount ( BYTE Drive, /* 逻辑驱动器号 */ FATFS* FileSystemObject /* 工作区指针 */ ); 1.3 参数 第1 页 共22 页 Drive：注册/注销工作区的逻辑驱动器号(0-9) 。 FileSystemObject：工作区(文件系统对象)指针。 返回值： FR_OK (0)函数成功。 FR_INVALID_DRIVE 驱动器号无效 1.4 详细描述 f_mount 函数在FatFs 模块上注册/注销一个工作区。 在使用任何其他文件函数之前，必须使用该函数为每个卷注册一个 工作区。要注销一个工作区，只要指定FileSystemObject 为NULL 即可，然后该工作区可以被丢弃。该函数只初始化给定的工 作区，以及将该工作区的地址注册到内部表中，不访问磁盘 I/O 层。卷装入过程是在f_mount 函数后或存储介质改变后的第 一次文件访问时完成的。 2. f_open 函数 2.1 功能 创建/打开一个用于访问文件的文件对象 2.2 原型 FRESULT f_open ( FIL* FileObject, /* 空白文件对象结构指针 */ const XCHAR* FileName, /* 文件名指针 */ BYTE ModeFlags /* 模式标志 */ ); 2.3 参数 FileObject：将被创建的文件对象结构的指针。 FileName：NULL 结尾的字符串指针，该字符串指定了将被创建或打开的文件名。 ModeFlags：指定文件的访问类型和打开方法。它是由下列标志的一个组合指定的。 模式 描述 指定读访问对象。可以从文件中读取数据。 FA_READ 与FA_WRITE 结合可以进行读写访问。 指定写访问对象。可以向文件中写入数据。 FA_WRITE 与FA_READ 结合可以进行读写访问。 FA_OPEN_EXISTING 打开文件。如果文件不存在，则打开失败。(默认) FA_OPEN_ALWAYS 如果文件存在，则打开；否则，创建一个新文件。 FA_CREATE_NEW 创建一个新文件。如果文件已存在，则创建失败。 FA_CREATE_ALWAYS 创建一个新文件。如果文件已存在，则它将被截断并覆盖。 注意：当 _FS_READONLY =