RK3562 开发板:第一次编译内核与设备树,把改动固化进固件

2026-11-21 17:46:13 pet_admin

「编译到一半蹦出 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 为例)
系统: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(按系统实际安装)

先收藏,跟着做更省事。本文出现的脚本、参数、产物名与四条排障命令,我们整理成了《Day4 编译命令速查卡》;后台回复「编译」领取 PDF 版。

一、从「会用」到「能改系统」,一次编译到底改了什么

编译不是敲一条 make,而是一条链:解压源码 → 改 defconfig 与 dts → 全编译 → 得到 update*.img → 烧回板子固化。任何一层没落到文件里,重编都会被上一层覆盖回去。

最容易混的一点:佩特给的是两套独立源码树——Android 侧与 Linux 侧,包名、内核目录、脚本、默认产物都不一样。下图对照看,先认清在哪棵树里再动手。

一次编译的五段链路,以及 Android 侧与 Linux 侧源码树、内核目录、脚本、产物、defconfig 对照

▲ 图 1 Android 13 侧与 Linux 侧:两套源码树、两套脚本、两套产物

通用知识的边界。git、dtc、menuconfig 只用来解释原理,不替换手册里的真实脚本;手册没写的命令输出、寄存器、设备树节点与编译耗时数值,一律不编,统一标注「以随货 SDK 为准」。

Day 4 路线图:5 件事,约 120 分钟

Day4 五步路线图:备编译主机、解压认目录、改配置设备树、全编译出固件、overlay 与验收

▲ 图 2 五件事的时间分配与每步验收 / 交付物(首次全编译耗时另计)

STEP 01 / 20 MIN
备编译主机:先把 300G 和 16G 备够

第一次编译翻车,八成翻在环境上。手册硬指标很直白:Ubuntu 22.04 64 位桌面版、内存最少 16G、源码所在磁盘剩余 >300G、虚拟机磁盘文件放到固态盘分区;VMware 需 15.5.6 及以上版本。磁盘镜像放机械盘,编译可能卡死不动。

最省事的是用现成虚拟机镜像:软件已装好,默认用户名 / 密码都是 gzpeite,解压源码就能编。自己新装主机,按手册原文依次做:

# ① 依赖清单(节选,完整以手册为准):gcc make git python2#    openjdk-19-jdk device-tree-compiler u-boot-tools#    live-build qemu-user-static expect dos2unix ...$ sudo apt -y install gcc make git python2 openjdk-19-jdk \  device-tree-compiler u-boot-tools live-build qemu-user-static# ② python2 软链成 python$ sudo ln -sf /usr/bin/python2 /usr/bin/python# ③ 装指定版本 live-build(deb 在开发工具目录内)$ sudo dpkg -i live-build_20230502_all.deb# ④ 关掉 systemd-oomd,别让它在编译时杀进程$ sudo systemctl stop systemd-oomd.service$ sudo systemctl disable systemd-oomd.service$ sudo apt -y autoremove --purge systemd-oomd
原厂专属提醒:编译主机硬指标、新装环境三步、解压大写 J、-m 手动回写、OutOfMemory 解法与屏参呼应 Day02

▲ 图 3 手册里才会写的细节:硬指标、三步依赖、大写 J、手动回写与故障提示

✅ 验收标准:依赖装完无报错;java -version / python 可用;df -h 复核源码分区剩余仍 >300G。三条都过再往下走。

STEP 02 / 15 MIN
解压源码,认清两套目录结构

源码包复制到 Ubuntu 下、确认磁盘剩余 >300G 再解压。手册两处都特意注明「注意参数中是大写 J」——写成小写会直接报错,是第一次编译最冤的返工。

# 两个包,参数都是大写 J$ tar xvJf PET_RK3562_P01_Android13_Source.tar.xz$ tar xvJf PET_RK3562_P01_Linux_Source.tar.xz# 解出来两个目录,分别进各自源码根$ cd PET_RK3562_P01_Android13$ cd PET_RK3562_P01_Linux

认清目录才不迷路:Android 侧内核目录叫 kernel-5.10,Linux 侧叫 kernel,设备树与 defconfig 路径都跟着这一字之差变。两侧的 rk3562.dtsi 与 rk3562-gzpeite.dtsi 都在各自 arch/arm64/boot/dts/rockchip/ 下。

U-Boot 源码在 u-boot/,研发细节参考 芯片原厂文档\common\UBOOT;其余内核研发也查《芯片原厂文档》目录。

真实脚本与路径速查:新装环境、大写 J 解压、-m 与手动回写、build.sh kernel-config、四条全编译命令、清理命令及设备树路径对照

▲ 图 4 本文出现的真实脚本、参数与设备树 / overlay 路径,一图收齐

✅ 验收标准:两个源码目录都解压完整、无 tar 报错;能分别说出 kernel-5.10 与 kernel 各属于哪一侧;u-boot/ 与设备树目录都能找到。

STEP 03 / 25 MIN · 呼应 Day02
改内核配置与设备树:改完必须手动回写

这正是「改了 .config 重编没生效」的答案。Android 侧用 ./gzpeite_build_android.sh -m 改配置并保存,但脚本不会替你把新 .config 写回默认配置文件——保存后必须手动拷一次,否则全编译读的还是旧 defconfig。

# Android 侧:改配置 + 手动回写(长命令手动折行)$ ./gzpeite_build_android.sh -m$ cp -rf kernel-5.10/.config \    kernel-5.10/arch/arm64/configs/gzpeite_rk3562_defconfig# Android 设备树(在 kernel-5.10 下)#   arch/arm64/boot/dts/rockchip/rk3562.dtsi#   arch/arm64/boot/dts/rockchip/rk3562-gzpeite.dtsi# Linux 侧:另一套脚本与配置文件$ ./build.sh kernel-config#   默认配置 kernel/arch/arm64/configs/#   gzpeite_rk3562_linux_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 卡验证过再写回源码。

STEP 04 / 40 MIN+ · 首次编译更久
全编译出固件:三条路径,四个产物文件

配置与屏参落盘后即可全编译。Android 与 Linux 各一条主脚本,Linux 再加 debian / ubuntu 两个参数,共四个 update*.img;清理命令也各归各,别串台。

三条编译路径对比:Android 出 update.img、Linux buildroot 出 update_buildroot.img、加 debian/ubuntu 参数出 update_debian.img 与 update_ubuntu.img,以及清理命令与关键坑

▲ 图 5 三条路径、四个产物,以及清理命令与「先 buildroot、需联网」的关键坑

# Android 侧 → rockdev/Image-rk3562_t/update.img$ ./gzpeite_build_android.sh# Linux 侧 → rockdev/update_buildroot.img$ ./gzpeite_build_linux.sh# 加参数 → update_debian.img / update_ubuntu.img$ ./gzpeite_build_linux.sh debian$ ./gzpeite_build_linux.sh ubuntu# 清理:Android 用 -c,Linux 用 cleanall$ ./gzpeite_build_android.sh -c$ ./gzpeite_build_linux.sh cleanall

关键坑(手册口径):编 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 为准。

四个售后现场排查树:OutOfMemory、改了 .config 没生效、镜像体积和 SDK 差很多、换 7 寸屏重烧后黑屏

▲ 图 6 四个高频现场:先对现象,再按手册给的做法动手

✅ 验收标准:四个目标产物分别出现在 rockdev/Image-rk3562_t/update.img 与 rockdev/ 下;编译日志无 OutOfMemory 等中断;debian / ubuntu 镜像体积与 SDK 参考值无明显异常(异常先查联网)。

STEP 05 / 20 MIN
不重编也能改系统:overlay 与出厂预置

Day03 的 demo 想「开机就有」,不必重编整包内核。SDK 给的是 overlay(根文件系统覆盖)机制:文件放进对应目录,编译时自动复制进 rootfs。三个系统各一个入口:

系统overlay 目录(放文件即自动进 rootfs)
buildrootbuildroot/board/rockchip/rk3562/fs-overlay
Debian 11debian/overlay
Ubuntu 22.04ubuntu/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 支持。

# 动态换开机画面(不重编译,文件名不可改)$ adb push logo.bmp /mnt/logo/$ adb push logo_kernel.bmp /mnt/logo/$ adb push bootanimation.zip /mnt/logo/# 交叉编译链(大写 J)$ sudo tar -xJf GZPEITE_ToolChain.tar.xz -C /usr/local/# 编译器:/usr/local/GZPEITE_ToolChain/#   gcc-linaro-10.2.1-2021.01-x86_64_aarch64-linux-gnu/bin# sysroot:/usr/local/GZPEITE_ToolChain/sysroot_debian# QT Creator Kits:GZPEITE_ARM64_Debian#   qmake → QT_5.15.2_Debian/bin/qmake;产物用 adb push 上板

把 demo 做成开机自启:《Debian 应用开发手册》的现成做法——无界面程序更名 bootapp 放 /usr/local/sbin/;QT 程序更名 bootapp_qt,自启定义在 /etc/xdg/autostart/bootapp_qt.desktop;路径可改 boot_app.sh 里的 APP_PATH,源码侧改 debian/overlay。Day03 的 demo 就此变成出厂自带能力。

编译验收速查卡:产物存在、哈希记录、依赖可用、磁盘复核、overlay 自启验证、串口日志无异常,底部绿色固化卡

▲ 图 7 产物、哈希、依赖、日志逐项确认,底部把改动固化进基线

✅ 验收标准(四条写死):① 目标 update*.img 产物存在;② 用 sha256sum 记录哈希存档;③ 按 Day01 的烧录流程烧回板子能正常启动;④ 串口日志无异常。命令与产物名以随货 SDK 为准,本文只写验收动作,不编造命令输出。

第四天最容易踩的 6 个坑

#现象原因正确做法
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 的板子」变成「能按需求出厂的设备」。内核能自己编了,接下来就该把工业现场要用的接口,一个个点验到能交付。


联系我们

首页
产品
研发
新闻