从手机连U盘到嵌入式开发：深入Linux内核的USB OTG驱动与角色切换（HNP/SRP协议解析）

当你的手机通过OTG线连接U盘时，背后隐藏着一套精密的协议交互过程。这种看似简单的"即插即用"体验，实则是嵌入式开发者需要深入理解的复杂系统——从硬件引脚定义到内核驱动配置，再到动态角色切换协议（HNP/SRP）的协同工作。本文将带你穿透表象，掌握Linux内核中OTG驱动的核心实现逻辑。

1. USB OTG技术体系全景

USB On-The-Go（OTG）技术本质上构建了一个动态权力体系。与传统的"主机-外设"固定关系不同，OTG设备需要具备双重身份识别能力。这种能力体现在三个层面：

1. 物理层：通过ID引脚电平状态（接地/浮空）判定初始角色
2. 协议层：HNP和SRP协议实现运行时角色切换
3. 系统层：Linux内核通过dwc2/dwc3等驱动栈管理状态迁移

在Rockchip RK3399这类典型嵌入式SoC中，OTG控制器通常集成以下关键组件：

模块	功能描述	相关内核配置选项
ID引脚检测电路	监测USB_ID电平状态	CONFIG_USB_OTG_FSM
电源管理单元	控制VBUS供电（SRP协议关键）	CONFIG_USB_OTG
状态机引擎	处理HNP/SRP协议流程	CONFIG_USB_DWC2_HOST
模式切换逻辑	Host/Device模式动态切换	CONFIG_USB_DWC3_GADGET

提示：在定制硬件设计时，务必确保ID引脚电路符合OTG规范。常见错误是将ID引脚直接固定接地或悬空，这将导致角色切换功能失效。

2. 硬件层：引脚定义的工程实践

Micro-USB接口的5个引脚中，ID引脚（Pin4）是OTG功能的仲裁者。但在实际工程中，开发者常遇到以下典型场景：

案例：STM32F4系列OTG设计

// 硬件初始化代码示例（STM32Cube HAL）
GPIO_InitTypeDef GPIO_InitStruct = {0};
__HAL_RCC_GPIOB_CLK_ENABLE();
GPIO_InitStruct.Pin = GPIO_PIN_12;  // ID引脚
GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
GPIO_InitStruct.Pull = GPIO_NOPULL; // 必须禁止上拉/下拉
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

关键设计要点：

• ID引脚必须配置为浮空输入（No Pull）
• VBUS检测电路需支持±0.5V精度
• 在PCB布局时，ID走线应远离高频信号线

常见硬件故障排查表：

现象	可能原因	解决方案
无法识别设备类型	ID引脚短路/断路	检查PCB走线和焊接质量
角色切换不稳定	VBUS供电不足	测量电源纹波，增强去耦电容
枚举过程频繁失败	D+/D-线序错误	核对原理图与插座定义

3. Linux内核驱动架构解析

Linux内核通过drivers/usb/dwc3/目录下的代码实现OTG功能。核心架构分为三个层次：

3.1 硬件抽象层（HAL）

/* 典型DWC3控制器初始化流程 */
static int dwc3_probe(struct platform_device *pdev)
{
    /* 1. 获取OTG硬件参数 */
    dwc->usb2_phy = devm_usb_get_phy(dev, USB_PHY_TYPE_USB2);
    
    /* 2. 配置角色切换回调 */
    dwc->role_sw = usb_role_switch_register(dev, &dwc3_role_switch_desc);
    
    /* 3. 初始化OTG状态机 */
    ret = dwc3_otg_init(dwc);
}

3.2 协议状态机实现

HNP（主机协商协议）的核心状态迁移逻辑：

A设备作为主机启动
  │
  ↓
B设备发送HNP请求（SET_FEATURE）
  │
  ↓
A设备挂起总线（Suspend）
  │
  ↓
B设备接管主机角色（通过驱动VBUS）

在drivers/usb/common/usb-otg-fsm.c中，状态机通过以下关键函数实现：

int otg_statemachine(struct otg_fsm *fsm)
{
    switch (fsm->state) {
    case OTG_STATE_A_HOST:
        if (test_bit(HNP_REQUEST, &fsm->inputs)) {
            otg_hnp_protocol(fsm, 1);
            fsm->state = OTG_STATE_A_SUSPEND;
        }
        break;
    case OTG_STATE_B_HOST:
        /* B设备作为主机的处理逻辑 */
        break;
    }
}

3.3 电源管理集成

SRP（会话请求协议）的电源控制流程：

1. B设备检测到无活动时，驱动D+线（数据线脉冲）
2. A设备检测到SRP信号后，重新使能VBUS
3. 双方重新建立会话

内核中的电源事件处理：

static void dwc3_otg_sm_work(struct work_struct *w)
{
    /* SRP检测处理 */
    if (dwc->otg_fsm.b_hnp_enable && !dwc->vbus_active) {
        dwc3_otg_start_srp(dwc);
    }
    
    /* VBUS电源控制 */
    if (dwc->desired_otg_role == USB_ROLE_HOST) {
        regulator_enable(dwc->usb2_phy->vbus);
    }
}

4. 实战：定制开发中的关键配置

在基于Buildroot或Yocto的嵌入式系统中，需要特别注意以下配置项：

内核配置片段：

# 启用OTG功能支持
CONFIG_USB_OTG=y
CONFIG_USB_OTG_FSM=y

# 针对DWC3控制器的配置
CONFIG_USB_DWC3=y
CONFIG_USB_DWC3_HOST=y
CONFIG_USB_DWC3_GADGET=y
CONFIG_USB_DWC3_DUAL_ROLE=y

设备树节点示例（Rockchip平台）：

usb@fe800000 {
    compatible = "rockchip,rk3399-dwc3";
    dr_mode = "otg";  // 必须设置为otg模式
    phys = <&u2phy0_otg>;
    phy-names = "usb2-phy";
    extcon = <&u2phy0>;
};

用户空间交互接口：

# 查看当前OTG角色
cat /sys/class/udc/*/current_role

# 手动触发角色切换（测试用）
echo "host" > /sys/class/udc/fe800000.usb/role

在调试过程中，建议使用以下内核日志过滤命令：

dmesg | grep -E "dwc3|otg|HNP|SRP"

5. 高级调试技巧与性能优化

当开发遇到角色切换失败时，可以按照以下步骤进行诊断：

1. 电气层检查

   • 使用示波器捕获ID引脚和VBUS波形
   • 验证SRP脉冲的时序是否符合USB2.0规范

2. 协议层分析

   # 启用OTG调试日志
   echo 8 > /proc/sys/kernel/printk
   

3. 性能优化参数

   // 调整HNP响应超时（单位：ms）
   module_param(hnp_polling_interval, int, 0644);
   MODULE_PARM_DESC(hnp_polling_interval, "HNP status polling interval");
   

典型性能优化案例：

• 减少角色切换延迟：调整dwc3.ko模块的hnp_polling_interval参数
• 降低功耗：合理配置autosuspend_delay_ms实现SRP快速响应
• 提高稳定性：修改dwc3_gadget.c中的EP队列深度参数

在完成所有调试后，建议使用USB协议分析仪捕获完整的HNP/SRP交互过程。Wireshark的USB捕获插件可以解析出关键协议事件：

No. Time        Source          Destination     Protocol Info
1    0.000000   host            device          USB      SET_FEATURE (HNP enable)
2    1.002103   host            device          USB      SUSPEND
3    1.205478   device          host            USB      RESUME (role swap)