FatFs文件系统移植
FatFs 程序结构图
移植 FatFs 之前我们先通过 FatFs 的程序结构图了解 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 芯片作为物理设备。
FatFs移植步骤一
1.将 FatFs 源码中的 src 文件夹整个文件夹拷贝一份至“SPI—FatFs 文件系统 USER”文件夹下并修改名为“FATFS
2.将 FatFs 组件文件添加到工程中,需要添加有 ff.c、 diskio.c 和 cc936.c 三个文件
- 添加 FATFS 文件夹到工程的 include 选项中。打开工程选项对话框,选择“C/C++”选项下的“Include Paths”项目,在弹出路径设置对话框中选择添加“FATFS”文件夹
4.如果现在编译工程,可以发现有两个错误,一个是来自 diskio.c 文件,提示有一些头文件没找到,diskio.c 文件内容是与底层设备输入输出接口函数文件,不同硬件设计驱动就不同,需要的文件也不同;另外一个错误来自 cc936.c 文件,提示该文件不是工程所必需的,这是因为 FatFs 默认使用日语,我们想要支持简体中文需要修改 FatFs 的配置,即修改 ffconf.h
5.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)。
FatFs移植步骤二
1.设备状态获取
/* 为每个设备定义一个物理编号 */
#define ATA 0 // 预留SD卡使用
#define SPI_FLASH 1 // 外部SPI Flash
/*-----------------------------------------------------------------------*/
/* 获取设备状态 */
/*-----------------------------------------------------------------------*/
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;
}
disk_status 函数只有一个参数 pdrv,表示物理编号。一般我们都是使用 switch 函数实现对 pdrv的分支判断。对于 SD 卡只是预留接口,留空即可。对于 SPI Flash 芯片,我们直接调用在SPI_FLASH_ReadID() 获取设备 ID,然后判断是否正确,如果正确,函数返回正常标准;如果错误,函数返回异常标志。 SPI_FLASH_ReadID() 是定义在 bsp_spi_flash.c 文件中,上一章节已做了分析。
2.设备初始化
/*-----------------------------------------------------------------------*/
/* 设备初始化 */
/*-----------------------------------------------------------------------*/
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 */
SPI_FLASH_Init();
/* 延时一小段时间 */
i=500;
while(--i);
/* 唤醒SPI Flash */
SPI_Flash_WAKEUP();
/* 获取SPI Flash芯片状态 */
status=disk_status(SPI_FLASH);
break;
default:
status = STA_NOINIT;
}
return status;
}
disk_initialize 函数也是有一个参数 pdrv,用来指定设备物理编号。对于 SPI Flash 芯片我们调用 SPI_FLASH_Init() 函数实现对 SPI Flash 芯片引脚 GPIO 初始化配置以及 SPI 通信参数配置。SPI_Flash_WAKEUP() 函数唤醒 SPI Flash 芯片,当 SPI Flash 芯片处于睡眠模式时需要唤醒芯片才可以进行读写操作。
3.读取扇区
/*-----------------------------------------------------------------------*/
/* 读扇区:读取扇区内容到指定存储区 */
/*-----------------------------------------------------------------------*/
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:
/* 扇区偏移2MB,外部Flash文件系统空间放在SPI Flash后面6MB空间 */
sector+=512;
SPI_FLASH_BufferRead(buff, sector<<12, count<<12);
status = RES_OK;
/* 不想偏移 */
// SPI_FLASH_BufferRead((BYTE *)buff, sector<<12, count<<12);
status = RES_OK;
break;
default:
status = RES_PARERR;
}
return status;
}
- disk_read 函数有四个形参。 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字节空间,为兼容后面实验程序,我们只将后部分 6MB 空间分配给 FatFs 使用,前部分 2MB 空 间用于其他实验需要,即 FatFs是从 2MB 空间开始,为实现这个效果需要将所有的读写地址都 偏移 512 个扇区空间。
- 对于 SPI Flash 芯片,主要是使用 SPI_FLASH_BufferRead() 实现在指定地址读取指定长度的数据,它接收三个参数,第一个参数为指定数据存放地址指针。第二个参数为指定数据读取地址,这里使用左移运算符,左移 12 位实际是乘以 4096,这与每个扇区大小是息息相关的。第三个参数为读取数据个数,也是需要使用左移运算符。
4.扇区写入
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);
SPI_FLASH_BufferWrite((uint8_t *)buff,write_addr,count<<12);
status = RES_OK;
/* 不想偏移 */
// SPI_FLASH_SectorErase(sector<<12);
// SPI_FLASH_BufferWrite((BYTE *)buff, sector<<12, count<<12);
// status = RES_OK;
break;
default:
status = RES_PARERR;
}
return status;
}
disk_write 函数有四个形参, pdrv 为设备物理编号。 buff 指向待写入扇区数据的首地址。 sector,指定要写入数据的扇区首地址。 count 指定扇区数量。对于 SPI Flash 芯片,在写入数据之前需要先擦除,所以用到扇区擦除函数 (SPI_FLASH_SectorErase)。然后就是在调用数据写入函数(SPI_FLASH_BufferWrite) 把数据写入到指定位置内
5.其他配置
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) {
/* 扇区数量:2048*4096/1024/1024=8(MB) */
/* 扇区数量: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;
}
- disk_ioctl 函数有三个形参, pdrv 为设备物理编号, cmd 为控制指令,包括发出同步信号、获取扇区数目、获取扇区大小、获取擦除块数量等等指令, buff 为指令对应的数据指针。
- 对于 SPI Flash 芯片,为支持 FatFs 格式化功能,需要用到获取扇区数量 (GET_SECTOR_COUNT)指令和获取擦除块数量(GET_BLOCK_SIZE)。另外, SD 卡扇区大小为 512 字节, SPI Flash 芯片一般设置扇区大小为 4096 字节,所以需要用到获取扇区大小 (GET_SECTOR_SIZE) 指令。
FatFs移植步骤三
ffconf.h 文件是 FatFs 功能配置文件,我们可以对文件内容进行修改,使得 FatFs 更符合我们的要求。 ffconf.h 对每个配置选项都做了详细的使用情况说明。下面只列出修改的配置,其他配置采用默认即可。
#define _USE_MKFS 1
#define _CODE_PAGE 936
#define _USE_LFN 2
#define _VOLUMES 2
#define _MIN_SS 512
#define _MAX_SS 4096
- _USE_MKFS:格式化功能选择,为使用 FatFs 格式化功能,需要把它设置为 1。
- _CODE_PAGE:语言功能选择,并要求把相关语言文件添加到工程宏。为支持简体中文文件名需要使用“936”,正如在图 25‑7 的操作,我们已经把 cc936.c 文件添加到工程中。
- _USE_LFN:长文件名支持,默认不支持长文件名,这里配置为 2,支持长文件名,并指定使用栈空间为缓冲区。
- _VOLUMES:指定物理设备数量,这里设置为 2,包括预留 SD 卡和 SPI Flash 芯片。
- _MIN_SS 、 _MAX_SS:指定扇区大小的最小值和最大值。 SD 卡扇区大小一般都为 512 字节, SPI Flash 芯片扇区大小一般设置为 4096 字节,所以需要把 _MAX_SS 改为 4096。