新增

Delphi Modbus TCP 和 RTU:客户端与服务器组件

适用于 Delphi 和 C++Builder 的原生 Modbus TCP 和 Modbus RTU 组件。轮询 PLC、驱动器、电能表和网关,或将您自己的数据作为 Modbus 服务器发布,并提供任意字序的类型化 Float32、Int32 和字符串辅助方法。

包含在 sgcWebSockets Enterprise(Delphi 和 .NET)和 All-Access 或独立的 sgcIndustrial 软件包中。

两个客户端,两个服务器,一套 Modbus API

Modbus TCP 和 Modbus RTU 主站与从站,以非可视组件的形式提供,使用 Pascal 编写并编译进您的应用程序。

Delphi Modbus 库让 VCL、FMX、服务或控制台应用程序能够与每个工厂车间里的设备通信:PLC、变频器、电能表、温度控制器和协议网关。sgcWebSockets 提供四个组件:TsgcModbusTCPClient 和 TsgcModbusRTUClient 用于轮询设备,TsgcModbusTCPServer 和 TsgcModbusRTUServer 则向 SCADA 系统、HMI 和任何其他 Modbus 主站公开您自己的数据。

两个客户端都继承自 TsgcModbusClient_Base,因此通过以太网读取寄存器的代码同样可以通过 RS-485 读取:您只需更换组件,无需更改调用。每次调用都会阻塞,直到应答到达或 Timeout 到期,以 Delphi 数组返回数值,并在设备报告错误时抛出类型化异常。只需一行 uses sgcIndustrial; 即可引入所有类。

组件类

TsgcModbusTCPClient, TsgcModbusRTUClient, TsgcModbusTCPServer, TsgcModbusRTUServer, TsgcModbusDataModel

传输

端口 502 上的 Modbus TCP,支持可选的 TLS 和代理;通过 TsgcSerialPort 在 RS-232 和 RS-485 上运行 Modbus RTU

功能码

01 至 08、15、16、22、23 和 43/14(读取设备标识)

平台

Delphi 7 至 Delphi 13 和 C++Builder;Windows、Linux 和 macOS

每个常用的 Modbus 功能,各对应一个方法

客户端会在发送任何数据之前根据规范检查数量;服务器会应答此表中的每个功能码。

FC功能客户端方法
01Read CoilsReadCoils
02Read Discrete InputsReadDiscreteInputs
03Read Holding RegistersReadHoldingRegisters, ReadInt32, ReadUInt32, ReadFloat32, ReadString
04Read Input RegistersReadInputRegisters, ReadInputInt32, ReadInputUInt32, ReadInputFloat32
05Write Single CoilWriteSingleCoil
06Write Single RegisterWriteSingleRegister
07Read Exception Status(串行线路)RTU 客户端上的 ReadExceptionStatus
08Diagnostics(串行线路)RTU 客户端上的 Diagnostics
15Write Multiple CoilsWriteMultipleCoils
16Write Multiple RegistersWriteMultipleRegisters, WriteInt32, WriteUInt32, WriteFloat32, WriteString
22Mask Write RegisterMaskWriteRegister
23Read/Write Multiple RegistersReadWriteMultipleRegisters
43/14Read Device IdentificationReadDeviceIdentification(基本、常规、扩展和单个对象)

用几行 Delphi 代码读取 PLC

创建组件,设置地址,调用方法。本页上的每个示例都可在 Delphi 7 和 Delphi 13 中编译。

uses
  sgcIndustrial;

procedure TForm1.FormCreate(Sender: TObject);
begin
  Modbus := TsgcModbusTCPClient.Create(Self);
  Modbus.Host := '192.168.1.50';
  Modbus.Port := 502;
  Modbus.UnitId := 1;
  Modbus.Timeout := 2000;          // ms per attempt
  Modbus.Retries := 2;             // extra attempts after a timeout
  Modbus.WatchDog.Enabled := True; // reconnect after a network drop
  Modbus.OnConnect := ModbusConnect;
  Modbus.OnError := ModbusError;
  Modbus.Active := True;
end;

procedure TForm1.ModbusConnect(Sender: TObject);
begin
  Memo1.Lines.Add('connected');
end;

procedure TForm1.ModbusError(Sender: TObject; const aError: string);
begin
  Memo1.Lines.Add('error: ' + aError);
end;

procedure TForm1.btnReadClick(Sender: TObject);
var
  vRegisters: TsgcModbusRegisters;
  vCoils: TsgcModbusBits;
  i: Integer;
begin
  vRegisters := Modbus.ReadHoldingRegisters(0, 10); // FC 03
  for i := 0 to Length(vRegisters) - 1 do
    Memo1.Lines.Add(Format('HR%d = %d', [i, vRegisters[i]]));

  vCoils := Modbus.ReadCoils(0, 8);                 // FC 01
  if vCoils[0] then
    Memo1.Lines.Add('coil 0 is on');

  Modbus.WriteSingleRegister(100, 1234);            // FC 06
  Modbus.WriteSingleCoil(5, True);                  // FC 05
end;
procedure TForm1.btnTypedClick(Sender: TObject);
var
  vTemperature: Single;
  vCounter: Integer;
  vName: TsgcModbusAnsiString;
begin
  Modbus.WordOrder := mwoCDAB;              // low word first
  vTemperature := Modbus.ReadFloat32(200);  // 2 holding registers
  vCounter := Modbus.ReadInt32(202);
  vName := Modbus.ReadString(300, 8);       // 8 registers, 16 characters
  Memo1.Lines.Add(Format('%s: %.1f C, %d cycles',
    [string(vName), vTemperature, vCounter]));

  Modbus.WriteFloat32(210, 21.5);
  Modbus.WriteUInt32(212, 3000000000);

  // explicit unit id, for a gateway with several devices behind it
  Memo1.Lines.Add(FloatToStr(Modbus.ReadInputFloat32(7, 0))); // unit 7, FC 04

  try
    Modbus.ReadHoldingRegisters(9000, 4);
  except
    on E: EsgcModbusException do // the device answered with an exception
      Memo1.Lines.Add(Format('exception %d, function %d',
        [E.ExceptionCode, E.FunctionCode]));
    on E: EsgcModbusTimeout do   // no answer after Retries + 1 attempts
      Memo1.Lines.Add(E.Message);
  end;
end;
procedure TForm1.FormCreate(Sender: TObject);
begin
  Serial := TsgcSerialPort.Create(Self);
  Serial.Port := 'COM3';          // '/dev/ttyUSB0' on Linux
  Serial.BaudRate := 19200;
  Serial.Parity := spEven;        // 8E1, the Modbus RTU default
  Serial.RtsControl := srcToggle; // RS-485: RTS switches the transmitter
  Serial.Active := True;

  RTU := TsgcModbusRTUClient.Create(Self);
  RTU.SerialPort := Serial;
  RTU.UnitId := 17;               // slave address
  RTU.Timeout := 500;
  RTU.Retries := 1;
end;

procedure TForm1.btnPollClick(Sender: TObject);
var
  vValues: TsgcModbusRegisters;
begin
  vValues := RTU.ReadInputRegisters(0, 4);                      // FC 04
  Memo1.Lines.Add(Format('IR0 = %d', [vValues[0]]));
  Memo1.Lines.Add(Format('status = %d', [RTU.ReadExceptionStatus])); // FC 07
  RTU.WriteSingleRegister(0, 10, 500); // unit 0: broadcast to every slave, no reply
end;
procedure TForm1.FormCreate(Sender: TObject);
begin
  Server := TsgcModbusTCPServer.Create(Self);
  Server.Port := 502;
  Server.UnitId := 0;                          // answer every unit id
  Server.DataModel.HoldingRegisterCount := 1000;
  Server.DataModel.SetHoldingRegister(0, 42);
  Server.DataModel.SetCoil(0, True);
  Server.DataModel.VendorName := 'My Company'; // FC 43/14 identification
  Server.DataModel.ProductCode := 'GW-100';
  Server.OnReadRequest := ServerReadRequest;
  Server.OnWriteRequest := ServerWriteRequest;
  Server.Active := True;
end;

// runs in the connection thread, before the table is read
procedure TForm1.ServerReadRequest(Sender: TObject; aUnitId, aFunctionCode: Byte;
  aAddress, aCount: Word; var aExceptionCode: Byte);
begin
  if aFunctionCode = CS_MODBUS_FC_READ_INPUT_REGISTERS then
    Server.DataModel.SetInputRegister(0, Random(1000)); // fresh value
end;

// registers 0..9 are read only
procedure TForm1.ServerWriteRequest(Sender: TObject; aUnitId, aFunctionCode: Byte;
  aAddress, aCount: Word; var aBits: TsgcModbusBits;
  var aRegisters: TsgcModbusRegisters; var aExceptionCode: Byte);
begin
  if (Length(aRegisters) > 0) and (aAddress < 10) then
    aExceptionCode := CS_MODBUS_EX_ILLEGAL_DATA_ADDRESS;
end;

可从任何线程调用的 Modbus 主站

在 TCP 和串行线路上提供阻塞调用、类型化数值和清晰的错误。

类型化的 32 位数值和字符串

ReadFloat32、ReadInt32、ReadUInt32 及其写入和输入寄存器对应方法会将两个寄存器合并为一个数值。WordOrder 涵盖设备使用的四种布局:mwoABCD(大端,Modbus 默认)、mwoCDAB、mwoBADC 和 mwoDCBA。ReadString 和 WriteString 每个寄存器打包两个字符。

线程安全的阻塞调用

每个客户端同一时间只运行一个请求,由覆盖其所有重试的锁保护,因此多个线程可以共享一个连接。在 TCP 上,应答由接收线程匹配,因此从主线程调用不会死锁。

超时和重试

Timeout 是每次尝试的等待时间,Retries 是额外的尝试次数。TCP 重试使用新的事务 ID,迟到或重复的应答会被丢弃,而不会被误认为是下一个应答。

类型化异常

EsgcModbusException 携带设备的 ExceptionCode 和 FunctionCode,EsgcModbusTimeout 报告缺少应答,EsgcModbusError 涵盖其他所有情况,从连接关闭到 CRC 错误的 RTU 帧。

每次调用指定单元 ID

每个方法还有一个带前置单元 ID 的重载,因此到网关的一个连接即可访问其后的所有设备。不带该参数的调用默认使用 UnitId。

TCP 上的 TLS、代理和重连

TLS 和 TLSOptions 将 Modbus TCP 流包装在 TLS 中,Proxy 通过 HTTP 或 SOCKS 代理访问设备,WatchDog 在网络中断后重连。这三者都来自该组件所基于的 sgcWebSockets TCP 客户端。

正确的 RTU 帧处理

RTU 客户端在发送之前等待 3.5 个字符的静默,按预期长度读取应答(USB 适配器会分批传送字节),检查每个帧的 CRC,并忽略来自其他从站地址的帧。

RS-485 和广播

在串口上设置 RtsControl := srcToggle,RTS 就会在每次写入时切换 RS-485 发送器,在 Windows 上通过驱动程序,在 Linux 上通过内核 RS-485 模式。单元 ID 0 会向每个从站发送广播写入,并等待 TurnaroundDelay 而不是应答。

按需处理事件

OnConnect、OnDisconnect 和 OnError 通过 NotifyEvents 分发:默认排入主线程队列,也可同步,或直接在接收线程中触发。

带实时数据模型的 Modbus TCP 和 RTU 服务器

将 Delphi 应用程序变成 Modbus 从站:公开数据库或 REST API 数值的网关、用于测试 HMI 画面的设备模拟器,或您自己控制器的 Modbus 接口。每个服务器都拥有一个 TsgcModbusDataModel,包含四个 Modbus 表(线圈、离散输入、保持寄存器和输入寄存器,默认各 10,000 项,最多 65,536 项)、在 FC 43/14 上应答的设备标识字符串,以及在 FC 07 上应答的异常状态。

数据模型是线程安全的:一把锁保护所有表,因此您的代码可以在客户端读取时更新数值。两个钩子将您的代码置于请求路径中。OnReadRequest 在读取表之前运行,因此可以即时刷新数值,或以异常码拒绝请求。OnWriteRequest 在数值存储之前接收它们,因此可以验证、更改或拒绝写入,并使表保持不变。

TsgcModbusTCPServer

支持多个并发连接,每个连接都有自己的线程。同时到达同一数据包的请求按顺序应答,拆分到多个数据包的请求会被重新组装,格式错误的报头会关闭该连接并触发 OnError。UnitId = 0 应答任何单元 ID,其他值则只应答该 ID。Bindings 选择接口和端口,OnClientConnect 和 OnClientDisconnect 报告对端。

TsgcModbusRTUServer

作为从站 UnitId(1 至 247)在 TsgcSerialPort 上监听。它按预期长度和 3.5 个字符的静默为请求分帧,忽略 CRC 错误或其他地址的帧,并按串行线路规范的要求,执行来自单元 ID 0 的广播写入而不应答。

连接线程中的钩子

服务器事件在连接线程 (TCP) 或帧线程 (RTU) 中运行,并同步返回结果。请保持它们简短,并可放心调用数据模型方法:钩子运行时不持有任何锁。

已针对独立的 Modbus 协议栈进行测试

Modbus 客户端和服务器已在线路上针对 pymodbus(一个独立的开源实现)进行测试,使用 Modbus TCP:功能码 01 至 06、15、16、22、23 和 43/14、异常应答、Float32 数值和设备标识。类型化辅助方法已在四种字序下对照已知字节向量进行检查。Delphi 组件还针对 sgcWebSockets .NET Modbus 组件进行了双向测试,即客户端对服务器,每个方向 35 项检查全部通过。

串口已在 Windows 上的真实 COM 端口和 Linux 上的伪终端上进行测试,包括在读取等待期间关闭端口。Modbus RTU 客户端和服务器已针对模拟的从站和主站进行测试:拆分帧、CRC 错误、其他从站地址和广播。相同的代码可在 macOS 上编译。

Delphi Modbus 常见问题

创建 TsgcModbusTCPClient,设置 Host、Port(默认 502)和 UnitId,设置 Active := True 并调用 ReadHoldingRegisters(Address, Count)。它会返回 TsgcModbusRegisters 数组,每个寄存器对应一个 Word。地址从零开始,与它们在线路上传输的方式一致。

使用两个寄存器中第一个寄存器的地址调用 ReadFloat32、ReadInt32 或 ReadUInt32,输入寄存器则使用 ReadInput... 变体。如果数值看起来不对,说明设备使用了另一种字序:请将 WordOrder 设置为 mwoCDAB、mwoBADC 或 mwoDCBA,而不是默认的 mwoABCD。

可以。在适配器上打开 TsgcSerialPort,并将其分配给 TsgcModbusRTUClient 或 TsgcModbusRTUServer 的 SerialPort 属性。带自动方向控制的适配器无需其他设置。对于通过 RTS 切换发送器的适配器,请设置 RtsControl := srcToggle:Windows 使用驱动程序的 RTS 切换模式,Linux 使用内核 RS-485 模式。

可以。客户端一次只运行一个事务,并在整个请求(包括重试)期间持有一把锁,因此来自多个线程的调用会排队,每个调用都会得到自己的应答。从主线程调用不会死锁:在 TCP 上,应答由单独的线程接收。

放置一个 TsgcModbusTCPServer(或带串口的 TsgcModbusRTUServer),使用 SetHoldingRegister、SetCoil 和其他设置方法填充其 DataModel,然后设置 Active := True。使用 OnReadRequest 和 OnWriteRequest 按需计算数值,或以 Modbus 异常码拒绝写入。

Delphi 7 至 Delphi 13 和 C++Builder,支持 Windows(32 位和 64 位)、Linux 64 位和 macOS。串口以及基于它的 Modbus RTU 不适用于 Android 和 iOS。

Modbus 和串口组件包含在 sgcWebSockets Enterprise(Delphi 和 .NET)和 All-Access 或独立的 sgcIndustrial 软件包中。

sgcWebSockets 中更多的工业组件

工业组件

串口、Modbus 和 OPC UA 客户端集中在一个板块,附完整的组件参考。

Modbus 客户端参考

TsgcModbusTCPClient 和 TsgcModbusRTUClient 的属性、方法和事件。

Modbus 服务器参考

TsgcModbusTCPServer、TsgcModbusRTUServer 和 TsgcModbusDataModel 钩子。

Delphi 串口

适用于 Windows、Linux 和 macOS 的 TsgcSerialPort:Modbus RTU 的传输层,同时也是独立的串口组件。

Delphi MQTT 客户端

将 Modbus 数值发布到 MQTT 代理:将工厂数据送上云端的常用方式。

也适用于 C# 和 .NET

相同的 Modbus 客户端和服务器,类名一致,适用于 .NET 8、9、10 和 .NET Standard 2.0。

超值之选:All-AccesseSeGeCe 全部产品,含高级支持,每年 €1,059 起。
查看 All-Access 价格

用 Delphi 连接您的第一台 PLC

包含在 sgcWebSockets Enterprise(Delphi 和 .NET)和 All-Access 或独立的 sgcIndustrial 软件包中。