2. 开发环境搭建：交叉编译工具链配置、内核源码获取与分支选择、启用 USB Gadget 相关内核配置选项

嵌入式 Linux USB Gadget 驱动的开发与调试，离不开一套完整且正确的开发环境。本章将引导你完成从零搭建开发环境的三个核心步骤：交叉编译工具链的配置、内核源码的获取与分支选择，以及USB Gadget 相关内核配置选项的启用。一个稳固的环境是后续驱动调试与中断端点通信实验的基础。

2.1 交叉编译工具链配置

交叉编译是指在性能强大的主机（x86_64）上，编译生成可在目标板（ARM64）上运行的二进制代码。配置工具链的关键在于设置正确的环境变量，使编译系统能够找到对应的编译器、链接器和头文件。

2.1.1 工具链安装与验证

推荐使用 Linaro 提供的 GCC 交叉编译器，它针对 ARM 架构进行了优化。下载并解压后，通过 export PATH 将其 bin 目录加入系统路径。

# 下载并解压工具链（示例版本：gcc-arm-10.2-2020.11-x86_64-aarch64-none-linux-gnu）
wget https://releases.linaro.org/components/toolchain/binaries/latest-7/aarch64-linux-gnu/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz
tar -xf gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz
sudo mv gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu /opt/

# 配置环境变量（建议写入 ~/.bashrc 以永久生效）
export CROSS_COMPILE=aarch64-linux-gnu-
export ARCH=arm64
export PATH=/opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin:$PATH

# 验证工具链
aarch64-linux-gnu-gcc --version

2.1.2 工具链与内核版本的匹配

并非所有工具链版本都能完美编译任意版本的内核。下表列出了本课程验证过的推荐组合：

2.2 内核源码获取与分支选择

USB Gadget 功能是内核的一部分，因此获取正确版本的内核源码至关重要。本课程推荐使用 Linux 内核的长期支持（LTS）版本，以确保稳定性和社区支持。

2.2.1 获取源码的方式

• 方式一：从 kernel.org 直接下载（推荐初学者使用）
• 方式二：使用 Git 克隆内核仓库（便于切换分支和打补丁）

# 方式一：下载 LTS 版本压缩包
wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.10.210.tar.xz
tar -xf linux-5.10.210.tar.xz
cd linux-5.10.210

# 方式二：使用 Git 克隆（以 5.10.y 分支为例）
git clone --depth 1 -b linux-5.10.y git://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
cd linux

2.2.2 分支选择策略

不同的开发阶段应选择不同的内核分支：

2.3 启用 USB Gadget 相关内核配置选项

USB Gadget 功能在内核中默认是关闭的，需要通过 make menuconfig 或直接修改 .config 文件来启用。错误的配置会导致 Gadget 功能无法注册或端点通信失败。

2.3.1 进入内核配置界面

在源码根目录下执行以下命令，确保 ARCH 和 CROSS_COMPILE 环境变量已正确设置。

# 使用默认配置（以 defconfig 为基础，通常芯片厂商会提供）
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- defconfig

# 进入图形化配置界面
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- menuconfig

2.3.2 必须启用的核心选项

以下选项是 USB Gadget 功能的基础，必须编译进内核（*）或编译为模块（M）。建议初学者全部编译进内核，避免模块加载顺序问题。

CONFIG_USB_GADGET=y
CONFIG_USB_GADGET_DUALSPEED=y
CONFIG_USB_IMX=y
CONFIG_USB_CONFIGFS=y
CONFIG_USB_CONFIGFS_ACM=y
CONFIG_USB_CONFIGFS_ECM=y
CONFIG_USB_CONFIGFS_RNDIS=y

2.3.3 调试与测试相关的辅助选项

为了在开发过程中获取更多信息，建议同时启用以下调试选项：

• CONFIG_USB_GADGET_DEBUG：启用 Gadget 框架的调试输出。
• CONFIG_USB_GADGET_VERBOSE：提供更详细的日志，用于跟踪端点通信。
• CONFIG_DYNAMIC_DEBUG：动态调试支持，可在运行时控制特定文件的日志级别。

2.4 编译与验证

配置完成后，执行编译命令生成内核镜像和设备树。编译过程中如果出现错误，请根据错误信息回溯检查工具链版本和配置选项。

# 编译内核镜像和设备树
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j$(nproc) Image dtbs

# 编译内核模块（如果配置了 =M）
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j$(nproc) modules

# 验证生成的镜像
file arch/arm64/boot/Image
# 输出应包含：... ELF 64-bit LSB executable, ARM aarch64, ...