基于RK3568的Yocto环境搭建与优化实践

1. 从零开始搭建RK3568的Yocto环境

第一次接触RK3568和Yocto的时候，我完全被各种术语和工具链搞晕了。后来在实际项目中摸爬滚打了几次，才发现只要把环境搭建好，后面的开发就会顺利很多。这里分享下我的经验，希望能帮你少走弯路。

首先得准备一台64位的Ubuntu主机，我推荐用22.04 LTS版本，稳定性有保障。记得安装前检查下磁盘空间，建议至少预留100GB，因为Yocto编译过程中会产生大量中间文件。安装完系统后，第一件事就是配置编译环境：

sudo apt update sudo apt install -y gawk wget git-core diffstat unzip texinfo gcc \ multilib 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 g++ \ libstdc++6 lib32stdc++6 libpulse-dev libevent-dev ninja-build \ rpm2cpio libswitch perl

这个命令看起来很长，但其实就是在安装各种编译工具和依赖库。我建议直接复制粘贴执行，避免手动输入出错。安装完成后，最好检查下关键工具的版本：

git --version # 需要1.8.3.1或更高 tar --version # 需要1.27.1或更高 python3 --version # 需要3.6.0或更高 gcc --version # 需要5.0或更高

如果发现版本不达标，可以通过apt升级或者手动编译安装新版。接下来要配置repo工具，这是管理Yocto源码的关键：

mkdir -p ~/.bin echo 'export PATH="${HOME}/.bin:${PATH}"' >> ~/.bashrc source ~/.bashrc curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo chmod a+rx ~/.bin/repo

这里有个小技巧：把PATH配置写入.bashrc，这样每次打开终端都会自动加载。我曾经忘记配置PATH，结果每次都要手动指定repo路径，特别麻烦。

2. 获取和配置Yocto源码

有了基础环境，接下来就是获取Yocto源码。Rockchip官方提供了针对RK3568的BSP层，我们需要先初始化repo：

mkdir rk3568-yocto && cd rk3568-yocto repo init -u https://github.com/rockchip-linux/manifests -b master -m rk356x_linux_release.xml repo sync -j$(nproc)

这个过程可能会比较久，取决于你的网络状况。我建议在晚上执行，第二天早上就能用上。第一次同步时，我遇到了几个坑：

• 网络中断导致同步失败，需要重新执行repo sync
• 磁盘空间不足，建议至少预留50GB给源码
• 权限问题，确保你有足够的权限在目标目录操作

同步完成后，你会看到一个完整的Yocto目录结构。接下来初始化构建环境：

source poky/oe-init-build-env build

这个命令会创建一个build目录，并设置好各种环境变量。第一次执行时可能会报错，通常是因为缺少某些依赖，根据提示安装即可。

3. 配置RK3568的BSP层

Rockchip的BSP层包含了很多针对RK3568的优化和驱动支持。我们需要在local.conf中启用这些配置：

echo 'MACHINE = "rk3568-evb"' >> conf/local.conf echo 'DISTRO = "poky"' >> conf/local.conf echo 'PACKAGE_CLASSES = "package_rpm"' >> conf/local.conf echo 'EXTRA_IMAGE_FEATURES = "debug-tweaks"' >> conf/local.conf echo 'USER_CLASSES = "buildstats image-mklibs image-prelink"' >> conf/local.conf echo 'PATCHRESOLVE = "noop"' >> conf/local.conf echo 'BB_DISKMON_DIRS = "STOPTASKS,${TMPDIR},1G,100K WARN,${TMPDIR},512M,40K"' >> conf/local.conf

这些配置做了几件事：

• 指定目标设备为rk3568-evb
• 使用poky发行版
• 启用RPM包管理
• 添加调试功能
• 设置磁盘空间监控

我强烈建议在第一次构建前检查下BBLAYERS变量，确保包含了Rockchip的BSP层：

bitbake-layers show-layers

如果缺少某些层，可以通过bitbake-layers add-layer命令添加。

4. 构建基础镜像

现在可以开始构建第一个镜像了。对于初次尝试，建议从最小镜像开始：

bitbake core-image-minimal

这个命令会启动构建过程，可能需要几个小时，取决于你的硬件配置。我的经验是：

• 16核CPU+32GB内存的机器大约需要2小时
• 8核CPU+16GB内存的机器大约需要4小时
• 笔记本上可能需要8小时以上

构建过程中可能会遇到各种错误，最常见的是：

• 网络问题导致下载失败，可以手动下载放到downloads目录
• 依赖冲突，需要检查layer的兼容性
• 内存不足，可以尝试减少并行任务数（-j参数）

第一次构建成功后，可以尝试更复杂的镜像，比如带Weston桌面的：

bitbake core-image-weston

这个镜像包含了图形界面，可以用来测试RK3568的GPU性能。

5. 优化构建速度

Yocto的构建速度是个老大难问题，特别是全量构建时。经过多次实践，我总结出几个有效的优化方法：

首先，配置本地缓存（sstate-cache）：

echo 'SSTATE_DIR = "${TOPDIR}/sstate-cache"' >> conf/local.conf echo 'SSTATE_MIRRORS = "file://.* http://sstate.yoctoproject.org/all/PATH;downloadfilename=PATH"' >> conf/local.conf

这样构建产物会被缓存起来，下次构建时可以直接复用。我专门用了一块SSD来存放sstate-cache，效果很明显。

其次，调整并行任务数：

echo 'BB_NUMBER_THREADS = "8"' >> conf/local.conf echo 'PARALLEL_MAKE = "-j 8"' >> conf/local.conf

这个数字应该根据你的CPU核心数来设置，一般设为核心数的1.5倍左右。

第三，使用预下载的源码包：

bitbake -c fetchall core-image-minimal

这个命令会下载所有需要的源码包，但不会开始构建。适合在网速好的时候先准备好。

最后，可以考虑使用构建服务器。我搭建了一台专门的构建服务器，配置了ECC内存和高速SSD，构建速度比笔记本快5倍以上。

6. 常见问题排查

在实际项目中，我遇到过各种奇怪的问题，这里分享几个典型案例：

问题1：构建过程中报错"no space left on device"解决：检查tmp目录空间，可以通过修改local.conf调整：

echo 'TMPDIR = "/path/to/larger/disk/tmp"' >> conf/local.conf

问题2：包依赖冲突解决：使用bitbake-gui可视化查看依赖关系：

bitbake-gui

问题3：构建成功后镜像无法启动解决：检查机器配置是否正确，特别是uboot和kernel的版本是否匹配。

问题4：网络代理导致下载失败解决：配置wget和git的代理设置：

echo 'export http_proxy="http://proxy.example.com:8080"' >> ~/.bashrc echo 'export https_proxy="http://proxy.example.com:8080"' >> ~/.bashrc

7. 进阶技巧

当你熟悉了基本流程后，可以尝试一些进阶操作：

自定义镜像：创建自己的image recipe，只包含需要的软件包。例如创建一个只包含Qt5的镜像：

inherit core-image IMAGE_INSTALL += "qtbase qtdeclarative qtquickcontrols2"

添加新软件包：通过创建bb文件来添加自定义软件包。基本结构如下：

DESCRIPTION = "My custom package" LICENSE = "MIT" SRC_URI = "git://github.com/user/repo.git;branch=main" S = "${WORKDIR}/git" inherit cmake

调试构建问题：使用devshell交互式调试：

bitbake -c devshell <package-name>

这个命令会进入一个包含所有构建环境的shell，方便调试。

分析构建时间：生成构建统计报告：

bitbake -m perf <image-name>

这个报告会显示每个任务的耗时，帮助找到性能瓶颈。

8. 实际项目经验

在最近的一个RK3568项目中，我们遇到了一个棘手的问题：系统启动后WiFi模块无法正常工作。经过排查，发现是内核配置缺少必要的驱动支持。解决方法是在kernel recipe中添加：

SRC_URI += "file://enable-wifi.cfg"

然后在enable-wifi.cfg中配置：

CONFIG_CFG80211=y CONFIG_MAC80211=y CONFIG_RTL8XXXU=y

重新编译内核后问题解决。这个案例让我深刻体会到Yocto灵活性的价值，但也反映出学习曲线确实比较陡峭。

另一个经验是关于版本控制的。我强烈建议把整个Yocto目录（包括downloads和sstate-cache之外的部分）纳入版本控制。我们使用git管理，通过.gitignore排除大文件和临时文件：

downloads/ sstate-cache/ tmp/ build/

这样团队协作时能确保环境一致，减少"在我机器上是好的"这类问题。