快速开始

系统要求

• Windows 7 或更高版本
• 需要至少一个可用的 COM 串口（RS-232/RS-485）
• 安装 Go 运行环境（如需要自行编译）

第一步：准备配置表

程序启动时会自动在当前目录寻找 项目变量信息.xlsx 文件。如果文件不存在，软件自动生成模板，桌面也有快捷键可一键生成。

这个 Excel 表格定义了所有要采集的变量。用户名和密码也在表格的「设定」页中配置，非硬编码。

基本变量页字段说明

列名	说明	示例
变量名	唯一标识这个变量	供水温度
变量类型	内存 / IO	IO
数据类型	Float / Short / UShort / Long / String / Bit	Float
串口号	连接的 COM 端口编号	3
波特率	串口通信速率	9600
设备地址	Modbus 设备地址 (1-247)	1
读功能码	1/2/3/4	3
寄存器地址	Modbus 寄存器地址	100
采集频率毫秒	每次采集间隔时间	5000

设定页

• 登录名 / 登录密码 — Web 页面登录凭证
• 端口 — Web 服务端口号（默认 53046）
• 企业微信 Webhook URL — 用于推送报警消息到企业微信群

第二步：启动

modbusrtu_broker.exe

首次启动时，程序会自动：

1. 读取 项目变量信息.xlsx 中的配置
2. 自动备份配置表
3. 为每个串口号启动一个独立的采集 goroutine
4. 启动 HTTP 服务器
5. 启动 SQLite 历史记录模块
6. 启动报警推送模块

第三步：查看数据

浏览器直接打开 http://127.0.0.1:53046/统计——这是一切的入口。还没登录的话，它会自动引导你去登录。

登录后页面直接展示所有内容：

• 所有 API 的实际调用链接（可直接复制使用）
• 变量的实时值、采集频率和状态
• 通讯异常指示
• 历史数据查询链接（可查看曲线图）

API 接口

登录后访问 /统计 页面会自动展示 API 的实际调用链接，可直接复制使用。

获取所有变量值

GET http://localhost:53046/数据?user=<MD5用户名>&password=<MD5密码>&项目代号=<项目代号>

返回格式：纯文本，每行一个变量

获取/设置单个变量值

GET http://localhost:53046/SetTagValue?tagName=变量名&tagValue=值&user=<MD5用户名>&password=<MD5密码>

查询历史数据

GET http://localhost:53046/SQLiteDB查询?参数...

故障排查

现象	可能原因	解决方法
启动后无数据	串口被占用	关闭其他串口软件
通讯异常值一直显示	设备地址错误	检查设备地址是否匹配
Web 页面打不开	端口被占用	修改 "设定" 表中的端口号
报警推送到微信失败	Webhook URL 错误	检查企业微信机器人配置

远程升级

1. 登录 Web 页面
2. 进入 "上传" 页面
3. 选择新的 .exe 文件上传
4. 程序自动替换并重启

技术支持

开发者: 158148415@qq.com