《野火STM32F407 霸天虎版》学习笔记——第 26 章 串行 FLASH 文件系统 FatFs

---

前言

上一章我们已经写好了 SPI Flash 芯片的驱动函数，我们可以非常方便的在 SPI Flash 芯片上读写数据。本章我们来看看如何使用文件系统做到对SPI Flash当中的数据进行存储和管理。

---

一、文件系统

文件系统，它是为了存储和管理数据，而在存储介质建立的一种组织结构，这些结构包括操作系统引导区、目录和文件。常见的 windows 下的文件系统格式包括 FAT32、NTFS、exFAT。在使用文件系统前，要先对存储介质进行格式化。格式化先擦除原来内容，在存储介质上新建一个文件分配表和目录。这样，文件系统就可以记录数据存放的物理地址，剩余空间。

使用文件系统时，数据都以文件的形式存储。写入新文件时，先在目录中创建一个文件索引，它指示了文件存放的物理地址，再把数据存储到该地址中。当需要读取数据时，可以从目录中找到该文件的索引，进而在相应的地址中读取出数据。具体还涉及到逻辑地址、簇大小、不连续存储等一系列辅助结构或处理过程。

文件系统的存在使我们在存取数据时，不再是简单地向某物理地址直接读写，而是要遵循它的读写格式。如经过逻辑转换，一个完整的文件可能被分开成多段存储到不连续的物理地址，使用目录或链表的方式来获知下一段的位置。

---

二、FatFs 文件系统简介

FatFs 是面向小型嵌入式系统的一种通用的 FAT 文件系统。它完全是由 ANSIC 语言编写并且完
全独立于底层的 I/O 介质。因此它可以很容易地不加修改地移植到其他的处理器当中我们可以利用前面写好的 SPI Flash 芯片驱动，把 FatFs 文件系统代码移植到工程之中，就可以利用文件系统的各种函数，对 SPI Flash 芯片以“文件”格式进行读写操作了。

1.FatFs 的目录结构

在移植 FatFs 文件系统到开发板之前，我们先要到 FatFs 的官网获取源码。解压之后可看到里面有 doc 和 src 这两个文件夹，doc 文件夹里面是一些使用帮助文档；src 才是 FatFs 文件系统的源码。

2.FatFs 帮助文档

打开 doc 文件夹，00index_e.html 和 00index_j.html是一些关于 FATFS 的简介，以及 FATFS 里面各个函数的使用方法。（e是英文，j是日文）

3.FATFS 源码

打开 src 文件夹：

option 文件夹下是一些可选的外部 c 文件，包含了多语言支持需要用到的文件和转换函数。
diskio.c 文件是 FatFs 移植最关键的文件，它为文件系统提供了最底层的访问 SPI Flash 芯片的方法，FatFs 有且仅有它需要用到与 SPI Flash 芯片相关的函数。diskio.h 定义了 FatFs 用到的宏，以及 diskio.c 文件内与底层硬件接口相关的函数声明。

src 文件夹下的源码文件功能简介如下：

• integer.h：文件中包含了一些数值类型定义。
• diskio.c：包含底层存储介质的操作函数，这些函数需要用户自己实现，主要添加底层驱动函数。
• ff.c：FatFs 核心文件，文件管理的实现方法。该文件独立于底层介质操作文件的函数，利用这些函数实现文件的读写。
• cc936.c：本文件在 option 目录下，是简体中文支持所需要添加的文件，包含了简体中文的GBK 和 Unicode 相互转换功能函数。
• ffconf.h: 这个头文件包含了对 FatFs 功能配置的宏定义，通过修改这些宏定义就可以裁剪FatFs 的功能。如需要支持简体中文，需要把 ffconf.h 中的 _CODE_PAGE 的宏改成 936 并把上面的cc936.c 文件加入到工程之中。

---

三、FatFs 文件系统移植实验

1.FatFs 程序结构图

用户应用程序需要由用户编写，想实现什么功能就编写什么的程序，一般我们只用到 f_mount()、f_open()、f_write()、f_read() 就可以实现文件的读写操作。

FatFs 组件是 FatFs 的主体，文件都在源码 src 文件夹中，其中 ff.c、ff.h、integer.h 以及 diskio.h 四个文件我们不需要改动，只需要修改 ffconf.h 和 diskio.c 两个文件。

底层设备输入输出要求实现存储设备的读写操作函数、存储设备信息获取函数等等。我们使用SPI Flash 芯片作为物理设备，在上一章节已经编写好了 SPI Flash 芯片的驱动程序，这里我们就直接使用。

2.硬件设计

FatFs 属于软件组件，不需要附带其他硬件电路。我们使用 SPI Flash 芯片作为物理存储设备，其硬件电路在上一章已经做了分析，这里就直接使用。

3.FatFs 移植步骤

1. 先拷贝一份 SPI Flash 芯片测试的工程文件，将 FatFs 源码中的 src 文件夹整个文件夹拷贝一份至前者工程文件当中。
2. 使用 KEIL 软件打开工程文件，并将 FatFs 组件文件添加到工程中。
3. 如果现在编译工程，可以发现有两个错误，一个是来自 diskio.c 文件，提示有一些头文件没找到，diskio.c 文件内容是与底层设备输入输出接口函数文件，不同硬件设计驱动就不同，需要的文件也不同；另外一个错误来自 cc936.c 文件，提示该文件不是工程所必需的，这是因为 FatFs 默认使用日语，我们想要支持简体中文需要修改 FatFs 的配置，即修改 ffconf.h 文件。

4.FatFs 底层设备驱动函数

FatFs 文件系统与底层介质的驱动分离开来，对底层介质的操作都要交给用户去实现，它仅仅是提供了一个函数接口而已。

表 “FatFs 移植需要用户支持函数”：

通过表 “FatFs 移植需要用户支持函数”我们可以清晰知道很多函数是在一定条件下才需要添加的，前三个函数是实现读文件最基本需求。接下来三个函数是实现创建文件、修改文件需要的。为实现格式化功能，需要在 disk_ioctl 添加两个获取物理设备信息选项。我们一般只要实现前面六个函数就可以了，已经足够满足大部分功能。

为支持简体中文长文件名称需要添加 ff_convert 和 ff_wtoupper 函数，实际这两个已经在 cc936.c
文件中实现，我们只要直接把 cc936.c 文件添加到工程中就可以。

底层设备驱动函数是存放在 diskio.c 文件，我们的目的就是把 diskio.c 中的函数接口与 SPI Flash 芯
片驱动连接起来。总共有五个函数，分别为设备状态获取 (disk_status)、设备初始(disk_initialize)、扇区读取 (disk_read)、扇区写入 (disk_write)、其他控制 (disk_ioctl)。

5.FatFs 功能配置

1 #define _USE_MKFS 1
2 #define _CODE_PAGE 936
3 #define _USE_LFN 2
4 #define _VOLUMES 2
5 #define _MIN_SS 512
6 #define _MAX_SS 4096

1. _USE_MKFS：格式化功能选择，为使用 FatFs 格式化功能，需要把它设置为 1。
2. _CODE_PAGE：语言功能选择，并要求把相关语言文件添加到工程宏。为支持简体中文文件名
   需要使用“936”，正如在图添加 FatFS 文件到工程 的操作，我们已经把 cc936.c 文件添加到工程中。
3. _USE_LFN：长文件名支持，默认不支持长文件名，这里配置为 2，支持长文件名，并指定使用栈空间为缓冲区。
4. _VOLUMES：指定物理设备数量，这里设置为 2，包括预留 SD 卡和 SPI Flash 芯片。
5. _MIN_SS 、_MAX_SS：指定扇区大小的最小值和最大值。SD 卡扇区大小一般都为 512 字节，SPI Flash 芯片扇区大小一般设置为 4096 字节，所以需要把 _MAX_SS 改为 4096。

---