如果你做过带 USB-C 充电口的嵌入式设备大概率遇到过这种场景开发板明明通过 CC 引脚请求了 9V 电压可适配器就是死守 5V 输出。用万用表量只能看到电压没升上去却看不到协议层到底发生了什么。想用逻辑分析仪抓 CC 线上的通信又发现 PD 报文是 BMC 编码普通逻辑分析仪抓出来一堆毛刺解析起来相当痛苦。这时你会明白调试 USB-C Power DeliveryPD最缺的不是电压表而是一个能同时“看协议”和“主动请求电压”的工具。最近在 Hacker News 上看到有人发布了一个开源项目把 USB-C PD 分析仪和可编程 Sink 做到了同一块板子上。从标题来看这个设计把“被动观察”和“主动请求”合二为一我认为这是目前 DIY 调试 PD 电源最值得关注的方向之一。本文会从实际开发痛点出发讲清楚 PD 协议中的 Sink/Source 关系、可编程 Sink 的原理、这类分析仪的设计思路、完整流程和常见坑。读完你不仅能理解 PD 调试的完整链路还能直接上手这类工具把它用于日常研发。1. 这篇文章真正要解决的问题先给结论这类开源项目的核心价值不是帮你把 CC 线抓下来而是把 PD 协议调试的门槛从“示波器加协议解析”降到了“一个 USB 串口”。在实际开发中PD 调试有三个真实痛点。第一CC 线上的通信不是普通 PWM而是 BMC 编码的差分信号。逻辑分析仪和示波器能触发但能直接解析 PD 报文的工具很少很多团队是抓了波形再手动对照协议文档查 bit。这个流程非常耗时而且容易错。第二传统的 PD 诱骗器只能“要电压”不能“看报文”。你可以用诱骗器把充电器骗到 20V但它为什么没协议 Accept、是对手的 PDO 不支持还是你的 Request 字段写错了诱骗器不会告诉你。等于你只知道结果不知道过程。第三USB-C 线缆里还有 E-Marker 芯片、SBU 引脚、VCONN这些和 PD 协商一起工作。很多时候电压没上来的原因根本不在 PD 协议本身而是线缆 E-Marker 没识别到或者 VCONN 没供电。没有协议日志这类问题只能靠猜。所以这篇文章要解决的问题很具体什么样的人需要一台 USB-C PD 分析仪它和可编程 Sink 合在一起意味着什么以及在实际工程中怎么用它排查问题。如果你是下面几类人这类工具尤其值得关注做 Type-C 接口嵌入式设备的固件工程师比如快充协议开发、电池管理、TWS 耳机充电仓。做电源适配器、旅行充电器、车载充电器的硬件或测试工程师。想用 PD 电源给 DIY 项目供电的玩家比如便携屏、掌机、桌面小主机。需要验证线缆 E-Marker 和 PD 协议兼容性的质量工程师。如果你只是拿手机充电那这个工具对你没有意义。它的目标用户是那些需要和设备“对话”的人。2. USB-C PD 基础概念Sink、Source、CC 与 PDO在展开分析仪之前先把 PD 协议里的几个核心概念讲清楚。这里不追协议文档只挑能理解后面所有操作的部分。2.1 Source 与 SinkUSB-C PD 世界里只有两个角色Source供电方比如充电器、电源适配器。Sink用电方比如手机、开发板、便携屏。传统 USB-A 时代电压固定 5V没有协商概念。USB-C PD 改变了这一点Sink 可以通过 CC 引脚向 Source 请求不同的电压和电流Source 可以选择接受或拒绝。可编程 Sink 的意思是你可以自己扮演一个“可以配置的用电方”告诉它“我要 9V 3A”然后它用 CC 引脚向 Source 发出请求。如果 Source 支持这个电压就会切换输出。2.2 CC 引脚与 Rp/RdUSB-C 接口里有两个 CC 引脚全称是 Configuration Channel配置通道。Source 端会在 CC 引脚上拉一个 Rp 电阻。Sink 端会在 CC 引脚上拉一个 Rd 电阻。当 Type-C 插入时Source 通过检测 CC 引脚上的电压判断对方是 Sink 还是另外一个设备同时能识别线缆插入方向和电流能力。注意CC 引脚既承担连接检测也承担 PD 协议通信。在 PD 模式下双方通过 CC 线进行半双工通信物理编码方式是 BMCBiphase Mark Coding通信速率在 USB PD 3.0 后最高可达约 1Mbps。因为通信和检测都在这两个引脚上所以调试 PD 问题必须同时关注“电气连接”和“协议报文”这也是为什么分析仪必须接入 CC 线而不是像普通电流表那样串在 VBUS 上。2.3 PDO、RDO 与协商过程PD 协商的核心数据结构是 PDOPower Data Object。Source 会广播自己支持的电压电流档位每个档位就是一个 PDO。常见的桌面充电器会广播类似下面的档位PDO 类型电压最大电流Fixed 5V5V3AFixed 9V9V3AFixed 15V15V3AFixed 20V20V5ASink 看到这些 PDO 后会选择一个档位提交一个 RDORequest Data Object请求 Source 切换到这个档位。协商过程大致是Source 通过 Source_Capabilities 消息广播 PDO 列表。Sink 解析 PDO选择一个可用档位。Sink 发送 Request 消息包含目标 RDO。Source 回 Accept。Source 切换输出回 PS_RDY。双方进入稳定的 powered 状态。看到这里你就明白PD 调试的本质就是在跟踪这一串消息的发送和应答。如果 Request 发出后没有 Accept问题大概率出在 PDO 选择逻辑如果有 Accept 但电压没上来问题更可能在 VBUS 切换或线缆上。2.4 PPS 与 APDOUSB PD 3.0 之后引入了 PPSProgrammable Power Supply属于 APDOAugmented PDO的一种。PPS 允许 Sink 在一个连续电压范围内精确请求电压比如以 20mV 步进从 3.3V 调到 21V。PPS 对充电方案影响很大但它对调试也提出了更高要求。普通 PDO 是固定档位PPS 是连续区间。分析可编程 Sink 是否支持 PPS 请求、请求的电压电流是否落在 Source 的 APDO 范围内是分析仪要重点验证的场景。3. 为什么要把“分析仪”和“可编程 Sink”放在一起传统方案里协议分析和 PD 诱骗通常拆成两个工具。逻辑分析仪负责抓波形但需要你懂协议解析PD 诱骗器负责要电压但看不到报文。实际开发时你经常需要一边诱骗、一边抓日志这就得两台设备同时接入引线复杂还容易因为接线顺序导致协议握手失败。从项目标题看这个开源项目的关键设计判断是把分析仪和可编程 Sink 放到同一个硬件里让设备既能被动监听又能主动参与协商。这意味着什么呢第一单点接入。它只需要串联在 Source 和真正的负载之间不需要额外拆线去夹 CC。分析仪的 CC 接口和 Sink 电路共享同一个物理连接接线简单减少了接触不良带来的干扰。第二同步触发。因为分析功能就在 Sink 内部它能拿到完整的“我请求了什么”和“对方回应了什么”不需要外部触发线和时间同步。对协议调试来说这非常重要。第三可编程能力。传统诱骗器是按下按钮选择 9V、12V、20V可编程 Sink 可以通过配置软件、串口命令或 Web 界面动态指定电压、电流甚至可以模拟复杂的 PPS 请求。这让自动化测试成为可能比如连续切换不同电压检验 Source 是否每次都正确响应。第四便于二次开发。开源意味着你拿到的不只是成品而是完整的 BOM、固件和上位机源码。你可以把它改造成产品测试治具的一部分或者集成到自己项目的自动化脚本里。所以这类项目真正的亮点不是“又多了一个分析工具”而是它把 PD 调试中原本割裂的“发起请求”和“观察请求结果”统一到了同一个工作流里。4. 这类开源分析仪的软硬件架构设计虽然我们还没看到项目仓库里具体的原理图但从同类开源 USB-C PD 分析项目来看硬件架构通常由几个核心部分组成。下面以这一类项目的常见设计思路来拆解具体器件选型和引脚定义请以项目仓库为准。4.1 硬件层MCU PD PHY 通道隔离PD 分析的核心是处理 CC 线上的 BMC 信号。这个任务通常有两种做法一种是通过专用 PD PHY 芯片比如 STUSB4500、FUSB302、TPS65987 之类的器件。这些芯片内部集成了 BMC 编解码、CRC、重传等底层处理MCU 通过 I2C 或 SPI 与 PHY 通信拿到的是已经解析好的协议消息。另一种是用带有比较器和定时器的高性能 MCU直接采样 CC 引脚电平在软件里完成 BMC 解码。这种做法的优点是成本低、可控性强缺点是协议兼容性和稳定性需要大量调试。从“open analyzer”这个定位来看更稳妥的设计是 MCU PD PHY 的组合。PD PHY 负责物理层MCU 负责协议状态机和用户逻辑。在电源通道上分析仪一般会串联一个高边电流采样电阻同时用 ADC 采集 VBUS 电压。这样设备不仅能看协议报文还能把电压、电流、功率和协议事件关联起来。比如你请求了 20V 3A但实际电压掉到 19.2V日志里能同时看到“PS_RDY 已收到”和“VBUS 电压偏低”排查起来就快很多。4.2 软件层协议解析 日志导出 配置接口软件部分通常分三块第一块是协议解析。它把 PD PHY 拿到的原始消息解析成可读的协议文本比如[12.345s] Rx Source_Capabilities: PDO1: 5V/3A Fixed PDO2: 9V/3A Fixed PDO3: 15V/3A Fixed PDO4: 20V/5A Fixed [12.351s] Tx Request: PDO2, 9V/3A [12.360s] Rx Accept [12.375s] Rx PS_RDY这段日志就是整个 PD 调试中最有价值的输出。第二块是日志导出。调试工具最常见的用法是输出 CSV、JSON 或 pcap 格式方便用脚本二次分析。后面我会给出一个 Python 解析示例。第三块是配置接口。因为它是可编程 Sink你需要在硬件上配置目标电压、电流、允许的 PDO 范围等。常见做法是板上按钮加 OLED或者通过 USB 串口提供命令行再进一步就是 Web 配置页面。4.3 工作模式监听模式、Sink 模式、旁路模式分析仪和 Sink 二合一通常会提供几种工作模式监听模式只观察 CC 线上的协议报文不发送 Request。适合分析现有设备与充电器之间的协商。Sink 模式主动按配置请求电压适合诱骗和电源测试。旁路模式VBUS 直接连通只采集电压电流数据不影响正常供电。不同模式决定了 CC 线上的电路连接方式。在 Sink 模式下设备需要接入 Rd 电阻并在 MCU 中完成 Sink 状态机在监听模式下需要高阻输入尽量减少对 CC 信号的影响。这是一个硬件设计上的权衡点也是开源项目里很值得看的部分。5. 环境准备与前置条件在使用这类开源项目之前你需要做好工具链和硬件准备。以下环境要求以常见开源项目为参考具体版本请以项目 README 为准。5.1 硬件准备一块分析仪板子。可以是作者打样好的成品也可以自己按开源文件打板。USB-C 公头或母座转接线用于连接 Source。USB-C 线缆用于连接待测 Sink 设备。USB 转串口适配器部分板载了串口芯片直接用 USB-C 数据线连电脑即可。一个已知正常的 PD 电源适配器作为基准 Source。调试 PD 设备时手边最好准备几根不同规格的线缆因为 E-Marker 芯片的有无会影响 5A 电流协商。5.2 软件准备串口终端工具比如 Windows 上的 PuTTYLinux 和 macOS 上的 minicom、screen或者 Python 的 pyserial。Python 3.8 或更高版本用于跑日志分析脚本。如果需要编译固件通常还需要 ARM GCC 工具链、Make 或 CMake以及芯片厂商的 SDK。这部分依赖项目使用的 MCU 型号不要照搬以仓库文档为准。如果没有编译环境也可以先用串口工具连接出厂固件。很多开源硬件项目会直接烧写好固件用户不需要重新编译就能完成大部分调试工作。6. 完整示例配置可编程 Sink 并进行 PD 协商下面用一个偏软件层面的完整示例演示从“配置可编程 Sink”到“分析协商结果”的整个流程。考虑到不同硬件的命令不一样这里重点演示通用逻辑和思路。6.1 配置可编程 Sink 的目标电压假设板子通过串口提供一个简单的命令接口。示例配置如下注意字段名以实际固件为准# 文件路径sink_config.yaml sink: mode: pd # pd 或 pps preferred_voltage: 12.0 # 首选请求电压单位 V max_current: 3.0 # 最大请求电流单位 A accept_pdo: - voltage: 5.0 current: 3.0 - voltage: 9.0 current: 3.0 - voltage: 12.0 current: 3.0 - voltage: 15.0 current: 3.0 timeout_ms: 500 # 设置超时超过则回退 5V这个配置表达的意思是优先请求 12V 3A但如果 Source 不支持 12V就按 accept_pdo 列表里的顺序选择可用档位。6.2 使用串口连接并启动 Sink 模式在 Linux 上用 screen 连接串口dmesg | grep ttyUSB screen /dev/ttyUSB0 115200进入命令行后先看是否有帮助菜单常见命令可能类似 sink config load sink set voltage 12.0 current 3.0 sink start log level info启动后终端会出现类似下面的输出[INF] [PD] CC1 connected, Rp3A [INF] [PD] Rx Source_Capabilities: 5V/3A, 9V/3A, 12V/3A, 15V/3A, 20V/5A [INF] [PD] Tx Request: PDO3 (12V/3A) [INF] [PD] Rx Accept [INF] [PD] Rx PS_RDY [INF] [PWR] VBUS12.18V, IBUS0.42A, PWR5.12W当看到VBUS12.18V时说明 Source 已经切换到 12VSink 请求成功。如果卡在Tx Request后面迟迟没有Rx Accept问题通常出在 PDO 选择或者 Source 不支持该电压。6.3 用 Python 导出并分析协商日志很多开源分析仪支持把日志导出为 CSV。假设导出的文件为pd_log.csv字段包含时间、事件、电压、电流import csv import sys THRESHOLD_W 60.0 def main(path: str): with open(path, newline) as f: reader csv.DictReader(f) for row in reader: event row.get(event, ) voltage float(row.get(voltage, 0)) current float(row.get(current, 0)) power voltage * current if event PS_RDY: print(f[PS_RDY] time{row[time]} v{voltage:.2f}V i{current:.2f}A p{power:.1f}W) if power THRESHOLD_W: print(f[WARN] power {power:.1f}W exceeds threshold, check PDO/APDO) if __name__ __main__: main(sys.argv[1])运行命令python3 analyze_pd_log.py pd_log.csv这个脚本做的事情很简单从日志里找出PS_RDY事件计算该时刻的功率并报告超过阈值的记录。你会看到类似输出[PS_RDY] time12.375 v12.18V i0.42A p5.1W [PS_RDY] time30.102 v20.05V i3.01A p60.3W [WARN] power 60.3W exceeds threshold, check PDO/APDO在真实项目中你可以在同样的脚本基础上加入“电压跌落超过 5% 就告警”“请求 20V 但回读 5V 就自动重试”等逻辑把它变成一台简单的 PD 自动化测试仪。7. 运行结果与效果验证看到日志只是第一步还要能判断结果是否正常。7.1 正常协商的标志一次成功的 PD 协商日志里通常按顺序出现三个关键事件Rx Source_CapabilitiesSink 收到了 Source 发的能力列表。Tx Request和Rx AcceptSource 确认了请求。Rx PS_RDYSource 完成了电压切换VBUS 就绪。如果这三个事件都出现且 VBUS 电压和请求目标一致可以判定基本流程正常。7.2 异常协商的标志下面这些日志状态属于异常需要继续排查日志表现可能原因下一步查看只有 Source_Capabilities没有 RequestSink 没找到可用 PDO或配置电压超出 Source 范围核对 accept_pdo 列表Request 后无 AcceptSource 不接受该 PDO降低请求电压或用 PPS 范围重新尝试出现 RejectSource 明确拒绝请求查看 Source 的能力列表PS_RDY 后 VBUS 电压不对线缆电阻过大或 Source 切换异常检查 VBUS 电压采样和线缆质量日志完全空白CC 线没接对或没有触发连接检测检查 CC1/CC2 接线和 Rp/Rd 配置7.3 失败时的第一步排查当遇到问题时不要急着改配置。先确认三件事设备是否真的进入了 Sink 模式CC 引脚上有没有正确的 Rd 下拉电阻。Source 是否真的广播了 PDO可以用另一个已知好的诱骗器交叉验证。日志是否在Rx Source_Capabilities之前就断了如果在这里断更多是物理层问题比如接线、供电、电平转换。按照这个顺序排查能覆盖绝大多数 PD 协商失败场景。8. 常见问题与排查思路结合 PD 调试中常见的坑整理了以下排查表。问题现象可能原因排查方式解决方案Sink 请求 12V电源始终输出 5VSource 不支持该 PDO或 PDO 类型不匹配查看 Source_Capabilities 日志把请求电压改成 Source 广播的档位能看到部分日志但报文不完整CC 线接触不良或线缆质量差更换线缆检查连接器使用通过认证的 USB-C 线缆通电后无任何日志板子没有正常供电或串口引脚接错检查电源指示灯、串口回环测试确认串口 TX/RX 接线正确电压能切换但电流上不去线缆 E-Marker 不支持高电流换 5A E-Marker 线缆使用支持 5A 的线缆日志出现 CRC 错误电磁干扰或 CC 线受到干扰缩短线缆减少电源噪声增加 CC 线滤波改善接地PPS 请求被拒绝请求电压超出 APDO 范围查看 Source 的 APDO 范围将请求值调整到 APDO 区间内分析仪接入后影响协商监听电路负载过大检查 CC 输入阻抗切换到监听模式关闭 Sink 状态机这里特别提醒PD 调试里“线缆问题”被低估的严重程度远超想象。很多情况下协议报文全对但 VBUS 电压在重负载下掉落 0.5V 以上导致设备欠压复位。这类问题不会体现在协议层但会体现在分析仪的电压采样数据里所以电压电流采样功能同样重要。9. 最佳实践与工程建议9.1 电气安全边界可编程 Sink 可以把电压诱骗到 20V、28V 甚至 48V取决于 Source 是否支持 EPR。调试时务必注意确认负载能在当前电压下安全工作不要把 5V 的负载接到 20V 输出上。不要超过线缆的额定电流。普通 3A 线缆硬跑 5A 会发热严重的会烧毁连接器。手边准备一个万用表或电子负载在真实负载接入前先用分析仪验证电压和电流上限。如果设备用于自动化脚本配置里也要像写软件一样设置“最大允许电压”和“最大允许电流”的硬边界超过就立刻断开请求。9.2 配置管理可编程 Sink 的配置应该纳入版本管理和固件代码一起提交。下面是一个推荐的最小配置结构./pd_test ├── configs │ ├── charger_a_12v.yaml │ ├── charger_a_pps.yaml │ └── charger_b_20v.yaml ├── scripts │ ├── analyze_pd_log.py │ └── run_regression.sh └── logs └── 20250101_charger_a.csv这样做的好处是每次测试结果都能回溯到具体配置。PD 调试最怕的就是“刚才用 9V 测的时候是好的为什么现在 20V 不行了”——如果配置可追溯这类问题能立刻定位。9.3 自动化回归测试如果你的产品需要兼容多种充电器可以考虑把分析仪接入自动化测试流程。基本思路是遍历所有配置文件和测试用例。对每个 Source执行 Sink 请求。检查日志中是否出现 Accept 和 PS_RDY。检查 VBUS 电压是否在容差范围内。把结果汇总成测试报告。这样一来分析仪就不再只是一个调试工具而是变成了 PD 兼容性测试治具。9.4 日志规范在实际项目中日志字段要保持稳定。推荐至少包含以下字段时间戳精确到毫秒或微秒。事件类型比如 Rx/Tx/Error/StateChange。消息名比如 Source_Capabilities、Request、Accept、PS_RDY。关键参数比如请求电压、电流、PDO 原始值。VBUS 电压和电流采样值。CC 线状态是 CC1 还是 CC2 连接。稳定的日志格式能让你写脚本分析时省很多事。9.5 对开源项目的期望玩这类开源项目时建议先确认项目仓库是否包含以下内容否则后续使用会遇到阻碍原理图和 PCB 设计文件。固件源码尤其是 PD 状态机部分。串口协议和命令文档。日志解析脚本或上位机工具。已知问题清单和更新记录。如果一个项目这五样都齐全它不仅是玩具更是一套可以复用的开发平台。10. 总结与后续学习方向回到最初的问题调试 USB-C PD 时最缺的是什么缺的是一双能看到协议消息的“眼睛”以及一个能主动参与协商的“手”。这个开源项目把两者做进了同一块板子从工具形态上给了开发者一个更高效的调试入口。从这个项目可以延伸出去学习的内容还有很多如果对协议层感兴趣可以系统看一遍 USB PD 规范里的状态机理解 Sink 端每个事件处理的含义。如果对硬件感兴趣可以研究 PD PHY 的选型和 CC 电路设计搞清楚为什么 CC 输入阻抗会影响协议稳定性。如果对测试自动化感兴趣可以把日志分析脚本扩展成更完整的测试框架。我的建议是拿到这类项目后不要先急着看代码。先拿它连接一个你手头最熟悉的充电器抓一次完整的 PD 协商日志亲眼看一次Request - Accept - PS_RDY的时序。看完之后你对 USB-C 供电、Sink 设计、协议兼容性的理解会完全不一样。建议收藏备用。