Een native OPC UA-client voor Delphi en C++Builder. Browse, lees en schrijf de variabelen van PLC's, SCADA-servers en industriële gateways, roep hun methoden aan en ontvang datawijzigingen en alarmen via subscriptions, over een ondertekende en versleutelde opc.tcp-verbinding die zichzelf herstelt.
Inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, of in het standalone pakket sgcIndustrial.
Secure channel, sessie, services en subscriptions in een niet-visuele component, geschreven in Pascal en gecompileerd in je toepassing.
Met een Delphi OPC UA-client kan een VCL-, FMX-, service- of consoletoepassing de data lezen die machines, PLC's en SCADA-systemen via een OPC UA-server publiceren, en setpoints en commando's terugschrijven. sgcWebSockets levert die als TsgcOPCUAClient: stel EndpointUrl in, kies SecurityPolicy en SecurityMode, roep Connect aan en werk met node-id's zoals ns=2;s=Line1.Speed of i=2253.
Service-aanroepen blokkeren tot de server antwoordt en geven EsgcOPCUAError met de OPC UA-statuscode als ze mislukken. ReadValue geeft een Delphi-Variant terug, en WriteValue leest eerst het datatype van de node, zodat WriteValue('ns=2;s=Line1.Setpoint', 75.5) een Float of een Double schrijft zoals de node verwacht. Eén regel uses sgcIndustrial; haalt de component, de types en de enumeraties binnen.
Componentklasse
TsgcOPCUAClient, met TsgcOPCUASubscription en TsgcOPCUAMonitoredItem
Transport
OPC UA binary over opc.tcp, het transport dat PLC's en SCADA-servers aanbieden
Beveiliging
Sign en SignAndEncrypt met Basic256Sha256, Aes128_Sha256_RsaOaep en Aes256_Sha256_RsaPss
Platformen
Delphi 7 tot Delphi 13 en C++Builder; Windows 32 en 64 bit en Linux 64 bit
Services
De OPC UA-services, elk één methode
Eenvoudige overloads nemen node-id-strings; volledige overloads nemen de request-records uit de specificatie.
Door de component afgehandeld: OnDataChange, OnEvent, OnKeepAlive, WatchDog
QuickStart
Lees een machine uit met een paar regels Delphi
Maak de component, stel het endpoint in, roep een methode aan. Elk voorbeeld op deze pagina compileert met Delphi 7 en 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);
excepton 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 := 0to Length(vRefs) - 1do
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);
beginif 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);
beginif aState = opccsReconnecting then
Memo1.Lines.Add('Connection lost, reconnecting');
end;
procedure TForm1.OnOPCUAReconnect(Sender: TObject; aMethod: TsgcOPCUAReconnectMethod);
begincase 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;
De hulpfuncties sgcOPCUANodeIdToString en sgcOPCUAVariantSimple staan in sgcOPCUA_Types, en sgcOPCUAVariantToDelphi in sgcOPCUA_Encoding; voeg die units toe als je ze gebruikt. Delphi 7 tot 2006 hebben ook sgcBase_Helpers nodig voor TBytes.
Client
Een OPC UA-client gebouwd voor de fabrieksvloer
Subscriptions, filters en opnieuw verbinden worden voor je afgehandeld, met events waar je ze wilt.
Subscriptions zonder polling
CreateSubscription stelt het publicatie-interval in, AddMonitoredItem het sampling-interval en de wachtrijgrootte van elke node. De component houdt voldoende Publish-verzoeken in omloop, bevestigt elke notificatie en vraagt de server om elk verloren bericht opnieuw te publiceren.
Deadband en triggers
Een absolute deadband (uadbtAbsolute) of een percentage van de EURange (uadbtPercent) houdt ruis uit je handlers. De trigger bepaalt of een statuswijziging, een waardewijziging of een nieuw tijdstempel wordt gemeld.
Events en alarmen
AddEventMonitoredItem neemt de terug te geven eventvelden, zoals Message, Severity en SourceName, en een optionele where-clausule. Abonneer op één bron of op het Server-object voor elk event van de server.
WatchDog-herverbinding
Na een netwerkonderbreking activeert WatchDog eerst dezelfde sessie opnieuw en publiceert de gemiste notificaties opnieuw. Is de sessie verdwenen, dan opent het een nieuwe en draagt de subscriptions over, of maakt ze opnieuw aan. OnReconnect meldt welk pad is gevolgd.
Dezelfde objecten na een herverbinding
Subscriptions en monitored items zijn eigendom van de client en overleven een WatchDog-herverbinding. Server-id's kunnen veranderen, de ClientHandle van een item nooit, zodat je handlers blijven werken.
Events waar je ze wilt hebben
OnDataChange, OnEvent, OnKeepAlive, OnConnect, OnDisconnect en OnError worden afgeleverd via NotifyEvents: standaard in de wachtrij van de hoofdthread, gesynchroniseerd, of direct in de clientthreads voor services en consoletoepassingen.
Beveiliging
Ondertekend en versleuteld, met veilige standaardwaarden
Stel SecurityPolicy in op opcspBasic256Sha256, opcspAes128_Sha256_RsaOaep of opcspAes256_Sha256_RsaPss en SecurityMode op opcsmSign of opcsmSignAndEncrypt. opcspBasic128Rsa15 en opcspBasic256 zijn door de OPC Foundation afgeraden en bestaan voor oudere servers. De client kiest het passende endpoint uit GetEndpoints en, als er geen past, noemt de fout wat de server aanbiedt.
Applicatiecertificaat
Application.CertificateFile en PrivateKeyFile laden het instantiecertificaat. Als de bestanden nog niet bestaan, maakt de client het certificaat aan en slaat het daar op, zodat de serverbeheerder het één keer vertrouwt. Zonder bestanden wordt het in het geheugen aangemaakt.
Servercertificaat
Een servercertificaat wordt geweigerd tenzij OnValidateServerCertificate het accepteert, zodat een nieuwe client nooit per ongeluk een onbekende server vertrouwt. AutoAcceptServerCertificate is er voor testopstellingen.
Gebruikersidentiteit
Authentication.AuthenticationType kiest tussen Anonymous, gebruikersnaam en wachtwoord, of een X.509-gebruikerscertificaat. Het wachtwoord wordt versleuteld met de serversleutel wanneer het tokenbeleid van de server dat vraagt.
Interoperabiliteit
Getest tegen een onafhankelijke OPC UA-stack
De client is op de lijn getest tegen een referentieserver gebouwd op asyncua, een onafhankelijke open-source OPC UA-implementatie: alle elf endpoints van de server (elk beleid en elke modus), de drie identiteitstypen, het browsen van 1.000 referenties met continuation points, het lezen van 18 ingebouwde types met arrays en een matrix, het schrijven van scalars en arrays, methode-aanroepen, subscriptions voor datawijzigingen en events met deadbands en where-clausules, een publicatierun van twee minuten zonder verloren of dubbel bericht, en elk herverbindingspad van de WatchDog.
FAQ
Vragen over Delphi OPC UA
Maak een TsgcOPCUAClient, stel EndpointUrl in op het opc.tcp-adres van de server, roep Connect aan en daarna ReadValue('ns=2;s=Line1.Speed'). Het geeft een Variant terug. Read leest meerdere nodes en attributen in één aanroep.
Roep CreateSubscription aan met het publicatie-interval, voeg de nodes toe met AddMonitoredItem en wijs OnDataChange toe. Het event ontvangt de subscription, het monitored item en de nieuwe TsgcOPCUADataValue met statuscode en tijdstempels.
Basic256Sha256, Aes128_Sha256_RsaOaep en Aes256_Sha256_RsaPss in de modus Sign of SignAndEncrypt, plus de afgeraden Basic128Rsa15 en Basic256 voor oudere servers, en None voor testopstellingen.
Met WatchDog.Enabled probeert de client het elke WatchDog.Interval seconden opnieuw. Het activeert dezelfde sessie opnieuw als de server die nog heeft, anders opent het een nieuwe sessie en draagt de subscriptions over of maakt ze opnieuw aan. OnReconnect meldt welk pad is gevolgd, en je subscription-objecten blijven geldig.
Ja. Stel NotifyEvents := neNoSync in als er geen berichtenlus is: de events draaien dan in de clientthreads. Roep vanuit die events geen Connect of andere blokkerende services aan; laat WatchDog opnieuw verbinden.
Delphi 7 tot Delphi 13 en C++Builder, op Windows (32 en 64 bit) en Linux 64 bit.
De OPC UA-client is inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, of in het standalone pakket sgcIndustrial. Hij bevat geen OPC UA-server, de HTTPS-, JSON- en WebSocket-transporten, HistoryRead, PubSub, Reverse Connect en de Global Discovery Server.