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

3. 开发环境搭建

BSP 板级适配的第一道门槛不是写驱动，而是把“能编译、能烧写、能看日志、能回滚”这条链路搭稳。开发主机（通常是 x86_64 Ubuntu）与目标板（ARM、AArch64、RISC-V 等）架构不同，必须依赖交叉编译工具链；同时串口负责早期启动日志与 U-Boot 交互，网络负责文件传输与 NFS 根文件系统调试，版本控制与构建系统则保证多人协作下产物可复现。本节按“工具链 → 主机环境 → 串口/网络调试 → 版本控制与构建”的顺序展开。

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

目标板资源有限，无法本地运行完整编译环境；而主机 CPU 指令集与目标板不同，普通 gcc 生成的机器码无法在目标板执行。交叉编译工具链由 binutils（as、ld、objcopy）、gcc、glibc/uClibc/musl、gdb 等组成，通过 --target 与 --prefix 绑定目标架构。工具链的 ABI（如 gnueabihf、gnueabi、musl）必须与目标板根文件系统一致，否则会出现“编译通过、运行段错误”的典型问题。

判断工具链是否匹配，先看三元组：arm-linux-gnueabihf- 表示 ARM 32 位、Linux、GNU、硬浮点；aarch64-linux-gnu- 表示 ARM 64 位。三元组与目标板 uname -m、readelf -h 输出必须对应。

二、主机环境配置

推荐使用 Ubuntu 20.04/22.04 LTS，安装基础依赖后，再放置工具链并配置环境变量。依赖包缺失是“configure 报错”的最常见原因。

sudo apt update
sudo apt install -y build-essential git bc bison flex \
  libssl-dev libncurses-dev device-tree-compiler \
  u-boot-tools minicom picocom tftp-hpa nfs-kernel-server \
  gcc-arm-linux-gnueabihf gcc-aarch64-linux-gnu

# 若使用厂商工具链，解压后加入 PATH
export ARCH=arm
export CROSS_COMPILE=arm-linux-gnueabihf-
export PATH=$PATH:/opt/toolchain/gcc-arm-10.3/bin
arm-linux-gnueabihf-gcc -v   # 验证版本与目标

环境变量建议写入 ~/.bashrc 或项目 env.sh，避免每个终端重复导出。注意 ARCH 与 CROSS_COMPILE 必须成对设置，内核、U-Boot、Buildroot 都依赖它们。

三、串口与网络调试环境

串口是目标板启动阶段唯一的“眼睛”。主机通过 USB 转 TTL 连接目标板 UART，使用 minicom 或 picocom 打开，参数通常为 115200 8N1。网络调试则依赖 TFTP 下载内核/设备树、NFS 挂载根文件系统，可大幅减少反复烧写 eMMC 的时间。

# 串口
sudo picocom -b 115200 /dev/ttyUSB0
# 退出：Ctrl-A 再按 Ctrl-X

# 主机 IP 与 TFTP 根目录
sudo ip addr add 192.168.1.100/24 dev eth0
sudo systemctl restart tftpd-hpa

# NFS 导出
echo "/srv/nfs/rootfs *(rw,sync,no_subtree_check,no_root_squash)" | \
  sudo tee -a /etc/exports
sudo exportfs -ra

目标板 U-Boot 中常用命令如下，用于验证网络与启动参数：

setenv ipaddr 192.168.1.10
setenv serverip 192.168.1.100
tftp 0x80000000 zImage
tftp 0x83000000 exynos4412.dtb
setenv bootargs console=ttySAC0,115200 root=/dev/nfs \
  nfsroot=192.168.1.100:/srv/nfs/rootfs ip=192.168.1.10
bootz 0x80000000 - 0x83000000

串口无输出时，先确认 TX/RX 是否交叉、GND 是否共地、波特率是否一致；网络不通时，先用 ping 验证主机与目标板同网段，再检查防火墙与 TFTP/NFS 服务状态。

四、版本控制与构建系统

BSP 涉及内核、U-Boot、设备树、根文件系统多个仓库，建议用 repo 或 git submodule 统一管理，并为每个仓库打上版本标签。构建系统方面，Yocto/Buildroot 适合生成完整发行版，手工 Makefile 适合快速验证单模块。无论哪种方式，都应把“配置、补丁、产物”纳入版本控制。

环节	常用工具	关键产物/命令	常见问题
工具链	gcc-arm-linux-gnueabihf	`arm-linux-gnueabihf-gcc -v`	ABI 不匹配、PATH 未生效
主机依赖	apt	`build-essential bc bison flex`	缺少 libssl-dev 导致编译中断
串口	picocom/minicom	`/dev/ttyUSB0 115200`	TX/RX 反接、权限不足
网络调试	tftp-hpa、nfs-kernel-server	`tftp`、`nfsroot=`	IP 不同段、防火墙拦截
版本控制	git、repo	`git tag`、`repo sync`	补丁丢失、分支混乱
构建系统	Buildroot/Yocto	`make menuconfig`、`bitbake`	配置未保存、产物不可复现

五、案例与复盘

某项目在主机上编译内核成功，但目标板启动后卡在 “Starting kernel ...”。排查发现设备树由旧工具链编译，bootargs 中的 console=ttySAC0 与实际 UART 编号不符，且 NFS 路径未导出。修正串口参数、重新导出 NFS 后正常启动。该案例说明：交叉编译只是第一步，串口与网络调试环境必须同步验证。

常见误区：① 只设置 CROSS_COMPILE 而忘记 ARCH；② 用 root 运行 NFS 且未加 no_root_squash，导致目标板无法写文件；③ 把工具链放在带空格的路径下，Makefile 解析失败；④ 不记录工具链版本，换人后无法复现构建。

建议把环境搭建固化为脚本：setup_host.sh 安装依赖、env.sh 导出变量、flash.sh 执行 TFTP/NFS 启动。这样新成员加入时，只需执行脚本即可获得一致的开发环境，为后续 BSP 适配打下稳定基础。