C# ve .NET Yeni

.NET için C# OPC UA İstemci Kitaplığı

PLC'lerin, SCADA sistemlerinin ve ağ geçitlerinin OPC UA sunucularında gezinin, onları okuyun, yazın ve bunlara abone olun; hepsi C# ile, imzalı ve şifreli bir opc.tcp bağlantısı üzerinden.

opc.tcp üzerinden OPC UA binary
Aes256_Sha256_RsaPss'e kadar Sign ve SignAndEncrypt
Veri değişikliği ve olay abonelikleri
Anonymous, kullanıcı adı ve X.509 kimlikleri

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

C# ile okuyun ve abone olun → · OPC UA SSS →

C# OPC UA istemcisi
using System;
using esegece.sgcWebSockets;

var opcua = new TsgcOPCUAClient();
opcua.EndpointUrl = "opc.tcp://192.168.1.60:4840";
opcua.Connect();
Console.WriteLine(opcua.ReadValue("ns=2;s=Line1.Temperature"));
opcua.WriteValue("ns=2;s=Line1.Setpoint", 75.5);
opcua.Disconnect();

.NET uygulamaları için bir OPC UA istemcisi

Güvenli kanal, oturum, hizmetler ve abonelikler; Delphi bileşeniyle aynı API'ye sahip tek bir sınıfta.

sgcWebSockets .NET içindeki C# OPC UA istemcisi, esegece.sgcIndustrial paketinin, esegece.sgcWebSockets ad alanının parçası olan TsgcOPCUAClient sınıfıdır. EndpointUrl ayarlayın, SecurityPolicy ve SecurityMode seçin, Connect çağırın ve ns=2;s=Line1.Speed gibi düğüm kimlikleriyle çalışın. ReadValue değeri düz bir .NET nesnesi olarak döndürür (türlü diziler, matris için double[,]) ve WriteValue önce düğümün veri türünü okur; böylece değer sunucunun beklediği gibi kodlanır.

Her hizmet çağrısı eşzamanlıdır ve başarısız olduğunda, StatusCode alanında OPC UA durum kodunu taşıyan EsgcOPCUAError fırlatır. Abonelikler veri değişikliklerini ve olayları OnDataChange ve OnEvent aracılığıyla işleyicilerinize iletir. Paket .NET 8, .NET 9, .NET 10 ve .NET Standard 2.0 hedefler.

Hizmetler

GetEndpoints, Browse, BrowseNext, TranslateBrowsePath, Read, Write ve Call.

Abonelikler

Deadband ve kuyruk boyutlu veri değişikliği öğeleri, select ve where koşullu olay öğeleri.

Güvenlik

Sign veya SignAndEncrypt modunda Basic256Sha256, Aes128_Sha256_RsaOaep ve Aes256_Sha256_RsaPss.

Kimlikler

Anonymous, kullanıcı adı ve parola veya bir X.509 kullanıcı sertifikası.

Adım adım C# ile OPC UA

esegece.sgcIndustrial paketine başvurun, bağlanın, ardından okuyun, gezinin veya abone olun. Bu sayfadaki her örnek .NET 8 ile derlenir.

using System;
using esegece.sgcWebSockets;

var opcua = new TsgcOPCUAClient();
opcua.EndpointUrl = "opc.tcp://192.168.1.60:4840";
opcua.Connect();
try
{
    Console.WriteLine("Speed: " + opcua.ReadValue("ns=2;s=Line1.Speed"));
    // write with an explicit built-in type
    opcua.WriteValue("ns=2;s=Line1.Mode", (ushort)2, TsgcOPCUABuiltInType.uabtUInt16);
}
catch (EsgcOPCUAError e)
{
    Console.WriteLine($"Status 0x{e.StatusCode:X8}: {e.Message}");
}
finally
{
    opcua.Disconnect();
}
using System;
using esegece.sgcWebSockets;
using static esegece.sgcWebSockets.sgcOPCUA_Types;

var opcua = new TsgcOPCUAClient();
opcua.EndpointUrl = "opc.tcp://192.168.1.60:4840";
opcua.Connect();
// i=85 is the Objects folder
foreach (TsgcOPCUAReferenceDescription item in opcua.Browse("i=85"))
    Console.WriteLine(item.DisplayName.Text + " = " + sgcOPCUANodeIdToString(item.NodeId.NodeId));
// resolve a browse path to a node id
TsgcOPCUANodeId speed = opcua.TranslateBrowsePath("i=85", "/2:Line1/2:Speed");
Console.WriteLine(sgcOPCUANodeIdToString(speed));
// call a method with two Int32 arguments
TsgcOPCUAVariant[] outputs = opcua.Call("ns=2;s=Methods", "ns=2;s=Methods.Add", new[] {
    sgcOPCUAVariantSimple(TsgcOPCUABuiltInType.uabtInt32, 2),
    sgcOPCUAVariantSimple(TsgcOPCUABuiltInType.uabtInt32, 3) });
Console.WriteLine("Result: " + outputs[0].Value);
opcua.Disconnect();
using System;
using esegece.sgcWebSockets;
using static esegece.sgcWebSockets.sgcOPCUA_Encoding;

class LineMonitor
{
    public void Start(TsgcOPCUAClient aClient)
    {
        aClient.OnDataChange += OnOPCUADataChange;
        aClient.OnEvent += OnOPCUAEvent;
        TsgcOPCUASubscription subscription = aClient.CreateSubscription(500);
        // report changes larger than 0.5 only
        aClient.AddMonitoredItem(subscription, "ns=2;s=Line1.Temperature", 250, 1, true,
            TsgcOPCUADeadbandType.uadbtAbsolute, 0.5);
        // i=2253 is the Server object, which reports the events of the whole server
        aClient.AddEventMonitoredItem(subscription, "i=2253", new[] { "Message", "Severity", "SourceName" });
    }

    void OnOPCUADataChange(object Sender, TsgcOPCUASubscription aSubscription,
        TsgcOPCUAMonitoredItem aMonitoredItem, TsgcOPCUADataValue aValue)
    {
        Console.WriteLine("Temperature: " + aValue.Value.Value);
    }

    void OnOPCUAEvent(object Sender, TsgcOPCUASubscription aSubscription,
        TsgcOPCUAMonitoredItem aMonitoredItem, TsgcOPCUAVariant[] aEventFields)
    {
        // the fields arrive in the order of the select clauses
        Console.WriteLine(sgcOPCUAVariantToValue(aEventFields[2]) + " (" +
            sgcOPCUAVariantToValue(aEventFields[1]) + "): " + sgcOPCUAVariantToValue(aEventFields[0]));
    }
}
using System.IO;
using System.Linq;
using esegece.sgcWebSockets;

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

    public TsgcOPCUAClient Connect()
    {
        var opcua = new TsgcOPCUAClient();
        opcua.EndpointUrl = "opc.tcp://192.168.1.60:4840";
        opcua.SecurityPolicy = TsgcOPCUASecurityPolicy.opcspAes256_Sha256_RsaPss;
        opcua.SecurityMode = TsgcOPCUAMessageSecurityMode.opcsmSignAndEncrypt;
        // no certificate files set: the application certificate is created in memory
        // X.509 user identity
        opcua.Authentication.AuthenticationType = TsgcOPCUAAuthenticationType.opcatCertificate;
        opcua.Authentication.CertificateFile = @"C:\pki\user\operator.der";
        opcua.Authentication.PrivateKeyFile = @"C:\pki\user\operator.pem";
        opcua.OnValidateServerCertificate += OnOPCUAValidateServerCertificate;
        opcua.WatchDog.Enabled = true;   // reconnect after a network drop
        opcua.Connect();
        return opcua;
    }

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

Hizmet çağrıları eşzamanlıdır. Bir WinForms, WPF veya ASP.NET uygulamasında bunları bir çalışan iş parçacığından veya Task.Run içinden çağırın. Abonelik olayları NotifyEvents aracılığıyla tetiklenir: varsa arayüz iş parçacığında, yoksa iş parçacığı havuzunda sırayla.

Desteklenen OPC UA hizmetleri

Basit aşırı yüklemeler düğüm kimliği dizelerini alır; tam aşırı yüklemeler spesifikasyonun istek sınıflarını alır.

Hizmet kümesiHizmetC# metodu
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
MetotCallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptionsİstemci tarafından yapılır: OnDataChange, OnEvent, OnKeepAlive, WatchDog

Üretim için geliştirilmiş bir OPC UA istemcisi

Yayın döngüsü ele alınır

İstemci yeterli sayıda Publish isteğini uçuşta tutar, her bildirimi onaylar, kaybolan bir mesajı sunucudan yeniden yayınlamasını ister ve yinelenenleri atar; böylece işleyicileriniz her değeri bir kez görür.

Deadband ve kuyruklar

AddMonitoredItem, düğüm başına örnekleme aralığını, kuyruk boyutunu ve mutlak veya yüzde deadband değerini ayarlar. ModifyMonitoredItem bunları sonradan değiştirir ve SetPublishingMode bir aboneliği duraklatır.

Olaylar ve alarmlar

AddEventMonitoredItem, seçtiğiniz olay alanlarını (Message, Severity ve SourceName gibi) isteğe bağlı bir where koşuluyla filtreleyerek döndürür.

Sertifikalar

Uygulama sertifikası DER veya PEM dosyalarından yüklenir, ilk bağlantıda oluşturulup kaydedilir veya bellekte oluşturulur. Bir sunucu sertifikası, OnValidateServerCertificate kabul etmedikçe reddedilir.

Otomatik yeniden bağlanma

Bir ağ kesintisinden sonra WatchDog önce aynı oturumu yeniden etkinleştirir ve kaçırılan bildirimleri yeniden yayınlar. Oturum kaybolmuşsa yeni bir tane açar ve abonelikleri aktarır veya yeniden oluşturur. OnReconnect hangi yolun izlendiğini bildirir ve abonelik nesneleriniz geçerli kalır.

Delphi ile aynı API

Sınıf, özellik, metot ve olay adları Delphi ve C++Builder bileşeniyle eşleşir; böylece bir ekip her iki platform için tek bir tasarımı paylaşabilir.

sgcWebSockets Enterprise'ın bir parçası

OPC UA istemcisi, seri port ve Modbus bileşenlerinin yanında esegece.sgcIndustrial paketinde, sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access içinde yer alır. Sürümleri fiyatlandırma sayfasında (.NET sekmesi) veya .NET özellik matrisinde karşılaştırın.

Bağımsız bir açık kaynaklı OPC UA uygulaması olan asyncua üzerine kurulu bir referans sunucuya karşı test edilmiştir: on bir uç noktanın tümü (her ilke ve mod), üç kimlik türü, devam noktalarıyla gezinme, dizi ve matrislerle 18 yerleşik türün okunması, metot çağrıları, deadband ve olay abonelikleri ve kayıp veya yinelenen mesaj olmadan iki dakikalık yayın çalışması.

C# OPC UA soruları

Bir TsgcOPCUAClient oluşturun, EndpointUrl ayarlayın, Connect() çağırın ve ardından ReadValue("ns=2;s=Line1.Speed") kullanın. Değerin .NET türünde bir object döndürür. Read tek çağrıda birkaç düğümü ve özniteliği okur.

Yayınlama aralığıyla CreateSubscription çağırın, düğümleri AddMonitoredItem ile ekleyin ve OnDataChange olayını işleyin. Her öğedeki bir deadband, küçük değişiklikleri işleyicinizin dışında tutar.

Sign veya SignAndEncrypt modunda Basic256Sha256, Aes128_Sha256_RsaOaep ve Aes256_Sha256_RsaPss; ayrıca eski sunucular için kullanımdan kaldırılmış Basic128Rsa15 ve Basic256, test ortamları için None.

OnValidateServerCertificate olayını işleyin ve aAccept değerini yalnızca güvendiğiniz sertifikalar için true yapın; örneğin DER baytlarını kaydettiğiniz bir kopyayla karşılaştırarak. İşleyici olmadan, test için AutoAcceptServerCertificate ayarlanmadıkça güvenli her bağlantı reddedilir.

İstemci OnError ve OnDisconnect olaylarını tetikler. WatchDog.Enabled = true ile her WatchDog.Interval saniyede bir yeniden dener (varsayılan 10, WatchDog.Attempts 0 ise sınır yok). Sunucu hâlâ tutuyorsa aynı oturumu yeniden etkinleştirir, aksi halde yeni bir oturum açar ve abonelikleri aktarır veya yeniden oluşturur. OnReconnect hangi yolun izlendiğini bildirir ve abonelik nesneleriniz geçerli kalır.

esegece.sgcIndustrial paketi .NET 8, .NET 9, .NET 10 ve .NET Standard 2.0 hedefler, bu yüzden .NET Framework 4.8 üzerinde de çalışır.

OPC UA istemcisi sgcWebSockets Enterprise (Delphi ve .NET) ve All-Access ya da bağımsız sgcIndustrial paketi içinde yer alır. Bir OPC UA sunucusunu, HTTPS, JSON ve WebSocket taşımalarını, HistoryRead, PubSub, Reverse Connect ve Global Discovery Server özelliklerini içermez.

sgcWebSockets .NET hakkında daha fazlası

Endüstriyel bileşenler

Seri port, Modbus ve OPC UA, tam bileşen başvurusuyla birlikte.

C# Modbus TCP ve RTU

OPC UA sunucularınızın yanındaki cihazlar için Modbus istemcileri ve sunucuları.

C# MQTT istemcisi

OPC UA veri değişikliklerini aynı uygulamadan bir MQTT aracısına iletin.

Delphi ve C++Builder için de

Aynı OPC UA istemcisi, aynı sınıf ve metot adları ve aynı WatchDog yeniden bağlanmasıyla.

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

İlk OPC UA düğümünüzü C# ile okuyun

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