ELF-RV1126B NPU 驱动与 RKNN 运行环境

验证“板端 NPU 节点 + Python / Lite2 环境 + 版本匹配”

1. 实验目的

• 验证 ELF-RV1126B 板端 NPU 驱动节点是否可访问。

• 验证官方推荐版本组合在当前系统中的可用性。

• 验证 Python3、pip3、虚拟环境以及 RKNN-Toolkit-Lite2 的导入能力。

2. 实验依据与版本要求

• 官方 AI 文档给出：ELF-RV1126B 对应 NPU 版本为 0.9.8，推荐使用 RKNN-Toolkit2 2.3.2 与 RKNN-Toolkit-Lite2 2.3.2。

• 官方快速使用手册说明：开发板 Debian12 文件系统已预装版本为 2.3.2 的 RKNPU2 组件，并默认安装 2.3.2 版本的 RKNN Toolkit Lite2。

• 实验中若发现版本混用，建议先恢复到官方推荐版本组合，再继续后续模型部署。

建议：本实验重点不是“能否联网安装”，而是“板端环境是否完整可用”。因此无论你是在线安装还是使用 whl 离线安装，只要最终能稳定导入 rknnlite.api 即可。

3. 实验准备

1）开发板正常上电，使用 DEBUG 串口或 SSH 登录系统。

2）建议先确认系统版本、Python 版本和 pip 版本，便于后续问题回溯。

3）若开发板不能联网，请提前准备 RKNN-Toolkit-Lite2 2.3.2 的 whl 安装包。

步骤 3.1  记录系统基础信息

uname -a cat /etc/issue python3 --version pip3 --version

步骤 3.2  检查 NPU 驱动节点与版本

mount -t debugfs none /sys/kernel/debug 2>/dev/null || true ls /sys/kernel/debug/rknpu 2>/dev/null cat /sys/kernel/debug/rknpu/version

预期现象：能够看到 /sys/kernel/debug/rknpu 目录，或至少通过 version 节点读到当前 NPU 版本信息。若 version 节点不存在，不要直接判定硬件损坏，应先检查 debugfs 是否已挂载。需要注意权限。

步骤 3.3  创建虚拟环境并安装 Lite2

python3 -m venv elf-env source elf-env/bin/activate pip install rknn-toolkit-lite2==2.3.2 -i https://pypi.tuna.tsinghua.edu.cn/simple pip3 show rknn-toolkit-lite2 || true vim test_RKNNLite.py from rknnlite.api import RKNNLite print("RKNNLite import ok") python3 test_RKNNLite.py

(之前已经安装过了)

若终端已打印 RKNNLite import ok，可视为板端 Python 侧基础依赖已经具备。若使用离线安装，请把 pip install 那一行替换为本地 whl 文件路径。测试通过时，建议保留终端输出截图，作为后续实验的前置条件证明。

审核编辑 黄宇