STM32项目实战：用FATFS文件系统给SD卡存点‘小秘密’（附完整代码）

STM32项目实战用FATFS文件系统给SD卡存点‘小秘密’附完整代码记得第一次用STM32读写SD卡时那种把传感器数据永久保存下来的成就感简直比发现新大陆还兴奋。今天我们就来做个有趣的小项目——用FATFS文件系统在SD卡上创建带时间戳的日志文件把温湿度传感器的数据悄悄存进去。这个方案最妙的是拔下SD卡插到电脑上就能直接查看CSV格式的数据特别适合做长期环境监测。1. 硬件准备与FATFS移植1.1 硬件清单先检查你的开发板是否具备这些硬件接口STM32F103C8T6核心板或其他带SPI接口的型号MicroSD卡模块SPI接口版本DHT11温湿度传感器一张格式化过的SD卡建议容量≤32GB提示SD卡最好先用电脑格式化为FAT32格式分配单元大小选4096字节1.2 FATFS文件系统移植移植FATFS到STM32需要这几个关键文件ff.c // FATFS核心实现 ffconf.h // 配置文件系统参数 diskio.c // 底层磁盘驱动接口在diskio.c中需要实现这5个关键函数DSTATUS disk_initialize (BYTE pdrv); DSTATUS disk_status (BYTE pdrv); DRESULT disk_read (BYTE pdrv, BYTE* buff, LBA_t sector, UINT count); DRESULT disk_write (BYTE pdrv, const BYTE* buff, LBA_t sector, UINT count); DRESULT disk_ioctl (BYTE pdrv, BYTE cmd, void* buff);2. SD卡初始化与文件系统挂载2.1 SPI模式初始化SD卡通过SPI通信需要先发送正确的初始化序列void SD_Init(void) { SPI_Config(); // 配置SPI为低速模式(400kHz) SD_PowerUpSeq(); // 发送至少74个时钟脉冲 CMD0(0x00000000); // 进入IDLE状态 CMD8(0x000001AA); // 检查SD卡版本 // ...后续初始化流程 SPI_ChangeSpeed(SPI_BAUDRATEPRESCALER_4); // 切换到高速模式 }2.2 FATFS挂载流程挂载文件系统时常见的三个错误码及解决方法错误码含义解决方案FR_OK挂载成功-FR_NO_FILESYSTEM未找到文件系统重新格式化SD卡为FAT32FR_NOT_READY设备未响应检查SPI接线或降低时钟频率挂载示例代码FATFS fs; FRESULT res f_mount(fs, 0:, 1); if (res ! FR_OK) { printf(Mount error: %d\n, res); while(1); }3. 创建带时间戳的日志文件3.1 获取RTC时间给日志文件添加时间戳需要先配置RTCvoid RTC_Config(void) { RTC_TimeTypeDef sTime {0}; sTime.Hours 12; sTime.Minutes 0; sTime.Seconds 0; HAL_RTC_SetTime(hrtc, sTime, RTC_FORMAT_BIN); RTC_DateTypeDef sDate {0}; sDate.Year 23; sDate.Month 6; sDate.Date 15; HAL_RTC_SetDate(hrtc, sDate, RTC_FORMAT_BIN); }3.2 动态生成文件名使用sprintf组合日期时间生成唯一文件名char filename[32]; RTC_DateTypeDef date; RTC_TimeTypeDef time; HAL_RTC_GetDate(hrtc, date, RTC_FORMAT_BIN); HAL_RTC_GetTime(hrtc, time, RTC_FORMAT_BIN); sprintf(filename, 0:/LOG_%02d%02d%02d_%02d%02d.csv, date.Year, date.Month, date.Date, time.Hours, time.Minutes);4. 数据记录实战代码4.1 完整数据记录函数这个函数实现了创建文件、写入表头、循环记录数据全套流程void DataLogger(float temp, float humid) { static FIL file; static uint8_t first_run 1; if(first_run) { // 创建新文件并写入CSV表头 f_open(file, filename, FA_WRITE | FA_CREATE_NEW); f_printf(file, Timestamp,Temperature,Humidity\n); first_run 0; } else { // 追加模式打开已有文件 f_open(file, filename, FA_WRITE | FA_OPEN_APPEND); } // 获取当前时间 RTC_TimeTypeDef time; HAL_RTC_GetTime(hrtc, time, RTC_FORMAT_BIN); // 写入数据记录 f_printf(file, %02d:%02d:%02d,%.1f,%.1f\n, time.Hours, time.Minutes, time.Seconds, temp, humid); f_close(file); }4.2 主程序逻辑在主循环中每5分钟记录一次数据while (1) { if(HAL_GetTick() - last_log 5*60*1000) { DHT11_Read(temp, humid); // 读取传感器 DataLogger(temp, humid); // 记录数据 last_log HAL_GetTick(); printf(Data logged: %.1fC, %.1f%%\n, temp, humid); } HAL_Delay(1000); }5. 常见问题排查指南5.1 文件无法打开当f_open返回FR_NO_FILE时按这个流程检查确认路径中的文件夹已存在先用f_mkdir创建检查文件名是否包含非法字符避免使用,/,:,*,?等SD卡是否写保护开关被锁定5.2 数据写入不完整遇到数据丢失时要注意每次写入后调用f_sync()强制刷新缓存确保每次f_close()成功执行电源不稳定时添加大容量滤波电容5.3 文件系统突然变为只读这通常是底层磁盘错误导致的处理步骤if(f_getfree(0:, fre_clust, fs) FR_DISK_ERR) { f_mount(0, 0:, 0); // 卸载文件系统 HAL_Delay(100); f_mount(fs, 0:, 1); // 重新挂载 }6. 性能优化技巧6.1 减少写操作损耗延长SD卡寿命的配置建议// 在ffconf.h中修改这些参数 #define _FS_TINY 1 // 使用tiny模式减少RAM占用 #define _WRITE_ONCE 1 // 避免频繁更新FAT表 #define _USE_TRIM 0 // 禁用TRIM指令6.2 内存优化方案对于资源紧张的STM32F103可以这样节省内存使用f_puts替代f_printf减少代码体积将FIL对象定义为全局变量而非局部变量在ffconf.h中将_MAX_SS设置为512SD卡标准扇区大小最后分享一个真实案例曾经因为没调用f_sync()导致断电丢失了三天数据现在我的代码里到处都是f_sync()调用宁可多写几行代码也要确保数据安全。