niujiuru 1 месяц назад
Родитель
Сommit
7badb71a45
3 измененных файлов с 222 добавлено и 166 удалено
  1. 113 66
      docs/测报灯MCU通信协议v0.1.md
  2. 67 58
      mcu_ctrl_board/readme.md
  3. 42 42
      mqtt_reporter/readme.md

+ 113 - 66
docs/测报灯MCU通信协议v0.1.md

@@ -8,10 +8,10 @@
 
 ### 1.1 名词约定
 
-| 名称 | 说明 |
-|:---|:---|
-| RTU | 上位机,负责网络通信、设备管理及与 MCU 的串口交互 |
-| MCU | 下位机,负责测报灯硬件控制、状态采集及数据上报 |
+| 名称   | 说明                                   |
+| :--- | :----------------------------------- |
+| RTU  | 上位机,负责网络通信、相机拍照及与 MCU 的串口交互          |
+| MCU  | 下位机,负责测报灯硬件控制、状态采集及数据上报              |
 | MQTT | RTU 与服务器之间的网络通信方式,同时用于部分 MCU 指令的数据透传 |
 
 ### 1.2 通信关系
@@ -20,24 +20,27 @@ RTU 与 MCU 通过串口进行双向通信,RTU 同时通过 MQTT 与服务器
 
 部分 MCU 数据及控制指令由服务器通过 MQTT 下发至 RTU,再由 RTU 通过串口转发给 MCU;MCU 返回的数据由 RTU 通过 MQTT 向服务器透传。
 
+相机直接连接 RTU,由 RTU 负责相机控制及实际拍照。
+
 ```text
                     MQTT
        ┌──────────────────────────┐
        │                          │
        ▼                          │
-   RTU 上位机  ◄──── 串口 ────► MCU 下位机
+   RTU上位机  ◄──── 串口 ────► MCU下位机
        │                          │
-       └────────── MQTT 透传 ─────┘
+       │                          │      
+       └───────────MQTT 透传─────┘┘┘
 ```
 
 ### 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 再通过串口转发 |
-| MCU → RTU → MQTT | MCU 通过串口返回数据,RTU 再通过 MQTT 向服务器透传 |
+| MCU → RTU → MQTT | MCU 通过串口返回数据,RTU 再通过 MQTT 向服务器透传         |
 
 ---
 
@@ -82,23 +85,25 @@ RTU 返回当前自身运行状态:
 
 ### 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 | 预警或状态信息 |
-| type | 预警类型 |
+| type   | 预警类型    |
 
 RTU 根据业务需要对 MCU 预警信息进行处理,并可通过 MQTT 向服务器透传。
 
@@ -284,9 +289,9 @@ RTU 根据业务需要对 MCU 预警信息进行处理,并可通过 MQTT 向
 
 ---
 
-## 8. MCU 执行拍照
+## 8. MCU 请求拍照
 
-### 8.1 RTU → MCU
+### 8.1 MCU → RTU
 
 ```json
 {
@@ -294,14 +299,18 @@ RTU 根据业务需要对 MCU 预警信息进行处理,并可通过 MQTT 向
 }
 ```
 
-MCU 收到指令后执行拍照操作。
+MCU 主动向 RTU 发起拍照请求。
+
+RTU 收到请求后控制相机执行实际拍照,拍照结果及相关状态由 RTU 根据实际业务进行处理,照片上传由 RTU 根据实际业务通过 MQTT 向服务器上报。
 
-拍照结果及相关状态由 RTU 根据实际业务进行处理。
+此外,服务器也可以通过 MQTT 向 RTU 下发拍照指令,由 RTU 直接控制相机完成拍照,不经过 MCU。
 
 ---
 
 ## 9. MCU 动作控制
 
+RTU → MCU
+
 所有硬件动作控制统一使用:
 
 ```json
@@ -461,26 +470,26 @@ MCU 收到指令后执行拍照操作。
 
 为避免 `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
 update
 reset
-takephoto
 ctrl
 ```
 
@@ -565,6 +573,38 @@ data
 warn
 ```
 
+### 11.5 MCU 请求拍照
+
+```text
+MCU
+ │
+ │ cmd=takephoto
+ ▼
+RTU
+ │
+ │ 控制相机
+ ▼
+相机
+```
+
+MCU 负责发起拍照请求,实际拍照由 RTU 控制相机完成。
+
+### 11.6 服务器请求拍照
+
+```text
+服务器
+ │
+ │ MQTT
+ ▼
+RTU
+ │
+ │ 控制相机
+ ▼
+相机
+```
+
+服务器下发的拍照指令由 RTU 直接处理,可以不经过 MCU,也可以当普通指令透传给MCU。
+
 ---
 
 ## 12. 协议指令结构
@@ -633,7 +673,7 @@ warn
         └─────────────┘              │
                ▲                     │
                │                     │
-               └──── MQTT 透传 ──────┘
+               └──── MQTT 透传───────┘
 ```
 
 ### 典型通信过程
@@ -658,18 +698,25 @@ warn
 5. MCU → RTU → 服务器
    MCU 返回状态/预警信息
    RTU 通过 MQTT 透传
+
+6. MCU → RTU → 相机
+   MCU 发起拍照请求
+   RTU 控制相机执行拍照
+
+7. 服务器 → RTU → 相机
+   服务器下发拍照指令
+   RTU 直接控制相机执行拍照
 ```
 
 ---
 
 ## 14. 版本信息
 
-| 项目 | 内容 |
-|:---|:---|
-| 协议名称 | 测报灯 MCU 串口交互协议 |
-| 协议版本 | v0.1 |
-| 上位机 | RTU |
-| 下位机 | MCU |
-| 主要通信方式 | RTU ↔ MCU:串口 |
-| 网络通信方式 | RTU ↔ 服务器:MQTT |
-| MQTT 作用 | MCU 数据及控制指令透传 |
+| 项目      | 内容             |
+| :------ | :------------- |
+| 协议名称    | 测报灯 MCU 串口交互协议 |
+| 协议版本    | v0.1           |
+| 上位机     | RTU            |
+| 下位机     | MCU            |
+| 主要通信方式  | RTU ↔ MCU:串口   |
+| 网络通信方式  | RTU ↔ 服务器:MQTT |

+ 67 - 58
mcu_ctrl_board/readme.md

@@ -1,84 +1,93 @@
-# MCU 控制板通信模块
+# MCU 控制板串口通信模块
 
 ## 模块概述
 
-该模块主要负责与测报灯单片机(MCU)控制板进行通信,实现 RTU(Linux)主控系统与 MCU 之间的数据交互和功能协同。
+该模块主要负责 RTU 与 MCU 控制板之间的串口通信,实现 MCU 数据、拍照请求、状态及告警信息交互,以及 MCU 控制指令收发。
 
-模块通过串口建立 RTU 与 MCU 之间的双向通信,并结合 MQTT 通信模块,实现 MCU 数据及控制指令的网络交互。
+模块负责串口数据收发、协议解析及数据处理,为 RTU 上层业务提供 MCU 相关数据和事件。
+
+## 通信关系
+
+```text
+                    ┌──────────────────┐
+                    │   云飞MQTT服务器  │
+                    └────────┬─────────┘
+                             │
+                         MQTT通信
+                             │
+                    ┌────────▼─────────┐
+                    │       RTU        │
+                    └────────┬─────────┘
+                             │
+                            串口
+                             │
+                    ┌────────▼─────────┐
+                    │       MCU        │
+                    └──────────────────┘
+```
+
+* **MCU → RTU**:运行数据、状态信息、告警信息、拍照请求等。
+* **RTU → MCU**:状态请求、数据请求、设备控制指令等。
+* **RTU → MQTT 服务器**:MCU 运行数据、状态及告警信息等。
+* **MQTT 服务器 → RTU → MCU**:MCU 相关控制及业务指令等。
 
 ## 主要功能
 
-### 1. MCU 通信
+### 1. 数据交互
 
-负责 MCU 通信连接的建立、维护及状态管理,实现 RTU 与 MCU 之间的数据交互。
+负责 RTU 与 MCU 之间的设备数据交互。
 
-支持 MCU 请求获取 RTU 的以下状态信息:
+* RTU 向 MCU 请求最新数据。
+* MCU 主动上报运行数据。
+* 将 MCU 数据提供给 RTU 上层业务,并由上层业务根据需要上报 MQTT 服务器。
 
-* 网络状态
-* 定位信息
-* 时间信息
-* 软件版本
-* 相机状态
-* 有线网络状态
+### 2. 拍照请求
 
-同时支持 RTU 请求 MCU 上报最新的测报灯运行数据,并对 MCU 返回的数据进行解析和处理,为上层业务模块提供相关数据。
+MCU 根据设备配置及运行条件发起拍照请求,模块负责接收并解析请求,通知 RTU 上层业务执行拍照。
 
-### 2. MCU 控制
+```text
+MCU
+ │ 拍照请求
+ ▼
+MCU串口通信模块
+ │
+ ▼
+RTU上层业务
+ │
+ │ 拍照控制
+ ▼
+相机
+```
 
-负责向 MCU 下发设备控制指令,包括:
+MCU 负责发起拍照请求,实际拍照由 RTU 完成,照片上传由 MQTT 通信上报模块负责。
 
-* 重启
-* 升级
-* 参数重置
-* 相机拍照
-* 补光灯控制
-* 测报灯控制
-* 上门控制
-* 下门控制
-* 加热控制
-* 清洁控制
-* 设备自检
+### 3. 告警信息
 
-### 3. 状态及告警处理
+负责接收和解析 MCU 上报的设备告警及异常信息,并提供给 RTU 上层业务处理。
 
-负责接收和处理 MCU 上报的运行数据、状态信息及告警信息,实现 RTU 与 MCU 之间的状态同步和告警事件处理。
+### 4. 状态信息
 
-其中:
+负责 MCU 设备状态信息的交互和处理,包括灯具、门、加热、电池及设备运行状态等。
 
-* **运行数据**:温度、湿度、风速、电压、电流等设备运行参数
-* **状态信息**:灯、门、加热、GPS 等设备当前工作状态
-* **告警信息**:设备异常、故障及其他告警信息
+RTU 的网络、GPS、系统时间等信息由 RTU 自身负责获取。
 
-### 4. 通信管理
+### 5. 控制指令
 
-负责 MCU 通信过程中的:
+负责 RTU 向 MCU 下发设备控制及业务指令,并接收 MCU 返回的执行结果。
 
-* 数据收发
-* 协议解析
-* 数据封装
-* 通信状态管理
-* 异常处理
+### 6. 串口通信
 
-为上层业务模块提供统一、可靠的 MCU 通信接口,确保 RTU 主控系统与 MCU 控制板之间的数据交互和设备控制稳定可靠。
+负责 MCU 串口数据的收发及协议处理,包括数据解析、封装、校验和异常处理。
 
-## 数据链路
+具体协议格式、命令字、字段定义及错误码见《测报灯MCU串口通信协议0.1.md》。
 
-```text
-                         MQTT 服务器
-                         ▲       │
-                  数据/照片上报   │ 控制指令
-                         │       ▼
-                         └─── RTU ───┐
-                                     │
-                                    串口
-                                     │
-                                     ▼
-                                MCU 控制板
-```
+## 模块职责
 
-其中:
+| 模块            | 主要职责                        |
+| :------------ | :-------------------------- |
+| MCU 控制板串口通信模块 | MCU 数据、拍照请求、状态、告警及控制指令的串口通信 |
+| MQTT 通信上报模块   | MQTT 通信及设备数据、状态、告警、照片上报     |
+| RTU 相机模块      | 相机控制及实际拍照                   |
+| RTU 上层业务      | MCU 业务处理、GPS 定位及各模块协调       |
 
-* **MCU → RTU**:运行数据、状态信息、告警信息等
-* **RTU → MCU**:状态请求、数据请求、设备控制指令等
-* **RTU → MQTT 服务器**:MCU 运行数据、状态及告警信息等
-* **MQTT 服务器 → RTU → MCU**:MCU 相关控制及业务指令等
+本模块主要负责 **RTU 与 MCU 控制板之间的串口通信**,不负责 MQTT 通信、相机实际拍照和 GPS 定位。

+ 42 - 42
mqtt_reporter/readme.md

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