工程 / TSENGCHEN BLOG

RK3582-NPU-3Core-850MHz-Patch-Analysis

09_Engineering · 第 8 / 14 篇

RK3582 NPU 三核 850 MHz 补丁分析

本文分析 RK3582 在 Linux Kernel 6.1 上启用三核 NPU、850 MHz OPP(工作频点)时使用的六个 Kernel 补丁。RK3582 是 RK3588 系列的核心屏蔽版本,不能仅增加 NPU 频点;还需让设备树、GPU 驱动和板级 DTS 使用一致的 RK3582 描述。

补丁集合

顺序提交主要文件作用
00013b90c0cecfacfrk3588s.dtsi定义 GPU、NPU 核心数量对应的 OTP 单元。
0002dfe0132888b92rk3582.dtsi建立 RK3582 专用 OPP 和 GPU/NPU 设备树覆盖。
00039e6fdf308e692rk3588s-evb1-lp4x-v10-linux.dts让 RK3588S EVB1 LP4X V10 使用 RK3582 设备树覆盖。
000438efaa81a814fmali_kbase_gpuprops.cGPU 按 OTP 识别有效核心,跳过被屏蔽或异常核心。
00053fb74a5682f2cmali_kbase_gpuprops.c将上述 GPU 处理逻辑扩展到 RK3582。
0006e6c5d4d960e1erk3582.dtsi开放 NPU 三个核心,并加入 850 MHz NPU OPP。

整体关系

0001:定义 GPU/NPU OTP 单元
  ├─ 0002:RK3582 OPP 与 GPU/NPU 设备树覆盖
  │   └─ 0003:EVB1 板级 DTS 引入 rk3582.dtsi
  └─ 0004 + 0005:GPU 驱动读取 GPU OTP,只启用两个有效核心

0006:移除 NPU OTP 核数限制 + 新增 850 MHz NPU OPP
  └─ rknpu devfreq 根据 npu_opp_table 提供 850 MHz

0001:定义 GPU 和 NPU OTP 单元

补丁在 rk3588s.dtsi 的 OTP 节点中增加:

gpu_cores: gpu-cores@1e {
    reg = <0x1e 0x1>;
    bits = <1 4>;
};

npu_cores: npu-cores@1f {
    reg = <0x1f 0x1>;
    bits = <3 3>;
};

这两项只是提供 OTP 数据的设备树标签,本身不改变运行核心数。后续补丁可通过 nvmem-cells 和 nvmem-cell-names 引用这些单元。

0002:建立 RK3582 专用 OPP 和核心信息

补丁新增 rk3582.dtsi,对 RK3588S 的默认 OPP 表进行 RK3582 化覆盖,涉及 CPU 三个 cluster、DMC、GPU、NPU 以及部分多媒体模块。

对 NPU 的初始覆盖包含 300、400、500、600、700、800 MHz OPP,并为各频点给出 opp-supported-hw、opp-hz 和电压范围。OPP 不是单纯的频率列表;频率、电压、硬件版本筛选必须作为一个整体使用。

该补丁还为 GPU 增加:

&gpu {
    nvmem-cells = <&gpu_cores>;
    nvmem-cell-names = "cores";
};

初始版本也为 NPU 引用了 npu_cores。这一限制在 0006 中被移除。

0003:将 RK3582 描述接入板级 DTS

补丁仅在 RK3588S EVB1 LP4X V10 的 Linux DTS 中增加:

#include "rk3582.dtsi"

它的作用是使该板编译出的 DTB 包含 RK3582 OPP 与设备覆盖。该补丁不适用于其他板级 DTS 的原样直接应用。

自定义板应保留自身的电源、引脚、外设和显示配置,并在自己的 Linux DTS 中移植等价的 rk3582.dtsi 引用;不要改用 EVB1 的整份板级 DTS。

0004 与 0005:GPU 核心屏蔽处理

0004 在 Mali Bifrost 驱动中检测 GPU 节点是否存在名为 cores 的 NVMEM 单元。存在时,驱动读取 GPU OTP 位图,按核心顺序跳过标记为坏的核心,并最多选择两个可用 GPU 核心写入 shader_present。

0005 不改变该算法,只将识别范围从 RK3583 扩展为 RK3583 和 RK3582。两项补丁需要一起保留:前者提供处理逻辑,后者使 RK3582 进入该处理分支。

这部分与 NPU 850 MHz 没有直接的 devfreq 关系,但对 RK3582 的完整启动与 GPU 初始化很重要。仅移植 NPU 相关 DTS 而遗漏 GPU OTP 处理,可能使核心屏蔽状态与 GPU 驱动识别不一致。

0006:开放 NPU 三核并新增 850 MHz OPP

补丁完成两项关键修改。

第一,删除 NPU 节点的 OTP 核数引用:

&rknpu {
    nvmem-cells = <&npu_cores>;
    nvmem-cell-names = "cores";
};

删除后,NPU 驱动不再通过该设备树 NVMEM 属性限制核心数,从而允许三个 NPU 核心参与运行。

第二,在 npu_opp_table 中增加厂商给定的 850 MHz OPP:

opp-850000000 {
    opp-supported-hw = <0xf9 0xffff>;
    opp-hz = /bits/ 64 <850000000>;
    opp-microvolt = <800000 800000 850000>,
                   <800000 800000 850000>;
};

850 MHz 的电压参数必须使用该补丁提供的完整值,不能根据 800 MHz 或 900 MHz OPP 自行推算。

为什么六个补丁需要成套使用

缺失内容直接影响
0001GPU/NPU OTP 单元标签不存在,依赖该信息的设备树和驱动无法正确引用。
0002没有 RK3582 的 OPP 覆盖,NPU 不会获得 RK3582 专用频点电压表。
0003EVB1 DTB 不会引入 rk3582.dtsi,0002 与 0006 的设备树覆盖不会进入该板 DTB。
0004 或 0005GPU 不会对 RK3582 按 OTP 选择两个有效核心。
0006NPU 仍受 npu_cores NVMEM 属性限制,且 OPP 表没有 850 MHz。

自定义板移植原则

  1. 保持客户自己的 board defconfig 与板级 DTS。
  2. 合入 0001、0002、0004、0005、0006 的 SoC 和驱动修改。
  3. 不直接套用仅修改 EVB1 DTS 的 0003;在客户自己的 Linux DTS 中加入等价的 #include "rk3582.dtsi"。
  4. 重新编译 Kernel 与 U-Boot/Trust 镜像,并按自身升级流程更新设备。

运行时验收

系统启动后可检查 NPU OPP、三核负载和当前频率:

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

验收点如下:

  • available_frequencies 包含 850000000。
  • load 输出包含 Core0、Core1、Core2。
  • 有 NPU 任务运行时,freq 可达到 850000000。
09_Engineering · 文档目录
上一篇RK3576-Industrial-Minimal-Buildroot-Guide下一篇rk3582-yolov5-three-core-stress-test