易百纳玄武S3工业缺陷检测系统（anomaly-detection）示例部署指南

硬件平台：易百纳玄武S3

简介

本文主要介绍anomaly-detection示例（工业缺陷检测系统）在易百纳玄武S3（RK3588+双RK182X）平台上的部署与运行验证方法。该示例基于DINOv3视觉模型，通过数据集标注与数据集测试两步流程，实现对工业零件图片的异常检测，检测到异常零件时可展示热力图辅助定位缺陷区域，并通过Web页面（工业缺陷检测系统）进行操作与展示。

整体流程分为四步：

1. 推送示例程序、rknn3-toolkit-lite、Python3.11安装包到板端；
2. 部署测试数据集；
3. 板端安装依赖；
4. 启动服务并访问Web页面验证。

环境准备

部署到开发板

推送示例程序与依赖包

将示例程序和rknn3-toolkit-lite推送到板端/userdata目录：

adb push <anomaly-detection.zip> /userdata
adb push <rknn3-toolkit-lite.zip> /userdata

说明：

• rknn3-toolkit-lite.zip,anomaly-detection.zip从网盘资料获取。
• 文件推送路径请按照实际路径修改命令。

部署Python3.11安装包

将Python 3.11安装包推送到板端/userdata目录：

adb push <cpython-3.11.16+20260901-aarch64-unknown-linux-gnu-install_only.tar.gz> /userdata

部署数据集

在板端创建datasets目录，并将数据集压缩包拷贝至板端解压：

# 板端创建datasets目录
mkdir /userdata/datasets

# 将mvtec_anomaly_detection.tar.xz拷贝至板端/userdata/datasets目录下
adb push <mvtec_anomaly_detection.tar.xz> /userdata/datasets
cd /userdata/datasets
tar -xvf mvtec_anomaly_detection.tar.xz

数据集目录结构应为如下形式：

/userdata/datasets/
├── bottle
│   ├── test
│   └── train
└── cable
    ├── test
    └── train

板端安装依赖

在板端执行以下命令，安装Python虚拟环境及依赖：

cd userdata
unzip rknn3-toolkit-lite.zip
unzip anomaly-detection.zip 

cd userdata/anomaly-detection
chmod +x /userdata/anomaly-detection/install.sh
./install.sh

.venv/bin/python -m pip install -r /userdata/rknn3-toolkit-lite/packages/requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 使用虚拟环境的Python3.11，安装实际SDK中对应的cp311包；确保只匹配一个wheel
.venv/bin/python -m pip install /userdata/rknn3-toolkit-lite/packages/rknn3_toolkit_lite-*cp311*linux*aarch64.whl

执行完install.sh后出现：“installing /home/ebaina/Desktop/ ... install: 无法创建普通文件 '/home/ebaina/Desktop/': 不是目录”，可以忽略。

板端运行与效果验证

启动服务

unzip  anomaly-detection.zip 
cd /userdata/anomaly-detection
chmod +x /userdata/anomaly-detection/run.sh
/userdata/anomaly-detection/run.sh start

效果验证

服务支持局域网访问，可通过ifconfig获取设备的IP地址，在局域网内的PC打开浏览器访问：

http://x.x.x.x:5000

本例为：http://192.168.1.168:5000（请替换为你板端的实际IP地址）。

打开后即可看到工业缺陷检测系统页面，测试分为标注和测试两步，数据集需要先进行标注：

1. 选择数据集，点击标注：

标注过程中页面会依次显示DINOv3s模型初始化、核心特征提取、样本子集优化、特征库评分估计等进度，全部完成后提示任务已完成：

2. 标注完成后，在数据集测试页面选择数据集，并开始测试：

测试页面按钮说明：

常见问题

模型文件通过adb push到板端后名称不全：检查adb push时路径是否有中文，路径只能是英文。