RK3582 NPU 三核 850 MHz 补丁分析
本文分析 RK3582 在 Linux Kernel 6.1 上启用三核 NPU、850 MHz OPP(工作频点)时使用的六个 Kernel 补丁。RK3582 是 RK3588 系列的核心屏蔽版本,不能仅增加 NPU 频点;还需让设备树、GPU 驱动和板级 DTS 使用一致的 RK3582 描述。
补丁集合
| 顺序 | 提交 | 主要文件 | 作用 |
|---|---|---|---|
| 0001 | 3b90c0cecfacf | rk3588s.dtsi | 定义 GPU、NPU 核心数量对应的 OTP 单元。 |
| 0002 | dfe0132888b92 | rk3582.dtsi | 建立 RK3582 专用 OPP 和 GPU/NPU 设备树覆盖。 |
| 0003 | 9e6fdf308e692 | rk3588s-evb1-lp4x-v10-linux.dts | 让 RK3588S EVB1 LP4X V10 使用 RK3582 设备树覆盖。 |
| 0004 | 38efaa81a814f | mali_kbase_gpuprops.c | GPU 按 OTP 识别有效核心,跳过被屏蔽或异常核心。 |
| 0005 | 3fb74a5682f2c | mali_kbase_gpuprops.c | 将上述 GPU 处理逻辑扩展到 RK3582。 |
| 0006 | e6c5d4d960e1e | rk3582.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 自行推算。
为什么六个补丁需要成套使用
| 缺失内容 | 直接影响 |
|---|---|
| 0001 | GPU/NPU OTP 单元标签不存在,依赖该信息的设备树和驱动无法正确引用。 |
| 0002 | 没有 RK3582 的 OPP 覆盖,NPU 不会获得 RK3582 专用频点电压表。 |
| 0003 | EVB1 DTB 不会引入 rk3582.dtsi,0002 与 0006 的设备树覆盖不会进入该板 DTB。 |
| 0004 或 0005 | GPU 不会对 RK3582 按 OTP 选择两个有效核心。 |
| 0006 | NPU 仍受 npu_cores NVMEM 属性限制,且 OPP 表没有 850 MHz。 |
自定义板移植原则
- 保持客户自己的 board defconfig 与板级 DTS。
- 合入
0001、0002、0004、0005、0006的 SoC 和驱动修改。 - 不直接套用仅修改 EVB1 DTS 的
0003;在客户自己的 Linux DTS 中加入等价的#include "rk3582.dtsi"。 - 重新编译 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。