C# e .NET Novità

Libreria client OPC UA in C# per .NET

Esplora, leggi, scrivi e sottoscrivi i server OPC UA di PLC, sistemi SCADA e gateway da C#, su una connessione opc.tcp firmata e cifrata.

OPC UA binary su opc.tcp
Sign e SignAndEncrypt fino ad Aes256_Sha256_RsaPss
Sottoscrizioni a variazioni di dati ed eventi
Identità Anonymous, nome utente e X.509

Incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial.

Leggi e sottoscrivi in C# → · FAQ su OPC UA →

Client OPC UA in C#
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();

Un client OPC UA per applicazioni .NET

Canale sicuro, sessione, servizi e sottoscrizioni in un'unica classe, con la stessa API del componente Delphi.

Il client OPC UA in C# di sgcWebSockets .NET è TsgcOPCUAClient, parte del pacchetto esegece.sgcIndustrial, namespace esegece.sgcWebSockets. Imposta EndpointUrl, scegli SecurityPolicy e SecurityMode, chiama Connect e lavora con node id come ns=2;s=Line1.Speed. ReadValue restituisce il valore come normale oggetto .NET (array tipizzati, double[,] per una matrice), e WriteValue legge prima il tipo di dato del nodo, così il valore viene codificato come il server si aspetta.

Ogni chiamata ai servizi è sincrona e solleva EsgcOPCUAError, il cui StatusCode contiene il codice di stato OPC UA, quando fallisce. Le sottoscrizioni inviano variazioni di dati ed eventi ai tuoi gestori tramite OnDataChange e OnEvent. Il pacchetto ha come target .NET 8, .NET 9, .NET 10 e .NET Standard 2.0.

Servizi

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

Sottoscrizioni

Item di variazione dati con deadband e dimensione della coda, item di evento con clausole select e where.

Sicurezza

Basic256Sha256, Aes128_Sha256_RsaOaep e Aes256_Sha256_RsaPss in modalità Sign o SignAndEncrypt.

Identità

Anonymous, nome utente e password, oppure un certificato utente X.509.

OPC UA in C#, passo dopo passo

Fai riferimento al pacchetto esegece.sgcIndustrial, connettiti, poi leggi, esplora o sottoscrivi. Ogni esempio di questa pagina si compila con .NET 8.

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

Le chiamate ai servizi sono sincrone. In un'applicazione WinForms, WPF o ASP.NET, chiamale da un thread di lavoro o dentro Task.Run. Gli eventi delle sottoscrizioni vengono sollevati tramite NotifyEvents: sul thread della UI quando esiste, altrimenti in ordine sul thread pool.

Servizi OPC UA supportati

Gli overload semplici accettano node id come stringhe; gli overload completi accettano le classi di richiesta della specifica.

Service setServizioMetodo C#
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
MetodoCallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptionsGestito dal client: OnDataChange, OnEvent, OnKeepAlive, WatchDog

Un client OPC UA pensato per la produzione

Ciclo Publish gestito

Il client mantiene in volo un numero sufficiente di richieste Publish, conferma ogni notifica, chiede al server di ripubblicare un messaggio andato perso ed elimina i duplicati, così i tuoi gestori vedono ogni valore una sola volta.

Deadband e code

AddMonitoredItem imposta l'intervallo di campionamento, la dimensione della coda e una deadband assoluta o percentuale per ogni nodo. ModifyMonitoredItem li modifica in seguito e SetPublishingMode mette in pausa una sottoscrizione.

Eventi e allarmi

AddEventMonitoredItem restituisce i campi dell'evento che selezioni, come Message, Severity e SourceName, filtrati da una clausola where opzionale.

Certificati

Il certificato dell'applicazione viene caricato da file DER o PEM, creato e salvato alla prima connessione, oppure creato in memoria. Un certificato del server viene rifiutato a meno che OnValidateServerCertificate non lo accetti.

Riconnessione automatica

Dopo una caduta di rete, WatchDog riattiva prima la stessa sessione e ripubblica le notifiche perse. Se la sessione non esiste più, ne apre una nuova e trasferisce o ricrea le sottoscrizioni. OnReconnect indica quale percorso è stato seguito, e i tuoi oggetti di sottoscrizione restano validi.

Stessa API di Delphi

I nomi di classi, proprietà, metodi ed eventi corrispondono a quelli del componente Delphi e C++Builder, così un team può condividere un unico progetto su entrambe le piattaforme.

Incluso in sgcWebSockets Enterprise

Il client OPC UA è incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, nel pacchetto esegece.sgcIndustrial accanto ai componenti porta seriale e Modbus. Confronta le edizioni nella pagina dei prezzi (scheda .NET) o nella matrice delle funzionalità .NET.

È testato con un server di riferimento basato su asyncua, un'implementazione OPC UA open source indipendente: tutti gli undici endpoint (ogni policy e modalità), i tre tipi di identità, il browse con continuation point, la lettura di 18 tipi built-in con array e matrice, le chiamate ai metodi, le sottoscrizioni con deadband ed eventi e una prova di pubblicazione di due minuti senza messaggi persi o duplicati.

Domande su OPC UA in C#

Crea un TsgcOPCUAClient, imposta EndpointUrl, chiama Connect() e poi ReadValue("ns=2;s=Line1.Speed"). Restituisce un object con il tipo .NET del valore. Read legge più nodi e attributi in una sola chiamata.

Chiama CreateSubscription con l'intervallo di pubblicazione, aggiungi i nodi con AddMonitoredItem e gestisci OnDataChange. Una deadband su ogni item tiene le piccole variazioni fuori dal tuo gestore.

Basic256Sha256, Aes128_Sha256_RsaOaep e Aes256_Sha256_RsaPss in modalità Sign o SignAndEncrypt, più le deprecate Basic128Rsa15 e Basic256 per i server meno recenti, e None per i banchi di prova.

Gestisci OnValidateServerCertificate e imposta aAccept su true solo per i certificati di cui ti fidi, per esempio confrontando i byte DER con una copia che hai salvato. Senza il gestore ogni connessione protetta viene rifiutata, a meno che AutoAcceptServerCertificate sia impostato per i test.

Il client solleva OnError e OnDisconnect. Con WatchDog.Enabled = true riprova poi ogni WatchDog.Interval secondi (10 per impostazione predefinita, WatchDog.Attempts 0 significa nessun limite). Riattiva la stessa sessione se il server la conserva ancora, altrimenti apre una nuova sessione e trasferisce o ricrea le sottoscrizioni. OnReconnect segnala quale percorso è stato seguito, e i tuoi oggetti di sottoscrizione restano validi.

Il pacchetto esegece.sgcIndustrial ha come target .NET 8, .NET 9, .NET 10 e .NET Standard 2.0, quindi funziona anche su .NET Framework 4.8.

Il client OPC UA è incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial. Non include un server OPC UA, i trasporti HTTPS, JSON e WebSocket, HistoryRead, PubSub, Reverse Connect e il Global Discovery Server.

Altro su sgcWebSockets .NET

Componenti industriali

Porta seriale, Modbus e OPC UA, con il riferimento completo dei componenti.

Modbus TCP e RTU in C#

Client e server Modbus per i dispositivi accanto ai tuoi server OPC UA.

Client MQTT C#

Inoltra le variazioni di dati OPC UA a un broker MQTT dalla stessa applicazione.

Anche per Delphi e C++Builder

Lo stesso client OPC UA, con gli stessi nomi di classi e metodi e la stessa riconnessione WatchDog.

La scelta più conveniente: All-AccessTutti i prodotti eSeGeCe, con Supporto Premium incluso, a partire da €1,059/anno.
Vedi i prezzi All-Access

Leggi il tuo primo nodo OPC UA da C#

Incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial.