1. 项目概述一个嵌入式工程师的“数据搬运工”方案最近在做一个工业数据采集的小玩意儿核心需求是把传感器采集到的数据先存到本地然后能方便地通过USB接口导出来给上位机分析。听起来简单但真动手选型时发现市面上很多现成的模块要么功能单一要么成本偏高。琢磨了一圈最终敲定了GD32F103 SD卡 USB 文件系统这套组合拳。这方案说白了就是用一颗性价比极高的国产MCU搭起一个既能大容量存储、又能即插即用传输数据的完整系统。它非常适合那些需要离线记录数据事后又需要便捷读取的场合比如车载黑匣子、环境监测终端、或者一些需要脱机升级固件的设备。GD32F103大家应该不陌生作为一款与STM32F103高度兼容的Cortex-M3内核MCU它性能足够外设丰富关键是供货和成本优势明显。SD卡提供了几乎无限的存储扩展能力而USB Device功能则让设备变身成一个U盘电脑无需安装任何驱动直接就能访问里面的数据文件。文件系统则是连接硬件和应用的桥梁它让我们的数据不再是杂乱无章的二进制流而是有名字、有目录、可以随意增删改查的“文件”。这个项目就是要把这几块硬骨头啃下来串成一个稳定可靠的数据链路。无论你是想学习嵌入式存储还是正在为产品寻找数据落地方案这套架构都值得你花时间深入研究一下。2. 核心方案选型与设计思路拆解2.1 为什么是GD32F103选择GD32F103C8T6这颗芯片作为主控是基于多方面的权衡。首先当然是成本在功能相近的M3内核MCU里它的价格非常有竞争力。其次它拥有丰富的外设至少2个SPI接口一个给SD卡另一个可能留给其他传感器或显示屏、1个USB 2.0全速Device接口、以及足够用的SRAM和Flash。对于文件系统操作尤其是FATFS需要一定的内存作为缓冲区GD32F103的20KB SRAM以C8T6为例在精心管理下是够用的。更重要的是生态和开发便利性。GD32的库函数风格与STM32标准外设库相似有大量现成的参考代码和社区资源可以借鉴。其USB IP核也较为成熟官方提供了USB Device库实现Mass Storage大容量存储设备类有迹可循。因此选用它技术风险较低开发周期可控。2.2 存储媒介SD卡 vs. SPI Flash vs. eMMC为什么用SD卡而不用更常见的SPI Flash或者eMMC这取决于我们的核心需求大容量、可移动、标准化。SPI Flash通常容量较小几MB到几十MB且需要自己管理坏块和磨损均衡虽然接口简单但做大容量数据记录比如长时间录制的数据很快会捉襟见肘。eMMC性能强大接口也相对简单但成本较高且一般焊死在板子上数据导出不够灵活。SD卡则完美契合需求容量从几百MB到上百GB可选价格低廉物理上可插拔方便更换和读取通信协议标准化SPI模式或SDIO模式。我们选择SPI模式驱动SD卡虽然速度比SDIO模式慢但其优势是占用MCU引脚少驱动代码简单几乎任何有SPI接口的MCU都能使用移植性极佳。对于数据记录这种对连续写入速度要求不是极端高的场景SPI模式的SD卡完全够用。2.3 文件系统FATFS的必然之选在嵌入式领域谈及文件系统FATFS几乎是唯一的选择。它是一个专为小型嵌入式系统设计的、通用且开源的FAT文件系统模块。它完全用ANSI C编写与平台无关资源占用小支持FAT12、FAT16、FAT32和exFAT需使能。使用文件系统的好处是巨大的。没有文件系统你的数据在SD卡上就是一连串扇区你需要自己记住哪个文件从哪个扇区开始、有多长管理起来极其麻烦。而有了FATFS你可以使用f_open,f_write,f_read,f_close这样高级的API来操作文件就像在电脑上编程一样。数据以文件形式存储例如“20240515_sensor_data.csv”在电脑上通过USB连接后可以直接双击用Excel打开用户体验直线上升。2.4 USB接口的角色从“传输”到“设备”USB在这里扮演的角色不是简单的串口转换CDC类而是大容量存储设备类MSC。这意味着当设备通过USB线连接到电脑时电脑会将其识别为一个普通的U盘或移动硬盘。用户可以直接在电脑的资源管理器里进行文件的复制、粘贴、删除操作无需任何额外的上位机软件。实现MSC的关键在于USB协议栈需要将来自主机的文件操作命令如读取扇区、写入扇区翻译成对底层存储介质即SD卡通过FATFS抽象的访问。这相当于在GD32内部虚拟了一个“U盘”而这个“U盘”的实际内容就是SD卡上的FAT文件系统卷。整体数据流设计思路如下应用层传感器数据通过ADC或I2C/SPI采集。数据缓冲层数据先存入MCU内部RAM的缓冲区攒够一定量如512字节一个扇区大小或到达一定时间。文件系统层调用FATFS的f_write函数将缓冲区数据写入SD卡上已打开的文件中。FATFS负责管理文件分配表、目录项等。物理存储层FATFS通过我们提供的底层磁盘I/O接口disk_read,disk_write以扇区为单位读写SD卡。USB交互层当USB连接时USB MSC协议栈接管。主机电脑发送的SCSI命令如读10、写10被解析转化为对特定逻辑块地址LBA的读写请求最终调用与FATFS相同的底层磁盘I/O接口来访问SD卡。这个架构清晰地将功能模块化耦合度低便于调试和维护。3. 硬件连接与底层驱动实现3.1 GD32与SD卡的SPI连接我们采用SPI模式驱动SD卡需要连接4根线不包括电源和地SD卡引脚CLK, CMD(MOSI), DAT0(MISO), CSGD32 SPI引脚SCK, MOSI, MISO, 和一个任意GPIO作为片选CS。以SPI1为例一种典型的连接方式如下SD卡引脚对应功能GD32引脚备注CLK时钟PA5 (SPI1_SCK)必须上拉CMD主机出从机入PA7 (SPI1_MOSI)上拉10K-100K电阻DAT0主机入从机出PA6 (SPI1_MISO)上拉CS片选PA4 (自定义GPIO)低电平有效初始为高注意SD卡在SPI模式下DAT1和DAT2引脚可以悬空。所有信号线最好串联一个22-33欧姆的小电阻用于阻抗匹配和抑制过冲。电源去耦电容100nF 10uF必须靠近SD卡座放置确保供电稳定。3.2 SPI驱动SD卡的初始化与读写SD卡在SPI模式下的初始化过程有严格的时序要求必须遵循SD协会的规范。流程大致如下上电延时SD卡上电后需要等待至少74个时钟周期约1ms的稳定时间期间保持CS为高、MOSI为高。进入SPI模式拉低CS发送CMD0 (GO_IDLE_STATE)命令参数为0x00000000CRC为0x95。此命令会让SD卡复位并进入SPI模式。检查电压范围发送CMD8 (SEND_IF_COND)用于验证主机电压是否在卡的支持范围内。V2版本的卡会回应。初始化流程循环发送CMD55 (APP_CMD) ACMD41 (SD_SEND_OP_COND)直到卡返回0x00表示初始化完成。这个过程可能持续数百毫秒。读取OCR寄存器发送CMD58 (READ_OCR)获取卡的操作条件寄存器可以判断卡是SDSC标准容量支持CMD8还是SDHC/SDXC高容量不支持CMD8。设置块长度对于标准容量卡需要发送CMD16 (SET_BLOCKLEN)将块长度设置为512字节。高容量卡固定为512字节此命令可选。关键点所有命令和响应都是通过SPI全双工通信完成的。发送命令包后需要持续读取SPI DR寄存器直到收到有效的响应起始位0x00。超时处理非常重要每个命令阶段都应设置合理的超时计数。扇区读写函数是连接FATFS的桥梁必须稳定可靠。disk_read(BYTE* buff, LBA_t sector, UINT count): 从SD卡的指定逻辑扇区sector开始读取count个扇区数据到buff。disk_write(const BYTE* buff, LBA_t sector, UINT count): 将buff中的数据写入SD卡的指定扇区。在SPI模式下单块读写使用CMD17 (READ_SINGLE_BLOCK)和CMD24 (WRITE_BLOCK)。多块读写有专用命令效率更高。写入时必须先发送CMD24然后是一个字节的起始令牌0xFE接着是512字节数据最后是2个字节的CRC在SPI模式下通常可以忽略填0xFF即可。写入后必须等待卡返回数据响应令牌并持续查询直到卡不再繁忙。实操心得SD卡SPI驱动调试时逻辑分析仪是神器。用它抓取SPI总线上的CMD、响应、数据令牌的波形与SD物理层规范文档对照任何时序或数据错误都无处遁形。另外GPIO模拟SPI虽然灵活但在高速读写时可能不稳定优先使用MCU的硬件SPI外设。3.3 USB Device的硬件与软件栈初始化GD32的USB外设需要连接DPPA12和DMPA11两根数据线到USB接口的对应引脚。USB接口需要提供稳定的5V电源并在DP线上通过一个1.5K欧姆电阻上拉到3.3V内置在GD32中通常通过配置上拉使能。软件上我们需要移植或使用GD32官方提供的USB Device库。核心工作是实现一个大容量存储设备MSC类。配置USB时钟USB模块需要48MHz的精确时钟。通常由PLL提供需要仔细配置系统时钟树确保USB时钟源准确。实现端点配置MSC类通常使用两个Bulk端点一个IN端点设备到主机和一个OUT端点主机到设备。端点缓冲区大小通常设置为64字节全速USB的最大包长。实现类特定请求MSC类通过Bulk-Only Transport (BOT)协议通信需要处理Get Max LUN和BOT Reset等类请求。实现SCSI命令集这是最核心的部分。USB主机发送的是封装在CBW命令块包装中的SCSI命令。我们需要解析这些命令并执行相应的操作。最关键的几个SCSI命令是TEST UNIT READY: 查询设备是否就绪。INQUIRY: 获取设备信息。READ CAPACITY: 获取存储设备容量总扇区数、扇区大小。READ(10): 读取扇区。WRITE(10): 写入扇区。REQUEST SENSE: 获取错误信息。当收到READ(10)命令时我们需要根据命令中的LBA地址和传输长度调用底层的disk_read函数读取SD卡数据然后通过USB IN端点发送给主机。WRITE(10)命令则相反从USB OUT端点接收数据调用disk_write写入SD卡。注意事项USB MSC的枚举过程对时序要求严格。在设备尚未枚举成功即电脑未识别出U盘前绝对不能进行SD卡的读写操作否则可能导致枚举失败。通常的做法是在USB配置描述符中报告一个“可移除”的存储设备并在TEST UNIT READY命令中根据SD卡是否初始化成功来返回“就绪”或“未就绪”状态。4. FATFS文件系统的移植与集成4.1 FATFS源码配置与裁剪从FatFs官网获取最新源码我们主要关心以下文件ff.c,ff.h: 文件系统模块本身。diskio.c,diskio.h: 底层磁盘I/O接口这是我们移植的重点。ffconf.h: 配置文件所有功能开关和参数都在这里。在ffconf.h中关键的配置项有_FS_TINY: 设置为1使用更小的缓冲区节省RAM。_USE_LFN: 长文件名支持。设置为2使用栈缓冲区或3使用堆缓冲区。启用会增加代码大小和RAM消耗。_CODE_PAGE: 代码页用于支持中文文件名。简体中文对应936。_USE_MKFS: 是否使能格式化功能。如果产品需要可以开启。_MAX_SS,_MIN_SS: 扇区大小。设置为512与SD卡一致。diskio.c中需要实现六个函数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); DWORD get_fattime (void); // 获取当前时间用于文件时间戳。其中disk_read和disk_write直接调用我们前面写好的SD卡扇区读写函数。disk_ioctl需要处理几个重要的控制命令特别是GET_SECTOR_COUNT获取总扇区数和GET_SECTOR_SIZE获取扇区大小这两个信息对于USB MSC报告设备容量至关重要。4.2 文件系统操作的核心API应用移植完成后就可以在应用层愉快地使用文件系统了。基本流程遵循“挂载-打开/创建-读写-关闭-卸载”。FATFS fs; // 文件系统对象 FIL file; // 文件对象 UINT bw; // 写入的字节数 // 1. 挂载SD卡 f_mount(fs, “0:”, 1); // “0:” 对应 diskio.c 中的 pdrv0 // 2. 打开文件如果不存在则创建 f_open(file, “0:/data.log”, FA_OPEN_ALWAYS | FA_WRITE); // 3. 移动指针到文件末尾追加写入 f_lseek(file, f_size(file)); // 4. 写入数据 char buffer[] “Hello, FATFS!\r\n”; f_write(file, buffer, strlen(buffer), bw); // 5. 关闭文件 f_close(file); // 6. 不再使用时卸载 f_mount(NULL, “0:”, 0);关键技巧频繁开关文件对于数据记录应用不要每次写入都f_open和f_close。这会导致FAT表被频繁回写既降低速度又增加SD卡磨损。正确的做法是上电后打开文件期间一直保持打开状态定期调用f_sync(file)将缓存数据强制写入物理介质断电前再安全关闭。缓冲区管理FATFS内部有缓存。通过合理配置ffconf.h中的_MAX_SS和缓存数量可以平衡性能和内存消耗。也可以使用更大的应用层缓冲区攒够多个扇区数据后一次性写入效率更高。错误处理每次文件操作后都应检查返回值FRESULT类型。常见的错误有FR_DISK_ERR底层磁盘错误、FR_NOT_READY磁盘未初始化、FR_NO_FILE文件未找到等。需要有相应的错误处理或重试机制。4.3 时间戳与长文件名支持要使生成的文件在电脑上显示正确的创建/修改时间需要实现get_fattime()函数。这个函数需要返回一个32位的时间戳格式遵循FAT文件系统标准。通常我们可以从RTC实时时钟获取或者如果设备联网可以从网络同步。DWORD get_fattime(void) { // 假设我们有获取时间的函数 get_rtc_time() // 格式: bit31:25 - 年(0-127) 相对于1980年, bit24:21 - 月(1-12), bit20:16 - 日(1-31) // bit15:11 - 时(0-23), bit10:5 - 分(0-59), bit4:0 - 秒/2 (0-29) uint32_t year, month, day, hour, min, sec; get_rtc_time(year, month, day, hour, min, sec); return ((year-1980) 25) | (month 21) | (day 16) | (hour 11) | (min 5) | (sec/2); }长文件名支持需要将_USE_LFN设置为2或3并添加相应的编码转换文件如cc936.c用于简体中文。这会显著增加代码体积可能增加几十KB的Flash占用需要根据项目资源情况权衡。5. 系统整合与任务调度策略5.1 数据记录、USB传输与文件系统的协同整个系统存在两个可能并行或冲突的任务后台数据记录和前台USB传输。它们共享同一个资源——SD卡及其上的FAT文件系统。因此互斥访问是必须考虑的核心问题。冲突场景设备正在通过USB向电脑传输一个数据文件同时应用层又需要向同一个文件追加写入新的传感器数据。如果不加控制FATFS的缓存、目录项、FAT表可能会被两个任务同时修改导致文件系统损坏。解决方案使用信号量Semaphore或互斥锁Mutex对FATFS的API调用进行保护。在RTOS环境下这很容易实现。在裸机环境下可以通过全局标志位和状态机来实现。一种简单的裸机策略是状态优先默认状态数据记录任务拥有SD卡访问权可以正常写文件。USB连接事件当检测到USB连接并成功枚举为MSC设备后设置一个usb_active标志。数据记录任务在每次尝试写SD卡前检查usb_active标志。如果为真则跳过本次写入将数据暂存在一个更大的循环缓冲区中。注意此时绝不能调用任何FATFS函数因为USB MSC正在底层直接操作磁盘扇区。USB断开事件USB断开后清除usb_active标志。数据记录任务检测到标志清除首先将循环缓冲区中积压的数据写入SD卡然后恢复正常记录。重要警告当USB MSC活动时FATFS的缓存内容可能与SD卡物理内容不一致。因此在USB连接前必须调用f_sync()确保所有缓存数据落盘并调用f_mount(NULL, …)卸载文件系统。在USB断开后再重新f_mount和f_open文件。这是最安全、最稳妥的做法。5.2 电源管理与数据安全对于数据记录设备突然断电导致文件系统损坏是致命问题。除了前面提到的定期f_sync还可以从硬件和软件层面增强安全性。硬件层面使用带有电源监测和写保护功能的SD卡座。在电源路径上设计大电容提供掉电后数十毫秒的维持时间让MCU有机会执行紧急关断流程。在检测到电压跌落通过MCU的ADC或专用电压监测芯片时立即触发中断在最短时间内完成f_sync和f_close。软件层面实现看门狗防止程序跑飞导致文件操作中断。采用原子操作思想先将数据写入一个临时文件如data.tmp写入完成并f_sync后再重命名为正式文件如data.log。这样即使写入过程断电也只会损失一个临时文件而不会破坏主日志文件。定期检查文件系统健康度可以在启动时使用f_mkfs如果使能修复轻微错误或者使用chkdsk工具在电脑端修复。5.3 性能优化与调试心得性能瓶颈分析SPI时钟频率提高SPI的时钟分频系数。GD32F103的SPI在72MHz系统时钟下理论上可以跑到36MHz主模式二分频。但受限于SD卡本身和PCB布线质量通常18MHz或9MHz是更稳定的选择。写入策略单扇区写入CMD24效率低。尽量使用多扇区写入命令CMD25。FATFS的f_write函数支持一次写入多个扇区只要在disk_write函数中实现多块写入即可。文件系统开销频繁写入小数据如每秒写几个字节会因簇分配和FAT表更新导致大量额外写入。最佳实践是在应用层进行缓冲攒够512字节甚至4KB8个扇区后再一次性写入。调试心得分阶段调试不要试图一次性集成所有功能。先调通SPI读写SD卡可以用简单的扇区读写测试程序验证。再单独移植FATFS实现创建文件、读写文件。最后再集成USB MSC。善用调试信息通过串口打印关键步骤的状态、返回值、错误代码。FATFS的FRESULT可以转换成字符串打印出来非常直观。电脑端工具使用WinHex或HxD这类磁盘编辑器可以直接查看SD卡的原始扇区数据对照FAT32文件系统结构分析目录项、FAT表是定位文件系统问题的终极手段。6. 常见问题排查与实战技巧在实际开发中你一定会遇到各种各样的问题。下面这个表格整理了一些典型故障现象、可能原因和排查思路问题现象可能原因排查思路与解决方案SD卡初始化失败1. 电源不稳或电流不足。2. SPI时序或相位(CPOL/CPHA)设置错误。3. 上电后等待时间不足。4. 卡本身损坏或格式不支持。1. 测量SD卡供电电压应在2.7-3.6V检查去耦电容。2. SD卡SPI模式要求CPOL0, CPHA0。用逻辑分析仪抓取CMD0波形确认。3. 发送至少74个时钟周期的全10xFF后再拉低CS。4. 换一张已知好的、已格式化为FAT32的SDHC卡32GB测试。可以初始化但读写扇区失败1. 读写命令或令牌格式错误。2. 读写超时时间设置太短。3. 多块读写未正确发送停止命令。1. 用逻辑分析仪对比读写命令波形与规范。2. 适当增加等待数据响应令牌和写操作完成的时间。3. 多块写结束时必须发送CMD12停止传输。FATFS挂载失败(FR_NO_FILESYSTEM)1. SD卡没有文件系统或不是FAT格式。2.disk_read函数读取的MBR或DBR扇区数据错误。3. 分区类型不对应为0x0B或0x0C。1. 在电脑上将SD卡格式化为FAT32。2. 调试disk_read确保能正确读取0扇区MBR。3. 使用磁盘编辑器查看0扇区确认分区表信息。能创建文件但电脑USB识别不到U盘1. USB硬件连接问题DP/DM接反、没接上拉。2. USB时钟不是精确的48MHz。3. USB描述符设备描述符、配置描述符等配置错误。4. MSC的SCSI命令响应不正确。1. 检查USB线、测量DP线电压应有约3.3V上拉。2. 用示波器测量USB时钟引脚PA8的MCO输出可配置为检查时钟。3. 使用USB协议分析仪如Beagle USB抓取枚举过程数据包这是最直接的调试方法。4. 确保READ CAPACITY等命令返回的数据格式和字节序正确。电脑识别到U盘但提示“需要格式化”1. USB MSC报告的设备容量扇区数、扇区大小与实际不符。2. 文件系统在USB活动期间被MCU意外写入导致结构损坏。3. 底层disk_read函数返回的数据有误。1. 检查disk_ioctl中GET_SECTOR_COUNT和GET_SECTOR_SIZE的实现确保与SD卡实际容量一致。2.确保USB活动时应用层已卸载文件系统且不再操作SD卡。3. 在USB MSC的READ(10)处理函数中对比读取的数据与通过disk_read直接读取的数据是否一致。USB传输文件速度极慢1. SPI时钟设置过低。2. 使用了单扇区读写命令。3. USB端点缓冲区大小设置不当或处理不及时。4. 文件碎片化严重。1. 在保证稳定的前提下提高SPI时钟频率。2. 实现并启用多扇区读写CMD17/18, CMD24/25。3. 确保USB中断优先级足够高及时处理端点数据。4. 定期在电脑上对SD卡进行碎片整理对于日志文件顺序写入一般不会碎片化。长时间运行后文件系统损坏1. 突然断电导致FAT表或目录项未更新。2. 多任务访问冲突。3. SD卡寿命到期闪存有擦写次数限制。1. 加强掉电保护机制增加钽电容实现掉电检测紧急保存。2. 严格进行资源互斥访问管理。3. 选择工业级或高耐久度的SD卡并在软件上做磨损均衡FATFS本身不提供可考虑定期更换文件存储位置。最后的实战技巧在项目初期可以先用一个简单的测试框架来验证每个环节。例如写一个循环每秒向SD卡的一个文件追加写入当前系统时间戳和一段测试数据。同时每隔一段时间就通过USB连接电脑查看文件内容是否正确并复制一个大文件进去再拷出来对比MD5校验和。这个简单的测试能暴露出稳定性、速度和数据一致性的大部分问题。把基础打牢后续增加复杂的应用逻辑就会顺利得多。
1. 项目概述一个嵌入式工程师的“数据搬运工”方案最近在做一个工业数据采集的小玩意儿核心需求是把传感器采集到的数据先存到本地然后能方便地通过USB接口导出来给上位机分析。听起来简单但真动手选型时发现市面上很多现成的模块要么功能单一要么成本偏高。琢磨了一圈最终敲定了GD32F103 SD卡 USB 文件系统这套组合拳。这方案说白了就是用一颗性价比极高的国产MCU搭起一个既能大容量存储、又能即插即用传输数据的完整系统。它非常适合那些需要离线记录数据事后又需要便捷读取的场合比如车载黑匣子、环境监测终端、或者一些需要脱机升级固件的设备。GD32F103大家应该不陌生作为一款与STM32F103高度兼容的Cortex-M3内核MCU它性能足够外设丰富关键是供货和成本优势明显。SD卡提供了几乎无限的存储扩展能力而USB Device功能则让设备变身成一个U盘电脑无需安装任何驱动直接就能访问里面的数据文件。文件系统则是连接硬件和应用的桥梁它让我们的数据不再是杂乱无章的二进制流而是有名字、有目录、可以随意增删改查的“文件”。这个项目就是要把这几块硬骨头啃下来串成一个稳定可靠的数据链路。无论你是想学习嵌入式存储还是正在为产品寻找数据落地方案这套架构都值得你花时间深入研究一下。2. 核心方案选型与设计思路拆解2.1 为什么是GD32F103选择GD32F103C8T6这颗芯片作为主控是基于多方面的权衡。首先当然是成本在功能相近的M3内核MCU里它的价格非常有竞争力。其次它拥有丰富的外设至少2个SPI接口一个给SD卡另一个可能留给其他传感器或显示屏、1个USB 2.0全速Device接口、以及足够用的SRAM和Flash。对于文件系统操作尤其是FATFS需要一定的内存作为缓冲区GD32F103的20KB SRAM以C8T6为例在精心管理下是够用的。更重要的是生态和开发便利性。GD32的库函数风格与STM32标准外设库相似有大量现成的参考代码和社区资源可以借鉴。其USB IP核也较为成熟官方提供了USB Device库实现Mass Storage大容量存储设备类有迹可循。因此选用它技术风险较低开发周期可控。2.2 存储媒介SD卡 vs. SPI Flash vs. eMMC为什么用SD卡而不用更常见的SPI Flash或者eMMC这取决于我们的核心需求大容量、可移动、标准化。SPI Flash通常容量较小几MB到几十MB且需要自己管理坏块和磨损均衡虽然接口简单但做大容量数据记录比如长时间录制的数据很快会捉襟见肘。eMMC性能强大接口也相对简单但成本较高且一般焊死在板子上数据导出不够灵活。SD卡则完美契合需求容量从几百MB到上百GB可选价格低廉物理上可插拔方便更换和读取通信协议标准化SPI模式或SDIO模式。我们选择SPI模式驱动SD卡虽然速度比SDIO模式慢但其优势是占用MCU引脚少驱动代码简单几乎任何有SPI接口的MCU都能使用移植性极佳。对于数据记录这种对连续写入速度要求不是极端高的场景SPI模式的SD卡完全够用。2.3 文件系统FATFS的必然之选在嵌入式领域谈及文件系统FATFS几乎是唯一的选择。它是一个专为小型嵌入式系统设计的、通用且开源的FAT文件系统模块。它完全用ANSI C编写与平台无关资源占用小支持FAT12、FAT16、FAT32和exFAT需使能。使用文件系统的好处是巨大的。没有文件系统你的数据在SD卡上就是一连串扇区你需要自己记住哪个文件从哪个扇区开始、有多长管理起来极其麻烦。而有了FATFS你可以使用f_open,f_write,f_read,f_close这样高级的API来操作文件就像在电脑上编程一样。数据以文件形式存储例如“20240515_sensor_data.csv”在电脑上通过USB连接后可以直接双击用Excel打开用户体验直线上升。2.4 USB接口的角色从“传输”到“设备”USB在这里扮演的角色不是简单的串口转换CDC类而是大容量存储设备类MSC。这意味着当设备通过USB线连接到电脑时电脑会将其识别为一个普通的U盘或移动硬盘。用户可以直接在电脑的资源管理器里进行文件的复制、粘贴、删除操作无需任何额外的上位机软件。实现MSC的关键在于USB协议栈需要将来自主机的文件操作命令如读取扇区、写入扇区翻译成对底层存储介质即SD卡通过FATFS抽象的访问。这相当于在GD32内部虚拟了一个“U盘”而这个“U盘”的实际内容就是SD卡上的FAT文件系统卷。整体数据流设计思路如下应用层传感器数据通过ADC或I2C/SPI采集。数据缓冲层数据先存入MCU内部RAM的缓冲区攒够一定量如512字节一个扇区大小或到达一定时间。文件系统层调用FATFS的f_write函数将缓冲区数据写入SD卡上已打开的文件中。FATFS负责管理文件分配表、目录项等。物理存储层FATFS通过我们提供的底层磁盘I/O接口disk_read,disk_write以扇区为单位读写SD卡。USB交互层当USB连接时USB MSC协议栈接管。主机电脑发送的SCSI命令如读10、写10被解析转化为对特定逻辑块地址LBA的读写请求最终调用与FATFS相同的底层磁盘I/O接口来访问SD卡。这个架构清晰地将功能模块化耦合度低便于调试和维护。3. 硬件连接与底层驱动实现3.1 GD32与SD卡的SPI连接我们采用SPI模式驱动SD卡需要连接4根线不包括电源和地SD卡引脚CLK, CMD(MOSI), DAT0(MISO), CSGD32 SPI引脚SCK, MOSI, MISO, 和一个任意GPIO作为片选CS。以SPI1为例一种典型的连接方式如下SD卡引脚对应功能GD32引脚备注CLK时钟PA5 (SPI1_SCK)必须上拉CMD主机出从机入PA7 (SPI1_MOSI)上拉10K-100K电阻DAT0主机入从机出PA6 (SPI1_MISO)上拉CS片选PA4 (自定义GPIO)低电平有效初始为高注意SD卡在SPI模式下DAT1和DAT2引脚可以悬空。所有信号线最好串联一个22-33欧姆的小电阻用于阻抗匹配和抑制过冲。电源去耦电容100nF 10uF必须靠近SD卡座放置确保供电稳定。3.2 SPI驱动SD卡的初始化与读写SD卡在SPI模式下的初始化过程有严格的时序要求必须遵循SD协会的规范。流程大致如下上电延时SD卡上电后需要等待至少74个时钟周期约1ms的稳定时间期间保持CS为高、MOSI为高。进入SPI模式拉低CS发送CMD0 (GO_IDLE_STATE)命令参数为0x00000000CRC为0x95。此命令会让SD卡复位并进入SPI模式。检查电压范围发送CMD8 (SEND_IF_COND)用于验证主机电压是否在卡的支持范围内。V2版本的卡会回应。初始化流程循环发送CMD55 (APP_CMD) ACMD41 (SD_SEND_OP_COND)直到卡返回0x00表示初始化完成。这个过程可能持续数百毫秒。读取OCR寄存器发送CMD58 (READ_OCR)获取卡的操作条件寄存器可以判断卡是SDSC标准容量支持CMD8还是SDHC/SDXC高容量不支持CMD8。设置块长度对于标准容量卡需要发送CMD16 (SET_BLOCKLEN)将块长度设置为512字节。高容量卡固定为512字节此命令可选。关键点所有命令和响应都是通过SPI全双工通信完成的。发送命令包后需要持续读取SPI DR寄存器直到收到有效的响应起始位0x00。超时处理非常重要每个命令阶段都应设置合理的超时计数。扇区读写函数是连接FATFS的桥梁必须稳定可靠。disk_read(BYTE* buff, LBA_t sector, UINT count): 从SD卡的指定逻辑扇区sector开始读取count个扇区数据到buff。disk_write(const BYTE* buff, LBA_t sector, UINT count): 将buff中的数据写入SD卡的指定扇区。在SPI模式下单块读写使用CMD17 (READ_SINGLE_BLOCK)和CMD24 (WRITE_BLOCK)。多块读写有专用命令效率更高。写入时必须先发送CMD24然后是一个字节的起始令牌0xFE接着是512字节数据最后是2个字节的CRC在SPI模式下通常可以忽略填0xFF即可。写入后必须等待卡返回数据响应令牌并持续查询直到卡不再繁忙。实操心得SD卡SPI驱动调试时逻辑分析仪是神器。用它抓取SPI总线上的CMD、响应、数据令牌的波形与SD物理层规范文档对照任何时序或数据错误都无处遁形。另外GPIO模拟SPI虽然灵活但在高速读写时可能不稳定优先使用MCU的硬件SPI外设。3.3 USB Device的硬件与软件栈初始化GD32的USB外设需要连接DPPA12和DMPA11两根数据线到USB接口的对应引脚。USB接口需要提供稳定的5V电源并在DP线上通过一个1.5K欧姆电阻上拉到3.3V内置在GD32中通常通过配置上拉使能。软件上我们需要移植或使用GD32官方提供的USB Device库。核心工作是实现一个大容量存储设备MSC类。配置USB时钟USB模块需要48MHz的精确时钟。通常由PLL提供需要仔细配置系统时钟树确保USB时钟源准确。实现端点配置MSC类通常使用两个Bulk端点一个IN端点设备到主机和一个OUT端点主机到设备。端点缓冲区大小通常设置为64字节全速USB的最大包长。实现类特定请求MSC类通过Bulk-Only Transport (BOT)协议通信需要处理Get Max LUN和BOT Reset等类请求。实现SCSI命令集这是最核心的部分。USB主机发送的是封装在CBW命令块包装中的SCSI命令。我们需要解析这些命令并执行相应的操作。最关键的几个SCSI命令是TEST UNIT READY: 查询设备是否就绪。INQUIRY: 获取设备信息。READ CAPACITY: 获取存储设备容量总扇区数、扇区大小。READ(10): 读取扇区。WRITE(10): 写入扇区。REQUEST SENSE: 获取错误信息。当收到READ(10)命令时我们需要根据命令中的LBA地址和传输长度调用底层的disk_read函数读取SD卡数据然后通过USB IN端点发送给主机。WRITE(10)命令则相反从USB OUT端点接收数据调用disk_write写入SD卡。注意事项USB MSC的枚举过程对时序要求严格。在设备尚未枚举成功即电脑未识别出U盘前绝对不能进行SD卡的读写操作否则可能导致枚举失败。通常的做法是在USB配置描述符中报告一个“可移除”的存储设备并在TEST UNIT READY命令中根据SD卡是否初始化成功来返回“就绪”或“未就绪”状态。4. FATFS文件系统的移植与集成4.1 FATFS源码配置与裁剪从FatFs官网获取最新源码我们主要关心以下文件ff.c,ff.h: 文件系统模块本身。diskio.c,diskio.h: 底层磁盘I/O接口这是我们移植的重点。ffconf.h: 配置文件所有功能开关和参数都在这里。在ffconf.h中关键的配置项有_FS_TINY: 设置为1使用更小的缓冲区节省RAM。_USE_LFN: 长文件名支持。设置为2使用栈缓冲区或3使用堆缓冲区。启用会增加代码大小和RAM消耗。_CODE_PAGE: 代码页用于支持中文文件名。简体中文对应936。_USE_MKFS: 是否使能格式化功能。如果产品需要可以开启。_MAX_SS,_MIN_SS: 扇区大小。设置为512与SD卡一致。diskio.c中需要实现六个函数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); DWORD get_fattime (void); // 获取当前时间用于文件时间戳。其中disk_read和disk_write直接调用我们前面写好的SD卡扇区读写函数。disk_ioctl需要处理几个重要的控制命令特别是GET_SECTOR_COUNT获取总扇区数和GET_SECTOR_SIZE获取扇区大小这两个信息对于USB MSC报告设备容量至关重要。4.2 文件系统操作的核心API应用移植完成后就可以在应用层愉快地使用文件系统了。基本流程遵循“挂载-打开/创建-读写-关闭-卸载”。FATFS fs; // 文件系统对象 FIL file; // 文件对象 UINT bw; // 写入的字节数 // 1. 挂载SD卡 f_mount(fs, “0:”, 1); // “0:” 对应 diskio.c 中的 pdrv0 // 2. 打开文件如果不存在则创建 f_open(file, “0:/data.log”, FA_OPEN_ALWAYS | FA_WRITE); // 3. 移动指针到文件末尾追加写入 f_lseek(file, f_size(file)); // 4. 写入数据 char buffer[] “Hello, FATFS!\r\n”; f_write(file, buffer, strlen(buffer), bw); // 5. 关闭文件 f_close(file); // 6. 不再使用时卸载 f_mount(NULL, “0:”, 0);关键技巧频繁开关文件对于数据记录应用不要每次写入都f_open和f_close。这会导致FAT表被频繁回写既降低速度又增加SD卡磨损。正确的做法是上电后打开文件期间一直保持打开状态定期调用f_sync(file)将缓存数据强制写入物理介质断电前再安全关闭。缓冲区管理FATFS内部有缓存。通过合理配置ffconf.h中的_MAX_SS和缓存数量可以平衡性能和内存消耗。也可以使用更大的应用层缓冲区攒够多个扇区数据后一次性写入效率更高。错误处理每次文件操作后都应检查返回值FRESULT类型。常见的错误有FR_DISK_ERR底层磁盘错误、FR_NOT_READY磁盘未初始化、FR_NO_FILE文件未找到等。需要有相应的错误处理或重试机制。4.3 时间戳与长文件名支持要使生成的文件在电脑上显示正确的创建/修改时间需要实现get_fattime()函数。这个函数需要返回一个32位的时间戳格式遵循FAT文件系统标准。通常我们可以从RTC实时时钟获取或者如果设备联网可以从网络同步。DWORD get_fattime(void) { // 假设我们有获取时间的函数 get_rtc_time() // 格式: bit31:25 - 年(0-127) 相对于1980年, bit24:21 - 月(1-12), bit20:16 - 日(1-31) // bit15:11 - 时(0-23), bit10:5 - 分(0-59), bit4:0 - 秒/2 (0-29) uint32_t year, month, day, hour, min, sec; get_rtc_time(year, month, day, hour, min, sec); return ((year-1980) 25) | (month 21) | (day 16) | (hour 11) | (min 5) | (sec/2); }长文件名支持需要将_USE_LFN设置为2或3并添加相应的编码转换文件如cc936.c用于简体中文。这会显著增加代码体积可能增加几十KB的Flash占用需要根据项目资源情况权衡。5. 系统整合与任务调度策略5.1 数据记录、USB传输与文件系统的协同整个系统存在两个可能并行或冲突的任务后台数据记录和前台USB传输。它们共享同一个资源——SD卡及其上的FAT文件系统。因此互斥访问是必须考虑的核心问题。冲突场景设备正在通过USB向电脑传输一个数据文件同时应用层又需要向同一个文件追加写入新的传感器数据。如果不加控制FATFS的缓存、目录项、FAT表可能会被两个任务同时修改导致文件系统损坏。解决方案使用信号量Semaphore或互斥锁Mutex对FATFS的API调用进行保护。在RTOS环境下这很容易实现。在裸机环境下可以通过全局标志位和状态机来实现。一种简单的裸机策略是状态优先默认状态数据记录任务拥有SD卡访问权可以正常写文件。USB连接事件当检测到USB连接并成功枚举为MSC设备后设置一个usb_active标志。数据记录任务在每次尝试写SD卡前检查usb_active标志。如果为真则跳过本次写入将数据暂存在一个更大的循环缓冲区中。注意此时绝不能调用任何FATFS函数因为USB MSC正在底层直接操作磁盘扇区。USB断开事件USB断开后清除usb_active标志。数据记录任务检测到标志清除首先将循环缓冲区中积压的数据写入SD卡然后恢复正常记录。重要警告当USB MSC活动时FATFS的缓存内容可能与SD卡物理内容不一致。因此在USB连接前必须调用f_sync()确保所有缓存数据落盘并调用f_mount(NULL, …)卸载文件系统。在USB断开后再重新f_mount和f_open文件。这是最安全、最稳妥的做法。5.2 电源管理与数据安全对于数据记录设备突然断电导致文件系统损坏是致命问题。除了前面提到的定期f_sync还可以从硬件和软件层面增强安全性。硬件层面使用带有电源监测和写保护功能的SD卡座。在电源路径上设计大电容提供掉电后数十毫秒的维持时间让MCU有机会执行紧急关断流程。在检测到电压跌落通过MCU的ADC或专用电压监测芯片时立即触发中断在最短时间内完成f_sync和f_close。软件层面实现看门狗防止程序跑飞导致文件操作中断。采用原子操作思想先将数据写入一个临时文件如data.tmp写入完成并f_sync后再重命名为正式文件如data.log。这样即使写入过程断电也只会损失一个临时文件而不会破坏主日志文件。定期检查文件系统健康度可以在启动时使用f_mkfs如果使能修复轻微错误或者使用chkdsk工具在电脑端修复。5.3 性能优化与调试心得性能瓶颈分析SPI时钟频率提高SPI的时钟分频系数。GD32F103的SPI在72MHz系统时钟下理论上可以跑到36MHz主模式二分频。但受限于SD卡本身和PCB布线质量通常18MHz或9MHz是更稳定的选择。写入策略单扇区写入CMD24效率低。尽量使用多扇区写入命令CMD25。FATFS的f_write函数支持一次写入多个扇区只要在disk_write函数中实现多块写入即可。文件系统开销频繁写入小数据如每秒写几个字节会因簇分配和FAT表更新导致大量额外写入。最佳实践是在应用层进行缓冲攒够512字节甚至4KB8个扇区后再一次性写入。调试心得分阶段调试不要试图一次性集成所有功能。先调通SPI读写SD卡可以用简单的扇区读写测试程序验证。再单独移植FATFS实现创建文件、读写文件。最后再集成USB MSC。善用调试信息通过串口打印关键步骤的状态、返回值、错误代码。FATFS的FRESULT可以转换成字符串打印出来非常直观。电脑端工具使用WinHex或HxD这类磁盘编辑器可以直接查看SD卡的原始扇区数据对照FAT32文件系统结构分析目录项、FAT表是定位文件系统问题的终极手段。6. 常见问题排查与实战技巧在实际开发中你一定会遇到各种各样的问题。下面这个表格整理了一些典型故障现象、可能原因和排查思路问题现象可能原因排查思路与解决方案SD卡初始化失败1. 电源不稳或电流不足。2. SPI时序或相位(CPOL/CPHA)设置错误。3. 上电后等待时间不足。4. 卡本身损坏或格式不支持。1. 测量SD卡供电电压应在2.7-3.6V检查去耦电容。2. SD卡SPI模式要求CPOL0, CPHA0。用逻辑分析仪抓取CMD0波形确认。3. 发送至少74个时钟周期的全10xFF后再拉低CS。4. 换一张已知好的、已格式化为FAT32的SDHC卡32GB测试。可以初始化但读写扇区失败1. 读写命令或令牌格式错误。2. 读写超时时间设置太短。3. 多块读写未正确发送停止命令。1. 用逻辑分析仪对比读写命令波形与规范。2. 适当增加等待数据响应令牌和写操作完成的时间。3. 多块写结束时必须发送CMD12停止传输。FATFS挂载失败(FR_NO_FILESYSTEM)1. SD卡没有文件系统或不是FAT格式。2.disk_read函数读取的MBR或DBR扇区数据错误。3. 分区类型不对应为0x0B或0x0C。1. 在电脑上将SD卡格式化为FAT32。2. 调试disk_read确保能正确读取0扇区MBR。3. 使用磁盘编辑器查看0扇区确认分区表信息。能创建文件但电脑USB识别不到U盘1. USB硬件连接问题DP/DM接反、没接上拉。2. USB时钟不是精确的48MHz。3. USB描述符设备描述符、配置描述符等配置错误。4. MSC的SCSI命令响应不正确。1. 检查USB线、测量DP线电压应有约3.3V上拉。2. 用示波器测量USB时钟引脚PA8的MCO输出可配置为检查时钟。3. 使用USB协议分析仪如Beagle USB抓取枚举过程数据包这是最直接的调试方法。4. 确保READ CAPACITY等命令返回的数据格式和字节序正确。电脑识别到U盘但提示“需要格式化”1. USB MSC报告的设备容量扇区数、扇区大小与实际不符。2. 文件系统在USB活动期间被MCU意外写入导致结构损坏。3. 底层disk_read函数返回的数据有误。1. 检查disk_ioctl中GET_SECTOR_COUNT和GET_SECTOR_SIZE的实现确保与SD卡实际容量一致。2.确保USB活动时应用层已卸载文件系统且不再操作SD卡。3. 在USB MSC的READ(10)处理函数中对比读取的数据与通过disk_read直接读取的数据是否一致。USB传输文件速度极慢1. SPI时钟设置过低。2. 使用了单扇区读写命令。3. USB端点缓冲区大小设置不当或处理不及时。4. 文件碎片化严重。1. 在保证稳定的前提下提高SPI时钟频率。2. 实现并启用多扇区读写CMD17/18, CMD24/25。3. 确保USB中断优先级足够高及时处理端点数据。4. 定期在电脑上对SD卡进行碎片整理对于日志文件顺序写入一般不会碎片化。长时间运行后文件系统损坏1. 突然断电导致FAT表或目录项未更新。2. 多任务访问冲突。3. SD卡寿命到期闪存有擦写次数限制。1. 加强掉电保护机制增加钽电容实现掉电检测紧急保存。2. 严格进行资源互斥访问管理。3. 选择工业级或高耐久度的SD卡并在软件上做磨损均衡FATFS本身不提供可考虑定期更换文件存储位置。最后的实战技巧在项目初期可以先用一个简单的测试框架来验证每个环节。例如写一个循环每秒向SD卡的一个文件追加写入当前系统时间戳和一段测试数据。同时每隔一段时间就通过USB连接电脑查看文件内容是否正确并复制一个大文件进去再拷出来对比MD5校验和。这个简单的测试能暴露出稳定性、速度和数据一致性的大部分问题。把基础打牢后续增加复杂的应用逻辑就会顺利得多。
