SD卡FATFS挂载失败:逻辑分析仪与调试器四层定位法

立即解锁
发布时间: 2026-11-15 11:16:57 阅读量: 6 订阅数: 1 AIGC
## 1. 硬件调试工具先上桌:SD卡挂载失败别急着改ffconf.h SD卡挂载失败时,很多人第一反应是翻`ffconf.h`,把宏改来改去,改到凌晨也没进展。我现在的习惯相反:先不动代码,把硬件调试工具摆上桌——逻辑分析仪夹住SPI四根线,串口把`diskio`每个返回值打出来,调试器停在HardFault现场看对齐和总线地址。这套动作看着慢,实际比盲改快得多。下面以STM32+SPI模式SD卡跑FATFS为例,走一遍从`f_mount`返回`FR_NO_FILESYSTEM`到定位根因的完整过程;工具不挑型号,逻辑分析仪、示波器、J-Link或ST-Link都能对上号。 ## 2. 硬件调试工具怎么分工:SPI-SD链路的四层观测点 挂载失败最怕一上来就全局搜索。FATFS从`f_mount`到真正读扇区,中间隔了命令握手、扇区读写、MCU内存访问、文件系统解析四层,每层出问题的现象长得都很像:要么返回`FR_NO_FILESYSTEM`,要么直接HardFault。硬件调试工具的价值不是“看一眼波形”,而是把四层拆开,让每一层都有独立的判据。 ### 2.1 四层拆分:命令握手、扇区数据、内存DMA、文件系统 第一层是命令握手层,发生在`disk_initialize`里。`SPI_SD_Init()`要完成CMD0、CMD8、ACMD41这一串上电时序,任何一步超时都会返回`STA_NOINIT`,FATFS随后拒绝挂载。这一层的观测点是CS拉低后的前几个字节,以及卡在MISO上回的响应字节。逻辑分析仪在这里看的是“卡有没有说话”,不是“数据对不对”。 第二层是扇区数据层,对应`disk_read`和`disk_write`。FATFS传给底层的`sector`是512字节为单位的逻辑块号,不是字节地址。这一层的观测点是CMD17/CMD24命令字、数据令牌`0xFE`、512字节数据以及末尾的CRC。逻辑分析仪的SPI解码器能直接把命令字和扇区号解出来,比在代码里打印更直观。 第三层是内存与DMA层,主要在SDIO路径上暴露。`HAL_SD_ReadBlocks`要求缓冲区4字节对齐,局部数组或外部SRAM地址不对齐时,轻则传输异常,重则进HardFault。这一层靠调试器看`SCB->CFSR`和`SCB->BFAR`,逻辑分析仪帮不上忙。 第四层是文件系统层,`f_mount`和`f_open`返回`FR_NO_FILESYSTEM`。这一层的问题往往不是FATFS本身,而是下面三层把数据读错位置了。判据是扇区0的前512字节里有没有引导扇区特征:偏移0的跳转指令和偏移510~511的`0x55AA`签名。 | 层 | 观测点 | 主要工具 | 通过判据 | |---|---|---|---| | 命令握手 | CMD0/CMD8/ACMD41响应 | 逻辑分析仪 | 卡有响应且最终回0x00 | | 扇区数据 | CMD17/CMD24、0xFE令牌、512字节 | 逻辑分析仪 | 地址与扇区号一致、数据长度完整 | | 内存DMA | 缓冲区地址、CFSR | 调试器 | 4字节对齐、无HardFault | | 文件系统 | 扇区0内容、返回值 | 串口+调试器 | 有引导扇区签名、返回FR_OK | 这张表的作用是缩小范围:先确认卡在命令层有没有响应,再确认扇区地址有没有传错,最后才怀疑FATFS配置。顺序反了,就容易在`ffconf.h`里绕圈。 ### 2.2 逻辑分析仪四通道怎么接、触发怎么设 接线不复杂,但要接对位置。四个通道分别夹CS、SCK、MOSI、MISO,地线必须和板子共地,否则解码出来的字节会随机翻转。CS建议夹在卡座焊盘上,不要夹在MCU引脚上,因为中间可能串了电平转换或缓冲器,波形到了卡座已经变形。 触发设置成CS下降沿、单次触发。SD卡的一次完整初始化从CS第一次拉低开始,用CS下降沿做触发能抓到CMD0。抓取时长按最坏情况设:卡上电慢的时候,ACMD41可能循环几十次,时间窗口给到200ms以上比较稳妥;如果只抓几毫秒,很容易只看到半个握手就结束了。 采样率按SPI时钟的4~10倍设。初始化阶段SPI通常要降到400kHz以内,这时候1MHz~4MHz的采样率足够解码;等初始化完成、时钟升到几兆甚至十几兆,采样率要跟着往上提,否则边沿会糊成一片。SPI解码器配置成CPOL=0、CPHA=0、MSB first、CS低有效、字长8位,这几个参数和SD卡SPI模式是对应的,配错了解出来全是`0xFF`或错位字节。 还有一点容易被忽略:逻辑分析仪的通道顺序要和解码器里绑定的通道一致。我见过有人把MOSI和MISO夹反了,解码器里看到主机命令全是`0xFF`,折腾半天以为是卡坏了。夹线之前先在板子背面确认丝印,或者用万用表蜂鸣档对一下卡座引脚定义。 ### 2.3 串口日志埋在哪几个返回值上 逻辑分析仪看的是线,串口看的是代码走到哪一步。两者对时间轴,才能判断“波形上卡回了0x00,但代码里`disk_initialize`还是返回失败”这种错位。 日志不要满篇打印。每读一个扇区都`printf`会把SPI时序拖慢,尤其是初始化阶段,打印一次可能就错过ACMD41的响应窗口。我一般只埋四个点:`disk_initialize`失败、`disk_read`失败、`disk_write`失败、`f_mount`返回值。成功路径不打印,失败路径带上`pdrv`、`sector`、`count`和返回值。 ```c /* user_diskio.c —— 带失败日志的SPI-SD底层接口,日志走UART */ #include "diskio.h" #include "sd_spi.h" #include <stdio.h> DSTATUS disk_status(BYTE pdrv) { if (pdrv != 0) return STA_NOINIT; return 0; } DSTATUS disk_initialize(BYTE pdrv) { if (pdrv != 0) return STA_NOINIT; if (SPI_SD_Init() != SD_OK) { printf("[disk] init fail pdrv=%u\r\n", pdrv); return STA_NOINIT; /* CMD0/CMD8/ACMD41 任一步失败 */ } printf("[disk] init ok pdrv=%u\r\n", pdrv); return 0; } DRESULT disk_read(BYTE pdrv, BYTE* buff, LBA_t sector, UINT count) { for (UINT i = 0; i < count; i++) { if (SPI_SD_ReadSector(sector + i, buff + i * 512) != SD_OK) { printf("[disk] read fail sec=%lu cnt=%u\r\n", (unsigned long)(sector + i), count); return RES_ERROR; } } return RES_OK; } ``` 这段代码的关键在`buff + i * 512`:`sector`是逻辑块号,直接传给底层;缓冲区偏移才乘512。如果反过来把`sector`乘512再传下去,逻辑分析仪上会看到CMD17的地址参数跳着走,扇区0根本读不到,`f_mount`自然返回`FR_NO_FILESYSTEM`。日志里的`sec`打印的是实际下发的块号,和波形上的地址参数一对照,这类错误藏不住。 ## 3. 逻辑分析仪抓SPI:从CMD0到ACMD41的握手波形怎么读 串口告诉你“初始化失败”,逻辑分析仪告诉你“失败在哪一步”。SD卡SPI模式的初始化是一串有固定顺序的命令,波形上每个命令字都能对得上,读懂了就不需要猜。 ### 3.1 SPI模式与片选:先让解码器能出字节 SD卡在SPI模式下常用Mode 0,也就是CPOL=0、CPHA=0,数据在SCK上升沿采样。如果解码器配成Mode 3,解出来的命令字会整体错一位,看起来像卡回了乱七八糟的值。判断方法很简单:CS拉低后主机发的第一个字节应该是`0x40`(CMD0),如果解出来是`0x80`或`0x20`,先查CPOL/CPHA,别急着换卡。 片选时序比模式更容易翻车。有些驱动用GPIO手动控制CS,在命令之间把CS拉高再拉低,这是允许的;但在一个命令的8个字节中间被中断打断、CS被其他外设操作拉高,这一帧就断了。波形上的表现是CS在字节之间出现毛刺,卡回的响应字节对不上命令。逻辑分析仪把CS和SCK一起抓,毛刺一眼就能看见。 初始化阶段的时钟要降下来。SD卡规范要求CMD0/CMD8/ACMD41在400kHz以内完成,很多驱动初始化时忘了分频,直接拿高速时钟跑,结果CMD0偶尔有响应、ACMD41一直超时。波形上SCK频率明显偏高、卡回`0xFF`,先把SPI预分频调大再试。等`disk_initialize`返回成功,再切回高速时钟读扇区。 ### 3.2 握手阶段:CMD0、CMD8、ACMD41的波形判读 CMD0是软件复位,主机发`0x40 00 00 00 00 95`,最后那个`0x95`是CRC。CMD0对CRC有要求,CRC错了卡不响应。波形上看到CS拉低后第一个字节`0x40`,紧接着5个字节参数和CRC,然后MISO上应该回`0x01`。如果MISO一直是高电平`0xFF`,说明卡没说话,先查供电和CS,再查SCK有没有输出。 CMD8用来确认卡支持2.0以上协议,主机发`0x48 00 00 01 AA 87`,卡回`0x01`加4字节。如果卡回`0x05`或者不回,可能是老卡或者电压不匹配。这一步在波形上很好认:`0x48`后面跟着`00 00 01 AA`,参数里的`0x1AA`就是电压范围。 ACMD41不是一条命令,是CMD55加CMD41的组合。主机先发`0x77 00 00 00 00 01`(CMD55),卡回`0x01`,再发`0x69 40 00 00 00 01`(ACMD41),卡在初始化完成前一直回`0x01`,完成后回`0x00`。逻辑分析仪上会看到`0x77`和`0x69`成对出现,可能重复很多次。如果`0x69`发了几十次卡还回`0x01`,重点查两件事:CMD8有没有成功、供电是否在卡座处跌落。波形上SCK和MOSI都正常但MISO始终`0x01`,基本可以把问题锁在卡本身或供电上。 握手阶段还有一个细节:CMD0之后要给卡留至少74个时钟。有些驱动发完CMD0立刻发CMD8,卡还没完成复位,CMD8自然没响应。波形上表现为CMD0回`0x01`后紧接着的CMD8回`0xFF`,中间几乎没有空隙。解决办法是在CMD0后补几个字节的`0xFF`,让SCK多跑几拍。 ### 3.3 扇区读写:512字节数据令牌与CMD13忙等待 握手完成后进入扇区读写,逻辑分析仪的SPI解码器这时候要能把命令字和数据分开显示。单块读走CMD17,主机发`0x51`加4字节扇区地址和CRC,卡回`0x00`后发数据令牌`0xFE`,紧接着512字节数据和2字节CRC。解码器上看到`0xFE`后面跟着整512字节,说明数据长度没问题;如果`0xFE`之后只解出几十个字节就断了,查CS是不是中途被拉高,或者DMA缓冲区是不是越界。 写扇区走CMD24,主机发`0x58`加地址和CRC,卡回`0x00`后主机发`0xFE`、512字节数据和CRC。写完不是立刻结束,卡内部要完成编程,MISO会被拉低表示忙。这时候如果主机紧接着发下一条命令,卡可能不响应。代码里必须等忙结束,材料里的做法是用CMD13轮询卡状态直到不忙。 ```c /* SPI模式写扇区:每写一块都要等卡内部编程完成 */ DRESULT disk_write(BYTE pdrv, const BYTE* buff, LBA_t sector, UINT count) { for (UINT i = 0; i < count; i++) { if (SPI_SD_WriteSector(sector + i, buff + i * 512) != SD_OK) return RES_ERROR; SPI_SD_WaitWriteComplete(); /* CMD13 轮询直到卡不忙 */ } return RES_OK; } ``` `SPI_SD_WaitWriteComplete()`内部做的事就是反复发CMD13读卡状态,直到忙位清零。逻辑分析仪上能看到写数据结束后MISO保持低电平一段时间,然后CMD13的响应里忙位变成0。如果波形上忙还没结束就出现了下一条CMD17,说明等待函数被跳过或者超时太短,写进去的数据可能只写了一部分,重新挂载时文件系统校验不过。 读多扇区时还要注意地址递增。`disk_read`里`count`大于1时,底层按`sector + i`逐块读,逻辑分析仪上CMD17的地址应该是连续的。如果地址每次跳512,说明代码里把块号当字节地址又乘了一次,这是`FR_NO_FILESYSTEM`最常见的来源之一。 ## 4. 调试器与串口配合:把FR_NO_FILESYSTEM和HardFault坐实 逻辑分析仪能证明“线上发生了什么”,但代码里指针指向哪、缓冲区地址是多少,还得靠调试器。串口负责把返回值带出来,调试器负责在崩溃现场按下暂停键。 ### 4.1 FR_NO_FILESYSTEM:先看扇区地址,再看引导扇区签名 `f_mount`返回`FR_NO_FILESYSTEM`,只说明FATFS在扇区0没找到合法的引导扇区,不等于卡没格式化。先看逻辑分析仪上第一次CMD17的地址参数:读扇区0时应该是`0x00000000`。如果看到地址是`0x00000000`但读回来的512字节全是`0xFF`,可能是卡没初始化成功;如果地址每次递增512,基本可以确定`sector`被当成了字节地址。 再看调试器里`buff`的前512字节。合法的FAT引导扇区偏移0是跳转指令,常见`0xEB 0x3C 0x90`;偏移510~511是`0x55 0xAA`签名。如果这两个特征都没有,而波形上地址又是对的,就要怀疑卡本身没有文件系统,或者读命令的CRC/数据令牌阶段出了问题。 这里有个容易误判的点:卡在SPI模式下读扇区0,返回的数据令牌`0xFE`之后才是512字节。如果驱动把`0xFE`也当成数据写进了缓冲区,整个512字节会整体错开一个字节,引导扇区签名自然对不上。逻辑分析仪上数据令牌的位置是固定的,对照代码里接收缓冲的起始位置,能看出有没有把令牌字节算进去。 ### 4.2 HardFault现场:CFSR、BFAR和那四个字节的对齐 SDIO路径的HardFault比SPI路径更隐蔽,因为SPI是GPIO模拟或SPI外设逐字节搬,地址不对齐最多读错数据;SDIO走DMA,缓冲区地址不对齐会直接触发总线异常。现象是程序跑着跑着突然停住,串口最后一条日志停在某次`disk_read`,没有返回值。 调试器连上后先看`SCB->CFSR`。如果`UNALIGNED`标志置位,基本就是缓冲区地址问题。再看`SCB->BFAR`,里面是触发异常的总线地址,低两位不是0就说明没对齐。材料里提到`HAL_SD_ReadBlocks`的`buff`必须4字节对齐,最好放在内部RAM;局部数组、外部SRAM、结构体里的`uint8_t`成员都可能不满足。 解决办法是定义一个全局的512字节对齐缓冲区,读完之后再拷给上层。这样DMA访问的地址永远是4字节对齐的,上层传进来的指针随便是什么地址都不会触发异常。 ```c /* SDIO模式:用全局对齐缓冲区承接DMA,再拷贝给上层 */ static uint8_t sd_buf[512] __attribute__((aligned(4))); DRESULT disk_read(BYTE pdrv, BYTE* buff, LBA_t sector, UINT count) { if (pdrv != 0 || count != 1) return RES_PARERR; if (HAL_SD_ReadBlocks(&hsd, sd_buf, sector, 1, 3000) != HAL_OK) return RES_ERROR; /* HAL库是异步的,必须等传输结束再返回 */ while (HAL_SD_GetCardState(&hsd) != HAL_SD_CARD_TRANSFER); memcpy(buff, sd_buf, 512); return RES_OK; } ``` `__attribute__((aligned(4)))`告诉编译器这个数组按4字节边界放置,`sd_buf`的地址低两位一定是0。`HAL_SD_ReadBlocks`的最后一个参数3000是超时毫秒数,卡没响应时不会无限等。`HAL_SD_GetCardState`的轮询不能省,HAL库发起传输后是异步的,不等状态回到`HAL_SD_CARD_TRANSFER`就`memcpy`,拿到的可能是半截数据。 这个`while`本身没有超时,卡死的时候会停在这里。调试时如果发现程序卡在这行,先用逻辑分析仪看SDIO_CLK有没有输出,再看卡座供电;如果时钟正常但状态一直不回来,查CMD线和DAT线有没有虚焊。 ### 4.3 SDIO路径的3000ms超时与卡状态轮询 3000ms不是随便写的。SD卡内部擦除和编程在劣质卡上可能到几百毫秒,超时给太短会在写操作时随机返回`RES_ERROR`,但重新上电又能用,这种“玄学”故障很难复现。串口日志里看到`disk_write`偶尔失败、失败扇区不固定,先把超时往上调,同时用逻辑分析仪看写数据之后卡忙了多久。 `HAL_SD_GetCardState`的返回值除了`HAL_SD_CARD_TRANSFER`,还有`HAL_SD_CARD_RECEIVING`、`HAL_SD_CARD_PROGRAMMING`等。轮询时只等`TRANSFER`,其他状态都算没完成。如果调试器里看到状态停在`PROGRAMMING`很久,说明卡还在写内部Flash,这时候断电或复位都会导致数据损坏。 SPI路径没有这个问题,因为`SPI_SD_WaitWriteComplete`内部就是CMD13轮询,超时逻辑要自己控制。材料里没有给具体超时值,我一般按卡的数据手册留够编程时间,同时在轮询里加计数,超了就返回错误并打印,避免死循环把整个系统拖住。 ## 5. 硬件调试工具避坑:五条从波形和日志里长出来的经验 下面这几条都是挂载失败排查里反复出现的,现象、原因、解决一对就能对上。每条都能从波形或日志里找到证据,不是凭感觉猜的。 ### 5.1 时序与片选类故障 第一条,`f_mount`返回`FR_NO_FILESYSTEM`,逻辑分析仪上CMD17的地址参数每次加512。原因是`disk_read`里把`sector`当成了字节地址,又乘了一次512,实际读的是扇区0、512、1024……正确写法是`SPI_SD_ReadSector(sector + i, buff + i * 512)`,块号直接透传,只有缓冲区偏移乘512。改完之后波形上的地址从0开始连续递增,引导扇区签名就能读到。 第二条,初始化阶段CMD0有响应,CMD8和ACMD41一直回`0xFF`或`0x01`。先看SCK频率,初始化时SPI分频不够、时钟还在几兆,卡跟不上;再看CMD0之后有没有留够74个时钟。解决是把初始化时钟降到400kHz以内,CMD0后补几个`0xFF`字节,等卡复位完成再发CMD8。波形上能看到CMD0和CMD8之间多出几拍时钟,ACMD41的响应就会正常。 第三条,写扇区返回成功,但重新挂载后文件损坏。逻辑分析仪上写数据结束后MISO还在低电平,下一条命令已经发出去了。原因是`disk_write`里没有等卡内部编程完成,`SPI_SD_WaitWriteComplete()`被跳过或超时太短。解决是每写一块都调CMD13轮询,确认忙位清零再发下一条命令;批量写的时候也不要为了省时间把等待去掉。 ### 5.2 内存与协议类故障 第四条,SPI模式读单扇区正常,连续读多扇区偶发HardFault或数据错位。SDIO路径上查缓冲区对齐,SPI路径上查`count`和缓冲区长度:`disk_read`里`buff + i * 512`如果只分配了一个扇区的空间,`count`大于1就会越界写。解决是按最大`count`分配缓冲区,或者一次只读一个扇区,让FATFS自己循环。 第五条,逻辑分析仪解码出来的命令字错位、CS在字节之间抖动。原因是SPI模式配错(CPOL/CPHA和卡不一致),或者CS被手动GPIO控制时在中断里被拉高。解决是把解码器和驱动都配成Mode 0,CS在一条命令的整个帧内保持低电平;如果必须手动控制CS,操作CS的代码要关中断,避免被打断。 这五条的共同点是:都能在波形或日志里找到“不对劲”的那一帧,而不是靠反复改配置试出来。硬件调试工具的作用就是把“偶发”变成“可见”。 ## 6. 固化一套抓包检查表:下次挂载失败十分钟定位 排查次数多了之后,我把动作固化成一张检查表,每次挂载失败按顺序走,不跳步。第一步,串口确认`disk_initialize`返回值;失败就抓CS下降沿,看CMD0有没有回`0x01`。第二步,初始化成功但`f_mount`失败,抓CMD17,核对扇区地址是不是从0开始、数据令牌`0xFE`后面是不是完整512字节。第三步,地址和数据长度都对,用调试器看缓冲区前512字节有没有`0x55AA`签名。第四步,出现HardFault就查`SCB->CFSR`的`UNALIGNED`位和`SCB->BFAR`,确认缓冲区地址低两位是不是0。 | 步骤 | 工具 | 看什么 | 通过标准 | |---|---|---|---| | 1 | 串口 | `disk_initialize`返回值 | 返回0,日志有init ok | | 2 | 逻辑分析仪 | CMD0/CMD8/ACMD41响应 | 最终回0x00 | | 3 | 逻辑分析仪 | CMD17地址、0xFE令牌、512字节 | 地址从0开始、数据完整 | | 4 | 调试器 | 缓冲区前512字节 | 偏移510~511为0x55AA | | 5 | 调试器 | CFSR、BFAR | 无UNALIGNED、地址4字节对齐 | 比检查表更好用的是基线波形对比。第一次调通一块板子时,把完整的挂载波形存下来,标好CMD0、CMD8、ACMD41、CMD17的位置。后面再遇到挂载失败,先抓同样的触发条件,和基线并排看:是握手阶段少了响应,还是扇区地址跳了,还是数据令牌后面长度不对。波形对比比看代码快,因为代码可以骗人,线上的字节不会。 从那以后我每次换卡、换板子、换SPI时钟,都强制先抓一次基线波形再改代码,哪怕这次看起来“只是换了个卡座”。希望帮到你。
复制全文

相关推荐