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。
**原因:**模型输出结构与识别类别数有关。自训练模型的类别配置与例程中的默认配置不一致,可能导致后处理读取模型输出时出错。
处理方法:
- 修改
model/coco_80_labels_list.txt,填写模型识别的类别名称,每行一个类别,顺序与训练时的类别顺序一致。 - 修改
include/postprocess.h中的OBJ_CLASS_NUM,将其设置为模型实际识别的类别数。 - 重新编译例程,并将更新后的程序、模型和标签文件完整部署到板端。
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 屏幕时会直接退出。
**处理方法:**从例程仓库获取最新代码,重新编译并完整部署支持无屏运行的新版例程。新版可在不连接屏幕的情况下运行,将结果输出到终端。