C#实现ModbusRTU详解【五】—— NModbus4的使用

已于 2022-02-25 10:13:33 修改
阅读量4.5w 收藏 343
点赞数 68
分类专栏： C#实现ModbusRTU通讯详解 文章标签： C# ModbusRTU NModbus4 串口通信 读写操作
于 2022-01-04 17:04:34 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/XUMENGCAS/article/details/122305152
版权

前言

通过前面的四篇文章，我们已经了解到了ModbusRTU具体是什么，以及如何生成正确的报文，也完成了一个完整实现ModbusRTU的Demo。

前面我们的实现方式，是从零开始一点点自己写，所以我们需要完整实现整个串口通讯以及报文的生成与收发。在实际使用的时候，我们其实不需要写那么多东西，GitHub上其实有很多现成的类库，可以直接导入使用，无需自己生成通讯报文。

由于本专栏并非仅仅介绍实际应用，所以前面花费了不少篇幅来讲解ModbusRTU的报文。如果能完全理解前面四篇文章的内容，那么当我们遇到需要使用常用的八种功能码以外的报文的情况的时候，我们也能举一反三地写出对应的程序，而不必依赖他人的类库。

在实际应用的开发过程中，如果充当主站的应用程序与子站直接的物理连接，并非完全是RS485等的串行通讯连接方式，而是中间使用了串口服务器将串行信号转换为以太网信号，那么则需要我们使用Socket通讯的方式将报文发送出去，所以就不能使用NModbus4这样的类库了。在这种情况下，虽然串行信号被转换成了以太网的信号，但是我们需要收发的报文格式是不变的，所以这时，我们只需要用我们前面写好的报文生成和解析的方法，结合Socket通讯，实现数据的请求与解析。

传送门：

C#实现ModbusRTU详解【一】—— 简介及仿真配置

C#实现ModbusRTU详解【二】—— 生成读取报文

C#实现ModbusRTU详解【三】—— 生成写入报文

C#实现ModbusRTU详解【四】—— 通讯Demo

引入类库

以下以Winform为例。创建一个Winform项目，然后在NuGet中安装NModbus4，如下图所示：

窗体界面

根据自己喜好创建布局，参考如下：

读写方法

首先我们需要引入NModbusRTU。

using Modbus.Device;

创建一个串口对象，还有一个ModbusRTU的实例对象。

/// <summary>
/// 私有串口实例
/// </summary>
private SerialPort serialPort = new SerialPort();

/// <summary>
/// 私有ModbusRTU主站字段
/// </summary>
private static IModbusMaster master;

 根据八种不同的功能，创建读写方法。

/// <summary>
/// 写入单个线圈
/// </summary>
private void WriteSingleCoil()
{
    bool result = false;
    if (rbxRWMsg.Text.Equals("true", StringComparison.OrdinalIgnoreCase) || rbxRWMsg.Text.Equals("1", StringComparison.OrdinalIgnoreCase))
    {
        result = true;
    }
    master.WriteSingleCoil((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, result);
}

/// <summary>
/// 批量写入线圈
/// </summary>
private void WriteArrayCoil()
{
    List<string> strList = rbxRWMsg.Text.Split(',').ToList();

    List<bool> result = new List<bool>();

    strList.ForEach(m => result.Add(m.Equals("true", StringComparison.OrdinalIgnoreCase) || m.Equals("1", StringComparison.OrdinalIgnoreCase)));

    master.WriteMultipleCoils((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, result.ToArray());
}

/// <summary>
/// 写入单个寄存器
/// </summary>
private void WriteSingleRegister()
{
    ushort result = Convert.ToUInt16(rbxRWMsg.Text);

    master.WriteSingleRegister((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, result);
}

/// <summary>
/// 批量写入寄存器
/// </summary>
private void WriteArrayRegister()
{
    List<string> strList = rbxRWMsg.Text.Split(',').ToList();

    List<ushort> result = new List<ushort>();

    strList.ForEach(m => result.Add(Convert.ToUInt16(m)));

    master.WriteMultipleRegisters((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, result.ToArray());
}

/// <summary>
/// 读取输出线圈
/// </summary>
/// <returns></returns>
private bool[] ReadCoils()
{
    return master.ReadCoils((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, (ushort)nudLength.Value);
}

/// <summary>
/// 读取输入线圈
/// </summary>
/// <returns></returns>
private bool[] ReadInputs()
{
    return master.ReadInputs((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, (ushort)nudLength.Value);
}

/// <summary>
/// 读取保持型寄存器
/// </summary>
/// <returns></returns>
private ushort[] ReadHoldingRegisters()
{
    return master.ReadHoldingRegisters((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, (ushort)nudLength.Value);
}

/// <summary>
/// 读取输入寄存器
/// </summary>
/// <returns></returns>
private ushort[] ReadInputRegisters()
{
    return master.ReadInputRegisters((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, (ushort)nudLength.Value);
}

创建显示读取数据到窗体的方法。

/// <summary>
/// 界面显示读取结果
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="result"></param>
private void SetMsg<T>(List<T> result)
{
    string msg = string.Empty;

    result.ForEach(m => msg += $"{m} ");

    rbxRWMsg.Text = msg.Trim();
}

 在按钮事件中调用读写方法。

/// <summary>
/// 读写事件
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void btnRW_Click(object sender, EventArgs e)
{
    //设定串口参数
    serialPort.PortName = cbxPort.SelectedItem.ToString();
    serialPort.BaudRate = (int)cbxBaudRate.SelectedItem;
    serialPort.Parity = GetSelectedParity();
    serialPort.DataBits = (int)cbxDataBits.SelectedItem;
    serialPort.StopBits = GetSelectedStopBits();

    //创建ModbusRTU主站实例
    master = ModbusSerialMaster.CreateRtu(serialPort);

    //打开串口
    if (!serialPort.IsOpen) serialPort.Open();

    //根据选择的模式进行读写
    switch (cbxMode.SelectedItem.ToString())
    {
        case "读取输出线圈":
            SetMsg(ReadCoils().ToList());
            break;
        case "读取离散输入":
            SetMsg(ReadInputs().ToList());
            break;
        case "读取保持型寄存器":
            SetMsg(ReadHoldingRegisters().ToList());
            break;
        case "读取输入寄存器":
            SetMsg(ReadInputRegisters().ToList());
            break;
        case "写入单个线圈":
            if (rbxRWMsg.Text.Contains(","))
            {
                MessageBox.Show("输入值过多");
                return;
            }
            WriteSingleCoil();
            break;
        case "写入多个线圈":
            WriteArrayCoil();
            break;
        case "写入单个寄存器":
            if (rbxRWMsg.Text.Contains(","))
            {
                MessageBox.Show("输入值过多");
                return;
            }
            WriteSingleRegister();
            break;
        case "写入多个寄存器":
            WriteArrayRegister();
            break;
        default:
            break;
    }

    //关闭串口
    serialPort.Close();
}

读写测试

读取输出线圈

读取输入线圈

读取保持型寄存器

读取输入寄存器

写入单个线圈

写入多个线圈

写入单个寄存器

写入多个寄存器

完整代码

using Modbus.Device;
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.IO.Ports;
using System.Linq;
using System.Text;
using System.Text.RegularExpressions;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace NModbusDemo
{
    public partial class DemoForm : Form
    {
        /// <summary>
        /// 私有串口实例
        /// </summary>
        private SerialPort serialPort = new SerialPort();

        /// <summary>
        /// 私有ModbusRTU主站字段
        /// </summary>
        private static IModbusMaster master;

        /// <summary>
        /// 构造函数
        /// </summary>
        public DemoForm()
        {
            InitializeComponent();            
        }

        /// <summary>
        /// 窗体加载事件
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void DemoForm_Load(object sender, EventArgs e)
        {
            //设置可选串口
            cbxPort.Items.AddRange(SerialPort.GetPortNames());
            //设置可选波特率
            cbxBaudRate.Items.AddRange(new object[] { 9600, 19200 });
            //设置可选奇偶校验
            cbxParity.Items.AddRange(new object[] { "None", "Odd", "Even", "Mark", "Space" });
            //设置可选数据位
            cbxDataBits.Items.AddRange(new object[] { 5, 6, 7, 8 });
            //设置可选停止位
            cbxStopBits.Items.AddRange(new object[] { 1, 1.5, 2 });
            //设置读写模式
            cbxMode.Items.AddRange(new object[] {
                "读取输出线圈",
                "读取离散输入",
                "读取保持型寄存器",
                "读取输入寄存器",
                "写入单个线圈",
                "写入多个线圈",
                "写入单个寄存器",
                "写入多个寄存器"
            });

            //设置默认选中项
            cbxPort.SelectedIndex = 1;
            cbxBaudRate.SelectedIndex = 0;
            cbxParity.SelectedIndex = 0;
            cbxDataBits.SelectedIndex = 3;
            cbxStopBits.SelectedIndex = 0;
            cbxMode.SelectedIndex = 0;

            nudLength.Minimum = 1;
            nudSlaveID.Minimum = 1;
            nudStartAdr.Minimum = 0;

            //设置为默认输入法，即为英文半角
            rbxRWMsg.ImeMode = ImeMode.Disable;            
        }

        /// <summary>
        /// 模式切换事件
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void cbxMode_SelectedIndexChanged(object sender, EventArgs e)
        {
            rbxRWMsg.Clear();
            if (cbxMode.SelectedItem.ToString().Contains("读取"))
            {
                btnRW.Text = "读取";
                rbxRWMsg.Enabled = false;
                nudLength.Enabled = true;
            }
            else
            {
                btnRW.Text = "写入";
                rbxRWMsg.Enabled = true;
                nudLength.Enabled = false;
            }
        }

        /// <summary>
        /// 读写事件
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void btnRW_Click(object sender, EventArgs e)
        {
            //设定串口参数
            serialPort.PortName = cbxPort.SelectedItem.ToString();
            serialPort.BaudRate = (int)cbxBaudRate.SelectedItem;
            serialPort.Parity = GetSelectedParity();
            serialPort.DataBits = (int)cbxDataBits.SelectedItem;
            serialPort.StopBits = GetSelectedStopBits();

            //创建ModbusRTU主站实例
            master = ModbusSerialMaster.CreateRtu(serialPort);

            //打开串口
            if (!serialPort.IsOpen) serialPort.Open();
            
            //根据选择的模式进行读写
            switch (cbxMode.SelectedItem.ToString())
            {
                case "读取输出线圈":
                    SetMsg(ReadCoils().ToList());
                    break;
                case "读取离散输入":
                    SetMsg(ReadInputs().ToList());
                    break;
                case "读取保持型寄存器":
                    SetMsg(ReadHoldingRegisters().ToList());
                    break;
                case "读取输入寄存器":
                    SetMsg(ReadInputRegisters().ToList());
                    break;
                case "写入单个线圈":
                    if (rbxRWMsg.Text.Contains(","))
                    {
                        MessageBox.Show("输入值过多");
                        serialPort.Close();
                        return;
                    }
                    WriteSingleCoil();
                    break;
                case "写入多个线圈":
                    WriteArrayCoil();
                    break;
                case "写入单个寄存器":
                    if (rbxRWMsg.Text.Contains(","))
                    {
                        MessageBox.Show("输入值过多");
                        serialPort.Close();
                        return;
                    }
                    WriteSingleRegister();
                    break;
                case "写入多个寄存器":
                    WriteArrayRegister();
                    break;
                default:
                    break;
            }

            //关闭串口
            serialPort.Close();
        }

        /// <summary>
        /// 更新写入值计数
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void rbxRWMsg_TextChanged(object sender, EventArgs e)
        {
            nudLength.Value = Regex.Matches(rbxRWMsg.Text, ",").Count + 1;
        }

        /// <summary>
        /// 获取窗体选中的奇偶校验
        /// </summary>
        /// <returns></returns>
        private Parity GetSelectedParity()
        {
            switch (cbxParity.SelectedItem.ToString())
            {
                case "Odd":
                    return Parity.Odd;
                case "Even":
                    return Parity.Even;
                case "Mark":
                    return Parity.Mark;
                case "Space":
                    return Parity.Space;
                case "None":
                default:
                    return Parity.None;
            }
        }

        /// <summary>
        /// 获取窗体选中的停止位
        /// </summary>
        /// <returns></returns>
        private StopBits GetSelectedStopBits()
        {
            switch (Convert.ToDouble(cbxStopBits.SelectedItem))
            {
                case 1:
                    return StopBits.One;
                case 1.5:
                    return StopBits.OnePointFive;
                case 2:
                    return StopBits.Two;
                default:
                    return StopBits.One;
            }
        }

        /// <summary>
        /// 写入单个线圈
        /// </summary>
        private void WriteSingleCoil()
        {
            bool result = false;
            if (rbxRWMsg.Text.Equals("true", StringComparison.OrdinalIgnoreCase) || rbxRWMsg.Text.Equals("1", StringComparison.OrdinalIgnoreCase))
            {
                result = true;
            }
            master.WriteSingleCoil((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, result);
        }

        /// <summary>
        /// 批量写入线圈
        /// </summary>
        private void WriteArrayCoil()
        {
            List<string> strList = rbxRWMsg.Text.Split(',').ToList();

            List<bool> result = new List<bool>();

            strList.ForEach(m => result.Add(m.Equals("true", StringComparison.OrdinalIgnoreCase) || m.Equals("1", StringComparison.OrdinalIgnoreCase)));

            master.WriteMultipleCoils((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, result.ToArray());
        }

        /// <summary>
        /// 写入单个寄存器
        /// </summary>
        private void WriteSingleRegister()
        {
            ushort result = Convert.ToUInt16(rbxRWMsg.Text);

            master.WriteSingleRegister((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, result);
        }

        /// <summary>
        /// 批量写入寄存器
        /// </summary>
        private void WriteArrayRegister()
        {
            List<string> strList = rbxRWMsg.Text.Split(',').ToList();

            List<ushort> result = new List<ushort>();

            strList.ForEach(m => result.Add(Convert.ToUInt16(m)));

            master.WriteMultipleRegisters((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, result.ToArray());
        }

        /// <summary>
        /// 读取输出线圈
        /// </summary>
        /// <returns></returns>
        private bool[] ReadCoils()
        {
            return master.ReadCoils((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, (ushort)nudLength.Value);
        }

        /// <summary>
        /// 读取输入线圈
        /// </summary>
        /// <returns></returns>
        private bool[] ReadInputs()
        {
            return master.ReadInputs((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, (ushort)nudLength.Value);
        }

        /// <summary>
        /// 读取保持型寄存器
        /// </summary>
        /// <returns></returns>
        private ushort[] ReadHoldingRegisters()
        {
            return master.ReadHoldingRegisters((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, (ushort)nudLength.Value);
        }

        /// <summary>
        /// 读取输入寄存器
        /// </summary>
        /// <returns></returns>
        private ushort[] ReadInputRegisters()
        {
            return master.ReadInputRegisters((byte)nudSlaveID.Value, (ushort)nudStartAdr.Value, (ushort)nudLength.Value);
        }

        /// <summary>
        /// 界面显示读取结果
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="result"></param>
        private void SetMsg<T>(List<T> result)
        {
            string msg = string.Empty;

            result.ForEach(m => msg += $"{m} ");

            rbxRWMsg.Text = msg.Trim();
        }
    }
}

结尾

至此，本专栏需要介绍的所有东西都已经介绍完毕了。

C#使用NModbus4库实现ModbusRtu通信
qq_32114737的博客
03-23 1372
下面代码为常用功能的方法：01-读线圈，02-读离散量输入，03-读保持型寄存器，04-读输入寄存器，05-写单个线圈，06-写单个寄存器，15-写多个线圈，16-写多个寄存器。NModbus4可以实现ModbusRtu、ModbusTcp等串口通信，组件使用很方便，封装很好，不需要了解底层协议的具体格式内容，便于软体工程师使用。在此使用C#与modbus slave进行modbusRtu通信，需要了解协议格式的，可以在modbus slave中监控协议内容。
C#中的通信-NModbus4
愿你历尽千帆，归来仍是少年。
08-08 760
NModbus4是一个用于Modbus通信的开源库，它提供了一套简单易用的API来实现Modbus协议的通信。Modbus是一种应用层协议，主要用于工业自动化领域的电子设备之间的通信。它支持多种通信方式，包括RTU（二进制模式）、ASCII和TCP/IP。​// 创建一个Modbus Master，假设使用TCP/IP通信​// 连接到Modbus Slave，Slave的地址是1​// 读取保持寄存器的值，从地址0开始，读取10个寄存器​// 断开连接。
C#中NModbus4中常用的方法
最新发布
愿你历尽千帆，归来仍是少年。
09-27 930
NModbus4 是一个用于 Modbus 协议通信的 C# 库，它支持串行 ASCII、RTU、TCP 和 UDP 协议。
Nmodbus库使用说明
qq_46827462的博客
08-13 1096
Modbus协议是应用于电子控制器上的一种通用语言，此协议支持传统的RS-232、RS-422、RS-485和以太网设备。
NModbus类库使用总结
03-28
自己使用NModbus类库实现Modbus协议的过程中作的总结，总结了如何使用NModbus类库
NModbus4 安装和配置指南
gitblog_09109的博客
09-13 462
NModbus4 安装和配置指南 NModbus4 NModbus4 is a C# implementation of the Modbus protocol. This project is archived in favor of https://github.com/NModbus/NModbus ...
Modbus RTU c#
05-29
Modbus Rtu c# 相关代码(CRC生成,数据发送,数据接收与验证)
在C#中使用NModbus4通信库执行读操作
qq_35320456的博客
03-11 3268
在C#中使用NModbus4通信库执行【读】操作
modbusRTU通信简单实现（使用NModbus4通信库）
dawfwafaew的博客
11-17 5557
本文实现ModbusRTU通信，使用的是NModbus4通信库，使用Slave是一个模拟Modbus协议从机的上位机软件，主要用于模拟测试跟其他主机设备通信的过程。与之成套存在的另一个软件--Modbus Poll，则是模拟Modbus协议主机的上位机软件。
【modbus-C#】 NModbus4 使用
cxyhjl的博客
05-13 4517
演示界面视频演示Modbus Encoding for Floating Point ValuesIEEE 754 单精度浮点格式是表示浮点数的最流行方法，但需要 32 位。制造商已决定使用 2 个连续的 Modbus 寄存器来编码浮点值。这听起来很容易……但是，没那么快。尽管同意使用 2 个连续的寄存器对浮点值进行编码，但对于数据发送的顺序没有标准方法。示例：对于浮点值...
在C#中使用NModbus4通信库执行【读】操作
qq_35320456的博客
03-11 2170
在C#中使用NModbus4通信库执行读操作
C#modbus rtu绝对好用，绝对能用
03-05
C#modbus rtu绝对好用，绝对能用，C#modbus rtu绝对好用，绝对能用
使用C# Modbus RTU串口通信
01-10
使用C# Modbus RTU串口通信 支援Modbus RTU 封包格式 自動計算CRC 測試工具
C#modbus rtu绝对好用，绝对能用.rar_C# ModbusRtu 库_C#Modbus通信_C#modbusrtu_
07-14
C#使用的modbus通讯协议编程。。真实可靠有用
c#版本MODBUS RTU类库及测试程序
02-06
C#版本MODBUS RTU方式的类库测试程序，可复制上行及下行MODBUS 指令文本，便于协议解析，类库可读写保持寄存器，线圈等。
C#语言编写Modbus RTU通讯程序
01-20
- 库引用：使用第三方库如NModbus，它提供了C#实现的Modbus RTU通信功能。 3. **C#与Modbus RTU通信的基础步骤** - **建立连接**：首先，需要创建一个连接到Modbus设备的实例，如`SerialPort`对象，设置正确的...
C#如何实现modbus rtu转modbus tcp
08-03
在C#中实现Modbus RTU转Modbus TCP可以通过使用第三方库来实现。一个常用的库是NModbus，它提供了用于Modbus通信的功能。以下是一个简单的示例代码，展示了如何使用NModbus库实现Modbus RTU转Modbus TCP： ```csharp using System; using System.Net.Sockets; using Modbus.Device; class Program { static void Main() { // 创建一个TCP客户端 TcpClient tcpClient = new TcpClient("192.168.1.1", 502); // 创建一个Modbus TCP主站 ModbusIpMaster modbusMaster = ModbusIpMaster.CreateIp(tcpClient); // 设置串口参数 modbusMaster.Transport.Retries = 3; modbusMaster.Transport.ReadTimeout = 1000; modbusMaster.Transport.WriteTimeout = 1000; // 读取线圈数据 bool[] coils = modbusMaster.ReadCoils(0, 10); // 打印结果 for (int i = 0; i < coils.Length; i++) { Console.WriteLine($"Coil {i}: {coils[i]}"); } // 关闭TCP连接 tcpClient.Close(); } } ``` 在这个示例中，我们首先创建了一个TCP客户端，并指定Modbus TCP服务器的IP地址和端口号。然后，我们使用ModbusIpMaster类创建了一个Modbus TCP主站。接下来，我们可以设置串口参数，例如重试次数和超时时间。最后，我们使用ReadCoils方法读取线圈数据，并打印结果。 请注意，这只是一个简单的示例，你可能需要根据你的具体需求进行更多的配置和操作。你可以根据NModbus库的文档进一步了解其它功能和用法。 [2][3]
评论 51
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值