STM32实战：基于FATFS与SDIO实现SD卡文件系统移植与数据持久化

张

张建站

2026/7/28 0:20:08

10分钟阅读

1. 为什么需要SD卡文件系统在嵌入式系统中数据持久化存储是个永恒的话题。想象一下你正在用STM32做一个环境监测设备需要记录温湿度传感器的数据。如果直接把数据存在芯片内部Flash里不仅容量有限而且频繁擦写会缩短芯片寿命。这时候外接一张SD卡就成了最经济实惠的选择。但问题来了——SD卡就像一块空白画布你需要一套文件系统来组织数据。这就好比在电脑上直接操作硬盘扇区不现实一样我们需要FATFS这样的文件系统模块来帮我们管理SD卡上的文件。FATFS最大的优势在于跨平台性纯C语言编写不依赖特定硬件轻量级最小配置仅需14KB ROM和2KB RAM功能完整支持FAT32/exFAT提供完整的文件操作API我最近做的一个工业振动监测项目就用了这套方案STM32F407通过加速度传感器采集数据每分钟生成一个CSV文件存到SD卡。客户可以直接拔卡插到电脑上分析数据这种即插即用的体验才是嵌入式存储该有的样子。2. 硬件准备与SDIO配置2.1 硬件连接要点先说说硬件接线这是最容易踩坑的地方。以STM32F407 Discovery板为例SDIO_D0~D3数据线D0必须接SDIO_CLK时钟线注意走线等长SDIO_CMD命令线CD/DETECT卡检测引脚可选特别提醒SD卡座最好选择带弹推结构的我们实验室就发生过因为卡座接触不良导致数据丢失的事故。另外电源滤波一定要做好我在PCB上放了两个并联的100nF10μF电容实测可以有效抑制写卡时的电压波动。2.2 CubeMX配置技巧用STM32CubeMX配置SDIO时这几个参数要特别注意/* SDIO时钟计算公式 SDIOCLK 48MHz 初始化时钟 ≤ 400kHz 正常工作时钟 ≤ 25MHz */ hsd.Instance SDIO; hsd.Init.ClockEdge SDIO_CLOCK_EDGE_RISING; hsd.Init.ClockBypass SDIO_CLOCK_BYPASS_DISABLE; hsd.Init.ClockPowerSave SDIO_CLOCK_POWER_SAVE_DISABLE; hsd.Init.BusWide SDIO_BUS_WIDE_4B; hsd.Init.HardwareFlowControl SDIO_HARDWARE_FLOW_CONTROL_DISABLE; hsd.Init.ClockDiv SDIO_TRANSFER_CLK_DIV; /* 初始化时设为0x76(118) */建议先在低速模式400kHz下调试通再提高速度。遇到过有的山寨SD卡在高速模式下不稳定这时候可以在f_mount之后动态调整时钟分频/* 挂载成功后切换到高速模式 */ if(f_mount(fs, 0:, 1) FR_OK) { hsd.Instance-CLKCR ~SDIO_CLKCR_CLKDIV; hsd.Instance-CLKCR | 0x2; /* 24MHz */ }3. FATFS移植实战3.1 源码获取与工程集成最新版FATFSR0.15a从官网下载后只需要关注这几个文件source/ ├── ff.c # 核心实现 ├── ff.h # 用户接口 ├── ffconf.h # 功能配置 └── diskio.c # 硬件适配层我习惯在工程里新建Middlewares/FATFS目录存放这些文件。特别提醒记得在ffconf.h中开启长文件名支持#define FF_USE_LFN 3 /* 动态内存分配长文件名缓冲区 */ #define FF_CODE_PAGE 936 /* 中文编码 */3.2 关键移植函数实现diskio.c里有五个函数必须实现/* 初始化磁盘 */ DSTATUS disk_initialize(BYTE pdrv) { if(SD_Init() ! SD_OK) return STA_NOINIT; return RES_OK; } /* 读扇区 */ DRESULT disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count) { if(SD_ReadBlocks(buff, sector, count, SD_TIMEOUT) ! SD_OK) return RES_ERROR; return RES_OK; } /* 写扇区注意要先擦除再写入 */ DRESULT disk_write(BYTE pdrv, const BYTE *buff, LBA_t sector, UINT count) { if(SD_WriteBlocks(buff, sector, count, SD_TIMEOUT) ! SD_OK) return RES_ERROR; return RES_OK; } /* 控制命令 */ DRESULT disk_ioctl(BYTE pdrv, BYTE cmd, void *buff) { switch(cmd) { case CTRL_SYNC: /* 确保写入完成 */ SD_WaitWriteOperation(); break; case GET_SECTOR_SIZE: *(WORD*)buff 512; /* SD卡固定扇区大小 */ break; case GET_BLOCK_SIZE: *(DWORD*)buff 1; /* 擦除块大小单位扇区 */ break; } return RES_OK; }4. 数据存储优化策略4.1 文件命名与轮转在数据采集场景中我推荐使用日期序号的命名规则void get_filename(char *buf) { RTC_DateTypeDef date; HAL_RTC_GetDate(hrtc, date, RTC_FORMAT_BIN); static uint16_t file_num 0; sprintf(buf, %04d%02d%02d_%03d.csv, date.Year2000, date.Month, date.Date, file_num); }对于长期运行的系统还要实现文件自动轮转。我的做法是每次启动时扫描SD卡FRESULT scan_files(char *path) { DIR dir; FILINFO fno; if(f_opendir(dir, path) ! FR_OK) return FR_DISK_ERR; while(f_readdir(dir, fno) FR_OK fno.fname[0]) { if(fno.fattrib AM_DIR) { /* 处理子目录 */ } else { /* 检查文件日期/大小 */ } } f_closedir(dir); return FR_OK; }4.2 写入性能优化直接频繁调用f_write会导致性能低下。我的实测数据单次写512字节约120ms单次写4KB约150ms批量写4KB×8次约200ms因此推荐使用缓冲写入#define BUF_SIZE 4096 uint8_t cache[BUF_SIZE]; uint16_t cache_pos 0; void write_data(float temp, float humi) { int len sprintf((char*)cache cache_pos, %.1f,%.1f\n, temp, humi); cache_pos len; if(cache_pos BUF_SIZE - 64) { UINT bw; f_write(file, cache, cache_pos, bw); cache_pos 0; } }5. 异常处理与数据安全5.1 错误恢复机制一定要处理这些常见错误FRESULT res f_write(...); switch(res) { case FR_DISK_ERR: /* 硬件错误 */ sd_reinit(); /* 重新初始化SD卡 */ break; case FR_INT_ERR: /* 文件系统错误 */ f_mount(NULL, , 0); /* 卸载 */ f_mount(fs, , 1); /* 重新挂载 */ break; case FR_NOT_ENOUGH_CORE: /* 内存不足 */ __disable_irq(); NVIC_SystemReset(); /* 最粗暴但有效 */ break; }5.2 掉电保护方案突然断电可能导致文件系统损坏。我的解决方案是每次写入后立即调用f_sync()使用FATFS的FA_OPEN_APPEND模式追加写入在备份电池支持下检测到掉电时立即执行void power_fail_handler(void) { f_sync(file); HAL_SD_DeInit(hsd); /* 安全断开SD卡 */ HAL_GPIO_WritePin(SD_PWR_GPIO_Port, SD_PWR_Pin, GPIO_PIN_RESET); }6. 实际项目经验分享去年给某气象站做的数据采集器就用了这套方案遇到几个有意思的问题案例1SD卡在-20℃环境下写入失败解决方法更换工业级SD卡并在初始化时增加重试机制int retry 3; while(retry--) { if(SD_Init() SD_OK) break; HAL_Delay(100); }案例2连续运行30天后FAT表损坏根本原因没有定期调用f_sync()改进方案加入看门狗任务每小时强制同步void wdg_task(void) { static uint32_t last_sync 0; if(HAL_GetTick() - last_sync 3600000) { f_sync(file); last_sync HAL_GetTick(); } }这些实战经验让我明白嵌入式存储系统要考虑的不仅是功能实现更要关注长期运行的可靠性。现在我的代码里都会加入SD卡健康监测功能定期检查剩余空间和写入速度一旦异常就通过LED报警。毕竟对于数据采集设备来说丢失数据比设备死机严重得多。

XHS-Downloader：如何通过3种智能方式高效采集小红书无水印内容？

XHS-Downloader：如何通过3种智能方式高效采集小红书无水印内容？ 【免费下载链接】XHS-Downloader 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具：提取账号发布、收藏、点赞、专辑作品链接；提取搜索结…...

2026/6/17 19:08:25 阅读更多 →

一文看懂AI Agent日志重构任务的行动计划

在接到日志重构任务后，AI可能会生成如下的行动计划：分析现状：首先，需要分析 main.rs 和 logger.rs 中现有的日志接口和实现方式，理解其功能。引入依赖：在 Cargo.toml 文件中添加 tracing 和 tracing-subscr…...

2026/5/15 10:15:24 阅读更多 →

Phi-4-mini-reasoning开发者案例：嵌入式设备边缘推理可行性验证

Phi-4-mini-reasoning开发者案例：嵌入式设备边缘推理可行性验证 1. 项目背景与模型介绍 Phi-4-mini-reasoning是微软推出的3.8B参数轻量级开源模型，专为数学推理、逻辑推导和多步解题等强逻辑任务设计。这个模型最吸引人的特点是"小参数、强推理、…...

2026/6/11 10:58:39 阅读更多 →

大模型 Agent 三面被问：怎么解决 Skill 的依赖关系？我是这么答的

前段时间有个读者去面某大厂的 Agent 岗位，三面被甩出来一道题当场卡壳。题目听着挺朴素：“如果你的 Agent 里面有很多 Skill，Skill 之间还存在依赖关系的话，你打算怎么去设计来解决这个问题？” 他跟我复盘的时候说&a…...

2026/7/27 14:32:01 阅读更多 →

抱怨应试教育的苦，却不知道：那已经是人生里最轻松、最公平的一段路了

能靠考试得到的东西，都是天上掉馅饼上学的时候，总觉得考试是天底下最熬人的苦。背不完的知识点，刷不完的题，熬不完的夜，一张卷子定输赢的应试制度，曾被无数人吐槽是束缚、是枷锁。那时候总天真地以为，等走出校园、踏入社会，就能摆脱考试的桎梏，凭真本事自由闯荡。 …...

2026/7/27 15:43:10 阅读更多 →

华硕笔记本终极控制工具：如何用G-Helper取代臃肿的Armoury Crate

华硕笔记本终极控制工具：如何用G-Helper取代臃肿的Armoury Crate 【免费下载链接】g-helper Lightweight Armoury Crate alternative for Asus laptops with nearly the same functionality. Works with ROG Zephyrus, Flow, TUF, Strix, Scar, ProArt, Vivobook, Z…...

2026/7/27 9:10:30 阅读更多 →