📚 课程目录第3章 R-Car ADAS平台开发环境搭建

3. R-Car ADAS平台开发环境搭建

R-Car ADAS平台的软件开发不是“装一个IDE就能跑”的桌面式流程，而是一条从官方发布源到板端可运行镜像的完整工具链。理解这条链路的构成与依赖关系，是后续所有驱动移植、感知算法部署和系统调优的前提。本节围绕五个环节展开：官方SDK与BSP获取、交叉编译工具链、Yocto构建系统、开发板启动与调试串口、基础镜像烧录。

一、官方SDK与BSP的获取与版本对齐

Renesas为R-Car系列提供两类关键资源：一类是面向Linux的Yocto BSP（Board Support Package），包含u-boot、Linux内核、设备树、驱动补丁和Yocto层配置；另一类是面向ADAS/自动驾驶的SDK，例如面向R-Car V3H/V3M/V4H的ADAS SDK，内含感知库、硬件加速接口、参考应用和样例数据。二者版本必须严格对齐，否则会出现内核与用户态库ABI不匹配、加速器驱动缺失等问题。

获取渠道主要有两个：Renesas官网的R-Car产品页面（需注册账号并签署NDA才能下载部分ADAS SDK组件），以及Renesas GitHub上的公开Yocto层（如meta-renesas）。下载后建议先核对发布说明中的版本矩阵，例如“BSP v5.0 + ADAS SDK v3.2 + Yocto Kirkstone”，并记录对应的Linux内核版本（如5.10.x）和u-boot版本。这一步看似简单，却是后续构建失败最常见的根因之一。

建议在项目根目录建立 docs/version-matrix.md，记录BSP、SDK、Yocto、内核、工具链五者的版本对应关系，每次升级前先更新此表。

二、交叉编译工具链的建立

R-Car SoC采用ARM Cortex-A系列（如A76/A55）作为应用核，因此开发主机（通常为x86_64 Ubuntu 20.04/22.04）需要一套aarch64交叉编译工具链。最稳妥的方式是直接使用Yocto构建出的SDK工具链，而不是系统apt安装的gcc-aarch64-linux-gnu，因为前者与BSP的glibc版本、内核头文件完全一致。

典型做法是：先用Yocto生成工具链安装包，再安装到主机。命令示例如下：

# 在Yocto构建目录中生成SDK安装包
bitbake core-image-weston -c populate_sdk

# 生成的安装脚本位于 tmp/deploy/sdk/
# 例如：poky-glibc-x86_64-core-image-weston-aarch64-toolchain-3.1.sh
./poky-glibc-x86_64-core-image-weston-aarch64-toolchain-3.1.sh

# 安装后source环境
source /opt/poky/3.1/environment-setup-aarch64-poky-linux

# 验证
aarch64-poky-linux-gcc --version
echo $CC

安装完成后，$CC、$CXX、$SDKTARGETSYSROOT等变量会被自动设置。编译单个驱动模块时，可直接使用$CC；编译内核模块时，则需指向BSP内核源码目录，并确保ARCH=arm64、CROSS_COMPILE=aarch64-poky-linux-。

三、Yocto构建系统与镜像定制

Yocto是R-Car BSP的构建框架，其核心概念包括：Layer（层，如meta-renesas、meta-rcar-gen4）、Recipe（.bb文件，描述如何获取和编译软件）、Image（最终镜像，如core-image-minimal、core-image-weston）。构建流程通常如下：

克隆BSP的Yocto层，并初始化构建环境：source poky/oe-init-build-env build。
在conf/bblayers.conf中加入meta-renesas、meta-rcar-gen4等层路径。
在conf/local.conf中设置MACHINE（如r8a779g0对应R-Car V4H）、DISTRO、并行编译数BB_NUMBER_THREADS和PARALLEL_MAKE。
执行bitbake core-image-weston或自定义镜像配方。

构建产物位于tmp/deploy/images/<machine>/，通常包括：Image（内核）、*.dtb（设备树）、u-boot.bin、core-image-weston-*.rootfs.tar.bz2或.wic镜像。若需要加入ADAS SDK的库和样例，可在自定义layer中编写recipe，将SDK的预编译库安装到rootfs的/opt/adas目录。

Yocto首次构建耗时较长（数小时），建议配置DL_DIR和SSTATE_DIR到本地大容量磁盘，并启用BB_HASHSERVE加速后续构建。

四、开发板启动与调试串口

R-Car开发板（如R-Car V4H参考板）通常提供调试串口（UART，默认115200-8N1）和系统控制台。上电前需连接串口线到主机，使用minicom或picocom打开：

picocom -b 115200 /dev/ttyUSB0

上电后，u-boot会输出启动日志，可在此阶段按任意键进入u-boot命令行，检查printenv中的bootargs、bootcmd、fdt_addr_r等变量。常见启动方式有两种：从eMMC/SD卡启动，或通过TFTP+NFS网络启动。调试阶段推荐网络启动，便于快速替换内核和rootfs。

若串口无输出，应依次检查：串口线是否交叉、波特率是否正确、板卡是否处于正确启动模式（拨码开关）、电源是否稳定。若u-boot有输出但内核卡住，则需检查设备树是否匹配、bootargs中的console=参数是否正确。

五、基础镜像烧录与首次启动验证

烧录方式取决于启动介质。对于SD卡，可直接使用dd写入.wic镜像：

sudo dd if=core-image-weston-r8a779g0.wic of=/dev/sdX bs=4M conv=fsync
sync

对于eMMC，通常通过u-boot的fastboot或ums命令将eMMC模拟为U盘，再从主机写入。烧录完成后，重新上电，观察串口日志是否依次出现u-boot、内核解压、根文件系统挂载、systemd启动。若成功进入登录提示符，说明基础镜像可用。

首次启动后，建议执行以下验证：uname -a确认内核版本；cat /proc/device-tree/model确认设备树匹配；ls /dev/ttySC*确认串口设备；ip link确认网络接口。若需要运行ADAS样例，还需确认/opt/adas下的库和可执行文件是否存在，以及加速器设备节点（如/dev/vsp、/dev/drp）是否就绪。