|
@@ -8,10 +8,10 @@
|
|
|
|
|
|
|
|
### 1.1 名词约定
|
|
### 1.1 名词约定
|
|
|
|
|
|
|
|
-| 名称 | 说明 |
|
|
|
|
|
-|:---|:---|
|
|
|
|
|
-| RTU | 上位机,负责网络通信、设备管理及与 MCU 的串口交互 |
|
|
|
|
|
-| MCU | 下位机,负责测报灯硬件控制、状态采集及数据上报 |
|
|
|
|
|
|
|
+| 名称 | 说明 |
|
|
|
|
|
+| :--- | :----------------------------------- |
|
|
|
|
|
+| RTU | 上位机,负责网络通信、相机拍照及与 MCU 的串口交互 |
|
|
|
|
|
+| MCU | 下位机,负责测报灯硬件控制、状态采集及数据上报 |
|
|
|
| MQTT | RTU 与服务器之间的网络通信方式,同时用于部分 MCU 指令的数据透传 |
|
|
| MQTT | RTU 与服务器之间的网络通信方式,同时用于部分 MCU 指令的数据透传 |
|
|
|
|
|
|
|
|
### 1.2 通信关系
|
|
### 1.2 通信关系
|
|
@@ -20,24 +20,27 @@ RTU 与 MCU 通过串口进行双向通信,RTU 同时通过 MQTT 与服务器
|
|
|
|
|
|
|
|
部分 MCU 数据及控制指令由服务器通过 MQTT 下发至 RTU,再由 RTU 通过串口转发给 MCU;MCU 返回的数据由 RTU 通过 MQTT 向服务器透传。
|
|
部分 MCU 数据及控制指令由服务器通过 MQTT 下发至 RTU,再由 RTU 通过串口转发给 MCU;MCU 返回的数据由 RTU 通过 MQTT 向服务器透传。
|
|
|
|
|
|
|
|
|
|
+相机直接连接 RTU,由 RTU 负责相机控制及实际拍照。
|
|
|
|
|
+
|
|
|
```text
|
|
```text
|
|
|
MQTT
|
|
MQTT
|
|
|
┌──────────────────────────┐
|
|
┌──────────────────────────┐
|
|
|
│ │
|
|
│ │
|
|
|
▼ │
|
|
▼ │
|
|
|
- RTU 上位机 ◄──── 串口 ────► MCU 下位机
|
|
|
|
|
|
|
+ RTU上位机 ◄──── 串口 ────► MCU下位机
|
|
|
│ │
|
|
│ │
|
|
|
- └────────── MQTT 透传 ─────┘
|
|
|
|
|
|
|
+ │ │
|
|
|
|
|
+ └───────────MQTT 透传─────┘┘┘
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
### 1.3 通信方向
|
|
### 1.3 通信方向
|
|
|
|
|
|
|
|
-| 方向 | 说明 |
|
|
|
|
|
-|:---|:---|
|
|
|
|
|
-| MCU → RTU | MCU 通过串口向 RTU 请求信息或主动上报数据 |
|
|
|
|
|
-| RTU → MCU | RTU 通过串口向 MCU 请求数据或下发控制指令 |
|
|
|
|
|
|
|
+| 方向 | 说明 |
|
|
|
|
|
+| :--------------- | :--------------------------------------- |
|
|
|
|
|
+| MCU → RTU | MCU 通过串口向 RTU 请求信息或主动上报数据 |
|
|
|
|
|
+| RTU → MCU | RTU 通过串口向 MCU 请求数据或下发业务指令 |
|
|
|
| MQTT → RTU → MCU | 服务器通过 MQTT 向 RTU 下发 MCU 相关指令,RTU 再通过串口转发 |
|
|
| MQTT → RTU → MCU | 服务器通过 MQTT 向 RTU 下发 MCU 相关指令,RTU 再通过串口转发 |
|
|
|
-| MCU → RTU → MQTT | MCU 通过串口返回数据,RTU 再通过 MQTT 向服务器透传 |
|
|
|
|
|
|
|
+| MCU → RTU → MQTT | MCU 通过串口返回数据,RTU 再通过 MQTT 向服务器透传 |
|
|
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
@@ -82,23 +85,25 @@ RTU 返回当前自身运行状态:
|
|
|
|
|
|
|
|
### 2.3 字段说明
|
|
### 2.3 字段说明
|
|
|
|
|
|
|
|
-| 字段 | 类型 | 说明 |
|
|
|
|
|
-|:---|:---:|:---|
|
|
|
|
|
-| imei | 字符串 | 通讯板唯一 ID |
|
|
|
|
|
-| iccid | 字符串 | 物联网卡 ICCID,可用于查询套餐及流量 |
|
|
|
|
|
-| csq | 整型 | 网络信号强度 |
|
|
|
|
|
-| lat | 字符串 | 纬度 |
|
|
|
|
|
-| lng | 字符串 | 经度 |
|
|
|
|
|
-| datetime | 字符串 | 当前日期时间,格式 `YYYYMMDDHHmmss` |
|
|
|
|
|
-| sim | 整型 | SIM 卡状态:`0` 正常,`1` 异常 |
|
|
|
|
|
-| net | 整型 | 网络状态:`0` 已联网,`1` 未联网 |
|
|
|
|
|
-| dver | 字符串 | RTU 软件版本 |
|
|
|
|
|
-| proj | 字符串 | RTU/DTU 项目标识,用于不同设备的升级判断 |
|
|
|
|
|
-| gps | 整型 | 定位方式:`0` 手动定位,`1` GPS 定位,`2` 基站定位 |
|
|
|
|
|
-| gps_inuse | 整型 | 当前使用中的卫星数量 |
|
|
|
|
|
-| gps_view | 整型 | 当前可见卫星数量 |
|
|
|
|
|
-| photo_sta | 整型 | 相机状态 |
|
|
|
|
|
-| link_sta | 整型 | 有线网络接入状态 |
|
|
|
|
|
|
|
+协议字段均采用字符串形式传输。
|
|
|
|
|
+
|
|
|
|
|
+| 字段 | 类型 | 说明 |
|
|
|
|
|
+| :-------- | :-: | :-------------------------------- |
|
|
|
|
|
+| imei | 字符串 | 通讯板唯一 ID |
|
|
|
|
|
+| iccid | 字符串 | 物联网卡 ICCID,可用于查询套餐及流量 |
|
|
|
|
|
+| csq | 字符串 | 网络信号强度 |
|
|
|
|
|
+| lat | 字符串 | 纬度 |
|
|
|
|
|
+| lng | 字符串 | 经度 |
|
|
|
|
|
+| datetime | 字符串 | 当前日期时间,格式 `YYYYMMDDHHmmss` |
|
|
|
|
|
+| sim | 字符串 | SIM 卡状态:`0` 正常,`1` 异常 |
|
|
|
|
|
+| net | 字符串 | 网络状态:`0` 已联网,`1` 未联网 |
|
|
|
|
|
+| dver | 字符串 | RTU 软件版本 |
|
|
|
|
|
+| proj | 字符串 | RTU/DTU 项目标识,用于不同设备的升级判断 |
|
|
|
|
|
+| gps | 字符串 | 定位方式:`0` 手动定位,`1` GPS 定位,`2` 基站定位 |
|
|
|
|
|
+| gps_inuse | 字符串 | 当前使用中的卫星数量 |
|
|
|
|
|
+| gps_view | 字符串 | 当前可见卫星数量 |
|
|
|
|
|
+| photo_sta | 字符串 | 相机状态 |
|
|
|
|
|
+| link_sta | 字符串 | 有线网络接入状态 |
|
|
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
@@ -247,10 +252,10 @@ MCU 可通过 `warn` 指令向 RTU 上报预警信息。
|
|
|
}
|
|
}
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
-| 字段 | 说明 |
|
|
|
|
|
-|:---|:---|
|
|
|
|
|
|
|
+| 字段 | 说明 |
|
|
|
|
|
+| :----- | :------ |
|
|
|
| status | 预警或状态信息 |
|
|
| status | 预警或状态信息 |
|
|
|
-| type | 预警类型 |
|
|
|
|
|
|
|
+| type | 预警类型 |
|
|
|
|
|
|
|
|
RTU 根据业务需要对 MCU 预警信息进行处理,并可通过 MQTT 向服务器透传。
|
|
RTU 根据业务需要对 MCU 预警信息进行处理,并可通过 MQTT 向服务器透传。
|
|
|
|
|
|
|
@@ -284,9 +289,9 @@ RTU 根据业务需要对 MCU 预警信息进行处理,并可通过 MQTT 向
|
|
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
-## 8. MCU 执行拍照
|
|
|
|
|
|
|
+## 8. MCU 请求拍照
|
|
|
|
|
|
|
|
-### 8.1 RTU → MCU
|
|
|
|
|
|
|
+### 8.1 MCU → RTU
|
|
|
|
|
|
|
|
```json
|
|
```json
|
|
|
{
|
|
{
|
|
@@ -294,14 +299,18 @@ RTU 根据业务需要对 MCU 预警信息进行处理,并可通过 MQTT 向
|
|
|
}
|
|
}
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
-MCU 收到指令后执行拍照操作。
|
|
|
|
|
|
|
+MCU 主动向 RTU 发起拍照请求。
|
|
|
|
|
+
|
|
|
|
|
+RTU 收到请求后控制相机执行实际拍照,拍照结果及相关状态由 RTU 根据实际业务进行处理,照片上传由 RTU 根据实际业务通过 MQTT 向服务器上报。
|
|
|
|
|
|
|
|
-拍照结果及相关状态由 RTU 根据实际业务进行处理。
|
|
|
|
|
|
|
+此外,服务器也可以通过 MQTT 向 RTU 下发拍照指令,由 RTU 直接控制相机完成拍照,不经过 MCU。
|
|
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
## 9. MCU 动作控制
|
|
## 9. MCU 动作控制
|
|
|
|
|
|
|
|
|
|
+RTU → MCU
|
|
|
|
|
+
|
|
|
所有硬件动作控制统一使用:
|
|
所有硬件动作控制统一使用:
|
|
|
|
|
|
|
|
```json
|
|
```json
|
|
@@ -461,26 +470,26 @@ MCU 收到指令后执行拍照操作。
|
|
|
|
|
|
|
|
为避免 `uart`、`cmd` 和 `ext.type` 三种指令字段混淆,所有协议指令统一按照实际字段进行汇总。
|
|
为避免 `uart`、`cmd` 和 `ext.type` 三种指令字段混淆,所有协议指令统一按照实际字段进行汇总。
|
|
|
|
|
|
|
|
-| 指令 | `uart` | `cmd` | `ext.type` | 方向 | 功能 |
|
|
|
|
|
-|:---|:---|:---|:---|:---|:---|
|
|
|
|
|
-| 获取 RTU 状态 | `getinfo` | — | — | MCU → RTU | MCU 请求 RTU 状态信息 |
|
|
|
|
|
-| 获取 MCU 最新数据 | — | `read` | — | RTU → MCU | RTU 请求 MCU 返回最新数据 |
|
|
|
|
|
-| MCU 重启 | — | `reboot` | — | RTU → MCU | 控制 MCU 重启 |
|
|
|
|
|
-| MCU 升级 | — | `update` | — | RTU → MCU | 控制 MCU 执行升级 |
|
|
|
|
|
-| MCU 参数重置 | — | `reset` | — | RTU → MCU | 重置 MCU 参数 |
|
|
|
|
|
-| 执行拍照 | — | `takephoto` | — | RTU → MCU | 控制 MCU 执行拍照 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `led_on` | RTU → MCU | 打开补光灯 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `led_off` | RTU → MCU | 关闭补光灯 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `lamp_on` | RTU → MCU | 打开测报灯 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `lamp_off` | RTU → MCU | 关闭测报灯 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `up_m_open` | RTU → MCU | 打开上门 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `up_m_close` | RTU → MCU | 关闭上门 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `down_m_open` | RTU → MCU | 打开下门 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `down_m_close` | RTU → MCU | 关闭下门 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `heat_on` | RTU → MCU | 开启加热 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `heat_off` | RTU → MCU | 关闭加热 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `clear_on` | RTU → MCU | 执行清洁 |
|
|
|
|
|
-| 动作控制 | — | `ctrl` | `selfcheck` | RTU → MCU | 执行自检 |
|
|
|
|
|
|
|
+| 指令 | `uart` | `cmd` | `ext.type` | 方向 | 功能 |
|
|
|
|
|
+| :---------- | :-------- | :---------- | :------------- | :-------- | :---------------- |
|
|
|
|
|
+| 获取 RTU 状态 | `getinfo` | — | — | MCU → RTU | MCU 请求 RTU 状态信息 |
|
|
|
|
|
+| 获取 MCU 最新数据 | — | `read` | — | RTU → MCU | RTU 请求 MCU 返回最新数据 |
|
|
|
|
|
+| MCU 重启 | — | `reboot` | — | RTU → MCU | 控制 MCU 重启 |
|
|
|
|
|
+| MCU 升级 | — | `update` | — | RTU → MCU | 控制 MCU 执行升级 |
|
|
|
|
|
+| MCU 参数重置 | — | `reset` | — | RTU → MCU | 重置 MCU 参数 |
|
|
|
|
|
+| 请求拍照 | — | `takephoto` | — | MCU → RTU | MCU 请求 RTU 执行拍照 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `led_on` | RTU → MCU | 打开补光灯 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `led_off` | RTU → MCU | 关闭补光灯 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `lamp_on` | RTU → MCU | 打开测报灯 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `lamp_off` | RTU → MCU | 关闭测报灯 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `up_m_open` | RTU → MCU | 打开上门 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `up_m_close` | RTU → MCU | 关闭上门 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `down_m_open` | RTU → MCU | 打开下门 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `down_m_close` | RTU → MCU | 关闭下门 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `heat_on` | RTU → MCU | 开启加热 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `heat_off` | RTU → MCU | 关闭加热 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `clear_on` | RTU → MCU | 执行清洁 |
|
|
|
|
|
+| 动作控制 | — | `ctrl` | `selfcheck` | RTU → MCU | 执行自检 |
|
|
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
@@ -538,7 +547,6 @@ MCU
|
|
|
reboot
|
|
reboot
|
|
|
update
|
|
update
|
|
|
reset
|
|
reset
|
|
|
-takephoto
|
|
|
|
|
ctrl
|
|
ctrl
|
|
|
```
|
|
```
|
|
|
|
|
|
|
@@ -565,6 +573,38 @@ data
|
|
|
warn
|
|
warn
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
|
|
+### 11.5 MCU 请求拍照
|
|
|
|
|
+
|
|
|
|
|
+```text
|
|
|
|
|
+MCU
|
|
|
|
|
+ │
|
|
|
|
|
+ │ cmd=takephoto
|
|
|
|
|
+ ▼
|
|
|
|
|
+RTU
|
|
|
|
|
+ │
|
|
|
|
|
+ │ 控制相机
|
|
|
|
|
+ ▼
|
|
|
|
|
+相机
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+MCU 负责发起拍照请求,实际拍照由 RTU 控制相机完成。
|
|
|
|
|
+
|
|
|
|
|
+### 11.6 服务器请求拍照
|
|
|
|
|
+
|
|
|
|
|
+```text
|
|
|
|
|
+服务器
|
|
|
|
|
+ │
|
|
|
|
|
+ │ MQTT
|
|
|
|
|
+ ▼
|
|
|
|
|
+RTU
|
|
|
|
|
+ │
|
|
|
|
|
+ │ 控制相机
|
|
|
|
|
+ ▼
|
|
|
|
|
+相机
|
|
|
|
|
+```
|
|
|
|
|
+
|
|
|
|
|
+服务器下发的拍照指令由 RTU 直接处理,可以不经过 MCU,也可以当普通指令透传给MCU。
|
|
|
|
|
+
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
## 12. 协议指令结构
|
|
## 12. 协议指令结构
|
|
@@ -633,7 +673,7 @@ warn
|
|
|
└─────────────┘ │
|
|
└─────────────┘ │
|
|
|
▲ │
|
|
▲ │
|
|
|
│ │
|
|
│ │
|
|
|
- └──── MQTT 透传 ──────┘
|
|
|
|
|
|
|
+ └──── MQTT 透传───────┘
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
### 典型通信过程
|
|
### 典型通信过程
|
|
@@ -658,18 +698,25 @@ warn
|
|
|
5. MCU → RTU → 服务器
|
|
5. MCU → RTU → 服务器
|
|
|
MCU 返回状态/预警信息
|
|
MCU 返回状态/预警信息
|
|
|
RTU 通过 MQTT 透传
|
|
RTU 通过 MQTT 透传
|
|
|
|
|
+
|
|
|
|
|
+6. MCU → RTU → 相机
|
|
|
|
|
+ MCU 发起拍照请求
|
|
|
|
|
+ RTU 控制相机执行拍照
|
|
|
|
|
+
|
|
|
|
|
+7. 服务器 → RTU → 相机
|
|
|
|
|
+ 服务器下发拍照指令
|
|
|
|
|
+ RTU 直接控制相机执行拍照
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
## 14. 版本信息
|
|
## 14. 版本信息
|
|
|
|
|
|
|
|
-| 项目 | 内容 |
|
|
|
|
|
-|:---|:---|
|
|
|
|
|
-| 协议名称 | 测报灯 MCU 串口交互协议 |
|
|
|
|
|
-| 协议版本 | v0.1 |
|
|
|
|
|
-| 上位机 | RTU |
|
|
|
|
|
-| 下位机 | MCU |
|
|
|
|
|
-| 主要通信方式 | RTU ↔ MCU:串口 |
|
|
|
|
|
-| 网络通信方式 | RTU ↔ 服务器:MQTT |
|
|
|
|
|
-| MQTT 作用 | MCU 数据及控制指令透传 |
|
|
|
|
|
|
|
+| 项目 | 内容 |
|
|
|
|
|
+| :------ | :------------- |
|
|
|
|
|
+| 协议名称 | 测报灯 MCU 串口交互协议 |
|
|
|
|
|
+| 协议版本 | v0.1 |
|
|
|
|
|
+| 上位机 | RTU |
|
|
|
|
|
+| 下位机 | MCU |
|
|
|
|
|
+| 主要通信方式 | RTU ↔ MCU:串口 |
|
|
|
|
|
+| 网络通信方式 | RTU ↔ 服务器:MQTT |
|