Modbus TCP と RTU クライアント

Delphi、C++Builder、.NET から、TCP/IP または RS-232 や RS-485 のシリアル回線を通じて、PLC、電力量計、ドライブのコイルとレジスタを読み書きします。

新機能

TsgcModbusTCPClient と TsgcModbusRTUClient

同じメソッドを持つ 2 つのクライアントです。1 つは Modbus TCP デバイスまたはゲートウェイに接続し、もう 1 つはシリアル回線上の 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 を取るオーバーロードがあり、UnitId を変更せずに、1 つの TCP 接続で Modbus TCP から RTU へのゲートウェイの先にあるすべてのデバイスにアクセスできます。

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) を呼び出します。

2 つのレジスタのうち最初のレジスタのアドレスを指定して ReadFloat32 を呼び出します。値がおかしい場合は、デバイスが別のバイト順で格納しています。WordOrder をデバイスが使う順序に設定してください。多くの PLC は下位ワードを先に格納し、これは mwoCDAB です。

各試行は Timeout ミリ秒待機します。有効な応答がないまま Retries + 1 回試行すると、リクエストは EsgcModbusTimeout を発生させ、メッセージにはファンクションコード、ユニット ID、試行回数が含まれます。

いいえ。TsgcSerialPort は自分で開き、OnData イベントは空のままにしてください。クライアントは Read で応答を読み取ります。ポートが未割り当て、未オープン、または OnData が割り当てられている場合、リクエストは EsgcModbusError を発生させます。

sgcIndustrial パックの一部として sgcWebSockets Enterprise (Delphi と .NET) および All-Access に含まれています。Delphi では uses 句に sgcIndustrial を追加します。

ドキュメント・デモ

コンポーネントリファレンスへ直接移動し、デモプロジェクトを開いて、技術ドキュメントを読めます。

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 パックに含まれています。