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") python3test_RKNNLite.py

(之前已经安装过了)

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

审核编辑 黄宇