指南 / TSENGCHEN BLOG

RK3582-NPU-ThreeCore-850MHz-Application-Guide-CN

05_Guid · 第 9 / 10 篇

RK3582 NPU 三核 850 MHz 应用指南

本包用于在 RK3582 平台启用三核 NPU 和 850 MHz OPP(工作频点)。

交付内容

  • kernel/:6 个 Kernel 补丁。需应用的补丁必须按文件编号顺序处理,最终应完整具备六个补丁的内容。
  • rkbin/RKTRUST/RK3588TRUST.ini:Trust 配置文件。
  • rkbin/bin/rk35/rk3588_bl31_v1.57.elf:BL31 固件文件。

Kernel 补丁说明

六个补丁共同完成 RK3582 核心屏蔽差异、GPU 初始化和 NPU 三核 850 MHz 配置。

编号补丁作用
0001在 RK3588S 设备树中增加 GPU、NPU 核心数量的 OTP(一次性可编程存储器)信息定义。
0002增加 RK3582 的 OPP 配置,包括 NPU 所需的频率和电压档位。
0003为 RK3588S EVB1 板级设备树引入 RK3582 OPP 配置。
0004GPU 驱动根据 OTP 信息使用有效核心,并跳过被屏蔽或异常的核心。
0005增加 Mali Bifrost GPU 驱动对 RK3582 的支持。
0006开放 NPU 三个核心,并增加 850 MHz NPU OPP。

使用准备

下文以 PKG_DIR 表示交付包的解压目录。请将尖括号内的内容替换为实际解压路径:

PKG_DIR="<交付包解压目录>"

在交付包根目录执行以下命令校验文件完整性:

cd "$PKG_DIR"
sha256sum -c SHA256SUMS

所有条目应显示 OK。

Kernel 合入方式

本包用于与本包补丁基线匹配的 RK3582 Kernel 源码。应用前请根据目标源码的已有修改选择合入方式。

进入 Kernel 源码目录,执行以下命令检查是否已发现六个对应提交:

sh "$PKG_DIR"/tools/check_kernel_patches.sh

脚本仅检查当前 Kernel 分支的提交主题,且要求 Kernel 版本为 6.1。已发现 表示源码历史中存在同主题提交;未发现 表示该补丁缺失或已通过其他方式修改,需结合下表处理。

目标源码状态处理方式
六个补丁均未合入直接应用完整补丁包。
已合入部分补丁,且已合入内容与本包完全一致仅应用缺失的补丁,并保持编号顺序。
六个补丁均已合入无需再次应用补丁,直接编译。
存在修改过的同类补丁或应用时发生冲突不要强行应用;确认差异后再人工合入。

完整应用命令:

git am "$PKG_DIR"/kernel/*.patch

仅应用缺失补丁时,在上述命令中列出缺失文件。例如仅缺少 0005、0006:

git am "$PKG_DIR"/kernel/0005-*.patch "$PKG_DIR"/kernel/0006-*.patch

RKBin 处理

设置 RKBIN_DIR 为 RKBin 源码目录,并将尖括号内的内容替换为实际路径:

RKBIN_DIR="<RKBin 源码目录>"

执行以下命令覆盖 RKBin 文件:

cp -f "$PKG_DIR"/rkbin/RKTRUST/RK3588TRUST.ini \
    "$RKBIN_DIR"/RKTRUST/RK3588TRUST.ini
cp -f "$PKG_DIR"/rkbin/bin/rk35/rk3588_bl31_v1.57.elf \
    "$RKBIN_DIR"/bin/rk35/rk3588_bl31_v1.57.elf

覆盖后执行以下命令验证:

cmp -s "$PKG_DIR"/rkbin/RKTRUST/RK3588TRUST.ini "$RKBIN_DIR"/RKTRUST/RK3588TRUST.ini && \
cmp -s "$PKG_DIR"/rkbin/bin/rk35/rk3588_bl31_v1.57.elf "$RKBIN_DIR"/bin/rk35/rk3588_bl31_v1.57.elf && \
echo "RKBin: PASS" || echo "RKBin: FAIL"

编译与更新

进入 SDK 根目录,执行:

./build.sh kernel
./build.sh uboot

编译完成后,按该平台既有的升级流程更新新的 Kernel 启动镜像和 Trust 镜像。更新前请备份当前镜像。

验收

系统启动后执行:

cat /sys/class/devfreq/fdab0000.npu/available_frequencies
cat /sys/kernel/debug/rknpu/load
cat /sys/kernel/debug/rknpu/freq

预期结果:

  • 频率列表包含 850000000。
  • NPU 负载输出包含 Core0、Core1、Core2。
  • NPU 有负载时,运行频率可达 850000000。
05_Guid · 文档目录
上一篇RK3506G-EVB1-64MB-Feature-and-Trim下一篇T8015-Test-GUIDE