Modbus TCP 和 RTU服务器

将 Delphi、C++Builder 或 .NET 应用程序变成 Modbus 设备。通过 TCP/IP 或串行线路,从线程安全的数据模型向 SCADA 系统、HMI 和 Modbus 客户端提供应答。

新增

TsgcModbusTCPServer 和 TsgcModbusRTUServer

两个服务器使用同一个 TsgcModbusDataModel 应答:一个监听 TCP 端口 502,另一个是串行线路上的 Modbus RTU 从站。

组件类

TsgcModbusTCPServer
TsgcModbusRTUServer
TsgcModbusDataModel

协议

Modbus Application Protocol V1.1b3、Modbus TCP 和 Modbus RTU

平台

TCP:sgcWebSockets 的所有平台。RTU:Windows、Linux 和 macOS

版本

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

启动 Modbus TCP 服务器

填充数据模型,分配事件并将 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 报告对端。

单元 ID

默认情况下,TCP 服务器会应答每个单元 ID。设置 UnitId 则只应答该 ID:其他 ID 的请求不会得到响应,连接保持打开,就像网关对缺失设备的处理方式一样。

设备标识

VendorName、ProductCode 和 MajorMinorRevision 是基本对象,VendorUrl、ProductName 和 ModelName 是常规对象,均会在功能 43/14 中应答。

RS-232 和 RS-485 上的 RTU 从站

关联一个 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;
    }
}

规范与参考

本组件所实现协议的权威来源。

Modbus 服务器常见问题

在处理 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) 涵盖库中每个组件的综合手册。
超值之选:All-AccesseSeGeCe 全部产品,含高级支持,每年 €1,059 起。
查看 All-Access 价格

包含在 sgcWebSockets Enterprise 中

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