📚 课程目录第4章交叉编译工具链与内核源码管理

4. 交叉编译工具链与内核源码管理

在 R-Car 车载 Linux 平台开发中，交叉编译工具链与内核源码管理是贯穿整个项目生命周期的两条主线。工具链决定了“用什么编译”，源码管理决定了“编译什么、如何演进”。本节围绕 Renesas R-Car SDK 提供的交叉编译器安装、内核 defconfig 配置、使用 devtool 修改驱动，以及内核补丁与版本升级管理展开，目标是让读者能够独立完成一次从环境搭建到驱动修改、再到补丁维护的完整闭环。

一、安装 R-Car SDK 交叉编译器

R-Car 平台通常采用 AArch64（ARMv8-A）架构，主机为 x86_64 Linux。Renesas 官方通过 Yocto/OpenEmbedded 提供 SDK，其中包含交叉编译器、sysroot、内核源码与 BSP 层。安装方式有两种：一是直接使用官方预编译 SDK 安装脚本，二是通过 Yocto 自行构建 SDK。前者适合快速上手，后者适合需要定制工具链版本或补丁的场景。

以官方 SDK 为例，安装过程如下：

# 1. 下载 SDK 安装脚本（示例文件名）
chmod +x poky-glibc-x86_64-core-image-weston-aarch64-rcar-toolchain-*.sh

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

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

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

执行 environment-setup-* 后，环境变量 CC、CXX、LD、CFLAGS、LDFLAGS、PKG_CONFIG_SYSROOT_DIR 等会被自动设置。此时直接运行 make 或 cmake 即可完成交叉编译，无需手动指定 --host。判断工具链是否可用，除了查看版本号，还应确认 --sysroot 指向 SDK 内的 sysroot，且 aarch64-poky-linux-gcc -print-sysroot 返回的路径存在。

若主机同时存在多个 SDK，建议在每次编译前重新 source 对应环境脚本，避免 sysroot 与工具链版本错配导致链接错误。

二、配置内核 defconfig

R-Car BSP 内核源码通常位于 build/tmp/work-shared/<machine>/kernel-source 或独立 git 仓库中。配置内核的第一步是选择与目标板匹配的 defconfig。R-Car 常见 defconfig 命名如 rcar_defconfig、rcar-gen3_defconfig、rcar-gen4_defconfig，具体取决于 SoC 代际与 BSP 版本。

# 进入内核源码目录
cd /opt/rcar-sdk/kernel-source

# 使用 R-Car defconfig 生成 .config
make ARCH=arm64 CROSS_COMPILE=aarch64-poky-linux- rcar_defconfig

# 按需微调配置
make ARCH=arm64 CROSS_COMPILE=aarch64-poky-linux- menuconfig

# 编译内核与设备树
make ARCH=arm64 CROSS_COMPILE=aarch64-poky-linux- -j$(nproc) Image dtbs

defconfig 是“基线配置”，menuconfig 中的修改会写入 .config，但不会自动回写 defconfig。若希望修改持久化，应使用 make savedefconfig 生成精简配置，再替换原 defconfig。判断配置是否生效，可检查 .config 中目标选项是否为 =y 或 =m，并确认 Image 与 dtbs 生成成功。

三、使用 devtool 修改驱动

在 Yocto 环境中，直接修改内核源码树中的驱动文件虽然可行，但不利于版本管理和复现。推荐使用 devtool 工作流：先 devtool modify 将内核源码检出到工作区，修改后 devtool build 验证，最后 devtool finish 将改动整理为补丁并回写到 BSP 层。

# 1. 检出内核源码到工作区
devtool modify linux-renesas

# 2. 进入工作区源码目录
cd build/workspace/sources/linux-renesas

# 3. 修改驱动，例如增加调试打印
#    编辑 drivers/net/ethernet/renesas/ravb_main.c

# 4. 编译验证
devtool build linux-renesas

# 5. 部署到目标板测试
devtool deploy-target linux-renesas root@192.168.1.10

# 6. 整理补丁并回写
devtool finish linux-renesas meta-rcar

devtool finish 会在 BSP 层生成 .bbappend 与补丁文件，补丁按提交顺序命名。若修改涉及多个文件，建议在源码目录内先 git add 并 git commit，使每个逻辑改动对应一个提交，便于后续审查与回退。

四、内核补丁与版本升级管理

内核补丁管理应遵循“小步提交、单一职责、可回退”的原则。每个补丁只解决一个问题，提交信息需说明背景、改动点与验证方式。补丁文件通常放在 BSP 层的 recipes-kernel/linux/linux-renesas/ 目录下，通过 .bbappend 中的 SRC_URI 引入。

# 示例：meta-rcar/recipes-kernel/linux/linux-renesas_%.bbappend
FILESEXTRAPATHS:prepend := "${THISDIR}/${PN}:"

SRC_URI += " \
    file://0001-ravb-add-debug-print.patch \
    file://0002-rcar-gen3-fix-clock-init.patch \
"

版本升级时，应先确认新内核版本与 BSP 层的兼容性，再逐步 rebase 现有补丁。若补丁无法直接应用，可使用 devtool modify 重新检出，手动解决冲突后重新生成补丁。升级后必须重新验证 defconfig、设备树与关键驱动，确保启动、网络、存储等基础功能正常。

五、实践中的常见问题与判断依据

工具链安装后若出现 cannot find -lc 或 skipping incompatible，通常是 sysroot 未正确设置或主机编译器被误用。此时应检查 CC 是否指向 aarch64-poky-linux-gcc，并确认 --sysroot 路径存在。内核编译阶段若报 No rule to make target 'dtbs'，说明 defconfig 未启用设备树支持或架构选择错误，应确认 ARCH=arm64 且 CONFIG_OF 为 y。

使用 devtool 修改驱动后，若 devtool build 成功但板端无变化，需检查 deploy-target 是否覆盖了目标路径，以及内核模块是否已 insmod 或驱动是否已编译进内核。补丁管理方面，若 devtool finish 后补丁未生效，应检查 .bbappend 中 SRC_URI 的路径与文件名是否匹配，并确认 FILESEXTRAPATHS 指向正确目录。

内核版本升级后，原有补丁可能因上下文变化而无法应用。建议在升级前先备份当前 BSP 层与补丁集，升级后逐条验证补丁，避免一次性引入过多变更导致问题难以定位。

综合来看，R-Car 交叉编译工具链与内核源码管理并非孤立步骤，而是一条从环境准备、配置、修改到版本演进的完整链路。掌握 SDK 安装与验证、defconfig 的持久化方法、devtool 的驱动修改流程，以及补丁与版本升级的规范，才能在实际项目中保证内核的可维护性与可复现性。