3. 开发环境搭建：内核配置、编译Gadget驱动模块与连接方式

搭建一个可复现的USB Gadget调试环境是枚举失败定位的基础。本节从内核配置入手，逐步讲解如何裁剪出最小Gadget功能集、编译独立的驱动模块，并给出目标板与主机之间的典型连接拓扑。

3.1 内核配置：CONFIG_USB_GADGET 及其依赖项

USB Gadget 功能由内核的 CONFIG_USB_GADGET 宏控制。在 make menuconfig 中，该选项位于 Device Drivers → USB Support → USB Gadget Support。以下表格列出了必须开启的核心选项及其作用：

3.2 编译Gadget驱动模块

将 Gadget 驱动编译为可加载模块（.ko）可以避免频繁烧录整个内核镜像，加快迭代速度。以下步骤基于 Linux 5.10+ 内核源码树：

1. 配置内核：执行 make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- menuconfig，将 CONFIG_USB_GADGET 设为 m，同时将需要的功能驱动（如 CONFIG_USB_ETH）也设为 m。
2. 编译模块：
   

   make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- modules -j$(nproc)

3. 提取模块：编译完成后，在 drivers/usb/gadget/ 下找到 udc-core.ko、libcomposite.ko 以及各功能模块（如 g_ether.ko、g_mass_storage.ko）。
4. 部署到目标板：将 .ko 文件拷贝至目标板的 /lib/modules/$(uname -r)/ 目录，执行 depmod -a 更新依赖。
5. 手动加载测试：
   

   modprobe libcomposite
   modprobe g_ether
   lsmod | grep gadget

3.3 目标板与主机的连接方式

USB Gadget 调试中，目标板（Device）与主机（Host）之间的物理连接直接影响枚举行为。下图展示了三种典型拓扑：

实际调试时，推荐按以下优先级选择连接方式：

• 直连（推荐）：目标板通过 USB-OTG 线或 A-to-A 线直接连接主机。信号路径最短，排除线缆和中间设备引入的电气问题。
• 串接分析仪：在 D+/D- 线上串接 USB 协议分析仪（如 Beagle USB 480 Pro），用于捕获枚举阶段的 SETUP 事务、描述符请求和复位信号。
• 通过 Hub 扩展：当目标板只有 Micro-B 口且主机距离较远时使用。注意 Hub 可能引入额外的帧起始（SOF）抖动，导致高速握手失败。

3.4 验证环境是否就绪

完成内核配置、模块编译和物理连接后，执行以下快速检查清单：