易百纳玄武S3_monitor示例部署指南_专栏

硬件平台：易百纳玄武S3

简介

本文主要介绍monitor示例（RKNN Monitor Web，RK182X状态监控页面）在Ebaina玄武S3边缘计算AI终端上的交叉编译、部署与运行验证方法。该示例通过Web页面实时监控RK182X的功耗、温度、NPU/CPU占用率与内存使用情况，显示内容与原LVGL桌面版基本一致，支持最多4张算力卡（多卡时每个图表中不同颜色的折线对应一张卡，单卡仅显示一条）。

示例特点：

由rknn_monitor_web.service系统服务管理，安装后默认不自启动，需手动启动/停止；
支持NPU、CPU、Memory、Temp、Power五个监控模块，模块开关状态可持久化保存；
各曲线模块显示最近30秒数据点的折线图，并展示当前值、平均值（Avg）与最大值（Max）。

整体流程分为四步：

在PC（x86编译服务器）上交叉编译，生成部署包rknn_monitor_web.tar.gz；
将部署包推送到板端并解压，执行install.sh安装；
板端通过systemctl手动启动服务；
浏览器访问http://<板端IP>:8181验证监控页面。

环境准备

项目	说明
编译环境	x86 Linux 编译服务器
SDK	RK182X SDK（网盘资料：【易百纳】玄武S3边缘计算AI终端_V2.0中的rk182x_ai_release.tar.gz）
交叉编译工具链	`aarch64-none-linux-gnu`（toolchain）
目标板	Ebaina玄武S3边缘计算AI终端（Debian 13，RK3588+RK182X）

编译构建

编译步骤

在PC的SDK示例源码目录<RK182X SDK>/examples/monitor下执行：

cd <RK182X SDK>/examples/monitor
export GCC_COMPILER=/<toolchain实际路径>/toolchain/aarch64-none-linux-gnu/bin/aarch64-none-linux-gnu    //指定交叉编译器（路径以实际位置为准）
./build.sh    //执行编译

说明：

GCC_COMPILER指定交叉编译器前缀（不带-gcc/-g++后缀），工具链为toolchain；
编译成功后，部署包输出到<RK182X SDK>/examples/monitor/output/rknn_monitor_web.tar.gz（含二进制、Web页面、安装脚本）：

部署到开发板

推送部署包

将编译出的部署包拷贝至板端任意目录（以/userdata为例）：

# PC端执行
adb push <RK182X SDK>/examples/monitor/output/rknn_monitor_web.tar.gz /userdata

板端安装

# 板端执行（解压后自动生成rknn_monitor_web/目录）
cd /userdata
tar -xvf rknn_monitor_web.tar.gz
cd rknn_monitor_web
./install.sh

安装完成输出如下，安装内容包含：

易百纳社区

/bin/rknn_monitor_web：服务程序；
/etc/rknn_monitor/web/：Web页面；
/etc/rknn_monitor/cfg/monitor.json：配置文件（模块开关状态持久化）；
/etc/systemd/system/rknn_monitor_web.service：系统服务（不enable，默认不自启动）。

说明：install.sh只安装、不启动服务，启动需按后文手动执行。若板端以root用户操作，命令中的sudo可省略。

运行说明

启动与停止服务

# 启动
sudo systemctl start rknn_monitor_web
# 停止
sudo systemctl stop rknn_monitor_web
# 查看状态
sudo systemctl status rknn_monitor_web

卸载

cd /userdata/rknn_monitor_web
sudo ./install.sh uninstall

访问监控页面

服务启动后，在PC浏览器打开：

http://<板端IP>:8181

示例中地址为：http://192.168.1.168:8181。

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

效果验证

打开页面后即可看到RKNN-SMI监控界面，实时显示RK182X的NPU/CPU占用率、温度、功耗与内存使用情况：

易百纳社区

顶部NPU/CPU/Memory/Temp/Power复选框：控制对应模块显示，开关状态持久化到monitor.json；
CLEAR按钮：清空所有数据，从当前时间开始重新记录；
各曲线模块显示最近30秒数据点的折线图，右上角为当前值，下方同时展示平均值（Avg）与最大值（Max）；
Memory模块展示占用率与已用大小（如57%-2931M），单卡标题为Memory-5G，多卡标题为Memory ×N，各卡数值着色区分。

常见问题

页面无数据或数据获取失败：rknn-smi API目前仅支持单线程调用，若设备中还有其它Demo在使用rknn-smi API会造成冲突，请先停止其它Demo后再启动本服务。
多卡显示说明：Monitor支持最多4张RK182X算力卡，多卡时每个图表中一条折线对应一张卡，颜色依次为蓝#0、橙#1、绿#2、紫#3（图表左上角图例），当前值/Avg/Max按卡以值 / 值形式着色显示。
端口修改：默认端口为8181，如需修改，编辑/etc/systemd/system/rknn_monitor_web.service中的--port参数，然后执行sudo systemctl daemon-reload && sudo systemctl restart rknn_monitor_web。
服务重启后未自启动：属正常现象，本服务默认不设置开机自启（不enable），板端重启后需手动执行sudo systemctl start rknn_monitor_web。