FatFS文件系统在MCU上的应用

最新推荐文章于 2023-12-13 11:11:48 发布
最新推荐文章于 2023-12-13 11:11:48 发布
阅读量739 收藏 3
点赞数
文章标签： 单片机 嵌入式硬件
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_61687959/article/details/133122013
版权

FatFS文件系统是单片机领域有名的一个文件系统，由于它的轻量级和兼容性，备受MCU开发者青睐。

在实现如U盘文件读写，SD卡的文件读写等工作时，我们往往需要一个文件系统来支持我们的工作。特别在一些MCU应用中，文件系统的加入能明显改善系统交互的友好性。

在这一篇中，我们就来讨论FatFS文件系统在STM32F4上的移植和应用。

1、准备工作

在开始FatFS的移植之前我们需要做一些必要的准备工作。首先需要准备相应的硬件平台，我们在这里使用的是STM32F407VET6的操作平台。USB硬件相关的库的移植工作也已完成。

其次我们还需要准备FatFS的相关源码，在这里我们使用最新的R0.14b版本，该文件可在网站下载：

http://elm-chan.org/fsw/ff/00index_e.html

下载的源码解压后有两个文件夹：document和source，其中document文件夹中是相关的文档资料，与网站上的内容一样，在移植时可以查看这些文档来工作。Source文件夹中则是源码相关的文件，主要包括：

图片

在上图所示的一系列文件中，00readme.txt文件有对各个文件的介绍，我们查看其内容如下：

00readme.txtreadme文件
00history.txt版本记录文件
ff.cFatFs模块
ffconf.hFatFs模块的配置文件
ff.hFatFs应用模块的头文件
diskio.hFatFs和磁盘IO模块的头文件
diskio.c一个将磁盘IO函数附加到FatFS的实例
ffunicode.cUnicode编码功能函数
ffsystem.c可选的操作系统相关文件实例

在这些文件中，ff.c和ff.h是核心文件。ffunicode.c是字符编码，会根据配置文件的配置选择编码。ffsystem.c文件根据自己的需要决定。所以与具体的应用平台相关的，并需要我们来实现的文件是配置文件ffconf.h和磁盘操作文件diskio.h与diskio.c，这几个文件也是我们移植的重点。

2、实现移植

  我们已经完成了移植的准备工作，接下来就来实现面向大容量U盘的应用移植。前面我们已经说过，移植需要处理的文件是配置文件ffconf.h和磁盘操作文件diskio.h与diskio.c。

  关于配置文件ffconf.h其实它本身有一个实例，我们只需要根据需要修改配置就好。这里我们需要修改的配置参数包括：

  所支持的编码方式配置参数FF_CODE_PAGE，这个关系到文件编码的问题，我们将其配置为简体中文支持。

  逻辑驱动器的数量配置参数FF_VOLUMES，FatFS可以同时应用于多个驱动器，所以我们需要根据实际情况配置驱动器的数量。

  时间戳配置参数FF_FS_NORTC，我们大多时候并不需要记录时间戳，所以在这里我们将其关闭。

  余下就是实现磁盘IO操作的相关函数，在FatFS的帮助文档中告诉了我们需要实现的函数有两类：一类是磁盘设备控制相关的函数，主要是获取设备状态函数、初始化设备函数、读取数据函数、写入数据函数以及控制设备相关功能函数；二类是实时时钟操作函数，主要是获取当前时间函数。所以实现这6个函数就是移植的主要工作。

2.1、获取设备状态函数

  磁盘状态检测函数disk_status。用于检测磁盘状态，在ff.c文件中会被调用。其函数原型如下：

  DSTATUS disk_status(BYTE drV)；

  根据其原型定义以及我们USB大容量存储设备的要求，我们可以实现磁盘状态获取函数如下：

/*用于USBH的状态获取函数*/
static DSTATUS USBH_status(BYTE lun)
{
DRESULT res = RES_ERROR;

if(USBH_MSC_UnitIsReady(&hUsbHostFS, lun))
{
 res = RES_OK;
}
else
{
 res = RES_ERROR;
}

return res;
}

2.2、初始化设备函数

  存储媒介初始化函数disk_initialize。用于对磁盘设备进行初始化，在ff.c文件中会被调用。其函数原型如下：

  DSTATUS disk_initialize(BYTE drv)；

  根据其原型定义以及我们USB大容量存储设备的要求，我们可以实现磁盘驱动器初始化函数，但这里我们其实不需要，因为在USB HOST库中已经完成了初始化，所以直接返回正确就可以了。

/*用于USBH的初始化函数*/
static DSTATUS USBH_initialize(BYTE lun)
{
 //USB HOST库中已经完成了初始化
return RES_OK;
}

2.3、读取数据

  读扇区函数disk_read。用于实现对磁盘数据的读取，根据具体的磁盘IO编写，在ff.c文件中会被调用。其函数原型如下：

  DRESULT disk_read(BYTE drv，BYTE*buff，DWORD sector，BYTE．count)；

  根据其原型定义以及我们USB大容量存储设备的要求，我们可以实现磁盘数据读取函数如下：

/*用于USBH的读扇区函数*/
static DRESULT USBH_read(BYTE lun, BYTE *buff, DWORD sector, UINT count)
{
DRESULT res = RES_ERROR;
MSC_LUNTypeDef info;

if(USBH_MSC_Read(&hUsbHostFS, lun, sector, buff, count) == USBH_OK)
{
 res = RES_OK;
}
else
{
 USBH_MSC_GetLUNInfo(&hUsbHostFS, lun, &info);

 switch (info.sense.asc)
{
 case SCSI_ASC_LOGICAL_UNIT_NOT_READY:
 case SCSI_ASC_MEDIUM_NOT_PRESENT:
 case SCSI_ASC_NOT_READY_TO_READY_CHANGE:
  USBH_ErrLog ("USB Disk is not ready!");
  res = RES_NOTRDY;
  break;

 default:
  res = RES_ERROR;
  break;
}
}

return res;
}

2.4、写入数据

  写扇区函数disk_write。用于实现对磁盘数据的写入，根据具体的磁盘IO编写，在ff.c文件中会被调用。其函数原型如下：

  DRESULT disk_write(BYTE drv，const BYTE*buff，DWORD sector，BYTE count)；

  根据其原型定义以及我们USB大容量存储设备的要求，我们可以实现磁盘数据写入函数如下：

/*用于USBH的写扇区函数*/
static DRESULT USBH_write(BYTE lun, const BYTE *buff, DWORD sector, UINT count)
{
DRESULT res = RES_ERROR;
MSC_LUNTypeDef info;

if(USBH_MSC_Write(&hUsbHostFS, lun, sector, (BYTE *)buff, count) == USBH_OK)
{
 res = RES_OK;
}
else
{
 USBH_MSC_GetLUNInfo(&hUsbHostFS, lun, &info);

 switch (info.sense.asc)
{
 case SCSI_ASC_WRITE_PROTECTED:
  USBH_ErrLog("USB Disk is Write protected!");
  res = RES_WRPRT;
  break;

 case SCSI_ASC_LOGICAL_UNIT_NOT_READY:
 case SCSI_ASC_MEDIUM_NOT_PRESENT:
 case SCSI_ASC_NOT_READY_TO_READY_CHANGE:
  USBH_ErrLog("USB Disk is not ready!");
  res = RES_NOTRDY;
  break;

 default:
  res = RES_ERROR;
  break;
}
}

return res;
}

2.5、控制设备相关功能

  存储媒介控制函数disk_ioctl。可以在此函数里编写自己需要的功能代码，比如获得存储媒介的大小、检测存储媒介的上电与否存储媒介的扇区数等。如果是简单的应用，也可以不用编写。其函数原型如下：

  DRESULT disk_ioctl(BYTE drv，BYTE ctrl，VoiI*buff)；  根据其原型定义以及我们USB大容量存储设备的要求，我们可以实现磁盘设备控制相关功能函数如下：

/*USBH IO控制函数 */
static DRESULT USBH_ioctl(BYTE lun, BYTE cmd, void *buff)
{
DRESULT res = RES_ERROR;
MSC_LUNTypeDef info;

switch (cmd)
{
/* Make sure that no pending write process */
case CTRL_SYNC:
 res = RES_OK;
 break;

/* Get number of sectors on the disk (DWORD) */
case GET_SECTOR_COUNT :
 if(USBH_MSC_GetLUNInfo(&hUsbHostFS, lun, &info) == USBH_OK)
{
  *(DWORD*)buff = info.capacity.block_nbr;
  res = RES_OK;
}
 else
{
  res = RES_ERROR;
}
 break;

/* Get R/W sector size (WORD) */
case GET_SECTOR_SIZE :
 if(USBH_MSC_GetLUNInfo(&hUsbHostFS, lun, &info) == USBH_OK)
{
  *(DWORD*)buff = info.capacity.block_size;
  res = RES_OK;
}
 else
{
  res = RES_ERROR;
}
 break;

 /* Get erase block size in unit of sector (DWORD) */
case GET_BLOCK_SIZE :

 if(USBH_MSC_GetLUNInfo(&hUsbHostFS, lun, &info) == USBH_OK)
{
  *(DWORD*)buff = info.capacity.block_size / USB_DEFAULT_BLOCK_SIZE;
  res = RES_OK;
}
 else
{
  res = RES_ERROR;
}
 break;

default:
 res = RES_PARERR;
}

return res;
}

2.6、获取当前时间

  实时时钟函数get_fattime。用于获取当前时间，返回一个32位无符号整数，时钟信息包含在这32位中。如果不使用时间戳，可以直接返回一个数，如0。其函数原型如下：

  DWORD get_fattime(Void)；

  根据其原型定义以及我们USB大容量存储设备的要求，我们可以实现磁盘状态获取函数如下：

/*读取时钟函数*/
DWORD get_fattime(void)
{

return 0;

}

  完成上述6个程序的编写，移植工作也就基本完成了。大家可能会发现，我们实现的函数名似乎与原型函数不一样，主要是考虑方便在多个存储设备同时存在时进行操作，我们在目标函数中调用我们实现的函数就可以了。

3、应用测试

  我们完成了FatFS的移植，现在来验证移植的是否正确。为此，我们来编写一个应用，向U盘中写入数据到文件以及读取文件的数据等。

/* USB HOST MSC操作函数，这部分功能根据需求设定 */
static void MSC_Application(void)
{
 FRESULT res;                      /* FatFs函数返回值 */
 uint32_t byteswritten, bytesread;           /* 文件读写的数量 */
 uint8_t wtext[] = "This is STM32 working with FatFs!"; /* 写文件缓冲器 */
uint8_t wtext2[] = "这是一个FatFs读写的例子！"; /* 写文件缓冲器 */
uint8_t wtext3[] = "这是一个向文件追加数据的测试！"; /* 写文件缓冲器 */
 uint8_t rtext[100];                  /* 读文件缓冲器 */
 
 /* 注册文件系统对象到FatFs模块 */
 if(f_mount(&USBHFatFS, (TCHAR const*)USBHPath, 0) != FR_OK)
{
   /* 错误处理 */
   Error_Handler();
}
 else
{
   /* 打开一个文件 */
   if(f_open(&USBHFile, "STM32.TXT", FA_OPEN_EXISTING | FA_WRITE) != FR_OK)
  {
     /* 错误处理 */
     Error_Handler();
  }
   else
  {
     res=f_lseek(&USBHFile,f_size(&USBHFile));  //将指针指向文件末
     //res=f_lseek(&USBHFile,100); //将指针指向文件末
     /* 写数据到文件 */
     res = f_write(&USBHFile, wtext, sizeof(wtext), (void *)&byteswritten);
     res = f_write(&USBHFile, "\r\n", sizeof("\r\n")-1, &byteswritten);
     res = f_write(&USBHFile, wtext2, sizeof(wtext2), (void *)&byteswritten);
     res = f_write(&USBHFile, "\r\n", sizeof("\r\n")-1, &byteswritten);
     res = f_write(&USBHFile, wtext3, sizeof(wtext3), (void *)&byteswritten);
     res = f_write(&USBHFile, "\r\n", sizeof("\r\n")-1, &byteswritten);
     
     if((byteswritten == 0) || (res != FR_OK))
    {
       /* 错误处理 */
       Error_Handler();
    }
     else
    {
       /* 关闭文件 */
       f_close(&USBHFile);
       
       /* 打开文件读 */
       if(f_open(&USBHFile, "STM32.TXT", FA_READ) != FR_OK)
      {
         /* 错误处理 */
         Error_Handler();
      }
       else
      {
         /* 从文件读数据 */
         res = f_read(&USBHFile, rtext, sizeof(rtext), (void *)&bytesread);
         
         if((bytesread == 0) || (res != FR_OK))
        {
           /* 错误处理 */
           Error_Handler();
        }
         else
        {
           /* 关闭文件 */
           f_close(&USBHFile);
           
           /* 比较读和写的数据 */
           if((bytesread != byteswritten))
          {        
             /* 错误处理*/
             Error_Handler();
          }
           else
          {
             /* 无错误 */
             
          }
        }
      }
    }
  }
}
 
 FATFS_UnLinkDriver(USBHPath);
}

  我们先在U盘上创建的文件，名为“STM32.TXT”，在上述源码中，我们创建完文件后将其修改为打开与存在文件。创建的文件如下图所示：

图片

  向创建的STM32.TXT文件中写入“This is STM32 working with FatFs!”，我们查看文件内容，结果如下：

图片

  接着我们尝试向已经存在的文件中追加内容。依然是STM32.TXT文件，我们操作完毕，查看其内容图下：

图片

  至此，我们完成了FatFS文件系统的移植与测试，从测试结果看，移植是正确的，至少在简单应用下没有发现问题。

4、移植小结

  在这篇中，我们移植了FatFS文件系统，并进行了简单的读写测试。从测试的结果来看，FatFS的一直是没有问题的，至少验证了在一般的读写操作方面是没有问题的。

  在我们移植时，我们考虑到在同时有多种驱动器的情况下能够方便的操作。我们定义的磁盘IO操作函数是需要根据实际硬件实现的，然后在系统指定的回调函数中调用我们编写的磁盘IO函数。这样就可以实现多个驱动器的操作，事实上FatFS给出的磁盘IO示例中也是这样建议的。

m0_61687959
关注
  • 0
    点赞
  • 踩
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
一个适用片内资源较小的单片机的文件系统
02-28
一个适用片内资源较小的单片机的文件系统，fatfs的简化版 Petit FATFS。压缩包内有文件系统源代码，移植例程，移植教程。适合向arm过渡
FATFS文件系统复制文件和文件夹
10-22
FATFS文件系统复制文件和文件夹
单片机读写U盘FAT32或FAT16文件系统.pdf
07-14
单片机读写U盘FAT32或FAT16文件系统.pdf
鸿蒙轻内核M核源码分析：LibC实现之Musl LibC
华为云官方博客
01-24 2054
摘要：本文学习了LiteOS-M内核Musl LibC的实现，特别是文件系统和内存分配释放部分。
STM32的FATFS文件系统
扬帆起航
03-21 3243
STM32的FATFS文件系统
单片机（嵌入式）程序分层架构
热门推荐
04-26 1万+
前言 疫情带来的灾难，使得世界处于不稳定状态，全球缺芯片成为常态。对从事单片机和嵌入式底层的开发人员来增加很多的工作量，若是不注重代码分层或者分层不好的将是多么痛苦，老项目换芯片换个不停，新项目做好几套芯片方案。若有良好的分层思想，将是减少很多工作量！ 最初的单片机开发语言是汇编语言，但汇编语言会随着单片机种类的不同而不同。程序设计起来难度较大。后来人们改用C语言作为单片机程序设计的通用语言。这种不依赖于机器硬件的语言，可以方便的在各类单片机系统中移植，极大的加快了单片机......
MCU 常用的文件系统
jieliangzi的博客
12-31 2176
MCU 文件系统
【Fatfs】f_close返回FR_DISK_ERR
听过好多编程语言的名字，但又学不会，偶然学会最厉害的操作sudo rm -rf /*（别尝试哦！我不知道干嘛用的哦~），忘记谁教我了。喜欢看开源代码。。。就跟看天书一样。
10-08 3847
项目涉及到数据存储，由于时间比较赶，采用Fatfs文件系统，直接通过STM32CubeMX生成代码。在补全Fatfs底层I/O接口之后，测试读写数据是否正常。结果出乎意料，第一次f_open文件是成功的，第二次f_open直接返回FR_LOCKED。经过很久的排查，才发现第一次f_close返回了FR_DISK_ERR。简单来说，我们实际移植出错，大多还是我们的底层有问题。Fatfs官方上层代码肯定经过测试才发布，因此，我们只需要检测底层接口哪里出问题。
MCU常见的操作系统介绍
Wang_XB_3434的博客
04-11 2634
MCU微控制器几种常见的操作系统各自的优缺点介绍。
芯片，SOC和MCU区别；裸机和带系统
Xueqian E的博客
06-28 1万+
SOC就是集成了很多个MCU的功能，以前的由多个MCU协同干的事情被集成了，MCU没有了，取而代之的是对外的IO引脚，连接IO引脚就可以实现交互，完成以前MCU的功能。 架构上，SOC就是MCU+外围控制器，也可以理解成为就是以前的MCU芯片变成了一些控制器controller，这些controller来处理问题，然后对外给出IO脚就够了。MCU就是一块芯片，然后外围都是一些硬件接口，MCU芯片控制这些硬件接口实现各种功能。它并不是多块芯片的集成。总而言之，MCU实现功能靠的是外围的一些硬件接口，变
手把手教-单片机stm32基于w25q128使用文件系统
weixin_46158019的博客
07-10 1026
一、开发测试环境①野火stm32f407开发板②rtthread操作系统W25Q128的电路原理图：二、开发步骤①使能spi驱动。②使能spibus/device 驱动，选择sfud驱动。③开启dfs功能，选择elm文件系统。④保存，重新生成工程。⑤下载到开发板，查看设备，可以看到设备spi1⑥添加测试代码。总线（spi1）挂载spi从设备（spi10）；使用 SFUD 探测 spi10 从设...
FatFS文件系统函数说明
05-10
FATFS是一个为小型嵌入式系统设计的通用FAT(File Allocation Table)文件系统模块，本文主要介绍相关的函数及使用方法
FATFS 文件系统源码
05-10
FATFS 文件系统源码，内附官方文档及移植方式
FatFs 文件系统在nor flash 移植
09-03
FatFs Module Source Files R0.12 FILES 00readme.txt This file. history.txt Revision history. ffconf.h Configuration file for FatFs module. ff.h Common include file for FatFs and application ...
FATFS文件系统源码
01-07
FATFS文件系统源码，版本是 FatFs R0.14，适用于SD卡和FLASH的读写，支持STM32、C51等单片机
STM32&SD卡实现USB虚拟U盘
zhang062061的专栏
02-02 8320
下载源码请关注公众号 之前的文章中介绍过STM32读写SD卡和FatFS文件系统相关的知识。今天将在这基础上介绍STM32通过USB口虚拟U盘的知识。即插入USB接口后，电脑将SD卡识别为U盘，可以直接读写SD卡内的文件。 硬件环境：STM32F407ZGT6 软件环境：STM32CubeMX v5.5.0 HAL库版本：STM32CubeF4 Firmware Package V1.24.0 1.STM32CubeMX配置 首先SD卡为SDIO接口，时钟等基础配置、SD...
MCU平台下一种简单的文件系统设计构想
最新发布
propor的专栏
12-13 249
MCU,简单文件系统
闪存文件系统基本操作-----ESP8266
zuoheizhu的博客
06-16 450
在自带的4Mflash中，有一部分，会用来存放（程序）（系统）剩下的才是（系统文件） 转载： http://www.taichi-maker.com/homepage/esp8266-nodemcu-iot/iot-c/spiffs/spiffs-operation/ /********************************************************************** 项目名称/Project : 零基础入门学用物联网 程序名称/Program
MCU Flash中的只读文件系统
Sugar的专栏
11-27 2294
ROM文件系统 ROM文件系统（ROMFS）是一个由eLua构建的微型的，只读的文件系统，它与C库集成在一起，所以你可以使用标准的POSIX（fopen/fclose/fwrite...）来操作它。它也可以直接通过Lua的io模块来控制。这个文件系统中的文件是eLua二进制镜像中的一部分，所以镜像构建以后它们不能被修改。因为同样的原因，在镜像构建后你不能增加或删除镜像文件。ROMFS不支持子目录
fatfs文件系统应用程序手册
11-04
FatFs是一个嵌入式文件系统适配层，可以方便地在嵌入式系统中使用各种不同的存储设备，如SD卡、USB闪存，以及内存等。FatFs文件系统应用程序手册提供了关于如何使用FatFs文件系统的详细说明和使用指南。 首先，该手册介绍了FatFs的概念和原理，以及使用FatFs的好处和功能。它解释了FatFs中的一些重要概念，如文件和目录的层次结构，文件操作的函数接口等。 接下来，手册提供了使用FatFs的步骤和示例代码。它详细解释了如何初始化FatFs，如何打开、创建、读取和写入文件，以及如何在文件和目录之间进行导航。示例代码演示了如何使用各种文件操作函数，例如f_open、f_read、f_write等。 此外，手册还介绍了FatFs的一些高级功能，如长文件名支持、同步和异步操作、多任务支持等。它解释了如何使用这些功能，并提供了相关的示例代码和使用建议。 最后，手册还包括一些常见问题的解答和错误处理的建议。它列出了一些可能遇到的问题和解决方法，以帮助开发人员在使用FatFs时更好地处理错误和异常情况。 总之，FatFs文件系统应用程序手册是一个很好的指南，提供了使用FatFs文件系统的详细说明和指导。通过阅读和理解该手册，开发人员可以更好地使用FatFs文件系统，从而方便地在嵌入式系统中处理各种存储设备中的文件操作。

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

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

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值