尧图网站建设 
1. 整体设计为什么STM32F103C8T6 SPI模式成了经典组合手头正好有一块STM32F103C8T6最小系统板想给它加个SD卡做数据存储网上搜了一圈资料大多数教程要么停留在理论层面要么代码残缺不全照着敲完还是一堆报错。这篇就把我实际调通的完整过程拆开揉碎讲清楚从硬件接线到SPI时序再到FATFS文件系统接入全部走一遍。先回答一个很多新手纠结的问题STM32F103C8T6明明有SDIO外设为什么还要用SPI模式原因其实很实在。第一SDIO接口虽然速度快但引脚占用多且对PCB走线有要求而C8T6本身是48脚封装资源不算充裕第二SDIO驱动对时序要求更严格调试起来比SPI麻烦不少第三也是最关键的——很多场景下比如记录传感器日志、保存配置文件、存储字库SPI模式的速度已经绰绰有余了。SPI模式SD卡读写本质上就是把SD卡当成一个SPI从设备来操作。SD卡内部其实支持两套指令协议SD模式即SDIO和SPI模式。上电后默认进入SD模式需要主机发送特定的复位序列才能切换到SPI模式。这也是为什么初始化代码里有一长串CMD0、CMD8、CMD55、ACMD41的魔法操作——它们的作用就是敲门告诉SD卡我要用SPI跟你说话。这套方案适合谁我觉得主要三类人正在做STM32入门、想搞懂存储设备底层通信原理的学生或爱好者手头有C8T6最小系统板、想做数据记录仪或离线采集设备的工程师想低成本、不依赖SDIO外设实现文件存储的开发者。我用的硬件是常见的STM32F103C8T6最小系统板搭配一个淘宝几块钱的SPI SD卡模块带电平转换和稳压SD卡用的是一张32GB的MicroSD卡通过TF转SD卡套接入。下面进入正式环节。2. 硬件准备与接线看着简单翻车点其实都在细节里2.1 最小系统板与SD卡模块的选型思路STM32F103C8T6最小系统板是国产板子里存量最大、资料最多的一款蓝色Pill板是最常见的形态。它的核心是STM32F103C8T6芯片Cortex-M3内核64KB Flash20KB SRAM板载8MHz晶振和USB转串口芯片供电通过MicroUSB或排针输入。选购时我个人的建议是尽量选带独立LDOAMS1117-3.3且晶振焊接可靠的板子有些特别廉价的板子在低温或长时间运行下晶振起振不稳会导致SPI时钟异常这是第一个隐藏坑。SD卡模块方面市售的SPI SD卡模块基本都集成了3.3V稳压电路LDO或DC-DC用于对SD卡供电电平转换电路如74LVC4245或MOS管方案用于5V↔3.3V电平匹配很多人觉得模块自带3.3V输出就直接用模块的VCC给MCU供电这是个错误做法。模块的稳压芯片带载能力有限给SD卡供电已经捉襟见肘再给板子供电容易造成电压跌落导致SPI通信不稳定。正确做法是板子和模块分别独立供电共地即可。2.2 SPI引脚映射与完整接线表STM32F103C8T6的SPI1引脚在默认复用功能下映射如下功能引脚说明SPI1_SCKPA5时钟线SPI1_MISOPA6主机输入、从机输出SPI1_MOSIPA7主机输出、从机输入SPI1_CSPA4片选软件控制SD卡模块通常引出六个引脚CS、SCK、MOSI、MISO、VCC、GND。其中CS对应我们软件控制的片选脚PA4。等一等——这里有个细节很多人会忽略。SPI1的默认引脚在PA5/PA6/PA7但很多国产最小系统板把这几个引脚引出的排针位置稍有不同不同品牌的板子丝印可能稍有差异建议对照板子丝印和原理图确认。另外如果PA4被其他外设占用比如某些板子PA4接了一个LED或者按键一定要避开冲突或者改用其他GPIO模拟CS这在SPI软件片选方案里非常方便。接线顺序建议先接GND和VCC再接SCK和MOSI最后接MISO和CS。原因很简单——SPI从设备在未上电时MISO脚可能是高阻态或不确定状态如果先接MISO而上电顺序不对可能出现回灌电流损坏引脚。虽然实际中损坏概率不高但养成先共地、后信号的习惯总是好的。2.3 硬件设计的细节上拉电阻与去耦电容SD卡在SPI模式下SDI、SCK、CS这几个信号线最好都接上拉电阻10kΩ左右上拉到3.3V。原因在于SPI总线空闲时SCK和CS需要保持确定电平如果悬空噪声可能触发SD卡的误动作。很多SD卡模块板上已经带了上拉电阻但也有不带或只带上拉的检查一下模块原理图更稳妥。MISO线上不需要额外上拉。MISO是SD卡的输出它在SD卡未选中时是高阻态MCU的SPI外设输入引脚在空闲时可能读到不确定电平但因为我们只在自己选中SD卡并且发送命令后才采样MISO所以悬空时间段内即使读到乱码也无所谓。供电去耦在模块VCC和GND之间加一个10μF电解电容和一个100nF陶瓷电容靠近模块引脚摆放。这一步对SPI稳定性很有帮助——SD卡在写入数据时瞬时电流可达几十毫安如果供电线较细或者电源内阻大写入瞬间电压跌落会导致数据错乱。我实测过直接接USB供电线长度超过30cm时,写文件偶尔会出现卡死现象加了电容后消失。3. 代码架构一个能复用的三类文件体系3.1 标准库与HAL库的选型对比我使用的是标准外设库Standard Peripheral Library版本为3.5配合Keil MDK 5环境。为什么不选HAL库在C8T6这种Flash只有64KB的芯片上标准库生成的代码体积更小、执行效率更高对底层寄存器行为也更透明适合作为教学和理解SPI时序的基础。当然如果你更熟悉STM32CubeMXHAL库SPI初始化和数据收发部分需要做少量改写如HAL_SPI_Transmit()替代SPI_I2S_SendData()但SD卡通信逻辑本身跟SPI底层用的是HAL还是标准库没有关系核心代码完全可复用。工程结构上我建议这样组织目录Project/ ├── User/ # main.c、delay.c ├── BSP/ # bsp_spi.c、bsp_sd.c ├── FATFS/ # ff.c、ff.h、diskio.c └── Core/ # 启动文件、系统时钟配置核心思路是把底层SPI驱动、SD卡协议层、文件系统层分开上层只调用文件系统API比如f_open()、f_read()、f_write()完全不用关心SD卡底层的扇区操作。这套架构无论以后换成SPI Flash还是别的存储介质上层业务代码都不用动。3.2 SPI初始化主模式、8位数据、MSB先行SPI初始化是整个项目的地基配置不当后面全白搭。我的初始化配置如下void SPI1_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_SPI1, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_6; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_4; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_SetBits(GPIOA, GPIO_Pin_4); /* CS拉高默认不选中 */ SPI_InitStructure.SPI_Direction SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode SPI_Mode_Master; SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL SPI_CPOL_High; /* 空闲时SCK为高 */ SPI_InitStructure.SPI_CPHA SPI_CPHA_2Edge; /* 数据在第二个边沿采样 */ SPI_InitStructure.SPI_NSS SPI_NSS_Soft; /* 使用软件NSS */ SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_128; /* 初始低速 */ SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB; SPI_Init(SPI1, SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }几个关键点初始化时波特率分频设置为128SPI时钟只有约140kHz72MHz / 128。为什么一开始要这么慢因为SD卡在切换到SPI模式之前可能还停留在SD模式SD模式要求的初始化时钟不能超过400kHz超了可能不识别。等初始化完成后再逐步提高分频系数。SCK和MOSI配置为复用推挽输出MISO配置为浮空输入。这个不能搞反搞反了通信直接失败。CPOL和CPHA必须按SD卡SPI模式的要求配置。SD卡SPI协议规定的是Mode 0CPOL0, CPHA1Edge或Mode 3CPOL1, CPHA2Edge都可以但大多数参考实现用Mode 0我习惯用Mode 3也没问题。关键是后续配置要统一。等待我上面的初始化写的是SPI_CPOL_HighSPI_CPHA_2Edge也就是Mode 3。如果你抄了代码或者移植的时候想用Mode 0CPOLLow, CPHA1Edge逻辑也完全成立但不要中途切换。我实测Mode 0和Mode 3对SD卡来说都稳定真正影响稳定性的是时钟频率不要过高。3.3 SPI收发字节的核心函数与超时保护SPI收发一个字节的标准函数uint8_t SPI1_ReadWriteByte(uint8_t data) { uint16_t timeout 0xFFFF; while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET) { if (--timeout 0) return 0xFF; } SPI_I2S_SendData(SPI1, data); timeout 0xFFFF; while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_RXNE) RESET) { if (--timeout 0) return 0xFF; } return SPI_I2S_ReceiveData(SPI1); }这个函数看似简单但超时保护非常重要。想象一下如果SD卡没有插好、接触不良或者供电异常SPI总线上一片死寂发送缓冲区的TXE标志和接收缓冲区的RXNE标志可能永远不为1没有超时保护的话主循环就会死等表现为程序卡死。加了超时机制后即使设备异常也能在有限时间内返回一个错误值让我们有机会去处理。另一个细节在读取MISO的数据之前必须先发送一个字节任意值因为SPI是全双工协议主机要接收一个字节同时必须发送一个字节来产生时钟。所以读操作的代码通常是uint8_t dummy 0xFF; uint8_t val SPI1_ReadWriteByte(dummy); /* 发一个0xFF同时读回一个字节 */这个发0xFF读数据的习惯会贯穿整个SD卡驱动——包括后面发送命令时SD卡返回的应答也是这么读回来的。还有一个踩过的坑每次切换CS选中之前先发送至少74个时钟周期也就是至少10个字节的0xFF这是SD卡内部上电稳定和SPI模式切换所需的最小时钟数。这个细节很多教程不会写但不加的话偶尔会遇到第一张卡初始化失败、第二张卡却成功的玄学问题。4. 五步实操流程从空工程到文件读写全跑通4.1 第一步SPI底层通信验证在接入SD卡之前先把SPI通信本身测一遍。方法很简单把MISO和MOSI用杜邦线短接然后持续发送递增数据检查读回的数据是否一致。如果返回数据一致说明SPI外设基本工作正常如果数据乱码优先检查GPIO配置和硬件接线。uint8_t tx 0x00; uint8_t rx 0xFF; uint8_t ok 1; for (uint16_t i 0; i 1000; i) { tx (uint8_t)i; rx SPI1_ReadWriteByte(tx); if (rx ! tx) { ok 0; break; } } if (ok) printf(SPI loopback test PASS\r\n);这个测试花不了几分钟但能帮你把硬件问题和软件问题彻底分开。如果这一步都不通过后面SD卡初始化的各种诡异现象基本可以断定是SPI配置有误。实测中我看到过不少人在这一步卡住排查后发现是MISO接到MOSI上了。接线之前一定仔细核对引脚别相信眼睛用万用表量一下引脚编号对应的位置更靠谱。4.2 第二步SD卡初始化——发送74个时钟并切换SPI模式SD卡初始化的代码是整个项目里最容易出问题的地方。下面把这个过程拆开来解释。SD卡上电后处于SD模式在这种模式下它使用SD总线协议至少需要一个Nac周期的时钟信号才能完成内部上电初始化。如果直接发SPI命令SD卡可能不会响应。所以第一步是给74个以上的时钟脉冲通常实现方式是在CS为高片选无效时向SPI总线发送至少10个字节的0xFF因为每发送一个字节产生8个时钟脉冲10个字节就是80个时钟满足74个时钟的要求。uint8_t SD_SendCmd(uint8_t cmd, uint32_t arg, uint8_t crc) { uint8_t r1 0xFF; /* 发送命令前导字节 命令索引 参数(4字节) CRC */ SPI1_ReadWriteByte(0xFF); /* 传输前的起始字节给SD卡处理时间 */ SPI1_ReadWriteByte(0x40 | cmd); /* 最高位01表示这是主机命令后6位是命令号 */ SPI1_ReadWriteByte(arg 24); SPI1_ReadWriteByte(arg 16); SPI1_ReadWriteByte(arg 8); SPI1_ReadWriteByte(arg); if (crc ! 0xFF) SPI1_ReadWriteByte(crc); else SPI1_ReadWriteByte(0xFF); /* CRC可以不填充但CMD0和CMD8例外 */ /* 等待R1响应R1的最高位是0表示SD卡收到了命令 */ uint16_t timeout 0xFFFF; do { r1 SPI1_ReadWriteByte(0xFF); } while ((r1 0x80) (--timeout 0)); return r1; }代码里的细节0x40 | cmd的来历SD卡SPI命令帧格式是01起始位 6位命令索引 32位参数 7位CRC 1位停止位。而命令帧的第一个字节中bit7必须为0bit6必须为1所以固定用0x40作为起始字节的基数然后按位或上命令号。命令之间的响应时间SD卡处理命令需要时间所以循环里每读一次就发一个0xFF提供时钟直到R1响应的bit7变为0即收到有效应答。发送CMD0之前要CS拉低发送完ACMD41之后要检查SD卡是否退出IDLE状态这个逻辑在下面的初始化流程里。完整初始化流程如下uint8_t SD_Init(void) { uint8_t r1 0; uint16_t timeout 0; /* 1. 发送至少74个时钟周期 */ SPI_CS_HIGH(); for (int i 0; i 10; i) SPI1_ReadWriteByte(0xFF); /* 2. 发送CMD0进入SPI模式 */ SPI_CS_LOW(); r1 SD_SendCmd(0, 0, 0x95); /* CMD0的CRC是0x95 */ if (r1 ! 0x01) { printf(CMD0 error: 0x%02X\r\n, r1); return 1; } /* 3. 发送CMD8确认SD卡版本SD v2.0及以上 */ r1 SD_SendCmd(8, 0x000001AA, 0x87); if (r1 0x01) { /* 发送后要读4字节的数据即接口工作电压和校验码 */ uint8_t b1 SPI1_ReadWriteByte(0xFF); uint8_t b2 SPI1_ReadWriteByte(0xFF); uint8_t b3 SPI1_ReadWriteByte(0xFF); uint8_t b4 SPI1_ReadWriteByte(0xFF); if (b3 ! 0x01 || b4 ! 0xAA) return 2; } else if (r1 ! 0x01) { /* 非SD v2.0卡可能不支持CMD8 */ return 3; } /* 4. 循环发送ACMD41CMD55 CMD41直到SD卡退出IDLE状态 */ timeout 0xFFFF; do { r1 SD_SendCmd(55, 0, 0xFF); /* CMD55告诉卡下一条是应用指定命令 */ r1 SD_SendCmd(41, 0x40000000, 0xFF); /* ACMD41初始化卡0x40000000表示支持高容量卡 */ if (--timeout 0) { printf(ACMD41 timeout\r\n); return 4; } } while (r1 ! 0x00); /* 5. 读取OCR寄存器CMD58确认卡类型高容量/标准容量 */ r1 SD_SendCmd(58, 0, 0xFF); if (r1 0x00) { uint8_t ocr_b1 SPI1_ReadWriteByte(0xFF); uint8_t ocr_b2 SPI1_ReadWriteByte(0xFF); uint8_t ocr_b3 SPI1_ReadWriteByte(0xFF); uint8_t ocr_b4 SPI1_ReadWriteByte(0xFF); if (ocr_b1 0x40) /* CCS位为1 */ SD_Type SD_TYPE_V2HC; /* 高容量卡 */ else SD_Type SD_TYPE_V2; /* 标准容量卡 */ } /* 6. 提高SPI时钟频率加快后续读写速度 */ SPI1_SetSpeed(SPI_BaudRatePrescaler_8); /* SPI时钟约9MHz */ SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); /* 发送一个结束字节 */ return 0; }这里有个容易误解的地方CMD8的CRC校验字节不能填0xFF。因为CMD0和CMD8的CRC是SD卡协议强制要求的其他命令可以不校验CMD0的CRC固定是0x95CMD8的CRC是0x87。我见过有人图省事全部填0xFF导致初始化始终失败——这不算玄学而是协议要求的计算值。ACMD41中的参数0x40000000表示请求高容量支持HCS。标准容量卡会在OCR寄存器里把CCS位清零高容量卡会置位。读取OCRCMD58能帮我们判断扇区读写时用的是字节寻址标准容量还是块寻址高容量。不过对于大多数应用来说FATFS内部已经处理了这种差别我们只需要知道这个判断背后的意义不需要在业务代码里手动区分。4.3 第三步读取单扇区——理解CMD17与响应类型读扇区是最常用的操作毕竟写之前总得先读。SPI模式下读扇区使用CMD17参数是32位的扇区地址。对于高容量卡这个地址就是块地址每个块512字节对于标准容量卡这个地址是字节地址所以要先乘以512。uint8_t SD_ReadSector(uint32_t sector, uint8_t *buffer) { uint8_t r1 0; SPI_CS_LOW(); if (SD_Type SD_TYPE_V2HC) r1 SD_SendCmd(17, sector, 0xFF); else r1 SD_SendCmd(17, sector 9, 0xFF); /* 标准容量卡字节地址 扇区号 * 512 */ if (r1 ! 0x00) { SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 1; } /* 等待数据起始标志0xFE */ uint16_t timeout 0xFFFF; uint8_t token 0xFF; do { token SPI1_ReadWriteByte(0xFF); } while (token 0xFF (--timeout 0)); if (token ! 0xFE) /* 期待0xFE如果不是则数据读取错误 */ { SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 2; } /* 读取512字节数据 */ for (uint16_t i 0; i 512; i) buffer[i] SPI1_ReadWriteByte(0xFF); /* 读取2字节CRCSPI模式下不校验但需要跳过 */ SPI1_ReadWriteByte(0xFF); SPI1_ReadWriteByte(0xFF); SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 0; }读扇区操作里等待数据起始标志0xFE是一个容易被忽视但很重要的环节。SD卡在收到CMD17后需要时间去内部搬运数据到缓冲区这个时间可能长达几十毫秒。在等待期间SD卡会持续在MISO线上输出0xFF高电平直到数据准备好才会输出0xFE作为数据起始令牌紧接着就是512字节的数据内容。许多在论坛上问为什么读扇区卡死的人八成是死在了这个等待循环里。原因可能是SPI时钟频率太高导致SD卡跟不上或者供电不稳导致SD卡内部操作超时。解决办法是降低SPI速度或者把超时时间加大同时在每个等待周期内发送0xFF以维持时钟。4.4 第四步写入单扇区——CMD24与写令牌0xFE写操作比读操作稍微复杂一点因为涉及忙检测。写入一个扇区的流程是发送CMD24 - SD卡返回R1响应0x00 - 发送写数据起始令牌0xFE - 发送512字节数据 - 发送2字节CRC - 等待SD卡忙结束MISO拉低再拉高。uint8_t SD_WriteSector(uint32_t sector, const uint8_t *buffer) { uint8_t r1 0; SPI_CS_LOW(); if (SD_Type SD_TYPE_V2HC) r1 SD_SendCmd(24, sector, 0xFF); else r1 SD_SendCmd(24, sector 9, 0xFF); if (r1 ! 0x00) { SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 1; } /* 发送写数据起始令牌0xFE */ SPI1_ReadWriteByte(0xFE); /* 发送512字节数据 */ for (uint16_t i 0; i 512; i) SPI1_ReadWriteByte(buffer[i]); /* 发送2字节CRCSPI模式下不校验 */ SPI1_ReadWriteByte(0xFF); SPI1_ReadWriteByte(0xFF); /* 等待SD卡忙结束SD卡在写数据时会拉低MISO写完释放拉高 */ uint16_t timeout 0xFFFF; uint8_t busy 0x00; do { busy SPI1_ReadWriteByte(0xFF); } while ((busy 0x00) (--timeout 0)); if (timeout 0) { printf(Write busy timeout\r\n); SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 2; } SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 0; }写数据成功后SD卡会进入忙状态把MISO线拉低这个时间可能长达几百毫秒取决于卡的写入速度和擦除策略FATFS修改文件时通常先擦除整块再写。我们的代码必须等待MISO重新变为高电平才能继续操作下一个扇区。如果不等待或等待时间不够紧接着写下一个扇区时SD卡会因为还在忙而拒绝命令返回错误应答。个人经验32GB的普通卡Class 10级别一个扇区写入完成大约需要10~30ms如果卡内碎片很多或者接近满盘这个时间可能翻倍。所以等待超时时间建议设置在100ms以上别写得太死。另外如果频繁写文件导致卡消失大概率是电源问题——写入瞬间的电流尖峰把稳压器拉垮了。4.5 第五步接入FATFS文件系统——打通最后一步裸的扇区读写当然能工作但以文件的形式组织数据才是真正的实用方式。FATFSFatFs是一个开源的FAT文件系统模块移植到STM32只需要提供6个底层接口函数。需要在diskio.c中实现的核心函数DSTATUS disk_initialize(BYTE pdrv) { /* 初始化底层SPI和SD卡 */ if (SD_Init() 0) return RES_OK; return STA_NOINIT; } DRESULT disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count) { while (count--) { if (SD_ReadSector(sector, buff) ! 0) return RES_ERROR; buff 512; } return RES_OK; } DRESULT disk_write(BYTE pdrv, const BYTE *buff, LBA_t sector, UINT count) { while (count--) { if (SD_WriteSector(sector, buff) ! 0) return RES_ERROR; buff 512; } return RES_OK; } DRESULT disk_ioctl(BYTE pdrv, BYTE cmd, void *buff) { switch (cmd) { case GET_SECTOR_COUNT: *(LBA_t*)buff 64 * 1024 * 1024 / 512; /* 按卡容量填写这里示例为64MB */ return RES_OK; case GET_SECTOR_SIZE: *(WORD*)buff 512; return RES_OK; case GET_BLOCK_SIZE: *(DWORD*)buff 1; return RES_OK; default: return RES_PARERR; } }FATFS的配置在ffconf.h中需要注意几个选项FF_USE_MKFS设为1这样可以在STM32上直接格式化SD卡FF_USE_STRFUNC设为1支持printf格式化的f_printf()函数方便输出日志FF_VOLUMES设为1只使用一个逻辑盘。在主函数中就可以这样操作FATFS fs; FIL file; FRESULT res; f_mount(fs, , 1); /* 挂载文件系统 */ /* 写文件示例 */ res f_open(file, test.txt, FA_CREATE_ALWAYS | FA_WRITE); if (res FR_OK) { f_printf(file, Hello SD Card! sector%lu\r\n, 1234); f_close(file); } /* 读文件示例 */ char buf[64]; res f_open(file, test.txt, FA_READ); if (res FR_OK) { UINT br 0; f_read(file, buf, sizeof(buf), br); buf[br] \0; printf(Read: %s\r\n, buf); f_close(file); } f_mount(NULL, , 0); /* 卸载文件系统 */接入FATFS后写日志、存配置、生成CSV数据文件都变成常规操作项目可维护性一下子就上来了。我还试着在 while 循环里每秒钟采一个模拟量、写入data.csv连续跑了一个多小时文件大小和内容都正常稳定性让人放心。5. 排查实录与避坑经验遇到这些问题别慌5.1 初始化失败是最大的翻车现场把最常见的几个初始化错误现象和排查路径整理成表格方便速查现象可能原因排查与解决方法CMD0返回0xFFSPI接线错误、CS极性不对、74时钟不足检查MISO/MOSI是否接反检查CS是否为低电平选中上电前多发送几个0xFFCMD0返回0x05或0x07时钟频率过高、供电电压不稳把SPI分频系数降到128检查模块供电是否在3.3V换一根短杜邦线CMD8无法通过SD卡是SD v1.x或MMC卡不要用支持v2.0的初始化流程直接尝试ACMD41循环ACMD41一直超时卡没插好、卡座接触不良重新插拔SD卡观察模块电源指示灯换一张卡交叉验证每次上电行为不一致SPI模式切换时序不完整确认初始化前CS为高电平时已发送至少80个时钟我踩过的一个印象很深的坑是用某宝买的含电平转换模块直接把模块输出接到STM32的PA6MISO发现MISO电平一直是3.3V高电平CMD0一直接不到有效响应。后来拿来万用表一量发现模块上根本没有电平转换芯片只是简单直连MISO的电压被上拉到了5V把PA6灌坏了好在GPIO耐压过得去换了个引脚就好了。所以买模块时看清楚原理图如果只有4个引脚VCC/GND/CLK/DAT通常就没有电平转换只能用于3.3V单片机。5.2 读出来的数据是0xFF或者全0读扇区返回的buffer全是0xFF说明SD卡没把有效数据推到MISO线上大概率是 等待数据起始标志0xFE 这一步超时了。与此同时写入全0常见原因是写数据后没等待忙结束或者写地址算错导致写到了不存在的区域。排查思路先用读命令检查SD卡的OCR返回和CSD寄存器确认地址计算方式是否正确读扇区操作前确认CS已经被拉低读取整个扇区结束后再把CS拉高试试用低速分频128读排除时钟太快导致的信号失真。如果手边有逻辑分析仪直接抓SPI波形看数据是最简单直观的排查方式。我习惯用几十块钱的8通道逻辑分析仪usb接电脑就能看波形配合pulseview软件一眼就能看出协议层是哪里不对。5.3 文件系统无法挂载或格式化失败f_mount返回FR_NO_FILESYSTEM说明SD卡上没有有效的FAT文件系统。这时候可以用f_mkfs把卡格式化成FAT在代码里调用f_mkfs(, FM_FAT, 0, work_buf, sizeof(work_buf))。如果f_mkfs报FR_MKFS_ABORTED检查disk_ioctl里返回的扇区数和扇区大小是否正确或者换一张卡在电脑上格式化为FAT32再试。有个不易察觉的问题FATFS默认配置里逻辑扇区大小FF_MIN_SS和FF_MAX_SS两者默认都是512如果SD卡的物理扇区是4096字节部分新卡就不能直接用。好在市售主流MicroSD卡在SPI模式下基本都以512字节扇区模式工作遇到格式化失败时留意一下SD卡的规格型号。5.4 关于速度别再纠结SPI太慢SPI模式SD卡的理论速度上限大约是12.5Mbit/s在24MHz SPI时钟下每字节8位就得8个时钟周期实际稳定速度一般在几百KB/s量级。如果你的数据记录速率需求在100KB/s以内SPI模式完全没问题。如果需求更大那就安心去调SDIO加DMA。实际使用中写一段10KB的日志文件从f_write到f_close完成大约耗时100ms左右里面有相当一部分消耗在FATFS的目录区和FAT表更新上。如果对这部分延迟敏感可以考虑用f_sync替代频繁关闭文件写完后不关闭定期同步增大FF_MAX_SS以支持多扇区连续写使用f_lseek定位写避免频繁更新FAT项。不过这些都是优化层面的功夫先把基础读写跑通才是正途。6. 一些实操心得和扩展方向总结一下我踩过的坑和沉淀下来的实操习惯第一SD卡模块和STM32板子之间如果不是紧挨着尽量降低SPI时钟频率不要为了纸面性能去冒险。9MHz的SPI时钟配合杜邦线长度超过10cm波形开始出现明显的振铃和过冲读写偶发错误率明显上升。再往上调高之前先考虑用示波器或逻辑分析仪确认波形质量。第二所有SPI发送函数里都要带超时机制这不仅是给SD卡异常留退路更是给整个系统留后路。我最初写的SD卡驱动没有超时保护一次写测试中SD卡接触不良结果整个控制系统的while循环卡死在SPI等待中连看门狗都救不回来。那之后所有阻塞型通信函数全部加超时。第三工程中强烈建议把SPI底层驱动、SD卡协议层、FATFS文件系统这四层分开API层应用调用、FF层FATFS模块、DIO层SD卡协议、LINK层SPI硬件驱动。调试哪一层出问题就单测哪一层定位问题的速度会快很多。这个项目做完后我又顺手用同样的底层驱动接了一个SPI FlashW25Q64只需要少量改动主要是命令集不同上层FATFS代码一行没改就实现了换个存储介质照样跑文件系统的效果。这就是分层设计的价值。如果你手头的C8T6最小系统板还闲着找一张旧SD卡按这篇文章的步骤走一遍相信很快就能跑通文件读写。后面如果想继续做数据记录仪、传感器日志器、字库读取或者离线固件升级这套方案都能作为基础设施直接复用。 STM32F103C8T6 SPI驱动SD卡与FATFS文件系统实现详解
1. 整体设计为什么STM32F103C8T6 SPI模式成了经典组合手头正好有一块STM32F103C8T6最小系统板想给它加个SD卡做数据存储网上搜了一圈资料大多数教程要么停留在理论层面要么代码残缺不全照着敲完还是一堆报错。这篇就把我实际调通的完整过程拆开揉碎讲清楚从硬件接线到SPI时序再到FATFS文件系统接入全部走一遍。先回答一个很多新手纠结的问题STM32F103C8T6明明有SDIO外设为什么还要用SPI模式原因其实很实在。第一SDIO接口虽然速度快但引脚占用多且对PCB走线有要求而C8T6本身是48脚封装资源不算充裕第二SDIO驱动对时序要求更严格调试起来比SPI麻烦不少第三也是最关键的——很多场景下比如记录传感器日志、保存配置文件、存储字库SPI模式的速度已经绰绰有余了。SPI模式SD卡读写本质上就是把SD卡当成一个SPI从设备来操作。SD卡内部其实支持两套指令协议SD模式即SDIO和SPI模式。上电后默认进入SD模式需要主机发送特定的复位序列才能切换到SPI模式。这也是为什么初始化代码里有一长串CMD0、CMD8、CMD55、ACMD41的魔法操作——它们的作用就是敲门告诉SD卡我要用SPI跟你说话。这套方案适合谁我觉得主要三类人正在做STM32入门、想搞懂存储设备底层通信原理的学生或爱好者手头有C8T6最小系统板、想做数据记录仪或离线采集设备的工程师想低成本、不依赖SDIO外设实现文件存储的开发者。我用的硬件是常见的STM32F103C8T6最小系统板搭配一个淘宝几块钱的SPI SD卡模块带电平转换和稳压SD卡用的是一张32GB的MicroSD卡通过TF转SD卡套接入。下面进入正式环节。2. 硬件准备与接线看着简单翻车点其实都在细节里2.1 最小系统板与SD卡模块的选型思路STM32F103C8T6最小系统板是国产板子里存量最大、资料最多的一款蓝色Pill板是最常见的形态。它的核心是STM32F103C8T6芯片Cortex-M3内核64KB Flash20KB SRAM板载8MHz晶振和USB转串口芯片供电通过MicroUSB或排针输入。选购时我个人的建议是尽量选带独立LDOAMS1117-3.3且晶振焊接可靠的板子有些特别廉价的板子在低温或长时间运行下晶振起振不稳会导致SPI时钟异常这是第一个隐藏坑。SD卡模块方面市售的SPI SD卡模块基本都集成了3.3V稳压电路LDO或DC-DC用于对SD卡供电电平转换电路如74LVC4245或MOS管方案用于5V↔3.3V电平匹配很多人觉得模块自带3.3V输出就直接用模块的VCC给MCU供电这是个错误做法。模块的稳压芯片带载能力有限给SD卡供电已经捉襟见肘再给板子供电容易造成电压跌落导致SPI通信不稳定。正确做法是板子和模块分别独立供电共地即可。2.2 SPI引脚映射与完整接线表STM32F103C8T6的SPI1引脚在默认复用功能下映射如下功能引脚说明SPI1_SCKPA5时钟线SPI1_MISOPA6主机输入、从机输出SPI1_MOSIPA7主机输出、从机输入SPI1_CSPA4片选软件控制SD卡模块通常引出六个引脚CS、SCK、MOSI、MISO、VCC、GND。其中CS对应我们软件控制的片选脚PA4。等一等——这里有个细节很多人会忽略。SPI1的默认引脚在PA5/PA6/PA7但很多国产最小系统板把这几个引脚引出的排针位置稍有不同不同品牌的板子丝印可能稍有差异建议对照板子丝印和原理图确认。另外如果PA4被其他外设占用比如某些板子PA4接了一个LED或者按键一定要避开冲突或者改用其他GPIO模拟CS这在SPI软件片选方案里非常方便。接线顺序建议先接GND和VCC再接SCK和MOSI最后接MISO和CS。原因很简单——SPI从设备在未上电时MISO脚可能是高阻态或不确定状态如果先接MISO而上电顺序不对可能出现回灌电流损坏引脚。虽然实际中损坏概率不高但养成先共地、后信号的习惯总是好的。2.3 硬件设计的细节上拉电阻与去耦电容SD卡在SPI模式下SDI、SCK、CS这几个信号线最好都接上拉电阻10kΩ左右上拉到3.3V。原因在于SPI总线空闲时SCK和CS需要保持确定电平如果悬空噪声可能触发SD卡的误动作。很多SD卡模块板上已经带了上拉电阻但也有不带或只带上拉的检查一下模块原理图更稳妥。MISO线上不需要额外上拉。MISO是SD卡的输出它在SD卡未选中时是高阻态MCU的SPI外设输入引脚在空闲时可能读到不确定电平但因为我们只在自己选中SD卡并且发送命令后才采样MISO所以悬空时间段内即使读到乱码也无所谓。供电去耦在模块VCC和GND之间加一个10μF电解电容和一个100nF陶瓷电容靠近模块引脚摆放。这一步对SPI稳定性很有帮助——SD卡在写入数据时瞬时电流可达几十毫安如果供电线较细或者电源内阻大写入瞬间电压跌落会导致数据错乱。我实测过直接接USB供电线长度超过30cm时,写文件偶尔会出现卡死现象加了电容后消失。3. 代码架构一个能复用的三类文件体系3.1 标准库与HAL库的选型对比我使用的是标准外设库Standard Peripheral Library版本为3.5配合Keil MDK 5环境。为什么不选HAL库在C8T6这种Flash只有64KB的芯片上标准库生成的代码体积更小、执行效率更高对底层寄存器行为也更透明适合作为教学和理解SPI时序的基础。当然如果你更熟悉STM32CubeMXHAL库SPI初始化和数据收发部分需要做少量改写如HAL_SPI_Transmit()替代SPI_I2S_SendData()但SD卡通信逻辑本身跟SPI底层用的是HAL还是标准库没有关系核心代码完全可复用。工程结构上我建议这样组织目录Project/ ├── User/ # main.c、delay.c ├── BSP/ # bsp_spi.c、bsp_sd.c ├── FATFS/ # ff.c、ff.h、diskio.c └── Core/ # 启动文件、系统时钟配置核心思路是把底层SPI驱动、SD卡协议层、文件系统层分开上层只调用文件系统API比如f_open()、f_read()、f_write()完全不用关心SD卡底层的扇区操作。这套架构无论以后换成SPI Flash还是别的存储介质上层业务代码都不用动。3.2 SPI初始化主模式、8位数据、MSB先行SPI初始化是整个项目的地基配置不当后面全白搭。我的初始化配置如下void SPI1_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_SPI1, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_6; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_4; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_SetBits(GPIOA, GPIO_Pin_4); /* CS拉高默认不选中 */ SPI_InitStructure.SPI_Direction SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode SPI_Mode_Master; SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL SPI_CPOL_High; /* 空闲时SCK为高 */ SPI_InitStructure.SPI_CPHA SPI_CPHA_2Edge; /* 数据在第二个边沿采样 */ SPI_InitStructure.SPI_NSS SPI_NSS_Soft; /* 使用软件NSS */ SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_128; /* 初始低速 */ SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB; SPI_Init(SPI1, SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }几个关键点初始化时波特率分频设置为128SPI时钟只有约140kHz72MHz / 128。为什么一开始要这么慢因为SD卡在切换到SPI模式之前可能还停留在SD模式SD模式要求的初始化时钟不能超过400kHz超了可能不识别。等初始化完成后再逐步提高分频系数。SCK和MOSI配置为复用推挽输出MISO配置为浮空输入。这个不能搞反搞反了通信直接失败。CPOL和CPHA必须按SD卡SPI模式的要求配置。SD卡SPI协议规定的是Mode 0CPOL0, CPHA1Edge或Mode 3CPOL1, CPHA2Edge都可以但大多数参考实现用Mode 0我习惯用Mode 3也没问题。关键是后续配置要统一。等待我上面的初始化写的是SPI_CPOL_HighSPI_CPHA_2Edge也就是Mode 3。如果你抄了代码或者移植的时候想用Mode 0CPOLLow, CPHA1Edge逻辑也完全成立但不要中途切换。我实测Mode 0和Mode 3对SD卡来说都稳定真正影响稳定性的是时钟频率不要过高。3.3 SPI收发字节的核心函数与超时保护SPI收发一个字节的标准函数uint8_t SPI1_ReadWriteByte(uint8_t data) { uint16_t timeout 0xFFFF; while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET) { if (--timeout 0) return 0xFF; } SPI_I2S_SendData(SPI1, data); timeout 0xFFFF; while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_RXNE) RESET) { if (--timeout 0) return 0xFF; } return SPI_I2S_ReceiveData(SPI1); }这个函数看似简单但超时保护非常重要。想象一下如果SD卡没有插好、接触不良或者供电异常SPI总线上一片死寂发送缓冲区的TXE标志和接收缓冲区的RXNE标志可能永远不为1没有超时保护的话主循环就会死等表现为程序卡死。加了超时机制后即使设备异常也能在有限时间内返回一个错误值让我们有机会去处理。另一个细节在读取MISO的数据之前必须先发送一个字节任意值因为SPI是全双工协议主机要接收一个字节同时必须发送一个字节来产生时钟。所以读操作的代码通常是uint8_t dummy 0xFF; uint8_t val SPI1_ReadWriteByte(dummy); /* 发一个0xFF同时读回一个字节 */这个发0xFF读数据的习惯会贯穿整个SD卡驱动——包括后面发送命令时SD卡返回的应答也是这么读回来的。还有一个踩过的坑每次切换CS选中之前先发送至少74个时钟周期也就是至少10个字节的0xFF这是SD卡内部上电稳定和SPI模式切换所需的最小时钟数。这个细节很多教程不会写但不加的话偶尔会遇到第一张卡初始化失败、第二张卡却成功的玄学问题。4. 五步实操流程从空工程到文件读写全跑通4.1 第一步SPI底层通信验证在接入SD卡之前先把SPI通信本身测一遍。方法很简单把MISO和MOSI用杜邦线短接然后持续发送递增数据检查读回的数据是否一致。如果返回数据一致说明SPI外设基本工作正常如果数据乱码优先检查GPIO配置和硬件接线。uint8_t tx 0x00; uint8_t rx 0xFF; uint8_t ok 1; for (uint16_t i 0; i 1000; i) { tx (uint8_t)i; rx SPI1_ReadWriteByte(tx); if (rx ! tx) { ok 0; break; } } if (ok) printf(SPI loopback test PASS\r\n);这个测试花不了几分钟但能帮你把硬件问题和软件问题彻底分开。如果这一步都不通过后面SD卡初始化的各种诡异现象基本可以断定是SPI配置有误。实测中我看到过不少人在这一步卡住排查后发现是MISO接到MOSI上了。接线之前一定仔细核对引脚别相信眼睛用万用表量一下引脚编号对应的位置更靠谱。4.2 第二步SD卡初始化——发送74个时钟并切换SPI模式SD卡初始化的代码是整个项目里最容易出问题的地方。下面把这个过程拆开来解释。SD卡上电后处于SD模式在这种模式下它使用SD总线协议至少需要一个Nac周期的时钟信号才能完成内部上电初始化。如果直接发SPI命令SD卡可能不会响应。所以第一步是给74个以上的时钟脉冲通常实现方式是在CS为高片选无效时向SPI总线发送至少10个字节的0xFF因为每发送一个字节产生8个时钟脉冲10个字节就是80个时钟满足74个时钟的要求。uint8_t SD_SendCmd(uint8_t cmd, uint32_t arg, uint8_t crc) { uint8_t r1 0xFF; /* 发送命令前导字节 命令索引 参数(4字节) CRC */ SPI1_ReadWriteByte(0xFF); /* 传输前的起始字节给SD卡处理时间 */ SPI1_ReadWriteByte(0x40 | cmd); /* 最高位01表示这是主机命令后6位是命令号 */ SPI1_ReadWriteByte(arg 24); SPI1_ReadWriteByte(arg 16); SPI1_ReadWriteByte(arg 8); SPI1_ReadWriteByte(arg); if (crc ! 0xFF) SPI1_ReadWriteByte(crc); else SPI1_ReadWriteByte(0xFF); /* CRC可以不填充但CMD0和CMD8例外 */ /* 等待R1响应R1的最高位是0表示SD卡收到了命令 */ uint16_t timeout 0xFFFF; do { r1 SPI1_ReadWriteByte(0xFF); } while ((r1 0x80) (--timeout 0)); return r1; }代码里的细节0x40 | cmd的来历SD卡SPI命令帧格式是01起始位 6位命令索引 32位参数 7位CRC 1位停止位。而命令帧的第一个字节中bit7必须为0bit6必须为1所以固定用0x40作为起始字节的基数然后按位或上命令号。命令之间的响应时间SD卡处理命令需要时间所以循环里每读一次就发一个0xFF提供时钟直到R1响应的bit7变为0即收到有效应答。发送CMD0之前要CS拉低发送完ACMD41之后要检查SD卡是否退出IDLE状态这个逻辑在下面的初始化流程里。完整初始化流程如下uint8_t SD_Init(void) { uint8_t r1 0; uint16_t timeout 0; /* 1. 发送至少74个时钟周期 */ SPI_CS_HIGH(); for (int i 0; i 10; i) SPI1_ReadWriteByte(0xFF); /* 2. 发送CMD0进入SPI模式 */ SPI_CS_LOW(); r1 SD_SendCmd(0, 0, 0x95); /* CMD0的CRC是0x95 */ if (r1 ! 0x01) { printf(CMD0 error: 0x%02X\r\n, r1); return 1; } /* 3. 发送CMD8确认SD卡版本SD v2.0及以上 */ r1 SD_SendCmd(8, 0x000001AA, 0x87); if (r1 0x01) { /* 发送后要读4字节的数据即接口工作电压和校验码 */ uint8_t b1 SPI1_ReadWriteByte(0xFF); uint8_t b2 SPI1_ReadWriteByte(0xFF); uint8_t b3 SPI1_ReadWriteByte(0xFF); uint8_t b4 SPI1_ReadWriteByte(0xFF); if (b3 ! 0x01 || b4 ! 0xAA) return 2; } else if (r1 ! 0x01) { /* 非SD v2.0卡可能不支持CMD8 */ return 3; } /* 4. 循环发送ACMD41CMD55 CMD41直到SD卡退出IDLE状态 */ timeout 0xFFFF; do { r1 SD_SendCmd(55, 0, 0xFF); /* CMD55告诉卡下一条是应用指定命令 */ r1 SD_SendCmd(41, 0x40000000, 0xFF); /* ACMD41初始化卡0x40000000表示支持高容量卡 */ if (--timeout 0) { printf(ACMD41 timeout\r\n); return 4; } } while (r1 ! 0x00); /* 5. 读取OCR寄存器CMD58确认卡类型高容量/标准容量 */ r1 SD_SendCmd(58, 0, 0xFF); if (r1 0x00) { uint8_t ocr_b1 SPI1_ReadWriteByte(0xFF); uint8_t ocr_b2 SPI1_ReadWriteByte(0xFF); uint8_t ocr_b3 SPI1_ReadWriteByte(0xFF); uint8_t ocr_b4 SPI1_ReadWriteByte(0xFF); if (ocr_b1 0x40) /* CCS位为1 */ SD_Type SD_TYPE_V2HC; /* 高容量卡 */ else SD_Type SD_TYPE_V2; /* 标准容量卡 */ } /* 6. 提高SPI时钟频率加快后续读写速度 */ SPI1_SetSpeed(SPI_BaudRatePrescaler_8); /* SPI时钟约9MHz */ SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); /* 发送一个结束字节 */ return 0; }这里有个容易误解的地方CMD8的CRC校验字节不能填0xFF。因为CMD0和CMD8的CRC是SD卡协议强制要求的其他命令可以不校验CMD0的CRC固定是0x95CMD8的CRC是0x87。我见过有人图省事全部填0xFF导致初始化始终失败——这不算玄学而是协议要求的计算值。ACMD41中的参数0x40000000表示请求高容量支持HCS。标准容量卡会在OCR寄存器里把CCS位清零高容量卡会置位。读取OCRCMD58能帮我们判断扇区读写时用的是字节寻址标准容量还是块寻址高容量。不过对于大多数应用来说FATFS内部已经处理了这种差别我们只需要知道这个判断背后的意义不需要在业务代码里手动区分。4.3 第三步读取单扇区——理解CMD17与响应类型读扇区是最常用的操作毕竟写之前总得先读。SPI模式下读扇区使用CMD17参数是32位的扇区地址。对于高容量卡这个地址就是块地址每个块512字节对于标准容量卡这个地址是字节地址所以要先乘以512。uint8_t SD_ReadSector(uint32_t sector, uint8_t *buffer) { uint8_t r1 0; SPI_CS_LOW(); if (SD_Type SD_TYPE_V2HC) r1 SD_SendCmd(17, sector, 0xFF); else r1 SD_SendCmd(17, sector 9, 0xFF); /* 标准容量卡字节地址 扇区号 * 512 */ if (r1 ! 0x00) { SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 1; } /* 等待数据起始标志0xFE */ uint16_t timeout 0xFFFF; uint8_t token 0xFF; do { token SPI1_ReadWriteByte(0xFF); } while (token 0xFF (--timeout 0)); if (token ! 0xFE) /* 期待0xFE如果不是则数据读取错误 */ { SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 2; } /* 读取512字节数据 */ for (uint16_t i 0; i 512; i) buffer[i] SPI1_ReadWriteByte(0xFF); /* 读取2字节CRCSPI模式下不校验但需要跳过 */ SPI1_ReadWriteByte(0xFF); SPI1_ReadWriteByte(0xFF); SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 0; }读扇区操作里等待数据起始标志0xFE是一个容易被忽视但很重要的环节。SD卡在收到CMD17后需要时间去内部搬运数据到缓冲区这个时间可能长达几十毫秒。在等待期间SD卡会持续在MISO线上输出0xFF高电平直到数据准备好才会输出0xFE作为数据起始令牌紧接着就是512字节的数据内容。许多在论坛上问为什么读扇区卡死的人八成是死在了这个等待循环里。原因可能是SPI时钟频率太高导致SD卡跟不上或者供电不稳导致SD卡内部操作超时。解决办法是降低SPI速度或者把超时时间加大同时在每个等待周期内发送0xFF以维持时钟。4.4 第四步写入单扇区——CMD24与写令牌0xFE写操作比读操作稍微复杂一点因为涉及忙检测。写入一个扇区的流程是发送CMD24 - SD卡返回R1响应0x00 - 发送写数据起始令牌0xFE - 发送512字节数据 - 发送2字节CRC - 等待SD卡忙结束MISO拉低再拉高。uint8_t SD_WriteSector(uint32_t sector, const uint8_t *buffer) { uint8_t r1 0; SPI_CS_LOW(); if (SD_Type SD_TYPE_V2HC) r1 SD_SendCmd(24, sector, 0xFF); else r1 SD_SendCmd(24, sector 9, 0xFF); if (r1 ! 0x00) { SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 1; } /* 发送写数据起始令牌0xFE */ SPI1_ReadWriteByte(0xFE); /* 发送512字节数据 */ for (uint16_t i 0; i 512; i) SPI1_ReadWriteByte(buffer[i]); /* 发送2字节CRCSPI模式下不校验 */ SPI1_ReadWriteByte(0xFF); SPI1_ReadWriteByte(0xFF); /* 等待SD卡忙结束SD卡在写数据时会拉低MISO写完释放拉高 */ uint16_t timeout 0xFFFF; uint8_t busy 0x00; do { busy SPI1_ReadWriteByte(0xFF); } while ((busy 0x00) (--timeout 0)); if (timeout 0) { printf(Write busy timeout\r\n); SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 2; } SPI_CS_HIGH(); SPI1_ReadWriteByte(0xFF); return 0; }写数据成功后SD卡会进入忙状态把MISO线拉低这个时间可能长达几百毫秒取决于卡的写入速度和擦除策略FATFS修改文件时通常先擦除整块再写。我们的代码必须等待MISO重新变为高电平才能继续操作下一个扇区。如果不等待或等待时间不够紧接着写下一个扇区时SD卡会因为还在忙而拒绝命令返回错误应答。个人经验32GB的普通卡Class 10级别一个扇区写入完成大约需要10~30ms如果卡内碎片很多或者接近满盘这个时间可能翻倍。所以等待超时时间建议设置在100ms以上别写得太死。另外如果频繁写文件导致卡消失大概率是电源问题——写入瞬间的电流尖峰把稳压器拉垮了。4.5 第五步接入FATFS文件系统——打通最后一步裸的扇区读写当然能工作但以文件的形式组织数据才是真正的实用方式。FATFSFatFs是一个开源的FAT文件系统模块移植到STM32只需要提供6个底层接口函数。需要在diskio.c中实现的核心函数DSTATUS disk_initialize(BYTE pdrv) { /* 初始化底层SPI和SD卡 */ if (SD_Init() 0) return RES_OK; return STA_NOINIT; } DRESULT disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count) { while (count--) { if (SD_ReadSector(sector, buff) ! 0) return RES_ERROR; buff 512; } return RES_OK; } DRESULT disk_write(BYTE pdrv, const BYTE *buff, LBA_t sector, UINT count) { while (count--) { if (SD_WriteSector(sector, buff) ! 0) return RES_ERROR; buff 512; } return RES_OK; } DRESULT disk_ioctl(BYTE pdrv, BYTE cmd, void *buff) { switch (cmd) { case GET_SECTOR_COUNT: *(LBA_t*)buff 64 * 1024 * 1024 / 512; /* 按卡容量填写这里示例为64MB */ return RES_OK; case GET_SECTOR_SIZE: *(WORD*)buff 512; return RES_OK; case GET_BLOCK_SIZE: *(DWORD*)buff 1; return RES_OK; default: return RES_PARERR; } }FATFS的配置在ffconf.h中需要注意几个选项FF_USE_MKFS设为1这样可以在STM32上直接格式化SD卡FF_USE_STRFUNC设为1支持printf格式化的f_printf()函数方便输出日志FF_VOLUMES设为1只使用一个逻辑盘。在主函数中就可以这样操作FATFS fs; FIL file; FRESULT res; f_mount(fs, , 1); /* 挂载文件系统 */ /* 写文件示例 */ res f_open(file, test.txt, FA_CREATE_ALWAYS | FA_WRITE); if (res FR_OK) { f_printf(file, Hello SD Card! sector%lu\r\n, 1234); f_close(file); } /* 读文件示例 */ char buf[64]; res f_open(file, test.txt, FA_READ); if (res FR_OK) { UINT br 0; f_read(file, buf, sizeof(buf), br); buf[br] \0; printf(Read: %s\r\n, buf); f_close(file); } f_mount(NULL, , 0); /* 卸载文件系统 */接入FATFS后写日志、存配置、生成CSV数据文件都变成常规操作项目可维护性一下子就上来了。我还试着在 while 循环里每秒钟采一个模拟量、写入data.csv连续跑了一个多小时文件大小和内容都正常稳定性让人放心。5. 排查实录与避坑经验遇到这些问题别慌5.1 初始化失败是最大的翻车现场把最常见的几个初始化错误现象和排查路径整理成表格方便速查现象可能原因排查与解决方法CMD0返回0xFFSPI接线错误、CS极性不对、74时钟不足检查MISO/MOSI是否接反检查CS是否为低电平选中上电前多发送几个0xFFCMD0返回0x05或0x07时钟频率过高、供电电压不稳把SPI分频系数降到128检查模块供电是否在3.3V换一根短杜邦线CMD8无法通过SD卡是SD v1.x或MMC卡不要用支持v2.0的初始化流程直接尝试ACMD41循环ACMD41一直超时卡没插好、卡座接触不良重新插拔SD卡观察模块电源指示灯换一张卡交叉验证每次上电行为不一致SPI模式切换时序不完整确认初始化前CS为高电平时已发送至少80个时钟我踩过的一个印象很深的坑是用某宝买的含电平转换模块直接把模块输出接到STM32的PA6MISO发现MISO电平一直是3.3V高电平CMD0一直接不到有效响应。后来拿来万用表一量发现模块上根本没有电平转换芯片只是简单直连MISO的电压被上拉到了5V把PA6灌坏了好在GPIO耐压过得去换了个引脚就好了。所以买模块时看清楚原理图如果只有4个引脚VCC/GND/CLK/DAT通常就没有电平转换只能用于3.3V单片机。5.2 读出来的数据是0xFF或者全0读扇区返回的buffer全是0xFF说明SD卡没把有效数据推到MISO线上大概率是 等待数据起始标志0xFE 这一步超时了。与此同时写入全0常见原因是写数据后没等待忙结束或者写地址算错导致写到了不存在的区域。排查思路先用读命令检查SD卡的OCR返回和CSD寄存器确认地址计算方式是否正确读扇区操作前确认CS已经被拉低读取整个扇区结束后再把CS拉高试试用低速分频128读排除时钟太快导致的信号失真。如果手边有逻辑分析仪直接抓SPI波形看数据是最简单直观的排查方式。我习惯用几十块钱的8通道逻辑分析仪usb接电脑就能看波形配合pulseview软件一眼就能看出协议层是哪里不对。5.3 文件系统无法挂载或格式化失败f_mount返回FR_NO_FILESYSTEM说明SD卡上没有有效的FAT文件系统。这时候可以用f_mkfs把卡格式化成FAT在代码里调用f_mkfs(, FM_FAT, 0, work_buf, sizeof(work_buf))。如果f_mkfs报FR_MKFS_ABORTED检查disk_ioctl里返回的扇区数和扇区大小是否正确或者换一张卡在电脑上格式化为FAT32再试。有个不易察觉的问题FATFS默认配置里逻辑扇区大小FF_MIN_SS和FF_MAX_SS两者默认都是512如果SD卡的物理扇区是4096字节部分新卡就不能直接用。好在市售主流MicroSD卡在SPI模式下基本都以512字节扇区模式工作遇到格式化失败时留意一下SD卡的规格型号。5.4 关于速度别再纠结SPI太慢SPI模式SD卡的理论速度上限大约是12.5Mbit/s在24MHz SPI时钟下每字节8位就得8个时钟周期实际稳定速度一般在几百KB/s量级。如果你的数据记录速率需求在100KB/s以内SPI模式完全没问题。如果需求更大那就安心去调SDIO加DMA。实际使用中写一段10KB的日志文件从f_write到f_close完成大约耗时100ms左右里面有相当一部分消耗在FATFS的目录区和FAT表更新上。如果对这部分延迟敏感可以考虑用f_sync替代频繁关闭文件写完后不关闭定期同步增大FF_MAX_SS以支持多扇区连续写使用f_lseek定位写避免频繁更新FAT项。不过这些都是优化层面的功夫先把基础读写跑通才是正途。6. 一些实操心得和扩展方向总结一下我踩过的坑和沉淀下来的实操习惯第一SD卡模块和STM32板子之间如果不是紧挨着尽量降低SPI时钟频率不要为了纸面性能去冒险。9MHz的SPI时钟配合杜邦线长度超过10cm波形开始出现明显的振铃和过冲读写偶发错误率明显上升。再往上调高之前先考虑用示波器或逻辑分析仪确认波形质量。第二所有SPI发送函数里都要带超时机制这不仅是给SD卡异常留退路更是给整个系统留后路。我最初写的SD卡驱动没有超时保护一次写测试中SD卡接触不良结果整个控制系统的while循环卡死在SPI等待中连看门狗都救不回来。那之后所有阻塞型通信函数全部加超时。第三工程中强烈建议把SPI底层驱动、SD卡协议层、FATFS文件系统这四层分开API层应用调用、FF层FATFS模块、DIO层SD卡协议、LINK层SPI硬件驱动。调试哪一层出问题就单测哪一层定位问题的速度会快很多。这个项目做完后我又顺手用同样的底层驱动接了一个SPI FlashW25Q64只需要少量改动主要是命令集不同上层FATFS代码一行没改就实现了换个存储介质照样跑文件系统的效果。这就是分层设计的价值。如果你手头的C8T6最小系统板还闲着找一张旧SD卡按这篇文章的步骤走一遍相信很快就能跑通文件读写。后面如果想继续做数据记录仪、传感器日志器、字库读取或者离线固件升级这套方案都能作为基础设施直接复用。