Neu

Delphi OPC UA Client Komponente

Ein nativer OPC UA Client für Delphi und C++Builder. Durchsuche, lies und schreibe die Variablen von SPS-Steuerungen, SCADA-Servern und Industrie-Gateways, rufe deren Methoden auf und empfange Datenänderungen und Alarme über Subscriptions, über eine signierte und verschlüsselte opc.tcp-Verbindung, die sich selbstständig wiederverbindet.

Enthalten in sgcWebSockets Enterprise (Delphi und .NET) und All-Access oder im eigenständigen Paket sgcIndustrial.

Eine Komponente für die Client-Seite von OPC UA

Secure Channel, Session, Services und Subscriptions in einer nicht visuellen Komponente, in Pascal geschrieben und in deine Anwendung kompiliert.

Ein Delphi OPC UA Client ermöglicht einer VCL-, FMX-, Dienst- oder Konsolenanwendung, die Daten zu lesen, die Maschinen, SPS-Steuerungen und SCADA-Systeme über einen OPC UA Server veröffentlichen, und Sollwerte und Befehle zurückzuschreiben. sgcWebSockets liefert ihn als TsgcOPCUAClient: Setze EndpointUrl, wähle SecurityPolicy und SecurityMode, rufe Connect auf und arbeite mit Node-IDs wie ns=2;s=Line1.Speed oder i=2253.

Service-Aufrufe blockieren, bis der Server antwortet, und lösen bei einem Fehler EsgcOPCUAError mit dem OPC UA Statuscode aus. ReadValue liefert einen Delphi-Variant, und WriteValue liest zuerst den Datentyp des Knotens, sodass WriteValue('ns=2;s=Line1.Setpoint', 75.5) einen Float oder einen Double schreibt, so wie der Knoten es erwartet. Eine Zeile uses sgcIndustrial; bringt die Komponente, ihre Typen und ihre Aufzählungen mit.

Komponentenklasse

TsgcOPCUAClient, mit TsgcOPCUASubscription und TsgcOPCUAMonitoredItem

Transport

OPC UA Binary über opc.tcp, der Transport, den SPS-Steuerungen und SCADA-Server bereitstellen

Sicherheit

Sign und SignAndEncrypt mit Basic256Sha256, Aes128_Sha256_RsaOaep und Aes256_Sha256_RsaPss

Plattformen

Delphi 7 bis Delphi 13 und C++Builder; Windows 32 und 64 Bit und Linux 64 Bit

Die OPC UA Services, je eine Methode

Einfache Überladungen nehmen Node-ID-Strings; vollständige Überladungen nehmen die Request-Records der Spezifikation.

Service SetServiceMethode
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
MethodeCallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptionsVon der Komponente erledigt: OnDataChange, OnEvent, OnKeepAlive, WatchDog

Eine Maschine in wenigen Zeilen Delphi lesen

Komponente erstellen, Endpunkt setzen, eine Methode aufrufen. Jedes Beispiel auf dieser Seite lässt sich mit Delphi 7 und Delphi 13 kompilieren.

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;

Die Hilfsfunktionen sgcOPCUANodeIdToString und sgcOPCUAVariantSimple befinden sich in sgcOPCUA_Types, und sgcOPCUAVariantToDelphi in sgcOPCUA_Encoding; füge diese Units hinzu, wenn du sie verwendest. Delphi 7 bis 2006 benötigen außerdem sgcBase_Helpers für TBytes.

Ein OPC UA Client für die Fertigungshalle

Subscriptions, Filter und Wiederverbindung werden für dich erledigt, mit Ereignissen dort, wo du sie willst.

Subscriptions ohne Polling

CreateSubscription legt das Publishing-Intervall fest, AddMonitoredItem das Abtastintervall und die Warteschlangengröße jedes Knotens. Die Komponente hält genügend Publish-Requests in Bearbeitung, bestätigt jede Benachrichtigung und fordert den Server auf, jede verlorene Nachricht erneut zu senden.

Deadband und Trigger

Ein absolutes Deadband (uadbtAbsolute) oder ein Prozentsatz des EURange (uadbtPercent) hält Rauschen von deinen Handlern fern. Der Trigger legt fest, ob eine Statusänderung, eine Wertänderung oder ein neuer Zeitstempel gemeldet wird.

Ereignisse und Alarme

AddEventMonitoredItem nimmt die zurückzugebenden Ereignisfelder entgegen, etwa Message, Severity und SourceName, sowie eine optionale Where-Klausel. Abonniere eine einzelne Quelle oder das Server-Objekt für jedes Ereignis des Servers.

WatchDog-Wiederverbindung

Nach einem Netzwerkausfall aktiviert WatchDog zuerst dieselbe Session wieder und sendet die verpassten Benachrichtigungen erneut. Ist die Session verloren, öffnet er eine neue und überträgt die Subscriptions oder erstellt sie neu. OnReconnect meldet, welcher Weg genommen wurde.

Dieselben Objekte nach einer Wiederverbindung

Subscriptions und Monitored Items gehören dem Client und überstehen eine WatchDog-Wiederverbindung. Server-IDs können sich ändern, das ClientHandle eines Items nie, sodass deine Handler weiter funktionieren.

Ereignisse dort, wo du sie willst

OnDataChange, OnEvent, OnKeepAlive, OnConnect, OnDisconnect und OnError werden über NotifyEvents geliefert: standardmäßig in die Warteschlange des Hauptthreads gestellt, synchronisiert oder in den Client-Threads ausgelöst, für Dienste und Konsolenanwendungen.

Signiert und verschlüsselt, mit sicheren Standardwerten

Setze SecurityPolicy auf opcspBasic256Sha256, opcspAes128_Sha256_RsaOaep oder opcspAes256_Sha256_RsaPss und SecurityMode auf opcsmSign oder opcsmSignAndEncrypt. opcspBasic128Rsa15 und opcspBasic256 sind von der OPC Foundation als veraltet eingestuft und nur für ältere Server vorhanden. Der Client wählt aus GetEndpoints den passenden Endpunkt und listet im Fehlerfall, wenn keiner passt, auf, was der Server anbietet.

Anwendungszertifikat

Application.CertificateFile und PrivateKeyFile laden das Instanzzertifikat. Existieren die Dateien noch nicht, erstellt der Client das Zertifikat und speichert es dort, sodass der Server-Administrator ihm einmal vertraut. Sind keine Dateien gesetzt, wird es im Speicher erstellt.

Serverzertifikat

Ein Serverzertifikat wird abgelehnt, sofern OnValidateServerCertificate es nicht akzeptiert, sodass ein frischer Client einem unbekannten Server nie versehentlich vertraut. AutoAcceptServerCertificate gibt es für Testaufbauten.

Benutzeridentität

Authentication.AuthenticationType wählt Anonymous, Benutzername und Passwort oder ein X.509-Benutzerzertifikat. Das Passwort wird mit dem Serverschlüssel verschlüsselt, sobald die Token-Richtlinie des Servers dies verlangt.

Gegen einen unabhängigen OPC UA Stack getestet

Der Client wird auf der Leitung gegen einen Referenzserver auf Basis von asyncua getestet, einer unabhängigen Open-Source-Implementierung von OPC UA: alle elf Endpunkte des Servers (jede Policy und jeder Modus), die drei Identitätstypen, das Durchsuchen von 1.000 Referenzen mit Continuation Points, das Lesen von 18 eingebauten Typen mit Arrays und einer Matrix, das Schreiben von Skalaren und Arrays, Methodenaufrufe, Datenänderungs- und Ereignis-Subscriptions mit Deadbands und Where-Klauseln, ein zweiminütiger Publish-Lauf ohne verlorene oder doppelte Nachricht und jeder Wiederverbindungsweg des WatchDog.

Fragen zu Delphi OPC UA

Erstelle einen TsgcOPCUAClient, setze EndpointUrl auf die opc.tcp-Adresse des Servers, rufe Connect auf und dann ReadValue('ns=2;s=Line1.Speed'). Es liefert einen Variant. Read liest mehrere Knoten und Attribute in einem Aufruf.

Rufe CreateSubscription mit dem Publishing-Intervall auf, füge die Knoten mit AddMonitoredItem hinzu und weise OnDataChange zu. Das Ereignis erhält die Subscription, das Monitored Item und den neuen TsgcOPCUADataValue mit Statuscode und Zeitstempeln.

Basic256Sha256, Aes128_Sha256_RsaOaep und Aes256_Sha256_RsaPss im Modus Sign oder SignAndEncrypt, dazu die veralteten Basic128Rsa15 und Basic256 für ältere Server sowie None für Testaufbauten.

Mit WatchDog.Enabled versucht der Client es alle WatchDog.Interval Sekunden erneut. Er aktiviert dieselbe Session wieder, wenn der Server sie noch hat, andernfalls öffnet er eine neue Session und überträgt oder erstellt die Subscriptions neu. OnReconnect meldet, welcher Weg genommen wurde, und deine Subscription-Objekte bleiben gültig.

Ja. Setze NotifyEvents := neNoSync, wenn es keine Nachrichtenschleife gibt: Die Ereignisse laufen dann in den Client-Threads. Rufe aus diesen Ereignissen weder Connect noch andere blockierende Services auf; lasse WatchDog die Wiederverbindung übernehmen.

Delphi 7 bis Delphi 13 und C++Builder, unter Windows (32 und 64 Bit) und Linux 64 Bit.

Der OPC UA Client ist in sgcWebSockets Enterprise (Delphi und .NET) und All-Access oder im eigenständigen Paket sgcIndustrial enthalten. Nicht enthalten sind ein OPC UA Server, die Transporte HTTPS, JSON und WebSocket, HistoryRead, PubSub, Reverse Connect und der Global Discovery Server.

Weitere industrielle Komponenten in sgcWebSockets

Industrielle Komponenten

Serial Port, Modbus und OPC UA in einem Bereich, mit der vollständigen Komponentenreferenz.

OPC UA Client Referenz

Eigenschaften, Methoden und Ereignisse von TsgcOPCUAClient, mit C++Builder- und C#-Beispielen.

Delphi Modbus TCP und RTU

Modbus-Clients und -Server für die Geräte, die kein OPC UA sprechen.

Delphi MQTT Client

Leite OPC UA Datenänderungen an MQTT-Topics weiter: das übliche Gateway von der Anlage in die Cloud.

Auch für C# und .NET

Derselbe OPC UA Client, mit denselben Klassennamen, für .NET 8, 9, 10 und .NET Standard 2.0.

Bestes Preis-Leistungs-Verhältnis: All-AccessAlle eSeGeCe-Produkte, inklusive Premium-Support, ab €1,059 pro Jahr.
All-Access-Preise ansehen

Lies deinen ersten OPC UA Knoten aus Delphi

Enthalten in sgcWebSockets Enterprise (Delphi und .NET) und All-Access oder im eigenständigen Paket sgcIndustrial.