跳到主要内容

RKNN 相关问题

本章节汇总 luckfox_pico_rknn_example 和 luckfox_pico_rkmpi_example 例程运行时的常见问题。

1. 标签文件加载失败与段错误​

**现象:**运行 RKNN 或 RKMPI 例程时,打印以下错误:

Open ./model/coco_80_labels_list.txt fail!
Segmenta fault

**原因:**例程需要从指定目录加载动态库、模型文件和配置文件。部署文件不完整或运行目录不正确,会导致相关文件加载失败。

**处理方法:**将编译后 install 目录下对应例程的整个部署文件夹完整上传到板端,保留 lib、model 等目录结构。进入该部署文件夹后,再运行例程。

模型文件占用的存储空间较大。使用 SPI NAND 系统时,先确认剩余空间足够,避免上传过程中因空间不足导致文件缺失。

2. 自训练 YOLOv5 模型的段错误​

**现象:**使用自训练的 YOLOv5 模型运行例程时,打印 Segmenta fault。

**原因:**模型输出结构与识别类别数有关。自训练模型的类别配置与例程中的默认配置不一致,可能导致后处理读取模型输出时出错。

处理方法:

  1. 修改 model/coco_80_labels_list.txt,填写模型识别的类别名称,每行一个类别,顺序与训练时的类别顺序一致。
  2. 修改 include/postprocess.h 中的 OBJ_CLASS_NUM,将其设置为模型实际识别的类别数。
  3. 重新编译例程,并将更新后的程序、模型和标签文件完整部署到板端。

3. RKMPI 无输出且视频流显示时间 OSD​

**现象:**运行 RKMPI 例程后没有报错,也没有其他打印信息;VLC 拉取的视频流左上角仍显示时间 OSD。

**原因:**摄像头被系统默认运行的 rkipc 占用,此时 VLC 拉取的视频流来自 rkipc 应用。

**处理方法:**先执行以下命令停止默认的 rkipc 程序,释放摄像头,再运行例程:

RkLunch-stop.sh

4. CMA 内存分配与 RKNN 初始化失败​

**现象:**运行例程时打印以下错误:

Cannot allocate memory
rknn_init fail!

**原因:**Luckfox Pico 的 CMA(连续内存分配器)从物理内存中预留连续内存,供多媒体和 RKNN 使用。预留空间过小可能无法满足模型与图像缓冲区的需求,过大则会压缩系统和应用可用的普通内存。

**处理方法:**根据板型内存容量和例程需求,修改 SDK 根目录 .BoardConfig.mk 所指向的板级配置文件中的 RK_BOOTARGS_CMA_SIZE,重新编译并烧录系统镜像。参数说明可参考 SDK 环境部署。

5. YOLOv5 识别类别显示为 null​

**现象:**运行 YOLOv5 例程时,打印 Open ./model/coco_80_labels_list.txt fail!,识别到的物体名称全部为 null。

原因:coco_80_labels_list.txt 未成功上传或未从正确路径读取,例程无法获取类别名称。

**处理方法:**检查板端是否有足够的存储空间,确认部署目录中的 model/coco_80_labels_list.txt 已完整上传,并从部署目录运行例程。

6. 运行内存不足(out of memory)​

**现象:**例程运行时打印 out of memory。

**原因:**系统可用内存不足。

**处理方法:**使用 SD 卡或 eMMC 作为系统存储介质时,可配置 swap 分区缓解普通内存不足;SPI NAND 系统不支持这种配置方式。

Swap 不能替代 RKNN 所需的 CMA 连续内存。如果同时出现 rknn_init fail!,还需检查 CMA 分配。

7. 自训练模型算子提交失败(faild to submit)​

**现象:**使用自训练模型时,打印类似以下错误:

E RKNN: faild to submit!,op id: 23, op name: ...

**原因:**模型可能使用了当前 RV1103/RV1106 推理环境不兼容的算子。

**处理方法:**根据日志中的算子名称定位模型中的对应操作,参考与所用 RKNN 版本和芯片匹配的算子支持列表、自定义算子文档进行适配。模型兼容性排查与调整可参考 RKNN 教程中的“调整 ONNX 模型”。

8. OpenCV-Mobile 设备白名单警告​

**现象:**例程初始化时打印设备白名单相关警告。

**原因:**OpenCV-Mobile 在初始化时检测设备型号,并根据硬件型号执行对应的初始化操作。

**处理方法:**如果例程能够正常打开摄像头并执行推理,可以忽略该警告。

9. 动态加载器 ld-uClibc.so.0 缺失​

**现象:**在 Ubuntu 系统下运行例程时,打印以下错误:

Could not open '/lib/ld-uClibc.so.0': No such file or directory

**原因:**上述 RKNN 和 RKMPI 例程基于 Buildroot 编译,依赖对应的动态加载器和运行库。直接在 Ubuntu 中运行这些构建产物时,运行环境不匹配,无法加载所需依赖。

**处理方法:**使用对应板型的 Buildroot 系统运行这些例程。

10. 打印 load lable 后直接退出​

**现象:**例程打印以下信息后直接退出,没有进入推理循环:

load lable ./model/coco_80_labels_list.txt

**原因:**旧版本例程依赖 framebuffer 设备,未检测到 LCD 屏幕时会直接退出。

**处理方法:**从例程仓库获取最新代码,重新编译并完整部署支持无屏运行的新版例程。新版可在不连接屏幕的情况下运行,将结果输出到终端。