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

3. 开发环境搭建

车载Linux BSP板级适配的第一步，不是改代码，而是把“能编译、能烧写、能连板、能看日志”这条链路打通。开发环境搭建的质量，直接决定后续驱动移植、内核裁剪、设备树调整的效率。本节围绕交叉编译工具链、SDK获取、主机环境配置、目标板连接与调试通道四个环节，给出可落地的工程方法。

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

车载SoC（如NXP i.MX8、TI TDA4、瑞萨R-Car、地平线J5等）通常采用ARM64或ARM32架构，而开发主机是x86_64。目标板资源有限，无法承载完整编译过程，因此需要在主机上使用交叉编译工具链，生成能在目标架构上运行的二进制。工具链的核心组成包括：

binutils：汇编器、链接器、objcopy、readelf等，负责目标文件处理。
gcc：C/C++编译器，决定生成代码的指令集与ABI。
glibc或musl：目标根文件系统的C库，必须与工具链匹配。
sysroot：目标系统的头文件与库集合，是交叉编译能否找到依赖的关键。

工具链的ABI、浮点策略、C库版本必须与目标板BSP一致。用错工具链，常见现象是编译通过但运行时报“No such file or directory”或“Illegal instruction”。

二、SDK获取与目录结构

车载项目一般由芯片原厂或Tier1提供BSP SDK，常见形式是Yocto工程、Buildroot工程或厂商自研构建脚本。获取渠道包括官方Git、客户支持门户、NDA交付包。拿到SDK后，先确认版本与目标板硬件版本对应，再检查是否自带预编译工具链。

# 典型SDK目录结构
sdk/
├── environment-setup-aarch64-poky-linux   # 环境初始化脚本
├── sysroots/                              # 目标sysroot
├── toolchain/                             # 交叉工具链
├── sources/                               # 内核、uboot、驱动源码
├── build/                                 # 构建输出
└── meta-xxx/                              # Yocto layer

若SDK未自带工具链，可从Linaro、ARM官方或芯片厂商下载对应版本。建议优先使用SDK自带工具链，避免版本漂移。

三、主机环境配置

推荐使用Ubuntu 20.04/22.04 LTS，磁盘预留至少200GB，内存16GB以上。安装基础依赖：

sudo apt update
sudo apt install -y build-essential git curl wget \
  python3 python3-pip flex bison libssl-dev \
  libncurses-dev device-tree-compiler \
  minicom picocom tftp-hpa nfs-kernel-server

随后初始化SDK环境，使交叉编译器进入PATH：

source ./environment-setup-aarch64-poky-linux
aarch64-poky-linux-gcc -v

若输出目标架构与版本信息，说明工具链可用。此时CC、CROSS_COMPILE等变量通常已被设置，可直接编译内核与驱动。

四、目标板连接与调试通道

目标板连接分为串口控制台、网络通道、调试器通道三类。串口用于查看U-Boot与内核启动日志，是排障第一入口；网络用于TFTP下载镜像、NFS挂载根文件系统、SSH登录；JTAG/SWD用于早期启动失败或内核挂死时的硬件级调试。

串口参数通常为115200-8-N-1，连接命令示例：

sudo minicom -D /dev/ttyUSB0 -b 115200
# 或
picocom -b 115200 /dev/ttyUSB0

网络调试前，需在主机配置TFTP根目录与NFS导出：

# /etc/default/tftpd-hpa
TFTP_DIRECTORY="/srv/tftp"

# /etc/exports
/srv/nfs/rootfs *(rw,sync,no_root_squash,no_subtree_check)

五、环境验证清单

检查项	验证命令/方法	预期结果
交叉编译器	`aarch64-poky-linux-gcc -v`	显示目标架构与版本
sysroot	`ls $SDKTARGETSYSROOT/usr/include`	存在目标头文件
串口	minicom连接后上电	看到U-Boot启动日志
TFTP	`tftp localhost get test`	文件传输成功
NFS	目标板`mount -t nfs`	根文件系统挂载成功
内核编译	`make ARCH=arm64 defconfig`	生成.config无报错

六、常见误区与复盘

误区一：工具链与内核版本不匹配。用新版gcc编译老内核，可能因插件或头文件变化报错。应优先使用SDK自带工具链。

误区二：串口无输出就怀疑板子坏。先确认波特率、TX/RX是否交叉、地线是否连接、串口是否被其他进程占用。

误区三：NFS挂载失败只查网络。还需检查/etc/exports权限、防火墙、目标板内核是否启用NFS客户端。

误区四：忽略主机时间与locale。Yocto构建对时间敏感，时间偏差过大会导致任务失败。

建议在环境搭建完成后，立即做一次“最小闭环”验证：编译一个hello程序，通过TFTP下载到目标板，串口执行并看到输出。这个闭环打通后，后续所有板级适配工作都有了可靠的基础。

环境搭建不是一次性任务，而是贯穿BSP适配全过程的支撑体系。工具链、SDK、主机、目标板四者版本与配置必须保持一致，任何一处漂移都可能在后期以难以定位的故障形式暴露。把本节清单固化为团队检查表，可以显著降低联调阶段的返工成本。