📚 课程目录第2章开发环境搭建

2. 开发环境搭建

板级联调的第一步不是写驱动，而是让“主机—目标板—调试通道”三者形成闭环。主机负责编译与烧写，目标板负责运行与暴露硬件，串口和网络负责把目标板的启动日志、内核打印、文件传输和远程登录串起来。本节围绕交叉编译工具链、内核源码、根文件系统、串口与网络调试环境五个对象，给出可落地的搭建路径。

一、核心原理：为什么必须交叉编译

开发主机通常是 x86_64 架构，而驱动板多为 ARM、AArch64 或 RISC-V。宿主机上的 gcc 生成的是 x86 指令，无法在目标板上执行。交叉编译工具链的本质，是一套“运行在 x86 主机、生成目标架构机器码”的编译器、链接器、汇编器与 C 库集合。它决定了内核、驱动模块和应用程序能否被目标板正确加载。

工具链的命名前缀直接暴露目标信息，例如 arm-linux-gnueabihf- 表示 ARM 32 位、Linux ABI、硬浮点；aarch64-linux-gnu- 表示 ARM 64 位。选择工具链时必须与内核配置中的 CONFIG_ARM、CONFIG_ARM64、浮点 ABI、大小端保持一致，否则会出现“编译通过、运行即崩”或模块版本不匹配。

交叉编译三要素：架构匹配、ABI 匹配、内核版本匹配。三者任一错位，都会在 insmod 或启动阶段暴露为符号缺失、非法指令或 vermagic 错误。

二、方法流程：从工具链到可启动系统

推荐按“工具链 → 内核源码 → 根文件系统 → 串口 → 网络”的顺序推进，每一步都可独立验证，避免问题叠加。

安装或构建工具链。优先使用芯片原厂或 Buildroot/Yocto 产出的工具链，保证与 BSP 匹配。安装后验证：

export CROSS_COMPILE=aarch64-linux-gnu-
export ARCH=arm64
${CROSS_COMPILE}gcc -v
${CROSS_COMPILE}gcc -dumpmachine
# 期望输出：aarch64-linux-gnu

获取内核源码。来源有三类：芯片原厂 BSP 内核、主线 kernel.org、发行版内核。板级联调优先用原厂 BSP，因其包含该 SoC 的时钟、引脚、电源域补丁。获取后切换分支并配置：

git clone --depth=1 -b linux-5.10.y \
  https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
cd linux
make ARCH=arm64 defconfig
make ARCH=arm64 menuconfig   # 打开所需驱动与调试选项
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j$(nproc) Image dtbs modules

制作根文件系统。根文件系统提供 init、shell、库和设备节点。可用 BusyBox 手工构建，也可用 Buildroot 一键生成。手工构建的核心步骤：

mkdir -p rootfs/{bin,sbin,etc,proc,sys,dev,lib,usr}
cd busybox && make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- defconfig
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- install CONFIG_PREFIX=../rootfs
cp -a /usr/aarch64-linux-gnu/lib/* rootfs/lib/
# 生成 init 与 inittab，打包为 ext4 或 cpio
genext2fs -b 65536 -d rootfs rootfs.ext4

配置串口调试。串口是目标板最早的可见通道，用于查看 U-Boot、内核启动日志和登录 shell。主机侧使用 minicom、picocom 或 screen：

sudo picocom -b 115200 -d 8 -p n -s 1 /dev/ttyUSB0
# 常见参数：115200 8N1，无流控
# 若乱码，优先核对波特率、时钟源与 GND 是否共地

配置网络调试。网络用于 NFS 挂载根文件系统、TFTP 下载内核、SSH 登录和 scp 传文件。目标板与主机需在同一网段，主机开启对应服务：

# 主机侧
sudo ip addr add 192.168.1.100/24 dev eth0
sudo systemctl start nfs-server tftpd-hpa sshd
# 目标板侧（U-Boot 或系统内）
ip addr add 192.168.1.50/24 dev eth0
ip link set eth0 up
ping 192.168.1.100

三、环境对象与验证要点

下表把五个核心对象、关键参数和验证方式集中对照，便于逐项排查。

对象	关键参数/文件	验证方式	常见失败现象
交叉编译工具链	CROSS_COMPILE、ARCH、ABI	gcc -dumpmachine、编译 hello 并 file 查看架构	非法指令、无法执行
内核源码	分支版本、defconfig、dtbs	make Image 成功、vermagic 与模块一致	insmod 报 version magic
根文件系统	init、/lib、/dev、inittab	串口出现 login 或 shell 提示符	Kernel panic: no init
串口调试	115200 8N1、/dev/ttyUSB0	能看到 U-Boot 与内核日志	乱码、无输出
网络调试	IP、NFS、TFTP、SSH	ping 通、mount -t nfs 成功	丢包、挂载超时

四、案例场景：一次典型的联调启动链

假设目标板为 AArch64 SoC，主机为 Ubuntu。上电后 U-Boot 从串口输出，通过 TFTP 加载 Image 与 dtb，再通过 NFS 挂载主机导出的 rootfs。此时驱动开发者只需替换 .ko 模块并重新 insmod，无需反复烧写整机镜像，迭代效率最高。

# U-Boot 环境变量示例
setenv ipaddr 192.168.1.50
setenv serverip 192.168.1.100
setenv bootargs console=ttyS0,115200 root=/dev/nfs \
  nfsroot=192.168.1.100:/srv/nfs/rootfs ip=192.168.1.50
tftpboot 0x40000000 Image
tftpboot 0x48000000 board.dtb
booti 0x40000000 - 0x48000000

当串口打印出内核版本、CPU 信息和 Run /sbin/init as init process，并且网络可 ping 通时，说明开发环境已具备驱动联调条件。

五、误区与复盘

工具链与内核不匹配：用主线 gcc 编译原厂 BSP 内核，可能因 GCC 版本过新触发编译错误。应优先使用 BSP 推荐版本。
只配串口不配网络：串口能看日志，但传文件、挂 NFS 效率低。两者应同时具备。
根文件系统缺少 /dev 与 /proc：驱动依赖的设备节点和 sysfs 无法生成，表现为 open 失败或 udev 不工作。
忽略 vermagic：内核与模块必须来自同一次编译，否则 insmod 直接拒绝。
网络未共地或 IP 冲突：串口正常但 ping 不通时，先查网线、网段和防火墙，再查目标板 MAC 与 PHY 驱动。

建议把工具链路径、ARCH、CROSS_COMPILE、NFS 导出目录、串口设备号写入一个 env.sh，每次联调前 source 一次，减少环境变量漂移带来的低级错误。

完成上述配置后，主机与目标板之间就形成了“编译—下载—运行—调试”的完整链路。后续驱动模块的加载、卸载、参数传递和日志分析，都建立在这条链路之上。