4. 内核配置与编译：配置内核支持USB Gadget、编译内核与设备树、烧录至目标板

本章是搭建USB Gadget调试环境的核心实操环节。你将学习如何配置Linux内核以启用USB Gadget功能、编译内核与设备树（DTB），并将生成的镜像烧录至目标开发板。完成本章后，你的开发板将具备运行USB Gadget驱动程序的基础能力。

4.1 内核配置：启用USB Gadget子系统

USB Gadget功能在内核中由 CONFIG_USB_GADGET 控制。你需要通过内核配置菜单（menuconfig）手动启用该选项及其相关依赖。

4.1.1 进入内核配置界面

# 进入内核源码根目录
cd ~/linux-kernel

# 加载默认配置（以ARM架构为例）
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- defconfig

# 启动图形化配置界面
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- menuconfig

4.1.2 关键配置项清单

以下表格列出了USB Gadget子系统必须启用的核心配置项，以及推荐启用的辅助功能。

4.1.3 配置UDC（USB Device Controller）驱动

UDC驱动是Gadget子系统的硬件抽象层。根据你的目标板SoC选择对应的UDC驱动：

• Allwinner (sunxi)：CONFIG_USB_MV_UDC 或 CONFIG_USB_SUNXI_UDC
• Rockchip：CONFIG_USB_DWC2 或 CONFIG_USB_DWC3
• NXP i.MX：CONFIG_USB_CHIPIDEA
• Raspberry Pi (BCM2835)：CONFIG_USB_DWC2
• TI AM335x：CONFIG_USB_MUSB_AM335X

配置路径：Device Drivers → USB Support → USB Gadget Support → USB Peripheral Controller。

4.2 编译内核与设备树

配置完成后，进入编译阶段。本节涵盖内核镜像（zImage/uImage）和设备树（.dtb）的编译流程。

4.2.1 编译内核镜像

# 编译内核（使用4线程加速）
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j4 zImage

# 编译设备树
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- dtbs

# 编译内核模块（可选，如果配置了=m的驱动）
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -j4 modules
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- INSTALL_MOD_PATH=./modules modules_install

4.2.2 编译产物清单

4.2.3 设备树中USB Gadget节点的关键属性

设备树（DTS）中需要正确描述USB控制器的工作模式。以下是一个典型DWC2控制器的Gadget模式配置示例：

&usb_otg {
    status = "okay";
    dr_mode = "peripheral";   /* 强制为设备模式 */
    g-rx-fifo-size = <512>;
    g-np-tx-fifo-size = <32>;
    g-tx-fifo-size = <256 128 128 64>;
};

关键属性说明：

• dr_mode：可选 host、peripheral、otg。Gadget调试时建议设为 peripheral 避免OTG协商干扰。
• g-rx-fifo-size：接收FIFO大小（单位：32位字）。
• g-tx-fifo-size：各端点的发送FIFO大小，顺序对应端点号。

4.3 烧录至目标板

根据目标板的不同，烧录方式有所差异。本节以常见的SD卡启动和U-Boot网络烧录为例。

4.3.1 SD卡烧录（适用于Raspberry Pi、Allwinner等）

# 假设SD卡设备为 /dev/sdb（请确认！）
sudo dd if=arch/arm/boot/zImage of=/dev/sdb1 bs=1M
sudo dd if=arch/arm/boot/dts/sun8i-h3-orangepi-pc.dtb of=/dev/sdb1 bs=1M seek=1

# 如果使用U-Boot，需要将内核打包为uImage
mkimage -A arm -O linux -T kernel -C none -a 0x80008000 -e 0x80008000 \
        -n "Linux Kernel" -d arch/arm/boot/zImage uImage
sudo dd if=uImage of=/dev/sdb1 bs=1M

4.3.2 U-Boot网络烧录（TFTP + NFS）

适用于开发阶段快速迭代：

# 在开发主机上启动TFTP服务器，将zImage和dtb放入TFTP目录
sudo cp arch/arm/boot/zImage /srv/tftp/
sudo cp arch/arm/boot/dts/myboard.dtb /srv/tftp/

# 在U-Boot命令行中加载并启动
U-Boot> setenv serverip 192.168.1.100
U-Boot> setenv ipaddr 192.168.1.10
U-Boot> tftp 0x82000000 zImage
U-Boot> tftp 0x83000000 myboard.dtb
U-Boot> bootz 0x82000000 - 0x83000000

4.3.3 烧录后验证

目标板启动后，通过串口终端检查USB Gadget子系统是否加载成功：

# 检查内核启动日志中是否有Gadget相关输出
dmesg | grep -i gadget

# 检查UDC是否注册
ls /sys/class/udc/
# 应输出类似：musb-hdrc.0.auto

# 检查ConfigFS是否可用（如果启用了CONFIG_USB_CONFIGFS）
ls /sys/kernel/config/usb_gadget/
# 应输出空目录（尚未创建Gadget实例）

4.4 内核配置与编译流程总览

下图展示了从内核配置到目标板运行的完整流程，帮助你建立全局视角。

4.5 常见问题与排查