Modbus TCP 和 RTU服务器
将 Delphi、C++Builder 或 .NET 应用程序变成 Modbus 设备。通过 TCP/IP 或串行线路,从线程安全的数据模型向 SCADA 系统、HMI 和 Modbus 客户端提供应答。
新增
将 Delphi、C++Builder 或 .NET 应用程序变成 Modbus 设备。通过 TCP/IP 或串行线路,从线程安全的数据模型向 SCADA 系统、HMI 和 Modbus 客户端提供应答。
新增
两个服务器使用同一个 TsgcModbusDataModel 应答:一个监听 TCP 端口 502,另一个是串行线路上的 Modbus RTU 从站。
TsgcModbusTCPServerTsgcModbusRTUServerTsgcModbusDataModel
Modbus Application Protocol V1.1b3、Modbus TCP 和 Modbus RTU
TCP:sgcWebSockets 的所有平台。RTU:Windows、Linux 和 macOS
包含在 sgcWebSockets Enterprise(Delphi 和 .NET)和 All-Access 或独立的 sgcIndustrial 软件包中
填充数据模型,分配事件并将 Active 设为 True。OnReadRequest 会在读取之前刷新实时数值,OnWriteRequest 会拒绝超出范围的设定值。
uses
sgcIndustrial;
procedure TForm1.StartServer;
begin
FServer := TsgcModbusTCPServer.Create(Self);
FServer.Port := 502;
FServer.DataModel.HoldingRegisterCount := 1000;
FServer.DataModel.SetHoldingRegister(0, 1234);
FServer.DataModel.SetCoil(5, True);
FServer.DataModel.VendorName := 'eSeGeCe';
FServer.DataModel.ProductCode := 'PLC-1';
FServer.DataModel.MajorMinorRevision := '1.0';
FServer.OnReadRequest := OnModbusReadRequest;
FServer.OnWriteRequest := OnModbusWriteRequest;
FServer.Active := True;
end;
procedure TForm1.OnModbusReadRequest(Sender: TObject; aUnitId,
aFunctionCode: Byte; aAddress, aCount: Word; var aExceptionCode: Byte);
begin
// live value: refresh input register 0 before the client reads it
if aFunctionCode = CS_MODBUS_FC_READ_INPUT_REGISTERS then
FServer.DataModel.SetInputRegister(0, FTemperature);
end;
procedure TForm1.OnModbusWriteRequest(Sender: TObject; aUnitId,
aFunctionCode: Byte; aAddress, aCount: Word; var aBits: TsgcModbusBits;
var aRegisters: TsgcModbusRegisters; var aExceptionCode: Byte);
var
i: Integer;
begin
// connection thread: setpoints accept 0..1000 only
if (aFunctionCode = CS_MODBUS_FC_WRITE_SINGLE_REGISTER) or
(aFunctionCode = CS_MODBUS_FC_WRITE_MULTIPLE_REGISTERS) then
for i := 0 to Length(aRegisters) - 1 do
if aRegisters[i] > 1000 then
begin
aExceptionCode := CS_MODBUS_EX_ILLEGAL_DATA_VALUE;
Exit;
end;
end;
#include "sgcIndustrial.hpp"
void __fastcall TForm1::StartServer()
{
FServer = new TsgcModbusTCPServer(this);
FServer->Port = 502;
FServer->DataModel->HoldingRegisterCount = 1000;
FServer->DataModel->SetHoldingRegister(0, 1234);
FServer->DataModel->SetCoil(5, true);
FServer->DataModel->VendorName = "eSeGeCe";
FServer->DataModel->ProductCode = "PLC-1";
FServer->DataModel->MajorMinorRevision = "1.0";
FServer->OnReadRequest = OnModbusReadRequest;
FServer->OnWriteRequest = OnModbusWriteRequest;
FServer->Active = true;
}
void __fastcall TForm1::OnModbusReadRequest(TObject *Sender, Byte aUnitId,
Byte aFunctionCode, Word aAddress, Word aCount, Byte &aExceptionCode)
{
// live value: refresh input register 0 before the client reads it
if (aFunctionCode == CS_MODBUS_FC_READ_INPUT_REGISTERS)
FServer->DataModel->SetInputRegister(0, FTemperature);
}
void __fastcall TForm1::OnModbusWriteRequest(TObject *Sender, Byte aUnitId,
Byte aFunctionCode, Word aAddress, Word aCount, TsgcModbusBits &aBits,
TsgcModbusRegisters &aRegisters, Byte &aExceptionCode)
{
// connection thread: setpoints accept 0..1000 only
if ((aFunctionCode == CS_MODBUS_FC_WRITE_SINGLE_REGISTER) ||
(aFunctionCode == CS_MODBUS_FC_WRITE_MULTIPLE_REGISTERS))
for (int i = 0; i < aRegisters.Length; i++)
if (aRegisters[i] > 1000)
{
aExceptionCode = CS_MODBUS_EX_ILLEGAL_DATA_VALUE;
return;
}
}
using System;
using esegece.sgcWebSockets;
class PlcServer
{
TsgcModbusTCPServer FServer = new TsgcModbusTCPServer();
ushort FTemperature = 215;
public void StartServer()
{
FServer.Port = 502;
FServer.DataModel.HoldingRegisterCount = 1000;
FServer.DataModel.SetHoldingRegister(0, 1234);
FServer.DataModel.SetCoil(5, true);
FServer.DataModel.VendorName = "eSeGeCe";
FServer.DataModel.ProductCode = "PLC-1";
FServer.DataModel.MajorMinorRevision = "1.0";
FServer.OnReadRequest += OnModbusReadRequest;
FServer.OnWriteRequest += OnModbusWriteRequest;
FServer.Active = true;
}
void OnModbusReadRequest(object Sender, byte aUnitId, byte aFunctionCode,
ushort aAddress, ushort aCount, ref byte aExceptionCode)
{
// live value: refresh input register 0 before the client reads it
if (aFunctionCode == sgcModbus_Classes.CS_MODBUS_FC_READ_INPUT_REGISTERS)
FServer.DataModel.SetInputRegister(0, FTemperature);
}
void OnModbusWriteRequest(object Sender, byte aUnitId, byte aFunctionCode,
ushort aAddress, ushort aCount, ref bool[] aBits, ref ushort[] aRegisters,
ref byte aExceptionCode)
{
// connection thread: setpoints accept 0..1000 only
if (aFunctionCode == sgcModbus_Classes.CS_MODBUS_FC_WRITE_SINGLE_REGISTER ||
aFunctionCode == sgcModbus_Classes.CS_MODBUS_FC_WRITE_MULTIPLE_REGISTERS)
foreach (ushort vValue in aRegisters)
if (vValue > 1000)
{
aExceptionCode = sgcModbus_Classes.CS_MODBUS_EX_ILLEGAL_DATA_VALUE;
return;
}
}
}
组件形式的 Modbus 设备:服务器解析请求、检查请求,并从数据模型中应答。
01 至 08(08 的子功能为 0)、15、16、22(掩码写入,以原子方式应用)、23(读/写多个寄存器)和 43/14(设备标识,通过 More Follows 分页)。
线圈、离散输入、保持寄存器和输入寄存器,默认各 10000 个,最多 65536 个。每个 Get 和 Set 方法都是线程安全的,超出表范围的请求会得到异常 02。
OnReadRequest 在读取数据之前触发,用于加载实时数值。OnWriteRequest 在写入数据之前触发,用于更改数值,或以 Modbus 异常码拒绝请求。
每个 TCP 连接独立处理,同一数据包中的多个请求会按顺序应答。格式错误的报头会触发 OnError 并关闭该连接。OnClientConnect 和 OnClientDisconnect 报告对端。
默认情况下,TCP 服务器会应答每个单元 ID。设置 UnitId 则只应答该 ID:其他 ID 的请求不会得到响应,连接保持打开,就像网关对缺失设备的处理方式一样。
VendorName、ProductCode 和 MajorMinorRevision 是基本对象,VendorUrl、ProductName 和 ModelName 是常规对象,均会在功能 43/14 中应答。
关联一个 TsgcSerialPort,并在 UnitId 中设置从站地址(1 至 247)。服务器启动时会打开端口,并从其数据模型中应答。
procedure TForm1.StartRTUServer;
begin
FPort := TsgcSerialPort.Create(Self);
FPort.Port := 'COM5';
FPort.BaudRate := 19200;
FPort.Parity := spEven;
FRTUServer := TsgcModbusRTUServer.Create(Self);
FRTUServer.SerialPort := FPort;
FRTUServer.UnitId := 17;
FRTUServer.DataModel.SetInputRegister(0, 215);
// the server opens the port when it is closed
FRTUServer.Active := True;
end;
void __fastcall TForm1::StartRTUServer()
{
FPort = new TsgcSerialPort(this);
FPort->Port = "COM5";
FPort->BaudRate = 19200;
FPort->Parity = spEven;
FRTUServer = new TsgcModbusRTUServer(this);
FRTUServer->SerialPort = FPort;
FRTUServer->UnitId = 17;
FRTUServer->DataModel->SetInputRegister(0, 215);
// the server opens the port when it is closed
FRTUServer->Active = true;
}
using System;
using esegece.sgcWebSockets;
class RtuSlave
{
TsgcSerialPort FPort = new TsgcSerialPort();
TsgcModbusRTUServer FRTUServer = new TsgcModbusRTUServer();
public void StartRTUServer()
{
FPort.Port = "COM5";
FPort.BaudRate = 19200;
FPort.Parity = TsgcSerialParity.spEven;
FRTUServer.SerialPort = FPort;
FRTUServer.UnitId = 17;
FRTUServer.DataModel.SetInputRegister(0, 215);
// the server opens the port when it is closed
FRTUServer.Active = true;
}
}
在处理 TCP 连接的线程中,或在 RTU 服务器的帧线程中。它们从不与主线程同步,因为服务器需要处理程序的结果来构建响应。请勿在其中直接访问用户界面,也不要在 TCP 服务器的事件处理程序中将 Active 设置为 False。
每当数值变化时将其写入数据模型,或在 OnReadRequest 中加载,该事件在每次读取前触发,并带有功能码、地址和数量。数据模型方法可在事件中调用,也可从任何其他线程调用。
在 OnWriteRequest 中设置 aExceptionCode,例如设为 CS_MODBUS_EX_ILLEGAL_DATA_VALUE (03)。客户端会收到该 Modbus 异常,表数据保持不变。该事件也可以在写入之前更改数值。
它作为 sgcIndustrial 包的一部分,包含在 sgcWebSockets Enterprise(Delphi 和 .NET)和 All-Access 中。在 Delphi 中,请将 sgcIndustrial 添加到 uses 子句。
直达组件参考,打开演示项目并阅读技术文档。
| Online Help: TsgcModbusTCPServer Modbus TCP 服务器的完整属性、方法和事件参考。 | 打开 | |
| Online Help: TsgcModbusRTUServer Modbus RTU 服务器的完整属性、方法和事件参考。 | 打开 | |
| Online Help: TsgcModbusDataModel 数据模型的表、设备标识对象和事件。 | 打开 | |
| 演示项目:Industrial\03.Modbus_TCP_Server 适用于 Delphi、C++Builder 和 .NET 的 Modbus TCP 服务器。随 sgcWebSockets 软件包一同提供。 | 打开 | |
| 技术文档 (PDF) 仅针对此组件的功能、快速入门、代码示例和一手资料参考。 | 打开 | |
| 用户手册 (PDF) 涵盖库中每个组件的综合手册。 | 打开 |