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
客户端会在发送任何数据之前根据规范检查数量;服务器会应答此表中的每个功能码。
| FC | 功能 | 客户端方法 |
|---|---|---|
| 01 | Read Coils | ReadCoils |
| 02 | Read Discrete Inputs | ReadDiscreteInputs |
| 03 | Read Holding Registers | ReadHoldingRegisters, ReadInt32, ReadUInt32, ReadFloat32, ReadString |
| 04 | Read Input Registers | ReadInputRegisters, ReadInputInt32, ReadInputUInt32, ReadInputFloat32 |
| 05 | Write Single Coil | WriteSingleCoil |
| 06 | Write Single Register | WriteSingleRegister |
| 07 | Read Exception Status(串行线路) | RTU 客户端上的 ReadExceptionStatus |
| 08 | Diagnostics(串行线路) | RTU 客户端上的 Diagnostics |
| 15 | Write Multiple Coils | WriteMultipleCoils |
| 16 | Write Multiple Registers | WriteMultipleRegisters, WriteInt32, WriteUInt32, WriteFloat32, WriteString |
| 22 | Mask Write Register | MaskWriteRegister |
| 23 | Read/Write Multiple Registers | ReadWriteMultipleRegisters |
| 43/14 | Read Device Identification | ReadDeviceIdentification(基本、常规、扩展和单个对象) |
创建组件,设置地址,调用方法。本页上的每个示例都可在 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;
在 TCP 和串行线路上提供阻塞调用、类型化数值和清晰的错误。
ReadFloat32、ReadInt32、ReadUInt32 及其写入和输入寄存器对应方法会将两个寄存器合并为一个数值。WordOrder 涵盖设备使用的四种布局:mwoABCD(大端,Modbus 默认)、mwoCDAB、mwoBADC 和 mwoDCBA。ReadString 和 WriteString 每个寄存器打包两个字符。
每个客户端同一时间只运行一个请求,由覆盖其所有重试的锁保护,因此多个线程可以共享一个连接。在 TCP 上,应答由接收线程匹配,因此从主线程调用不会死锁。
Timeout 是每次尝试的等待时间,Retries 是额外的尝试次数。TCP 重试使用新的事务 ID,迟到或重复的应答会被丢弃,而不会被误认为是下一个应答。
EsgcModbusException 携带设备的 ExceptionCode 和 FunctionCode,EsgcModbusTimeout 报告缺少应答,EsgcModbusError 涵盖其他所有情况,从连接关闭到 CRC 错误的 RTU 帧。
每个方法还有一个带前置单元 ID 的重载,因此到网关的一个连接即可访问其后的所有设备。不带该参数的调用默认使用 UnitId。
TLS 和 TLSOptions 将 Modbus TCP 流包装在 TLS 中,Proxy 通过 HTTP 或 SOCKS 代理访问设备,WatchDog 在网络中断后重连。这三者都来自该组件所基于的 sgcWebSockets TCP 客户端。
RTU 客户端在发送之前等待 3.5 个字符的静默,按预期长度读取应答(USB 适配器会分批传送字节),检查每个帧的 CRC,并忽略来自其他从站地址的帧。
在串口上设置 RtsControl := srcToggle,RTS 就会在每次写入时切换 RS-485 发送器,在 Windows 上通过驱动程序,在 Linux 上通过内核 RS-485 模式。单元 ID 0 会向每个从站发送广播写入,并等待 TurnaroundDelay 而不是应答。
OnConnect、OnDisconnect 和 OnError 通过 NotifyEvents 分发:默认排入主线程队列,也可同步,或直接在接收线程中触发。
将 Delphi 应用程序变成 Modbus 从站:公开数据库或 REST API 数值的网关、用于测试 HMI 画面的设备模拟器,或您自己控制器的 Modbus 接口。每个服务器都拥有一个 TsgcModbusDataModel,包含四个 Modbus 表(线圈、离散输入、保持寄存器和输入寄存器,默认各 10,000 项,最多 65,536 项)、在 FC 43/14 上应答的设备标识字符串,以及在 FC 07 上应答的异常状态。
数据模型是线程安全的:一把锁保护所有表,因此您的代码可以在客户端读取时更新数值。两个钩子将您的代码置于请求路径中。OnReadRequest 在读取表之前运行,因此可以即时刷新数值,或以异常码拒绝请求。OnWriteRequest 在数值存储之前接收它们,因此可以验证、更改或拒绝写入,并使表保持不变。
支持多个并发连接,每个连接都有自己的线程。同时到达同一数据包的请求按顺序应答,拆分到多个数据包的请求会被重新组装,格式错误的报头会关闭该连接并触发 OnError。UnitId = 0 应答任何单元 ID,其他值则只应答该 ID。Bindings 选择接口和端口,OnClientConnect 和 OnClientDisconnect 报告对端。
作为从站 UnitId(1 至 247)在 TsgcSerialPort 上监听。它按预期长度和 3.5 个字符的静默为请求分帧,忽略 CRC 错误或其他地址的帧,并按串行线路规范的要求,执行来自单元 ID 0 的广播写入而不应答。
服务器事件在连接线程 (TCP) 或帧线程 (RTU) 中运行,并同步返回结果。请保持它们简短,并可放心调用数据模型方法:钩子运行时不持有任何锁。
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 上编译。
创建 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 软件包中。
串口、Modbus 和 OPC UA 客户端集中在一个板块,附完整的组件参考。
TsgcModbusTCPClient 和 TsgcModbusRTUClient 的属性、方法和事件。
TsgcModbusTCPServer、TsgcModbusRTUServer 和 TsgcModbusDataModel 钩子。
适用于 Windows、Linux 和 macOS 的 TsgcSerialPort:Modbus RTU 的传输层,同时也是独立的串口组件。
将 Modbus 数值发布到 MQTT 代理:将工厂数据送上云端的常用方式。
相同的 Modbus 客户端和服务器,类名一致,适用于 .NET 8、9、10 和 .NET Standard 2.0。