FatFS文件系统在MCU上的应用

strongerHuang 2023-09-21 08:20

关注+星标公众,不错过精彩内容

转自 | 木南创智


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示例中也是这样建议的。

声明:本文素材来源网络,版权归原作者所有。如涉及作品版权问题,请与我联系删除。
------------ END ------------


●专栏《嵌入式工具
●专栏《嵌入式开发》
●专栏《Keil教程》
●嵌入式专栏精选教程

关注公众号回复“加群”按规则加入技术交流群,回复“1024”查看更多内容。




点击“阅读原文”查看更多分享。

strongerHuang 作者黄工,高级嵌入式软件工程师,分享嵌入式软硬件、物联网、单片机、开发工具、电子等内容。
评论
  • 首先在gitee上打个广告:ad5d2f3b647444a88b6f7f9555fd681f.mp4 · 丙丁先生/香河英茂工作室中国 - Gitee.com丙丁先生 (mr-bingding) - Gitee.com2024年对我来说是充满挑战和机遇的一年。在这一年里,我不仅进行了多个开发板的测评,还尝试了多种不同的项目和技术。今天,我想分享一下这一年的故事,希望能给大家带来一些启发和乐趣。 年初的时候,我开始对各种开发板进行测评。从STM32WBA55CG到瑞萨、平头哥和平海的开发板,我都
    丙丁先生 2024-12-11 20:14 68浏览
  • 全球智能电视时代来临这年头若是消费者想随意地从各个通路中选购电视时,不难发现目前市场上的产品都已是具有智能联网功能的智能电视了,可以宣告智能电视的普及时代已到临!Google从2021年开始大力推广Google TV(即原Android TV的升级版),其他各大品牌商也都跟进推出搭载Google TV操作系统的机种,除了Google TV外,LG、Samsung、Panasonic等大厂牌也开发出自家的智能电视平台,可以看出各家业者都一致地看好这块大饼。智能电视的Wi-Fi连线怎么消失了?智能电
    百佳泰测试实验室 2024-12-12 17:33 25浏览
  • 在智能化技术快速发展当下,图像数据的采集与处理逐渐成为自动驾驶、工业等领域的一项关键技术。高质量的图像数据采集与算法集成测试都是确保系统性能和可靠性的关键。随着技术的不断进步,对于图像数据的采集、处理和分析的需求日益增长,这不仅要求我们拥有高性能的相机硬件,还要求我们能够高效地集成和测试各种算法。我们探索了一种多源相机数据采集与算法集成测试方案,能够满足不同应用场景下对图像采集和算法测试的多样化需求,确保数据的准确性和算法的有效性。一、相机组成相机一般由镜头(Lens),图像传感器(Image
    康谋 2024-12-12 09:45 74浏览
  • 应用环境与极具挑战性的测试需求在服务器制造领域里,系统整合测试(System Integration Test;SIT)是确保产品质量和性能的关键步骤。随着服务器系统的复杂性不断提升,包括:多种硬件组件、操作系统、虚拟化平台以及各种应用程序和服务的整合,服务器制造商面临着更有挑战性的测试需求。这些挑战主要体现在以下五个方面:1. 硬件和软件的高度整合:现代服务器通常包括多个处理器、内存模块、储存设备和网络接口。这些硬件组件必须与操作系统及应用软件无缝整合。SIT测试可以帮助制造商确保这些不同组件
    百佳泰测试实验室 2024-12-12 17:45 19浏览
  • 一、SAE J1939协议概述SAE J1939协议是由美国汽车工程师协会(SAE,Society of Automotive Engineers)定义的一种用于重型车辆和工业设备中的通信协议,主要应用于车辆和设备之间的实时数据交换。J1939基于CAN(Controller Area Network)总线技术,使用29bit的扩展标识符和扩展数据帧,CAN通信速率为250Kbps,用于车载电子控制单元(ECU)之间的通信和控制。小北同学在之前也对J1939协议做过扫盲科普【科普系列】SAE J
    北汇信息 2024-12-11 15:45 108浏览
  • 习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习笔记&记录学习习笔记&记学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记
    youyeye 2024-12-12 10:13 17浏览
  • 习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习笔记&记录学习习笔记&记学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记
    youyeye 2024-12-11 17:58 83浏览
  • RK3506 是瑞芯微推出的MPU产品,芯片制程为22nm,定位于轻量级、低成本解决方案。该MPU具有低功耗、外设接口丰富、实时性高的特点,适合用多种工商业场景。本文将基于RK3506的设计特点,为大家分析其应用场景。RK3506核心板主要分为三个型号,各型号间的区别如下图:​图 1  RK3506核心板处理器型号场景1:显示HMIRK3506核心板显示接口支持RGB、MIPI、QSPI输出,且支持2D图形加速,轻松运行QT、LVGL等GUI,最快3S内开
    万象奥科 2024-12-11 15:42 83浏览
  • 天问Block和Mixly是两个不同的编程工具,分别在单片机开发和教育编程领域有各自的应用。以下是对它们的详细比较: 基本定义 天问Block:天问Block是一个基于区块链技术的数字身份验证和数据交换平台。它的目标是为用户提供一个安全、去中心化、可信任的数字身份验证和数据交换解决方案。 Mixly:Mixly是一款由北京师范大学教育学部创客教育实验室开发的图形化编程软件,旨在为初学者提供一个易于学习和使用的Arduino编程环境。 主要功能 天问Block:支持STC全系列8位单片机,32位
    丙丁先生 2024-12-11 13:15 63浏览
  • 铁氧体芯片是一种基于铁氧体磁性材料制成的芯片,在通信、传感器、储能等领域有着广泛的应用。铁氧体磁性材料能够通过外加磁场调控其导电性质和反射性质,因此在信号处理和传感器技术方面有着独特的优势。以下是对半导体划片机在铁氧体划切领域应用的详细阐述: 一、半导体划片机的工作原理与特点半导体划片机是一种使用刀片或通过激光等方式高精度切割被加工物的装置,是半导体后道封测中晶圆切割和WLP切割环节的关键设备。它结合了水气电、空气静压高速主轴、精密机械传动、传感器及自动化控制等先进技术,具有高精度、高
    博捷芯划片机 2024-12-12 09:16 80浏览
  • 本文介绍瑞芯微RK3588主板/开发板Android12系统下,APK签名文件生成方法。触觉智能EVB3588开发板演示,搭载了瑞芯微RK3588芯片,该开发板是核心板加底板设计,音视频接口、通信接口等各类接口一应俱全,可帮助企业提高产品开发效率,缩短上市时间,降低成本和设计风险。工具准备下载Keytool-ImportKeyPair工具在源码:build/target/product/security/系统初始签名文件目录中,将以下三个文件拷贝出来:platform.pem;platform.
    Industio_触觉智能 2024-12-12 10:27 21浏览
  • 近日,搭载紫光展锐W517芯片平台的INMO GO2由影目科技正式推出。作为全球首款专为商务场景设计的智能翻译眼镜,INMO GO2 以“快、准、稳”三大核心优势,突破传统翻译产品局限,为全球商务人士带来高效、自然、稳定的跨语言交流体验。 INMO GO2内置的W517芯片,是紫光展锐4G旗舰级智能穿戴平台,采用四核处理器,具有高性能、低功耗的优势,内置超微高集成技术,采用先进工艺,计算能力相比同档位竞品提升4倍,强大的性能提供更加多样化的应用场景。【视频见P盘链接】 依托“
    紫光展锐 2024-12-11 11:50 69浏览
  • 时源芯微——RE超标整机定位与解决详细流程一、 初步测量与问题确认使用专业的电磁辐射测量设备,对整机的辐射发射进行精确测量。确认是否存在RE超标问题,并记录超标频段和幅度。二、电缆检查与处理若存在信号电缆:步骤一:拔掉所有信号电缆,仅保留电源线,再次测量整机的辐射发射。若测量合格:判定问题出在信号电缆上,可能是电缆的共模电流导致。逐一连接信号电缆,每次连接后测量,定位具体哪根电缆或接口导致超标。对问题电缆进行处理,如加共模扼流圈、滤波器,或优化电缆布局和屏蔽。重新连接所有电缆,再次测量
    时源芯微 2024-12-11 17:11 106浏览
  • 全球知名半导体制造商ROHM Co., Ltd.(以下简称“罗姆”)宣布与Taiwan Semiconductor Manufacturing Company Limited(以下简称“台积公司”)就车载氮化镓功率器件的开发和量产事宜建立战略合作伙伴关系。通过该合作关系,双方将致力于将罗姆的氮化镓器件开发技术与台积公司业界先进的GaN-on-Silicon工艺技术优势结合起来,满足市场对高耐压和高频特性优异的功率元器件日益增长的需求。氮化镓功率器件目前主要被用于AC适配器和服务器电源等消费电子和
    电子资讯报 2024-12-10 17:09 98浏览
我要评论
0
点击右上角,分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦