37. 基于SD卡的FatFs文件系统¶
上一章我们已经全面介绍了SD卡的识别和简单的数据读写，也进行了简单的读写测试，不过像这样直接操作SD卡存储单元，在实际应用中是不现实的。 SD卡一般用来存放文件，所以都需要加载文件系统到里面。 类似于串行Flash芯片，我们移植FatFs文件系统到SD卡内。
对于FatFs文件系统的介绍和具体移植过程参考“基于串行Flash的FatFs文件系统”，这里就不做过多介绍，重点放在SD卡与FatFs接口函数编写上。 与串行Flash的FatFs文件系统移植例程相比，FatFs文件系统部分的代码只有diskio.c文件有所不同，其他的不用修改， 所以一个简易的移植方法是利用原来工程进行修改。下面讲解利用原来工程实现SD卡的FatFs文件系统。
37.1. FatFs移植步骤¶
上一章我们已经完成了SD卡驱动程序以及进行了简单的读写测试。该工程有很多东西是现在可以使用的，所以我们先把上一章的工程文件完整的拷贝一份， 并修改文件夹名为“SD卡—-FatFs移植与读写测试”，如果此时使用KEIL软件打开该工程，应该是编译无错误并实现上一章的测试功能。
接下来，我们到串行Flash文件系统移植工程文件的“SPI—FatFs移植与读写测试User”文件夹下拷贝“FATFS” 整个文件夹到现在工程文件的“SD卡——FatFs移植与读写测试User”文件夹下，如图 拷贝FatFs文件夹。 该文件夹是FatFs文件系统的所有代码文件，在串行Flash移植FatFs文件系统时我们对部分文件做了修改，这里主要是想要保留之前的配置， 而不是使用FatFs官方源码还需要重新配置。
现在就可以使用KEIL软件打开“SD卡—-FatFs移植与读写测试”工程文件，并把FatFs相关文件添加到工程内， 同时把sdio_test.c文件移除，参考图 FatFs工程文件结构。
添加文件之后还必须打开工程选项对话框添加文件系统的头文件路径，参考图 添加FatFs路径到工程。
操作到这来，工程文件结构就算完整了，接下来就是修改文件代码了。这来有两个文件需要修改，为diskio.c文件和main.c文件。 main.c文件内容可以参考“SPI—FatFs移植与读写测试”工程中的main.c文件，只有做小细节修改而已。这来重点讲解diskio.c文件，也是整个移植的重点。
37.2. FatFs接口函数¶
FatFs文件系统与存储设备的连接函数在diskio.c文件中，主要有5个函数需要我们编写的。
宏定义和存储设备状态获取函数
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 | //宏定义
#define ATA 0 // SD卡
#define SPI_FLASH 1 // 预留外部SPI Flash使用
// SD卡块大小
#define SD_BLOCKSIZE SDCardInfo.CardBlockSize
//存储设备状态获取
DSTATUS disk_status (
BYTE pdrv /* 物理编号 */
)
{
DSTATUS status = STA_NOINIT;
switch (pdrv) {
case ATA: /* SD CARD */
status &= ~STA_NOINIT;
break;
case SPI_FLASH: /* SPI Flash */
break;
default:
status = STA_NOINIT;
}
return status;
}
|
FatFs支持同时挂载多个存储设备，通过定义为不同编号以区别。SD卡一般定义为编号0，编号1预留给串行Flash芯片使用。使用宏定义方式给出SD卡块大小， 方便修改。实际上，SD卡块大小一般都是设置为512字节的，不管是标准SD卡还是高容量SD卡。
disk_status函数要求返回存储设备的当前状态，对于SD卡一般返回SD卡插入状态，这里直接返回正常状态。
存储设备初始化函数
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | DSTATUS disk_initialize (
BYTE pdrv /* 物理编号 */
)
{
DSTATUS status = STA_NOINIT;
switch (pdrv) {
case ATA: /* SD CARD */
if (SD_Init()==SD_OK) {
status &= ~STA_NOINIT;
} else {
status = STA_NOINIT;
}
break;
case SPI_FLASH: /* SPI Flash */
break;
default:
status = STA_NOINIT;
}
return status;
}
|
该函数用于初始化存储设备，一般包括相关GPIO初始化、外设环境初始化、中断配置等等。对于SD卡， 直接调用SD_Init函数实现对SD卡初始化， 如果函数返回SD_RESPONSE_NO_ERROR说明SD卡正确插入，并且控制器可以与之正常通信。
存储设备数据读取函数
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 35 | /*-------------------------------------------------------*/
/* 读扇区：读取扇区内容到指定存储区 */
/*-------------------------------------------------------*/
DRESULT disk_read (
BYTE pdrv, /* 设备物理编号(0..) */
BYTE *buff, /* 数据缓存区 */
DWORD sector, /* 扇区首地址 */
UINT count /* 扇区个数(1..128) */
)
{
DRESULT status = RES_PARERR;
SD_Error SD_state = SD_RESPONSE_NO_ERROR;
switch (pdrv) {
case ATA: /* SD CARD */
SD_state=SD_ReadMultiBlocks(buff,
sector*SD_BLOCKSIZE,
SD_BLOCKSIZE,
count);
if (SD_state!=SD_RESPONSE_NO_ERROR)
status = RES_PARERR;
else
status = RES_OK;
break;
case SPI_FLASH:
break;
default:
status = RES_PARERR;
}
return status;
}
|
disk_read函数用于从存储设备指定地址开始读取一定的数量的数据到指定存储区内。
本移植方案直接调用SD_ReadMultiBlocks函数从SD卡内读取多个块数据，它有四个形参，分别为存储区地址指针、 起始块地址、块大小以及块数量。根据判断函数的返回值是否等于SD_RESPONSE_NO_ERROR来确认是否正常读出了数据。
存储设备数据写入函数
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 35 36 37 38 39 40 41 | /*---------------------------------------------------*/
/* 写扇区：见数据写入指定扇区空间上 */
/*---------------------------------------------------*/
#if _USE_WRITE
DRESULT disk_write (
BYTE pdrv, /* 设备物理编号(0..) */
const BYTE *buff, /* 欲写入数据的缓存区 */
DWORD sector, /* 扇区首地址 */
UINT count /* 扇区个数(1..128) */
)
{
DRESULT status = RES_PARERR;
SD_Error SD_state = SD_RESPONSE_NO_ERROR;
if (!count) {
return RES_PARERR; /* Check parameter */
}
switch (pdrv) {
case ATA: /* SD CARD */
SD_state=SD_WriteMultiBlocks((uint8_t *)buff,
sector*SD_BLOCKSIZE,
SD_BLOCKSIZE,
count);
if (SD_state!=SD_RESPONSE_NO_ERROR)
status = RES_PARERR;
else
status = RES_OK;
break;
case SPI_FLASH:
break;
default:
status = RES_PARERR;
}
return status;
}
#endif
|
disk_write函数用于向存储设备指定地址写入指定数量的数据。本移植方案直接调用SD_WriteMultiBlocks函数向SD卡写入多个块数据， 它有四个形参，分别为存储区地址指针、起始块地址、块大小以及块数量，它与SD_ReadMultiBlocks函数执行相反过程。 最后也是根据判断函数的返回值是否等于SD_RESPONSE_NO_ERROR来确认是否正常写入了数据。
其他控制函数
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 35 36 37 38 | #if _USE_IOCTL
DRESULT disk_ioctl (
BYTE pdrv, /* 物理编号 */
BYTE cmd, /* 控制指令 */
void *buff /* 写入或者读取数据地址指针 */
)
{
DRESULT status = RES_PARERR;
switch (pdrv) {
case ATA: /* SD CARD */
switch (cmd) {
// Get R/W sector size (WORD)
case GET_SECTOR_SIZE :
*(WORD * )buff = SD_BLOCKSIZE;
break;
// Get erase block size in unit of sector (DWORD)
case GET_BLOCK_SIZE :
*(DWORD * )buff = 1;
break;
case GET_SECTOR_COUNT:
*(DWORD*)buff = SDCardInfo.CardCapacity/SDCardInfo.CardBlockSize;
break;
case CTRL_SYNC :
break;
}
status = RES_OK;
break;
case SPI_FLASH:
break;
default:
status = RES_PARERR;
}
return status;
}
#endif
|
disk_ioctl函数有三个形参，pdrv为设备物理编号，cmd为控制指令，包括发出同步信号、获取扇区数目、获取扇区大小、获取擦除块数量等等指令， buff为指令对应的数据指针。
对于SD卡，为支持格式化功能，需要用到获取扇区数量(GET_SECTOR_COUNT)指令和获取最小擦除的块个数(GET_BLOCK_SIZE)。 另外，SD卡扇区大小为512字节，串行Flash芯片一般设置扇区大小为4096字节，所以需要用到获取扇区大小(GET_SECTOR_SIZE)指令。
至此，基于SD卡的FatFs文件系统移植就已经完成了，最重要就是diskio.c文件中5个函数的编写。 接下来就编写FatFs基本的文件操作检测移植代码是否可以正确执行。
37.3. FatFs功能测试¶
主要的测试包括格式化测试、文件写入测试和文件读取测试三个部分，主要程序都在main.c文件中实现。
变量定义
1 2 3 4 5 6 7 | FATFS fs; /* FatFs文件系统对象 */
FIL fnew; /* 文件对象 */
FRESULT res_sd; /* 文件操作结果 */
UINT fnum; /* 文件成功读写数量 */
BYTE ReadBuffer[1024]= {0}; /* 读缓冲区 */
BYTE WriteBuffer[] = /* 写缓冲区*/
"欢迎使用野火STM32开发板 今天是个好日子，新建文件系统测试文件\r\n";
|
FATFS是在ff.h文件定义的一个结构体类型，针对的对象是物理设备，包含了物理设备的物理编号、扇区大小等等信息， 一般我们都需要为每个物理设备定义一个FATFS变量。
FIL也是在ff.h文件定义的一个结构体类型，针对的对象是文件系统内具体的文件，包含了文件很多基本属性，比如文件大小、 路径、当前读写地址等等。如果需要在同一时间打开多个文件进行读写，才需要定义多个FIL变量，不然一般定义一个FIL变量即可。
FRESULT是也在ff.h文件定义的一个枚举类型，作为FatFs函数的返回值类型，主要管理FatFs运行中出现的错误。 总共有19种错误类型，包括物理设备读写错误、找不到文件、没有挂载工作空间等等错误。这在实际编程中非常重要， 当有错误出现是我们要停止文件读写，通过返回值我们可以快速定位到错误发生的可能地点。如果运行没有错误才返回FR_OK。
fnum是个32位无符号整形变量，用来记录实际读取或者写入数据的数组。
buffer和textFileBuffer分别对应读取和写入数据缓存区，都是8位无符号整形数组。
主函数
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 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 | int main(void)
{
/* 初始化LED */
LED_GPIO_Config();
LED_BLUE;
/* 初始化调试串口，一般为串口1 */
Debug_USART_Config();
printf("\r\n****** 这是一个SD卡 文件系统实验 ******\r\n");
//在外部SPI Flash挂载文件系统，文件系统挂载时会对SPI设备初始化
res_sd = f_mount(&fs,"0:",1);
/*----------------------- 格式化测试 ---------------------------*/
/* 如果没有文件系统就格式化创建创建文件系统 */
if (res_sd == FR_NO_FILESYSTEM) {
printf("》SD卡还没有文件系统，即将进行格式化...\r\n");
/* 格式化 */
res_sd=f_mkfs("0:",0,0);
if (res_sd == FR_OK) {
printf("》SD卡已成功格式化文件系统。\r\n");
/* 格式化后，先取消挂载 */
res_sd = f_mount(NULL,"0:",1);
/* 重新挂载 */
res_sd = f_mount(&fs,"0:",1);
} else {
LED_RED;
printf("《《格式化失败。》》\r\n");
while (1);
}
} else if (res_sd!=FR_OK) {
printf("！！SD卡挂载文件系统失败。(%d)\r\n",res_sd);
printf("！！可能原因：SD卡初始化不成功。\r\n");
while (1);
} else {
printf("》文件系统挂载成功，可以进行读写测试\r\n");
}
/*--------------------- 文件系统测试：写测试 -----------------------*/
/* 打开文件，如果文件不存在则创建它 */
printf("\r\n****** 即将进行文件写入测试... ******\r\n");
res_sd=f_open(&fnew,"0:FatFs读写测试文件.txt",FA_CREATE_ALWAYS|FA_WRITE);
if ( res_sd == FR_OK ) {
printf("》打开/创建FatFs读写测试文件.txt文件成功，向文件写入数据。\r\n");
/* 将指定存储区内容写入到文件内 */
res_sd=f_write(&fnew,WriteBuffer,sizeof(WriteBuffer),&fnum);
/* 实测SPI_SD驱动下写入大于512字节的数据在SD卡里打开会显示乱码，如需写入大量数据使用f_write_co替代上面f_write即可 */
//res_sd=f_write_co(&fnew,WriteBuffer,sizeof(WriteBuffer),&fnum);
if (res_sd==FR_OK) {
printf("》文件写入成功，写入字节数据：%d\n",fnum);
printf("》向文件写入的数据为：\r\n%s\r\n",WriteBuffer);
} else {
printf("！！文件写入失败：(%d)\n",res_sd);
}
/* 不再读写，关闭文件 */
f_close(&fnew);
} else {
LED_RED;
printf("！！打开/创建文件失败。\r\n");
}
/*------------------ 文件系统测试：读测试 --------------------------*/
printf("****** 即将进行文件读取测试... ******\r\n");
res_sd=f_open(&fnew,"0:FatFs读写测试文件.txt",FA_OPEN_EXISTING|FA_READ);
if (res_sd == FR_OK) {
LED_GREEN;
printf("》打开文件成功。\r\n");
res_sd = f_read(&fnew, ReadBuffer, sizeof(ReadBuffer), &fnum);
/* 实测SPI_SD驱动下读取大于512字节的数据在SD卡里打开会显示乱码，如需读取大量数据使用f_read_co替代上面f_read即可 */
//res_sd = f_read_co(&fnew, ReadBuffer, sizeof(ReadBuffer), &fnum);
if (res_sd==FR_OK) {
printf("》文件读取成功,读到字节数据：%d\r\n",fnum);
printf("》读取得的文件数据为：\r\n%s \r\n", ReadBuffer);
} else {
printf("！！文件读取失败：(%d)\n",res_sd);
}
} else {
LED_RED;
printf("！！打开文件失败。\r\n");
}
/* 不再读写，关闭文件 */
f_close(&fnew);
/* 不再使用文件系统，取消挂载文件系统 */
f_mount(NULL,"0:",1);
/* 操作完成，停机 */
while (1) {
}
}
|
程序的开头首先初始化LED灯和调试串口，用来指示程序进程。
FatFs的第一步工作就是使用f_mount函数挂载工作区。f_mount函数有三个形参，第一个参数是指向FATFS变量指针，如果赋值为NULL可以取消物理设备挂载。 第二个参数为逻辑设备编号，使用设备根路径表示，与物理设备编号挂钩， 在 代码清单:FatFs-1 中我们定义SD卡物理编号为0，所以这里使用“0：”。 第三个参数可选0或1，1表示立即挂载，0表示不立即挂载，延迟挂载。 f_mount函数会返回一个FRESULT类型值，指示运行情况。
如果f_mount函数返回值为FR_NO_FILESYSTEM，说明SD卡没有FAT文件系统。我们就必须对SD卡进行格式化处理。使用f_mkfs函数可以实现格式化操作。 f_mkfs函数有三个形参，第一个参数为逻辑设备编号；第二参数可选0或者1，0表示设备为一般硬盘，1表示设备为软盘。第三个参数指定扇区大小， 如果为0，表示通过 代码清单:FatFs-5 中disk_ioctl函数获取。格式化成功后需要先取消挂载原来设备，再重新挂载设备。
在设备正常挂载后，就可以进行文件读写操作了。使用文件之前，必须使用f_open函数打开文件，不再使用文件必须使用f_close函数关闭文件， 这个跟电脑端操作文件步骤类似。f_open函数有三个形参，第一个参数为文件对象指针。第二参数为目标文件，包含绝对路径的文件名称和后缀名。 第三个参数为访问文件模式选择，可以是打开已经存在的文件模式、读模式、写模式、新建模式、总是新建模式等的或运行结果。比如对于写测试， 使用FA_CREATE_ALWAYS和FA_WRITE组合模式，就是总是新建文件并进行写模式。
f_close函数用于不再对文件进行读写操作关闭文件，f_close函数只要一个形参，为文件对象指针。f_close函数运行可以确保缓冲区完全写入到文件内。
成功打开文件之后就可以使用f_write函数和f_read函数对文件进行写操作和读操作。这两个函数用到的参数是一致的，只不过一个是数据写入，一个是数据读取。 f_write函数第一个形参为文件对象指针，使用与f_open函数一致即可。第二个参数为待写入数据的首地址，对于f_read函数就是用来存放读出数据的首地址。 第三个参数为写入数据的字节数，对于f_read函数就是欲读取数据的字节数。第四个参数为32位无符号整形指针，这里使用fnum变量地址赋值给它， 在运行读写操作函数后，fnum变量指示成功读取或者写入的字节个数。
注意：虽然是官方给的demo，但是在实测SPI_SD驱动下读取或写入大于512字节的数据时，虽然可以在串口调试助手里显示正常，但是在SD卡里打开会显示乱码，这时我们编写一个函数使其分512字节多次循环操作，以避免乱码的出现，写入或读取大量数据使用f_read_co/f_write_co替代上面f_read/f_write即可
最后，不再使用文件系统时，使用f_mount函数取消挂载。
下载验证
保证开发板相关硬件连接正确，用USB线连接开发板“USB TO UART”接口跟电脑，在电脑端打开串口调试助手，把编译好的程序下载到开发板。 程序开始运行后，RGB彩灯为蓝色，在串口调试助手可看到格式化测试、写文件检测和读文件检测三个过程； 正确执行例程程序后可以使用读卡器将SD卡在电脑端打开，我们可以在SD卡根目录下看到“FatFs读写测试文件.txt”文件，这与程序设计是相吻合的。