Modbus TCP と RTU クライアント
Delphi、C++Builder、.NET から、TCP/IP または RS-232 や RS-485 のシリアル回線を通じて、PLC、電力量計、ドライブのコイルとレジスタを読み書きします。
新機能
Delphi、C++Builder、.NET から、TCP/IP または RS-232 や RS-485 のシリアル回線を通じて、PLC、電力量計、ドライブのコイルとレジスタを読み書きします。
新機能
同じメソッドを持つ 2 つのクライアントです。1 つは Modbus TCP デバイスまたはゲートウェイに接続し、もう 1 つはシリアル回線上の Modbus RTU マスターです。
TsgcModbusTCPClientTsgcModbusRTUClient
Modbus Application Protocol V1.1b3、Modbus TCP と Modbus RTU
TCP: sgcWebSockets のすべてのプラットフォーム。RTU: Windows、Linux、macOS
sgcWebSockets Enterprise (Delphi と .NET) および All-Access、または単体の sgcIndustrial パックに含まれています
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 を発生させます。仕様の範囲外の数量は、何かが送信される前に拒否されます。
TCP クライアントは、TLS、Proxy、自動再接続用の WatchDog に対応しています。接続が切れたときに待機中だったリクエストは、タイムアウトを待たずにすぐに例外を発生させます。
すべてのメソッドには先頭にユニット ID を取るオーバーロードがあり、UnitId を変更せずに、1 つの TCP 接続で Modbus TCP から 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);
}
}
TurnaroundDelay の間待機します
このコンポーネントが実装するプロトコルの公式ソースです。
メソッドが受け取るのは 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) ライブラリのすべてのコンポーネントを網羅した総合マニュアルです。 | 開く |