单片机与物联网 / 系统课时
用逻辑分析仪定位错位字节
用逻辑分析仪定位错位字节
SPI 读回错误字节时,先不要反复修改驱动。通过逻辑分析仪同时观察片选、时钟、主机输出和从机响应,可以确定错误发生在采样边沿、事务边界还是字节解释阶段。本课使用 STM32F407 与 W25Q64JV Flash,复现三种常见故障并建立波形验收方法。
学习目标
- 配置四通道逻辑分析仪,准确解析 SPI 事务与采样边沿。
- 根据波形定位 CPOL/CPHA 不匹配、片选提前释放和数据错位。
- 区分位序与多字节数据顺序错误,并通过复测验证修复效果。
建立可重复的 SPI 测试事务
使用 STM32F407 的 SPI1 连接 W25Q64JV,发送 JEDEC ID 指令 0x9F。正常响应的三个字节依次为 EF 40 17,分别代表厂商标识、存储器类型和容量代码。这个事务不修改 Flash 内容,适合反复抓取和对照。
| 信号 | STM32F407 | Flash 端 | 分析仪通道 |
|---|---|---|---|
| CS | PA4,GPIO 输出 | /CS | CH0 |
| SCK | PA5,SPI1_SCK | CLK | CH1 |
| MOSI | PA7,SPI1_MOSI | DI/IO0 | CH2 |
| MISO | PA6,SPI1_MISO | DO/IO1 | CH3 |
Flash 使用 3.3V 供电,分析仪与开发板共地,并确认分析仪输入耐压和逻辑阈值适合 3.3V。标准四线 SPI 模式下,未另作复用的 /WP 与 /HOLD 应保持高电平,可通过 10kΩ 电阻上拉。PA4 初始输出高电平,避免上电时误选中器件。
在 STM32CubeMX 中将 SPI1 设置为 Master、Full-Duplex、8 Bits、MSB First、CPOL Low、CPHA 1 Edge、NSS Software。示例采用 APB2 为 84MHz、SPI 预分频 64,得到 1.3125MHz 的 SCK。若时钟树不同,应重新计算并实测频率。
以 Saleae Logic 2 为例,将 CH0 至 CH3 映射到对应信号,添加 SPI 分析器,设置 Enable Active Low、CPOL=0、CPHA=0、8 bits 和 MSB First。采样率先取 20MS/s,捕获长度覆盖完整事务。其他逻辑分析仪使用等价参数即可。
以下是片段示例,放在 STM32CubeMX 已生成的 main.c 用户代码区,依赖完成初始化的 hspi1、GPIO 和 HAL 时间基准。split_cs 参数用于故意制造片选提前释放故障。
#include "main.h"
extern SPI_HandleTypeDef hspi1;
HAL_StatusTypeDef spi_probe_jedec(uint8_t id[3], uint8_t split_cs)
{
uint8_t tx[4] = {0x9F, 0x00, 0x00, 0x00};
uint8_t rx[4] = {0};
HAL_StatusTypeDef status;
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET);
if (split_cs == 0U) {
// 正常事务:命令与三个响应字节共用一次片选
status = HAL_SPI_TransmitReceive(&hspi1, tx, rx, 4, 100);
} else {
// 故障注入:发送命令后提前释放片选
status = HAL_SPI_TransmitReceive(&hspi1, tx, rx, 1, 100);
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET);
HAL_Delay(1);
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET);
if (status == HAL_OK) {
status = HAL_SPI_TransmitReceive(&hspi1, &tx[1], &rx[1], 3, 100);
}
}
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET);
if (status == HAL_OK) {
// 全双工第一个接收字节对应命令阶段,不是 ID
id[0] = rx[1];
id[1] = rx[2];
id[2] = rx[3];
}
return status;
}在 MX_GPIO_Init() 和 MX_SPI1_Init() 执行完毕后,声明 uint8_t id[3];,先调用 spi_probe_jedec(id, 0);,通过调试器观察数组,同时触发逻辑分析仪采样。
预期结果(逻辑分析仪解码与调试器观察值,并非串口输出):
MOSI: 9F 00 00 00
MISO: [忽略] EF 40 17
id[0]: 0xEF
id[1]: 0x40
id[2]: 0x17命令阶段的 MISO 不参与判断,实际电平和解码字节可能不同。正常事务应有 32 个 SCK 时钟周期,且整个命令与响应阶段 CS 持续为低。
从采样边沿识别模式不匹配
SPI 的 CPOL 决定空闲时钟电平,CPHA 决定相对于时钟周期的采样边沿。W25Q64JV 的标准 SPI 通信支持模式 0 和模式 3。本例选择模式 0:SCK 空闲为低,接收方在上升沿采样,数据通常在下降沿更新。

按以下顺序判断,避免将解析器配置错误误认为设备故障。
- 在 CS 为高的空闲区读取 SCK 电平。模式 0 应为低,模式 3 应为高;若与固件配置不同,先检查实际 SPI 时钟极性。
- 放大第一个字节,检查 MOSI 是否在采样边沿前稳定。模式 0 的前八个上升沿应依次采到
10011111,解码为0x9F。 - 保持固件不变,故意把分析仪的 CPHA 改为 1,即改在后半个时钟边沿采样。重新解码同一份波形,观察解析值和错误提示,再恢复 CPHA=0。
- 如需复现真实设备模式不匹配,再将 MCU 临时改为 CPOL Low、CPHA 2 Edge,即模式 1,并将分析仪设置成相同的实际总线模式。该 Flash 不支持模式 1,通信结果可能错误或不稳定,实验后恢复模式 0。
如果 MOSI 波形能正确解码为 0x9F,但 MISO 的三个响应字节异常,应进一步检查主机采样边沿、从机模式、信号建立时间与电气连接,而不是直接将错误归结为命令字节发送失败。
通过片选断点定位响应丢失
W25Q64JV 的 0x9F 读取要求 CS 从命令开始到三个 ID 字节读取完成始终保持低电平。若命令刚发送完就释放 CS,器件会结束当前指令,下一次拉低 CS 后的 0x00 不再是原指令的响应时钟,而会被当成新指令内容。

现在改为调用 spi_probe_jedec(id, 1);,分析仪触发条件仍设为 CS 下降沿。故障代码在发送 0x9F 后拉高 CS,并保持约 1ms,再次拉低 CS 发送三个 0x00。捕获窗口应覆盖这段间隔。
预期现象是分析仪能识别两个片选有效区间:第一个只有 8 个时钟,第二个有 24 个时钟。第二段 MISO 不保证为 EF 40 17,具体字节可能受器件状态和线路空闲电平影响,不能将 0xFF 或 0x00 当作必然结果。
当抓到这一类波形时,重点排查驱动是否把命令发送和数据接收封装成了两次独立的片选事务。正确实现可以使用一次 HAL_SPI_TransmitReceive(),或者在 CS 始终为低的期间连续完成多次 HAL 传输,等最后一个字节真正发送完毕后再释放 CS。
还要区分字节之间的 SCK 停顿与 CS 释放。只要器件时序允许,SCK 在字节间暂停并不必然结束事务;CS 拉高才是这里的关键边界。对于实际驱动,仍需逐项核对数据手册规定的片选建立、保持和释放时间。
区分位序错误与多字节顺序错误
SPI 的 MSB First 指每个字节从最高有效位开始传输;多字节数据的排列顺序则由器件协议决定。这是两个独立问题。分析仪已解码出正确字节,但程序解释结果错误时,优先检查缓存下标和数据拼接方式。
| 观察结果 | 可能原因 | 验证与修正 |
|---|---|---|
MOSI 的 9F 被解析为 F9 |
分析仪设成 LSB First,产生位反转 | 核对原始位流,改为 MSB First |
MISO 为 EF 40 17,程序却显示 17 40 EF |
软件把三个字节倒序读取或展示 | 检查数组下标与字节拼接顺序 |
| MOSI、MISO 字节均不稳定 | 模式、电气质量或采样配置错误 | 先检查边沿,再降速复测 |
| MOSI 正常而响应缺失 | CS 边界、MISO 接线或器件状态异常 | 检查完整片选窗口及从机供电 |
对于本例,三个响应字节按顺序拼接为 24 位标识值 0xEF4017。如果直接按反向下标拼接,会得到 0x1740EF。两者的逻辑分析仪原始波形可能完全相同,说明问题发生在软件解释层,而非 SPI 传输层。
若读取的是带地址的寄存器或数据块,应进一步核对协议中的地址传输顺序。例如 W25Q64JV 的普通读取指令 0x03 后需要依次传输 24 位地址的高、中、低字节,不能根据 MCU 的小端内存布局自行颠倒顺序。对未知数据内容,不要仅凭数值看起来合理就判定字节序正确。
按固定证据链完成故障复测
先恢复 MCU 模式 0、分析仪 CPOL=0/CPHA=0、MSB First,并重新调用 spi_probe_jedec(id, 0);。连续执行十次读取,逐次核对以下验收条件。
- 物理层:CS 空闲高、有效低;SCK 空闲低,频率接近配置值;四线电压与分析仪阈值匹配。
- 协议层:每次事务有且仅有一个连续的 CS 低电平窗口,包含 32 个时钟;MOSI 为
9F 00 00 00。 - 数据层:忽略命令阶段的 MISO,后续三字节为
EF 40 17;调试器中的id[0..2]与波形解码一致,十次结果相同。
如果降速后故障消失,应继续检查 SCK 和数据线的建立保持时间、布线长度、探头接地、信号完整性及从机允许的时钟频率;逻辑分析仪可定位数字边沿和协议边界,但无法单独证明模拟波形质量合格,必要时配合示波器测量。
最终应保存正常和异常两份四线捕获记录,标记错误发生的时钟边沿或 CS 转换点,并记录固件模式、实测 SCK 频率与接收字节。这样才能将错位字节明确归因到采样、事务控制或软件数据解释,而不是根据一串错误十六进制值猜测原因。