# 双机 16 路单屏部署说明 本系统支持用 **两台 RK3588** 组成 16 路视频监控，并通过一块 HDMI 屏幕以 4×4 宫格显示。 两台板运行**同一份程序**，仅配置不同；`master` / `slave` 角色可在网页中切换（重启生效）。 --- ## 1. 架构 ``` 千兆交换机 ┌───────────────┴───────────────┐ 8×摄像头(子码流) 8×摄像头(子码流) │ │ 节点2 (slave, 无屏) 节点1 (master, HDMI) ·8路解码 + 姿态推理 ·8路解码 + 姿态推理 ·输出 /stream 供对端拉取 ·拉取对端8路画面 → 4×4 一屏 ·本地报警入库 ·本地报警 + 聚合对端报警 ·Web / 手机 APP 统一入口 ``` - **master**：接 HDMI 屏，负责 16 宫格显示、Web/手机访问、报警聚合。 - **slave**：不接屏（也可接），专注采集与推理，暴露 `/stream`、报警 API 供对端读取。 - 两台各自把报警写入本地 SQLite；master 在查询时合并两台数据。 --- ## 2. 通道编号规则（重要） 每台板有一个固定不变的 `local_base`： | 板子 | `local_base` | 拥有通道 | |---|---|---| | 节点1 | `0` | CH0 ~ CH7 | | 节点2 | `8` | CH8 ~ CH15 | `local_base` **与角色无关**：无论谁当 master，编号都不变。 角色只决定“谁显示、谁聚合”。 > 界面中的通道号从 0 开始（CH0~CH15）。 --- ## 3. 配置示例 ### 3.1 节点1（master，接屏） `config/config.json` 关键项： ```json { "node_role": "master", "local_base": 0, "grid_output": true, "steel_output": false, "enable_bucket": false, "display_fps": 12, "watchdog_sec": 120, "peer": { "enabled": true, "host": "192.168.1.232", "port": 8080, "username": "admin", "password": "admin", "local_base": 8, "count": 8, "fps": 8 }, "rtsp": [ { "id": 0, "name": "cam1", "url": "rtsp://user:pass@192.168.1.121:554/Streaming/Channels/102" }, { "id": 1, "name": "cam2", "url": "rtsp://user:pass@192.168.1.122:554/Streaming/Channels/102" }, { "id": 2, "name": "cam3", "url": "rtsp://user:pass@192.168.1.123:554/Streaming/Channels/102" }, { "id": 3, "name": "cam4", "url": "rtsp://user:pass@192.168.1.124:554/Streaming/Channels/102" }, { "id": 4, "name": "cam5", "url": "rtsp://user:pass@192.168.1.125:554/Streaming/Channels/102" }, { "id": 5, "name": "cam6", "url": "rtsp://user:pass@192.168.1.126:554/Streaming/Channels/102" }, { "id": 6, "name": "cam7", "url": "rtsp://user:pass@192.168.1.127:554/Streaming/Channels/102" }, { "id": 7, "name": "cam8", "url": "rtsp://user:pass@192.168.1.128:554/Streaming/Channels/102" } ] } ``` ### 3.2 节点2（slave，无屏） ```json { "node_role": "slave", "local_base": 8, "grid_output": false, "steel_output": false, "enable_bucket": false, "peer": { "enabled": false }, "rtsp": [ { "id": 0, "name": "cam9", "url": "rtsp://user:pass@192.168.1.129:554/Streaming/Channels/102" }, { "id": 1, "name": "cam10", "url": "rtsp://user:pass@192.168.1.130:554/Streaming/Channels/102" }, { "id": 2, "name": "cam11", "url": "rtsp://user:pass@192.168.1.131:554/Streaming/Channels/102" }, { "id": 3, "name": "cam12", "url": "rtsp://user:pass@192.168.1.132:554/Streaming/Channels/102" }, { "id": 4, "name": "cam13", "url": "rtsp://user:pass@192.168.1.133:554/Streaming/Channels/102" }, { "id": 5, "name": "cam14", "url": "rtsp://user:pass@192.168.1.134:554/Streaming/Channels/102" }, { "id": 6, "name": "cam15", "url": "rtsp://user:pass@192.168.1.135:554/Streaming/Channels/102" }, { "id": 7, "name": "cam16", "url": "rtsp://user:pass@192.168.1.136:554/Streaming/Channels/102" } ] } ``` ### 3.3 配置项说明 | 配置项 | 说明 | |---|---| | `node_role` | `standalone` / `master` / `slave` | | `local_base` | 本机通道全局起点，节点1=0，节点2=8 | | `peer.enabled` | master 才需要开启 | | `peer.host` / `peer.port` | 对端板 IP 与 Web 端口 | | `peer.username` / `peer.password` | 对端登录凭据（用于拉流/报警/截图） | | `peer.local_base` | 对端通道起点（节点1填8，节点2填0） | | `peer.count` | 拉取对端通道数量（默认8） | | `peer.fps` | 拉取对端画面帧率（默认8） | | `display_fps` | 本机显示帧生成帧率（默认12） | | `watchdog_sec` | 主循环卡死看门狗，超时自动重启（默认120，0=禁用） | --- ## 4. 网页切换 A/B 角色（谁当主） 1. 浏览器登录该板 Web（默认 `admin/admin`）。 2. 进入 **系统设置 → 双机模式**。 3. 设置： - 本机角色：`主节点` 或 `从节点` / `单机` - 本机通道起点：节点1=`0`，节点2=`8` - 对端 IP / 端口 / 用户名 / 密码 - 对端通道起点：与对端 `local_base` 一致 4. 保存后**重启生效**（页面会提示）。 5. 把 HDMI 屏接到新的 master 板上。 > 也可直接修改 `config/config.json` 后重启服务。 重启命令： ```bash systemctl restart zone_alarm ``` --- ## 5. 性能与带宽 基于 RK3588 实测（8 路/台，**仅姿态识别**，子码流 1280×720，skip_frames=9）： | 项 | 参考值 | |---|---| | 单板 CPU | 约 80 ~ 130% | | NPU | 三核各约 60 ~ 90% | | 跨机流量（master ← slave） | 约 8 Mbps（8 路 JPEG@8fps） | | 千兆交换机 | 充裕 | 建议： - **全部使用子码流**（`.../Channels/102`）。 - 16 路**仅姿态**；如同时开目标识别，建议降 `pose_input_size`（640→416）或增大 `skip_frames`。 - 非重点通道可在姿态配置里关闭。 --- ## 6. 部署检查清单 - [ ] 两台板在同一千兆交换机、同网段，互相能 `ping` 通。 - [ ] 两台板 **NTP 对时**（否则报警合并排序会乱）。 - [ ] 节点1 `local_base=0`、节点2 `local_base=8`，且互不重复。 - [ ] master 的 `peer.host` 指向对端 IP（不能填本机同一端口）。 - [ ] 两台 Web 登录凭据与 `peer.username/password` 一致。 - [ ] HDMI 接在 master 上。 - [ ] 花生壳/外网访问**只需映射 master**。 - [ ] 防火墙放行 8080（或配置的 `web_port`）。 - [ ] 若使用工位/钢包位功能，请确认 `enable_bucket` 与 `local_base` 不冲突（16 路场景建议关闭）。 --- ## 7. 验证方法 在 master 上登录后检查： ```bash # 角色与通道（应看到本机8 + 对端8，共16路） curl -s -b cookies.txt http://:8080/api/status # 对端通道画面（用于确认跨机拉流） curl -s -b cookies.txt -o test.jpg http://:8080/stream/8 # 合并后的姿态报警 curl -s -b cookies.txt "http://:8080/api/pose/alarms?limit=5" ``` - `/api/status` 中 `"remote": true` 的通道来自对端，`online` 为在线状态。 - 报警条目带 `"src": "local"` 或 `"peer"`，用于区分来源与删除分发。 --- ## 8. 故障排查 | 现象 | 排查 | |---|---| | 对端通道一直离线 | 检查 `peer.host/port`、网络、对端 `node_role=slave` 且 Web 可访问；查看 master 日志 `[Peer]` | | 对端通道画面黑/无数据 | 确认对端已加载对应摄像头且 `online`；对端 `/stream/<其全局id>` 是否可访问 | | 报警不合并 | 确认 master `peer.enabled=true`；对端时间是否同步；检查 `peer.local_base` 是否与对端 `local_base` 一致 | | 对端截图打不开 | 检查 `/api/peer/image/<文件名>`；确认对端 `data/screenshots` 存在该文件 | | 保存角色后不生效 | 角色需**重启**生效；确认写入的是运行目录下的 `config/config.json` | | 对端地址填成本机 | 程序会提示并禁用对端（防止状态查询递归死锁） | | 画面卡顿 | 检查 master CPU/NPU；适当降低 `peer.fps` / `display_fps`，或增大 `skip_frames` | | 服务反复重启 | 查看 `journalctl -u zone_alarm`；看门狗触发说明主循环卡死（NPU 异常会自动恢复） | --- ## 9. 单机与双机切换 - **单机（8 路）**：`node_role=standalone`，`peer.enabled=false`。 - **双机（16 路）**：一台 `master` + 一台 `slave`，配置如上。 - 切换到双机或互换角色：只需调整 `node_role` / `peer` 并重启，**无需重新编译**。