1. 项目概述Sitron Labs FUSB302 Arduino Library 是一款面向嵌入式开发者的专业级 USB Type-C 控制器驱动库专为 onsemi原安森美FUSB302 系列可编程 USB Type-C 端口控制器设计。该库并非简单封装 I2C 读写操作而是完整实现了 USB Type-C 物理层状态机、CC 引脚电平检测逻辑、VBUS 电压测量校准链路以及 USB Power DeliveryPD协议栈的底层硬件协同控制机制。其核心价值在于将 FUSB302 这颗高度集成的专用 ASIC 转化为 Arduino 生态中可直接调用的“即插即用”功能模块使开发者无需深入理解 USB Type-C 规范第 1.4 版本中关于角色协商DRP、供电能力通告Source Capabilities、电压档位请求Request Message等复杂时序即可构建具备完整 USB-C 插拔感知、方向识别、VBUS 监控与 PD 协商能力的终端设备。FUSB302 本身是一颗采用 QFN-20 封装的专用 SoC内部集成了 10-bit ADC、可编程 MDAC乘法数模转换器、双通道 CC 比较器、PD 协议引擎含 CRC 生成/校验、SOP 帧解析、FIFO 缓冲区、I2C 从机接口及电源管理单元。它不运行固件所有行为均由寄存器配置驱动——这正是 Sitron Labs 库的设计哲学以寄存器级精确控制为根基向上提供语义清晰的 API 接口。库明确区分 FUSB302B出厂默认配置为 Sink 角色CC 引脚内置 Rd5.1kΩ与 FUSB302T出厂默认配置为 Source 角色CC 引脚内置 Rp56kΩ并在初始化阶段通过detect()函数自动识别芯片型号确保后续cc_pull_down()或cc_pull_up()配置的物理意义与硬件实际一致。在工程实践中该库已成功应用于多个关键场景便携式 USB-C 供电测试仪实时显示 VBUS 电压、CC 状态、PD 协商结果、双角色移动电源根据插入设备自动切换 Source/Sink 模式、工业 HUB 的端口状态监控模块多路 FUSB302 并行管理以及嵌入式设备的 USB-C 充电管理子系统配合电池充电 IC 实现动态功率分配。其稳定性已在 STM32F407 Arduino Core、ESP32-WROVER-B PlatformIO、Raspberry Pi Pico W通过 TinyUSB Arduino 核心等异构平台上得到验证。1.1 硬件架构与信号流解析FUSB302 的硬件连接并非简单的 I2C 外设挂载而是一个涉及模拟前端、数字逻辑与时序协同的精密系统。其关键信号链路如下CC1/CC2 引脚直接连接 USB-C 连接器对应触点内部通过可编程开关矩阵接入比较器。比较器参考电压由 MDAC 产生精度达 12.5mV/LSB。当设备作为 Sink 时需配置内部 Rd5.1kΩ符合 USB-IF 规范要求此时 CC 线被拉低至约 0.4V作为 Source 时则配置 Rp56kΩ默认或 Rp10kΩ广告 1.5A或 Rp22kΩ广告 3.0A此时 CC 线被拉高至 VCONN5V或 VDD3.3V电平。cc_measure()函数的本质是读取STATUS0寄存器地址 0x01中的CC1_STAT和CC2_STAT位域该位域直接反映比较器输出状态而非 ADC 采样值。VBUS 引脚接入 USB-C 连接器的 VBUS 线最高耐压 22V。内部通过分压电阻网络典型比例 1:4.5接入 ADC 输入vbus_measure()函数执行流程为先向CONTROL0寄存器地址 0x08写入ADC_EN1启动转换延时 100μs 等待稳定再读取ADC_DATA_H0x0A与ADC_DATA_L0x0B寄存器组合成 10-bit 结果最后通过预存的校准系数存储于DEVICE_ID寄存器区域进行线性补偿最终输出浮点电压值。此过程绕过了 MCU 的 ADC利用 FUSB302 内置资源实现高精度、低干扰测量。INT 引脚可选开漏输出连接 MCU 任意 GPIO。当发生 CC 状态变化、VBUS 过压/欠压、PD 消息到达等事件时FUSB302 自动拉低此引脚。库中虽未强制要求使用中断但pd_message_receive()在轮询模式下会持续查询INT_STATUS寄存器0x02若开发者启用中断则可在 ISR 中调用pd_rx_flush()清空 FIFO避免消息丢失。I2C 接口标准 100kHz/400kHz 模式地址固定为 0x22FUSB302B或可通过SWRESET引脚电平上拉为 0x22下拉为 0x23配置FUSB302T。必须使用 4.7kΩ 上拉电阻至 VDD3.3V 或 5.0V且 VDD 必须与 MCU I2C 电平兼容。库内部所有Wire操作均采用Wire.beginTransmission()→Wire.write()→Wire.endTransmission()标准流程并对每次传输返回值进行严格校验错误码映射关系见表 1。错误码含义工程处理建议-1I2C 传输失败NACK检查接线、上拉电阻、地址是否正确-2寄存器读取超时检查 FUSB302 是否上电、复位是否完成-3设备 ID 不匹配非 FUSB302确认芯片型号、焊接质量、I2C 地址-4PD FIFO 溢出增加pd_rx_flush()调用频率2. 核心功能实现原理2.1 USB Type-C 电缆方向检测的硬件协同机制USB-C 电缆方向检测并非软件算法推导而是 FUSB302 硬件状态机的直接输出。其原理基于 USB-C 规范定义的“分时复用”特性当一个设备作为 Sink如手机插入另一个 Source如充电器时Source 的 CC 引脚Rp会通过电缆内的 CC 线连接到 Sink 的 CC 引脚Rd形成分压电路。FUSB302 内部的两个独立比较器分别监测 CC1 和 CC2 对地电压并将结果编码为 2-bit 状态字USB_TYPEC_CC_STATUS_OPEN、USB_TYPEC_CC_STATUS_RP_DEF等。cc_measure()函数读取的是STATUS0寄存器的原始位域其状态真值表如下CC1 状态CC2 状态电缆方向物理解释Rp_DEFOPENNormalCC1 被拉低Sink Rd 接通CC2 悬空OPENRp_DEFFlippedCC2 被拉低Sink Rd 接通CC1 悬空OPENOPENNone无设备连接或非标准电缆Rp_DEFRp_DEFInvalid短路故障需触发保护逻辑值得注意的是cc_orientation_set()并非改变硬件连接而是向SW_CTRL寄存器0x07写入ORIENT位告知 FUSB302 当前应使用的 CC 通道CC1或CC2作为主通信路径。这对 PD 协议至关重要SOPStart of Packet帧必须通过当前激活的 CC 通道发送。若方向设置错误PD 消息将无法被对端正确接收。2.2 VBUS 电压测量的校准与精度保障FUSB302 的 VBUS 测量精度依赖于两个关键环节内部 ADC 的线性度与外部分压网络的匹配度。库中vbus_measure()的实现包含完整的校准流程int fusb302::vbus_measure(float voltage) { // 1. 启动 ADC 转换 uint8_t ctrl0_val 0x01; // ADC_EN1, 其他位清零 if (register_write(FUSB302_REG_CONTROL0, ctrl0_val) ! 0) return -2; // 2. 等待转换完成最小 100μs delayMicroseconds(100); // 3. 读取 ADC 原始值10-bit uint8_t adc_data[2]; if (register_read(FUSB302_REG_ADC_DATA_H, adc_data, 2) ! 0) return -2; uint16_t raw_adc ((uint16_t)adc_data[0] 2) | (adc_data[1] 6); // 4. 应用校准系数存储于 DEVICE_ID 寄存器需在 setup() 中读取 // 公式Voltage (raw_adc * VREF / 1024) * (R1R2)/R2 * K_CAL // 其中 VREF1.25V, (R1R2)/R2 ≈ 5.5典型分压比 voltage (float)raw_adc * 0.001220703125f * 5.5f * cal_coefficient; return 0; }校准系数cal_coefficient在setup()中通过读取DEVICE_ID寄存器0x00的特定字节获得该值由 onsemi 出厂时激光修调写入保证单颗芯片的绝对精度优于 ±2%。若应用对精度要求极高如计量级设备可外接高精度分压电阻如 Vishay Z-Foil 系列并重新标定cal_coefficient。2.3 USB Power Delivery 协议栈的硬件加速实现FUSB302 的 PD 引擎是真正的硬件协处理器其工作完全独立于 MCU。库中 PD 相关 API 的本质是配置该引擎的运行参数与交互接口pd_reset_logic()向RESET寄存器0x06写入PD_RESET1复位 PD 协议状态机清空所有 FIFO 与寄存器为新会话做准备。pd_autogoodcrc_set(true)设置CONTROL3寄存器0x0D的AUTO_GCRC1使 FUSB302 在收到有效 SOP 帧后自动在硬件层面生成并发送 GoodCRC 包MCU 无需参与 CRC 计算降低 CPU 占用率。pd_message_receive()轮询INT_STATUS寄存器0x02的RX_INT1位若置位则从RX_DATA寄存器组0x10-0x2F按顺序读取 28 字节SOP 头 2B 最多 7 个 DO 4B each CRC 4B并解析为usb_pd_message结构体。其中sop_type由RX_HEADER寄存器0x10的SOP_TYPE位域决定。PD 消息结构体usb_pd_message的设计严格遵循 USB PD 3.0 规范struct usb_pd_message { enum usb_pd_sop_type sop_type; // SOP (0x00), SOP (0x01), SOP (0x02) uint16_t header; // Bit15: DataRole, Bit14: PowerRole, // Bit13: SpecRev, Bit12-10: NumDataObjects, // Bit9-0: MessageType uint32_t objects[7]; // Data Objects, e.g., RDO, PDO, BIST uint8_t object_count; // 实际有效的 DO 数量0-7 };例如解析一个Source_Capabilities消息时header的MessageType0x01object_count表示 PDO 数量objects[0]即第一个 PDO其 bit31:bit30 表示电压类型Fixed/Variable/Batterybit29:bit20 为电压值单位 50mVbit19:bit10 为最大电流单位 10mA。3. API 详解与工程化使用指南3.1 初始化与基础控制 APIAPI 函数参数说明返回值工程要点setup(TwoWire i2c_library, uint8_t i2c_address)i2c_library: ArduinoWire实例i2c_address: I2C 地址0x22 或 0x230 成功-1 I2C 失败-2 寄存器访问失败必须在Wire.begin()之后调用地址错误会导致detect()失败detect(void)无true检测成功false失败读取DEVICE_ID寄存器0x00校验值是否为0x01FUSB302B或0x02FUSB302Treset(void)无0 成功-1 失败向RESET寄存器0x06写入SW_RESET1硬件复位整个芯片power_set(bool on)on:true上电false断电0 成功-1 失败控制CONTROL0寄存器0x08的POWER1/0断电可降低静态功耗至 10μA3.2 CC 引脚配置与测量 APIAPI 函数参数说明返回值工程要点cc_pull_down(void)无0 成功-1 失败设置SW_CTRL0x07的CC1_PU0,CC2_PU0,CC1_PD1,CC2_PD1适用于 Sink 设备cc_pull_up(enum usb_typec_cc_status status)status:USB_TYPEC_CC_STATUS_RP_DEF56kΩ,USB_TYPEC_CC_STATUS_RP_1_510kΩ,USB_TYPEC_CC_STATUS_RP_3_022kΩ0 成功-1 失败通过SW_CTRL的RP_VAL位域配置Source 设备必须正确设置以通告供电能力cc_measure(enum usb_typec_cc_status cc1, enum usb_typec_cc_status cc2)cc1/cc2: 输出参数接收状态枚举0 成功-1 失败读取STATUS00x01的CC1_STATbit7:6与CC2_STATbit5:4cc_orientation_set(enum usb_typec_cc_orientation orientation)orientation:USB_TYPEC_CC_ORIENTATION_NORMAL或REVERSE0 成功-1 失败设置SW_CTRL0x07的ORIENT位决定 PD 通信使用的 CC 通道3.3 VBUS 与 PD 协议 APIAPI 函数参数说明返回值工程要点vbus_measure(float voltage)voltage: 输出参数单位 V0 成功-1 失败-2 ADC 超时内部执行 ADC 启动、延时、读取、校准全流程建议每 500ms 读取一次pd_reset_logic(void)无0 成功-1 失败复位 PD 状态机必须在 PD 通信前调用pd_autogoodcrc_set(bool enabled)enabled:true启用自动 GoodCRC0 成功-1 失败启用后 MCU 只需关注消息内容无需处理 CRCpd_autoretry_set(int retries)retries: 0-3重试次数0 成功-1 失败设置CONTROL30x0D的TX_RETRY位域应对噪声环境pd_message_receive(struct usb_pd_message msg)msg: 输出参数1 收到消息0 无消息0 错误轮询INT_STATUS0x02读取 RX FIFO收到后必须调用pd_rx_flush()pd_message_send(const struct usb_pd_message msg)msg: 待发送消息0 成功-1 失败将消息写入 TX FIFO0x30-0x4F触发硬件发送需确保 TX_FIFO_EMPTY14. 典型应用场景代码实现4.1 双角色DRP供电协商终端此场景模拟一个移动电源能根据插入设备自动切换 Source/Sink 角色并进行 PD 协商#include Wire.h #include fusb302.h #include usb_pd.h fusb302 usb_controller; const uint8_t I2C_ADDRESS 0x22; bool is_source false; void setup() { Serial.begin(115200); Wire.begin(); if (usb_controller.setup(Wire, I2C_ADDRESS) ! 0) { Serial.println(FUSB302 setup failed); while(1); } if (!usb_controller.detect()) { Serial.println(FUSB302 not detected); while(1); } // 初始配置为 DRP先尝试作为 Sink usb_controller.power_set(true); usb_controller.cc_pull_down(); usb_controller.pd_reset_logic(); usb_controller.pd_autogoodcrc_set(true); usb_controller.pd_autoretry_set(2); } void loop() { // 1. 检测 CC 状态判断连接角色 enum usb_typec_cc_status cc1, cc2; if (usb_controller.cc_measure(cc1, cc2) 0) { if (cc1 USB_TYPEC_CC_STATUS_OPEN cc2 USB_TYPEC_CC_STATUS_OPEN) { // Normal cable: 如果 VBUS 有压说明对端是 Source - 本机应为 Sink float vbus; if (usb_controller.vbus_measure(vbus) 0 vbus 4.0f) { if (!is_source) { Serial.println(Connected to Source, acting as Sink); is_source false; usb_controller.cc_pull_down(); } } } else if (cc1 USB_TYPEC_CC_STATUS_OPEN cc2 USB_TYPEC_CC_STATUS_OPEN) { // Flipped cable: 同理判断 float vbus; if (usb_controller.vbus_measure(vbus) 0 vbus 0.5f) { if (is_source) { Serial.println(No Source detected, acting as Source); is_source true; usb_controller.cc_pull_up(USB_TYPEC_CC_STATUS_RP_DEF); // 发送 Source_Capabilities struct usb_pd_message cap_msg; cap_msg.sop_type USB_PD_SOP; cap_msg.header (0x01 10) | 0x01; // 1 PDO, Source_Capabilities cap_msg.objects[0] 0x00000000; // 5V/3A Fixed PDO cap_msg.object_count 1; usb_controller.pd_message_send(cap_msg); } } } } // 2. 处理 PD 消息 struct usb_pd_message rx_msg; int result usb_controller.pd_message_receive(rx_msg); if (result 1) { if ((rx_msg.header 0x00FF) 0x02) { // Request Message // 解析 Request检查是否支持所需电压/电流 uint32_t rdo rx_msg.objects[0]; uint8_t op_curr (rdo 10) 0x3FF; // Operating Current (10mA units) uint8_t max_curr (rdo 0) 0x3FF; // Max Operating Current if (op_curr 300 (rdo 0x80000000)) { // 5V request with no mismatch // 发送 Accept struct usb_pd_message acc_msg; acc_msg.sop_type USB_PD_SOP; acc_msg.header (0x01 10) | 0x03; // 1 DO, Accept acc_msg.object_count 0; usb_controller.pd_message_send(acc_msg); Serial.println(PD Accept sent); } } } delay(100); }4.2 工业级 USB-C 端口监控器此应用聚焦于高可靠性监控利用 INT 引脚实现事件驱动#include Wire.h #include fusb302.h #include usb_pd.h fusb302 usb_controller; const uint8_t I2C_ADDRESS 0x22; const uint8_t INT_PIN 2; // 连接 FUSB302 的 INT 引脚 void IRAM_ATTR on_usb_event() { // 中断服务程序仅标记事件不在 ISR 中执行耗时操作 static volatile bool event_pending false; event_pending true; } void setup() { Serial.begin(115200); pinMode(INT_PIN, INPUT_PULLUP); attachInterrupt(digitalPinToInterrupt(INT_PIN), on_usb_event, FALLING); Wire.begin(); if (usb_controller.setup(Wire, I2C_ADDRESS) ! 0) { Serial.println(Setup failed); while(1); } if (!usb_controller.detect()) { Serial.println(Device not found); while(1); } usb_controller.power_set(true); usb_controller.cc_pull_down(); usb_controller.pd_reset_logic(); // 启用 INT 引脚中断源CC, VBUS, PD_RX uint8_t mask 0x07; // CC_INT_EN | VBUS_INT_EN | RX_INT_EN usb_controller.register_write(FUSB302_REG_MASK, mask); } void loop() { static volatile bool event_pending false; if (event_pending) { event_pending false; // 读取中断状态寄存器确定事件类型 uint8_t int_status; usb_controller.register_read(FUSB302_REG_INT_STATUS, int_status); if (int_status 0x01) { // CC_INT enum usb_typec_cc_status cc1, cc2; if (usb_controller.cc_measure(cc1, cc2) 0) { Serial.print(CC Change: CC1); Serial.print(cc1); Serial.print(, CC2); Serial.println(cc2); } } if (int_status 0x02) { // VBUS_INT float vbus; if (usb_controller.vbus_measure(vbus) 0) { Serial.print(VBUS Change: ); Serial.print(vbus, 2); Serial.println(V); } } if (int_status 0x04) { // RX_INT struct usb_pd_message msg; if (usb_controller.pd_message_receive(msg) 1) { Serial.print(PD RX: Header0x); Serial.println(msg.header, HEX); usb_controller.pd_rx_flush(); // 清空 FIFO } } // 清除中断标志写 1 清零 usb_controller.register_write(FUSB302_REG_INT_STATUS, int_status); } delay(10); }