Modbus TCP 和 RTU客户端

通过 TCP/IP 或 RS-232、RS-485 串行线路,从 Delphi、C++Builder 和 .NET 读写 PLC、电能表和驱动器的线圈与寄存器。

新增

TsgcModbusTCPClient 和 TsgcModbusRTUClient

两个方法相同的客户端:一个连接到 Modbus TCP 设备或网关,另一个是串行线路上的 Modbus RTU 主站。

组件类

TsgcModbusTCPClient
TsgcModbusRTUClient

协议

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

平台

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

版本

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

通过 Modbus TCP 连接、读取和写入

设置 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。超出规范的数量会在发送任何数据之前被拒绝。

TLS、代理和重连

TCP 客户端支持 TLS、Proxy 和用于自动重连的 WatchDog。连接断开时正在等待的请求会立即抛出异常,无需等待超时。

网关和单元 ID

每个方法都有一个带前置单元 ID 的重载,因此一个 TCP 连接即可访问 Modbus TCP 到 RTU 网关后面的所有设备,而无需更改 UnitId。

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

打开一个 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);
    }
}

规范与参考

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

Modbus 客户端常见问题

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

包含在 sgcWebSockets Enterprise 中

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