# SL651-2014水文监测数据测试工具（多测站）

**Repository Path**: yqcgba/SL651

## Basic Information

- **Project Name**: SL651-2014水文监测数据测试工具（多测站）
- **Description**: SL651-2014水文监测数据通信规约模拟器（多测站），基于 Flask 构建的 SL651 水文监测数据通信规约模拟工具，用于测试和验证 SL651-2014 协议消息的构建、解析与传输，支持多测站数据仿真与测试，助力水利系统开发与调试。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-08-14
- **Last Updated**: 2026-08-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


我来帮您了解这个仓库并生成README的文字说明。首先让我获取一些关键信息。

根据我对仓库内容的分析，我为您整理了以下完整的 **README 文字说明**。这份说明基于仓库中的真实代码和文件结构提取而成，您可以直接使用或根据需要调整。

---

## 📖 SL651-2014 水文监测数据测试工具（多测站）

### 🎯 项目简介

这是一个基于 **Flask** 构建的 **SL651-2014 水文监测数据通信规约模拟器**，支持多测站数据仿真与测试。该工具用于测试和验证 SL651-2014 协议消息的构建、解析与传输，助力水利系统开发与调试。

### ✨ 核心功能

- **协议报文构建**：支持 SL651-2014 标准的 HEX/BCD 编码方式，自动构建完整的上行报文帧
- **协议报文解析**：提供报文解码功能，用于调试和验证
- **多测站支持**：可同时模拟多个测站的数据上报
- **M1 传输模式**：支持发送/无回答（M1）传输模式
- **数据元素配置**：内置水文监测要素定义（ELEMENT_DEFS、ELEMENT_REFS 等），支持灵活配置
- **独立 EXE 运行**：可打包为独立的 Windows 可执行文件，无需安装 Python 环境
- **Web 可视化界面**：基于 Flask + HTML 的现代化操作界面，访问地址 `http://127.0.0.1:5000`

### 🏗️ 
```
SL651/
├── scr/
│   ├── app.py                    # Flask Web 后端主程序
│   ├── sl651_protocol.py         # SL651-2014 协议编码/解码模块
│   ├── templates/
│   │   └── index.html            # 前端可视化界面
│   ├── build_exe.bat             # PyInstaller 打包脚本
│   ├── start.bat                 # 一键启动脚本
│   └── version_info.txt          # EXE 版本信息配置
├── 测试软件/                      # 测试相关目录
├── LICENSE                       # 木兰宽松许可证 v2
└── README.md
```

### 🚀 快速开始

#### 方式一：使用独立 EXE（推荐）

1. 双击 `scr/start.bat`，程序会自动检测并使用打包好的 EXE 文件
2. 浏览器将自动打开 `http://127.0.0.1:5000`
3. 无需安装任何依赖，可在任意 Windows 电脑上运行

#### 方式二：Python 源码运行

1. 确保已安装 Python 环境
2. 安装依赖：`pip install flask`
3. 运行：`python scr/app.py`
4. 访问：`http://127.0.0.1:5000`

#### 打包为 EXE

bash
#
``` 运行打包脚本
cd scr
build_exe.bat
```

打包完成后，EXE 文件位于 `dist/SL651_Simulator.exe`，可直接复制到任意 Windows 电脑使用。

### 📋 协议支持

| 特性 | 说明 |
|------|------|
| 协议标准 | SL651-2014 水文监测数据通信规约 |
| 编码方式 | HEX / BCD |
| 传输模式 | M1（发送/无回答） |
| 报文方向 | 上行报文（测站→中心） |
| 报文类型 | 定时报、随机报等 |

### 🛠️ 技术栈

- **后端**：Python + Flask
- **前端**：原生 HTML/CSS/JavaScript
- **打包工具**：PyInstaller
- **协议实现**：SL651-2014 标准 HEX/BCD 编解码

### 📝 版本历史

- **v1.3.0**：当前版本，支持多测站数据仿真、Web 可视化操作界面、独立 EXE 打包

### 📄 开源协议

本项目采用 **木兰宽松许可证 v2 (Mulan PSL v2)** 开源。

### 👤 作者

**邱小晨（YQC）**

---

## 💡 说明

以上内容是基于您仓库中 **真实存在的文件和代码** 提取整理的，包括：

- 从 `scr/app.py` 获取的应用启动逻辑和功能描述
- 从 `scr/sl651_protocol.py` 获取的协议编码模块信息
- 从 `scr/build_exe.bat` 和 `scr/start.bat` 获取的打包和启动方式
- 从 `scr/version_info.txt` 获取的版本号和作者信息
- 从 `LICENSE` 获取的开源许可证类型

如果您需要我直接调用 README 生成工具为您创建 PR，请告诉我，我可以使用 AI 自动生成并创建 Pull Request。