3. 开发环境搭建：交叉编译工具链配置、Linux内核源码获取与编译、构建最小根文件系统、目标板准备

构建USB Gadget多功能复合设备，首先需要搭建一套完整的交叉开发环境。本章将指导你完成从工具链配置到目标板启动的全流程，确保后续驱动开发与设备固件编译能够顺利进行。

3.1 交叉编译工具链配置

交叉编译工具链是嵌入式开发的基石。对于BeagleBone Black（ARM Cortex-A8）和Raspberry Pi 3B+（ARM Cortex-A53），推荐使用Linaro GCC或Buildroot生成的自定义工具链。

3.1.1 工具链选择对比

3.1.2 安装Linaro工具链（以Ubuntu 22.04主机为例）

# 下载ARM 32位硬浮点工具链
wget https://releases.linaro.org/components/toolchain/binaries/latest-7/arm-linux-gnueabihf/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz

# 解压到 /opt 目录
sudo tar -xvf gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz -C /opt/

# 添加环境变量（写入 ~/.bashrc）
export PATH=/opt/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin:$PATH
export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabihf-

# 验证安装
arm-linux-gnueabihf-gcc --version

3.1.3 工具链验证：编译最小测试程序

# 编写测试代码
cat > hello_gadget.c << EOF
#include <stdio.h>
int main(void) {
    printf("USB Gadget Ready!\n");
    return 0;
}
EOF

# 交叉编译
arm-linux-gnueabihf-gcc -static -o hello_gadget hello_gadget.c

# 查看生成文件的架构信息
file hello_gadget
# 输出: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), statically linked

3.2 Linux内核源码获取与编译

USB Gadget功能高度依赖内核配置，必须正确开启USB Gadget子系统及相关驱动。本节以BeagleBone Black官方内核（Linux 6.1 LTS）为例进行演示。

3.2.1 获取内核源码

# 从TI官方仓库获取BeagleBone Black内核源码
git clone --depth 1 -b v6.1.80-ti-r142 \
    https://github.com/beagleboard/linux.git \
    bb-kernel

cd bb-kernel

3.2.2 内核配置：USB Gadget相关选项

执行 make menuconfig 后，必须确保以下选项被编译进内核或作为模块：

3.2.3 编译内核与模块

# 设置交叉编译环境
export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabihf-

# 加载BeagleBone Black默认配置
make bb.org_defconfig

# 进入菜单配置（按上述表格修改）
make menuconfig

# 编译内核镜像（使用4线程加速）
make -j$(nproc) zImage

# 编译设备树
make -j$(nproc) dtbs

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

# 安装模块到临时目录
make INSTALL_MOD_PATH=./modules_install modules_install

3.2.4 内核编译产物清单

3.3 构建最小根文件系统

根文件系统提供设备运行所需的用户空间程序、库和配置文件。对于USB Gadget设备，推荐使用Buildroot构建最小系统，仅包含必要组件。

3.3.1 Buildroot配置要点

# 下载Buildroot 2024.02 LTS
wget https://buildroot.org/downloads/buildroot-2024.02.tar.gz
tar -xvf buildroot-2024.02.tar.gz
cd buildroot-2024.02

# 配置BeagleBone Black目标
make beaglebone_defconfig

# 进入菜单配置，调整以下关键项：
make menuconfig

3.3.2 编译根文件系统

# 编译（耗时较长，约30分钟）
make -j$(nproc)

# 编译产物位于 output/images/
ls output/images/
# rootfs.tar    zImage    am335x-boneblack.dtb

3.3.3 最小根文件系统结构

# 解压rootfs.tar查看目录结构
mkdir rootfs
sudo tar -xvf output/images/rootfs.tar -C rootfs/
tree -L 2 rootfs/ | head -30

rootfs/
├── bin -> usr/bin
├── dev
├── etc
│   ├── init.d
│   ├── network
│   └── shadow
├── lib -> usr/lib
├── proc
├── sbin -> usr/sbin
├── sys
├── usr
│   ├── bin
│   ├── lib
│   └── sbin
└── var

3.4 目标板准备（BeagleBone Black）

将编译好的内核、设备树、根文件系统部署到SD卡，使目标板能够独立启动并加载USB Gadget驱动。

3.4.1 SD卡分区规划

3.4.2 制作可启动SD卡

# 假设SD卡设备为 /dev/sdb（请务必确认！）
sudo fdisk /dev/sdb
# 创建两个分区：1) FAT32 128MB, 2) ext4 剩余空间

# 格式化
sudo mkfs.vfat -F 32 -n BOOT /dev/sdb1
sudo mkfs.ext4 -L ROOTFS /dev/sdb2

# 挂载并复制启动文件
mkdir boot rootfs
sudo mount /dev/sdb1 boot
sudo mount /dev/sdb2 rootfs

# 复制内核与设备树
sudo cp bb-kernel/arch/arm/boot/zImage boot/
sudo cp bb-kernel/arch/arm/boot/dts/am335x-boneblack.dtb boot/

# 复制根文件系统
sudo tar -xvf buildroot/output/images/rootfs.tar -C rootfs/

# 复制内核模块
sudo cp -r bb-kernel/modules_install/lib/modules rootfs/lib/

# 卸载
sudo umount boot rootfs

3.4.3 首次启动验证

# 将SD卡插入BeagleBone Black，按住BOOT按钮上电
# 通过串口（115200 8N1）连接观察启动日志

# 登录后检查USB Gadget功能
ls /sys/kernel/config/usb_gadget/
# 如果看到空目录，说明configfs已挂载，Gadget框架就绪

# 检查内核模块
lsmod | grep g_
# 应看到 g_ether、g_serial 等模块（如果已加载）

3.5 开发环境架构总览

下图展示了主机与目标板之间的开发流程与数据流向：

3.6 常见问题与避坑指南

• 工具链版本不匹配：内核版本与GCC版本存在兼容性，Linux 6.x内核建议使用GCC 10+，避免使用GCC 7以下版本编译时出现内联汇编错误。
• configfs未挂载：如果 /sys/kernel/config/usb_gadget/ 不存在，手动执行 mount -t configfs none /sys/kernel/config，并在 /etc/fstab 中添加自动挂载。
• USB OTG引脚冲突：BeagleBone Black的USB0端口默认用于主机模式，需确认设备树中 dr_mode = "peripheral" 或 "otg" 已正确设置。
• 模块依赖缺失：复制内核模块到根文件系统后，执行 depmod -a 重建模块依赖关系，否则 modprobe 可能失败。

3.7 开发环境验证清单