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

4. 开发环境搭建

R-Car BSP 的构建不是“在目标板上直接编译”，而是在一台性能稳定的 Linux 主机上完成内核、U-Boot、根文件系统与 Yocto 镜像的交叉编译，再通过串口、网络或存储介质部署到目标板。因此，主机环境是否规范，直接决定后续 30 个章节中构建、调试、排障能否顺利进行。本节从主机要求、工具链安装、依赖包管理、网络与串口调试四个维度，给出可落地的环境搭建方法。

一、主机环境要求：先定基线，再谈构建

R-Car 系列（如 H3/M3、V3H/V3M、D3、S4 等）BSP 通常基于 Yocto Project 或官方 SDK，构建过程会占用大量 CPU、内存和磁盘 I/O。主机环境建议遵循以下基线：

操作系统：Ubuntu 20.04 LTS 或 22.04 LTS（64 位），官方 BSP 文档通常以 Ubuntu 为参考；不建议使用滚动发行版，避免依赖版本漂移。
CPU：4 核以上，推荐 8 核；Yocto 的 bitbake 支持并行任务，核心数直接影响首次构建时间。
内存：最低 8 GB，推荐 16 GB 及以上；链接大型镜像时内存不足会导致 OOM 或编译中断。
磁盘：至少 200 GB 可用空间，推荐 SSD；Yocto 的 build/、sstate-cache/、downloads/ 会快速膨胀。
文件系统：使用区分大小写的 ext4；若在 Windows 下通过虚拟机或 WSL 构建，需注意大小写与符号链接支持问题。
权限：具备 sudo 权限，用于安装依赖包和配置串口设备权限。

建议为 BSP 构建单独准备一台主机或虚拟机，避免与日常办公环境混用；同时固定主机名、时区和用户目录，便于团队复现构建结果。

二、交叉编译工具链安装：区分“SDK 自带”与“独立工具链”

R-Car BSP 的交叉编译工具链通常有两种来源：一是 Yocto 构建时自动生成的 SDK（meta-toolchain 或 populate_sdk），二是芯片厂商提供的独立工具链（如 aarch64-poky-linux、arm-linux-gnueabi 等）。推荐优先使用 BSP 配套 SDK，以保证 libc、内核头文件与目标 rootfs 一致。

安装 SDK 的典型流程如下：

# 1. 获取 SDK 安装脚本（由 Yocto 构建生成）
ls tmp/deploy/sdk/
# 例如：poky-glibc-x86_64-core-image-weston-aarch64-toolchain-3.1.sh

# 2. 安装 SDK 到指定目录
chmod +x poky-glibc-x86_64-core-image-weston-aarch64-toolchain-3.1.sh
./poky-glibc-x86_64-core-image-weston-aarch64-toolchain-3.1.sh -d /opt/rcar-sdk

# 3. 激活环境变量
source /opt/rcar-sdk/environment-setup-aarch64-poky-linux

# 4. 验证交叉编译器
aarch64-poky-linux-gcc --version
echo $CC
echo $CROSS_COMPILE

若使用独立工具链，则需手动将 bin/ 加入 PATH，并设置 CROSS_COMPILE 与 ARCH。注意：工具链的 sysroot 必须与目标板 rootfs 的库版本匹配，否则会出现“编译通过、运行报错”的典型问题。

三、依赖包管理：一次性装齐，避免反复中断

Yocto 与内核构建依赖大量主机工具和库。建议在 Ubuntu 上一次性安装官方文档列出的依赖包，减少构建中途因缺包失败。常用依赖如下：

sudo apt update
sudo apt install -y gawk wget git diffstat unzip texinfo gcc build-essential \
  chrpath socat cpio python3 python3-pip python3-pexpect xz-utils debianutils \
  iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev \
  pylint3 xterm python3-subunit mesa-common-dev zstd liblz4-tool file locales \
  libssl-dev bc flex bison libncurses5-dev libelf-dev

此外，还需注意 Python 版本与 pip 包管理：部分 BSP 脚本依赖 python3 的特定模块，建议使用系统自带 Python，不要随意替换为 conda 或 pyenv 环境，以免 bitbake 找不到模块。

依赖类别	典型包/工具	作用	常见问题
编译工具	gcc、g++、make、flex、bison	编译内核、U-Boot、应用	版本过低导致语法不兼容
脚本与解析	python3、perl、gawk、sed	Yocto 元数据解析与构建脚本	Python 模块缺失
打包与压缩	tar、zip、xz、zstd、lz4	生成镜像与根文件系统	缺少 zstd 导致镜像打包失败
网络与调试	git、wget、curl、socat、minicom	拉取源码、串口与网络调试	代理未配置导致下载超时
库与头文件	libssl-dev、libncurses5-dev、libelf-dev	内核配置与加密模块编译	头文件缺失导致 menuconfig 失败

四、网络与串口调试环境配置：打通“主机—目标板”链路

目标板启动后，最常用的两条调试通道是串口和网络。串口用于查看 U-Boot、内核启动日志，网络用于 scp、nfs、tftp 和 ssh 传输文件与远程登录。

串口配置：使用 USB 转 TTL 串口线连接目标板调试串口，确认设备节点（如 /dev/ttyUSB0），并加入 dialout 组：

sudo usermod -aG dialout $USER
sudo chmod 666 /dev/ttyUSB0
# 使用 minicom 或 picocom
sudo apt install -y minicom
minicom -D /dev/ttyUSB0 -b 115200

网络配置：推荐为主机配置静态 IP，并通过 dnsmasq 或 tftp-hpa 提供 TFTP/NFS 服务。目标板 U-Boot 中常用 tftp 加载内核与设备树，内核启动后通过 NFS 挂载根文件系统：

# 主机安装 TFTP 与 NFS 服务
sudo apt install -y tftpd-hpa nfs-kernel-server

# 配置 TFTP 根目录
sudo mkdir -p /srv/tftp
sudo chown tftp:tftp /srv/tftp

# 目标板 U-Boot 中设置网络参数
setenv ipaddr 192.168.1.100
setenv serverip 192.168.1.10
setenv gatewayip 192.168.1.1
tftp 0x48000000 Image
tftp 0x49000000 r8a77951-ulcb.dtb
booti 0x48000000 - 0x49000000

串口与网络配置中最常见的误区是：主机防火墙未关闭、TFTP 目录权限不足、NFS 导出路径未加 no_root_squash，导致目标板能 ping 通却无法加载文件。建议先用 ping、tftp 客户端、showmount -e 逐项验证。

五、案例与复盘：一次典型的“构建失败”排查

某团队在 Ubuntu 22.04 上首次构建 R-Car H3 BSP，bitbake core-image-weston 在编译 openssl 时中断，日志提示缺少 libssl-dev 与 perl 模块。复盘发现：主机只安装了基础开发包，未按 BSP 文档安装完整依赖；同时 /opt 分区剩余空间不足 20 GB，导致 SDK 安装不完整。解决方法是：按官方依赖清单补齐包、将 SDK 安装到独立大容量分区、清理 sstate-cache 后重新构建。该案例说明，环境搭建不是“装完即用”，而应通过一次完整构建来验证主机基线是否达标。

完成以上四步后，建议用一条最小闭环验证环境：主机上激活 SDK，编译一个 hello 程序，通过 TFTP 或 scp 传到目标板，在串口终端中运行并确认输出。只有这条链路全部打通，后续的内核裁剪、驱动移植和镜像定制才有稳定的基础。