C# i .NET Nowość

Biblioteka klienta C# OPC UA dla .NET

Przeglądaj, odczytuj, zapisuj i subskrybuj serwery OPC UA sterowników PLC, systemów SCADA i bram z poziomu C#, w podpisanym i szyfrowanym połączeniu opc.tcp.

Binarny OPC UA przez opc.tcp
Sign i SignAndEncrypt aż do Aes256_Sha256_RsaPss
Subskrypcje zmian danych i zdarzeń
Tożsamości: anonimowa, nazwa użytkownika i X.509

W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial.

Odczyt i subskrypcja w C# → · FAQ o OPC UA →

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

Klient OPC UA dla aplikacji .NET

Bezpieczny kanał, sesja, usługi i subskrypcje w jednej klasie, z tym samym API co komponent Delphi.

Klient C# OPC UA w sgcWebSockets .NET to TsgcOPCUAClient, część pakietu esegece.sgcIndustrial, w przestrzeni nazw esegece.sgcWebSockets. Ustaw EndpointUrl, wybierz SecurityPolicy i SecurityMode, wywołaj Connect i pracuj z identyfikatorami węzłów, takimi jak ns=2;s=Line1.Speed. ReadValue zwraca wartość jako zwykły obiekt .NET (tablice typowane, double[,] dla macierzy), a WriteValue najpierw odczytuje typ danych węzła, aby wartość została zakodowana tak, jak oczekuje serwer.

Każde wywołanie usługi jest synchroniczne i w razie niepowodzenia zgłasza EsgcOPCUAError, którego StatusCode zawiera kod statusu OPC UA. Subskrypcje przekazują zmiany danych i zdarzenia do Twoich obsług przez OnDataChange i OnEvent. Pakiet obsługuje .NET 8, .NET 9, .NET 10 i .NET Standard 2.0.

Usługi

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

Subskrypcje

Elementy zmian danych z deadbandem i rozmiarem kolejki, elementy zdarzeń z klauzulami select i where.

Bezpieczeństwo

Basic256Sha256, Aes128_Sha256_RsaOaep i Aes256_Sha256_RsaPss w trybie Sign lub SignAndEncrypt.

Tożsamości

Anonimowa, nazwa użytkownika i hasło albo certyfikat użytkownika X.509.

OPC UA w C#, krok po kroku

Dodaj odwołanie do pakietu esegece.sgcIndustrial, połącz się, a następnie odczytuj, przeglądaj lub subskrybuj. Każdy przykład na tej stronie kompiluje się w .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);
    }
}

Wywołania usług są synchroniczne. W aplikacji WinForms, WPF lub ASP.NET wywołuj je z wątku roboczego albo wewnątrz Task.Run. Zdarzenia subskrypcji są wywoływane przez NotifyEvents: w wątku interfejsu użytkownika, jeśli istnieje, a w przeciwnym razie po kolei w puli wątków.

Obsługiwane usługi OPC UA

Proste przeciążenia przyjmują identyfikatory węzłów jako ciągi znaków; pełne przeciążenia przyjmują klasy żądań ze specyfikacji.

Zestaw usługUsługaMetoda C#
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
MetodaCallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptionsRealizowane przez klienta: OnDataChange, OnEvent, OnKeepAlive, WatchDog

Klient OPC UA zbudowany do pracy produkcyjnej

Pętla publikacji obsłużona

Klient utrzymuje w locie wystarczającą liczbę żądań Publish, potwierdza każde powiadomienie, prosi serwer o ponowną publikację utraconej wiadomości i odrzuca duplikaty, więc Twoje obsługi zdarzeń widzą każdą wartość jeden raz.

Deadband i kolejki

AddMonitoredItem ustawia interwał próbkowania, rozmiar kolejki oraz bezwzględny lub procentowy deadband dla każdego węzła. ModifyMonitoredItem zmienia je później, a SetPublishingMode wstrzymuje subskrypcję.

Zdarzenia i alarmy

AddEventMonitoredItem zwraca wybrane przez Ciebie pola zdarzenia, takie jak Message, Severity i SourceName, filtrowane opcjonalną klauzulą where.

Certyfikaty

Certyfikat aplikacji jest ładowany z plików DER lub PEM, tworzony i zapisywany przy pierwszym połączeniu albo tworzony w pamięci. Certyfikat serwera jest odrzucany, chyba że zaakceptuje go OnValidateServerCertificate.

Automatyczne ponowne połączenie

Po zerwaniu sieci WatchDog najpierw reaktywuje tę samą sesję i ponownie publikuje pominięte powiadomienia. Jeśli sesji już nie ma, otwiera nową i przenosi lub odtwarza subskrypcje. OnReconnect informuje, która ścieżka została wybrana, a Twoje obiekty subskrypcji pozostają ważne.

To samo API co w Delphi

Nazwy klas, właściwości, metod i zdarzeń odpowiadają komponentowi Delphi i C++Builder, więc zespół może współdzielić jeden projekt na obu platformach.

Część sgcWebSockets Enterprise

Klient OPC UA jest zawarty w sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, w pakiecie esegece.sgcIndustrial obok komponentów portu szeregowego i Modbus. Porównaj edycje na stronie z cennikiem (zakładka .NET) lub w macierzy funkcji .NET.

Jest testowany z serwerem referencyjnym zbudowanym na asyncua, niezależnej implementacji OPC UA o otwartym kodzie: wszystkie jedenaście punktów końcowych (każda polityka i tryb), trzy typy tożsamości, przeglądanie z punktami kontynuacji, odczyt 18 typów wbudowanych z tablicami i macierzą, wywołania metod, subskrypcje z deadbandem i zdarzeniami oraz dwuminutowy przebieg publikacji bez utraconej ani zduplikowanej wiadomości.

Pytania o OPC UA w C#

Utwórz TsgcOPCUAClient, ustaw EndpointUrl, wywołaj Connect(), a potem ReadValue("ns=2;s=Line1.Speed"). Zwraca object z typem .NET wartości. Read odczytuje kilka węzłów i atrybutów w jednym wywołaniu.

Wywołaj CreateSubscription z interwałem publikowania, dodaj węzły przez AddMonitoredItem i obsłuż OnDataChange. Deadband na każdym elemencie trzyma drobne zmiany z dala od Twojej obsługi.

Basic256Sha256, Aes128_Sha256_RsaOaep i Aes256_Sha256_RsaPss w trybie Sign lub SignAndEncrypt, a także wycofane Basic128Rsa15 i Basic256 dla starszych serwerów oraz None dla stanowisk testowych.

Obsłuż OnValidateServerCertificate i ustaw aAccept na true tylko dla certyfikatów, którym ufasz, na przykład porównując bajty DER z zapisaną kopią. Bez tej obsługi każde zabezpieczone połączenie jest odrzucane, chyba że do testów ustawiono AutoAcceptServerCertificate.

Klient wywołuje OnError i OnDisconnect. Przy WatchDog.Enabled = true ponawia próbę co WatchDog.Interval sekund (domyślnie 10, WatchDog.Attempts równe 0 oznacza brak limitu). Reaktywuje tę samą sesję, jeśli serwer ją jeszcze ma, w przeciwnym razie otwiera nową sesję i przenosi lub odtwarza subskrypcje. OnReconnect informuje, która ścieżka została wybrana, a Twoje obiekty subskrypcji pozostają ważne.

Pakiet esegece.sgcIndustrial obsługuje .NET 8, .NET 9, .NET 10 i .NET Standard 2.0, więc działa także na .NET Framework 4.8.

Klient OPC UA jest zawarty w sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial. Nie obejmuje serwera OPC UA, transportów HTTPS, JSON i WebSocket, HistoryRead, PubSub, Reverse Connect ani Global Discovery Server.

Więcej o sgcWebSockets .NET

Komponenty przemysłowe

Port szeregowy, Modbus i OPC UA, z pełną dokumentacją komponentów.

C# Modbus TCP i RTU

Klienty i serwery Modbus dla urządzeń obok Twoich serwerów OPC UA.

Klient MQTT dla C#

Przekazuj zmiany danych OPC UA do brokera MQTT z tej samej aplikacji.

Także dla Delphi i C++Builder

Ten sam klient OPC UA, z tymi samymi nazwami klas i metod oraz tym samym ponownym łączeniem WatchDog.

Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

Odczytaj pierwszy węzeł OPC UA z C#

W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial.