驗(yàn)證“板端 NPU 節(jié)點(diǎn) + Python / Lite2 環(huán)境 + 版本匹配”

1.實(shí)驗(yàn)?zāi)康?/p>

?驗(yàn)證 ELF-RV1126B板端 NPU驅(qū)動節(jié)點(diǎn)是否可訪問。

?驗(yàn)證官方推薦版本組合在當(dāng)前系統(tǒng)中的可用性。

?驗(yàn)證 Python3、pip3、虛擬環(huán)境以及 RKNN-Toolkit-Lite2 的導(dǎo)入能力。

2. 實(shí)驗(yàn)依據(jù)與版本要求

?官方 AI 文檔給出：ELF-RV1126B 對應(yīng) NPU 版本為 0.9.8，推薦使用 RKNN-Toolkit2 2.3.2 與 RKNN-Toolkit-Lite2 2.3.2。

?官方快速使用手冊說明：開發(fā)板 Debian12文件系統(tǒng)已預(yù)裝版本為 2.3.2的 RKNPU2組件，并默認(rèn)安裝 2.3.2版本的 RKNN Toolkit Lite2。

?實(shí)驗(yàn)中若發(fā)現(xiàn)版本混用，建議先恢復(fù)到官方推薦版本組合，再繼續(xù)后續(xù)模型部署。

3.實(shí)驗(yàn)準(zhǔn)備

1）開發(fā)板正常上電，使用 DEBUG串口或 SSH登錄系統(tǒng)。

2）建議先確認(rèn)系統(tǒng)版本、Python版本和 pip版本，便于后續(xù)問題回溯。

3）若開發(fā)板不能聯(lián)網(wǎng)，請?zhí)崆皽?zhǔn)備 RKNN-Toolkit-Lite2 2.3.2 的 whl 安裝包。

步驟 3.1 記錄系統(tǒng)基礎(chǔ)信息

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

步驟 3.2 檢查 NPU驅(qū)動節(jié)點(diǎn)與版本

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

預(yù)期現(xiàn)象：能夠看到 /sys/kernel/debug/rknpu 目錄，或至少通過 version 節(jié)點(diǎn)讀到當(dāng)前 NPU 版本信息。若 version 節(jié)點(diǎn)不存在，不要直接判定硬件損壞，應(yīng)先檢查 debugfs 是否已掛載。需要注意權(quán)限。

步驟 3.3 創(chuàng)建虛擬環(huán)境并安裝 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

(之前已經(jīng)安裝過了)

若終端已打印 RKNNLite import ok，可視為板端 Python 側(cè)基礎(chǔ)依賴已經(jīng)具備。若使用離線安裝，請把 pip install那一行替換為本地 whl文件路徑。測試通過時(shí)，建議保留終端輸出截圖，作為后續(xù)實(shí)驗(yàn)的前置條件證明。

審核編輯 黃宇