基于C#实现Modbus RTU通信

 更新时间:2026年03月12日 09:29:10   作者:yongui47834  
本文主要介绍了使用C#和Modbus RTU模式与下位机进行通信,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

一、环境配置与依赖安装

# NuGet包安装(支持.NET Framework 4.5+)
Install-Package NModbus4
Install-Package System.IO.Ports

二、核心代码实现

1. 串口初始化与连接

using System.IO.Ports;
using Modbus.Device;

public class ModbusRtuMaster
{
    private SerialPort _serialPort;
    private IModbusSerialMaster _master;

    public void Connect(string portName, int baudRate = 9600, Parity parity = Parity.None, 
                       int dataBits = 8, StopBits stopBits = StopBits.One)
    {
        try
        {
            _serialPort = new SerialPort(portName, baudRate, parity, dataBits, stopBits)
            {
                ReadTimeout = 3000,
                WriteTimeout = 3000
            };
            
            _serialPort.Open();
            _master = ModbusSerialMaster.CreateRtu(_serialPort);
            _master.Transport.Retries = 3; // 设置重试次数
            _master.Transport.WriteTimeout = 2000;
            _master.Transport.ReadTimeout = 2000;
        }
        catch (Exception ex)
        {
            Console.WriteLine($"连接失败: {ex.Message}");
            throw;
        }
    }

    public void Disconnect()
    {
        _master?.Close();
        _serialPort?.Close();
    }
}

2. 数据读取操作

public ushort[] ReadHoldingRegisters(byte slaveId, ushort startAddr, ushort count)
{
    try
    {
        return _master.ReadHoldingRegisters(slaveId, startAddr, count);
    }
    catch (ModbusException ex)
    {
        Console.WriteLine($"Modbus错误: {ex.ErrorCode}");
        return null;
    }
    catch (IOException ex)
    {
        Console.WriteLine($"通信异常: {ex.Message}");
        return null;
    }
}

// 示例调用
var data = master.ReadHoldingRegisters(1, 0, 10); // 从站1读取保持寄存器0-9

3. 数据写入操作

public void WriteSingleRegister(byte slaveId, ushort address, ushort value)
{
    _master.WriteSingleRegister(slaveId, address, value);
}

public void WriteMultipleCoils(byte slaveId, ushort startAddr, bool[] values)
{
    _master.WriteMultipleCoils(slaveId, startAddr, values);
}

三、关键功能实现

1. CRC16校验(Modbus标准)

public static class Crc16
{
    public static byte[] Compute(byte[] data)
    {
        ushort crc = 0xFFFF;
        foreach (byte b in data)
        {
            crc ^= (ushort)b;
            for (int i = 0; i < 8; i++)
            {
                if ((crc & 0x0001) != 0)
                {
                    crc >>= 1;
                    crc ^= 0xA001;
                }
                else
                {
                    crc >>= 1;
                }
            }
        }
        return new[] { (byte)crc, (byte)(crc >> 8) };
    }

    public static bool Validate(byte[] dataWithCrc)
    {
        if (dataWithCrc.Length < 2) return false;
        byte[] data = dataWithCrc.Take(dataWithCrc.Length - 2).ToArray();
        byte[] crc = Compute(data);
        return crc[0] == dataWithCrc[dataWithCrc.Length - 2] 
            && crc[1] == dataWithCrc[dataWithCrc.Length - 1];
    }
}

2. 帧间延迟计算

private int CalculateInterFrameDelay()
{
    int charBits = 1 + _serialPort.DataBits + 
                  (_serialPort.StopBits == StopBits.One ? 1 : 2) + 
                  (_serialPort.Parity == Parity.None ? 0 : 1);
    return (int)(3500.0 * charBits / _serialPort.BaudRate); // 3.5字符时间
}

四、错误处理与调试

1. 异常处理策略

try
{
    var data = ReadHoldingRegisters(1, 0, 10);
    if (data == null) throw new InvalidOperationException("读取失败");
}
catch (TimeoutException)
{
    Console.WriteLine("通信超时,请检查设备状态");
    Reconnect();
}
catch (InvalidOperationException ex)
{
    Console.WriteLine($"操作失败: {ex.Message}");
}

2. 自动重连机制

private void Reconnect()
{
    Disconnect();
    Thread.Sleep(1000);
    Connect(_config.PortName, _config.BaudRate);
}

五、性能优化

1批量操作优化

// 批量读取多个寄存器区域
public Dictionary<ushort, ushort[]> BatchRead(
    params (byte SlaveId, ushort StartAddr, ushort Count)[] requests)
{
    var results = new Dictionary<ushort, ushort[]>();
    Parallel.ForEach(requests, request => 
    {
        var data = ReadHoldingRegisters(request.SlaveId, request.StartAddr, request.Count);
        lock (results) results[request.SlaveId] = data;
    });
    return results;
}

2异步通信实现

public async Task<ushort[]> ReadAsync(byte slaveId, ushort startAddr, ushort count)
{
    return await Task.Run(() => ReadHoldingRegisters(slaveId, startAddr, count));
}

参考代码 C#利用modbus rtu模式与下位机通讯 www.youwenfan.com/contentcsr/112701.html

六、完整项目结构

ModbusRTUDemo/
├── src/
│   ├── ModbusMaster/          // 主站核心逻辑
│   ├── SerialPortConfig.cs    // 串口配置管理
│   └── ProtocolHandler.cs     // 协议解析器
├── tests/
│   ├── ModbusTests.cs         // 单元测试
│   └── StressTests.cs         // 压力测试
└── docs/
    └── 开发指南.md

七、调试与测试工具

  1. 虚拟串口工具

    使用VSPD创建虚拟串口对(如COM3<->COM4),方便调试

  2. Wireshark抓包分析

    过滤Modbus RTU协议,观察完整的请求/响应帧结构

  3. Modbus从站模拟

    使用Modbus Slave工具创建测试从站设备

八、扩展应用场景

1.多从站管理

public class ModbusNetwork
{
    private Dictionary<byte, ModbusRtuMaster> _slaves = new();
    
    public void AddSlave(byte address, string portName)
    {
        var master = new ModbusRtuMaster();
        master.Connect(portName);
        _slaves[address] = master;
    }
}

2.数据缓存机制

public class DataCache
{
    private Dictionary<ushort, (DateTime Timestamp, ushort Value)[]> _cache = new();
    
    public void UpdateCache(ushort[] data, ushort startAddr)
    {
        _cache[startAddr] = data.Select((v, i) => 
            (DateTime.Now, v)).ToArray();
    }
}

九、最佳实践建议

参数配置规范

  • 波特率:9600/19200/115200(根据设备手册选择)
  • 数据格式:8N1(默认配置)
  • 超时时间:读操作1000ms,写操作500ms

安全防护措施

  • 添加设备认证机制
  • 实现数据加密传输
  • 设置访问权限控制

到此这篇关于基于C#实现Modbus RTU通信的文章就介绍到这了,更多相关C# Modbus RTU通信内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • C#实现基于XML配置MenuStrip菜单的方法

    C#实现基于XML配置MenuStrip菜单的方法

    这篇文章主要介绍了C#实现基于XML配置MenuStrip菜单的方法,涉及C#使用XML配置MenuStrip菜单的原理与实现技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-08-08
  • C#对Xamarin框架进行数据绑定

    C#对Xamarin框架进行数据绑定

    这篇文章介绍了C#对Xamarin框架进行数据绑定,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-01-01
  • C#实现十字链表的使用示例

    C#实现十字链表的使用示例

    十字链表是一种将数据存储在节点中的数据结构,每个节点包含两个指针,分别指向下一个节点和上一个节点,通过定义节点类和链表类,实现十字链表的创建、遍历、插入和删除等操作,本文就来实现一下
    2023-11-11
  • C# Socket文件上传至服务器的操作方法

    C# Socket文件上传至服务器的操作方法

    文件上传有FTP、WebApi、WebService等等,这次我们来实现一个基于socket通信的本地客户端上传文件到服务器的例子,这篇文章主要介绍了C# Socket文件上传至服务器的操作方法,需要的朋友可以参考下
    2024-05-05
  • WPF自定义实现IP地址输入控件

    WPF自定义实现IP地址输入控件

    这篇文章主要给大家介绍了关于WPF自定义实现IP地址输入控件的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用WPF具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-06-06
  • Avalonia封装实现指定组件允许拖动的工具类

    Avalonia封装实现指定组件允许拖动的工具类

    这篇文章主要为大家详细介绍了Avalonia如何封装实现指定组件允许拖动的工具类,文中的示例代码讲解详细,感兴趣的小伙伴快跟随小编一起来学习学习吧
    2023-03-03
  • C# WinForm窗体编程中处理数字的正确操作方法

    C# WinForm窗体编程中处理数字的正确操作方法

    这篇文章主要介绍了C# WinForm窗体编程中处理数字的正确操作方法,本文给出了正确示例,并解释了为什么要这么做,需要的朋友可以参考下
    2014-08-08
  • WPF TextBox和PasswordBox添加水印

    WPF TextBox和PasswordBox添加水印

    这篇文章主要为大家详细介绍了WPF TextBox和PasswordBox添加水印的方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-11-11
  • C# WinForms中实现MD5的加密

    C# WinForms中实现MD5的加密

    MD5(消息摘要算法第5版)是一种广泛使用的哈希函数,可以生成一个128位(16字节)的哈希值,通常用于数据完整性校验和密码存储,在Windows Forms应用程序中实现MD5加密,可以用于用户密码的安全存储和数据的完整性验证,本文将详细介绍了如何在WinForms中实现MD5加密
    2024-10-10
  • C#字符串使用密钥进行加解密

    C#字符串使用密钥进行加解密

    这篇文章主要为大家详细介绍了C#字符串使用密钥进行加解密的代码,C#字符串加密和解密实现代码,感兴趣的小伙伴们可以参考一下
    2016-08-08

最新评论