联系电话:18926288206 | 邮箱:18926288206@gzpeite.com
「编译到一半蹦出 OutOfMemoryError: Java heap space」「改了 .config,重编完配置又回去了」「镜像体积和 SDK 里那份差一大截」「换块 7 寸屏重烧固件就黑屏」——这四类,是售后带用户第一次编译 RK3562 时最高频的现场。
共同点不是「不会编译」,而是漏掉了 SDK 手册里那几行很具体的话:哪个参数要大写、改完配置要手动拷回哪、编 debian 之前先做过什么。今天把三本手册里的真实脚本、路径、产物名与故障提示逐条摊开,按 5 件事走一遍,每步都给验收标准。
接上期 / BEFORE YOU START Day 03 你已经在板子上跑通了第一个 RKNN 推理 demo,把结果显示到了 Day02 点亮的那块屏上。但 demo 是「这次开机手动跑起来的」,一断电、一恢复出厂,就得重新装一遍。 从「会用」到「能改系统」,缺的就是今天这一步:把 demo、驱动、屏参、开机画面做成出厂就有的能力。也是从今天起,Day01 那份黄金镜像不再只是回滚用的备份,而成了你要往上叠加改动的基线。 写给佩特的用户:RK3562 不是一个板型,而是一组——P01 开发板、P03 主板(标准 / LVDS / EDP 版)、P04 通用主板、CORE 核心板与 Q 系列一体屏 / 一体机。本文的源码包名、脚本名与设备树路径,以 P01 的《开发板编译烧写手册》《系统开发手册》为主。 不同板型的 defconfig、dts、overlay 目录与内置应用位置并不通用。请按板卡型号找对应资料包,别跨板型套用脚本或设备树。命令里的版本号、路径与产物名,一律以随货 SDK 为准。 本文适用环境 / TESTED ON 硬件:RK3562 / RK3562J 系列,佩特 P01 / P03 / P04 主板与 Q 系列一体机(编译以 P01 SDK 为例) 先收藏,跟着做更省事。本文出现的脚本、参数、产物名与四条排障命令,我们整理成了《Day4 编译命令速查卡》;后台回复「编译」领取 PDF 版。
系统:Android 13 / Debian 11 / Ubuntu 22.04 / buildroot
编译主机:Ubuntu 22.04 64 位桌面版,内存 ≥16G,源码盘剩余 >300G,虚拟机磁盘放固态盘,VMware 15.5.6+
物料:Android13 / Linux 源码压缩包、GZPEITE_ToolChain.tar.xz、live-build_20230502_all.deb、U 盘 / TF 卡、调试串口
资料:随货《开发板编译烧写手册》《系统开发手册》《Debian 应用开发手册》、芯片原厂文档\common\UBOOT、U盘或TF卡更新显示参数.7z
调试:串口日志、adb、sha256sum / df -h(按系统实际安装)
编译不是敲一条 make,而是一条链:解压源码 → 改 defconfig 与 dts → 全编译 → 得到 update*.img → 烧回板子固化。任何一层没落到文件里,重编都会被上一层覆盖回去。
最容易混的一点:佩特给的是两套独立源码树——Android 侧与 Linux 侧,包名、内核目录、脚本、默认产物都不一样。下图对照看,先认清在哪棵树里再动手。
▲ 图 1 Android 13 侧与 Linux 侧:两套源码树、两套脚本、两套产物
通用知识的边界。git、dtc、menuconfig 只用来解释原理,不替换手册里的真实脚本;手册没写的命令输出、寄存器、设备树节点与编译耗时数值,一律不编,统一标注「以随货 SDK 为准」。
▲ 图 2 五件事的时间分配与每步验收 / 交付物(首次全编译耗时另计)
第一次编译翻车,八成翻在环境上。手册硬指标很直白:Ubuntu 22.04 64 位桌面版、内存最少 16G、源码所在磁盘剩余 >300G、虚拟机磁盘文件放到固态盘分区;VMware 需 15.5.6 及以上版本。磁盘镜像放机械盘,编译可能卡死不动。
最省事的是用现成虚拟机镜像:软件已装好,默认用户名 / 密码都是 gzpeite,解压源码就能编。自己新装主机,按手册原文依次做:
▲ 图 3 手册里才会写的细节:硬指标、三步依赖、大写 J、手动回写与故障提示
✅ 验收标准:依赖装完无报错;java -version / python 可用;df -h 复核源码分区剩余仍 >300G。三条都过再往下走。
源码包复制到 Ubuntu 下、确认磁盘剩余 >300G 再解压。手册两处都特意注明「注意参数中是大写 J」——写成小写会直接报错,是第一次编译最冤的返工。
认清目录才不迷路:Android 侧内核目录叫 kernel-5.10,Linux 侧叫 kernel,设备树与 defconfig 路径都跟着这一字之差变。两侧的 rk3562.dtsi 与 rk3562-gzpeite.dtsi 都在各自 arch/arm64/boot/dts/rockchip/ 下。
U-Boot 源码在 u-boot/,研发细节参考 芯片原厂文档\common\UBOOT;其余内核研发也查《芯片原厂文档》目录。
▲ 图 4 本文出现的真实脚本、参数与设备树 / overlay 路径,一图收齐
✅ 验收标准:两个源码目录都解压完整、无 tar 报错;能分别说出 kernel-5.10 与 kernel 各属于哪一侧;u-boot/ 与设备树目录都能找到。
这正是「改了 .config 重编没生效」的答案。Android 侧用 ./gzpeite_build_android.sh -m 改配置并保存,但脚本不会替你把新 .config 写回默认配置文件——保存后必须手动拷一次,否则全编译读的还是旧 defconfig。
强烈呼应 Day02 / 先调屏,再写回源码 SDK 内的系统源代码默认配置为 10.1 寸 MIPI 屏输出。手册「显示屏配置」一节的建议与 Day02 那条轻量路径同源:先用 U 盘 / TF 卡把屏参调好,再改源码重新编译,别把没验证的屏参直接编进固件反复烧。 资料包 U盘或TF卡更新显示参数.7z 内有 rk3562-gzpeite_p01_lvds_7寸屏.dts、rk3562-gzpeite_p01_mipi_40P_10.1寸屏.dts 等配置。7 寸 / 10.1 寸贴合屏重烧固件后可能无显示,用对应文件更新屏参即恢复——「换 7 寸屏重烧黑屏」的标准解。
更细的设备树节点、时序参数我们不在这儿编,按屏规格书与随货 SDK 里的示例改即可。✅ 验收标准:改动后的 .config 已手动拷回 gzpeite_rk3562_defconfig(Linux 侧确认 gzpeite_rk3562_linux_defconfig);屏参已先用 U 盘 / TF 卡验证过再写回源码。
配置与屏参落盘后即可全编译。Android 与 Linux 各一条主脚本,Linux 再加 debian / ubuntu 两个参数,共四个 update*.img;清理命令也各归各,别串台。
▲ 图 5 三条路径、四个产物,以及清理命令与「先 buildroot、需联网」的关键坑
关键坑(手册口径):编 debian / ubuntu 之前,需首先完成过 buildroot 的编译,且编译主机需能联网;编译后文件大小与 SDK 差异较大,要检查联网情况。编 Android 13 最少 16GB 内存,太小可能报错。 若报 Exception in thread "main" java.lang.OutOfMemoryError: Java heap space,执行 export _JAVA_OPTIONS="-Xmx8G" 并减少虚拟机 CPU 核心个数。首次编译很耗时,后续只改 uboot / kernel / android 某处再编会快很多,耗时以随货 SDK 为准。
▲ 图 6 四个高频现场:先对现象,再按手册给的做法动手
✅ 验收标准:四个目标产物分别出现在 rockdev/Image-rk3562_t/update.img 与 rockdev/ 下;编译日志无 OutOfMemory 等中断;debian / ubuntu 镜像体积与 SDK 参考值无明显异常(异常先查联网)。
Day03 的 demo 想「开机就有」,不必重编整包内核。SDK 给的是 overlay(根文件系统覆盖)机制:文件放进对应目录,编译时自动复制进 rootfs。三个系统各一个入口:
| 系统 | overlay 目录(放文件即自动进 rootfs) |
|---|---|
| buildroot | buildroot/board/rockchip/rk3562/fs-overlay |
| Debian 11 | debian/overlay |
| Ubuntu 22.04 | ubuntu/overlay |
开机画面与动画(Android):用 bmp 替换 kernel/logo.bmp 与 logo_kernel.bmp(分辨率别超屏);bootanimation.zip 放 device/rockchip/common/bootshutdown/,并在 rk3562_t.mk 加 include .../bootshutdown.mk。
两个硬要求:zip 必须「存储」方式压缩、解压后不能多一层 bootanimation 目录(可用 WinRAR 确认)。不重编动态换,就把 logo.bmp / logo_kernel.bmp / bootanimation.zip 推到 /mnt/logo/;两个 logo 必须 bmp、文件名不可改(U-Boot / 内核阶段),动画仅 Android 支持。
把 demo 做成开机自启:《Debian 应用开发手册》的现成做法——无界面程序更名 bootapp 放 /usr/local/sbin/;QT 程序更名 bootapp_qt,自启定义在 /etc/xdg/autostart/bootapp_qt.desktop;路径可改 boot_app.sh 里的 APP_PATH,源码侧改 debian/overlay。Day03 的 demo 就此变成出厂自带能力。
▲ 图 7 产物、哈希、依赖、日志逐项确认,底部把改动固化进基线
✅ 验收标准(四条写死):① 目标 update*.img 产物存在;② 用 sha256sum 记录哈希存档;③ 按 Day01 的烧录流程烧回板子能正常启动;④ 串口日志无异常。命令与产物名以随货 SDK 为准,本文只写验收动作,不编造命令输出。
| # | 现象 | 原因 | 正确做法 |
|---|---|---|---|
| 01 | 编译到一半 OutOfMemory | 内存不足 / 虚拟机 CPU 核数过多 / Java 堆不够 | export _JAVA_OPTIONS="-Xmx8G" 并减少 CPU 核数;内存 ≥16G |
| 02 | 改了 .config 重编没生效 | -m 保存后没手动拷回默认配置文件 | cp -rf kernel-5.10/.config → gzpeite_rk3562_defconfig |
| 03 | 镜像体积和 SDK 差很多 | 编 debian/ubuntu 前没完成 buildroot 编译 / 主机未联网 | 先跑 buildroot 编译、确认联网,差异大先查网络 |
| 04 | 换 7 寸屏重烧后黑屏 | SDK 默认 10.1 寸 MIPI,贴合屏屏参未更新 | 先用 U 盘 / TF 卡调好 dts,再写回源码重编 |
| 05 | 解压报错 / 虚拟机编译卡死 | 用了小写 j、磁盘放机械盘、剩余空间不足 | 大写 J,磁盘 >300G 且放固态盘分区 |
| 06 | 开机动画 / overlay 不生效 | zip 压缩方式不对、多一层目录,或放错 overlay | 「存储」方式压缩、不能多一层目录;按系统选 overlay 目录 |
五件事做完,手上该有四样东西:一套能自己编译的主机与干净源码树、一份改动已生效的 defconfig / dts、四个带哈希记录的 update*.img 产物,以及一套不重编就能改系统的 overlay 与自启方案。
RK3562 这才从「能跑 demo 的板子」变成「能按需求出厂的设备」。内核能自己编了,接下来就该把工业现场要用的接口,一个个点验到能交付。