FPGA 与数字 IC 设计 / 系统课时
调试SPI通信异常
调试SPI通信异常
本课解决 SPI 完全没有响应、读写数据错位和偶发错误的问题。核心不是先改驱动,而是把 SCLK、MOSI、MISO、CS 放到同一时间轴上,依次确认片选窗口、时钟边沿、数据建立保持关系以及 SPI Mode 是否与从设备一致。
学习目标
- 能根据 SCLK、MOSI、MISO、CS 波形判断 SPI 帧是否真正发生
- 能用 CPOL 与 CPHA 判断 Mode 0~3 的采样与翻转关系
- 能区分片选、时钟、数据线和模式配置导致的常见异常
先看片选窗口,再看数据
SPI 与 UART 最大的不同之一,是通信通常由 CS 定义一次事务的边界。调试时先确认 CS 是否有效、持续时间是否覆盖完整帧,以及每次事务之间是否符合器件要求。
以常见低有效片选为例,CS 拉低后 SCLK 才产生有效时钟,MOSI 在时钟边沿附近提供数据,MISO 在从设备允许时驱动返回数据。若 CS 根本没有拉到有效电平,后续看到再漂亮的 SCLK 也不代表从设备真的接受了这次事务。

用 CPOL 和 CPHA 判断 SPI Mode
SPI Mode 由两个参数决定:CPOL 定义时钟空闲电平,CPHA 定义数据相对哪个时钟边沿采样。四种组合如下:
| Mode | CPOL | CPHA | 空闲电平 | 常见采样边沿 |
|---|---|---|---|---|
| 0 | 0 | 0 | Low | 第一个上升沿 |
| 1 | 0 | 1 | Low | 第一个下降沿 |
| 2 | 1 | 0 | High | 第一个下降沿 |
| 3 | 1 | 1 | High | 第一个上升沿 |
这里最容易犯的错误,是只说“上升沿采样”却没有确认 CPOL。对于 CPOL=1 的模式,第一个有效边沿方向已经发生变化,因此必须把空闲电平、第一有效边沿和采样边沿一起观察。
判断数据是否真的在正确边沿上稳定
当波形看起来像正常时钟,但收到的数据整体左移一位、右移一位或固定错误,优先怀疑 CPHA/采样边沿不一致。观察 MOSI 或 MISO 在采样边沿前后是否稳定,比直接修改字节拼接代码更有效。
例如一个 8-bit 传输应当看到明确的 8 个 SCLK 周期。若 CS 窗口内只有 7 个或 9 个有效时钟,就先解决时钟计数或片选窗口问题,不要把错误归因于字节序。
CS = 0:开始一次 SPI 事务
SCLK:产生 8 个完整时钟周期
MOSI:在约定边沿提供 8 个数据位
MISO:在从设备规定的边沿返回 8 个数据位
CS = 1:结束事务预期结果
在一次有效 CS 窗口内可数出与协议要求一致的 SCLK 周期;数据位数量与预期一致,且采样边沿附近没有明显抖动或边沿重合。从三个现象快速定位
完全没有响应时,首先检查 CS 极性、CS 时序、设备供电和 SCLK 是否真正运行。返回数据整体错位时,重点检查 CPOL、CPHA 与采样边沿。偶发一两个 bit 错误时,则继续检查数据建立保持裕量、SCLK 频率、线路完整性以及 CS 在事务期间是否被意外抖动。
尤其要区分“主机没有采到数据”和“从设备没有发送数据”。如果 MISO 始终保持固定电平,应先确认从设备是否被选中、是否要求读命令后的 dummy byte,以及该器件是否在当前阶段允许驱动 MISO。不要仅凭“读出来全是 0xFF 或 0x00”判断芯片损坏。
用逻辑分析仪做一次最小验证
固定一条确定的读写命令,降低 SCLK 到器件允许范围内的较低频率,并只抓取一次 CS 事务。验证时只回答四个问题:CS 是否有效、时钟是否正确、数据是否在正确边沿稳定、时钟数量是否正确。
# 片段示例:用于记录一次 SPI 事务的关键测量结果
measurements = {
"cs_active": True,
"clock_cycles": 8,
"cpol": 0,
"cpha": 0,
"sample_edge": "rising",
}
assert measurements["cs_active"]
assert measurements["clock_cycles"] == 8
assert measurements["cpol"] == 0 and measurements["cpha"] == 0
print("SPI transaction timing checks passed")预期结果
SPI transaction timing checks passed这个程序只是对已经测得的参数做一致性检查,不能代替实际波形测量。真正的故障定位仍应以同一事务中的 CS、SCLK、MOSI、MISO 时间关系为证据。只要能把“没有片选”“模式错误”和“数据时序不足”分别对应到波形上的具体位置,SPI 异常就能从驱动层猜测转化为硬件时序上的可验证问题。