4. 内核配置与编译：USB Gadget 相关选项详解

在嵌入式 Linux 开发中，正确配置内核是启用 USB Gadget 功能的前提。本章将深入讲解 menuconfig 中与 USB Gadget 相关的核心选项，包括 USB Gadget Support、UDC 驱动以及 Function 驱动的配置方法与依赖关系。

4.1 USB Gadget Support 顶层开关

进入内核源码根目录，执行 make menuconfig 后，通过以下路径找到 USB Gadget 支持选项：

Device Drivers  --->
  [*] USB support  --->
    <*> USB Gadget Support  --->

该选项是 USB Gadget 功能的全局开关，必须选中（<*> 或 [y]）才能显示后续的 UDC 和 Function 配置项。其依赖关系如下：

4.2 UDC 驱动配置

UDC（USB Device Controller）驱动是连接 SoC USB 控制器与 Gadget 框架的底层软件层。配置路径通常位于 USB Gadget Support 子菜单内：

USB Gadget Support  --->
  *** UDC Controller Drivers ***
  <*> DesignWare USB2 DRD Core Support
  <*> Chipidea USB2 Device Controller
  <*> MUSB (Inventra) USB Device Controller
  [*]   Support for Mentor USB OTG Port

常见 UDC 驱动与对应 SoC 平台对照表：

4.3 Function 驱动配置

Function 驱动定义了 USB Gadget 的具体功能角色，如串口、网络、存储等。配置路径位于 USB Gadget Support 子菜单的 USB Gadget Drivers 部分：

USB Gadget Support  --->
  *** USB Gadget Drivers ***
  <M> USB Gadget Functions (configfs based)
  <M> Serial Gadget (with CDC ACM and CDC OBEX support)
  <M> Ethernet Gadget (with CDC ECM support)
  <M> Mass Storage Gadget
  <M> Audio Gadget
  <M> Video Gadget (UVC)
  <M> HID Gadget

常用 Function 驱动功能对比：

4.4 配置依赖与常见问题

内核配置中存在隐式依赖关系，未满足依赖会导致选项不可见或编译失败。以下为关键依赖链：

• USB Gadget Support 依赖 USB_SUPPORT 和 USB（或 USB_OTG）
• DWC2 UDC 依赖 USB_DWC2 且需选中 USB_DWC2_PERIPHERAL 或 USB_DWC2_DUAL_ROLE
• Chipidea UDC 依赖 USB_CHIPIDEA 且需选中 USB_CHIPIDEA_UDC
• ConfigFS 方式 依赖 CONFIGFS_FS（必须挂载 configfs 文件系统）
• Ethernet Gadget 依赖 NET 和 PHYLIB
• Mass Storage Gadget 依赖 BLOCK 和 SCSI

4.5 编译验证

配置完成后，执行以下步骤验证：

# 清理旧编译产物
make clean

# 编译内核与模块
make -j$(nproc)

# 编译设备树（如需要）
make dtbs

# 安装模块到目标根文件系统
make modules_install INSTALL_MOD_PATH=/path/to/rootfs

编译完成后，检查关键模块是否生成：

# 检查 UDC 模块
find . -name "dwc2.ko" -o -name "chipidea.ko" -o -name "musb_hdrc.ko"

# 检查 Function 模块
find . -name "g_serial.ko" -o -name "g_ether.ko" -o -name "g_mass_storage.ko"

# 检查 configfs 模块
find . -name "libcomposite.ko" -o -name "usb_f_*.ko"