易百纳玄武S3_intelligate（基于RK182X边缘计算终端的离线智能网关示例）部署指南_专栏

硬件平台：易百纳玄武S3

易百纳社区

简介

IntelliGate（智能网关）示例通过本地大模型解析语音或界面快捷指令，控制界面中的灯、风扇、空调等模拟设备。示例提供板端图形界面，没有Web操作页面，界面中的设备状态由本地大模型通过MCP工具（如 set_indoor_aircondition、set_bedroom_speed 等）实时控制。

示例功能：

板端3D智能家居界面，展示厨房、客厅、卧室、浴室等房间内的模拟设备（灯、风扇、空调、窗帘等）；
通过右侧快捷指令（如「卧室有点热」「我要出门了」「打开卧室空调设置到23度，风速调到2」）触发大模型解析与设备控制；
支持语音输入（ASR），模型通过MCP工具调用控制模拟设备，并在界面右侧实时显示工具调用日志；
基于rkllm3-server本地推理，完全离线运行。

整体流程分为三步：

将示例和模型拷贝到板端；
板端安装依赖、编译并启动应用；
在板端显示器上通过快捷指令或语音验证效果。

环境准备

项目	说明
已验证环境	RK3588主控+RK182X，ARM64 Debian 13、Wayland图形桌面
SDK	RK182X SDK（网盘资料：【易百纳】玄武S3边缘计算AI终端_V2.0中的rk182x_ai_release.tar.gz）
板端预装	匹配的RKNN3驱动、固件和运行时，`rknn3.service`正常运行，存在`/bin/rkllm3-server`
模型	model：兼容LLM模型的 `.rknn`、`.weight`、`.tokenizer.gguf`、`.embed.bin`（从<【易百纳】RK182X_模型文件>网盘资料获取）

拷贝示例、模型到板端

将SDK中RK182X SDK/applications/intelligate拷贝到板端/userdata：

adb push <RK182X SDK/applications/intelligate> /userdata

将model目录拷贝至板端/userdata/intelligate目录下（model从网盘资料获取）：

adb push <model> /userdata/intelligate

板端安装、编译并启动

cd /userdata/intelligate
./install.sh package      //安装依赖
./build.sh                //编译程序
./install.sh runtime      //安装服务和启动入口
intelligate-demo start    //启动应用

各步骤依次安装依赖、编译程序、安装服务和启动入口、启动应用。启动后等待模型加载，在板端显示器上点击右侧快捷指令体验。易百纳社区

效果验证

模型加载完成后，界面标题为「瑞芯微RK182X边侧智能家居算力中枢网关」，右上角显示已加载模型（本例为 model_llm_Qwen3-VL-4B.rknn）。

点击右侧快捷指令（如「打开卧室空调设置到23度，风速调到2」），大模型解析指令并通过MCP工具控制模拟设备，界面右侧实时显示工具调用日志：

易百纳社区

语音功能（可选）

默认开启ASR编译、关闭TTS。使用语音需另行准备匹配的ASR模型，放入 system/resource/rockasr/data/，并按system/resource/rockasr/rockx_auth_config.json配置有效授权，默认授权路径为/userdata/key_asr.lic。

ASR 初始化失败时，界面提示语音不可用，仍可使用快捷指令。若暂不需要语音，可将部署流程中的./build.sh替换为：

ENABLE_ASR=OFF ./build.sh

常用命令

intelligate-demo status   //查看运行状态
intelligate-demo restart  //重启界面和后台
intelligate-demo stop     //停止应用和模型服务
intelligate-cli status    //查询模拟设备状态

常见问题

语音不可用：界面提示语音不可用时，说明ASR初始化失败，检查ASR模型是否已放入system/resource/rockasr/data/、授权文件/userdata/key_asr.lic是否有效；仍可使用快捷指令。不需要语音时可用ENABLE_ASR=OFF ./build.sh关闭ASR编译。
应用启动失败或异常：通过日志排查具体原因：journalctl -u intelligate-ui -n 80 --no-pager journalctl -u intelligate-sentry -n 80 --no-pager journalctl -u intelligate_llm -n 80 --no-pager