易百纳玄武S3(rk3588+rk182X)多路视频流VLM监控系统（multistream_vlm）示例部署指南_专栏

硬件平台：易百纳玄武S3

易百纳社区

简介

本文主要介绍multistream_vlm示例（多路视频流VLM监控系统）的交叉编译、板端部署与运行验证方法。该示例基于玄武S3（RK3588+双RK182X）平台，支持多路视频流的实时接入与VLM智能分析，并通过Web页面展示监控画面与实时告警。

整体流程分为三步：

在编译服务器上交叉编译生成multivlm安装目录；
将程序、模型、测试视频推送到板端并完成环境准备；
启动服务并访问Web监控页面验证。

环境准备

项目	说明
编译环境	x86 Ubuntu 22.04编译服务器
SDK	RK182X SDK（网盘资料：【易百纳】玄武S3边缘计算AI终端_V2.0中的rk182x_ai_release.tar.gz）
交叉编译工具链	`aarch64-none-linux-gnu`(toolchain)
目标板	玄武S3边缘计算AI终端（Debian 13，RK3588+RK1820）
板端依赖	python3-fastapi（板端安装）
模型与视频	`models`、`test_videos`两个目录（从<【易百纳】RK182X_模型文件>网盘资料获取）

编译构建

编译步骤

进入 SDK 中示例源码目录 rk182x_ai_release/applications/multistream_vlm，执行交叉编译：

./build.sh --cross --toolchain /<toolchain实际路径>/toolchain/aarch64-none-linux-gnu

说明：

交叉编译文件地址：toolchain
该命令在<RK182X SDK>/applications/multistream_vlm目录下运行，工具链路径指向rockchip_linux6.12_releaseSDK中预置的aarch64编译器。

编译输出

易百纳社区

编译成功时终端输出如下：

生成的安装目录：rk182x_ai_release/applications/multistream_vlm/install/multivlm
该目录即后续需要推送到板端的完整程序包（含start.sh、stop.sh、bin/、config/等）。

运行说明

推送程序到板端

在Windows终端将编译产物multistream_vlm\install\multivlm推送到板端 /userdata/multivlm：

adb push <multistream_vlm\install\multivlm> /userdata/multivlm

准备模型与测试视频

在板端创建示例目录，并将test_videos（测试视频）和models（模型文件）两个目录拷贝到板端/userdata/multistream_vlm目录：

易百纳社区

说明：

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

板端环境准备

安装Python依赖并给启动脚本、可执行程序添加执行权限：

apt install python3-fastapi
chmod +x /userdata/multivlm/start.sh
chmod +x /userdata/multivlm/bin/edgevision_core_service
chmod +x /userdata/multivlm/bin/edgevision_main
chmod +x /userdata/multivlm/bin/mediamtx

启动服务

sudo env \
    EDGEVISION_MODEL_DIR=/userdata/multistream_vlm/models/current \
    EDGEVISION_VIDEO_DIR=/userdata/multistream_vlm/test_videos \
    /userdata/multivlm/start.sh config/default.json

停止服务

chmod +x stop.sh
sudo /userdata/multivlm/stop.sh

启动成功输出如下：

易百纳社区

说明：

组件日志位于/userdata/multivlm/state/logs，出现异常时可优先排查该目录下的日志文件。

环境变量说明：

环境变量	说明
`EDGEVISION_MODEL_DIR`	模型文件目录，指向 `/userdata/multistream_vlm/models/current`
`EDGEVISION_VIDEO_DIR`	测试视频目录，指向 `/userdata/multistream_vlm/test_videos`

效果验证

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

http://192.168.1.168:8080

请将 192.168.1.168 替换为你板端的实际IP地址。

打开后即可看到 Edge Multi-Channel Video VLM Monitoring System（VLM 监控系统）页面：

支持 1 / 4 / 9 / 16 多种画面分屏切换；
每路通道实时显示视频画面与 VLM 分析结果（画面下方绿色横幅）；
右侧实时滚动告警记录（Real-time Alert Records）。

易百纳社区

常见问题

启动后页面无法访问：确认板端IP与访问地址一致，确认8080端口未被占用，并查看/userdata/multivlm/state/logs下组件日志。
提示模型文件不存在：确认EDGEVISION_MODEL_DIR指向的/userdata/multistream_vlm/models/current目录存在且已推入模型文件。
权限不足无法执行：确认已按上文对start.sh、stop.sh及bin/下所有可执行文件执行chmod +x。