|
@@ -0,0 +1,173 @@
|
|
|
|
|
+# MQTT 通信上报模块
|
|
|
|
|
+
|
|
|
|
|
+## 模块概述
|
|
|
|
|
+
|
|
|
|
|
+该模块主要负责 RTU 主控系统与 MQTT 服务器之间的通信,实现设备数据上报、照片采集与上传、服务器指令接收以及设备远程控制等功能。
|
|
|
|
|
+
|
|
|
|
|
+模块通过 MQTT 建立 RTU 与服务器之间的通信连接,并结合 RTU、MCU 及相机等设备,实现测报灯设备数据、运行状态和现场照片与后端服务器之间的数据交互。
|
|
|
|
|
+
|
|
|
|
|
+## 通信关系
|
|
|
|
|
+
|
|
|
|
|
+```text
|
|
|
|
|
+ 云飞MQTT 服务器
|
|
|
|
|
+ ▲ │
|
|
|
|
|
+ 数据/照片上报│ │指令下发
|
|
|
|
|
+ │ ▼
|
|
|
|
|
+ ┌──────────────────────┐
|
|
|
|
|
+ │ MQTT 通信上报模块 │
|
|
|
|
|
+ │ mqttreporter │
|
|
|
|
|
+ └──────────┬───────────┘
|
|
|
|
|
+ │
|
|
|
|
|
+ ┌─────────────┼─────────────┐
|
|
|
|
|
+ │ │ │
|
|
|
|
|
+ ▼ ▼ ▼
|
|
|
|
|
+ RTU 系统 MCU 相机
|
|
|
|
|
+ │ │ │
|
|
|
|
|
+ │ │ │
|
|
|
|
|
+ └─────────────┴─────────────┘
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+## 主要功能
|
|
|
|
|
+
|
|
|
|
|
+### 1. 设备数据上报
|
|
|
|
|
+
|
|
|
|
|
+负责将 RTU 及 MCU 采集和产生的设备数据上报至 MQTT 服务器,包括:
|
|
|
|
|
+
|
|
|
|
|
+* RTU 运行状态
|
|
|
|
|
+* MCU 运行数据
|
|
|
|
|
+* 定位信息
|
|
|
|
|
+* 环境数据
|
|
|
|
|
+* 设备状态
|
|
|
|
|
+* 设备事件
|
|
|
|
|
+* 设备预警信息
|
|
|
|
|
+* 其他业务数据
|
|
|
|
|
+
|
|
|
|
|
+实现测报灯设备现场数据与后端服务器之间的数据交互,为后端平台提供设备运行信息。
|
|
|
|
|
+
|
|
|
|
|
+### 2. 照片采集与上传
|
|
|
|
|
+
|
|
|
|
|
+负责测报灯相机拍照业务的数据交互、照片处理及上传,实现设备现场图像数据与后端服务器之间的传输。
|
|
|
|
|
+
|
|
|
|
|
+照片任务主要包括两种来源:
|
|
|
|
|
+
|
|
|
|
|
+#### 2.1 MCU 定时拍照
|
|
|
|
|
+
|
|
|
|
|
+MCU 控制板根据设备配置的光控或时控策略,以及拍照间隔等参数,按照设备运行条件发起拍照任务。
|
|
|
|
|
+
|
|
|
|
|
+RTU 接收到 MCU 的拍照请求后,负责协调相机完成拍照,并对生成的照片进行处理和上传。
|
|
|
|
|
+
|
|
|
|
|
+```text
|
|
|
|
|
+ MCU控制板
|
|
|
|
|
+ │
|
|
|
|
|
+ │ 拍照指令
|
|
|
|
|
+ ▼
|
|
|
|
|
+ RTU
|
|
|
|
|
+ │
|
|
|
|
|
+ │ 拍照控制
|
|
|
|
|
+ ▼
|
|
|
|
|
+ 相机
|
|
|
|
|
+ │
|
|
|
|
|
+ │ 输出照片
|
|
|
|
|
+ ▼
|
|
|
|
|
+ RTU
|
|
|
|
|
+ │
|
|
|
|
|
+ │ 照片上传
|
|
|
|
|
+ ▼
|
|
|
|
|
+ MQTT服务器
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+#### 2.2 服务器指令拍照
|
|
|
|
|
+
|
|
|
|
|
+MQTT 服务器可以向设备下发拍照指令,由 RTU 接收并处理拍照任务,控制相机完成拍照,并将拍摄的照片上传至服务器。
|
|
|
|
|
+
|
|
|
|
|
+```text
|
|
|
|
|
+ MQTT服务器
|
|
|
|
|
+ │
|
|
|
|
|
+ │ 拍照指令
|
|
|
|
|
+ ▼
|
|
|
|
|
+ RTU
|
|
|
|
|
+ │
|
|
|
|
|
+ │ 拍照控制
|
|
|
|
|
+ ▼
|
|
|
|
|
+ 相机
|
|
|
|
|
+ │
|
|
|
|
|
+ │ 输出照片
|
|
|
|
|
+ ▼
|
|
|
|
|
+ RTU
|
|
|
|
|
+ │
|
|
|
|
|
+ │ 照片上传
|
|
|
|
|
+ ▼
|
|
|
|
|
+ MQTT服务器
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+模块负责两类拍照业务的通信与数据处理,包括:
|
|
|
|
|
+
|
|
|
|
|
+* MCU 拍照任务接收
|
|
|
|
|
+* 服务器拍照指令接收
|
|
|
|
|
+* 相机拍照控制
|
|
|
|
|
+* 照片文件处理
|
|
|
|
|
+* 照片上传
|
|
|
|
|
+* 拍照及上传状态处理
|
|
|
|
|
+* 异常处理
|
|
|
|
|
+
|
|
|
|
|
+### 3. 服务器指令接收与处理
|
|
|
|
|
+
|
|
|
|
|
+负责接收 MQTT 服务器下发的设备业务指令,并根据指令类型进行解析和分发。
|
|
|
|
|
+
|
|
|
|
|
+主要包括:
|
|
|
|
|
+
|
|
|
|
|
+* 设备控制
|
|
|
|
|
+* 参数配置
|
|
|
|
|
+* 拍照控制
|
|
|
|
|
+* 远程升级
|
|
|
|
|
+* MCU 控制
|
|
|
|
|
+* 设备重启
|
|
|
|
|
+* 其他业务指令
|
|
|
|
|
+
|
|
|
|
|
+根据指令内容调用对应业务模块执行,并将相关执行结果反馈至服务器。
|
|
|
|
|
+
|
|
|
|
|
+### 4. MCU 数据及指令转发
|
|
|
|
|
+
|
|
|
|
|
+对于涉及 MCU 控制板的业务,负责完成 MQTT 消息与本地 MCU 通信之间的数据转发。
|
|
|
|
|
+
|
|
|
|
|
+```text
|
|
|
|
|
+MQTT 服务器
|
|
|
|
|
+ │
|
|
|
|
|
+ │ MQTT
|
|
|
|
|
+ ▼
|
|
|
|
|
+ RTU
|
|
|
|
|
+ │
|
|
|
|
|
+ │ 串口
|
|
|
|
|
+ ▼
|
|
|
|
|
+ MCU
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+负责 MCU 数据上报、控制指令下发以及 MCU 状态和预警信息的网络透传,实现服务器、RTU 与 MCU 之间的远程交互。
|
|
|
|
|
+
|
|
|
|
|
+### 5. MQTT 通信管理
|
|
|
|
|
+
|
|
|
|
|
+负责 MQTT 通信连接的建立、维护及状态管理,实现 RTU 与 MQTT 服务器之间的稳定通信。
|
|
|
|
|
+
|
|
|
|
|
+主要包括:
|
|
|
|
|
+
|
|
|
|
|
+* MQTT 连接建立
|
|
|
|
|
+* MQTT 连接维护
|
|
|
|
|
+* 消息订阅
|
|
|
|
|
+* 消息发布
|
|
|
|
|
+* 消息收发
|
|
|
|
|
+* 通信状态管理
|
|
|
|
|
+* 自动断线重连
|
|
|
|
|
+* 异常处理
|
|
|
|
|
+
|
|
|
|
|
+### 6. 消息协议处理
|
|
|
|
|
+
|
|
|
|
|
+负责 MQTT 业务消息的协议处理,包括:
|
|
|
|
|
+
|
|
|
|
|
+* 消息解析
|
|
|
|
|
+* 数据封装
|
|
|
|
|
+* 数据校验
|
|
|
|
|
+* 消息分发
|
|
|
|
|
+* 业务结果处理
|
|
|
|
|
+* 异常处理
|
|
|
|
|
+
|
|
|
|
|
+为 RTU 上层业务提供统一的 MQTT 通信接口,完成设备数据、照片及控制指令与后端服务器之间的可靠传输。
|