使用nmodbus4类库实现Modbus协议读写操作指南

一、安装nmodbus4类库

在使用nmodbus4类库之前，我们首先需要安装它，并将其引入我们的项目中。

下面是一个使用Visual Studio进行开发的示例：

//使用NuGet包安装nmodbus4类库
Install-Package Modbus -Version 4.3.0

//引入命名空间
using Modbus.Data;
using Modbus.Device;
using System.Net.Sockets;

二、创建Modbus主站

在我们的C#代码中，需要通过TCP网络与从机建立连接，这些工作要由主站负责。首先，我们需要创建主站实例。

//创建TCP客户端
TcpClient client = new TcpClient(host, port);
//创建主站
ModbusIpMaster master = ModbusIpMaster.CreateIp(client);

准备好主站实例之后，我们就可以使用它来发送读写请求。

三、发送读写请求

1. 读取线圈状态（读取线圈开关量）

读取线圈状态是指读取从机设备的线圈开关量。在Modbus协议中，线圈的地址从0开始编号，长度则以位（b）为单位。

//输入参数：起始地址、长度
//返回值：线圈状态
bool[] coilStatus = master.ReadCoils(startingAddress, length);

2. 读取离散输入状态（读取位开关量）

与读取线圈状态类似，读取离散输入状态指的是读取从机设备的位开关量。

//输入参数：起始地址、长度
//返回值：离散输入状态
bool[] discreteInputs = master.ReadInputs(startingAddress, length);

3. 读取保持寄存器（读取16位无符号整数）

读取保持寄存器指的是读取从机设备的16位无符号整数。

//输入参数：起始地址、长度
//返回值：16位无符号整数
ushort[] holdingRegisters = master.ReadHoldingRegisters(startingAddress, length);

4. 读取输入寄存器（读取16位无符号整数）

读取输入寄存器指的是读取从机设备的16位无符号整数。

//输入参数：起始地址、长度
//返回值：16位无符号整数
ushort[] inputRegisters = master.ReadInputRegisters(startingAddress, length);

5. 写入单个线圈（写入单个位开关量）

写入单个线圈指的是向从机设备写入单个位开关量。

//输入参数：操作地址、开关量
//返回值：无
master.WriteSingleCoil(writeAddress, value);

6. 写入多个线圈（写入多个位开关量）

写入多个线圈指的是向从机设备写入多个位开关量。

//输入参数：起始地址、开关量数组
//返回值：无
master.WriteMultipleCoils(startingAddress, values);

7. 写入单个保持寄存器（写入16位无符号整数）

写入单个保持寄存器指的是向从机设备写入单个16位无符号整数。

//输入参数：操作地址、16位无符号整数
//返回值：无
master.WriteSingleRegister(writeAddress, value);

8. 写入多个保持寄存器（写入多个16位无符号整数）

写入多个保持寄存器指的是向从机设备写入多个16位无符号整数。

//输入参数：起始地址、16位无符号整数数组
//返回值：无
master.WriteMultipleRegisters(startingAddress, values);

四、总结

本文介绍了使用nmodbus4类库实现Modbus协议读写操作的指南，分别从安装nmodbus4类库、创建Modbus主站和发送读写请求三个方面进行了阐述，具体涉及读取线圈状态、离散输入状态、保持寄存器、输入寄存器和写入操作。希望能够对使用Modbus协议的开发人员提供帮助。