来源：http://blog.chinaunix.net/uid-20766895-id-2827635.html

FATFS是一个为小型嵌入式系统设计的通用FAT(File Allocation Table)文件系统模块。FatFs 的编写遵循ANSI C，并且完全与磁盘I/O层分开。因此，它独立(不依赖)于硬件架构。它可以被嵌入到低成本的微控制器中，如AVR, 8051, PIC, ARM, Z80, 68K 等等，而不需要做任何修改。  

    FatFs 模块为应用程序提供了下列函数：

1.f_mount  

在 FatFs 模块上注册 / 注销一个工作区 ( 文件系统对象 )  

FRESULT f_mount ( 

  BYTE  Drive,             /*  逻辑驱动器号  */ 

  FATFS*  FileSystemObject /*  工作区指针  */ 

);

参数   

Drive  

注册 / 注销工作区的逻辑驱动器号 (0-9) 。   

FileSystemObject  

工作区 ( 文件系统对象 ) 指针。

返回值   

FR_OK (0)  

函数成功。   

FR_INVALID_DRIVE  

驱动器号无效   

f_mount 函数在 FatFs 模块上注册 / 注销一个工作区。 在使用任何其他文件函数之前，必须使用该函数为每个卷注册一个工作区。要注销一个工作区，只要指定 FileSystemObject 为 NULL 即可，然后该工作区可以被丢弃。  

该函数只初始化给定的工作区，以及将该工作区的地址注册到内部表中，不访问磁盘 I/O 层。卷装入过程是在f_mount 函数后或存储介质改变后的第一次文件访问时完成的。

2.f_open  

创建 / 打开一个用于访问文件的文件对象   

FRESULT f_open ( 

  FIL* FileObject,         /*  空白文件对象结构指针  */ 

  const XCHAR* FileName,   /*  文件名指针  */ 

  BYTE ModeFlags           /*  模式标志  */ 

); 

参数   

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 == 1  时，模式标志  FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYS  是无效的。 

返回值  

FR_OK (0)  

函数成功，该文件对象有效。   

FR_NO_FILE  

找不到该文件。   

FR_NO_PATH  

找不到该路径。   

FR_INVALID_NAME  

文件名无效。   

FR_INVALID_DRIVE  

驱动器号无效。   

FR_EXIST  

该文件已存在。   

FR_DENIED  

由于下列原因，所需的访问被拒绝： 

n  ▲ 以写模式打开一个只读文件。   

n  ▲ 由于存在一个同名的只读文件或目录，而导致文件无法被创建。   

n  ▲ 由于目录表或磁盘已满，而导致文件无法被创建。   

FR_NOT_READY  

由于驱动器中没有存储介质或任何其他原因，而导致磁盘驱动器无法工作。   

FR_WRITE_PROTECTED  

在存储介质被写保护的情况下，以写模式打开或创建文件对象。   

FR_DISK_ERR  

由于底层磁盘 I/O 接口函数中的一个错误，而导致该函数失败。   

FR_INT_ERR  

由于一个错误的 FAT 结构或一个内部错误，而导致该函数失败。   

FR_NOT_ENABLED  

逻辑驱动器没有工作区。

FR_NO_FILESYSTEM  

磁盘上没有有效地 FAT 卷。 

如果函数成功，则创建一个文件对象。该文件对象被后续的读 / 写函数用来访问文件。如果想要关闭一个打开的文件对象，则使用 f_close 函数。如果不关闭修改后的文件，那么文件可能会崩溃。在使用任何文件函数之前，必须使用 f_mount 函数为驱动器注册一个工作区。只有这样，其他文件函数才能正常工作。  

3.f_close  

关闭一个打开的文件   

FRESULT f_close ( 

  FIL* FileObject          /*  文件对象结构的指针  */ 

); 

参数   

FileObject  

指向将被关闭的已打开的文件对象结构的指针。   

返回值   

FR_OK (0)  

文件对象已被成功关闭。  

FR_DISK_ERR  

由于底层磁盘 I/O 函数中的错误，而导致该函数失败。

FR_INT_ERR  

由于一个错误的 FAT 结构或一个内部错误，而导致该函数失败。   

FR_NOT_READY  

由于驱动器中没有存储介质或任何其他原因，而导致磁盘驱动器无法工作。   

FR_INVALID_OBJECT  

文件对象无效。

f_close 函数关闭一个打开的文件对象。无论向文件写入任何数据，文件的缓存信息都将被写回到磁盘。该函数成功后，文件对象不再有效，并且可以被丢弃。如果文件对象是在只读模式下打开的，不需要使用该函数，也能被丢弃。 

4.f_read  

从一个文件读取数据   

FRESULT f_read ( 

  FIL* FileObject,         /*  文件对象结构的指针  */ 

  void* Buffer,            /*  存储读取数据的缓冲区的指针  */ 

  UINT ByteToRead,         /*  要读取的字节数  */ 

  UINT* ByteRead           /*  返回已读取字节数变量的指针  */ 

); 

参数   

FileObject  

指向将被读取的已打开的文件对象结构的指针。   

Buffer  

指向存储读取数据的缓冲区的指针。   

ByteToRead  

要读取的字节数， UINT 范围内。   

ByteRead  

指向返回已读取字节数的 UINT 变量的指针。在调用该函数后，无论结果如何，数值都是有效的。

返回值   

FR_OK (0)  

函数成功。   

FR_DENIED  

由于文件是以非读模式打开的，而导致该函数被拒绝。   

FR_DISK_ERR  

由于底层磁盘 I/O 函数中的错误，而导致该函数失败。   

FR_INT_ERR  

由于一个错误的 FAT 结构或一个内部错误，而导致该函数失败。   

FR_NOT_READY  

由于驱动器中没有存储介质或任何其他原因，而导致磁盘驱动器无法工作。   

FR_INVALID_OBJECT  文件对象无效。 

文件对象中的读 / 写指针以已读取字节数增加。该函数成功后，应该检查  *ByteRead  来检测文件是否结束。在读操作过程中，一旦  *ByteRead