Modbus 网关操作手册-（TCP, RTU, ASCII）之间的透明转换

Modbus 网关操作手册

快速开始

最简单的使用方式

1. 选择配置文件（根据应用场景选择其一）：
   • config_rtu_to_tcp.xml - 串口设备转网络访问
   • config_tcp_to_rtu.xml - 网络设备转串口访问
   • config_tcp_to_tcp.xml - TCP 透明代理
2. 修改配置文件（如需要）：
   • 打开对应的 XML 配置文件
   • 修改 <Client> 和 <Server> 为实际设备参数
   • 保存文件
3. 运行程序：直接双击运行（推荐） ModbusGateway.exe 程序会自动加载同目录下的 config.xml 配置文件。
4. 验证运行：
   • 查看控制台输出
   • 使用 Modbus 客户端工具测试连接

1. 产品简介

Modbus 网关是一款专业的工业通信协议转换设备，支持 Modbus RTU、ASCII 和 TCP 三种协议之间的相互转换。

主要功能

• 协议转换：Modbus RTU/ASCII/TCP 双向转换
• 数据透传：透明传输 Modbus 数据
• 多站支持：支持 1-255 个 Modbus 从站地址
• 多连接：支持多个客户端同时连接（TCP 模式）
• 日志记录：自动记录运行日志

2. 典型应用场景

场景一：串口设备转网络访问（RTU → TCP）

应用背景：SCADA 系统需要访问多个串口设备，但计算机串口资源有限。

连接方式：

[Modbus RTU 设备] → (串口) → [Modbus 网关] → (以太网) → [SCADA 系统]

配置文件：config_rtu_to_tcp.xml

配置说明：

<?xml version="1.0" encoding="utf-8"?>
<ModbusGateway>
  <!-- 连接串口设备 -->
  <Client>rtu:COM1:9600-8-N-1</Client>
  <!-- 开启 TCP 服务 -->
  <Server>tcp:502</Server>
  <!-- 允许的从站站号范围 -->
  <ServerUnits>1-255</ServerUnits>
  <!-- 最大并发连接数 -->
  <ServerMaxConn>10</ServerMaxConn>
  <!-- 是否显示控制台 -->
  <NoConsole>false</NoConsole>
</ModbusGateway>

场景二：网络设备转串口访问（TCP → RTU）

应用背景：老旧上位机只有串口，需要访问网络 Modbus 设备。

连接方式：

[Modbus TCP 设备] → (以太网) → [Modbus 网关] → (串口) → [上位机]

配置文件：config_tcp_to_rtu.xml

配置说明：

<?xml version="1.0" encoding="utf-8"?>
<ModbusGateway>
  <!-- 连接远程 TCP 设备 -->
  <Client>tcp:192.168.1.100:502</Client>
  <!-- 开启串口服务 -->
  <Server>rtu:COM2:19200-8-E-1</Server>
  <!-- 是否显示控制台 -->
  <NoConsole>false</NoConsole>
</ModbusGateway>

场景三：TCP 透明代理（TCP → TCP）

应用背景：某 Modbus TCP 设备只支持一个客户端连接，需要共享给多个系统。

连接方式：

[客户端 1] ┐
[客户端 2] ├→ [Modbus 网关] → [Modbus TCP 设备]
[客户端 3] ┘

配置文件：config_tcp_to_tcp.xml

配置说明：

<?xml version="1.0" encoding="utf-8"?>
<ModbusGateway>
  <!-- 连接远程 TCP 设备 -->
  <Client>tcp:192.168.1.50:502</Client>
  <!-- 开启本地 TCP 服务 -->
  <Server>tcp:502</Server>
  <!-- 最大并发连接数 -->
  <ServerMaxConn>20</ServerMaxConn>
  <!-- 是否显示控制台 -->
  <NoConsole>false</NoConsole>
</ModbusGateway>

3. 技术规格

协议支持

串口参数

网络参数

性能指标

4. 安装与配置

4.1 系统要求

• 操作系统：Windows 7/8/10/11 或 Windows Server 2008+
• 运行环境：.NET 10.0 运行时（独立发布版无需安装）
• 硬件要求：
  • CPU: 1 GHz 及以上
  • 内存：512 MB 及以上
  • 硬盘空间：100 MB 及以上

4.2 安装步骤

1. 解压程序到指定目录
2. 根据需要修改配置文件
3. 运行 ModbusGateway.exe

4.3 配置文件说明

重要：程序会自动加载同目录下的 config.xml 配置文件。

如需使用其他配置文件，请重命名为 config.xml 或使用命令行参数：

./ModbusGateway.exe --config 配置文件名.xml

5. 操作指南

5.1 启动网关

方法一：直接双击运行（推荐）

• 找到 ModbusGateway.exe
• 双击运行

方法二：命令行启动

./ModbusGateway.exe

方法三：设置为 Windows 服务（生产环境推荐）

类似的工具很多，以 NSSM 工具举例：

# 安装服务
nssm install ModbusGateway
# 配置服务
Path: C:\Program Files\ModbusGateway\ModbusGateway.exe
Startup directory: C:\Program Files\ModbusGateway

# 启动服务

net start ModbusGateway

5.2 检查运行状态

启动成功后，控制台显示：

5.3 测试连接

TCP 模式测试：

1. 打开 Modbus Poll 或其他 Modbus TCP 客户端
2. 连接地址：127.0.0.1 或网关 IP
3. 端口：502
4. 读取寄存器，查看是否成功

串口模式测试：

1. 打开串口调试工具
2. 配置正确的串口参数
3. 发送 Modbus RTU 请求
4. 查看响应数据

5.4 停止网关

• 控制台退出：按 Ctrl+C
• 关闭窗口：直接点击关闭按钮
• 服务停止：net stop ModbusGateway

6. 故障排除

6.1 常见问题

问题 1：程序无法启动

可能原因：

1. 配置文件格式错误
2. 端口被占用
3. 串口不存在或被占用

解决方法：

1. 检查配置文件 XML 格式
2. 检查端口占用：netstat -ano | findstr ":502"
3. 检查串口：[System.IO.Ports.SerialPort]::GetPortNames()

问题 2：无法连接串口设备

可能原因：

1. 串口编号错误
2. 串口参数不匹配
3. 串口被占用

解决方法：

1. 确认 COM 端口号正确
2. 检查波特率、校验位等参数
3. 关闭其他使用该串口的程序

问题 3：TCP 连接失败

可能原因：

1. 防火墙阻止
2. 端口未监听
3. IP 地址错误

解决方法：

1. 开放防火墙端口
2. 确认网关已启动：netstat -ano | findstr ":502"
3. 确认 IP 地址正确

问题 4：通信数据异常

可能原因：

1. 站号设置错误
2. 寄存器地址错误
3. 数据类型不匹配

解决方法：

1. 确认 Modbus 从站地址正确
2. 检查寄存器地址（注意 0 基址和 1 基址）
3. 确认数据类型（16 位、32 位等）

6.2 获取技术支持

如遇到无法解决的问题，请联系：

• 技术支持 QQ：2492123056
• 提供信息：
  • 程序版本号
  • 操作系统版本
  • 配置文件内容
  • 日志文件内容
  • 故障现象描述

7. 日志查看

日志文件位于程序目录下的 Log 文件夹中：

C:\Program Files\ModbusGateway\Log\

日志文件按日期自动命名：

2026_04_11.log  # 2026 年 4 月 11 日的日志

8. 安全注意事项

电气安全

• 确保在断电情况下连接串口设备
• 确保设备良好接地
• RS-485 总线应安装防雷击和浪涌保护器

网络安全

• 仅开放必要的端口
• 限制可连接网关的 IP 地址
• 生产网络与办公网络隔离

运行环境

• 工作环境温度：0-40°C
• 工作环境湿度：10-90%（无冷凝）
• 保持设备清洁

9. 附录

Modbus 功能码

术语表