Modbus 网络通信学习笔记

本文重点整理 Modbus TCP/IP、Modbus UDP/IP、Modbus RTU Over TCP/IP 与 Modbus RTU Over UDP/IP 的区别、帧结构、C# 常用操作和设备联调排查方法。内容基于当前 Modebus 文件夹中的学习材料、NModbus4 示例代码和设备联调记录整理，并补充实际项目中常见的判断方法。

一、核心概念

1. Modbus TCP/IP

Modbus TCP/IP 是把 Modbus 应用层数据封装到 TCP 中的通信方式。它是原生以太网 Modbus 协议，不是简单地把 RTU 串口帧放进 TCP。

通信过程可以理解为：

客户端软件 -> TCP 连接 -> 设备端口 -> 读取或写入寄存器 -> 返回响应

2. Modbus UDP/IP

Modbus UDP/IP 与 Modbus TCP/IP 类似，都是以太网场景下的 Modbus 通信方式，但底层使用 UDP。它不像 Modbus TCP/IP 那样常见，实际项目中必须先确认设备是否支持。

UDP 的优势是开销较小、延迟通常较低；缺点是可靠性需要应用层自行处理，例如超时、重试、丢包判断等。如果设备同时支持 TCP 和 UDP，生产环境通常优先选择 TCP。

3. Modbus RTU Over TCP/IP

Modbus RTU Over TCP/IP 不是 Modbus TCP/IP。它只是把完整的 RTU 帧通过 TCP 传输，帧中仍然包含从站地址和 CRC16。

常见链路如下：

上位机程序 -> TCP -> 串口服务器 -> RS-485 -> Modbus RTU 设备

这种方式适合兼容已有串口 RTU 设备。在原生以太网设备之间通信时，一般优先选择 Modbus TCP/IP。

4. Modbus RTU Over UDP/IP

Modbus RTU Over UDP/IP 与 RTU Over TCP 类似，只是底层改为 UDP。它仍然保留 RTU 帧格式和 CRC16，可靠性取决于网络质量以及程序中的超时重试机制。

5. 四种网络方式对比

6. Modbus TCP 与 RTU Over TCP 的关键区别

二、常用操作

1. 常用功能码

2. C# 使用 NModbus4 创建不同通信模式

using Modbus.Device;
using System;
using System.Net;
using System.Net.Sockets;
​
public enum ModbusNetworkMode
{
   TcpIp,
   UdpIp,
   RtuOverTcp,
   RtuOverUdp
}
​
public static class ModbusMasterFactory
{
   public static ModbusMaster Create(string ip, int port, ModbusNetworkMode mode)
  {
       IPAddress address = IPAddress.Parse(ip);
​
       switch (mode)
      {
           case ModbusNetworkMode.TcpIp:
               TcpClient tcpClient = new TcpClient();
               tcpClient.Connect(address, port);
               return ModbusIpMaster.CreateIp(tcpClient);
​
           case ModbusNetworkMode.UdpIp:
               UdpClient udpClient = new UdpClient();
               udpClient.Connect(address, port);
               return ModbusIpMaster.CreateIp(udpClient);
​
           case ModbusNetworkMode.RtuOverTcp:
               TcpClient rtuTcpClient = new TcpClient();
               rtuTcpClient.Connect(address, port);
               return ModbusSerialMaster.CreateRtu(rtuTcpClient);
​
           case ModbusNetworkMode.RtuOverUdp:
               UdpClient rtuUdpClient = new UdpClient();
               rtuUdpClient.Connect(address, port);
               return ModbusSerialMaster.CreateRtu(rtuUdpClient);
​
           default:
               throw new NotSupportedException("不支持的 Modbus 通信模式");
      }
  }
}

具体是否能正常通信，取决于设备或网关支持的协议模式，不能只看代码创建方式。

3. 读取保持寄存器

using Modbus.Device;
​
public static ushort[] ReadFourHoldingRegisters(ModbusMaster master)
{
   byte slaveAddress = 1;
   ushort startAddress = 0;
   ushort registerCount = 4;
​
   return master.ReadHoldingRegisters(slaveAddress, startAddress, registerCount);
}

4. 定时读取设备数据

using Modbus.Device;
using System;
using System.Threading;
using System.Threading.Tasks;
​
public class ModbusPollingService
{
   private readonly ModbusMaster _master;
   private CancellationTokenSource _cts;
​
   public ModbusPollingService(ModbusMaster master)
  {
       _master = master;
  }
​
   public void Start(Action<ushort[]> onDataReceived)
  {
       _cts = new CancellationTokenSource();
​
       Task.Run(async () =>
      {
           while (!_cts.IsCancellationRequested)
          {
               ushort[] data = _master.ReadHoldingRegisters(1, 0, 4);
​
               if (data.Length == 4)
              {
                   onDataReceived(data);
              }
​
               await Task.Delay(1000, _cts.Token);
          }
      }, _cts.Token);
  }
​
   public void Stop()
  {
       _cts?.Cancel();
  }
}

5. 写单个保持寄存器

using Modbus.Device;
​
public static void WriteSingleRegister(ModbusMaster master)
{
   byte slaveAddress = 1;
   ushort registerAddress = 0;
   ushort value = 12;
​
   master.WriteSingleRegister(slaveAddress, registerAddress, value);
}

6. RTU 帧结构与 CRC16

读取保持寄存器 01 03 00 00 00 0A 的 CRC 结果常见为 CD C5，完整 RTU 请求帧为：

01 03 00 00 00 0A CD C5
public static byte[] CalculateModbusCrc16(byte[] data)
{
   ushort crc = 0xFFFF;
​
   foreach (byte item in data)
  {
       crc ^= item;
​
       for (int i = 0; i < 8; i++)
      {
           bool lsb = (crc & 0x0001) != 0;
           crc >>= 1;
​
           if (lsb)
          {
               crc ^= 0xA001;
          }
      }
  }
​
   return new[] { (byte)(crc & 0xFF), (byte)(crc >> 8) };
}

7. 设备联调流程

三、问题排查

错误1：SocketException 或连接失败

• 现象：TCP 连接失败，程序无法连接设备 IP 和端口。

• 原因：IP 不通、端口错误、防火墙拦截、设备未开启 Modbus TCP 服务、串口服务器模式配置错误。

• 解决：

  • 检查网络：确认电脑和设备在同一网段，先 ping 设备 IP。

  • 检查端口：Modbus TCP 通常使用 502，串口服务器可能使用自定义端口。

  • 检查模式：设备如果是 RTU 设备接串口服务器，应确认网关是 TCP Server、TCP Client 还是 UDP 模式。

  • 检查占用：同一设备可能只允许一个客户端连接，关闭其他调试工具后重试。

错误2：读取寄存器返回超时

• 现象：连接成功，但 ReadHoldingRegisters 长时间无响应或抛出超时异常。

• 原因：从站地址错误、寄存器地址错误、功能码不支持、设备没有接好、串口参数不一致。

• 解决：

  • 确认从站地址：RTU 设备尤其要确认地址，常见默认值为 1。

  • 确认寄存器地址：说明书写 40001 时，程序里常用地址 0。

  • 确认功能码：保持寄存器用 0x03，输入寄存器用 0x04。

  • 确认串口参数：RTU 设备需要一致的波特率、数据位、校验位、停止位。

错误3：CRC 校验失败

• 现象：RTU 或 RTU Over TCP/UDP 返回数据后 CRC 校验不通过。

• 原因：通信噪声、帧截断、协议模式选错、把 Modbus TCP 当成 RTU Over TCP 使用。

• 解决：

  • 区分协议：Modbus TCP 不带 RTU CRC；RTU Over TCP/UDP 必须带 CRC。

  • 检查网关模式：串口服务器需要配置为透明传输或对应的 Modbus 网关模式。

  • 检查接线：RS-485 的 A/B 线接反、屏蔽接地不良都可能导致数据异常。

  • 降低频率：轮询太快可能导致设备响应不完整，适当增加读取间隔。

错误4：数据能读到但数值不正确

• 现象：寄存器有返回值，但温度、湿度、压力等数据明显不合理。

• 原因：寄存器地址偏移、字节序错误、数据类型解析错误、未处理比例系数。

• 解决：

  • 查看说明书：确认数据类型是 ushort、short、int32、float 还是 BCD。

  • 处理比例系数：很多传感器需要除以 10、100 或 1000。

  • 处理有符号数：温度等可能使用 short 表示负数。

  • 检查高低字顺序：32 位数据可能存在 AB CD、CD AB、BA DC、DC BA 等字节序差异。

错误5：UDP 模式偶发丢包

• 现象：UDP 通信有时读取成功，有时无响应。

• 原因：UDP 本身不保证可靠传输，网络拥塞或设备处理能力不足都会导致丢包。

• 解决：

  • 增加重试：请求失败后重发 1 到 3 次。

  • 设置超时：避免程序一直等待。

  • 降低频率：读取周期不要过短。

  • 优先 TCP：如果设备支持 TCP，生产环境优先使用 Modbus TCP 或 RTU Over TCP。

错误6：WinForms 实时读取界面卡顿或跨线程异常

• 现象：实时读取时界面卡死，或提示不能从非 UI 线程访问控件。

• 原因：在 UI 线程执行耗时通信，或后台线程直接修改控件。

• 解决：

  • 后台读取：把 Modbus 读写放到 Task.Run 或定时任务中。

  • UI 线程更新：WinForms 使用 Invoke 或 BeginInvoke 更新控件。

  • 支持取消：使用 CancellationTokenSource 停止实时读取。

四、相关资源

• 官方文档：Modbus Organization

• 协议规范：Modbus Application Protocol Specification

• C# 库：NModbus4 NuGet

• 常用工具：Modbus Poll

• 常用工具：Modbus Slave

五、学习总结

• 协议选择：设备说明书写 Modbus TCP 时，用原生 Modbus TCP/IP；设备是 RS-485 RTU 再通过串口服务器联网时，通常考虑 RTU Over TCP/IP 或 RTU Over UDP/IP。

• 帧格式判断：带 MBAP、不带 CRC 的是 Modbus TCP/IP；带从站地址和 CRC 的是 Modbus RTU 或 RTU Over 网络。

• UDP 使用原则：UDP 不是首选通用方案，只有设备明确支持或业务确实需要时才使用，并且要做好超时和重试。

• 联调顺序：先读说明书，再用工具验证，最后写代码。不要一开始就直接写程序猜地址和功能码。

• 常见坑点：端口不对、从站地址不对、寄存器偏移、功能码选错、比例系数没处理、TCP 与 RTU Over TCP 混淆。