单片机与物联网 / 系统课时
使用逻辑分析仪排查总线
使用逻辑分析仪排查总线
当 I2C 设备不应答或 SPI 数据始终错误时,仅查看程序返回值很难判断问题位于连线、配置还是器件协议。本课给出从接线、采样、协议解码到故障归因的固定顺序,并用可运行脚本检查导出的解码结果。
学习目标
- 正确设置逻辑分析仪通道、采样率与协议解码参数
- 从 I2C 应答位和 SPI 采样边沿定位典型故障
- 将解码结果导出为 CSV,并自动筛查地址、应答和模式问题
捕获与解码方法
开始捕获前,应先将分析仪地线与目标板地线连接,再接入 SCL/SCK、SDA/MOSI、MISO 和 CS。数字分析仪只能判断高低电平,若电压门限不匹配,波形可能被错误识别。探头线应尽量短,避免为高速 SPI 引入明显边沿畸变。
采样率至少应高于总线时钟数倍。为了看清边沿并让解码器稳定工作,通常可先使用时钟频率的 8~10 倍;例如 400 kHz I2C 可从 4 MHz 开始,8 MHz SPI 可从 64 MHz 开始。若分析仪上限不足,应先降低主控总线时钟再排查。
| 总线 | 必看信号 | 解码关键参数 | 首要观察点 |
|---|---|---|---|
| I2C | SCL、SDA |
7 位地址显示、时钟速率 | START、地址、R/W、ACK/NACK、STOP |
| SPI | SCK、MOSI、MISO、CS |
CPOL、CPHA、位序 | 片选边界、采样边沿、命令与返回值 |
| 共通项 | 目标板 GND | 电压门限、采样率 | 空闲电平、毛刺、过慢上升沿 |

I2C 解码器通常显示 7 位地址。若器件资料给出写地址字节 0x78,其 7 位地址是 0x3C,因为最低位是 R/W 位。地址阶段出现 NACK,应依次检查地址表示方式、供电、上拉电阻和引脚复用;数据阶段出现 NACK,则还要检查器件是否忙、命令是否支持以及写入长度是否越界。
SPI 没有应答位,必须结合命令与返回值判断。若 MISO 长期为 0xFF,常见原因是从设备未被选中、未供电或线路被上拉;若每个字节都像左移或右移一位,应优先检查 CPOL、CPHA 和解码器模式。CS 必须完整包围命令、地址和数据阶段,过早拉高会让从设备终止当前事务。
示例与验证
多数逻辑分析仪都能导出协议解码 CSV。下面给出一个精简样例:第一帧把 8 位地址字节 0x78 当成地址并收到 NACK;第二帧使用正确的 7 位地址 0x3C;第三帧 SPI 使用模式 3,而目标器件要求模式 0。
将以下内容保存为 decoded.csv:
protocol,frame,address_or_mode,direction,tx,rx,ack,cs
I2C,1,0x78,W,00,,NACK,
I2C,2,0x3C,W,00,,ACK,
SPI,3,3,,9F,EF 40 17,,LOW再将以下脚本保存为 BusTraceInspector.py。脚本使用 Python 标准库读取 CSV,并输出明确的故障原因。
import csv
import sys
from pathlib import Path
def analyze(path: Path) -> int:
issues = []
with path.open("r", encoding="utf-8", newline="") as file:
for row in csv.DictReader(file):
protocol = row["protocol"].strip().upper()
frame = row["frame"].strip()
if protocol == "I2C":
address = int(row["address_or_mode"], 0)
if address > 0x7F:
guessed_address = address >> 1
issues.append(
f"I2C frame {frame}: 0x{address:02X} is not a 7-bit address; "
f"try 0x{guessed_address:02X}"
)
if row["ack"].strip().upper() != "ACK":
issues.append(f"I2C frame {frame}: NACK detected")
elif protocol == "SPI":
decoded_mode = int(row["address_or_mode"], 0)
expected_mode = 0
if decoded_mode != expected_mode:
issues.append(
f"SPI frame {frame}: decoded mode {decoded_mode}, "
f"expected mode {expected_mode}"
)
if row["cs"].strip().upper() != "LOW":
issues.append(f"SPI frame {frame}: CS was not active")
for issue in issues:
print(issue)
print(f"Summary: {len(issues)} issue(s)")
return 1 if issues else 0
def main() -> None:
if len(sys.argv) != 2:
raise SystemExit("Usage: python BusTraceInspector.py <decoded.csv>")
csv_path = Path(sys.argv[1])
if not csv_path.is_file():
raise SystemExit(f"File not found: {csv_path}")
raise SystemExit(analyze(csv_path))
if __name__ == "__main__":
main()运行命令:
python BusTraceInspector.py decoded.csv预期输出:
I2C frame 1: 0x78 is not a 7-bit address; try 0x3C
I2C frame 1: NACK detected
SPI frame 3: decoded mode 3, expected mode 0
Summary: 3 issue(s)脚本以非零退出码表示发现问题,便于接入自动化测试。导出真实数据时,只需把分析仪字段映射为相同列名;若软件导出的列不同,可在脚本读取处调整键名,并保留原始捕获文件作为复核依据。
排错要点与练习
排查应遵循“电气层先于协议层”的顺序:先确认地线、电压、空闲电平和边沿质量,再检查地址、模式、位序和命令。不要一开始就改动多个参数,否则即使波形恢复,也难以知道真正原因。每次只改变一个变量,并保存一份故障波形与一份修复后的对照波形。
I2C 的 SDA 在 SCL 高电平期间应保持稳定,只有 START 与 STOP 允许例外。若上升沿明显缓慢,可降低上拉电阻阻值或总线速率,并检查总线电容。SPI 应在器件规定的边沿采样;若解码器显示正确但器件仍无响应,还要检查主控实际配置与解码器配置是否一致。
练习一:修改 decoded.csv,加入一帧地址 0x50 且 ACK 正常的 I2C 数据,再确认脚本不为该帧报告问题。验收条件是问题总数仍为 3。
练习二:扩展脚本,检测 SPI 接收字段是否全为 FF。输入第三帧 rx 为 FF FF FF 时,应新增一条“从设备可能未驱动 MISO”的诊断,并将问题总数增加到 4。
本课总结
- 逻辑分析应先确认接地、门限、采样率和信号质量,再解读协议字段
- I2C 重点检查 7 位地址与 ACK/NACK,SPI 重点检查模式、片选边界和 MISO 返回值
- 保存故障与修复后的波形对照,并用脚本检查导出数据,可提高排查的可重复性
下一课预告
完成 I2C 与 SPI 的基础驱动和波形排查后,下一阶段将把外设通信、定时器、DMA 与中断结合起来,构建更完整的传感采集与显示系统。