I2C 自动化采集与波形分析

概览

现有资料覆盖三种不同的自动化工作：测试平台管理测试计划和示波器流程、拓扑采集器经 SSH 汇总 BMC I²C adapter/设备信息、波形工具从 SCL/SDA 记录提取协议及时序/SI 指标。它们输入、风险和输出不同，不能互相替代；应按“计划配置—只读拓扑确认—波形采集—离线评估—人工复核”串成证据链。

核心要点

1. 测试计划先于脚本执行。 明确测试点、总线链路、首尾节点、测试指标、仪器设置和波形归档位置。地址格式存在 7 位与 8 位差别，填写时按平台字段语义换算并确认，不能凭提示颜色直接判错。
2. 拓扑采集默认先读后探测。 采集器通过 SSH 读取 i2cdetect -l、sysfs 和相关状态，结合 adapter 父子关系、MUX 注册设备和设备地址建立拓扑。主动 i2cdetect 与 MUX 通道扫描是可选操作，可能影响总线，应在了解设备和总线状态后启用。
3. 采集拓扑不等于原理图事实。 Linux bus 编号和 sysfs 信息是运行时证据；应与原理图、设备树和固件配置交叉核对。工具不负责识别器件型号，也不替代板级设计资料。
4. 波形批处理要显式配对。 每组 SCL/SDA 文件、速率模式、VDD、主机视角、地址和限值都应明确指定。报告保留逐波形结论、指标数据、协议字段及问题图，便于回溯每项判定。
5. 将规范与工程观察分开。 波形工具需标明采集覆盖、规范时序和 SI 观察。数据缺失、事务截断、器件门限未配置应保留为“不完整/未配置”，不默认通过。
6. 脚本输出必须可复核。 拓扑报告可含 HTML/JSON，批量波形评估输出 CSV 与问题图；采集日期、输入文件、限值来源和运行条件应随结果保存。

工作流

flowchart LR
  PLAN[测试计划与仪器配置] --> TOPO[只读拓扑核对]
  TOPO --> CAP[采集 SCL / SDA 波形]
  CAP --> PAIR[显式配对与模式/限值配置]
  PAIR --> ASSESS[协议、SPEC、SI 分层评估]
  ASSESS --> REVIEW[人工复核并归档]

风险边界

• 生产板卡上的主动 I²C 扫描、MUX 写操作或 SMB 网络设置变化，必须根据板卡状态和授权流程执行。
• SSH 密钥、口令、访问地址和设备标识应保存在受控配置中，不得写入公开笔记、日志或版本库。
• 报告目录不可写、远程权限不足、波形配对不明或测试条件缺失时，应停止给出确定性结论并记录阻塞项。

复核依据

具体采集步骤、测试门限和脚本行为应以目标平台、器件手册和经批准的测试计划为准。自动化输出用于辅助复核，不替代人工确认。