STM32_FATFS文件系统

最新推荐文章于 2024-09-14 23:08:44 发布

小枫Geek

最新推荐文章于 2024-09-14 23:08:44 发布

阅读量729

点赞数

分类专栏： STM32 文章标签： stm32

本文链接：https://blog.csdn.net/m0_65592409/article/details/125277849

版权

STM32 专栏收录该内容

10 篇文章 5 订阅

订阅专栏

前言

FATFS 是一个完全免费开源的 FAT 文件系统模块，专门为小型的嵌入式系统而设计。它完全用标准 C 语言编写，所以具有良好的硬件平台独立性，可以移植到 8051、 PIC、 AVR、 SH、Z80、 H8、 ARM 等系列单片机上而只需做简单的修改。它支持 FATl2、 FATl6 和 FAT32，支持多个存储媒介；有独立的缓冲区，可以对多个文件进行读／写，并特别对 8 位单片机和 16 位单片机做了优化。

FATFS 的特点

 Windows 兼容的 FAT 文件系统（支持 FAT12/FAT16/FAT32）
 与平台无关，移植简单
 代码量少、效率高
 多种配置选项
 支持多卷（物理驱动器或分区，最多 10 个卷）
 多个 ANSI/OEM 代码页包括 DBCS
 支持长文件名、 ANSI/OEM 或 Unicode
 支持 RTOS
 支持多种扇区大小
 只读、最小化的 API 和 I/O 缓冲区等

FATFS 模块的层次结构图

底层接口，包括存储媒介读／写接口（ disk I/O ）和供给文件创建修改时间的实时时钟，需要我们根据平台和存储介质编写移植代码。
中间层 FATFS 模块，实现了 FAT 文件读／写协议。 FATFS 模块提供的是 ff.c 和 ff.h 。除非有必要，使用者一般不用修改，使用时将头文件直接包含进去即可。
最顶层是应用层，使用者无需理会 FATFS 的内部结构和复杂的 FAT 协议，只需要调用 FATFS 模块提供给用户的一系列应用接口函数，如 f_open ， f_read ， f_write 和 f_close 等，就可以像在 PC 上读／写文件那样简单。

FATFS的源码下载地址

解压后可以得到两个文件夹： doc 和 src。 doc 里面主要是对 FATFS 的介绍，而 src 里面才是我们需要的源码。

FatFs - Generic FAT Filesystem Modulehttp://elm-chan.org/fsw/ff/00index_e.html 文件系统包结构

文件名	功能	说明
ffconf.h	FATFS模块配置文件	需要根据需求来配置参数。
ff.h	FATFS和应用模块公用的包含文件	不需要修改
ff.c	FATFS模块源码	不需要修改
diskio.h	FATFS和disk I/O模块公用的包含文件	不需要修改
diskio.c	FATFS和disk I/O模块接口层文件	与平台相关的代码,需要用户根据存储介质来编写函数。
interger.h	数据类型定义	与编译器有关。
option文件夹	可选的外部功能（比如支持中文等）	汉字实验把字库放到SPI FLASH需要修改

FATFS关键配置文件

FATFS模块的所有配置项都是存放在 ffconf.h里面，我们可以通过配置里面的一些选项，来满足自己的需求。

1） _FS_TINY。这个选项在 R0.07 版本中开始出现，之前的版本都是以独立的 C 文件出现（FATFS 和 Tiny FATFS），有了这个选项之后，两者整合在一起了，使用起来更方便。我们使用 FATFS，所以把这个选项定义为 0 即可。

2） _FS_READONLY。这个用来配置是不是只读，本章我们需要读写都用，所以这里设置为 0 即可。

3） _USE_STRFUNC。这个用来设置是否支持字符串类操作，比如 f_putc， f_puts 等，本章我们需要用到，故设置这里为 1。

4） _USE_MKFS。这个用来定时是否使能格式化，本章需要用到，所以设置这里为 1。

5） _USE_FASTSEEK。这个用来使能快速定位，我们设置为 1，使能快速定位。

6） _USE_LABEL。这个用来设置是否支持磁盘盘符（磁盘名字）读取与设置。我们设置为 1，使能，就可以通过相关函数读取或者设置磁盘的名字了。

7） _CODE_PAGE。这个用于设置语言类型，包括很多选项（见 FATFS 官网说明），我们这里设置为 936，即简体中文（GBK 码，需要 c936.c 文件支持，该文件在 option 文件夹）。

8） _USE_LFN。该选项用于设置是否支持长文件名（还需要_CODE_PAGE 支持），取值范围为 0~3。 0，表示不支持长文件名， 1~3 是支持长文件名，但是存储地方不一样，我们选择使用 3，通过 ff_memalloc 函数来动态分配长文件名的存储区域。

9） _VOLUMES。用于设置 FATFS 支持的逻辑设备数目，我们设置为 2，即支持 2 个设备。

10） _MAX_SS。扇区缓冲的最大值，一般设置为 512。

FATFS 的移植

① 数据类型：在 integer.h 里面去定义好数据的类型。这里需要了解你用的编译器的数据类型，并根据编译器定义好数据类型。

② 配置：通过 ffconf.h 配置 FATFS 的相关功能(上面介绍的10个关键配置文件）

③ 函数编写：打开 diskio.c，进行底层驱动编写，一般需要编写 6 个接口函数：

(因为 FATFS 模块完全与磁盘 I/O 层分开，因此需要下面的函数来实现底层物理磁盘的读写与获取当前时间。底层磁盘 I/O 模块并不是 FATFS 的一部分，并且必须由用户提供。这些函数一般有 6 个，在 diskio.c 里面。 disk_initialize 、disk_status、disk_read、disk_write、disk_ioctl 、get_fattime )

总结

在STM32上使用FATFS文件系统，首先建立项目工程，在FATFS文件系统地址下载相关源码导入工程，接着进行FATFS的移植，在 ffconf.h 上配置FATFS的关键配置，在 diskio.c 上编写6个接口函数，进行底层驱动，完成了对FATFS 的移植，就可以在代码里面使用 FATFS 了。FATFS 提供了很多 API 函数，在使用FATFS的时候，必须先通过f_mount函数注册一个工作区，才能开始后续 API 的使用。