从零到一：在STM32F103上构建FatFs文件系统并驱动W25Q64 Flash

1. 硬件准备与环境搭建在开始构建FatFs文件系统之前我们需要先准备好硬件环境。我手头用的是STM32F103C8T6最小系统板搭配一块W25Q64 Flash芯片。这块Flash芯片容量为8MB通过SPI接口通信正好适合用来做文件存储介质。首先得确认硬件连接正确。W25Q64的SPI引脚需要与STM32的SPI1接口对应连接SCK接PA5MISO接PA6MOSI接PA7CS接PA4这个可以自定义我习惯用PA4建议先用逻辑分析仪或者示波器检查SPI信号是否正常。我之前就遇到过因为接线松动导致通信失败的情况折腾了半天才发现是物理连接问题。硬件确认无误后就可以开始搭建开发环境了。我使用的是Keil MDK开发环境需要先创建一个基础工程包含STM32标准外设库或者HAL库SPI驱动代码GPIO初始化代码特别要注意的是W25Q64的工作电压是3.3V而STM32F103的IO口也是3.3V电平所以不需要电平转换。但如果你的开发板是5V系统就需要特别注意电平匹配问题。2. W25Q64驱动开发要让FatFs能操作Flash芯片首先得实现W25Q64的基础驱动。这块芯片虽然看起来简单但实际操作中有不少坑需要注意。2.1 SPI初始化配置SPI的配置很关键W25Q64支持SPI模式0和模式3。我实测下来模式0更稳定。以下是SPI初始化的关键代码void SPI_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; // 使能时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_SPI1, ENABLE); // 配置SCK和MOSI为复用推挽输出 GPIO_InitStructure.GPIO_Pin GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); // 配置MISO为浮空输入 GPIO_InitStructure.GPIO_Pin GPIO_Pin_6; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, GPIO_InitStructure); // CS引脚配置为普通输出 GPIO_InitStructure.GPIO_Pin GPIO_Pin_4; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_Init(GPIOA, GPIO_InitStructure); // SPI配置 SPI_InitStructure.SPI_Direction SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode SPI_Mode_Master; SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL SPI_CPOL_Low; // 模式0 SPI_InitStructure.SPI_CPHA SPI_CPHA_1Edge; SPI_InitStructure.SPI_NSS SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_4; // 18MHz 72MHz SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB; SPI_InitStructure.SPI_CRCPolynomial 7; SPI_Init(SPI1, SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }2.2 Flash基础操作函数W25Q64的操作有些特殊要求比如写操作前必须先擦除擦除单位最小是4KB的扇区。我封装了几个基础函数// 读取芯片ID uint32_t W25Q64_ReadID(void) { uint32_t temp 0; W25Q64_CS_LOW(); SPI1_ReadWriteByte(0x90); // 发送读取ID命令 SPI1_ReadWriteByte(0x00); SPI1_ReadWriteByte(0x00); SPI1_ReadWriteByte(0x00); temp | SPI1_ReadWriteByte(0xFF) 16; temp | SPI1_ReadWriteByte(0xFF) 8; temp | SPI1_ReadWriteByte(0xFF); W25Q64_CS_HIGH(); return temp; } // 扇区擦除4KB void W25Q64_SectorErase(uint32_t SectorAddr) { W25Q64_WriteEnable(); W25Q64_WaitBusy(); W25Q64_CS_LOW(); SPI1_ReadWriteByte(0x20); // 扇区擦除命令 SPI1_ReadWriteByte((SectorAddr 16) 0xFF); SPI1_ReadWriteByte((SectorAddr 8) 0xFF); SPI1_ReadWriteByte(SectorAddr 0xFF); W25Q64_CS_HIGH(); W25Q64_WaitBusy(); }特别注意写操作有最大256字节的页限制跨页写入需要特殊处理。我花了很长时间调试才发现这个问题后来改进了写入函数// 自动处理页边界的写入函数 void W25Q64_WriteBuffer(uint8_t* pBuffer, uint32_t WriteAddr, uint32_t NumByteToWrite) { uint32_t secpos; uint16_t secoff; uint16_t secremain; uint16_t i; secpos WriteAddr / 4096; // 扇区位置 secoff WriteAddr % 4096; // 扇区内偏移 secremain 4096 - secoff; // 扇区剩余空间 if(NumByteToWrite secremain) secremain NumByteToWrite; while(1) { W25Q64_PageWrite(pBuffer, WriteAddr, secremain); if(NumByteToWrite secremain) break; else { pBuffer secremain; WriteAddr secremain; NumByteToWrite - secremain; if(NumByteToWrite 4096) secremain 4096; else secremain NumByteToWrite; } } }3. FatFs文件系统移植FatFs是一个轻量级的文件系统非常适合嵌入式设备。最新版本是R0.14b可以从官网elm-chan.org下载。3.1 源码结构介绍下载的FatFs包包含以下重要文件ff.c文件系统核心实现ff.h头文件diskio.c底层设备接口ffconf.h配置文件系统功能我们需要重点关注diskio.c和ffconf.h这两个文件。前者需要我们自己实现底层驱动接口后者可以配置文件系统的功能选项。3.2 diskio.c接口实现diskio.c中需要实现6个函数disk_initialize - 初始化存储设备disk_status - 获取设备状态disk_read - 读取扇区disk_write - 写入扇区disk_ioctl - 设备控制get_fattime - 获取当前时间以disk_read为例我们需要将FatFs的扇区读写映射到W25Q64的实际操作DRESULT disk_read ( BYTE pdrv, /* Physical drive nmuber to identify the drive */ BYTE *buff, /* Data buffer to store read data */ LBA_t sector, /* Start sector in LBA */ UINT count /* Number of sectors to read */ ) { switch (pdrv) { case DEV_FLASH: // W25Q64的扇区大小是4096字节 W25Q64_ReadBuffer(buff, sector * 4096, count * 4096); return RES_OK; } return RES_PARERR; }disk_ioctl函数需要提供设备的基本信息DRESULT disk_ioctl ( BYTE pdrv, /* Physical drive nmuber (0..) */ BYTE cmd, /* Control code */ void *buff /* Buffer to send/receive control data */ ) { switch (pdrv) { case DEV_FLASH: switch (cmd) { case GET_SECTOR_COUNT: // 总扇区数 *(DWORD*)buff 2048; // 8MB/4KB2048 break; case GET_SECTOR_SIZE: // 扇区大小 *(WORD*)buff 4096; break; case GET_BLOCK_SIZE: // 擦除块大小单位扇区 *(DWORD*)buff 1; // 每次擦除1个扇区 break; default: return RES_PARERR; } return RES_OK; } return RES_PARERR; }3.3 ffconf.h配置ffconf.h中有几个关键配置需要修改#define FF_USE_STRFUNC 1 // 启用字符串操作函数 #define FF_USE_MKFS 1 // 启用格式化功能 #define FF_USE_LABEL 1 // 启用卷标功能 #define FF_USE_FORWARD 0 // 禁用文件转发功能 #define FF_CODE_PAGE 936 // 简体中文代码页 #define FF_USE_LFN 1 // 使用长文件名 #define FF_MAX_SS 4096 // 最大扇区大小 #define FF_MIN_SS 512 // 最小扇区大小 #define FF_FS_TINY 1 // 使用tiny模式减少内存占用4. 文件系统测试与应用完成移植后就可以测试文件系统功能了。我建议按照以下步骤逐步验证4.1 初始化与挂载FATFS fs; // 文件系统对象 FIL fil; // 文件对象 FRESULT res; // 操作结果 UINT bw; // 写入字节数 // 挂载文件系统 res f_mount(fs, 0:, 1); if (res FR_NO_FILESYSTEM) { // 如果没有文件系统则格式化 BYTE work[FF_MAX_SS]; // 工作缓冲区 res f_mkfs(0:, 0, work, sizeof(work)); if (res FR_OK) { // 格式化成功后重新挂载 f_mount(NULL, 0:, 0); res f_mount(fs, 0:, 1); } }4.2 文件读写测试// 创建并写入文件 res f_open(fil, 0:/test.txt, FA_CREATE_ALWAYS | FA_WRITE); if (res FR_OK) { res f_write(fil, Hello, STM32 FatFs!, 19, bw); f_close(fil); } // 读取文件内容 res f_open(fil, 0:/test.txt, FA_READ); if (res FR_OK) { char buffer[64]; UINT br; res f_read(fil, buffer, sizeof(buffer), br); f_close(fil); printf(Read: %.*s\n, br, buffer); }4.3 性能优化技巧在实际使用中我发现有几点可以显著提升性能合理设置SPI时钟频率W25Q64最高支持104MHz但STM32F103的SPI1在72MHz系统时钟下最高只能到18MHz预分频4使用DMA传输可以大幅提升连续读写速度实现缓存机制减少实际Flash操作次数合理规划文件存储位置避免频繁擦写同一区域一个实用的技巧是使用f_lseek函数预分配文件空间// 预分配1MB文件空间 res f_open(fil, 0:/largefile.bin, FA_CREATE_ALWAYS | FA_WRITE); if (res FR_OK) { res f_lseek(fil, 1024*1024); // 移动到1MB位置 if (res FR_OK) { // 写入1字节实际分配空间 res f_write(fil, , 1, bw); } f_close(fil); }5. 常见问题与调试技巧在开发过程中我遇到了不少问题这里分享几个典型的案例和解决方法。5.1 文件系统挂载失败最常见的错误是f_mount返回FR_NO_FILESYSTEM。这通常有两种可能Flash芯片确实没有文件系统diskio.c中的底层驱动有问题解决方法先用底层驱动直接读写Flash确认硬件正常检查disk_ioctl返回的扇区大小是否正确尝试格式化(f_mkfs)后重新挂载5.2 写入数据损坏有时候写入文件后再读取发现数据不对。可能原因写入前没有擦除Flash跨页写入没有正确处理SPI时钟太快导致数据出错我的调试方法是用逻辑分析仪抓取SPI波形在写入前后读取原始Flash数据对比降低SPI时钟频率测试5.3 内存不足问题FatFs需要一定内存资源特别是在使用长文件名时。如果出现奇怪错误可以增大堆栈大小使用FF_FS_TINY模式减少FF_USE_LFN的缓冲区大小使用静态分配的缓冲区而非动态内存6. 高级功能扩展基础功能实现后可以考虑扩展更实用的功能。6.1 文件系统掉电保护突然断电可能导致文件系统损坏。解决方法定期调用f_sync强制写入使用事务性写入模式实现写前日志(WAL)一个简单的保护措施void safe_write(FIL* fp, const void* buff, UINT btw) { UINT bw; f_write(fp, buff, btw, bw); f_sync(fp); // 立即写入物理设备 }6.2 实现目录操作FatFs支持完整的目录操作// 遍历目录 void list_dir(const char* path) { DIR dir; FILINFO fno; if (f_opendir(dir, path) FR_OK) { while (f_readdir(dir, fno) FR_OK fno.fname[0]) { printf(%s/%s\n, path, fno.fname); } f_closedir(dir); } }6.3 与PC交换数据可以通过串口实现YModem协议传输文件// 简单的文件接收函数 void receive_file(const char* filename) { FIL fp; if (f_open(fp, filename, FA_CREATE_ALWAYS | FA_WRITE) FR_OK) { while (ymodem_receive_block(fp)) { // 接收数据块并写入文件 } f_close(fp); } }7. 实际项目应用案例在我的一个数据记录项目中这套方案运行非常稳定。项目要求每5分钟记录一次传感器数据保存为CSV文件并支持通过USB导出。实现方案使用FatFs管理Flash上的多个数据文件每个文件保存一天的数据约288条记录文件命名规则为YYYYMMDD.CSV实现环形缓冲区存储自动覆盖最早的数据关键代码片段// 获取当前日期文件名 void get_filename(char* buf) { RTC_DateTypeDef date; HAL_RTC_GetDate(hrtc, date, RTC_FORMAT_BIN); sprintf(buf, 0:/%04d%02d%02d.csv, date.Year 2000, date.Month, date.Date); } // 追加一条记录 void log_data(float temp, float humidity) { char filename[16]; FIL fp; char line[64]; get_filename(filename); if (f_open(fp, filename, FA_OPEN_APPEND | FA_WRITE) FR_OK) { int len sprintf(line, %lu,%.1f,%.1f\n, HAL_GetTick(), temp, humidity); UINT bw; f_write(fp, line, len, bw); f_close(fp); } }这套系统已经连续运行6个月记录数据超过10万条没有出现任何文件系统错误。FatFs的稳定性和W25Q64的可靠性都经受住了实际考验。