C# y .NET Novedad

Biblioteca cliente OPC UA en C# para .NET

Explora, lee, escribe y suscríbete a los servidores OPC UA de PLC, sistemas SCADA y pasarelas desde C#, a través de una conexión opc.tcp firmada y cifrada.

OPC UA binario sobre opc.tcp
Sign y SignAndEncrypt hasta Aes256_Sha256_RsaPss
Suscripciones de cambio de datos y de eventos
Identidades Anonymous, usuario y X.509

Incluido en sgcWebSockets Enterprise (Delphi y .NET) y All-Access, o en el pack independiente sgcIndustrial.

Lee y suscríbete en C# → · Preguntas frecuentes de OPC UA →

Cliente OPC UA en 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 cliente OPC UA para aplicaciones .NET

Canal seguro, sesión, servicios y suscripciones en una sola clase, con la misma API que el componente de Delphi.

El cliente OPC UA en C# de sgcWebSockets .NET es TsgcOPCUAClient, parte del paquete esegece.sgcIndustrial, espacio de nombres esegece.sgcWebSockets. Establece EndpointUrl, elige SecurityPolicy y SecurityMode, llama a Connect y trabaja con ids de nodo como ns=2;s=Line1.Speed. ReadValue devuelve el valor como un objeto .NET normal (arrays tipados, double[,] para una matriz), y WriteValue lee primero el tipo de datos del nodo para que el valor se codifique como espera el servidor.

Cada llamada de servicio es síncrona y lanza EsgcOPCUAError, cuyo StatusCode contiene el código de estado OPC UA, cuando falla. Las suscripciones envían los cambios de datos y los eventos a tus manejadores mediante OnDataChange y OnEvent. El paquete admite .NET 8, .NET 9, .NET 10 y .NET Standard 2.0.

Servicios

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

Suscripciones

Elementos de cambio de datos con banda muerta y tamaño de cola, elementos de evento con cláusulas select y where.

Seguridad

Basic256Sha256, Aes128_Sha256_RsaOaep y Aes256_Sha256_RsaPss en modo Sign o SignAndEncrypt.

Identidades

Anonymous, usuario y contraseña, o un certificado de usuario X.509.

OPC UA en C#, paso a paso

Referencia el paquete esegece.sgcIndustrial, conecta y luego lee, explora o suscríbete. Todos los ejemplos de esta página compilan 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);
    }
}

Las llamadas de servicio son síncronas. En una aplicación WinForms, WPF o ASP.NET, llámalas desde un hilo de trabajo o dentro de Task.Run. Los eventos de suscripción se lanzan a través de NotifyEvents: en el hilo de la interfaz cuando existe, y si no, en orden en el grupo de hilos.

Servicios OPC UA admitidos

Las sobrecargas simples toman cadenas de id de nodo; las sobrecargas completas toman las clases de petición de la especificación.

Conjunto de serviciosServicioMétodo de C#
DescubrimientoGetEndpointsGetEndpoints
VistaBrowse, BrowseNextBrowse, BrowseNext
VistaTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AtributoReadRead, ReadValue
AtributoWriteWrite, WriteValue
MétodoCallCall
SuscripciónCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SuscripciónPublish, Republish, TransferSubscriptionsLo hace el cliente: OnDataChange, OnEvent, OnKeepAlive, WatchDog

Un cliente OPC UA preparado para producción

Bucle de publicación resuelto

El cliente mantiene suficientes peticiones Publish en curso, confirma cada notificación, pide al servidor que vuelva a publicar un mensaje perdido y descarta los duplicados, de modo que tus manejadores ven cada valor una sola vez.

Banda muerta y colas

AddMonitoredItem establece el intervalo de muestreo, el tamaño de la cola y una banda muerta absoluta o porcentual por nodo. ModifyMonitoredItem los cambia más tarde y SetPublishingMode pausa una suscripción.

Eventos y alarmas

AddEventMonitoredItem devuelve los campos de evento que selecciones, como Message, Severity y SourceName, filtrados por una cláusula where opcional.

Certificados

El certificado de aplicación se carga desde archivos DER o PEM, se crea y se guarda en la primera conexión, o se crea en memoria. Un certificado de servidor se rechaza a menos que OnValidateServerCertificate lo acepte.

Reconexión automática

Tras una caída de red, WatchDog reactiva primero la misma sesión y vuelve a publicar las notificaciones perdidas. Si la sesión ya no existe, abre una nueva y transfiere o recrea las suscripciones. OnReconnect indica qué camino se siguió, y tus objetos de suscripción siguen siendo válidos.

La misma API que en Delphi

Los nombres de clases, propiedades, métodos y eventos coinciden con los del componente de Delphi y C++Builder, de modo que un equipo puede compartir un único diseño en ambas plataformas.

Parte de sgcWebSockets Enterprise

El cliente OPC UA está incluido en sgcWebSockets Enterprise (Delphi y .NET) y All-Access, en el paquete esegece.sgcIndustrial junto a los componentes de puerto serie y Modbus. Compara las ediciones en la página de precios (pestaña .NET) o en la matriz de funciones de .NET.

Se prueba contra un servidor de referencia construido con asyncua, una implementación OPC UA independiente de código abierto: los once puntos finales (todas las políticas y modos), los tres tipos de identidad, la exploración con puntos de continuación, la lectura de 18 tipos integrados con arrays y una matriz, las llamadas a métodos, las suscripciones con banda muerta y de eventos, y una ejecución de publicación de dos minutos sin ningún mensaje perdido ni duplicado.

Preguntas sobre OPC UA en C#

Crea un TsgcOPCUAClient, establece EndpointUrl, llama a Connect() y luego a ReadValue("ns=2;s=Line1.Speed"). Devuelve un object con el tipo .NET del valor. Read lee varios nodos y atributos en una sola llamada.

Llama a CreateSubscription con el intervalo de publicación, añade nodos con AddMonitoredItem y gestiona OnDataChange. Una banda muerta en cada elemento mantiene los cambios pequeños fuera de tu manejador.

Basic256Sha256, Aes128_Sha256_RsaOaep y Aes256_Sha256_RsaPss en modo Sign o SignAndEncrypt, además de las obsoletas Basic128Rsa15 y Basic256 para servidores antiguos, y None para bancos de pruebas.

Gestiona OnValidateServerCertificate y establece aAccept a true solo para los certificados en los que confíes, por ejemplo comparando los bytes DER con una copia que hayas guardado. Sin el manejador, toda conexión segura se rechaza, salvo que AutoAcceptServerCertificate esté activado para pruebas.

El cliente lanza OnError y OnDisconnect. Con WatchDog.Enabled = true, reintenta cada WatchDog.Interval segundos (10 por defecto, WatchDog.Attempts 0 significa sin límite). Reactiva la misma sesión cuando el servidor todavía la conserva; si no, abre una sesión nueva y transfiere o recrea las suscripciones. OnReconnect informa de qué camino se siguió, y tus objetos de suscripción siguen siendo válidos.

El paquete esegece.sgcIndustrial admite .NET 8, .NET 9, .NET 10 y .NET Standard 2.0, así que también funciona en .NET Framework 4.8.

El cliente OPC UA está incluido en sgcWebSockets Enterprise (Delphi y .NET) y All-Access, o en el pack independiente sgcIndustrial. No incluye un servidor OPC UA, los transportes HTTPS, JSON y WebSocket, HistoryRead, PubSub, Reverse Connect ni el Global Discovery Server.

Más sobre sgcWebSockets .NET

Componentes industriales

Puerto serie, Modbus y OPC UA, con la referencia completa de componentes.

Modbus TCP y RTU en C#

Clientes y servidores Modbus para los dispositivos que están junto a tus servidores OPC UA.

Cliente MQTT para C#

Reenvía los cambios de datos OPC UA a un broker MQTT desde la misma aplicación.

También para Delphi y C++Builder

El mismo cliente OPC UA, con los mismos nombres de clase y método y la misma reconexión WatchDog.

La mejor opción: All-AccessTodos los productos de eSeGeCe, con Premium Support incluido, desde €1,059 al año.
Ver precios de All-Access

Lee tu primer nodo OPC UA desde C#

Incluido en sgcWebSockets Enterprise (Delphi y .NET) y All-Access, o en el pack independiente sgcIndustrial.