4. 硬件平台准备
在开始USB Gadget驱动开发之前，选择正确的硬件平台并正确配置OTG模式是成功的第一步。本章将系统梳理主流支持USB Gadget的SoC平台、硬件连线要点以及OTG模式配置方法，帮助开发者快速搭建可用的硬件环境。
4.1 主流支持USB Gadget的SoC平台对比
并非所有SoC都支持USB Gadget模式。Gadget模式要求USB控制器必须支持设备模式（Device Mode）或OTG（On-The-Go）模式。以下是嵌入式开发中最常用的三类平台：
| SoC系列 | 代表型号 | USB控制器类型 | Gadget支持 | 典型应用 |
|---|---|---|---|---|
| NXP i.MX | i.MX6ULL / i.MX8M Mini | ChipIdea (CI) / DWC3 | 完整支持 | 工业控制、车载、物联网网关 |
| Broadcom BCM | BCM2711 (RPi 4B) | DWC2 | 完整支持 | 原型验证、教育、边缘计算 |
| Allwinner | H3 / H5 / V3s | Musb (Mentor Graphics) | 完整支持 | 低成本平板、智能音箱、开发板 |
选型建议： 初学者推荐使用Raspberry Pi 4B（DWC2控制器），其驱动成熟、社区文档丰富、调试工具完善。i.MX系列适合工业级产品开发，Allwinner系列适合成本敏感型项目。
4.2 SoC USB控制器架构与Gadget驱动栈
不同SoC的USB控制器内部架构虽有差异，但在Linux内核中均通过统一的Gadget API向上层提供服务。下图以i.MX6ULL的ChipIdea控制器为例，展示硬件与软件的分层关系：
4.3 硬件连线与OTG模式配置
4.3.1 OTG模式识别原理
USB OTG通过ID引脚的电平状态决定设备角色：
- ID引脚接地（GND）：设备作为 Host（主机），可以外接U盘、鼠标等从设备。
- ID引脚悬空（High-Z）：设备作为 Device（从设备/Gadget），可被PC识别为虚拟网卡、串口或存储设备。
常见错误： 许多开发板（如Raspberry Pi 4B）的USB-C口默认配置为Host模式。若直接连接PC，PC无法识别设备。必须使用OTG转接线或修改硬件ID引脚电平。
4.3.2 典型硬件连线方案
以下为三种常见SoC的OTG硬件连线参考：
| SoC平台 | USB接口类型 | ID引脚连接方式 | Gadget模式触发条件 |
|---|---|---|---|
| i.MX6ULL (EVK) | Micro-USB (OTG) | 通过GPIO模拟ID电平 | GPIO拉高 → Device模式 |
| Raspberry Pi 4B | USB-C | CC逻辑芯片控制 | 使用OTG线缆（ID接地） |
| Allwinner H3 (NanoPi) | Micro-USB (OTG) | 直连ID引脚到GND | 插入OTG线 → Device模式 |
4.3.3 Raspberry Pi 4B OTG配置实战
Raspberry Pi 4B的USB-C口默认作为电源输入和Host使用。要启用Gadget模式，需修改 config.txt：
# 在 /boot/config.txt 中添加以下内容
# 启用DWC2驱动
dtoverlay=dwc2
# 在 /boot/cmdline.txt 中添加（在 rootwait 之后）
modules-load=dwc2
# 重启后，检查是否加载成功
$ lsmod | grep dwc2
dwc2 245760 0
验证步骤：
- 将Raspberry Pi 4B通过USB-C线连接到PC。
- 在PC上执行
lsusb，应看到Linux Foundation 2.0 root hub或类似设备。 - 若未识别，检查ID引脚是否通过OTG线缆正确接地。
4.3.4 i.MX6ULL OTG配置实战
i.MX6ULL的OTG引脚为 USB_OTG1_ID（GPIO1_IO00）。通过设备树配置ID引脚：
// arch/arm/boot/dts/imx6ull.dtsi 片段
&usbotg1 {
dr_mode = "otg"; // 支持OTG模式
srp-disable;
hnp-disable;
adp-disable;
status = "okay";
};
// 板级dts中配置ID引脚
&usbotg1 {
pinctrl-names = "default";
pinctrl-0 = &pinctrl_usbotg1;
id-gpios = &gpio1 0 GPIO_ACTIVE_HIGH; // ID引脚
};
pinctrl_usbotg1: usbotg1grp {
fsl,pins = <
MX6UL_PAD_GPIO1_IO00__GPIO1_IO00 0x10b0 // ID引脚
MX6UL_PAD_GPIO1_IO04__GPIO1_IO04 0x10b0 // VBUS控制
>;
};4.4 OTG模式切换流程
下图展示了从硬件上电到Gadget功能激活的完整流程：
4.5 常见问题与排查方法
| 问题现象 | 可能原因 | 排查方法 |
|---|---|---|
| PC无法识别设备 | ID引脚电平错误 / 驱动未加载 | 测量ID引脚电压；lsmod | grep udc |
| Gadget功能注册失败 | UDC驱动未绑定 / 配置字符串错误 | dmesg | grep gadget 查看错误日志 |
| USB传输速度慢 | PHY配置错误 / 电源不足 | 检查 /sys/kernel/debug/usb/ 状态 |
| 设备反复断开重连 | VBUS供电不稳定 / 线缆质量差 | 更换USB线缆；检查VBUS电压（5V±5%） |
调试利器： 使用
lsusb -t 查看USB设备树拓扑，cat /sys/kernel/debug/usb/devices 查看详细设备描述符。对于Gadget驱动，/sys/kernel/config/usb_gadget/ 目录下的文件系统是配置和调试的核心入口。
4.6 本章小结
硬件平台准备是USB Gadget开发的基础。开发者需要：
- 选择支持Gadget模式的SoC（i.MX / RPi / Allwinner）
- 正确配置OTG模式（ID引脚电平控制）
- 加载对应的UDC驱动（dwc2 / ci_hdrc / musb）
- 通过设备树或内核参数完成硬件初始化