易百纳玄武S3(rk3588+rk1820)多路视频事件分析与检索（multistream_event）示例部署指南_专栏

硬件平台：易百纳玄武S3

易百纳社区

简介

本文主要介绍multistream_event示例（多路视频事件分析与检索）的交叉编译、板端部署与运行验证方法。该示例面向RK3588+RK1820边缘计算平台，提供四路视频硬件解码、YOLOv8目标检测、Qwen3-VL视觉语言事件分析、MediaMTX+WebRTC实时预览和事件检索能力。基础功能使用一张RK1820加速卡即可运行；配置第二张加速卡后，可启用事件语义检索。

示例功能：

四路1080p视频硬件解码；
YOLOv8n目标检测（COCO80类），检测叠加VLM事件理解；
Qwen3-VL对每路画面进行事件描述，事件写入本地SQLite数据库；
MediaMTX提供RTSP收流与WebRTC播放，浏览器端实时预览四路画面；
Web页面提供实时预览（/preview）、事件检索（/events）、健康检查（/health）与就绪检查（/ready），默认监听8080；
事件检索页支持历史事件浏览与语义检索。

整体流程分为三步：

在x86编译服务器上交叉编译，生成install/multistream_event部署目录；
将程序目录、模型、测试视频推送到板端并完成环境安装；
启动服务并访问Web页面验证。

环境准备

项目	说明
编译环境	x86_64 Linux 编译服务器
SDK	RK182X SDK（网盘资料：【易百纳】玄武S3边缘计算AI终端_V2.0中的rk182x_ai_release.tar.gz）
交叉编译工具链	`aarch64-none-linux-gnu`（地址：toolchain）
目标板	玄武S3边缘计算AI终端（Debian 13，RK3588+RK1820）
板端依赖	Python 3、pip（`install.sh`自动安装Flask、OpenCV等Python依赖，板端需可访问网络）
模型与视频	`models`、`test_videos`两个目录（从<【易百纳】RK182X_模型文件>网盘资料获取）

编译构建

编译步骤

进入SDK中示例源码目录<RK182X SDK>/applications/multistream_event，执行：

./build.sh -c    //清除构建产物
./build.sh --cross --toolchain /<toolchain所在文件路径>/toolchain/aarch64-none-linux-gnu

说明：

先清除build/、install/等构建产物，避免旧缓存干扰；
--cross启用RK3588交叉编译；
--toolchain指定交叉编译工具链目录，为toolchain工具链所在路径。

编译输出

编译成功时输出如下：、

易百纳社区

编译产物路径：<RK182X SDK>/applications/multistream_event/install/multistream_event

部署到开发板

推送程序到板端

将编译生成的multistream_event目录拷贝到板端/userdata。在Windows终端执行：

adb push <multistream_event> /userdata

推送模型和测试视频

将test_videos（测试视频）和models（模型文件）两个目录拷贝到板端/userdata/multistream_event目录：

adb push <test_videos，models> /userdata/multistream_event

说明：

模型文件与测试视频可以从网盘资料下载。

安装板端环境

进入板端程序目录，执行环境安装脚本（需要板端可访问网络，脚本使用阿里云pip源安装Flask、OpenCV等Python依赖）：

cd /userdata/multistream_event
chmod +x /userdata/multistream_event/install.sh
./install.sh

安装过程输出如下：

易百纳社区

赋予脚本与可执行文件权限

chmod +x /userdata/multistream_event/run.sh
chmod +x /userdata/multistream_event/open_pages.sh
chmod +x /userdata/multistream_event/bin/edgevision_core_service
chmod +x /userdata/multistream_event/bin/edgevision_main
chmod +x /userdata/multistream_event/bin/mediamtx

启动与效果验证

启动服务

cd /userdata/multistream_event
./run.sh

启动成功输出如下：

易百纳社区

说明：

页面地址默认为http://127.0.0.1:8080/preview和http://127.0.0.1:8080/events，在PC浏览器访问时把127.0.0.1替换成开发板的实际IP；
按ctrl+c可停止服务。

效果验证

服务启动后，在浏览器中访问：

http://<开发板IP>:8080/preview

本例为http://192.168.1.168:8080/preview，请替换为实际ip 。

实时预览页面：四路画面同时播放，可切换单画面/四画面，右上角显示Core运行状态：

易百纳社区

事件检索页面（http://<开发板IP>:8080/events）：按时间线持续产生事件，事件卡片包含缩略图、事件类型与中文描述：

易百纳社区

语义检索：在右侧语义检索框输入自然语言查询（需要两张加速卡）：

易百纳社区

停止服务

ctrl+c

也可以用./start.sh启动，./stop.sh停止。

常用配置（可选）

程序默认无需修改配置即可运行。需要自定义端口、目录或加速卡时，将config/edgevision.env.example复制为config/edgevision.env并修改，然后重启服务生效：

cp config/edgevision.env.example config/edgevision.env
vi config/edgevision.env

常用配置项：

配置项	默认值	说明
`EDGEVISION_MODEL_DIR`	`/userdata/multistream_event/models/current`	模型目录
`EDGEVISION_MEDIA_DIR`	`/userdata/multistream_event/test_videos`	测试视频目录
`EDGEVISION_WEB_PORT`	`8080`	Web 服务端口
`EDGEVISION_RTSP_PORT`	`8554`	RTSP 端口
`EDGEVISION_VLM_DEVICE_INDEX`	`0`	视频 VLM 使用的加速卡索引
`EDGEVISION_LLM_DEVICE_INDEX`	`1`	语义检索 LLM 使用的加速卡索引
`EDGEVISION_OPEN_PAGES`	`1`	启动后是否在板端自动打开页面（无桌面环境设为 `0`）

修改配置后重启服务生效：

./stop.sh
./start.sh

常见问题

./install.sh安装依赖失败：脚本需要联网并通过阿里云pip源下载，检查板端网络；
./run.sh 提示权限不足：脚本内部会自动切换到root行；请确认已按上文执行 chmod +x赋予run.sh、open_pages.sh和bin/下三个可执行文件权限。
页面能打开但没有视频：确认test_videos下四个测试视频存在，并查看 /userdata/multistream_event/data/logs/下的core.log、web.log、mediamtx.log定位。
页面提示不支持语义检索：语义检索默认使用第二张RK1820加速卡，单卡环境只提供实时预览、事件检测和历史事件浏览，属于预期的降级运行状态；双卡环境可执行 rknn-smi确认两张加速卡状态。
重新编译报旧缓存错误：先执行./build.sh -c清除构建产物，再使用配套工具链重新编译。