4. USB控制器设备树绑定：常见USB控制器（如DWC2、DWC3、Chipidea）的设备树节点定义与属性

在嵌入式Linux系统中，USB Gadget功能的实现高度依赖于底层USB控制器的正确配置。设备树（Device Tree）是描述硬件拓扑和资源的关键手段，对于USB控制器而言，设备树节点定义了其寄存器地址、中断号、时钟、电源管理、DMA以及USB 2.0/3.0相关的属性。本章将深入剖析三种主流USB控制器——DWC2（常用于STM32MP1、Allwinner）、DWC3（常用于TI AM64x、Qualcomm、Rockchip）和Chipidea（常用于NXP i.MX系列）——的设备树绑定规范，并提供可直接参考的节点定义与属性说明。

4.1 DWC2控制器设备树绑定

DWC2（DesignWare USB 2.0 OTG Controller）是广泛使用的USB 2.0 OTG控制器，支持Host、Device（Gadget）和OTG模式。其设备树节点需要明确指定操作模式、DMA掩码、以及物理接口类型。

4.1.1 核心属性与节点结构

4.1.2 典型设备树节点示例

usb_otg: usb@49000000 {
    compatible = "snps,dwc2";
    reg = <0x49000000 0x10000>;
    interrupts = <GIC_SPI 71 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&ccu CLK_BUS_OTG>, <&ccu CLK_OTG>;
    clock-names = "bus", "otg";
    resets = <&ccu RST_BUS_OTG>;
    reset-names = "bus";
    dr_mode = "peripheral";
    g-rx-fifo-size = <512>;
    g-np-tx-fifo-size = <32>;
    g-tx-fifo-size = <256 128 128 64 64 32>;
    phys = <&usbphy0>;
    phy-names = "usb2-phy";
    status = "okay";
};

4.1.3 DWC2 Gadget模式数据流

4.2 DWC3控制器设备树绑定

DWC3（DesignWare USB 3.0 Controller）是高性能USB 3.0/3.1控制器，支持SuperSpeed和SuperSpeedPlus。其设备树绑定比DWC2更复杂，需要额外处理USB 3.0 PHY、LPM（链路电源管理）以及多端口配置。

4.2.1 核心属性与差异

4.2.2 典型设备树节点示例（含glue层）

usb: usb@ff600000 {
    compatible = "ti,am64-dwc3", "snps,dwc3";
    reg = <0x0 0xff600000 0x0 0x10000>;
    interrupts = <GIC_SPI 131 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&k3_clks 151 0>, <&k3_clks 151 1>;
    clock-names = "bus", "ref";
    power-domains = <&k3_pds 151 TI_SCI_PD_EXCLUSIVE>;
    ti,syscon-phy-pll-refclk = <&scm_conf 0x4000>;
    #address-cells = <2>;
    #size-cells = <2>;
    ranges;

    dwc3: dwc3@ff600000 {
        compatible = "snps,dwc3";
        reg = <0x0 0xff600000 0x0 0x10000>;
        interrupts = <GIC_SPI 131 IRQ_TYPE_LEVEL_HIGH>;
        dr_mode = "peripheral";
        maximum-speed = "super-speed";
        snps,dis_u3_susphy_quirk;
        snps,dis_u2_susphy_quirk;
        snps,usb3_lpm_capable;
        phys = <&usb0_phy>, <&usb0_phy>;
        phy-names = "usb2-phy", "usb3-phy";
        tx-fifo-resize;
        status = "okay";
    };
};

4.2.3 DWC3 Gadget模式与PHY交互

4.3 Chipidea控制器设备树绑定

Chipidea（现已被NXP收购，常见于i.MX系列）是另一种广泛使用的USB 2.0 OTG控制器。其设备树绑定与DWC2有相似之处，但具有独特的 ci-hdrc 驱动框架和 phy 接口。

4.3.1 核心属性与配置

4.3.2 典型设备树节点示例（i.MX6Q）

usbotg: usb@02184000 {
    compatible = "fsl,imx6q-usb", "fsl,imx27-usb";
    reg = <0x02184000 0x200>;
    interrupts = <0 43 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&clks IMX6Q_CLK_USBOH3>;
    fsl,usbphy = <&usbphy1>;
    fsl,usbmisc = <&usbmisc 0>;
    dr_mode = "peripheral";
    phy_type = "utmi";
    disable-over-current;
    srp-disable;
    hnp-disable;
    status = "okay";
};

4.3.3 Chipidea控制器模式切换逻辑

4.4 三种控制器设备树对比总结

4.5 设备树节点调试与验证

在完成设备树配置后，可以通过以下方法验证节点是否正确加载：

• 检查设备树解析： 使用 ls /sys/firmware/devicetree/base/soc/ 查看节点是否存在。
• 查看驱动绑定： cat /sys/bus/platform/drivers/dwc2/ 或 cat /sys/bus/platform/drivers/ci_hdrc/ 确认驱动已绑定。
• 检查中断和寄存器： cat /proc/interrupts | grep dwc 查看中断是否触发。
• 验证Gadget功能： ls /sys/kernel/config/usb_gadget/ 确认Gadget目录可访问。

# 检查DWC2设备树节点是否被内核识别
# 在目标板上执行：
ls /sys/firmware/devicetree/base/soc/usb@49000000/
cat /sys/firmware/devicetree/base/soc/usb@49000000/compatible
cat /sys/firmware/devicetree/base/soc/usb@49000000/dr_mode

# 预期输出：
# snps,dwc2
# peripheral