3. 开发环境搭建

嵌入式Linux驱动开发与原生PC开发最大的区别在于交叉编译。目标板（ARM、RISC-V等架构）资源有限，无法直接运行本地编译器，因此需要在性能强劲的宿主机（x86_64）上安装交叉编译工具链，生成目标架构的可执行文件。本章将系统讲解Gadget驱动开发环境的完整搭建流程，包括工具链安装、内核源码获取、内核配置与编译，为后续的虚拟网卡（Ethernet Gadget）和虚拟串口（Serial Gadget）实战打下坚实基础。

3.1 交叉编译工具链安装

交叉编译工具链是一套完整的工具集合，包含编译器（gcc）、汇编器（as）、链接器（ld）、库文件（glibc/uclibc）以及调试器（gdb）。根据目标架构的不同，工具链的命名规则通常为：arch-vendor-os-abi-。例如，ARM 架构的交叉编译器前缀为 arm-linux-gnueabihf-，其中 hf 表示硬浮点（Hard Float）。

3.1.1 工具链选择与下载

推荐使用 Linaro 提供的预编译工具链，稳定且社区支持广泛。也可以使用 Buildroot 或 Yocto 自行构建，但初次搭建建议直接下载预编译版本。

3.1.2 安装步骤

1. 下载工具链：从 Linaro 官方仓库或镜像站下载对应版本。
2. 解压到指定目录：建议统一放置在 /opt/toolchains/ 下。
3. 配置环境变量：将工具链的 bin 目录添加到 PATH 中。
4. 验证安装：使用 arm-linux-gnueabihf-gcc --version 检查版本。

# 下载 ARM 32位硬浮点工具链（约 200MB）
wget https://releases.linaro.org/components/toolchain/binaries/10.2-2020.11/arm-linux-gnueabihf/gcc-linaro-10.2.1-2020.11-x86_64_arm-linux-gnueabihf.tar.xz

# 解压到 /opt/toolchains
sudo mkdir -p /opt/toolchains
sudo tar -xvf gcc-linaro-10.2.1-2020.11-x86_64_arm-linux-gnueabihf.tar.xz -C /opt/toolchains/

# 添加环境变量（写入 ~/.bashrc 或 ~/.zshrc）
export PATH=$PATH:/opt/toolchains/gcc-linaro-10.2.1-2020.11-x86_64_arm-linux-gnueabihf/bin

# 重新加载配置
source ~/.bashrc

# 验证
arm-linux-gnueabihf-gcc --version
# 输出示例：arm-linux-gnueabihf-gcc (Linaro GCC 10.2-2020.11) 10.2.1 20201103

3.1.3 交叉编译测试

编写一个简单的 Hello World 程序，使用交叉编译器编译，并通过 file 命令验证生成的可执行文件是否为 ARM 架构。

# 创建测试文件
cat > hello.c << EOF
#include <stdio.h>

int main(void)
{
    printf("Hello from ARM Gadget!\n");
    return 0;
}
EOF

# 交叉编译
arm-linux-gnueabihf-gcc -o hello_arm hello.c

# 查看文件类型
file hello_arm
# 输出：hello_arm: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-armhf.so.3, not stripped

3.2 Linux内核源码获取

Gadget 驱动是 Linux 内核的一部分，因此必须获取内核源码并进行配置编译。推荐使用 Linux 内核主线版本或长期支持（LTS）版本。本课程基于 Linux 6.1 LTS，该版本对 USB Gadget 框架支持完善，且社区文档丰富。

3.2.1 源码获取方式

# 方式一：下载 tar 包（推荐，体积小、速度快）
wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.1.76.tar.xz
tar -xvf linux-6.1.76.tar.xz
cd linux-6.1.76

# 方式二：git 克隆（需要安装 git）
git clone --depth=1 https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git -b v6.1.76
cd linux

3.2.2 内核源码目录结构

理解内核源码的目录结构有助于快速定位 Gadget 相关代码。下表列出了与 USB Gadget 开发密切相关的目录：

3.3 内核配置与编译基础

内核配置是决定哪些功能被编译进内核或编译为模块的关键步骤。对于 Gadget 驱动开发，需要确保 USB Gadget 框架、ConfigFS、以及具体的 Function 驱动（Ethernet、Serial）被正确启用。

3.3.1 配置方法概述

Linux 内核提供多种配置界面，推荐使用 menuconfig（基于 ncurses 的文本菜单界面），操作直观且支持搜索。

3.3.2 Gadget 相关配置项

在 menuconfig 中，需要依次进入以下路径并启用对应选项。下表列出了关键配置项及其含义：

3.3.3 编译内核与模块

配置完成后，执行编译命令。对于交叉编译，需要指定目标架构和交叉编译器前缀。

# 设置环境变量（每次编译前执行，或写入 ~/.bashrc）
export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabihf-

# 生成默认配置（基于 ARM 架构）
make defconfig

# 进入 menuconfig 手动调整 Gadget 配置
make menuconfig

# 编译内核（使用 -jN 并行编译，N 为 CPU 核心数）
make -j4 zImage

# 编译设备树
make -j4 dtbs

# 编译内核模块
make -j4 modules

# 安装模块到目标目录（可选，用于后续打包）
make modules_install INSTALL_MOD_PATH=./modules_install

3.3.4 编译产物说明

编译完成后，在源码根目录下会生成以下关键文件：

3.4 开发环境架构总览

下面通过一张 SVG 架构图展示宿主机与目标板之间的交叉编译关系，以及内核源码、工具链、模块之间的数据流。

3.5 常见问题与避坑指南

#!/bin/bash
export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabihf-
export PATH=$PATH:/opt/toolchains/gcc-linaro-10.2.1-2020.11-x86_64_arm-linux-gnueabihf/bin
make -j4 zImage dtbs modules

3.6 本章小结

本章完成了 Gadget 驱动开发环境的完整搭建：

• 交叉编译工具链：安装并验证了 arm-linux-gnueabihf- 工具链，能够编译 ARM 架构的可执行文件。
• 内核源码获取：下载了 Linux 6.1 LTS 源码，并熟悉了 Gadget 相关目录结构。
• 内核配置与编译：通过 menuconfig 启用了 USB Gadget 框架、ConfigFS、ECM 网卡和 ACM 串口功能，并成功编译出内核镜像和模块。