香橙派 RK3588 使用 RKLLM 更新 NPU 驱动教程

一、NPU 驱动版本要求

在文档《Rockchip_RKLLM_SDK_CN_1.2.1》中明确提到：RKLLM 需要 NPU 内核版本为 v0.9.8，若当前版本低于该要求，则需进行更新。

二、查询当前 NPU 版本

通过以下命令查询设备当前的 NPU 内核版本：

cat /sys/kernel/debug/rknpu/version

• 若版本为 v0.9.8，则无需更新；

• 若版本低于 v0.9.8，需按以下步骤更新。

三、NPU 驱动更新步骤

（一）准备工作：下载驱动压缩包

1. 下载驱动包 rknpu_driver_0.9.8_20241009.tar.bz2，下载地址：

   https://github.com/airockchip/rknn-llm/tree/main/rknpu-driver

（二）编译内核前的环境配置（参考香橙派文档）

香橙派文档《OrangePi_5_Ultra_RK3588_用户手册_v1.0》建议通过以下方式配置编译环境：

1. 在 PC 上安装 Ubuntu 22.04 虚拟机；

2. 更换 APT 源（加速软件下载）；

3. 安装必要工具并下载 Linux SDK 源码：

sudo apt-get update

sudo apt-get install -y git

\# 克隆源码仓库（若下载慢，可通过主机共享局域网代理加速）

git clone https://github.com/orangepi-xunlong/orangepi-build.git -b next

（三）首次编译内核（关闭自动同步）

1. 进入源码目录并启动编译配置：

cd orangepi-build

sudo ./build.sh

1. 按以下选项配置：

• 选择 Kernel package（内核包）；

• 选择板卡 orangepi5ultra；

• 选择 do not change（不修改内核配置），开始首次编译（目的是关闭源码自动同步）。

1. 关闭内核源码自动同步：

\# 编辑配置文件

vim userpatches/config-default.conf

\# 将以下变量设置为"yes"

IGNORE_UPDATES="yes"

（四）替换 NPU 驱动并重新编译

1. 解压下载的驱动包，将其中的rknpu驱动代码覆盖到内核源码目录；

2. 重新编译内核：

sudo ./build.sh

（编译完成后，deb 包位于 output/debs 目录下）

（五）安装新内核到开发板

1. 将编译好的内核 deb 包上传到开发板（以实际文件名和 IP 为例）：

cd output/debs

scp linux-image-legacy-rockchip-rk3588\_1.0.2\_arm64.deb root@192.168.1.xxx:/root

1. 登录开发板，卸载旧内核并安装新内核：

\# 卸载旧版本

apt purge -y linux-image-legacy-rockchip-rk3588

\# 安装新版本

dpkg -i linux-image-legacy-rockchip-rk3588\_1.0.2\_arm64.deb

1. 重启开发板：

reboot

四、验证更新结果

重启后，再次查询 NPU 版本：

cat /sys/kernel/debug/rknpu/version

若显示版本为v0.9.8，则更新成功。

来源链接：https://www.cnblogs.com/yijunchenhui/p/19027716