Modbus TCP と RTU サーバー
Delphi、C++Builder、.NET アプリケーションを Modbus デバイスにします。TCP/IP またはシリアル回線を通じて、スレッドセーフなデータモデルから SCADA システム、HMI、Modbus クライアントに応答します。
新機能
Delphi、C++Builder、.NET アプリケーションを Modbus デバイスにします。TCP/IP またはシリアル回線を通じて、スレッドセーフなデータモデルから SCADA システム、HMI、Modbus クライアントに応答します。
新機能
同じ TsgcModbusDataModel から応答する 2 つのサーバーです。1 つは TCP ポート 502 で待ち受け、もう 1 つはシリアル回線上の 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 接続は独立して処理され、1 つのパケットに含まれる複数のリクエストには順番に応答します。不正なヘッダーは OnError を発生させ、その接続を閉じます。OnClientConnect と OnClientDisconnect が接続相手を通知します。
デフォルトでは、TCP サーバーはすべてのユニット ID に応答します。UnitId を設定すると 1 つの 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 では 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) ライブラリのすべてのコンポーネントを網羅した総合マニュアルです。 | 開く |