【STM32】文件系统FATFS与Flash的初步使用

文件系统简介

简介可以不看，直接看移植步骤

文件系统是介于应用层和底层间的模糊层。底层提供API，比如说使用SDIO或者SPI等读写一个字节。文件系统把这些API组合包装起来，并且提供一些列函数，我们可以使用这些函数进行更进一步的对存储设备的操作。

底层：操作单片机外设，读写。需要我们进行配置。
中层：中间层 FATFS 模块，实现了 FAT 文件读／写协议。一般不管
顶层：文件系统提供给我们的函数库，我们就是要使用这些。
FATFS的实现过程(白色框中的内容是需要我们自己实现的也就是底层设备的输入输出以及最高层的用户应用程序，蓝色框由fatfs提供)

源码获取

FATFS 的源码及英文详述，大家可以在：http://elm-chan.org/fsw/ff/00index_e.html 这个网站下载。下载解压之后的根目录下有这么两个文件夹，源码和帮助文档。

DOC文件夹下有Fatfs提供的具体函数的使用方法
SRC文件的构成如下

Fatfs的源码阅读可以参考《零死角玩转 STM32F103—指南者》中的阅读提示，如果只是想使用，那么只需要看如何移植

移植FATFS 准备工作

背景：两个文件 ffconf.h diskio.c

FATFS 模块在移植的时候，我们一般只需要修改 2 个文件，即 ffconf.h 和 diskio.c
ffconf.h :FATFS模块的所有配置项都是存放在 ffconf.h 里面，我们可以通过配置里面的一些选项，来满足自己的需求.FATFS 的说明文档里面有很详细的介绍

以spi读写flash为例，在实现了spi往flash中读写单个字节的底层代码之后，就可以进行fatfs的移植了。

0.创建一个新的工程，并且实现简单的点灯，spi操作等功能。

1.准备一份工程源码称为SPI—FatFs。将。将 FatFs 源码中的 src 文件夹整个文件夹拷贝一份至“SPI—FatFs 文件系统\USER\”文件夹下并修改名为“FATFS”。文件夹名字没有固定名称，这里只是方便书写。

2.打开工程文件,并将 FatFs 组件文件添加到工程中，需要添加有 ff.c、diskio.c 和cc936.c 三个文件.

3.添加 FATFS 文件夹到工程的 include 选项中。打开工程选项对话框，选择“C/C++”选项下的“Include Paths”项目，在弹出路径设置对话框中选择添加“FATFS”文件夹

4.修改 diskio.c 文件和 ffconf.h 文件,diskio.c 文件内容是与底层设备输入输出接口函数文件，不同硬件设计驱动就不同，需要的文件也不同；FatFs默认使用日语，我们想要支持简体中文需要
修改 FatFs 的配置，即修改 ffconf.h 文件。

FatFs 底层设备驱动函数

文件系统实现中间模糊层，提供上层函数给用户使用。需要用户实现底层接口。diskio.c 文件内容就是与底层接口相关的。

移植需要用户支持函数，一般只有前六个需要使用

disk_status，disk_initialize，disk_read是必要配置的。
disk_write，get_fattime，disk_ioctl (CTRL_SYNC)是实现创建文件、修改文件需要的。
为支持简体中文长文件名称需要添加 ff_convert 和 ff_wtoupper 函数，实际这两个已经在 cc936.c 文件中实现，我们只要直接把 cc936.c 文件添加到工程中就可以。

移植FATFS 主要步骤

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

2.配置：通过 ffconf.h 配置 FATFS 的相关功能，以满足你的需要。

3.函数编写：打开 diskio.c，进行底层驱动编写，需要编写 5 个接口函数。

配置integer.h 以定义数据类型(一般不需要)

我们使用的是 MDK5.34 编译器，数据类型和 integer.h 里面定义的一致，所以此步，我们不需要做任何改动。

配置 ffconf.h 选择模式

关于 ffconf.h 里面的相关配置，配置修改为我们需要的值即可，其他的配置用默认配置。

1 #define _USE_MKFS 1	//格式化功能选择，为使用 FatFs 格式化功能，需要把它设置为 1。
2 #define _CODE_PAGE 936	//语言功能选择，并要求把相关语言文件添加到工程宏。为支持简体中文文件名需要使用“936” 指的是把 cc936.c 文件添加到工程中
3 #define _USE_LFN 2	//长文件名支持，默认不支持长文件名，这里配置为 2，支持长文件名，并指定使用栈空间为缓冲区。
4 #define _VOLUMES 2	//指定物理设备数量
5 #define _MIN_SS 512	//指定扇区大小的最小值和最大值。SD 卡扇区大小一般都为 512字节，SPI Flash芯片扇区大小一般设置为 4096字节
6 #define _MAX_SS 4096	//指定扇区大小的最小值和最大值
1
2
3
4
5
6

为每个设备定义一个物理编号

 #define ATA 	0 	// 预留 SD 卡使用
 #define SPI_FLASH 	1 // 外部 SPI Flash
1
2

实现五个函数

设备状态获取(disk_status)、设备初始化(disk_initialize)、扇区读取(disk_read)、扇区写(disk_write)、其他控制(disk_ioctl)。

disk_initialize

DSTATUS disk_status (BYTE pdrv /* 物理编号 */)
{
DSTATUS status = STA_NOINIT;
switch (pdrv) {
	case ATA: /* SD CARD 预留，也可以*/
		 break;
 	case SPI_FLASH: /* SPI Flash 状态检测：读取 SPI Flash 设备 ID */
		 if (sFLASH_ID == SPI_FLASH_ReadID()) {/* 设备 ID 读取结果正确 */
 				status &= ~STA_NOINIT;
 			} else { /* 设备 ID 读取结果错误 */
				 status = STA_NOINIT;
			 }
		 break;
 	default:
		 status = STA_NOINIT;
		 }
	 return status;
	  }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

注意点
SPI_FLASH_ReadID函数由用户自己实现，目的是检测设备是否已经就绪。

disk_status

DSTATUS disk_initialize (BYTE pdrv /* 物理编号 */)
{	uint16_t i;
	DSTATUS status = STA_NOINIT;
	switch (pdrv) {
		case ATA: /* SD CARD */
			break;
 
	case SPI_FLASH: /* SPI Flash */
				SPI_FLASH_Init(); /* 初始化 SPI Flash */
		 		i=500;/* 延时一小段时间 */
				while (--i);
				SPI_Flash_WAKEUP();/* 唤醒 SPI Flash */
				status = disk_status(SPI_FLASH);/* 获取 SPI Flash 芯片状态 */
				break;
	default:
		 status = STA_NOINIT;
		}
 return status;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

注意点
SPI_FLASH_Init();SPI_Flash_WAKEUP();都是由用户自己实现的底层功能，具体需要参照Flash对应的要求进行编写(一般也就是按着一定的规则发送数据字节过去，所以一般编程顺序是，线实现单字节的spi收发，再按照要求编写多字节的功能，再嵌入文件系统)

disk_read

DRESULT disk_read (
	BYTE pdrv, /* 设备物理编号(0..) */
	BYTE *buff, /* 数据缓存区 */
	DWORD sector, /* 扇区首地址 */
	UINT count /* 扇区个数(1..128) */
	)
{
	DRESULT status = RES_PARERR;
	switch (pdrv) {
		 case ATA: /* SD CARD */
			break;
 
		 case SPI_FLASH:
			sector+=512;/* 扇区偏移 2MB，外部 Flash 文件系统空间放在 SPI Flash 后面 6MB 空间 */
			SPI_FLASH_BufferRead(buff, sector <<12, count<<12);
			status = RES_OK;
			break;
 
		default:
			status = RES_PARERR;
				 }
		 return status;
 }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

注意点
参数：pdrv 为设备物理编号，用户自定义,buff:BYTE 类型指针变量，buff指向用来存放读取到数据的存储区首地址,sector 是一个 DWORD 类型变量，指定要读取数据的扇区首地址。count 是一个 UINT 类型变量，指定扇区数量。
数据类型：BYTE 类型实际是 unsigned char 类型，DWORD 类型实际是 unsigned long 类型，UINT类型实际是 unsigned int 类型，类型定义在 integer.h 文件中。
偏移 ：板使用的 SPI Flash 芯片型号为 W25Q64FV，每个扇区大小为 4096 个字节(4KB)，总共有8M字节空间若。要从Flash的首地址开始存放文件系统则不需要偏移。 只将后部分6MB空间分配给FatFs使用，即 FatFs 是从 2MB 空间开始，为实现这个效果需要将所有的读写地址都偏移 512 个扇区空间
SPI_FLASH_BufferRead():读flash的底层程序，实现在指定地址读取指定长度的数据，示例

/**
* @brief 读取 FLASH 数据
* @param pBuffer，存储读出数据的指针
* @param ReadAddr，读取地址
* @param NumByteToRead，读取数据长度
* @retval 无
*/
void SPI_FLASH_BufferRead(u8* pBuffer, u32 ReadAddr, u16 NumByteToRead)
{

 SPI_FLASH_CS_LOW(); /* 选择 FLASH: CS 低电平 */
 
 SPI_FLASH_SendByte(W25X_ReadData); /* 发送 读 指令 */
 SPI_FLASH_SendByte((ReadAddr & 0xFF0000) >> 16) /* 发送 读 地址高位 */
 SPI_FLASH_SendByte((ReadAddr& 0xFF00) >> 8); /* 发送 读 地址中位 */
 SPI_FLASH_SendByte(ReadAddr & 0xFF); /* 发送 读 地址低位 */
  
 while (NumByteToRead--)/* 读取数据 */
 {
	  *pBuffer = SPI_FLASH_SendByte(Dummy_Byte);/* 读取一个字节*/
	  pBuffer++;/* 指向下一个字节缓冲区 */
 }
	SPI_FLASH_CS_HIGH();/* 停止信号 FLASH: CS 高电平 */
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

disk_write

DRESULT disk_write (
	BYTE pdrv, /* 设备物理编号(0..) */
	const BYTE *buff, /* 欲写入数据的缓存区 */
	DWORD sector, /* 扇区首地址 */
	UINT count /* 扇区个数(1..128) */
)
{
	uint32_t write_addr;
	DRESULT status = RES_PARERR;
 if (!count) {
		 return RES_PARERR; /* Check parameter */
			}
 
		switch (pdrv) {
			case ATA: /* SD CARD */
			 break;
			case SPI_FLASH:
			/* 扇区偏移 2MB，外部 Flash 文件系统空间放在 SPI Flash 后面 6MB 空间 */
			 sector+=512;
			 write_addr = sector<<12;
			 SPI_FLASH_SectorErase(write_addr);//对于Flash 先擦除再写
			 SPI_FLASH_BufferWrite((u8 *)buff,write_addr,count<<12);//写
			 status = RES_OK;
			break;
 
			default:
			status = RES_PARERR;
				}
			return status;
 }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

SPI_FLASH_SectorErase SPI_FLASH_BufferWrite用户实现

disk_ioctl

DRESULT disk_ioctl (
BYTE pdrv, /* 物理编号 */
BYTE cmd, /* 控制指令 */
void *buff /* 写入或者读取数据地址指针 */
)
{
	DRESULT status = RES_PARERR;
	switch (pdrv) {
		case ATA: /* SD CARD */
			break;
 
		case SPI_FLASH:
			switch (cmd) {
			/* 扇区数量：1536*4096/1024/1024=6(MB) */
			case GET_SECTOR_COUNT:
					*(DWORD * )buff = 1536;
					break;
			/* 扇区大小 */
			case GET_SECTOR_SIZE :
					*(WORD * )buff = 4096;
					 break;
			/* 同时擦除扇区个数 */
		    case GET_BLOCK_SIZE :
					*(DWORD * )buff = 1;
					break;
				 }
			status = RES_OK;
				break;
 
			default:
			status = RES_PARERR;
		 }
		return status;
 }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

参数：pdrv 为设备物理编号，cmd 为控制指令，包括发出同步信号、获取扇区数目、获取扇区大小、获取擦除块数量等等指令，buff 为指令对应的数据指针。
cmd:对 于 SPI Flash 芯 片 ， 为 支 持 FatFs 格 式 化 功 能 ， 需 要 用 到 获 取 扇 区 数 量(GET_SECTOR_COUNT)指令和获取擦除块数量(GET_BLOCK_SIZE)。另外，SD 卡扇区大小为 512 字节，SPI Flash 芯片一般设置扇区大小为 4096 字节，所以需要用到获取扇区大小(GET_SECTOR_SIZE)指令。