新機能

Delphi OPC UA クライアントコンポーネント

Delphi と C++Builder 向けのネイティブ OPC UA クライアントです。署名と暗号化が施され、自動で再接続する opc.tcp 接続を通じて、PLC、SCADA サーバー、産業用ゲートウェイの変数のブラウズ、読み取り、書き込み、メソッドの呼び出し、サブスクリプションによるデータ変更とアラームの受信ができます。

sgcWebSockets Enterprise (Delphi と .NET) および All-Access、または単体の sgcIndustrial パックに含まれています。

OPC UA のクライアント側を担う 1 つのコンポーネント

セキュアチャネル、セッション、サービス、サブスクリプションを、Pascal で書かれアプリケーションにコンパイルされるビジュアルではないコンポーネントにまとめています。

Delphi OPC UA クライアントを使うと、VCL、FMX、サービス、コンソールのいずれのアプリケーションからでも、機械、PLC、SCADA システムが OPC UA サーバー経由で公開するデータを読み取り、設定値やコマンドを書き戻せます。sgcWebSockets では TsgcOPCUAClient として提供されます。EndpointUrl を設定し、SecurityPolicy と SecurityMode を選択して Connect を呼び出し、ns=2;s=Line1.Speed や i=2253 のようなノード ID を使って操作します。

サービス呼び出しはサーバーが応答するまでブロックし、失敗すると OPC UA ステータスコード付きの EsgcOPCUAError が発生します。ReadValue は Delphi の Variant を返し、WriteValue は最初にノードのデータ型を読み取るため、WriteValue('ns=2;s=Line1.Setpoint', 75.5) のような呼び出しは、ノードが期待するとおりに Float または Double として書き込まれます。uses sgcIndustrial; の 1 行で、コンポーネント、その型、列挙型がすべて利用できます。

コンポーネントクラス

TsgcOPCUAClient、および TsgcOPCUASubscription と TsgcOPCUAMonitoredItem

トランスポート

opc.tcp 上の OPC UA バイナリ。PLC や SCADA サーバーが公開するトランスポートです

セキュリティ

Basic256Sha256、Aes128_Sha256_RsaOaep、Aes256_Sha256_RsaPss による Sign と SignAndEncrypt

プラットフォーム

Delphi 7 から Delphi 13 および C++Builder、Windows 32 ビット・64 ビット、Linux 64 ビット

OPC UA サービスを 1 つずつのメソッドで

シンプルなオーバーロードはノード ID 文字列を受け取り、フルオーバーロードは仕様のリクエストレコードを受け取ります。

サービスセットサービスメソッド
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
メソッドCallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptionsコンポーネントが自動で処理: OnDataChange、OnEvent、OnKeepAlive、WatchDog

数行の Delphi コードで機械を読み取る

コンポーネントを作成し、エンドポイントを設定し、メソッドを呼び出します。このページのすべてのサンプルは Delphi 7 と Delphi 13 でコンパイルできます。

uses
  sgcIndustrial;

procedure TForm1.ReadLine1;
begin
  OPCUA := TsgcOPCUAClient.Create(Self);
  OPCUA.EndpointUrl := 'opc.tcp://192.168.1.60:4840';
  OPCUA.Connect;
  try
    Memo1.Lines.Add('Speed: ' + VarToStr(OPCUA.ReadValue('ns=2;s=Line1.Speed')));
    // write with an explicit built-in type
    OPCUA.WriteValue('ns=2;s=Line1.Mode', 2, uabtUInt16);
  except
    on E: EsgcOPCUAError do
      Memo1.Lines.Add('Status ' + IntToHex(Int64(E.StatusCode), 8) + ': ' + E.Message);
  end;
end;
uses
  sgcIndustrial, sgcOPCUA_Types;

procedure TForm1.BrowseAndCall;
var
  vRefs: TsgcOPCUAReferenceDescriptionArray;
  vInputs, vOutputs: TsgcOPCUAVariantArray;
  i: Integer;
begin
  // i=85 is the Objects folder
  vRefs := OPCUA.Browse('i=85');
  for i := 0 to Length(vRefs) - 1 do
    Memo1.Lines.Add(vRefs[i].DisplayName.Text + ' = ' +
      sgcOPCUANodeIdToString(vRefs[i].NodeId.NodeId));
  // resolve a browse path to a node id
  Memo1.Lines.Add(sgcOPCUANodeIdToString(OPCUA.TranslateBrowsePath('i=85', '/2:Line1/2:Speed')));
  // call a method with two Int32 arguments
  SetLength(vInputs, 2);
  vInputs[0] := sgcOPCUAVariantSimple(uabtInt32, 2);
  vInputs[1] := sgcOPCUAVariantSimple(uabtInt32, 3);
  vOutputs := OPCUA.Call('ns=2;s=Methods', 'ns=2;s=Methods.Add', vInputs);
  Memo1.Lines.Add('Result: ' + VarToStr(vOutputs[0].Value));
end;
procedure TForm1.WatchLine1;
var
  oSubscription: TsgcOPCUASubscription;
begin
  OPCUA.OnDataChange := OnOPCUADataChange;
  oSubscription := OPCUA.CreateSubscription(1000);
  // sampling 100 ms, keep the 10 newest samples between two publishes
  FSpeed := OPCUA.AddMonitoredItem(oSubscription, 'ns=2;s=Line1.Speed', 100, 10);
  // only changes of more than 2 percent of the EURange of the variable
  OPCUA.AddMonitoredItem(oSubscription, 'ns=2;s=Line1.Level', 500, 1, True, uadbtPercent, 2);
end;

procedure TForm1.OnOPCUADataChange(Sender: TObject; aSubscription: TsgcOPCUASubscription;
  aMonitoredItem: TsgcOPCUAMonitoredItem; const aValue: TsgcOPCUADataValue);
begin
  if aMonitoredItem = FSpeed then
    Memo1.Lines.Add('Speed: ' + VarToStr(aValue.Value.Value))
  else
    Memo1.Lines.Add('Level: ' + VarToStr(aValue.Value.Value));
end;
uses
  sgcIndustrial, sgcOPCUA_Encoding;

procedure TForm1.WatchAlarms;
var
  oSubscription: TsgcOPCUASubscription;
begin
  OPCUA.OnEvent := OnOPCUAEvent;
  oSubscription := OPCUA.CreateSubscription(1000);
  // i=2253 is the Server object, which reports the events of the whole server
  OPCUA.AddEventMonitoredItem(oSubscription, 'i=2253', ['Message', 'Severity', 'SourceName']);
end;

procedure TForm1.OnOPCUAEvent(Sender: TObject; aSubscription: TsgcOPCUASubscription;
  aMonitoredItem: TsgcOPCUAMonitoredItem; const aEventFields: TsgcOPCUAVariantArray);
begin
  // the fields arrive in the order of the select clauses
  Memo1.Lines.Add(VarToStr(sgcOPCUAVariantToDelphi(aEventFields[2])) + ' (' +
    VarToStr(sgcOPCUAVariantToDelphi(aEventFields[1])) + '): ' +
    VarToStr(sgcOPCUAVariantToDelphi(aEventFields[0])));
end;
procedure TForm1.StartMonitor;
begin
  OPCUA := TsgcOPCUAClient.Create(Self);
  OPCUA.EndpointUrl := 'opc.tcp://192.168.1.60:4840';
  // try to reconnect every 5 seconds, with no limit of attempts
  OPCUA.WatchDog.Enabled := True;
  OPCUA.WatchDog.Interval := 5;
  OPCUA.WatchDog.Attempts := 0;
  OPCUA.OnStatusChange := OnOPCUAStatusChange;
  OPCUA.OnReconnect := OnOPCUAReconnect;
  OPCUA.Connect;
end;

procedure TForm1.OnOPCUAStatusChange(Sender: TObject; aState: TsgcOPCUAClientState);
begin
  if aState = opccsReconnecting then
    Memo1.Lines.Add('Connection lost, reconnecting');
end;

procedure TForm1.OnOPCUAReconnect(Sender: TObject; aMethod: TsgcOPCUAReconnectMethod);
begin
  case aMethod of
    opcrmSessionReactivated:
      Memo1.Lines.Add('Same session, missing notifications republished');
    opcrmSubscriptionsTransferred:
      Memo1.Lines.Add('New session, subscriptions transferred');
    opcrmSubscriptionsRecreated:
      Memo1.Lines.Add('New session, subscriptions created again');
  else
    Memo1.Lines.Add('New session');
  end;
end;

ヘルパー関数 sgcOPCUANodeIdToString と sgcOPCUAVariantSimple は sgcOPCUA_Types に、sgcOPCUAVariantToDelphi は sgcOPCUA_Encoding にあります。これらを使う場合は該当ユニットを追加してください。Delphi 7 から 2006 では、TBytes のために sgcBase_Helpers も必要です。

製造現場向けに作られた OPC UA クライアント

サブスクリプション、フィルタ、再接続はコンポーネントが処理し、必要な箇所でイベントを受け取れます。

ポーリング不要のサブスクリプション

CreateSubscription でパブリッシング間隔を、AddMonitoredItem で各ノードのサンプリング間隔とキューサイズを設定します。コンポーネントは十分な数の Publish リクエストを送信中に保ち、すべての通知を確認応答し、欠落したメッセージの再パブリッシュをサーバーに要求します。

デッドバンドとトリガー

絶対デッドバンド (uadbtAbsolute) または EURange に対するパーセント (uadbtPercent) で、ノイズをハンドラに入れずに済みます。トリガーで、ステータスの変化、値の変化、新しいタイムスタンプのどれを通知するかを選択できます。

イベントとアラーム

AddEventMonitoredItem は、Message、Severity、SourceName などの返却するイベントフィールドと、任意の where 句を受け取ります。単一のソース、またはサーバーのすべてのイベントを対象にする Server オブジェクトをサブスクライブできます。

WatchDog 再接続

ネットワークが切断されると、WatchDog はまず同じセッションを再アクティブ化し、取りこぼした通知を再パブリッシュします。セッションが失われている場合は新しいセッションを開き、サブスクリプションを転送するか、作成し直します。OnReconnect はどの経路が使われたかを通知します。

再接続後も同じオブジェクト

サブスクリプションとモニタリング項目はクライアントが所有し、WatchDog による再接続後も維持されます。サーバー側の ID は変わることがありますが、項目の ClientHandle は変わらないため、ハンドラはそのまま動作し続けます。

好きな場所でイベントを受け取る

OnDataChange、OnEvent、OnKeepAlive、OnConnect、OnDisconnect、OnError は NotifyEvents を通じて配信されます。既定ではメインスレッドにキューイングされ、同期させることも、サービスやコンソールアプリケーション向けにクライアントのスレッドで発生させることもできます。

署名と暗号化に対応し、安全な既定値を採用

SecurityPolicy を opcspBasic256Sha256、opcspAes128_Sha256_RsaOaep、opcspAes256_Sha256_RsaPss のいずれかに、SecurityMode を opcsmSign または opcsmSignAndEncrypt に設定します。opcspBasic128Rsa15 と opcspBasic256 は OPC Foundation により非推奨とされており、古いサーバー向けに用意されています。クライアントは GetEndpoints から一致するエンドポイントを選択し、一致するものがない場合は、サーバーが提供するものをエラーに一覧表示します。

アプリケーション証明書

Application.CertificateFile と PrivateKeyFile でインスタンス証明書を読み込みます。ファイルがまだ存在しない場合、クライアントが証明書を作成してそこに保存するため、サーバー管理者が一度信頼するだけで済みます。ファイルを設定しない場合は、メモリ上に作成されます。

サーバー証明書

サーバー証明書は OnValidateServerCertificate が受け入れない限り拒否されるため、新しいクライアントが未知のサーバーを誤って信頼することはありません。AutoAcceptServerCertificate はテスト環境向けです。

ユーザー ID

Authentication.AuthenticationType で、匿名、ユーザー名とパスワード、X.509 ユーザー証明書のいずれかを選択します。サーバーのトークンポリシーが求める場合は、パスワードがサーバーの鍵で暗号化されます。

独立した OPC UA スタックに対してテスト済み

クライアントは、独立したオープンソースの OPC UA 実装である asyncua で構築されたリファレンスサーバーに対して、実際の通信でテストされています。サーバーの 11 すべてのエンドポイント (すべてのポリシーとモード)、3 種類の ID タイプ、継続ポイントを使った 1,000 件の参照のブラウズ、配列とマトリックスを含む 18 の組み込み型の読み取り、スカラーと配列の書き込み、メソッド呼び出し、デッドバンドと where 句を使ったデータ変更およびイベントのサブスクリプション、メッセージの欠落も重複もない 2 分間のパブリッシュ実行、WatchDog の各再接続経路を対象としています。

Delphi OPC UA に関するよくある質問

TsgcOPCUAClient を作成し、EndpointUrl をサーバーの opc.tcp アドレスに設定し、Connect を呼び出してから ReadValue('ns=2;s=Line1.Speed') を呼び出します。Variant が返されます。Read は複数のノードと属性を 1 回の呼び出しで読み取ります。

パブリッシング間隔を指定して CreateSubscription を呼び出し、AddMonitoredItem でノードを追加し、OnDataChange を割り当てます。イベントは、サブスクリプション、モニタリング項目、ステータスコードとタイムスタンプを持つ新しい TsgcOPCUADataValue を受け取ります。

Sign または SignAndEncrypt モードの Basic256Sha256、Aes128_Sha256_RsaOaep、Aes256_Sha256_RsaPss に加え、古いサーバー向けの非推奨の Basic128Rsa15 と Basic256、テスト環境向けの None に対応しています。

WatchDog.Enabled を有効にすると、クライアントは WatchDog.Interval 秒ごとに再試行します。サーバーにセッションが残っていれば同じセッションを再アクティブ化し、そうでなければ新しいセッションを開いてサブスクリプションを転送または再作成します。OnReconnect はどの経路が使われたかを通知し、サブスクリプションオブジェクトは有効なままです。

はい。メッセージループがない場合は NotifyEvents := neNoSync を設定します。イベントはクライアントのスレッドで実行されます。それらのイベントから Connect などのブロッキングサービスを呼び出さず、再接続は WatchDog に任せてください。

Delphi 7 から Delphi 13 および C++Builder、Windows (32 ビット・64 ビット) と Linux 64 ビット。

OPC UA クライアントは、sgcWebSockets Enterprise (Delphi および .NET) と All-Access、または単体の sgcIndustrial パックに含まれています。OPC UA サーバー、HTTPS・JSON・WebSocket トランスポート、HistoryRead、PubSub、Reverse Connect、Global Discovery Server は含まれません。

sgcWebSockets のその他の産業用コンポーネント

産業用コンポーネント

シリアルポート、Modbus、OPC UA を 1 つのセクションにまとめ、完全なコンポーネントリファレンスを提供します。

OPC UA クライアントのリファレンス

TsgcOPCUAClient のプロパティ、メソッド、イベント。C++Builder と C# のサンプル付き。

Delphi Modbus TCP と RTU

OPC UA に対応していないデバイス向けの Modbus クライアントとサーバー。

Delphi MQTT クライアント

OPC UA のデータ変更を MQTT トピックに転送します。工場からクラウドへの定番のゲートウェイです。

C# と .NET にも対応

.NET 8、9、10、.NET Standard 2.0 向けに、同じクラス名を持つ同じ OPC UA クライアントを提供します。

最もお得な選択: All-AccesseSeGeCe の全製品にプレミアムサポートが付いて、年間 €1,059 からご利用いただけます。
All-Access の価格を見る

Delphi で最初の OPC UA ノードを読む

sgcWebSockets Enterprise (Delphi と .NET) および All-Access、または単体の sgcIndustrial パックに含まれています。