企业官网建设流程全解析

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挂载流程

挂载文件系统时常见的三个错误码及解决方法：

挂载示例代码：

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时间

给日志文件添加时间戳需要先配置RTC：

void 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时，按这个流程检查：

1. 确认路径中的文件夹已存在（先用f_mkdir创建）
2. 检查文件名是否包含非法字符（避免使用,/,:,*,?等）
3. 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设置为512（SD卡标准扇区大小）

最后分享一个真实案例：曾经因为没调用f_sync()导致断电丢失了三天数据，现在我的代码里到处都是f_sync()调用，宁可多写几行代码也要确保数据安全。