📚 课程目录第2章开发环境与工具链搭建

2. 开发环境与工具链搭建

R-Car车载计算平台的开发环境不是单一工具，而是一条从宿主机到目标板的完整工具链。宿主机负责编辑、交叉编译和镜像构建，目标板负责运行；两者之间通过串口、JTAG/TRACE32和网络连接。本节以R-Car H3/M3这类典型SoC为例，说明如何把这条链路搭起来，并让第一个Hello World真正跑在目标板上。

一、工具链的组成与职责划分

先明确各组件在链路中的位置，避免把“编译成功”误当成“板子能跑”。

R-Car SDK：Renesas提供的集成开发包，包含交叉编译器、库、示例代码和部分板级支持，适合快速验证和驱动开发。
Yocto BSP：用于构建完整Linux镜像（U-Boot、Kernel、Rootfs），适合产品化定制和系统级调试。
交叉编译工具链：在x86宿主机上生成ARM64目标代码，如aarch64-poky-linux-gcc。
调试探针：JTAG用于内核/UBoot早期调试，TRACE32用于指令级跟踪和性能分析。
串口终端：目标板的“控制台”，用于查看启动日志、登录系统和执行命令。

这五者不是并列关系，而是有明确的信号与数据流向：宿主机编译产物经网络或存储介质送到目标板，串口回传运行日志，JTAG/TRACE32在需要时介入底层调试。

二、安装R-Car SDK与交叉编译工具链

R-Car SDK通常以安装包或Yocto SDK形式提供。以Yocto生成的SDK为例，安装过程如下：

# 1. 下载并赋予执行权限
chmod +x poky-glibc-x86_64-core-image-weston-aarch64-toolchain-*.sh

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

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

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

激活后，CC、CXX、LD等变量会自动指向交叉工具链。此时编译出的可执行文件是ARM64格式，可用file命令确认：

file hello
# 输出应包含：ELF 64-bit LSB executable, ARM aarch64

如果输出是x86_64，说明环境未激活或编译器选错，这是初学者最常见的错误之一。

三、Yocto BSP构建与镜像产出

Yocto BSP用于生成完整系统镜像。典型流程是：

# 初始化构建环境
source poky/oe-init-build-env build

# 配置目标机器
echo 'MACHINE = "rcar-h3"' >> conf/local.conf

# 构建核心镜像
bitbake core-image-weston

构建完成后，在tmp/deploy/images/rcar-h3/下会得到Image、*.dtb、core-image-weston-*.tar.bz2等文件。这些就是后续通过TFTP或SD卡送到目标板的产物。Yocto首次构建耗时较长，建议使用BB_NUMBER_THREADS和PARALLEL_MAKE匹配宿主机CPU核心数。

四、串口终端与目标板连接

串口是目标板的“生命线”。R-Car开发板通常使用FTDI或CP210x芯片，连接后宿主机出现/dev/ttyUSB0。使用minicom或picocom连接：

sudo picocom -b 115200 /dev/ttyUSB0

上电后应能看到U-Boot和Kernel日志。若乱码，检查波特率是否为115200、数据位8、停止位1、无校验。若完全无输出，检查串口线是否交叉、TX/RX是否接反、板子是否真正上电。

五、JTAG/TRACE32调试探针配置

JTAG用于在U-Boot或Kernel启动早期介入调试。TRACE32需要配置以下要素：

CPU类型：选择R-Car H3/M3对应的Cortex-A57/A53配置。
JTAG时钟：初始建议降频到1MHz，稳定后再提高。
符号表：加载vmlinux或u-boot的ELF文件，才能按函数名下断点。
初始化脚本：配置DDR、时钟和引脚复用，否则无法访问内存。

一个典型的TRACE32启动脚本片段如下：

SYStem.CPU RCarH3
SYStem.JtagClock 1MHz
SYStem.Up
Data.LOAD.Elf vmlinux /NoClear
Break.Set main

当JTAG连接正常时，TRACE32能读到CPU ID和当前PC值；若报“JTAG chain broken”，优先检查探针供电、排线方向和复位信号。

六、Hello World的交叉编译与部署

编写一个最小程序：

#include <stdio.h>
int main(void) {
    printf("Hello R-Car!\n");
    return 0;
}

交叉编译：

aarch64-poky-linux-gcc -o hello hello.c --sysroot=$SDKTARGETSYSROOT

部署到目标板有三种常用方式：

TFTP：在U-Boot中用tftp下载到内存，再bootm或写入存储。
NFS：目标板挂载宿主机NFS目录，直接运行hello，适合频繁修改。
SCP/SD卡：系统启动后通过网络或读卡器复制到rootfs。

以NFS为例，目标板启动后执行：

mount -t nfs -o nolock 192.168.1.100:/nfsroot /mnt
/mnt/hello
# 预期输出：Hello R-Car!

七、运行结果判断与常见问题

看到Hello R-Car!说明交叉编译、部署和运行链路全部打通。若没有输出，按以下顺序排查：

现象	可能原因	检查方法
执行时报“cannot execute binary file”	编译成了x86_64	`file hello`确认架构
报“No such file or directory”	动态链接器路径不匹配	用`-static`重新编译或检查sysroot
串口无任何输出	波特率/接线/供电问题	换线、确认115200、测TX/RX
TRACE32连不上	JTAG时钟过快或初始化脚本缺失	降频到1MHz，补DDR初始化

建议把“编译→部署→运行→看串口”做成一个可重复的脚本，每次修改代码后一键执行，减少手工操作带来的变量。

至此，宿主机上的SDK、Yocto、交叉工具链、TRACE32与目标板上的U-Boot、Kernel、Rootfs、串口形成了完整闭环。后续所有性能优化与调试工作，都建立在这条链路稳定可用的基础之上。