niujiuru 1 месяц назад
Родитель
Сommit
cf89c73fb9

+ 32 - 0
Makefile

@@ -3,3 +3,35 @@
 all:
 	@echo "Nothing to build."
 
+# C&GO编译器
+CC := arm-linux-gnueabihf-gcc
+GO := go
+GO_BUILD := $(GO) build
+GO_FLAGS := -ldflags "-s -w -X main.BuildTime=$(shell date +%Y-%m-%dT%H:%M:%S)"
+
+# GO编译环境
+SETGO_ENV = \
+	GOOS=linux \
+	GOARCH=arm \
+	GOARM=7 \
+	CC=$(CC) \
+	CGO_ENABLED=1
+
+# 日期和时间
+DATE := $(shell date +%Y%m%d_%H%M%S)
+
+# 依赖库路径
+RTU_LINUX_MODULES_PATH := $(shell pwd)/../rtu_linux_modules
+
+# 编译的目标
+all: cbd_go_app cbd-web-ui
+
+cbd_go_app :
+
+cbd-web-ui :
+
+# 编译的清理
+clean:
+	$(MAKE) -C $(RTU_LINUX_MODULES_PATH) clean
+
+	rm -rf build

+ 2 - 0
go.mod

@@ -1,3 +1,5 @@
 module hnyfkj.com.cn/rtu/linux/rtu/cbd
 
 go 1.24.2
+
+replace hnyfkj.com.cn/rtu/linux => ../rtu_linux_modules

+ 17 - 0
mcu_ctrl_board/mcu_ctrl_board.c

@@ -1 +1,18 @@
 #include "mcu_ctrl_board.h"
+#include "mcu_ctrl_board.h"
+#include "../../rtu_linux_modules/swapi/subjects/serial/serial.h"
+
+// 模块名称
+static const char MODULE_NAME[] = "MCUCtrlBoard";
+
+// 打开与MCU控制板的串口通讯, 返回: 0成功, <0时失败
+int MCU_ComInit()
+{
+  return 0;
+}
+
+// 关闭与MCU控制板的串口通讯, 返回: 0成功, <0时失败
+int MCU_ComExit()
+{
+  return 0;
+}

+ 8 - 0
mcu_ctrl_board/mcu_ctrl_board.h

@@ -4,11 +4,19 @@
 #ifndef __MCU_CTRL_BOARD_H__
 #define __MCU_CTRL_BOARD_H__
 
+#include "../../rtu_linux_modules/swapi/include_swapiLib.h"
+
 #ifdef __cplusplus
 extern "C"
 {
 #endif
 
+// 打开与MCU控制板的串口通讯, 返回: 0成功, <0时失败
+int MCU_ComInit();
+
+// 关闭与MCU控制板的串口通讯, 返回: 0成功, <0时失败
+int MCU_ComExit();
+
 #ifdef __cplusplus
 }
 #endif

+ 84 - 0
mcu_ctrl_board/readme.md

@@ -0,0 +1,84 @@
+# MCU 控制板通信模块
+
+## 模块概述
+
+该模块主要负责与测报灯单片机(MCU)控制板进行通信,实现 RTU(Linux)主控系统与 MCU 之间的数据交互和功能协同。
+
+模块通过串口建立 RTU 与 MCU 之间的双向通信,并结合 MQTT 通信模块,实现 MCU 数据及控制指令的网络交互。
+
+## 主要功能
+
+### 1. MCU 通信
+
+负责 MCU 通信连接的建立、维护及状态管理,实现 RTU 与 MCU 之间的数据交互。
+
+支持 MCU 请求获取 RTU 的以下状态信息:
+
+* 网络状态
+* 定位信息
+* 时间信息
+* 软件版本
+* 相机状态
+* 有线网络状态
+
+同时支持 RTU 请求 MCU 上报最新的测报灯运行数据,并对 MCU 返回的数据进行解析和处理,为上层业务模块提供相关数据。
+
+### 2. MCU 控制
+
+负责向 MCU 下发设备控制指令,包括:
+
+* 重启
+* 升级
+* 参数重置
+* 相机拍照
+* 补光灯控制
+* 测报灯控制
+* 上门控制
+* 下门控制
+* 加热控制
+* 清洁控制
+* 设备自检
+
+### 3. 状态及告警处理
+
+负责接收和处理 MCU 上报的运行数据、状态信息及告警信息,实现 RTU 与 MCU 之间的状态同步和告警事件处理。
+
+其中:
+
+* **运行数据**:温度、湿度、风速、电压、电流等设备运行参数
+* **状态信息**:灯、门、加热、GPS 等设备当前工作状态
+* **告警信息**:设备异常、故障及其他告警信息
+
+### 4. 通信管理
+
+负责 MCU 通信过程中的:
+
+* 数据收发
+* 协议解析
+* 数据封装
+* 通信状态管理
+* 异常处理
+
+为上层业务模块提供统一、可靠的 MCU 通信接口,确保 RTU 主控系统与 MCU 控制板之间的数据交互和设备控制稳定可靠。
+
+## 数据链路
+
+```text
+                         MQTT 服务器
+                         ▲       │
+                  数据/照片上报   │ 控制指令
+                         │       ▼
+                         └─── RTU ───┐
+                                     │
+                                    串口
+                                     │
+                                     ▼
+                                MCU 控制板
+```
+
+其中:
+
+* **MCU → RTU**:运行数据、状态信息、告警信息等
+* **RTU → MCU**:状态请求、数据请求、设备控制指令等
+* **RTU → MQTT 服务器**:MCU 运行数据、状态及告警信息等
+* **MQTT 服务器 → RTU → MCU**:MCU 相关控制及业务指令等

+ 0 - 8
mcu_ctrl_board/readme.txt

@@ -1,8 +0,0 @@
-该模块主要负责与测报灯单片机(MCU)控制板进行通信,实现 RTU(Linux)主控系统与 MCU 之间的数据交互和功能协同。模块通过串口建立 RTU 与 MCU 之间的双向通信,并结合 MQTT 完成 MCU 数据及控制指令的网络透传。
-
-模块主要负责 MCU 通信连接的建立与维护,以及 MCU 状态信息、运行数据和控制指令的交互。支持 MCU 请求获取 RTU 的网络、定位、时间、软件版本、相机及有线网络等状态信息;同时支持 RTU 请求 MCU 上报最新测报灯运行数据,并对 MCU 返回的数据进行处理和向上层业务提供。
-
-在控制功能方面,模块负责向 MCU 下发重启、升级、参数重置、拍照等控制指令,并提供补光灯、测报灯、上下门、加热、清洁及设备自检等硬件动作控制。同时负责接收和处理 MCU 上报的运行状态及预警信息,实现 RTU 与 MCU 之间的状态同步和事件交互。
-
-模块还负责 MCU 通信过程中的数据收发、协议解析、通信状态管理及异常处理,为上层业务模块提供统一、可靠的 MCU 通信接口,确保 RTU 主控系统与 MCU 控制板之间的数据交互和设备控制稳定可靠。
-

+ 173 - 0
mqtt_reporter/readme.md

@@ -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 通信接口,完成设备数据、照片及控制指令与后端服务器之间的可靠传输。

+ 0 - 6
mqtt_reporter/readme.txt

@@ -1,6 +0,0 @@
-该模块主要负责 RTU 主控系统与 MQTT 服务器之间的通信,实现设备与后端服务之间的数据交互和业务协同。模块通过 MQTT 建立与服务器的通信连接,负责设备数据上报、服务器指令接收及相关消息的处理和转发。
-
-模块主要负责 MQTT 通信连接的建立、维护及状态管理,并根据业务需求向服务器上报设备运行状态、MCU 数据、定位信息、环境数据及设备事件等信息。同时接收服务器下发的设备控制、参数配置、远程升级及其他业务指令,并根据指令内容分发至对应业务模块执行。
-
-对于涉及 MCU 控制板的业务指令,模块负责完成 MQTT 消息与本地 MCU 通信之间的数据转发,实现服务器、RTU 与 MCU 之间的远程交互。模块同时负责 MQTT 消息的协议解析、数据封装、异常处理及必要的数据校验,为上层业务提供统一的后端通信接口,确保 RTU 与 MQTT 服务器之间的数据传输稳定、可靠。
-

+ 17 - 0
readme.md

@@ -0,0 +1,17 @@
+# 虫情测报灯 RTU APP
+
+本项目基于 **云飞科技 RTU-BSP-FRAMEWORK(云飞科技 Linux-RTU 远程终端单元通用微服务程序)** 构建,用于开发虫情测报灯 RTU 的 APP 可执行程序。
+
+## 基础框架
+
+项目基于云飞科技 Linux-RTU 远程终端单元通用微服务框架进行开发。
+
+框架源码仓库:
+
+```text
+http://code.nyzhwlw.com:10202/YFKJ_EmbeddedSoftwareTeam/rtu_linux_services.git
+```
+
+## 项目说明
+
+在 RTU 通用微服务框架的基础上,结合虫情测报灯的设备功能和业务需求,开发对应的 RTU APP 可执行程序,实现设备数据采集、设备控制、通信交互及相关业务功能。

+ 0 - 4
readme.txt

@@ -1,4 +0,0 @@
-基于云飞科技RTU-BSP-FRAMEWORK(云飞科技LINUX-RTU远程终端单元通用微服务程序)
-clone下载地址:http://code.nyzhwlw.com:10202/YFKJ_EmbeddedSoftwareTeam/rtu_linux_services.git
-,构建的虫情测报灯RTU的APP可执行程序。
-

+ 32 - 0
web-ui.service/readme.md

@@ -0,0 +1,32 @@
+# 测报灯 Web UI 服务
+
+## 模块说明
+
+以 `RTU_LINUX_SERVICE` 的 `web-ui.service` 为基础进行开发,在原有功能基础上增加测报灯自身的业务管理页面,组合生成测报灯项目专用的 `web-ui.service`。
+
+基础模块:
+
+```text
+RTU_LINUX_SERVICE/web-ui.service
+```
+
+基础代码地址:
+
+```text
+http://code.nyzhwlw.com:10202/YFKJ_EmbeddedSoftwareTeam/rtu_linux_services.git/web-ui.service
+```
+
+## 功能组成
+
+该模块由以下两部分组成:
+
+* `RTU_LINUX_SERVICE` 原有 Web UI 功能
+* 测报灯自身业务管理页面
+
+在基础 `web-ui.service` 上增加测报灯业务功能后,形成测报灯项目专用的 Web UI 服务。
+
+## 自动升级
+
+由于测报灯项目中的 `web-ui.service` 在 `RTU_LINUX_SERVICE` 基础上进行了业务定制,因此该模块作为独立版本进行维护和升级。
+
+其自动升级地址与 `RTU_LINUX_SERVICE` 中的 `web-ui.service` 不同。

+ 0 - 4
web-ui.service/readme.txt

@@ -1,4 +0,0 @@
-以RTU_LINUX_SERVICE的web-ui.service为基础,
-clone下载地址:http://code.nyzhwlw.com:10202/YFKJ_EmbeddedSoftwareTeam/rtu_linux_services.git/web-ui.service
-,再加上测报灯自身的业务管理页面, 组合生成新的web-ui.service, 因此该模块的自动升级地址将会和RTU_LINUX_SERVICE不同。
-