using NModbus;
using System;
using System.Net.Sockets;
namespace MvvmScaffoldFrame48.DLL.CommunicationTools
{
public class ModbusTcpClient
{
#region 实例
private TcpClient _tcpClient;
private IModbusMaster _modbusMaster;
#endregion
#region 连接方法
///
/// 判断 TCP 连接是否已断开
///
///
public bool IsTcpClientConnected()
{
if (_tcpClient == null || _tcpClient.Client == null)
return false;
try
{
Socket socket = _tcpClient.Client;
bool isReadable = socket.Poll(0, SelectMode.SelectRead);
bool hasNoData = (socket.Available == 0);
// 可读且无数据 = 连接已断开
return !(isReadable && hasNoData);
}
catch (SocketException) { return false; }
catch (ObjectDisposedException) { return false; }
}
///
/// 连接 Modbus TCP 服务器
///
///
///
///
public bool Connect(string ipAddress, int port = 502)
{
try
{
_tcpClient = new TcpClient(ipAddress, port)
{
SendTimeout = 2000,
ReceiveTimeout = 2000
};
// 使用 ModbusFactory 创建 Master(新版本 API)
var factory = new ModbusFactory();
_modbusMaster = factory.CreateMaster(_tcpClient);
return true;
}
catch (Exception ex)
{
Console.WriteLine($"连接失败: {ex.Message}");
return false;
}
}
///
/// 断开连接
///
public void Disconnect()
{
_modbusMaster?.Dispose();
_tcpClient?.Close();
}
#endregion
#region 读取方法
///
/// 读取线圈(功能码01)
///
///
/// 读取开始地址
/// 读取长度
/// 读取的的结果
///
///
public bool ReadCoilsRegister(byte slaveId, ushort startAddress, ushort numRegisters,out bool[] ReturnValue)
{
bool Result = false;
ReturnValue = null;
if (_modbusMaster == null)
{
Console.WriteLine($"ModbusTcpClient-ReadCoilsRegister failed:未连接到服务器");
return false;
}
try
{
ReturnValue = _modbusMaster.ReadCoils(slaveId, startAddress, numRegisters);
Result = true;
}
catch (Exception ex)
{
Console.WriteLine($"读取线圈失败,ModbusTcpClient-ReadCoilsRegister failed: {ex.Message}");
Result = false;
}
return Result;
}
///
/// 读取保持寄存器(功能码03)
///
///
///
///
///
///
public bool ReadHoldingRegisters(byte slaveId, ushort startAddress, ushort numRegisters,out ushort[] ReturnValue)
{
bool Result = false;
ReturnValue = null;
if (_modbusMaster == null)
{
Console.WriteLine($"ModbusTcpClient-ReadHoldingRegistersAsReal failed:未连接到服务器");
return false;
}
try
{
ReturnValue = _modbusMaster.ReadHoldingRegisters(slaveId, startAddress, numRegisters);
}
catch (Exception ex)
{
Console.WriteLine($"读取保持寄存器失败,ModbusTcpClient-ReadHoldingRegisters failed: {ex.Message}");
Result = false;
}
return Result;
}
///
/// 读取保持寄存器中的REAL值(功能码03)
///
/// 从站ID
/// 起始地址
/// REAL值的数量
/// 字节序 (ABCD, CDAB, BADC, DCBA)
/// REAL值数组
public bool ReadHoldingRegistersAsReal(byte slaveId, ushort startAddress, ushort count, out float[] ReturnValue,string byteOrder = "BADC")
{
bool Result = false;
ReturnValue = null;
if (_modbusMaster == null)
{
Console.WriteLine($"ModbusTcpClient-ReadHoldingRegistersAsReal failed:未连接到服务器");
return false;
}
try
{
// 每个REAL值占用2个寄存器
ushort[] registers = _modbusMaster.ReadHoldingRegisters(slaveId, startAddress, (ushort)(count * 2));
float[] realValues = new float[count];
for (int i = 0; i < count; i++)
{
ushort highRegister = registers[i * 2];
ushort lowRegister = registers[i * 2 + 1];
byte[] bytes = ConvertToByteArray(lowRegister, highRegister, byteOrder);
realValues[i] = BitConverter.ToSingle(bytes, 0);
}
ReturnValue = realValues;
Result = true;
}
catch (Exception ex)
{
Console.WriteLine($"读取REAL值失败,ModbusTcpClient-ReadHoldingRegistersAsReal failed:{ex.Message}");
Result = false;
}
return Result;
}
///
/// 读取保持寄存器中的Int32值(功能码03)
///
/// 从站ID
/// 起始地址
/// REAL值的数量
/// REAL值数组
public bool ReadHoldingRegistersAsInt32(byte slaveId, ushort startAddress, ushort count,out UInt32[] ReturnValue, string byteOrder = "BADC")
{
bool Result = false;
ReturnValue = null;
if (_modbusMaster == null)
{
Console.WriteLine($"ModbusTcpClient-ReadHoldingRegistersAsInt32 failed:未连接到服务器");
return false;
}
try
{
// 每个REAL值占用2个寄存器
ushort[] registers = _modbusMaster.ReadHoldingRegisters(slaveId, startAddress, (ushort)(count * 2));
UInt32[] realValues = new UInt32[count];
for (int i = 0; i < count; i++)
{
// 获取两个连续的寄存器值
ushort highRegister = registers[i * 2];
ushort lowRegister = registers[i * 2 + 1];
byte[] bytes = ConvertToByteArray(lowRegister, highRegister, byteOrder);
// 转换为float
realValues[i] = (UInt32)BitConverter.ToInt32(bytes, 0);
}
ReturnValue = realValues;
Result = true;
}
catch (Exception ex)
{
Console.WriteLine($"读取Int32值失败: {ex.Message}");
Result= false;
}
return Result;
}
#endregion
#region 写入方法
///
/// 写入线圈(功能码05)
///
/// Slave编号
/// 写入地址
/// 写入值
///
public bool WriteCoilsRegister(byte slaveId, ushort CoilsAddress, bool values)
{
bool result = false;
if (_modbusMaster == null)
{
Console.WriteLine($"ModbusTcpClient-WriteCoilsRegister failed:未连接到服务器");
result = false;
}
try
{
_modbusMaster.WriteSingleCoil(slaveId, CoilsAddress, values);
result = true;
}
catch (Exception ex)
{
Console.WriteLine($"ModbusTcpClient-WriteCoilsRegister-WriteCoilsRegister failed:{ex.Message}");
result = false;
}
return result;
}
///
/// 写入单个寄存器(功能码06)
///
///
///
///
///
public bool WriteSingleRegister(byte slaveId, ushort registerAddress, ushort value)
{
bool result = false;
if (_modbusMaster == null)
{
Console.WriteLine($"ModbusTcpClient-WriteSingleRegister failed:未连接到服务器");
result = false;
return result;
}
try
{
_modbusMaster.WriteSingleRegister(slaveId, registerAddress, value);
result = true;
}
catch (Exception ex)
{
Console.WriteLine($"写入单个寄存器失败,ModbusTcpClient-WriteSingleRegister failed:{ex.Message}");
result = false;
}
return result;
}
///
/// 写入多个寄存器(功能码16)
///
///
///
///
///
public bool WriteMultipleRegisters(byte slaveId, ushort startAddress, ushort[] values)
{
bool result = false;
if (_modbusMaster == null)
{
Console.WriteLine($"ModbusTcpClient-WriteMultipleRegisters failed:未连接到服务器");
return false;
}
try
{
_modbusMaster.WriteMultipleRegisters(slaveId, startAddress, values);
result = true;
}
catch (Exception ex)
{
Console.WriteLine($"写入多个寄存器失败,ModbusTcpClient-WriteMultipleRegisters failed:{ex.Message}");
result = false;
}
return result;
}
///
/// 写入单个REAL值到保持寄存器(功能码16)
///
/// 从站ID
/// 起始地址
/// REAL值
/// 字节序 (ABCD, CDAB, BADC, DCBA)
public bool WriteSingleReal(byte slaveId, ushort startAddress, float value, string byteOrder = "BADC")
{
bool result = false;
if (_modbusMaster == null)
{
Console.WriteLine($"ModbusTcpClient-WriteSingleReal failed:未连接到服务器");
return false;
}
try
{
// 将float转换为字节数组
byte[] bytes = BitConverter.GetBytes(value);
// 根据字节序重新排列字节
ushort[] registers = ConvertBytesToRegisters(bytes, byteOrder);
// 写入连续的寄存器
result = WriteMultipleRegisters(slaveId, startAddress, registers);
}
catch (Exception ex)
{
Console.WriteLine($"写入REAL值失败,ModbusTcpClient-WriteSingleReal failed:{ex.Message}");
result = false;
}
return result;
}
///
/// 写入多个REAL值到保持寄存器(功能码16)
///
/// 从站ID
/// 起始地址
/// REAL值数组
/// 字节序 (ABCD, CDAB, BADC, DCBA)
public bool WriteMultipleReals(byte slaveId, ushort startAddress, float[] values, string byteOrder = "BADC")
{
bool result = false;
if (_modbusMaster == null)
{
Console.WriteLine($"ModbusTcpClient-WriteMultipleReals failed:未连接到服务器");
return false;
}
if (values == null || values.Length == 0)
{
Console.WriteLine("写入多个REAL值到保持寄存器-值数组不能为空", 0);
return false;
}
try
{
// 每个REAL值需要2个寄存器,所以总寄存器数是REAL值数量的2倍
ushort[] registers = new ushort[values.Length * 2];
for (int i = 0; i < values.Length; i++)
{
// 将每个float转换为字节数组
byte[] bytes = BitConverter.GetBytes(values[i]);
// 根据字节序转换为寄存器值
ushort[] regPair = ConvertBytesToRegisters(bytes, byteOrder);
// 将寄存器值放入数组
registers[i * 2] = regPair[0];
registers[i * 2 + 1] = regPair[1];
}
// 写入所有寄存器
_modbusMaster.WriteMultipleRegisters(slaveId, startAddress, registers);
result = true;
}
catch (Exception ex)
{
Console.WriteLine($"写入多个REAL值失败: {ex.Message}");
result = false;
}
return result;
}
///
/// 写入单个Int32值到保持寄存器(功能码16)
///
/// 从站ID
/// 起始地址
/// REAL值
/// 字节序 (ABCD, CDAB, BADC, DCBA)
public bool WriteSingleInt32(byte slaveId, ushort startAddress, UInt32 value, string byteOrder = "BADC")
{
// 将32位整数拆分为两个16位寄存器值
byte[] bytes = BitConverter.GetBytes(value);
ushort[] registers = new ushort[2];
ushort[] regPair = ConvertBytesToRegisters(bytes, byteOrder);
// 将寄存器值放入数组
registers[0] = regPair[0];
registers[1] = regPair[1];
return WriteMultipleRegisters(slaveId, startAddress, registers);
}
#endregion
#region 辅助方法
///
/// 将寄存器数组换为字节数组转(根据指定字节序)
///
/// 低位寄存器
/// 高位寄存器
/// 字节序
/// 字节数组
private byte[] ConvertToByteArray(ushort lowRegister, ushort highRegister, string byteOrder)
{
byte[] bytes = new byte[4];
switch (byteOrder.ToUpper())
{
case "ABCD": // 大端序
bytes[0] = (byte)(highRegister >> 8);
bytes[1] = (byte)(highRegister & 0xFF);
bytes[2] = (byte)(lowRegister >> 8);
bytes[3] = (byte)(lowRegister & 0xFF);
break;
case "CDAB": // 小端序
bytes[0] = (byte)(lowRegister >> 8);
bytes[1] = (byte)(lowRegister & 0xFF);
bytes[2] = (byte)(highRegister >> 8);
bytes[3] = (byte)(highRegister & 0xFF);
break;
case "BADC":
bytes[0] = (byte)(highRegister & 0xFF);
bytes[1] = (byte)(highRegister >> 8);
bytes[2] = (byte)(lowRegister & 0xFF);
bytes[3] = (byte)(lowRegister >> 8);
break;
case "DCBA":
bytes[0] = (byte)(lowRegister & 0xFF);
bytes[1] = (byte)(lowRegister >> 8);
bytes[2] = (byte)(highRegister & 0xFF);
bytes[3] = (byte)(highRegister >> 8);
break;
default:
// 默认使用ABCD顺序
bytes[0] = (byte)(highRegister >> 8);
bytes[1] = (byte)(highRegister & 0xFF);
bytes[2] = (byte)(lowRegister >> 8);
bytes[3] = (byte)(lowRegister & 0xFF);
break;
}
return bytes;
}
///
/// 将字节数组转换为寄存器数组(根据指定字节序)
///
/// 字节数组(4字节)
/// 字节序
/// 寄存器数组(2个ushort)
private ushort[] ConvertBytesToRegisters(byte[] bytes, string byteOrder)
{
if (bytes.Length != 4)
throw new ArgumentException("字节数组必须包含4个字节用于REAL值转换");
ushort[] registers = new ushort[2];
switch (byteOrder.ToUpper())
{
case "ABCD": // 大端序
registers[0] = (ushort)((bytes[0] << 8) | bytes[1]); // 高位寄存器
registers[1] = (ushort)((bytes[2] << 8) | bytes[3]); // 低位寄存器
break;
case "CDAB": // 小端序
registers[0] = (ushort)((bytes[2] << 8) | bytes[3]); // 高位寄存器
registers[1] = (ushort)((bytes[0] << 8) | bytes[1]); // 低位寄存器
break;
case "BADC":
registers[0] = (ushort)((bytes[1] << 8) | bytes[0]); // 高位寄存器
registers[1] = (ushort)((bytes[3] << 8) | bytes[2]); // 低位寄存器
break;
case "DCBA":
registers[0] = (ushort)((bytes[3] << 8) | bytes[2]); // 高位寄存器
registers[1] = (ushort)((bytes[1] << 8) | bytes[0]); // 低位寄存器
break;
default:
// 默认使用ABCD顺序
registers[0] = (ushort)((bytes[0] << 8) | bytes[1]);
registers[1] = (ushort)((bytes[2] << 8) | bytes[3]);
break;
}
return registers;
}
#endregion
}
}