OPC UA İstemcisi

Delphi, C++Builder ve .NET uygulamalarını bir OPC UA sunucusu çalıştıran PLC'lere, SCADA sistemlerine ve ağ geçitlerine bağlayın: imzalı ve şifreli bir opc.tcp bağlantısı üzerinden adres alanında gezinin, değişkenleri okuyun ve yazın, metotları çağırın ve veri değişikliklerine ile olaylara abone olun.

Yeni

TsgcOPCUAClient

OPC UA'nın istemci tarafının tamamı için tek bir bileşen: güvenli kanal, oturum, hizmetler ve abonelikler.

Bileşen sınıfı

TsgcOPCUAClient

Protokol

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

Güvenlik

Basic256Sha256, Aes128_Sha256_RsaOaep ve Aes256_Sha256_RsaPss ile Sign ve SignAndEncrypt; Anonymous, kullanıcı adı ve X.509 kimlikleri

Sürüm

sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır

Bağlanın, okuyun ve yazın

EndpointUrl değerini ayarlayın, güvenlik politikasını ve modunu seçin ve Connect çağırın. Her hizmet çağrısı, sunucu yanıtlayana kadar engeller ve başarısız olduğunda OPC UA durum koduyla EsgcOPCUAError oluşturur.

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);
    }
}

İçeriğinde neler var

Güvenli kanalı, oturumu ve yayın döngüsünü bileşen yönetir, bu yüzden kodunuz düğüm kimlikleri ve değerlerle çalışır.

Hizmetler

GetEndpoints, Browse ve BrowseNext (devam noktaları sizin için izlenir), TranslateBrowsePath, herhangi bir özniteliğin Read ve Write işlemleri ve metotlar için Call. ReadValue ve WriteValue bir düğüm kimliği dizesi alır ve düğümün veri tipini kullanır.

Güvenlik politikaları

Basic256Sha256, Aes128_Sha256_RsaOaep ve Aes256_Sha256_RsaPss, ayrıca eski sunucular için kullanımdan kaldırılmış Basic128Rsa15 ve Basic256, Sign ya da SignAndEncrypt modunda. İstemci sunucu imzasını ve nonce değerini denetler ve yolda değiştirilmiş bir uç nokta listesini reddeder.

Kullanıcı kimliği

Anonymous, kullanıcı adı ve parola (belirteç politikası istediğinde sunucu anahtarıyla şifrelenir) ya da özel anahtarınızla imzalanmış bir X.509 kullanıcı sertifikası.

Sertifikalar

Uygulama örneği sertifikası DER ya da PEM dosyalarından yüklenir, ilk bağlantıda oluşturulup bu dosyalara kaydedilir ya da dosya ayarlanmamışsa bellekte oluşturulur. Bir sunucu sertifikası, OnValidateServerCertificate kabul etmedikçe reddedilir.

Abonelikler

Örnekleme aralığı, kuyruk boyutu, mutlak ya da yüzde ölü bant ve tetikleyici ile veri değişikliği öğeleri; seçim yan tümceleri ve isteğe bağlı bir where yan tümcesi ile olay öğeleri. Onayları ve eksik bildirimlerin yeniden yayımlanmasını istemci yapar.

Otomatik yeniden bağlanma

WatchDog, bir ağ kopmasından sonra Delphi, C++Builder ve .NET'te yeniden bağlanır: aynı oturumu yeniden etkinleştirir ve kaçırılanları yeniden yayımlar ya da abonelikleri yeni bir oturuma aktarır veya yeniden oluşturur. OnReconnect hangi yolun izlendiğini bildirir.

Sunucunun ilettiği veri değişiklikleri ve olaylar

Bir abonelik oluşturun, izlenecek öğeleri ekleyin ve OnDataChange olayını işleyin. Değerler, seçtiğiniz yayın aralığında yoklama yapmadan gelir.

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);
    }
}

İmzalı ve şifreli bağlantılar

Politikayı ve modu seçin, istemciye uygulama sertifikasını ve bir kullanıcı kimliği verin ve hangi sunucu sertifikalarına güveneceğinize karar verin.

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);
    }
}

Spesifikasyonlar ve referanslar

Bu bileşenin uyguladığı protokol için yetkili kaynaklar.

OPC UA istemcisi soruları

opc.tcp uç noktasına sahip her OPC UA sunucusuna: yerleşik sunucusu olan PLC'ler ve denetleyiciler, SCADA ve MES sistemleri ve protokol ağ geçitleri. İstemci, bağımsız bir açık kaynaklı OPC UA yığını olan asyncua üzerine kurulu bir referans sunucuya karşı, on bir uç noktasının tamamında test edilmiştir.

Browse ile Objects klasöründen (i=85) gezinin ya da /2:Line1/2:Speed gibi bir yolu TranslateBrowsePath ile çözün. Düğüm kimlikleri metin olarak yazılır: bir dize kimliği için ns=2;s=Line1.Speed, ad alanı 0'daki sayısal bir kimlik için i=2258.

Varsayılan opcspNone değeridir ve çoğu sunucu buna yalnızca test için izin verir. İmzalamak ya da şifrelemek için SecurityPolicy ve SecurityMode değerlerini ayarlayın. Sunucu sertifikaları, OnValidateServerCertificate kabul etmedikçe reddedilir; Basic128Rsa15 ve Basic256 kullanımdan kaldırılmıştır ve yalnızca eski sunucular için korunur.

Evet, WatchDog.Enabled değerini ayarlayın: istemci oturumu yeniden etkinleştirir ve kaçırılan bildirimleri yeniden yayımlar ya da yeni bir oturum açar ve abonelikleri aktarır veya yeniden oluşturur. Delphi, C++Builder ve .NET'te aynı şekilde çalışır ve OnReconnect hangi yolun izlendiğini bildirir.

Bileşen, binary kodlamalı opc.tcp üzerinden bir OPC UA istemcisidir. Bir OPC UA sunucusunu, HTTPS, JSON ve WebSocket taşımalarını, HistoryRead, PubSub, Reverse Connect ve Global Discovery Server'ı içermez.

sgcIndustrial paketinin bir parçası olarak sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access içinde yer alır. Delphi'de sgcIndustrial birimini uses yan tümcesine ekleyin.

Belgeler ve Demolar

Bileşen başvurusuna doğrudan gidin, demo projesini açın ve teknik belgeyi okuyun.

Online Help: TsgcOPCUAClient OPC UA istemcisi için tam özellik, metot ve olay referansı.
Online Help: OPC UA Subscriptions İzlenen öğeler, ölü bantlar, olay filtreleri, canlı tutma ve yeniden bağlanma davranışı.
Demo Projesi: Industrial\05.OPCUA_Client Delphi, C++Builder ve .NET için bir OPC UA istemcisi. sgcWebSockets paketinin içinde gelir.
Teknik Belge (PDF) Yalnızca bu bileşene ait özellikler, hızlı başlangıç, kod örnekleri ve birincil kaynak başvuruları.
Kullanıcı Kılavuzu (PDF) Kütüphanedeki her bileşeni kapsayan kapsamlı kılavuz.
En avantajlı seçenek: All-AccessTüm eSeGeCe ürünleri, Premium Destek dahil, yılda €1,059'dan itibaren.
All-Access fiyatlarına bakın

sgcWebSockets Enterprise içinde yer alır

sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır.