簡介這份資源面向嵌入式開發(fā)學(xué)習(xí)者與STM32工程師聚焦在STM32F429平臺上集成FatFS文件系統(tǒng)、驅(qū)動SD卡寫入數(shù)據(jù)并生成.csv文件同時結(jié)合以太網(wǎng)驅(qū)動搭建TCP服務(wù)器接收網(wǎng)絡(luò)數(shù)據(jù)。內(nèi)容覆蓋FatFS的移植與參數(shù)配置、SDIO或SPI方式下的SD卡初始化與讀寫、CSV格式數(shù)據(jù)的文件創(chuàng)建與寫入以及基于lwIP的TCP服務(wù)器連接建立、數(shù)據(jù)接收與處理流程適合具備一定C語言與嵌入式基礎(chǔ)、希望打通存儲與網(wǎng)絡(luò)通信鏈路的開發(fā)者參考。資源包共1482個文件以629個c源文件、382個h頭文件為主另含144個d依賴文件、144個o目標(biāo)文件、142個crf交叉引用文件及少量庫文件、工程配置與說明文檔壓縮包約59.43MB工程結(jié)構(gòu)完整便于直接編譯與二次開發(fā)。目前已有8150人學(xué)習(xí)下載可幫助讀者快速理解SD卡文件系統(tǒng)與TCP數(shù)據(jù)落盤的完整實(shí)現(xiàn)思路。1. 從一塊 SD 卡說起為什么 fatfs 是 STM32 數(shù)據(jù)落盤繞不開的一環(huán)手上有個 STM32 的采集板傳感器數(shù)據(jù)在 RAM 里滾了幾百個字節(jié)一斷電全沒了。想把數(shù)據(jù)存下來最直接的辦法就是插一張 SD 卡讓它像 U 盤一樣能被電腦讀走。但 STM32 本身不認(rèn)識 FAT32 文件系統(tǒng)它只會按扇區(qū)讀寫原始數(shù)據(jù)。這時候 fatfs 就派上用場了——它是一個輕量級的 FAT 文件系統(tǒng)模塊專門給單片機(jī)用能把裸扇區(qū)操作封裝成f_open、f_write、f_close這種文件級接口。這個資源做的事很明確在 STM32 上通過 SDIO 或 SPI 驅(qū)動 SD 卡移植 fatfs然后周期性地把采集數(shù)據(jù)寫成.csv文件。csv 的好處是電腦端 Excel、Python pandas 直接能打開不用自己寫解析器。適合誰做數(shù)據(jù)采集、工業(yè)記錄儀、離線日志存儲的嵌入式開發(fā)者。如果你正在糾結(jié)數(shù)據(jù)怎么落盤、csv 怎么生成、fatfs 怎么配這篇可以跟著走一遍。2. fatfs 移植與 SD 卡底層驅(qū)動從扇區(qū)到文件句柄2.1 先搞清楚 fatfs 的分層結(jié)構(gòu)fatfs 的設(shè)計是分層解耦的。最上層是ff.c提供f_open、f_read、f_write這些 API跟具體硬件無關(guān)。中間是diskio.c這是一層薄薄的適配層把 fatfs 的disk_read、disk_write、disk_initialize映射到你自己的 SD 卡驅(qū)動。最底下才是 SDIO 或 SPI 的寄存器操作。常見做法是SDIO 模式跑 4 位總線理論速率能到幾十 Mbps適合高速采集SPI 模式接線簡單但速率受限于 SPI 時鐘一般也就幾 Mbps。我一般優(yōu)先選 SDIO除非引腳實(shí)在不夠。移植的核心工作就三件事實(shí)現(xiàn)diskio.c里的五個函數(shù)、配置ffconf.h里的宏、確保 SD 卡驅(qū)動能正常初始化并讀寫扇區(qū)。2.2 diskio.c 的五個函數(shù)怎么寫diskio.c里必須實(shí)現(xiàn)disk_initialize、disk_status、disk_read、disk_write、disk_ioctl。前兩個是狀態(tài)查詢后三個是實(shí)際讀寫。下面是一個基于 SDIO 的典型實(shí)現(xiàn)骨架#include diskio.h #include sdio_driver.h // 你自己的 SDIO 驅(qū)動頭文件 #define DEV_SD 0 DSTATUS disk_initialize(BYTE pdrv) { if (pdrv ! DEV_SD) return RES_PARERR; if (SDIO_Init() ! 0) return STA_NOINIT; // 初始化失敗 return 0; // 成功返回 0 } DSTATUS disk_status(BYTE pdrv) { if (pdrv ! DEV_SD) return RES_PARERR; return 0; // 簡化處理實(shí)際可查卡是否插入 } DRESULT disk_read(BYTE pdrv, BYTE *buff, DWORD sector, UINT count) { if (pdrv ! DEV_SD) return RES_PARERR; if (SDIO_ReadBlocks((uint8_t *)buff, sector, count) ! 0) return RES_ERROR; return RES_OK; } DRESULT disk_write(BYTE pdrv, const BYTE *buff, DWORD sector, UINT count) { if (pdrv ! DEV_SD) return RES_PARERR; if (SDIO_WriteBlocks((uint8_t *)buff, sector, count) ! 0) return RES_ERROR; return RES_OK; } DRESULT disk_ioctl(BYTE pdrv, BYTE cmd, void *buff) { if (pdrv ! DEV_SD) return RES_PARERR; switch (cmd) { case CTRL_SYNC: return RES_OK; // 等待寫完成SDIO 阻塞模式下可直接返回 case GET_SECTOR_COUNT: *(DWORD *)buff SDIO_GetSectorCount(); return RES_OK; case GET_SECTOR_SIZE: *(WORD *)buff 512; return RES_OK; case GET_BLOCK_SIZE: *(DWORD *)buff 1; // 擦除塊大小SD 卡填 1 即可 return RES_OK; default: return RES_PARERR; } }邏輯說明disk_initialize里調(diào)用你的 SDIO 初始化函數(shù)返回 0 表示成功。disk_read和disk_write直接轉(zhuǎn)發(fā)給底層塊讀寫函數(shù)注意sector是扇區(qū)號不是字節(jié)地址。disk_ioctl里GET_SECTOR_COUNT必須返回正確的扇區(qū)總數(shù)否則 fatfs 格式化或掛載時會算錯容量。參數(shù)說明pdrv是物理驅(qū)動號單卡場景固定為 0。buff是數(shù)據(jù)緩沖區(qū)count是扇區(qū)數(shù)。CTRL_SYNC在阻塞寫模式下可以直接返回 OK但如果你用了 DMA 或非阻塞寫這里必須等寫完成。2.3 ffconf.h 里必須改的幾個宏ffconf.h是 fatfs 的配置文件默認(rèn)值不一定適合 STM32。下面幾個宏我每次都會檢查宏名默認(rèn)值建議值原因_FS_TINY00設(shè)為 1 會省 RAM 但性能下降采集場景不差這點(diǎn)內(nèi)存_FS_READONLY00要寫 csv 必須為 0_USE_MKFS01卡沒格式化時可以直接在板子上格式化_CODE_PAGE932936932 是日文936 是簡體中文避免文件名亂碼_USE_LFN01 或 2支持長文件名csv 文件名可以寫完整日期_MAX_SS512512扇區(qū)大小SD 卡固定 512_VOLUMES11單卡場景一個卷夠了_USE_LFN設(shè)為 1 時用靜態(tài)緩沖區(qū)設(shè)為 2 時用棧上動態(tài)分配設(shè)為 3 時用堆。STM32 上我一般用 1省得折騰內(nèi)存管理。2.4 掛載與格式化第一次用卡必須做的事新卡或者電腦上格式化過的卡掛載前最好先確認(rèn)文件系統(tǒng)類型。如果卡是 exFAT 或 NTFSfatfs 默認(rèn)不支持需要f_mkfs重新格式化成 FAT32。下面是一段掛載加自動格式化的代碼FATFS fs; // 文件系統(tǒng)對象 FIL fil; // 文件對象 FRESULT fres; fres f_mount(fs, 0:, 1); // 1 表示立即掛載 if (fres ! FR_OK) { // 掛載失敗嘗試格式化 fres f_mkfs(0:, FM_FAT32, 0, NULL, 0); if (fres ! FR_OK) { printf(Format failed: %d\r\n, fres); return; } fres f_mount(fs, 0:, 1); if (fres ! FR_OK) { printf(Mount after format failed: %d\r\n, fres); return; } }邏輯說明f_mount的第三個參數(shù)為 1 時會立即執(zhí)行掛載操作為 0 時只注冊不掛載。f_mkfs的第二個參數(shù)指定格式類型FM_FAT32適合 32GB 以下的卡。第四個參數(shù)是工作緩沖區(qū)傳 NULL 時 fatfs 會用內(nèi)部緩沖區(qū)但有些版本要求外部提供傳 NULL 前先確認(rèn)版本。參數(shù)說明0:是邏輯驅(qū)動器號對應(yīng)diskio.c里的DEV_SD。f_mkfs的第三個參數(shù)是簇大小傳 0 表示自動選擇。3. 生成 csv 文件從 f_open 到 f_printf 的完整鏈路3.1 csv 文件的寫入流程csv 本質(zhì)是純文本每行一條記錄字段用逗號分隔。fatfs 提供f_printf函數(shù)可以直接往文件里寫格式化字符串比手動拼接再f_write方便得多。但f_printf需要開啟_FS_READONLY為 0 且_USE_STRFUNC不為 0。典型流程是打開文件追加模式→ 寫表頭如果是新文件→ 寫數(shù)據(jù)行 → 關(guān)閉文件。下面是一個完整的寫入函數(shù)FRESULT write_csv_record(FIL *fil, uint32_t timestamp, float temp, float humi) { FRESULT fres; UINT bw; // 以追加模式打開如果文件不存在則創(chuàng)建 fres f_open(fil, 0:data.csv, FA_OPEN_ALWAYS | FA_WRITE); if (fres ! FR_OK) return fres; // 移動到文件末尾 fres f_lseek(fil, f_size(fil)); if (fres ! FR_OK) { f_close(fil); return fres; } // 如果文件為空先寫表頭 if (f_size(fil) 0) { f_printf(fil, timestamp,temperature,humidity\r\n); } // 寫數(shù)據(jù)行 f_printf(fil, %lu,%.2f,%.2f\r\n, timestamp, temp, humi); f_close(fil); // 必須關(guān)閉否則數(shù)據(jù)可能還在緩存里 return FR_OK; }邏輯說明FA_OPEN_ALWAYS表示文件存在就打開不存在就創(chuàng)建。f_lseek移動到末尾是為了追加而不是覆蓋。f_size返回當(dāng)前文件大小用來判斷是否需要寫表頭。f_printf的格式化語法和標(biāo)準(zhǔn) C 的printf基本一致但浮點(diǎn)數(shù)支持取決于_USE_STRFUNC的配置。參數(shù)說明fil是文件對象指針調(diào)用前需要先f_mount。timestamp用%lu因?yàn)樗?32 位無符號數(shù)。%.2f保留兩位小數(shù)csv 里夠用了。\r\n是 Windows 換行符Excel 打開不會亂行。3.2 寫入頻率與緩沖策略每次采集都f_openf_close一次在低頻場景比如每秒一條沒問題。但如果每秒要寫幾十上百條頻繁開關(guān)文件會拖慢速度因?yàn)槊看蝔_close都會觸發(fā) FAT 表更新和扇區(qū)寫入。我一般會這樣做文件保持打開狀態(tài)每隔 N 條或者每隔幾秒調(diào)用一次f_sync把緩存刷到卡里。f_sync比f_close輕量只刷新數(shù)據(jù)不關(guān)閉文件。掉電風(fēng)險高的場景N 取小一點(diǎn)比如 10 條同步一次對掉電不敏感的場景可以 100 條同步一次。// 保持文件打開定期 sync static FIL csv_fil; static uint32_t record_count 0; void csv_append(uint32_t ts, float t, float h) { f_printf(csv_fil, %lu,%.2f,%.2f\r\n, ts, t, h); record_count; if (record_count % 10 0) { f_sync(csv_fil); // 每 10 條刷一次 } }邏輯說明f_sync會把文件緩存區(qū)的臟數(shù)據(jù)寫回 SD 卡但不關(guān)閉文件句柄。這樣既減少了開關(guān)開銷又控制了掉電丟數(shù)據(jù)的窗口。參數(shù)說明record_count是靜態(tài)變量記錄自上次 sync 以來寫了多少條。取 10 是經(jīng)驗(yàn)值具體看你的數(shù)據(jù)重要程度和 SD 卡寫入速度。3.3 文件名帶時間戳避免覆蓋和歷史追溯固定叫data.csv有個問題每次上電都往同一個文件追加時間長了文件巨大而且分不清哪次采集是哪次。更好的做法是用 RTC 的時間生成文件名比如20250101_120000.csv。這樣每次上電新建一個文件電腦上按文件名就能排序。void create_csv_by_time(FIL *fil, RTC_TimeTypeDef *time, RTC_DateTypeDef *date) { char fname[32]; snprintf(fname, sizeof(fname), 0:%04d%02d%02d_%02d%02d%02d.csv, date-Year 2000, date-Month, date-Date, time-Hours, time-Minutes, time-Seconds); f_open(fil, fname, FA_CREATE_ALWAYS | FA_WRITE); }邏輯說明snprintf拼出文件名FA_CREATE_ALWAYS表示每次都新建如果同名文件存在就覆蓋。RTC 的年份寄存器通常存的是 2000 年起的偏移所以要加 2000。參數(shù)說明fname緩沖區(qū)至少 32 字節(jié)0:前綴不能少。snprintf比sprintf安全能防止緩沖區(qū)溢出。4. 避坑與排查SD 卡 fatfs 最容易翻車的五個地方4.1 掛載返回 FR_NOT_READY 或 FR_DISK_ERR現(xiàn)象f_mount返回FR_NOT_READY或者f_open返回FR_DISK_ERR。原因九成是disk_initialize沒成功或者disk_read讀不到扇區(qū) 0。SD 卡上電后需要一段初始化時間如果 MCU 啟動太快卡還沒準(zhǔn)備好就發(fā)命令就會失敗。解決在disk_initialize里加延時上電后至少等 1ms 再發(fā) CMD0。另外檢查 SDIO 時鐘分頻初始化階段必須降到 400kHz 以下初始化完成后再切到高速。SPI 模式同理先低速再高速。4.2 寫 csv 后電腦打開亂碼或列錯位現(xiàn)象csv 文件在 Excel 里打開中文亂碼或者所有數(shù)據(jù)擠在一列。原因Excel 默認(rèn)按系統(tǒng)區(qū)域設(shè)置解析 csv如果文件里沒有 BOM中文可能亂碼。列錯位通常是分隔符問題有些區(qū)域設(shè)置用分號而不是逗號。解決表頭和數(shù)據(jù)里不要用中文字段名用英文。如果一定要中文在文件開頭寫入 UTF-8 BOM0xEF 0xBB 0xBF。列錯位的話確認(rèn)f_printf里用的是逗號且字段值里沒有多余的逗號。4.3 f_write 返回成功但數(shù)據(jù)沒落盤現(xiàn)象f_write和f_close都返回FR_OK但拔卡插電腦上發(fā)現(xiàn)文件是空的或者少了最后幾條。原因fatfs 有緩存機(jī)制f_write只是寫到緩存f_close才真正刷到卡。如果f_close之前掉電緩存里的數(shù)據(jù)就丟了。另外有些 SD 卡內(nèi)部也有緩存f_close返回后卡可能還在寫。解決對掉電敏感的場景每次寫完調(diào)用f_sync并且f_sync之后加一句disk_ioctl(0, CTRL_SYNC, NULL)確?？▋?nèi)部也寫完。如果還不行換一張卡試試有些雜牌卡緩存策略很激進(jìn)。4.4 長時間寫入后速度越來越慢現(xiàn)象剛開始寫 csv 很快寫了幾千條之后越來越慢甚至卡死。原因FAT 表碎片化。頻繁創(chuàng)建刪除文件、或者文件反復(fù)增長會導(dǎo)致 FAT 表里簇鏈變得很長每次寫都要遍歷簇鏈。另外如果 SD 卡質(zhì)量差壞塊重映射也會拖慢速度。解決定期整理比如每天新建一個文件而不是往同一個文件無限追加。格式化時選大一點(diǎn)的簇比如 32KB減少簇鏈長度。如果卡已經(jīng)用了很久用f_mkfs重新格式化一次。4.5 多任務(wù)環(huán)境下 fatfs 重入問題現(xiàn)象在 RTOS 里一個任務(wù)寫 csv另一個任務(wù)讀配置偶爾會死機(jī)或者文件損壞。原因fatfs 默認(rèn)不是線程安全的多個任務(wù)同時調(diào)用f_open、f_write會破壞內(nèi)部狀態(tài)。解決給 fatfs 加互斥鎖。簡單做法是用一個全局標(biāo)志位訪問前檢查并置位訪問完清除。更規(guī)范的做法是用 RTOS 的互斥量在f_mount之后創(chuàng)建每次文件操作前 take操作完 give。另外_FS_REENTRANT宏可以開啟 fatfs 自帶的重入保護(hù)但需要你實(shí)現(xiàn)ff_req_grant和ff_rel_grant兩個信號量函數(shù)。5. 進(jìn)階技巧用 f_printf 直接輸出帶表頭的結(jié)構(gòu)化 csv前面寫的 csv 是手動拼表頭和數(shù)據(jù)行其實(shí) fatfs 的f_printf可以更靈活。比如你要記錄多種傳感器字段數(shù)量不固定可以用一個格式化函數(shù)統(tǒng)一處理。下面這個技巧我經(jīng)常用把表頭和數(shù)據(jù)行都封裝成函數(shù)字段用數(shù)組傳入避免每次改字段都要改代碼。// 寫表頭fields 是字段名數(shù)組count 是字段數(shù) FRESULT csv_write_header(FIL *fil, const char **fields, uint8_t count) { for (uint8_t i 0; i count; i) { f_printf(fil, %s, fields[i]); if (i count - 1) f_printf(fil, ,); } f_printf(fil, \r\n); return FR_OK; } // 寫一行 float 數(shù)據(jù) FRESULT csv_write_row(FIL *fil, const float *values, uint8_t count) { for (uint8_t i 0; i count; i) { f_printf(fil, %.3f, values[i]); if (i count - 1) f_printf(fil, ,); } f_printf(fil, \r\n); return FR_OK; }邏輯說明csv_write_header遍歷字段名數(shù)組用逗號分隔最后換行。csv_write_row同理但輸出的是浮點(diǎn)數(shù)。這樣字段增減只需要改數(shù)組不用動寫入邏輯。參數(shù)說明fields是字符串指針數(shù)組values是浮點(diǎn)數(shù)組count是字段數(shù)量。%.3f保留三位小數(shù)按需調(diào)整。驗(yàn)證方法寫完之后把卡拔下來插電腦用 Excel 或文本編輯器打開確認(rèn)列對齊、行數(shù)正確、沒有多余空行。更嚴(yán)格的驗(yàn)證是用 Python 的csv模塊讀一遍import csv with open(data.csv, r) as f: reader csv.reader(f) for row in reader: print(row)如果 Python 能正常解析說明格式?jīng)]問題。我一般還會檢查文件大小和記錄數(shù)是否匹配比如每條記錄約 30 字節(jié)1000 條就是 30KB 左右差太多說明有丟數(shù)據(jù)。從那以后我每次寫完 csv 都強(qiáng)制走一遍「拔卡→電腦讀→Python 解析」的流程確認(rèn)無誤再批量部署。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取