Modbus TCP と RTU サーバー

Delphi、C++Builder、.NET アプリケーションを Modbus デバイスにします。TCP/IP またはシリアル回線を通じて、スレッドセーフなデータモデルから SCADA システム、HMI、Modbus クライアントに応答します。

新機能

TsgcModbusTCPServer と TsgcModbusRTUServer

同じ TsgcModbusDataModel から応答する 2 つのサーバーです。1 つは TCP ポート 502 で待ち受け、もう 1 つはシリアル回線上の 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 接続は独立して処理され、1 つのパケットに含まれる複数のリクエストには順番に応答します。不正なヘッダーは OnError を発生させ、その接続を閉じます。OnClientConnect と OnClientDisconnect が接続相手を通知します。

ユニット ID

デフォルトでは、TCP サーバーはすべてのユニット ID に応答します。UnitId を設定すると 1 つの 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 では uses 句に sgcIndustrial を追加します。

ドキュメント・デモ

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

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