单片机与物联网 / 系统课时

使用逻辑分析仪排查总线

使用逻辑分析仪排查总线

当 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 与 SPI 故障波形对比

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:

text
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,并输出明确的故障原因。

python
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()

运行命令:

bash
python BusTraceInspector.py decoded.csv

预期输出:

text
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 与中断结合起来,构建更完整的传感采集与显示系统。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用逻辑分析仪排查总线

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通