FATfs系统移植

STM32 FATFS读写SD卡:http://wenku.baidu.com/link?url=qapnOkydmTDRvE-lagwmtBxHrK5hBeVv4S1onp7DCw-KMJE8qjvRQiFxVfgc7uiktht7zQLgynMWhErqK6cpiWF6FP3x9JiWMCnqKnhxJ8a

 移植步骤 

 

 

 编写SPI和SD卡接口代码 

   本文使用SD卡的SPI通信模式。SD卡的DI接MOSI,DO接MISO,CS接SS。这

就需要ATmegal28提供SPI读/写接口代码,主要包括初始化、读和写。SPI初始化包括

SPI相关寄存器的初始化和相关I/O口的初始化。将ATmega  128的SPI配置成主机模式、

数据高位先传、时钟速率为二分之一系统时钟等。代码如下: 

SPCR =(O<<SPIE) | (1<<SPE) | (O<<DORD)| (1<<MSTR) |(O<<CPOL) |  

(O<<CPHA) |(O<<SPR1) |  (O<<SPRO);SPSR |= ( 1<< SPI2X ); 

接着配置I/O口的输入/输出。MOSI脚和SS脚配置成输出,MISO脚配置成输入。

然后,就可以进行读/写了。 

 



读1个字节的SPI接口代码: 

static BYTErcvr_spi(void) 

{  

SPDR=OxFF; 

 loop_until_bit_is_set(SPSR,SPIF); 

return SPDR; 

写1个字节的SPI接口代码: 

static voidxmit_spi(BYTE dat) 

SPDR=dat; 

loop_until_bit_is_set(SPSR,SPIF) 

 在具备SPI读/写接口的基础上编写SD卡接口代码,需要编写3个基本接口函数: 



 

 

 

    ①向SD卡发送1条命令: 

     Static  BYTE send-cmd(BYTE  cmd,DWORD  arg); 

 

   ②向SD卡发送1个数据包: 

     Static  BOOL  xmit—datablock(const BYTE  *buff,BYTE token); 

 

   ③从SD卡接收1个数据包: 

     static BOOL  rcvr-datablock(BYTE*buff,UINT  btr); 

 

 

 

    1.2.2 编写DiskIO 

   编写好存储媒介的接口代码后,就可以编写DiskIO了,DiskIO结构如图2所示。 

   Tiny—FatFs的移植实际上需要编写6个接口函数,分别是: 

 

 

 

   ① DSTATUS  disk_initialize(BYTE drv); 

 

   存储媒介初始化函数。由于存储媒介是SD卡,所以实际上是对SD卡的初始化。drv

是存储媒介号码,由于Tinv—FatFs只支持一个存储媒介,所以drv应恒为O。执行无误返

回0,错误返回非O。 

 

   ② DSTATUS  disk_status(BYTE drV);  

 

   状态检测函数。检测是否支持当前的存储媒介,对Tinv—FatFs来说,只要drv为0,

就认为支持,然后返回O。 

 

    ③ DRESULT  disk_read(BYTE  drv,BYTE*buff,DWORD sector,BYTE.count);  

 

读扇区函数。在SD卡读接口函数的基础上编写,*buff存储已经读取的数据,sector

是开始读的起始扇区,count是需要读的扇区数。1个扇区512个字节。执行无误返回O,

错误返回非0。 

 

    ④ DRESULT  disk_write(BYTE drv,const  BYTE*buff,DWORD  sector,BYTE  count); 

 

   写扇区函数。在SD卡写接口函数的基础上编写,*buff存储要写入的数据,sector是

开始写的起始扇区count是需要写的扇区数。1个扇区512个字节。执行无误返回O,错误

返回非0。 

 

    ⑤ DRESULT  disk_ioctl(BYTE drv,BYTE  ctrl,VoiI*buff); 

 

   存储媒介控制函数。ctrl是控制代码,*buff存储或接收控制数据。可以在此函数里编写

自己需要的功能代码,比如获得存储媒介的大小、检测存储媒介的上电与否存储媒介的扇区

数等。如果是简单的应用,也可以不用编写,返回O即可。 

 

    ⑥ DWORD  get_fattime(Void); 

 

   实时时钟函数。返回一个32位无符号整数,时钟信息包含在这32位中,如下所示: 

   bit31:25 年(O..127)从1980年到现在的年数 

   bit24:21 月(1…12) 

   bit20:16 日(1..31) 

   bitl5.1] 时(O..23) 

   bitl0:5 分(O..59) 

    bit4:0 秒/2(0..29) 

   如果用不到实时时钟,也可以简单地返回一个数。正确编写完DiskIO,移植工作也就

基本完成了,接下来的工作就是对Tiny—FatFs进行配置。 

 

 

2  Tiny—FatFs的配置 

   Tiny—FatFs是一款可配置可裁减的文件系统,使用者可以选择自己需要的功能。Tiny

—FatFs总共有5个文件,分别是tff.c、tff.h、diskio.c、diskio.h和integer.h。tff_

c和integer.h一般不用改动,前面的移植工作主要更改的是diskio.c,而配置Tiny—Fat

Fs则主要修改tff.h和diskio.h。 

 

diskio.h中,使用者可以根据需要使能disk—write或disk_ioetl。以下代码使能disk_w

rite和disk_ioctl: 

   #define—R'EADONLY 0 

   #define—USE_IOCTL 1 

 

   在tff.h中,使用者可以根据需要对整个文件系统进行全面的配置:

 

      #define_MCU_ENDIAN。

               有1和2两个值可设,默认情况下设1,以获得较好的

           系统性能。如果单片机是大端模式或者设为1时系统运行不正常,则必须设为2。 

 

     #define_FS_READONLY。

             设为1时将使能只读操作,程序编译时将文件系统中

        涉及写的操作全部去掉,以节省空间。 

 

     #define_FS_MINIMIZE。有0、1、2、3四个选项可设。设0表示可以使用全部Tin

y-FatFs提供的用户函数;设1将禁用f_stat、f_getfree、f_unlink、f_mkdir、f_chmod和f

_rename;设2将在1的基础上禁用f_opendir 和f_readdir;设3将在1和2的基础上再

禁用f_lseek。使用者可以根据需要进行裁减,以节省空间。

 

   ④ #define _FAT32                    设置为1时,支持FAT32

 

   ⑤ #define _USE_FSINFO           为1时提供FAT32的磁盘信息支持

 

   ⑥ #define _USE_SJIS      设置为1 时支持Shit-JIS码 , 一般为0

 

    #define _USE_NTFLAG         设置为1时对文件名大小字敏感

 

 








FATfs介绍

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

 

特点

 

 

Windows兼容的FAT文件系统

不依赖于平台,易于移植

代码和工作区占用空间非常小

多种配置选项:

 

多卷(物理驱动器和分区)

多ANSI/OEM代码页,包括DBCS

在ANSI/OEM或Unicode中长文件名的支持

RTOS的支持

多扇区大小的支持

只读,最少API,I/O缓冲区等等

应用程序接口

FatFs 模块为应用程序提供了下列函数,这些函数描述了FatFs能对FAT卷执行哪些操作。

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函数后或存储介质改变后的第一次文件访问时完成的。

 

f_open 

 

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

FRESULT f_open (

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

  constXCHAR* FileName,   /* 文件名指针*/

  BYTEModeFlags          /* 模式标志*/

);

参数

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由于下列原因,所需的访问被拒绝:

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

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

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

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函数为驱动器注册一个工作区。只有这样,其他文件函数才能正常工作。

例子(文件拷贝)

void main (void)

{

   FATFSfs[2];         /* 逻辑驱动器的工作区(文件系统对象)*/

   FIL fsrc,fdst;      /* 文件对象*/

   BYTE buffer[4096];  /* 文件拷贝缓冲区*/

   FRESULTres;         /* FatFs 函数公共结果代码*/

   UINT br,bw;         /* 文件读/写字节计数*/

 

 

   /* 为逻辑驱动器注册工作区*/

   f_mount(0, &fs[0]);

   f_mount(1, &fs[1]);

 

   /* 打开驱动器1 上的源文件*/

    res= f_open(&fsrc,"1:srcfile.dat",FA_OPEN_EXISTING | FA_READ);

   if (res) die(res);

 

   /* 在驱动器0 上创建目标文件*/

   res =f_open(&fdst,"0:dstfile.dat", FA_CREATE_ALWAYS | FA_WRITE);

   if (res) die(res);

 

   /* 拷贝源文件到目标文件*/

    for (;;)

    {

       res =f_read(&fsrc, buffer,sizeof(buffer), &br);

       if (res || br== 0) break;   /* 文件结束错误*/

       res =f_write(&fdst, buffer, br,&bw);

       if (res || bw< br) break;   /* 磁盘满错误*/

   }

 

   /* 关闭打开的文件*/

   f_close(&fsrc);

   f_close(&fdst);

 

   /* 注销工作区(在废弃前) */

   f_mount(0, NULL);

   f_mount(1, NULL);

}

 

 

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

 

 

 

f_read 

从一个文件读取数据

FRESULT f_read (

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

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

 UINTByteToRead,         /* 要读取的字节数*/

 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< ByteToRead ,则读/写指针到达了文件结束位置。

 

 

f_write 

写入数据到一个文件

FRESULT f_write (

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

  constvoid* Buffer,     /* 存储写入数据的缓冲区的指针*/

 UINTByteToWrite,        /* 要写入的字节数*/

 UINT*ByteWritten        /* 返回已写入字节数变量的指针*/

);

参数

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文件对象无效。

 

描述

文件对象中的读/写指针以已写入字节数增加。该函数成功后,应该检查*ByteWritten 来检测磁盘是否已满。在写操作过程中,一旦*ByteWritten< *ByteToWritten ,则意味着该卷已满。

 

 

 

 f_lseek 

移动一个打开的文件对象的文件读/写指针。也可以被用来扩展文件大小(簇预分配)。

FRESULT f_lseek (

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

 DWORDOffset            /* 文件字节偏移*/

);

参数

FileObject打开的文件对象的指针

Offset相对于文件起始处的字节数

 

返回值

FR_OK (0)函数成功。

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

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

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

FR_INVALID_OBJECT文件对象无效。

 

描述

f_lseek函数当FS_MINIMIZE <= 2时可用。

offset只能被指定为相对于文件起始处的字节数。当在写模式下指定了一个超过文件大小的offset时,文件的大小将被扩展,并且该扩展的区域中的数据是未定义的。这适用于为快速写操作迅速地创建一个大的文件。f_lseek函数成功后,为了确保读/写指针已被正确地移动,必须检查文件对象中的成员fptr。如果fptr不是所期望的值,则发生了下列情况之一。

文件结束。指定的offset被钳在文件大小,因为文件已被以只读模式打开。

磁盘满。卷上没有足够的空闲空间去扩展文件大小。

 

例子

/* 移动文件读/写指针到相对于文件起始处偏移为5000字节处*/

   res = f_lseek(file, 5000);

    /* 移动文件读/写指针到文件结束处,以便添加数据*/

   res = f_lseek(file, file->fsize);

   /* 向前3000字节*/

   res = f_lseek(file, file->fptr +3000);

    /* 向后(倒带)2000字节(注意溢出) */

   res = f_lseek(file, file->fptr -2000);

    /* 簇预分配(为了防止在流写时缓冲区上溢*/

    res = f_open(file, recfile,FA_CREATE_NEW| FA_WRITE); /* 创建一个文件*/

    res = f_lseek(file,PRE_SIZE);        /* 预分配簇*/

   if (res || file->fptr != PRE_SIZE).../* 检查文件大小是否已被正确扩展*/

    res = f_lseek(file, DATA_START);      /* 没有簇分配延迟地记录数据流*/

   ...

    res=f_truncate(file);               /* 截断未使用的区域*/

   res =f_lseek(file,0);               /* 移动到文件起始处*/

   ...

    res = f_close(file);

 

 

f_truncate

截断文件大小

FRESULTf_truncate(

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

);

参数

FileObject 待截断的打开的文件对象的指针。

 

返回值

FR_OK (0函数成功。

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

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

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

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

FR_INVALID_OBJECT文件对象无效。

 

描述

f_truncate函数当_FS_READONLY == 0 并且_FS_MINIMIZE == 0时可用。

f_truncate函数截断文件到当前的文件读/写指针。当文件读/写指针已经指向文件结束时,该函数不起作用。

 

 

 

f_sync

冲洗一个写文件的缓存信息

FRESULT f_sync (

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

);

参数

FileObject待冲洗的打开的文件对象的指针。

 

返回值

FR_OK (0)函数成功。

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

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

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

FR_INVALID_OBJECT文件对象无效。

 

描述

f_sync函数当_FS_READONLY == 0时可用。

f_sync函数和f_close函数执行同样的过程,但是文件仍处于打开状态,并且可以继续对文件执行读/写/移动指针操作。这适用于以写模式长时间打开文件,比如数据记录器。定期的或f_write后立即执行f_sync可以将由于突然断电或移去磁盘而导致数据丢失的风险最小化。在f_close前立即执行f_sync没有作用,因为在f_close中执行了f_sync。换句话说,这两个函数的差异就是文件对象是不是无效的。

 

 

 

f_opendir

打开一个目录

FRESULT f_opendir(

 DIR*DirObject,          /* 空白目录对象结构的指针*/

  constXCHAR* DirName     /* 目录名的指针*/

);

参数

DirObject待创建的空白目录对象的指针。

DirName'\0'结尾的字符串指针,该字符串指定了将被打开的目录名。

 

返回值

FR_OK (0)函数成功,目录对象被创建。该目录对象被后续调用,用来读取目录项。

FR_NO_PATH找不到路径。

FR_INVALID_NAME路径名无效。

FR_INVALID_DRIVE驱动器号无效。

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

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

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

FR_NOT_ENABLED逻辑驱动器没有工作区。

FR_NO_FILESYSTEM磁盘上没有有效的FAT卷。

 

描述

f_opendir函数当_FS_MINIMIZE <= 1时可用。

f_opendir函数打开一个已存在的目录,并为后续的调用创建一个目录对象。该目录对象结构可以在任何时候不经任何步骤而被丢弃。

 

 

 

 

f_readdir

读取目录项

FRESULT f_readdir(

 DIR*DirObject,          /* 指向打开的目录对象结构的指针*/

 FILINFO*FileInfo        /* 指向文件信息结构的指针*/

);

参数

DirObject打开的目录对象的指针。

FileInfo存储已读取项的文件信息结构指针。

 

返回值

FR_OK (0)函数成功。

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

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

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

FR_INVALID_OBJECT文件对象无效。

 

描述

f_readdir函数当_FS_MINIMIZE <= 1时可用。

f_readdir函数顺序读取目录项。目录中的所有项可以通过重复调用f_readdir函数被读取。当所有目录项已被读取并且没有项要读取时,该函数没有任何错误地返回一个空字符串到f_name[]成员中。当FileInfo给定一个空指针时,目录对象的读索引将被回绕。

当LFN功能被使能时,在使用f_readdir函数之前,文件信息结构中的lfname和lfsize必须被初始化为有效数值。lfname是一个返回长文件名的字符串缓冲区指针。lfsize是以字符为单位的字符串缓冲区的大小。如果读缓冲区或LFN工作缓冲区的大小(对于LFN)不足,或者对象没有LFN,则一个空字符串将被返回到LFN读缓冲区。如果LFN包含任何不能被转换为OEM代码的字符,则一个空字符串将被返回,但是这不是Unicode API配置的情况。当lfname是一个空字符串时,没有LFN的任何数据被返回。当对象没有LFN时,任何小型大写字母可以被包含在SFN中。

当相对路径功能被使能(_FS_RPATH== 1)时,"."和".."目录项不会被过滤掉,并且它将出现在读目录项中。

 

例子

FRESULTscan_files(char* path)

{

   FRESULT res;

   FILINFO fno;

   DIR dir;

   int i;

   char *fn;

#if _USE_LFN

   static char lfn[_MAX_LFN * (_DF1S ? 2: 1)+ 1];

   fno.lfname = lfn;

   fno.lfsize = sizeof(lfn);

#endif

 

 

   res = f_opendir(&dir, path);

   if (res == FR_OK) {

       i =strlen(path);

       for (;;) {

           res= f_readdir(&dir,&fno);

           if(res != FR_OK || fno.fname[0] ==0) break;

           if(fno.fname[0] == '.') continue;

#if _USE_LFN

           fn= *fno.lfname ? fno.lfname :fno.fname;

#else

           fn= fno.fname;

#endif

           if(fno.fattrib & AM_DIR) {

               sprintf(&path[i],"/%s",fn);

               res= scan_files(path);

               if(res != FR_OK) break;

               path[i]= 0;

           }else {

               printf("%s/%s\n",path,fn);

           }

       }

   }

 

   return res;

}

 

 

f_getfree

获取空闲簇的数目

FRESULT f_getfree(

  const XCHAR*Path,      /* 驱动器的根目录*/

 DWORD*Clusters,         /* 存储空闲簇数目变量的指针*/

  FATFS**FileSystemObject /* 文件系统对象指针的指针*/

);

参数

Path'\0'结尾的字符串指针,该字符串指定了逻辑驱动器的目录。

Clusters存储空闲簇数目的DWORD变量的指针。

FileSystemObject相应文件系统对象指针的指针。

 

返回值

FR_OK (0)函数成功。*Clusters表示空闲簇的数目,并且*FileSystemObject指向文件系统对象。

FR_INVALID_DRIVE驱动器号无效。

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

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

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

FR_NOT_ENABLED逻辑驱动器没有工作区。

FR_NO_FILESYSTEM磁盘上没有有效的FAT卷。

 

描述

f_getfree函数当_FS_READONLY == 0并且_FS_MINIMIZE== 0时有效。

f_getfree函数获取驱动器上空闲簇的数目。文件系统对象中的成员csize是每簇中的扇区数,因此,以扇区为单位的空闲空间可以被计算出来。当FAT32卷上的FSInfo结构不同步时,该函数返回一个错误的空闲簇计数。

 

例子:

   FATFS *fs;

   DWORD fre_clust, fre_sect, tot_sect;

 

 

   /* Get drive information and freeclusters*/

   res =f_getfree("/",&fre_clust, &fs);

   if (res) die(res);

 

   /* Get total sectors and free sectors*/

   tot_sect = (fs->max_clust - 2)*fs->csize;

   fre_sect = fre_clust * fs->csize;

 

   /* Print free space in unit of KB(assuming512B/sector) */

   printf("%lu KB totaldrivespace.\n"

          "%luKB available.\n",

          fre_sect/ 2, tot_sect / 2);

 

 

 

 

f_stat

获取文件状态

FRESULT f_stat (

  constXCHAR* FileName,   /* 文件名或目录名的指针*/

 FILINFO*FileInfo        /* FILINFO结构的指针*/

);

参数

FileName'\0'结尾的字符串指针,该字符串指定了待获取其信息的文件或目录。

FileInfo存储信息的空白FILINFO结构的指针。

 

返回值

FR_OK (0)函数成功。

FR_NO_FILE找不到文件或目录。

FR_NO_PATH找不到路径。

FR_INVALID_NAME路径名无效。

FR_INVALID_DRIVE驱动器号无效。

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

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

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

FR_NOT_ENABLED逻辑驱动器没有工作区。

FR_NO_FILESYSTEM磁盘上没有有效的FAT卷。

 

描述

f_stat函数当_FS_MINIMIZE == 0时可用。
f_stat函数获取一个文件或目录的信息。信息的详情,请参考FILINFO结构和f_readdir函数。

 

 

 

 

f_mkdir

创建一个目录

FRESULT f_mkdir (

  constXCHAR* DirName /* 目录名的指针*/

);

参数

DirName'\0'结尾的字符串指针,该字符串指定了待创建的目录名。

 

返回值

FR_OK (0)函数成功。

FR_NO_PATH找不到路径。

FR_INVALID_NAME路径名无效。

FR_INVALID_DRIVE驱动器号无效。

FR_DENIED由于目录表或磁盘满,而导致目录不能被创建。

FR_EXIST已经存在同名的文件或目录。

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

FR_WRITE_PROTECTED存储介质被写保护。

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

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

FR_NOT_ENABLED逻辑驱动器没有工作区。

FR_NO_FILESYSTEM磁盘上没有有效的FAT卷。

 

描述

f_mkdir函数当_FS_READONLY == 0并且_FS_MINIMIZE== 0时可用。
f_mkdir函数创建一个新目录。

 

例子

res=f_mkdir("sub1");

   if (res) die(res);

   res = f_mkdir("sub1/sub2");

   if (res) die(res);

   res =f_mkdir("sub1/sub2/sub3");

   if (res) die(res);

 

 

 

 

f_unlink

移除一个对象

FRESULT f_unlink(

  constXCHAR* FileName  /* 对象名的指针*/

);

参数

FileName'\0'结尾的字符串指针,该字符串指定了一个待移除的对象。

 

返回值

FR_OK (0)函数成功。

FR_NO_FILE找不到文件或目录。

FR_NO_PATH找不到路径。

FR_INVALID_NAME路径名无效。

FR_INVALID_DRIVE驱动器号无效。

FR_DENIED由于下列原因之一,而导致该函数被拒绝:

对象具有只读属性

目录不是空的

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

FR_WRITE_PROTECTED存储介质被写保护。

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

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

FR_NOT_ENABLED逻辑驱动器没有工作区。

FR_NO_FILESYSTEM磁盘上没有有效的FAT卷。

 

描述

f_unlink函数当_FS_READONLY == 0并且_FS_MINIMIZE== 0时可用。
f_unlink函数移除一个对象。不要移除打开的对象或当前目录。

 

 

 

 

 

f_chmod

修改一个文件或目录的属性。

FRESULT f_chmod (

  constXCHAR* FileName, /* 文件或目录的指针*/

  BYTEAttribute,       /* 属性标志*/

  BYTEAttributeMask    /* 属性掩码*/

);

 

参数

FileName'\0'结尾的字符串指针,该字符串指定了一个待被修改属性的文件或目录。

Attribute待被设置的属性标志,可以是下列标志的一个或任意组合。指定的标志被设置,其他的被清除。

 

属性描述

AM_RDO

只读

AM_ARC

存档

AM_SYS

系统

AM_HID

隐藏

AttributeMask属性掩码,指定修改哪个属性。指定的属性被设置或清除。

 

返回值

FR_OK (0)函数成功。

FR_NO_FILE找不到文件或目录。

FR_NO_PATH找不到路径。

FR_INVALID_NAME路径名无效。

FR_INVALID_DRIVE驱动器号无效。

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

FR_WRITE_PROTECTED存储介质被写保护。

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

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

FR_NOT_ENABLED逻辑驱动器没有工作区。

FR_NO_FILESYSTEM磁盘上没有有效的FAT卷。

 

描述

f_chmod函数当_FS_READONLY == 0并且_FS_MINIMIZE== 0时可用。
f_chmod函数修改一个文件或目录的属性。

 

例子

   // 设置只读标志,清除存档标志,其他不变

   f_chmod("file.txt",AR_RDO,AR_RDO | AR_ARC);

 

 

 

 

 

f_utime

f_utime函数修改一个文件或目录的时间戳。

FRESULT f_utime (

  constXCHAR* FileName,   /* 文件或目录路径的指针*/

  constFILINFO* TimeDate  /* 待设置的时间和日期*/

);

参数

FileName'\0'结尾的字符串的指针,该字符串指定了一个待修改时间戳的文件或目录。

TimeDate文件信息结构指针,其中成员ftime和fdata存储了一个待被设置的的时间戳。不关心任何其他成员。

 

返回值

   FR_OK (0)函数成功。

   FR_NO_FILE找不到文件或目录。

   FR_NO_PATH找不到路径。

   FR_INVALID_NAME路径名无效。

   FR_INVALID_DRIVE驱动器号无效。

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

   FR_WRITE_PROTECTED存储介质被写保护。

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

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

   FR_NOT_ENABLED逻辑驱动器没有工作区。

   FR_NO_FILESYSTEM磁盘上没有有效的FAT卷。

 

描述

f_utime函数当_FS_READONLY == 0并且_FS_MINIMIZE== 0时可用。
f_utime函数修改一个文件或目录的时间戳。

 

 

 

 

f_rename

重命名一个对象。

FRESULT f_rename(

  constXCHAR* OldName, /* 原对象名的指针*/

  constXCHAR* NewName  /* 新对象名的指针*/

);

参数

OldName'\0'结尾的字符串的指针,该字符串指定了待被重命名的原对象名。

NewName'\0'结尾的字符串的指针,该字符串指定了重命名后的新对象名,不能包含驱动器号。

 

返回值

FR_OK (0)函数成功。

FR_NO_FILE找不到原名。

FR_NO_PATH找不到路径。

FR_INVALID_NAME文件名无效。

FR_INVALID_DRIVE驱动器号无效。

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

FR_EXIST新名和一个已存在的对象名冲突。

FR_DENIED由于任何原因,而导致新名不能被创建。

FR_WRITE_PROTECTED存储介质被写保护。

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

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

FR_NOT_ENABLED逻辑驱动器没有工作区。

FR_NO_FILESYSTEM磁盘上没有有效的FAT卷。

 

描述

f_rename函数当_FS_READONLY == 0并且_FS_MINIMIZE== 0时可用。
f_rename函数重命名一个对象,并且也可以将对象移动到其他目录。逻辑驱动器号由原名决定,新名不能包含一个逻辑驱动器号。不要重命名打开的对象

 

例子

   /* 重命名一个对象*/

   f_rename("oldname.txt","newname.txt");

 

   /* 重命名并且移动一个对象到另一个目录*/

   f_rename("oldname.txt","dir1/newname.txt");

 

 

 

 

f_mkfs

在驱动器上创建一个文件系统

FRESULT f_mkfs (

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

 BYTE PartitioningRule, /* 分区规则*/

 WORD AllocSize        /* 分配单元大小*/

);

参数

Drive待格式化的逻辑驱动器号(0-9)。

PartitioningRule当给定0时,首先在驱动器上的第一个扇区创建一个分区表,然后文件系统被创建在分区上。这被称为FDISK格式化,用于硬盘和存储卡。当给定1时,文件系统从第一个扇区开始创建,而没有分区表。这被称为超级软盘(SFD)格式化,用于软盘和可移动磁盘。

AllocSize指定每簇中以字节为单位的分配单元大小。数值必须是0或从512到32K之间2的幂。当指定0时,簇大小取决于卷大小。

 

返回值

FR_OK (0)函数成功。

FR_INVALID_DRIVE驱动器号无效。

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

FR_WRITE_PROTECTED驱动器被写保护。

FR_NOT_ENABLED逻辑驱动器没有工作区。

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

FR_MKFS_ABORTED由于下列原因之一,而导致函数在开始格式化前终止:磁盘容量太小、参数无效、该驱动器不允许的簇大小。

 

描述

f_mkfs函数当_FS_READOLNY == 0并且_USE_MKFS== 1时可用。
f_mkfs函数在驱动器中创建一个FAT文件系统。对于可移动媒介,有两种分区规则:FDISK和SFD,通过参数PartitioningRule选择。FDISK格式在大多数情况下被推荐使用。该函数当前不支持多分区,因此,物理驱动器上已存在的分区将被删除,并且重新创建一个占据全部磁盘空间的新分区。
根据Microsoft发布的FAT规范,FAT分类:FAT12/FAT16/FAT32,由驱动器上的簇数决定。因此,选择哪种FAT分类,取决于卷大小和指定的簇大小。簇大小影响文件系统的性能,并且大簇会提高性能。

 

 

 

 

f_forward

读取文件数据并将其转发到数据流设备。

FRESULT f_forward(

 FIL*FileObject,                /* 文件对象*/

  UINT(*Func)(const BYTE*,UINT),  /* 数据流函数*/

 UINTByteToFwd,                 /* 要转发的字节数*/

  UINT*ByteFwd                   /* 已转发的字节数*/

);

参数

FileObject打开的文件对象的指针。

Func用户定义的数据流函数的指针。详情参考示例代码。

ByteToFwd要转发的字节数,UINT范围内。

ByteFwd返回已转发的字节数的UINT变量的指针。

 

返回值

FR_OK (0)函数成功。

FR_DENIED由于文件已经以非读模式打开,而导致函数失败。

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

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

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

FR_INVALID_OBJECT文件对象无效。

 

描述

f_forward函数当_USE_FORWARD == 1并且_FS_TINY ==1时可用。
f_forward函数从文件中读取数据并将数据转发到输出流,而不使用数据缓冲区。这适用于小存储系统,因为它在应用模块中不需要任何数据缓冲区。文件对象的文件指针以转发的字节数增加。如果*ByteFwd < ByteToFwd并且没有错误,则意味着由于文件结束或在数据传输过程中流忙,请求的字节不能被传输。

 

例子(音频播放)

/*-----------------------------------------------------------------------*/

/* 示例代码:数据传输函数,将被f_forward函数调用                          */

/*-----------------------------------------------------------------------*/

 

UINTout_stream(   /* 返回已发送字节数或流状态*/

   const BYTE *p,  /* 将被发送的数据块的指针*/

   UINTbtf        /* >0: 传输调用(将被发送的字节数)。0: 检测调用*/

)

{

   UINT cnt = 0;

   if(btf == 0) {    /* 检测调用*/

       /* 返回流状态(0: 忙,1: 就绪) */

       /* 当检测调用时,一旦它返回就绪,那么在后续的传输调用时,它必须接收至少一个字节,或者f_forward将以FR_INT_ERROR而失败。*/

       if(FIFO_READY) cnt = 1;

   }

   else{             /* 传输调用*/

       do{   /* 当有数据要发送并且流就绪时重复*/

           FIFO_PORT= *p++;

           cnt++;

       } while (cnt< btf &&FIFO_READY);

   }

 

   return cnt;

}

 

 

/*-----------------------------------------------------------------------*/

/* 示例代码:使用f_forward函数                                                   */

/*-----------------------------------------------------------------------*/

 

FRESULT play_file(

   char*fn        /* 待播放的音频文件名的指针*/

)

{

   FRESULT rc;

   FIL fil;

   UINT dmy;

 

   /* 以只读模式打开音频文件*/

   rc = f_open(&fil, fn, FA_READ);

 

   /* 重复,直到文件指针到达文件结束位置*/

   while (rc == FR_OK && fil.fptr<fil.fsize) {

 

       /* 任何其他处理... */

 

       /* 定期或请求式填充输出流*/

       rc =f_forward(&fil, out_stream,1000, &dmy);

   }

 

   /* 该只读的音频文件对象不需要关闭就可以被丢弃*/

   return rc;

}

 

 

 

 

 f_chdir

f_chdir函数改变一个驱动器的当前目录。

FRESULT f_chdir (

  constXCHAR* Path /* 路径名的指针*/

);

参数

Path'\0'结尾的字符串的指针,该字符串指定了将要进去的目录。

 

返回值

FR_OK (0)函数成功。

FR_NO_PATH找不到路径。

FR_INVALID_NAME路径名无效。

FR_INVALID_DRIVE驱动器号无效。

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

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

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

FR_NOT_ENABLED逻辑驱动器没有工作区。

FR_NO_FILESYSTEM磁盘上没有有效的FAT卷。

 

描述

f_chdir函数当_FS_RPATH == 1时可用。
f_chdir函数改变一个逻辑驱动器的当前目录。当一个逻辑驱动器被自动挂载时,它的当前目录被初始化为根目录。注意:当前目录被保存在每个文件系统对象中,因此它也影响使用同一逻辑驱动器的其它任务。

 

例子

   // 改变当前驱动器的当前目录(根目录下的dir1)

   f_chdir("/dir1");

   // 改变驱动器2的当前目录(父目录)

   f_chdir("2:..");

 

 

 

 

f_chdrive

f_chdrive函数改变当前驱动器。

FRESULT f_chdrive(

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

);

Drive指定将被设置为当前驱动器的逻辑驱动器号。

 

返回值

FR_OK (0)函数成功。

FR_INVALID_DRIVE驱动器号无效。

描述

f_chdrive函数当_FS_RPATH == 1时可用。
f_chdrive函数改变当前驱动器。当前驱动器号初始值为0,注意:当前驱动器被保存为一个静态变量,因此它也影响使用文件函数的其它任务。

 

 

 

 

f_gets

f_gets从文件中读取一个字符串。

char* f_gets (

 char*Str,        /* 读缓冲区*/

 intSize,         /* 读缓冲区大小*/

  FIL*FileObject   /* 文件对象*/

);

参数

Str存储读取字符串的读缓冲区指针。

Size读缓冲区大小。

FileObject打开的文件对象结构指针。

返回值当函数成功后,Str将被返回。

 

描述

f_gets函数当_USE_STRFUNC == 1或者_USE_STRFUNC== 2时可用。如果_USE_STRFUNC == 2,文件中包含的'\r'则被去除。
f_gets函数是f_read的一个封装函数。当读取到'\n'、文件结束或缓冲区被填冲了Size - 1个字符时,读操作结束。读取的字符串以'\0'结束。当文件结束或读操作中发生了任何错误,f_gets()返回一个空字符串。可以使用宏f_eof()和f_error()检查EOF和错误状态。

 

 

 

 

 f_putc

f_putc函数向文件中写入一个字符。

int f_putc (

 intChr,          /* 字符*/

  FIL*FileObject   /* 文件对象*/

);

参数

Chr待写入的字符。

FileObject打开的文件对象结构的指针。

 

返回值

当字符被成功地写入后,函数返回该字符。由于磁盘满或任何错误而导致函数失败,将返回EOF。

 

描述

f_putc函数当(_FS_READONLY ==0)&&(_USE_STRFUNC== 1 ||_USE_STRFUNC == 2)时可用。当_USE_STRFUNC== 2时,字符'\n'被转换为"\r\n"写入文件中。
f_putc函数是f_write的一个封装函数。

 

 

 

 

 f_puts

f_puts函数向文件中写入一个字符串。

int f_puts (

  constchar* Str,  /* 字符串指针*/

  FIL*FileObject   /* 文件对象指针*/

);

参数

Str待写入的'\0'结尾的字符串的指针。'\0'字符不会被写入。

FileObject打开的文件对象结构的指针。

 

返回值

函数成功后,将返回写入的字符数。由于磁盘满或任何错误而导致函数失败,将返回EOF。

 

描述

f_puts()当(_FS_READONLY ==0)&&(_USE_STRFUNC== 1 ||_USE_STRFUNC == 2)时可用。当_USE_STRFUNC== 2时,字符串中的'\n'被转换为"\r\n"写入文件中。
f_puts()是f_putc()的一个封装函数。

 

 

 

 

f_printf

f_printf函数向文件中写入一个格式化字符串。

int f_printf (

  FIL*FileObject,     /* 文件对象指针*/

  constchar* Foramt,  /* 格式化字符串指针*/

  ...

);

参数

FileObject已打开的文件对象结构的指针。

Format'\0'结尾的格式化字符串指针。

...  可选参数

 

返回值

函数成功后,将返回写入的字符数。由于磁盘满或任何错误而导致函数失败,将返回EOF。

 

描述

f_printf函数当(_FS_READONLY ==0)&&(_USE_STRFUNC== 1 ||_USE_STRFUNC == 2)时可用。当_USE_STRFUNC== 2时,包含在格式化字符串中的'\n'将被转换成"\r\n"写入文件中。

f_printf函数是f_putc和f_puts的一个封装函数。如下所示,格式控制符是标准库的一个子集:
类型:c s d u X
大小:l
标志:0

例子

    f_printf(&fil,"%6d",-200);                /*" -200" */

   f_printf(&fil,"%02u",5);                   /* "05" */

   f_printf(&fil,"%ld",12345678L);       /*"12345678" */

   f_printf(&fil,"%08lX",1194684UL);  /* "00123ABC"*/

   f_printf(&fil,"%s","String");            /*"String" */

   f_printf(&fil,"%c",'a');                     /* "a" */

 

 

 

 

 磁盘I/O接口

由于FatFs模块完全与磁盘I/O层分开,因此底层磁盘I/O需要下列函数去读/写物理磁盘以及获取当前时间。由于底层磁盘I/O模块并不是FatFs的一部分,因此它必须由用户提供。

 

 

disk_initialize

初始化磁盘驱动器

DSTATUSdisk_initialize(

  BYTEDrive          /* 物理驱动器号*/

);

参数

Drive指定待初始化的物理驱动器号。

 

返回值

disk_initialize函数返回一个磁盘状态作为结果。磁盘状态的详情,参考disk_status函数。

描述

disk_initialize函数初始化一个物理驱动器。函数成功后,返回值中的STA_NOINIT标志被清除。

disk_initialize函数被FatFs模块在卷挂载过程中调用,去管理存储介质的改变。当FatFs模块起作用时,或卷上的FAT结构可以被瓦解时,应用程序不能调用该函数。可以使用f_mount函数去重新初始化文件系统。

 

 

 

 disk_status

获取当前磁盘的状态

DSTATUSdisk_status(

  BYTEDrive    /* 物理驱动器号*/

);

参数

Drive指定待确认的物理驱动器号。

 

返回值

磁盘状态,是下列标志的组合:STA_NOINIT

指示磁盘驱动器还没有被初始化。当系统复位、磁盘移除和disk_initialize函数失败时,该标志被设置;当disk_initialize函数成功时,该标志被清除。STA_NODISK

指示驱动器中没有存储介质。当安装了磁盘驱动器后,该标志始终被清除。

STA_PROTECTED

指示存储介质被写保护。在不支持写保护缺口的驱动器上,该标志始终被清除。当STA_NODISK被设置时,该标志无效。

 

 

 

 

disk_read

从磁盘驱动器中读取扇区

DRESULT disk_read(

 BYTEDrive,          /* 物理驱动器号*/

 BYTE*Buffer,       /* 读取数据缓冲区的指针*/

  DWORDSectorNumber,  /* 起始扇区号*/

  BYTESectorCount     /* 要读取的扇区数*/

);

参数

Drive指定物理驱动器号。

Buffer存储读取数据的缓冲区的指针。该缓冲区大小需要满足要读取的字节数(扇区大小* 扇区总数。由上层指定的存储器地址可能会也可能不会以字边界对齐。SectorNumber

指定在逻辑块地址(LBA)中的起始扇区号。

SectorCount指定要读取的扇区数(1-255)。

 

返回值

RES_OK (0)函数成功

RES_ERROR在读操作过程中发生了不能恢复的硬错误。

RES_PARERR无效的参数。

RES_NOTRDY磁盘驱动器还没被初始化。

 

 

 

 

 disk_write

向磁盘驱动器中写入扇区

DRESULTdisk_write(

 BYTEDrive,          /* 物理驱动器号*/

  constBYTE* Buffer,  /* 写入数据缓冲区的指针(可能未对齐) */

  DWORDSectorNumber,  /* 起始扇区号*/

  BYTESectorCount     /* 要写入的扇区数*/

);

参数

Drive指定物理驱动器号。

Buffer存储写入数据的缓冲区的指针。由上层指定的存储器地址可能会也可能不会以字边界对齐。

SectorNumber指定在逻辑块地址(LBA)中的起始扇区号。

SectorCount指定要写入的扇区数(1-255)。

 

返回值

RES_OK (0)函数成功

RES_ERROR在读操作过程中发生了不能恢复的硬错误。

RES_WRPRT存储介质被写保护。

RES_PARERR无效的参数。

RES_NOTRDY磁盘驱动器还没被初始化。

 

描述

在只读配置中,不需要此函数。

 

 

 

 

 disk_ioctl

控制设备特定的功能以及磁盘读写以外的其它功能。

DRESULTdisk_ioctl(

  BYTEDrive,      /* 驱动器号*/

  BYTECommand,    /* 控制命令代码*/

  void*Buffer     /* 数据传输缓冲区*/

);

参数

Drive指定驱动器号(1-9)。

Command指定命令代码。

Buffer取决于命令代码的参数缓冲区的指针。当不使用时,指定一个NULL指针。

 

返回值

RES_OK (0)函数成功。

RES_ERROR发生错误。

RES_PARERR无效的命令代码。

RES_NOTRDY磁盘驱动器还没被初始化。

 

描述

FatFs模块只使用下述与设备无关的命令,没有使用任何设备相关功能。

命令描述

CTRL_SYNC

确保磁盘驱动器已经完成等待写过程。当磁盘I/O模块有一个写回高速缓存时,立即冲洗脏扇区。在只读配置中,不需要该命令。

GET_SECTOR_SIZE

返回驱动器的扇区大小赋给Buffer指向的WORD变量。在单个扇区大小配置中(_MAX_SS 为512),不需要该命令。

GET_SECTOR_COUNT

返回总扇区数赋给Buffer指向的DWORD变量。只在f_mkfs函数中,使用了该命令。

GET_BLOCK_SIZE

返回以扇区为单位的存储阵列的擦除块大小赋给Buffer指向的DWORD变量。当擦除块大小未知或是磁盘设备时,返回1。只在f_mkfs函数中,使用了该命令。

 

 

 

 

 get_fattime

获取当前时间

DWORD get_fattime(void);

 

返回值

返回的当前时间被打包进一个DWORD数值。

各位域定义如下:

bit31:25年,从1980年开始算起(0..127)

bit24:21月(1..12)

bit20:16日(1..31)

bit15:11时(0..23)

bit10:5分(0..59)

bit4:0秒/2(0..29),由此可见FatFs的时间分辨率为2秒

描述

get_fattime函数必须返回任何有效的时间,即使系统不支持实时时钟。如果返回一个0,则文件将没有一个有效的时间。在只读配置中,不需要此函数。

 

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
1. 硬件平台选择 首先,需要选择一个适合自己应用的硬件平台,可以根据自己的需求选择不同的平台,比如STM32、GD32、ESP32、Arduino等等。 在本文中,我们选择了GD32F303VCT6作为硬件平台。 2. FatFs库介绍 FatFs是一个轻量级的文件系统,支持FAT12、FAT16、FAT32等多种文件系统格式,可以在各种嵌入式系统中运行。FatFs提供了一组API函数,可以方便地对文件系统进行读写操作。 3. 移植步骤 步骤一:创建工程 首先,需要创建一个GD32的Keil工程,选择自己的芯片型号。然后,在工程目录下新建一个fatfs文件夹,用于存放FatFs库和相关的驱动代码。 步骤二:添加FatFs库 将FatFs库添加到工程中。可以在官网上下载最新的FatFs库,然后将其解压到fatfs文件夹下。 步骤三:配置FatFsfatfs文件夹下创建一个diskio.h文件,用于定义磁盘驱动接口。然后,在fatfs文件夹下创建一个ffconf.h文件,用于配置FatFs的一些参数,比如支持的文件系统格式、簇大小等等。 步骤四:实现磁盘驱动接口 在diskio.h文件中,定义以下磁盘驱动接口: ``` DSTATUS disk_initialize(BYTE pdrv); DSTATUS disk_status(BYTE pdrv); DRESULT disk_read(BYTE pdrv, BYTE *buff, DWORD sector, UINT count); DRESULT disk_write(BYTE pdrv, const BYTE *buff, DWORD sector, UINT count); DRESULT disk_ioctl(BYTE pdrv, BYTE cmd, void *buff); ``` 这些接口函数需要在磁盘驱动文件中实现,比如SD卡驱动文件sdio_sd.c中就实现了这些接口函数。 步骤五:初始化FatFs 在main函数中,调用以下代码初始化FatFs: ``` FATFS fs; FRESULT res; res = f_mount(&fs, "", 1); if (res != FR_OK) { // mount failed } ``` 这段代码将FatFs挂载到默认的磁盘上,如果挂载失败,则说明磁盘不存在或者格式不支持。 步骤六:使用FatFs 使用FatFs的API函数对文件系统进行读写操作,比如: ``` FIL file; FRESULT res; res = f_open(&file, "file.txt", FA_READ); if (res != FR_OK) { // open failed } char buf[128]; UINT read_bytes; res = f_read(&file, buf, sizeof(buf), &read_bytes); if (res != FR_OK) { // read failed } f_close(&file); ``` 这段代码打开一个名为file.txt的文件,并读取其中的内容。 至此,FatFs文件系统移植工作完成。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值