（十）stm32之FATFS

最新推荐文章于 2025-07-16 22:48:37 发布

梦新嵌入式

最新推荐文章于 2025-07-16 22:48:37 发布

阅读量1.1k

点赞数 25

CC 4.0 BY-SA版权

分类专栏： STM32单片机文章标签： stm32 嵌入式硬件单片机

本文链接：https://blog.csdn.net/m0_55389449/article/details/147633459

STM32单片机专栏收录该内容

23 篇文章

订阅专栏

SD 卡的使用，不过仅仅是简单的实现读扇区而已，真正要好好应用SD 卡，必须使用文件系统管理，本章，我们将使用 FATFS 来管理 SD 卡，实现 SD 卡文件的读写等基本功能。

FATFS 简介

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 的这些特点，加上免费、开源的原则，使得 FATFS 应用非常广泛。FATFS 模块的层
次结构如图
在这里插入图片描述
最顶层是应用层，使用者无需理会 FATFS 的内部结构和复杂的 FAT 协议，只需要调用
FATFS 模块提供给用户的一系列应用接口函数，如 f_open，f_read，f_write 和 f_close 等，就可以像在 PC 上读／写文件那样简单。
中间层 FATFS 模块，实现了 FAT 文件读／写协议。FATFS 模块提供的是 ff.c 和 ff.h。除非
有必要，使用者一般不用修改，使用时将头文件直接包含进去即可。
需要我们编写移植代码的是 FATFS 模块提供的底层接口，它包括存储媒介读／写接口（disk
I/O）和供给文件创建修改时间的实时时钟。
FATFS 的源码，大家可以在：http://elm-chan.org/fsw/ff/00index_e.html 这个网站下载到。

其中，与平台无关的是：
ffconf.h FATFS 模块配置文件
ff.h FATFS 和应用模块公用的包含文件
ff.c FATFS 模块
diskio.h FATFS 和 disk I/O 模块公用的包含文件
interger.h 数据类型定义
option 可选的外部功能（比如支持中文等）
与平台相关的代码（需要用户提供）是：diskio.c FATFS 和 disk I/O 模块接口层文件
FATFS 模块在移植的时候，我们一般只需要修改 2 个文件，即 ffconf.h 和 diskio.c。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 的说明文档里面有很详细的介绍，大家自
己阅读即可。下面我们来讲讲 FATFS 的移植，FATFS 的移植主要分为 3 步：
① 数据类型：在 integer.h 里面去定义好数据的类型。这里需要了解你用的编译器的数
据类型，并根据编译器定义好数据类型。
② 配置：通过 ffconf.h 配置 FATFS 的相关功能，以满足你的需要。
③ 函数编写：打开 diskio.c，进行底层驱动编写，一般需要编写 6 个接口函数，如图
在这里插入图片描述
通过以上三步，我们即可完成对 FATFS 的移植。
第一步，我们使用的是 MDK5 编译器，器数据类型和 integer.h 里面定义的一致，所以此步，
我们不需要做任何改动。
第二步，关于 ffconf.h 里面的相关配置，我们在前面已经有介绍（之前介绍的 10 个配置），
我们将对应配置修改为我们介绍时候的值即可，其他的配置用默认配置。
第三步，因为 FATFS 模块完全与磁盘 I/O 层分开，因此需要下面的函数来实现底层物理磁
盘的读写与获取当前时间。底层磁盘 I/O 模块并不是 FATFS 的一部分，并且必须由用户提供。
这些函数一般有 6 个，在 diskio.c 里面。
首先是 disk_initialize 函数，该函数介绍如图
在这里插入图片描述
第二个函数是 disk_status 函数，该函数介绍如图

第三个函数是 disk_read 函数，该函数介绍如图

第四个函数是 disk_write 函数，该函数介绍如图

第五个函数是 disk_ioctl 函数，该函数介绍如图

最后一个函数是 get_fattime 函数，该函数介绍如图
在这里插入图片描述
以上六个函数，我们将在软件设计部分一一实现。通过以上 3 个步骤，我们就完成了对
FATFS 的移植，就可以在我们的代码里面使用 FATFS 了。
FATFS 提供了很多 API 函数，这些函数 FATFS 的自带介绍文件里面都有详细的介绍(包括
参考代码)，我们这里就不多说了。这里需要注意的是，在使用FATFS的时候，必须先通过f_mount函数注册一个工作区，才能开始后续 API 的使用，关于 FATFS 的介绍，我们就介绍到这里。大家可以通过 FATFS 自带的介绍文件进一步了解和熟悉 FATFS 的使用。