OPC UA-client

Koppel Delphi-, C++Builder- en .NET-toepassingen aan PLC's, SCADA-systemen en gateways met een OPC UA-server: doorzoek de adresruimte, lees en schrijf variabelen, roep methoden aan en abonneer je op gegevenswijzigingen en events via een ondertekende en versleutelde opc.tcp-verbinding.

Nieuw

TsgcOPCUAClient

Eén component voor de hele clientkant van OPC UA: secure channel, sessie, services en abonnementen.

Componentklasse

TsgcOPCUAClient

Protocol

OPC UA binary over opc.tcp (UA TCP, UA Secure Conversation, UA Binary encoding)

Beveiliging

Sign en SignAndEncrypt met Basic256Sha256, Aes128_Sha256_RsaOaep en Aes256_Sha256_RsaPss; Anonymous-, gebruikersnaam- en X.509-identiteiten

Editie

Inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, of in het standalone pakket sgcIndustrial

Verbinden, lezen en schrijven

Stel EndpointUrl in, kies het beveiligingsbeleid en de modus en roep Connect aan. Elke service-aanroep blokkeert tot de server antwoordt en veroorzaakt EsgcOPCUAError, met de OPC UA-statuscode, wanneer het mislukt.

uses
  sgcIndustrial;

procedure TForm1.ConnectAndRead;
begin
  FClient := TsgcOPCUAClient.Create(Self);
  FClient.EndpointUrl := 'opc.tcp://192.168.1.60:4840';
  FClient.SecurityPolicy := opcspNone;
  FClient.SecurityMode := opcsmNone;
  FClient.OnError := OnOPCUAError;
  FClient.Connect;
  // read the Value attribute of a variable
  Memo1.Lines.Add('Temperature: ' + VarToStr(FClient.ReadValue('ns=2;s=Line1.Temperature')));
  // the data type of the node is read first and used for the written value
  FClient.WriteValue('ns=2;s=Line1.Setpoint', 75.5);
end;

procedure TForm1.OnOPCUAError(Sender: TObject; aStatusCode: Cardinal; const aError: string);
begin
  Memo1.Lines.Add('Error: ' + aError);
end;
#include "sgcIndustrial.hpp"

void __fastcall TForm1::ConnectAndRead()
{
  FClient = new TsgcOPCUAClient(this);
  FClient->EndpointUrl = "opc.tcp://192.168.1.60:4840";
  FClient->SecurityPolicy = opcspNone;
  FClient->SecurityMode = opcsmNone;
  FClient->OnError = OnOPCUAError;
  FClient->Connect();
  // read the Value attribute of a variable
  Memo1->Lines->Add("Temperature: " + VarToStr(FClient->ReadValue("ns=2;s=Line1.Temperature")));
  // the data type of the node is read first and used for the written value
  FClient->WriteValue("ns=2;s=Line1.Setpoint", 75.5);
}

void __fastcall TForm1::OnOPCUAError(TObject *Sender, unsigned aStatusCode, const String aError)
{
  Memo1->Lines->Add("Error: " + aError);
}
using System;
using esegece.sgcWebSockets;

class PlantReader
{
    TsgcOPCUAClient FClient = new TsgcOPCUAClient();

    public void ConnectAndRead()
    {
        FClient.EndpointUrl = "opc.tcp://192.168.1.60:4840";
        FClient.SecurityPolicy = TsgcOPCUASecurityPolicy.opcspNone;
        FClient.SecurityMode = TsgcOPCUAMessageSecurityMode.opcsmNone;
        FClient.OnError += OnOPCUAError;
        FClient.Connect();
        // read the Value attribute of a variable
        Console.WriteLine("Temperature: " + FClient.ReadValue("ns=2;s=Line1.Temperature"));
        // the data type of the node is read first and used for the written value
        FClient.WriteValue("ns=2;s=Line1.Setpoint", 75.5);
    }

    void OnOPCUAError(object Sender, uint aStatusCode, string aError)
    {
        Console.WriteLine("Error: " + aError);
    }
}

Wat zit erin

Het secure channel, de sessie en de publish-lus worden door de component afgehandeld, zodat je code met node-id's en waarden werkt.

Services

GetEndpoints, Browse en BrowseNext (continuation points worden voor je gevolgd), TranslateBrowsePath, Read en Write van elk attribuut, en Call voor methoden. ReadValue en WriteValue nemen een node-id-string en gebruiken het gegevenstype van de node.

Beveiligingsbeleid

Basic256Sha256, Aes128_Sha256_RsaOaep en Aes256_Sha256_RsaPss, plus de verouderde Basic128Rsa15 en Basic256 voor oudere servers, in de modus Sign of SignAndEncrypt. De client controleert de handtekening en nonce van de server en weigert een endpointlijst die onderweg is gewijzigd.

Gebruikersidentiteit

Anonymous, gebruikersnaam en wachtwoord (versleuteld met de serversleutel wanneer het tokenbeleid dat vraagt) of een X.509-gebruikerscertificaat dat met je privésleutel is ondertekend.

Certificaten

Het certificaat van de toepassingsinstantie wordt geladen uit DER- of PEM-bestanden, bij de eerste verbinding aangemaakt en in die bestanden opgeslagen, of in het geheugen aangemaakt wanneer er geen bestand is ingesteld. Een servercertificaat wordt geweigerd tenzij OnValidateServerCertificate het accepteert.

Abonnementen

Data change-items met sampling-interval, wachtrijgrootte, absolute of procentuele deadband en trigger; event-items met select-clausules en een optionele where-clausule. Bevestigingen en het opnieuw publiceren van gemiste notificaties worden door de client afgehandeld.

Automatisch opnieuw verbinden

WatchDog maakt opnieuw verbinding na een netwerkonderbreking, in Delphi, C++Builder en .NET: het heractiveert dezelfde sessie en publiceert wat gemist is opnieuw, of draagt de abonnementen over of maakt ze opnieuw aan in een nieuwe sessie. OnReconnect geeft aan welk pad is gevolgd.

Gegevenswijzigingen en events, door de server gepusht

Maak een abonnement, voeg de te bewaken items toe en verwerk OnDataChange. De waarden komen binnen zonder polling, met het publicatie-interval dat je kiest.

procedure TForm1.Subscribe;
var
  oSubscription: TsgcOPCUASubscription;
begin
  FClient.OnDataChange := OnOPCUADataChange;
  // publishing interval 500 ms
  oSubscription := FClient.CreateSubscription(500);
  // sampling 250 ms, queue of 1, report changes larger than 0.5 only
  FClient.AddMonitoredItem(oSubscription, 'ns=2;s=Line1.Temperature', 250, 1, True,
    uadbtAbsolute, 0.5);
  FClient.AddMonitoredItem(oSubscription, 'ns=2;s=Line1.Pressure');
end;

procedure TForm1.OnOPCUADataChange(Sender: TObject; aSubscription: TsgcOPCUASubscription;
  aMonitoredItem: TsgcOPCUAMonitoredItem; const aValue: TsgcOPCUADataValue);
begin
  if (aValue.StatusCode and $80000000) = 0 then
    Memo1.Lines.Add('Item ' + IntToStr(aMonitoredItem.ClientHandle) + ': ' +
      VarToStr(aValue.Value.Value));
end;
void __fastcall TForm1::Subscribe()
{
  FClient->OnDataChange = OnOPCUADataChange;
  // publishing interval 500 ms
  TsgcOPCUASubscription *oSubscription = FClient->CreateSubscription(500);
  // sampling 250 ms, queue of 1, report changes larger than 0.5 only
  FClient->AddMonitoredItem(oSubscription, "ns=2;s=Line1.Temperature", 250, 1, true,
    uadbtAbsolute, 0.5);
  FClient->AddMonitoredItem(oSubscription, "ns=2;s=Line1.Pressure");
}

void __fastcall TForm1::OnOPCUADataChange(TObject *Sender, TsgcOPCUASubscription *aSubscription,
  TsgcOPCUAMonitoredItem *aMonitoredItem, const TsgcOPCUADataValue &aValue)
{
  if ((aValue.StatusCode & 0x80000000) == 0)
    Memo1->Lines->Add("Item " + IntToStr((int)aMonitoredItem->ClientHandle) + ": " +
      VarToStr(aValue.Value.Value));
}
using System;
using esegece.sgcWebSockets;

class PlantMonitor
{
    public void Subscribe(TsgcOPCUAClient aClient)
    {
        aClient.OnDataChange += OnOPCUADataChange;
        // publishing interval 500 ms
        TsgcOPCUASubscription oSubscription = aClient.CreateSubscription(500);
        // sampling 250 ms, queue of 1, report changes larger than 0.5 only
        aClient.AddMonitoredItem(oSubscription, "ns=2;s=Line1.Temperature", 250, 1, true,
            TsgcOPCUADeadbandType.uadbtAbsolute, 0.5);
        aClient.AddMonitoredItem(oSubscription, "ns=2;s=Line1.Pressure");
    }

    void OnOPCUADataChange(object Sender, TsgcOPCUASubscription aSubscription,
        TsgcOPCUAMonitoredItem aMonitoredItem, TsgcOPCUADataValue aValue)
    {
        if ((aValue.StatusCode & 0x80000000) == 0)
            Console.WriteLine("Item " + aMonitoredItem.ClientHandle + ": " + aValue.Value.Value);
    }
}

Ondertekende en versleutelde verbindingen

Kies het beleid en de modus, geef de client zijn toepassingscertificaat en een gebruikersidentiteit, en bepaal welke servercertificaten je vertrouwt.

uses
  sgcIndustrial; // Delphi 7 to 2006: add sgcBase_Helpers (TBytes)

procedure TForm1.ConnectSecure;
begin
  FClient := TsgcOPCUAClient.Create(Self);
  FClient.EndpointUrl := 'opc.tcp://192.168.1.60:4840';
  FClient.SecurityPolicy := opcspBasic256Sha256;
  FClient.SecurityMode := opcsmSignAndEncrypt;
  // application instance certificate: created and saved on the first run
  FClient.Application.ApplicationName := 'Line1 Monitor';
  FClient.Application.CertificateFile := 'C:\pki\own\client.der';
  FClient.Application.PrivateKeyFile := 'C:\pki\own\client.pem';
  // user identity
  FClient.Authentication.AuthenticationType := opcatUserName;
  FClient.Authentication.User := 'operator';
  FClient.Authentication.Password := 'secret';
  // decide which server certificates you trust
  FClient.OnValidateServerCertificate := OnOPCUAValidateServerCertificate;
  FClient.Connect;
end;

procedure TForm1.OnOPCUAValidateServerCertificate(Sender: TObject;
  const aCertificate: TBytes; var aAccept: Boolean);
begin
  // FTrusted holds the DER bytes of the server certificate you trust
  aAccept := (Length(aCertificate) > 0) and (Length(aCertificate) = Length(FTrusted)) and
    CompareMem(@aCertificate[0], @FTrusted[0], Length(aCertificate));
end;
void __fastcall TForm1::ConnectSecure()
{
  FClient = new TsgcOPCUAClient(this);
  FClient->EndpointUrl = "opc.tcp://192.168.1.60:4840";
  FClient->SecurityPolicy = opcspBasic256Sha256;
  FClient->SecurityMode = opcsmSignAndEncrypt;
  // application instance certificate: created and saved on the first run
  FClient->Application->ApplicationName = "Line1 Monitor";
  FClient->Application->CertificateFile = "C:\\pki\\own\\client.der";
  FClient->Application->PrivateKeyFile = "C:\\pki\\own\\client.pem";
  // user identity
  FClient->Authentication->AuthenticationType = opcatUserName;
  FClient->Authentication->User = "operator";
  FClient->Authentication->Password = "secret";
  // decide which server certificates you trust
  FClient->OnValidateServerCertificate = OnOPCUAValidateServerCertificate;
  FClient->Connect();
}

void __fastcall TForm1::OnOPCUAValidateServerCertificate(TObject *Sender,
  const TBytes aCertificate, bool &aAccept)
{
  // FTrusted holds the DER bytes of the server certificate you trust
  aAccept = (aCertificate.Length > 0) && (aCertificate.Length == FTrusted.Length) &&
    CompareMem((void*)&aCertificate[0], &FTrusted[0], aCertificate.Length);
}
using System.IO;
using System.Linq;
using esegece.sgcWebSockets;

class SecureClient
{
    TsgcOPCUAClient FClient = new TsgcOPCUAClient();
    // DER bytes of the server certificate you trust
    byte[] FTrusted = File.ReadAllBytes(@"C:\pki\trusted\server.der");

    public void ConnectSecure()
    {
        FClient.EndpointUrl = "opc.tcp://192.168.1.60:4840";
        FClient.SecurityPolicy = TsgcOPCUASecurityPolicy.opcspBasic256Sha256;
        FClient.SecurityMode = TsgcOPCUAMessageSecurityMode.opcsmSignAndEncrypt;
        // application instance certificate: created and saved on the first run
        FClient.Application.ApplicationName = "Line1 Monitor";
        FClient.Application.CertificateFile = @"C:\pki\own\client.der";
        FClient.Application.PrivateKeyFile = @"C:\pki\own\client.pem";
        // user identity
        FClient.Authentication.AuthenticationType = TsgcOPCUAAuthenticationType.opcatUserName;
        FClient.Authentication.User = "operator";
        FClient.Authentication.Password = "secret";
        // decide which server certificates you trust
        FClient.OnValidateServerCertificate += OnOPCUAValidateServerCertificate;
        FClient.Connect();
    }

    void OnOPCUAValidateServerCertificate(object Sender, byte[] aCertificate, ref bool aAccept)
    {
        aAccept = aCertificate != null && aCertificate.SequenceEqual(FTrusted);
    }
}

Specificaties & referenties

Gezaghebbende bronnen voor het protocol dat deze component implementeert.

Vragen over de OPC UA-client

Met elke OPC UA-server met een opc.tcp-endpoint: PLC's en controllers met een ingebouwde server, SCADA- en MES-systemen en protocolgateways. De client is getest tegen een referentieserver gebouwd op asyncua, een onafhankelijke open-source OPC UA-stack, op al zijn elf endpoints.

Browse vanaf de map Objects (i=85) met Browse, of los een pad zoals /2:Line1/2:Speed op met TranslateBrowsePath. Node-id's worden als tekst geschreven: ns=2;s=Line1.Speed voor een string-id, i=2258 voor een numerieke id in namespace 0.

De standaardwaarde is opcspNone, wat de meeste servers alleen voor tests toestaan. Stel SecurityPolicy en SecurityMode in om te ondertekenen of te versleutelen. Servercertificaten worden geweigerd tenzij OnValidateServerCertificate ze accepteert, en Basic128Rsa15 en Basic256 zijn verouderd en worden alleen voor oudere servers bewaard.

Ja, zet WatchDog.Enabled aan: de client heractiveert de sessie en publiceert de gemiste notificaties opnieuw, of opent een nieuwe sessie en draagt de abonnementen over of maakt ze opnieuw aan. Het werkt hetzelfde in Delphi, C++Builder en .NET, en OnReconnect geeft aan welk pad is gevolgd.

De component is een OPC UA-client via opc.tcp met de binaire codering. Hij bevat geen OPC UA-server, geen HTTPS-, JSON- en WebSocket-transporten, geen HistoryRead, PubSub, Reverse Connect en Global Discovery Server.

Het is inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, als onderdeel van het sgcIndustrial-pakket. Voeg in Delphi sgcIndustrial toe aan de uses-clausule.

Documentatie & demo's

Spring direct naar de componentreferentie, open het demoproject en lees het technische document.

Online Help: TsgcOPCUAClient Volledige referentie van eigenschappen, methoden en events voor de OPC UA-client.
Online Help: OPC UA Subscriptions Bewaakte items, deadbands, eventfilters, keep-alive en gedrag bij opnieuw verbinden.
Demoproject: Industrial\05.OPCUA_Client Een OPC UA-client voor Delphi, C++Builder en .NET. Wordt meegeleverd in het sgcWebSockets-pakket.
Technisch document (PDF) Functies, snelstart, codevoorbeelden en primaire bronnen voor alleen deze component.
Gebruikershandleiding (PDF) Uitgebreide handleiding die elke component in de bibliotheek behandelt.
De beste deal: All-AccessElk eSeGeCe-product, inclusief Premium-ondersteuning, vanaf €1,059 per jaar.
Bekijk de All-Access-prijzen

Inbegrepen in sgcWebSockets Enterprise

Inbegrepen in sgcWebSockets Enterprise (Delphi en .NET) en All-Access, of in het standalone pakket sgcIndustrial.