3. 开发环境搭建：交叉编译工具链配置、内核源码获取、内核配置选项启用

嵌入式 Linux USB Gadget 开发与普通桌面开发的最大区别在于交叉编译。目标设备（ARM、RISC-V、MIPS 等）资源有限，无法直接运行本地编译工具链，因此必须在性能强劲的宿主机（x86_64）上搭建交叉编译环境，生成目标架构的可执行文件与内核模块。本章将系统讲解从工具链安装、内核源码获取到 Gadget 相关内核配置选项启用的完整流程。

3.1 交叉编译工具链配置

交叉编译工具链是一套完整的编译、链接、调试工具集合，运行在宿主机上，生成目标架构的二进制代码。推荐使用官方预编译工具链，避免从源码构建的复杂性与兼容性问题。

3.1.1 工具链安装（APT 方式）

# 安装 ARM 32位硬浮点交叉工具链
sudo apt update
sudo apt install -y gcc-arm-linux-gnueabihf binutils-arm-linux-gnueabihf \
    g++-arm-linux-gnueabihf libc6-dev-armhf-cross

# 验证安装
arm-linux-gnueabihf-gcc --version
# 输出示例：arm-linux-gnueabihf-gcc (Ubuntu 12.2.0-3ubuntu1) 12.2.0

3.1.2 工具链环境变量设置

为简化后续编译命令，建议将工具链前缀写入环境变量，并加入 ~/.bashrc 永久生效：

export CROSS_COMPILE=arm-linux-gnueabihf-
export ARCH=arm

# 验证环境变量
echo $CROSS_COMPILE   # 输出：arm-linux-gnueabihf-
echo $ARCH            # 输出：arm

3.1.3 测试编译：最小可执行程序

# 编写测试文件 test.c
#include <stdio.h>
int main() {
    printf("USB Gadget Dev Env OK\n");
    return 0;
}

# 交叉编译
${CROSS_COMPILE}gcc -o test_arm test.c

# 查看目标架构
file test_arm
# 输出：ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked ...

3.2 内核源码获取

USB Gadget 驱动深度依赖内核源码树，必须获取完整的内核源码（含头文件、Kconfig、Makefile），不能仅使用内核头文件包。

3.2.1 获取方式对比

3.2.2 解压与目录结构

# 下载并解压主线内核
wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.1.tar.xz
tar -xf linux-6.1.tar.xz
cd linux-6.1

# 关键目录说明
ls -F | grep /
arch/          # 架构相关代码 (arch/arm/, arch/arm64/)
drivers/       # 设备驱动 (drivers/usb/gadget/)
include/       # 内核头文件 (include/linux/usb/)
Documentation/ # 内核文档 (Documentation/usb/gadget_configfs.rst)

3.3 内核配置选项启用（CONFIG_USB_GADGET 等）

USB Gadget 功能通过内核 Kconfig 选项控制。必须正确启用 CONFIG_USB_GADGET 及其子选项，才能编译出支持 Gadget 设备的内核与模块。

3.3.1 配置流程总览

下图展示了从默认配置到 Gadget 功能启用的完整配置流程：

3.3.2 关键 Kconfig 选项详解

以下表格列出了 USB Gadget 开发必须启用的核心配置选项及其依赖关系：

3.3.3 功能驱动选项（Function Drivers）

根据实际需求选择以下功能驱动（以 CONFIG_USB_CONFIGFS 为基础）：

3.3.4 实际操作：配置内核

以下命令以 TI AM335x 平台为例，演示如何启用 USB Gadget 相关选项：

# 1. 设置环境变量
export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabihf-

# 2. 加载厂商默认配置（以 TI AM335x 为例）
make am335x_evm_defconfig

# 3. 进入菜单配置界面
make menuconfig

# 4. 在 menuconfig 中依次进入以下路径并启用选项：
#    Device Drivers  --->
#      [*] USB support  --->
#        <*>   USB Gadget Support  --->
#          [*]   Debugging interface (DEVELOPMENT)
#          [*]   Debug filesystem
#          (100)  Maximum VBUS Draw (mA)
#          <*>   USB Gadget Drivers  --->
#            <*>   USB Gadget Functions (ConfigFS)  --->
#              <M>   Mass Storage Gadget
#              <M>   Serial Gadget
#              <M>   Ethernet Gadget (ECM)
#              <M>   RNDIS
#              <M>   HID Gadget

# 5. 保存退出后，验证配置
grep -E "CONFIG_USB_GADGET|CONFIG_USB_CONFIGFS|CONFIG_USB_F_" .config

3.3.5 验证配置结果

执行上述 grep 命令后，应看到类似输出：

CONFIG_USB_GADGET=y
CONFIG_USB_GADGET_DEBUG=y
CONFIG_USB_GADGET_DEBUG_FILES=y
CONFIG_USB_GADGET_DEBUG_FS=y
CONFIG_USB_GADGET_VBUS_DRAW=100
CONFIG_USB_CONFIGFS=y
CONFIG_USB_CONFIGFS_UEVENT=y
CONFIG_USB_F_MASS_STORAGE=m
CONFIG_USB_F_SERIAL=m
CONFIG_USB_F_ECM=m
CONFIG_USB_F_RNDIS=m
CONFIG_USB_F_HID=m

3.4 编译内核与模块

配置完成后，执行编译命令生成内核镜像与 Gadget 功能模块：

# 编译内核（使用 4 核并行）
make -j4 zImage

# 编译设备树
make -j4 dtbs

# 编译模块
make -j4 modules

# 安装模块到目标文件系统（假设挂载在 /mnt/rootfs）
make modules_install INSTALL_MOD_PATH=/mnt/rootfs

# 输出文件位置
# 内核镜像：arch/arm/boot/zImage
# 设备树：arch/arm/boot/dts/am335x-evm.dtb
# 模块：/mnt/rootfs/lib/modules/6.1.0+/

3.5 开发环境验证清单

完成上述步骤后，使用以下清单逐项确认环境就绪：

至此，嵌入式 Linux USB Gadget 开发环境搭建完毕。下一阶段将深入 Gadget 驱动框架与 ConfigFS 接口的使用。