Modbus TCP 和 RTU客户端
通过 TCP/IP 或 RS-232、RS-485 串行线路,从 Delphi、C++Builder 和 .NET 读写 PLC、电能表和驱动器的线圈与寄存器。
新增
通过 TCP/IP 或 RS-232、RS-485 串行线路,从 Delphi、C++Builder 和 .NET 读写 PLC、电能表和驱动器的线圈与寄存器。
新增
两个方法相同的客户端:一个连接到 Modbus TCP 设备或网关,另一个是串行线路上的 Modbus RTU 主站。
TsgcModbusTCPClientTsgcModbusRTUClient
Modbus Application Protocol V1.1b3、Modbus TCP 和 Modbus RTU
TCP:sgcWebSockets 的所有平台。RTU:Windows、Linux 和 macOS
包含在 sgcWebSockets Enterprise(Delphi 和 .NET)和 All-Access 或独立的 sgcIndustrial 软件包中
设置 Host 和 UnitId,将 Active 设为 True 并调用方法。每个请求都会阻塞,直到收到匹配的响应,当设备报告错误或没有应答时会抛出异常。
uses
sgcIndustrial;
procedure TForm1.ConnectClient;
begin
FClient := TsgcModbusTCPClient.Create(Self);
FClient.Host := '192.168.1.50';
FClient.Port := 502;
FClient.UnitId := 1;
FClient.Timeout := 1000;
FClient.Retries := 2;
FClient.OnConnect := OnModbusConnect;
FClient.OnError := OnModbusError;
FClient.Active := True;
end;
procedure TForm1.OnModbusConnect(Sender: TObject);
begin
Memo1.Lines.Add('Connected');
end;
procedure TForm1.ReadValues;
var
vRegisters: TsgcModbusRegisters;
vTemperature: Single;
begin
try
vRegisters := FClient.ReadHoldingRegisters(0, 10);
FClient.WriteSingleCoil(10, True);
// 32-bit float stored low word first by many PLCs
FClient.WordOrder := mwoCDAB;
vTemperature := FClient.ReadFloat32(300);
Memo1.Lines.Add(Format('HR0 = %d, temperature = %.1f',
[vRegisters[0], vTemperature]));
except
on E: EsgcModbusException do
Memo1.Lines.Add(Format('Device exception %d', [E.ExceptionCode]));
on E: EsgcModbusTimeout do
Memo1.Lines.Add('No response');
end;
end;
procedure TForm1.OnModbusError(Sender: TObject; const aError: string);
begin
Memo1.Lines.Add('Error: ' + aError);
end;
#include "sgcIndustrial.hpp"
void __fastcall TForm1::ConnectClient()
{
FClient = new TsgcModbusTCPClient(this);
FClient->Host = "192.168.1.50"; // Port is 502 by default
FClient->UnitId = 1;
FClient->Timeout = 1000;
FClient->Retries = 2;
FClient->OnConnect = OnModbusConnect;
FClient->OnError = OnModbusError;
FClient->Active = true;
}
void __fastcall TForm1::OnModbusConnect(TObject *Sender)
{
Memo1->Lines->Add("Connected");
}
void __fastcall TForm1::ReadValues()
{
try
{
TsgcModbusRegisters vRegisters = FClient->ReadHoldingRegisters(0, 10);
FClient->WriteSingleCoil(10, true);
// 32-bit float stored low word first by many PLCs
FClient->WordOrder = mwoCDAB;
float vTemperature = FClient->ReadFloat32(300);
Memo1->Lines->Add("HR0 = " + IntToStr(vRegisters[0]) + ", temperature = " +
FloatToStrF(vTemperature, ffFixed, 7, 1));
}
catch (EsgcModbusException &E)
{
Memo1->Lines->Add("Device exception " + IntToStr(E.ExceptionCode));
}
catch (EsgcModbusTimeout &E)
{
Memo1->Lines->Add("No response");
}
}
void __fastcall TForm1::OnModbusError(TObject *Sender, const String aError)
{
Memo1->Lines->Add("Error: " + aError);
}
using System;
using esegece.sgcWebSockets;
class PlcClient
{
TsgcModbusTCPClient FClient = new TsgcModbusTCPClient();
public void ConnectClient()
{
FClient.Host = "192.168.1.50";
FClient.Port = 502;
FClient.UnitId = 1;
FClient.Timeout = 1000;
FClient.Retries = 2;
FClient.OnConnect += OnModbusConnect;
FClient.OnError += OnModbusError;
FClient.Active = true;
}
void OnModbusConnect(object Sender, EventArgs e)
{
Console.WriteLine("Connected");
}
public void ReadValues()
{
try
{
ushort[] vRegisters = FClient.ReadHoldingRegisters(0, 10);
FClient.WriteSingleCoil(10, true);
// 32-bit float stored low word first by many PLCs
FClient.WordOrder = TsgcModbusWordOrder.mwoCDAB;
float vTemperature = FClient.ReadFloat32(300);
Console.WriteLine($"HR0 = {vRegisters[0]}, temperature = {vTemperature:F1}");
}
catch (EsgcModbusException E)
{
Console.WriteLine("Device exception " + E.ExceptionCode);
}
catch (EsgcModbusTimeout)
{
Console.WriteLine("No response");
}
}
void OnModbusError(object Sender, string aError)
{
Console.WriteLine("Error: " + aError);
}
}
Modbus 的帧结构、时序和错误处理均由组件完成,您的代码只需处理地址和数值。
01 至 06、15、16、22(掩码写入)、23(读/写多个寄存器)和 43/14(设备标识,支持分页)。RTU 客户端另外支持 07(读取异常状态)和 08(诊断)。
ReadInt32、ReadUInt32、ReadFloat32、ReadString 及其对应的写入方法,以及对输入寄存器的读取。WordOrder 可选择 ABCD、DCBA、BADC 或 CDAB 以匹配设备。
可从任何线程调用这些方法:请求会被串行化,每个响应都通过其事务 ID 进行匹配。Timeout 适用于每次尝试,Retries 则增加更多次尝试。
Modbus 异常应答会抛出带有异常码和功能码的 EsgcModbusException,无应答会抛出 EsgcModbusTimeout,其他所有问题都会抛出 EsgcModbusError。超出规范的数量会在发送任何数据之前被拒绝。
TCP 客户端支持 TLS、Proxy 和用于自动重连的 WatchDog。连接断开时正在等待的请求会立即抛出异常,无需等待超时。
每个方法都有一个带前置单元 ID 的重载,因此一个 TCP 连接即可访问 Modbus TCP 到 RTU 网关后面的所有设备,而无需更改 UnitId。
打开一个 TsgcSerialPort,通过 SerialPort 将其关联,并在 UnitId 中设置从站地址。客户端会构建带 CRC16 的 RTU 帧并等待从站应答。
procedure TForm1.ReadSlave;
var
vRegisters: TsgcModbusRegisters;
begin
FPort := TsgcSerialPort.Create(Self);
FPort.Port := 'COM4';
FPort.BaudRate := 19200;
FPort.Parity := spEven;
FPort.Open;
FRTU := TsgcModbusRTUClient.Create(Self);
FRTU.SerialPort := FPort;
FRTU.UnitId := 17;
FRTU.Timeout := 500;
FRTU.Retries := 2;
vRegisters := FRTU.ReadHoldingRegisters(107, 3);
Memo1.Lines.Add(Format('Register 107 = %d', [vRegisters[0]]));
// unit id 0 = broadcast: every slave executes the write, none answers
FRTU.WriteSingleRegister(0, 1, 100);
end;
void __fastcall TForm1::ReadSlave()
{
FPort = new TsgcSerialPort(this);
FPort->Port = "COM4";
FPort->BaudRate = 19200;
FPort->Parity = spEven;
FPort->Open();
FRTU = new TsgcModbusRTUClient(this);
FRTU->SerialPort = FPort;
FRTU->UnitId = 17;
FRTU->Timeout = 500;
FRTU->Retries = 2;
TsgcModbusRegisters vRegisters = FRTU->ReadHoldingRegisters(107, 3);
Memo1->Lines->Add("Register 107 = " + IntToStr(vRegisters[0]));
// unit id 0 = broadcast: every slave executes the write, none answers
FRTU->WriteSingleRegister(0, 1, 100);
}
using System;
using esegece.sgcWebSockets;
class RtuMaster
{
TsgcSerialPort FPort = new TsgcSerialPort();
TsgcModbusRTUClient FRTU = new TsgcModbusRTUClient();
public void ReadSlave()
{
FPort.Port = "COM4";
FPort.BaudRate = 19200;
FPort.Parity = TsgcSerialParity.spEven;
FPort.Open();
FRTU.SerialPort = FPort;
FRTU.UnitId = 17;
FRTU.Timeout = 500;
FRTU.Retries = 2;
ushort[] vRegisters = FRTU.ReadHoldingRegisters(107, 3);
Console.WriteLine("Register 107 = " + vRegisters[0]);
// unit id 0 = broadcast: every slave executes the write, none answers
FRTU.WriteSingleRegister(0, 1, 100);
}
}
TurnaroundDelay
这些方法使用从 0 开始的协议地址。许多手册中记录为 40001 的寄存器就是保持寄存器 0,因此请调用 ReadHoldingRegisters(0, 1)。
使用其两个寄存器中第一个寄存器的地址调用 ReadFloat32。如果数值看起来不对,说明设备以另一种顺序存储字节:请将 WordOrder 设置为设备使用的顺序。许多 PLC 先存储低位字,即 mwoCDAB。
每次尝试等待 Timeout 毫秒。在 Retries + 1 次尝试仍无有效应答后,请求会抛出 EsgcModbusTimeout,消息中包含功能码、单元 ID 和尝试次数。
不会。请自行打开 TsgcSerialPort,并保持其 OnData 事件为空,因为客户端通过 Read 读取应答。当端口未分配、未打开或已分配 OnData 时,请求会抛出 EsgcModbusError。
它作为 sgcIndustrial 包的一部分,包含在 sgcWebSockets Enterprise(Delphi 和 .NET)和 All-Access 中。在 Delphi 中,请将 sgcIndustrial 添加到 uses 子句。
直达组件参考,打开演示项目并阅读技术文档。
| Online Help: TsgcModbusTCPClient Modbus TCP 客户端的完整属性、方法和事件参考。 | 打开 | |
| Online Help: TsgcModbusRTUClient Modbus RTU 客户端的完整属性、方法和事件参考。 | 打开 | |
| 演示项目:Industrial\02.Modbus_TCP_Client 适用于 Delphi、C++Builder 和 .NET 的 Modbus TCP 客户端。随 sgcWebSockets 软件包一同提供。 | 打开 | |
| 技术文档 (PDF) 仅针对此组件的功能、快速入门、代码示例和一手资料参考。 | 打开 | |
| 用户手册 (PDF) 涵盖库中每个组件的综合手册。 | 打开 |