RKNN部署记录-2（RKNN python API安装，使用

原创

已于 2025-01-06 16:02:34 修改 · 2.6k 阅读

16 ·

CC 4.0 BY-SA版权

文章标签：

#linux #运维 #服务器

于 2024-05-06 15:54:26 首次发布

本文介绍了如何在Linux系统中使用rknn-toolkit进行模型部署，包括查询磁盘容量、NPU驱动版本，安装必要的库，以及在Python脚本中运行板端推理。遇到的invalidrknnmodelversion错误被解释为缺少库文件，并提供了解决方法。

查看Linux磁盘容量：

df -h

查询NPU驱动版本：

 dmesg | grep -i rknpu 
# 或
 cat /sys/kernel/debug/rknpu/version 
# 或
 cat /sys/kernel/debug/rknpu/driver_version 
# 或
 cat /proc/debug/rknpu/driver_version

查询python版本并退出

python3

exit()

安装pip，numpy，ruamel.yaml，psutils

sudo apt-get update

apt-get install python3-pip

sudo apt-get install -y python3-numpy

sudo apt-get install ruamel.yaml

sudo apt-get install psutils

查询对应版本rknn lite 2库

GitHub - rockchip-linux/rknn-toolkit2

安装rknn-toolkit lite 2

# Python 3.10
 pip3 install rknn_toolkit_lite2-x.y.z-cp310-cp310-linux_aarch64.whl

（我使用的：rknn_toolkit_lite2-2.0.0b0-

最低0.47元/天解锁文章

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

phoenixlxl

关注关注

6
点赞
踩
16

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

【RKNN】RKNN-Toolkit2 Python API函数详解

浩瀚之水的专栏

04-29

494

RKNN-Toolkit2 的 API 设计以开发者效率为核心，覆盖模型转换、量化、部署全流程。通过灵活的参数配置（如多核调度、混合量化）和调试工具（性能分析、精度对比），可快速适配复杂边缘场景。

rknn-toolkit推理yolov5-face.rknn模型--python代码

C/C++、嵌入式开发、深度学习算法、模型部署与推理优化

03-08

2797

import os import urllib import traceback import time import sys import numpy as np import cv2 from rknn.api import RKNN ONNX_MODEL = 'yolov5s.onnx' RKNN_MODEL = 'yolov5s.rknn' IMG_PATH = './bus.jpg' DATASET = './dataset.txt' QUANTIZE_ON = True BOX_THR.

参与评论您还未登录，请先登录后发表或查看评论

香橙派5使用rknn提示报错Invalid RKNN model version 6

热门推荐

qq_40280673的博客

03-07

1万+

rknn-toolkit-lite2部署RKNN模型到开发板上

python安装部署rknn-toolkit2（ModuleNotFoundError: No module named ‘rknn_toolkit2‘）

sazass的博客

08-07

557

下载连接：https://pypi.org/project/rknn-toolkit2/#files。python 安装rknn-toolkit-lite。选择对应的python版本、软件版本、和系统架构。选择对应的python版本、软件版本、和系统架构。python安装rknn-toolkit2。

rknn（做记录）

a2488220557的博客

10-19

273

里面的文件进行转onnx模型，在转到ubuntu（电脑版）：原因是电脑版是x86架构的。他真的太nb了怎么就知道我的错误呢。里面进行转rknn，在。

RKNN模型部署——RKNN零拷贝API开发板落地部署RKNN模型（附代码详细图文教程）

qq_40280673的博客

03-11

5445

RKNN零拷贝API开发板落地部署RKNN模型

【RKNN】RKNN-Toolkit2 Python API之get_sdk_version函数详解

浩瀚之水的专栏

05-10

184

rknn.get_sdk_version() 是 RKNN-Toolkit2 中用于获取当前 NPU 工具链及硬件驱动的版本信息的关键接口，帮助开发者验证开发环境与硬件驱动的兼容性。

【RKNN】RKNN-Toolkit2 Python API之rknn_query 函数详解

浩瀚之水的专栏

06-30

390

rknn_query 是 RKNN-Toolkit2 中用于查询模型或运行时状态信息的核心接口，支持获取模型属性、硬件配置、性能数据等关键信息，帮助开发者调试和优化模型部署。

【RKNN】RKNN-Toolkit2 Python 模型加载API函数详解

浩瀚之水的专栏

05-02

303

RKNN-Toolkit2 提供多种函数加载不同框架的预训练模型，将其转换为 RKNN 格式。

rk3588 更新推理库，安装python rknn-toolkit-lite2 推理环境

weixin_43951955的博客

04-03

1214

rk3588 的ai开发环境，需要安装的库有点多，名称看起来有点像，经常会乱，本文重点是更新板端推理库和python npu 的api，并运行测试。推理库的安装过程，以及验证是否安装是否成功python 推理 api 安装过程，以及验证安装是否成功。

在Linux系统实现瑞芯微RK3588部署rknntoolkit2进行模型转换

m0_62588333的博客

07-13

1222

在Linux系统实现瑞芯微RK3588部署rknntoolkit2进行模型转换

RKNN 工具使用-python

dongdonglele521的博客

03-14

3236

quantized_method 支持 layer 或 channel ，用于每层的权重是否共享参数，默认为。data_format ：输入数据的 layout 列表，只对 4 维的输入有效，格式为 “NCHW” 或。询 RKNN_QUERY_CUSTOM_STRING 得到该信息，方便部署时根据不同的 RKNN 模。默认值为 False。quantized_algorithm 用于指定计算每一层的量化参数时采用的量化算法，可以选择。

【RKNN】RKNN-Toolkit2 Python API之rknn_outputs_get 函数详解

浩瀚之水的专栏

06-28

1288

rknn_outputs_get 是 RKNN-Toolkit2 中用于获取模型推理结果的核心接口，支持多输出模型的解析与后处理。

rknn-api1.2.0和rknn-toolkit1.2.0安装笔记

照玄

12-24

3483

一，rknn-toolkit1.2.0 下载http://t.rock-chips.com/forum.php?mod=viewthread&tid=964&extra=page%3D1里面的资源，按照Rockchip_Quick_Start_RKNN_Toolkit_V1.2.1_CN.pdf文档安装会报很多错，正确步骤如下： sudo apt-get install pyt...

安装RKNN Toolkit，遇到python版本不匹配

allright6059的博客

04-26

669

目录下没有适合的whl文件，需要安装python3.7，但如果直接重装，可能导致系统其它软件出现不可预料的问题，所以推荐创建一个虚拟环境，防止不同项目之间由于依赖不同版本的库而导致冲突。每个项目都可以有自己的依赖，不会影响到其他项目。下载到的whl文件需要按照python版本以及Linux版本，选择对应的文件。安装库时，它们会被安装在虚拟环境的目录中，而不是全局环境中。至此，我们可以在虚拟环境完成软件包安装，注意当使用。

代码解读！RK3588板端使用RKNN通用API详细操作流程！

qq_1033275663的博客

05-17

5050

零拷贝（Zero-copy）API 是指在数据传输过程中，数据并不从原始内存中拷贝到目标内存，而是直接在原始内存和目标内存之间进行传输，以提高性能和降低内存开销。在 RKNN（Rockchip Neural Network）模型中，零拷贝 API 可能用于在输入和输出数据的传输过程中提高效率。

rknn-tool安装

u010949023的博客

03-08

497

按照官方教程安装，碰到，原因是pip和python的版本不一致。注意我们使用的sudo pip3 install，会提示sudo下的pip3和普通user下的pip3是不一样的，python也不一样。使用sudo python3 get-pip.py 更新pip即可。这里sudo 、python3都不能错。这样才是真正更新了sudo pip3. 之后使用rknn库时也要用sudo python3. 安装库都要用sudo pip3 ...

RK3399学习笔记 1.0.3---python环境 Firefly Core-3399pro-jd4 Win10上RKNN工具安装

Lxbbdxg的博客

06-17

1049

Core-3399pro-jd4 Win10上RKNN工具安装

安装rknn-toolkit-lite2后怎么用from 语句导入rknn

05-07

<think>好的，我现在需要解决用户在安装rknn-toolkit-lite2之后如何正确通过from语句导入rknn模块的问题。首先，我得回忆一下之前用户提到的安装步骤和相关引用内容。根据引用[1]，安装rknn-toolkit时需要使用特定的whl文件，比如rknn_toolkit-1.3.0的版本。而引用[2]提到，rknn-toolkit-lite2是用于在嵌入式设备上部署模型的Python接口。所以，用户可能是在开发板上安装了这个lite版本，但导入时遇到问题。首先，用户可能没有正确安装rknn-toolkit-lite2。需要确认安装命令是否正确，比如是否使用了正确的pip版本和whl文件路径。例如，用户是否执行了类似于`pip3 install rknn_toolkit_lite2-xxx.whl`的命令？如果路径或文件名错误，安装可能失败。其次，环境问题。如果用户是在开发板上安装，可能需要确认Python环境是否为ARM架构兼容的版本。比如，开发板上的Python是否是3.6或3.7版本，因为有些库对Python版本有特定要求。此外，检查是否在正确的Python环境中安装了库，比如使用虚拟环境时可能需要激活环境。另外，安装后的路径是否正确。有时候，库可能被安装到了非标准路径，导致Python无法找到。可以用`pip show rknn_toolkit_lite2`来查看安装位置，并确认该路径是否在sys.path中。还有，导入语句是否正确。根据文档，rknn-toolkit-lite2的导入方式可能与完整版不同。例如，可能需要使用`from rknnlite.api import RKNNLite`而不是直接导入rknn模块。用户可能混淆了不同版本的导入方式，需要查阅对应的文档确认正确的导入语句。此外，检查是否有命名冲突。如果用户同时安装了rknn-toolkit和rknn-toolkit-lite2，可能会有模块名冲突，导致导入错误。这时候需要卸载其中一个版本，确保环境干净。最后，可能需要设置环境变量，如LD_LIBRARY_PATH，指向正确的库文件位置，尤其是在开发板上运行时，可能需要配置NPU相关的驱动和库路径。总结可能的问题点：安装错误、环境问题、导入语句不正确、路径配置问题、版本冲突。需要逐一排查，建议用户检查安装步骤，确认导入语句是否符合lite2的文档，并验证环境配置是否正确。</think>### 如何在安装 rknn-toolkit-lite2 后正确导入 `rknn` 模块 #### 1. 确认安装正确性首先需确保 `rknn-toolkit-lite2` 已正确安装。安装命令通常为： ```bash pip3 install rknn_toolkit_lite2-<版本号>-<平台>.whl ``` 例如： ```bash pip3 install rknn_toolkit_lite2-1.5.0-cp39-cp39-linux_aarch64.whl ``` 安装后可通过以下命令验证： ```bash pip3 list | grep rknn ``` 若列表中包含 `rknn-toolkit-lite2`，则安装成功[^2]。 --- #### 2. 导入模块的正确语法 `rknn-toolkit-lite2` 的 Python 接口与完整版略有差异，**导入方式应为**： ```python from rknnlite.api import RKNNLite ``` 或根据版本不同： ```python from rknnlite import RKNNLite ``` --- #### 3. 完整使用示例 ```python # 导入模块 from rknnlite.api import RKNNLite # 初始化RKNN对象 rknn = RKNNLite() # 加载模型 ret = rknn.load_rknn(path='model.rknn') # 初始化运行时环境（需连接设备） ret = rknn.init_runtime(target='rk3588') # 执行推理 outputs = rknn.inference(inputs=[input_data]) ``` --- #### 4. 常见错误排查 | 问题现象 | 解决方案 | |---------------------------|--------------------------------------------------------------------------| | `ModuleNotFoundError` | 检查安装路径是否在 `sys.path` 中，尝试 `export PYTHONPATH=/安装路径` | | 版本不兼容 | 确认 Python 版本是否为 3.6/3.7/3.9 | | 硬件驱动未加载 | 在开发板执行 `lsmod | grep rknn`，确认驱动已加载[^2] | | 同时安装多个 RKNN 工具链 | 卸载冲突包：`pip3 uninstall rknn_toolkit rknn_toolkit_lite2` 后重新安装 | --- #### 5. 关键注意事项 1. **平台限制**：`rknn-toolkit-lite2` 需在 ARM 架构设备（如 RK3588）运行 2. **模型转换依赖**：部署前需通过完整版 RKNN Toolkit 将模型转换为 `.rknn` 格式[^1] 3. **硬件连接**：需通过 ADB 或 USB 连接开发板进行初始化（若为本地执行可忽略）