C#과 .NET 신규

.NET용 C# OPC UA 클라이언트 라이브러리

서명 및 암호화된 opc.tcp 연결로 C#에서 PLC, SCADA 시스템, 게이트웨이의 OPC UA 서버를 탐색하고, 읽고, 쓰고, 구독해 보세요.

opc.tcp 위의 OPC UA 바이너리
Aes256_Sha256_RsaPss까지 지원하는 Sign 및 SignAndEncrypt
데이터 변경 및 이벤트 구독
Anonymous, 사용자 이름, X.509 ID

sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access, 또는 독립형 sgcIndustrial 팩에 포함.

C#으로 읽고 구독하기 → · OPC UA FAQ →

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

.NET 애플리케이션을 위한 OPC UA 클라이언트

보안 채널, 세션, 서비스, 구독을 Delphi 컴포넌트와 같은 API의 클래스 하나로 제공해요.

sgcWebSockets .NET의 C# OPC UA 클라이언트는 esegece.sgcIndustrial 패키지의 esegece.sgcWebSockets 네임스페이스에 있는 TsgcOPCUAClient예요. EndpointUrl을 설정하고, SecurityPolicy와 SecurityMode를 고르고, Connect를 호출한 다음 ns=2;s=Line1.Speed 같은 노드 ID로 작업하세요. ReadValue는 값을 일반 .NET 객체(타입이 있는 배열, 행렬은 double[,])로 반환하고, WriteValue는 먼저 노드의 데이터 타입을 읽어 서버가 기대하는 대로 값을 인코딩해요.

모든 서비스 호출은 동기식이며, 실패하면 OPC UA 상태 코드를 StatusCode에 담은 EsgcOPCUAError를 던져요. 구독은 OnDataChange와 OnEvent를 통해 데이터 변경과 이벤트를 핸들러로 전달해요. 패키지는 .NET 8, .NET 9, .NET 10, .NET Standard 2.0을 대상으로 해요.

서비스

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

구독

데드밴드와 큐 크기를 지정한 데이터 변경 항목, select 및 where 절을 사용하는 이벤트 항목.

보안

Sign 또는 SignAndEncrypt 모드의 Basic256Sha256, Aes128_Sha256_RsaOaep, Aes256_Sha256_RsaPss.

ID 유형

Anonymous, 사용자 이름과 비밀번호, 또는 X.509 사용자 인증서.

C#으로 배우는 OPC UA, 단계별로

esegece.sgcIndustrial 패키지를 참조하고, 연결한 다음 읽거나, 탐색하거나, 구독하세요. 이 페이지의 모든 샘플은 .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);
    }
}

서비스 호출은 동기식이에요. WinForms, WPF, ASP.NET 애플리케이션에서는 워커 스레드나 Task.Run 안에서 호출하세요. 구독 이벤트는 NotifyEvents를 통해 발생해요. UI 스레드가 있으면 그곳에서, 없으면 스레드 풀에서 순서대로 실행돼요.

지원하는 OPC UA 서비스

단순 오버로드는 노드 ID 문자열을 받고, 전체 오버로드는 사양의 요청 클래스를 받아요.

서비스 세트서비스C# 메서드
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
메서드CallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptions클라이언트가 처리: OnDataChange, OnEvent, OnKeepAlive, WatchDog

운영 환경을 위해 만든 OPC UA 클라이언트

Publish 루프 처리

클라이언트는 충분한 Publish 요청을 계속 대기시키고, 모든 알림을 승인하며, 누락된 메시지는 서버에 다시 게시하도록 요청하고, 중복은 버려요. 그래서 핸들러는 각 값을 한 번만 받아요.

데드밴드와 큐

AddMonitoredItem은 노드마다 샘플링 간격, 큐 크기, 절대 또는 퍼센트 데드밴드를 설정해요. ModifyMonitoredItem으로 나중에 바꿀 수 있고, SetPublishingMode로 구독을 일시 중지할 수 있어요.

이벤트와 알람

AddEventMonitoredItem은 선택한 이벤트 필드(예: Message, Severity, SourceName)를 반환하고, 선택적 where 절로 필터링해요.

인증서

애플리케이션 인증서는 DER 또는 PEM 파일에서 불러오거나, 첫 연결 때 만들어 저장하거나, 메모리에 만들어요. 서버 인증서는 OnValidateServerCertificate가 수락하지 않으면 거부돼요.

자동 재연결

네트워크가 끊기면 WatchDog가 먼저 같은 세션을 다시 활성화하고 놓친 알림을 다시 게시해요. 세션이 사라졌다면 새 세션을 열고 구독을 이전하거나 다시 만들어요. OnReconnect가 어느 경로를 택했는지 알려 주고, 구독 객체는 계속 유효해요.

Delphi와 같은 API

클래스, 속성, 메서드, 이벤트 이름이 Delphi 및 C++Builder 컴포넌트와 같아서, 팀이 두 플랫폼에서 하나의 설계를 공유할 수 있어요.

sgcWebSockets Enterprise에 포함

OPC UA 클라이언트는 시리얼 포트 및 Modbus 컴포넌트와 함께 esegece.sgcIndustrial 패키지로 sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access에 포함돼요. 에디션은 가격 페이지(.NET 탭) 또는 .NET 기능 매트릭스에서 비교해 보세요.

독립적인 오픈 소스 OPC UA 구현인 asyncua로 만든 레퍼런스 서버에 대해 테스트했어요. 11개 엔드포인트 전부(모든 정책과 모드), 세 가지 ID 유형, 연속 포인트를 사용한 탐색, 배열과 행렬을 포함한 18개 내장 타입 읽기, 메서드 호출, 데드밴드 및 이벤트 구독, 메시지 손실이나 중복이 없는 2분간의 게시 실행을 확인했어요.

C# OPC UA FAQ

TsgcOPCUAClient를 만들고, EndpointUrl을 설정하고, Connect()를 호출한 다음 ReadValue("ns=2;s=Line1.Speed")를 호출하세요. 값의 .NET 타입을 가진 object를 반환해요. Read는 여러 노드와 속성을 한 번에 읽어요.

게시 간격으로 CreateSubscription을 호출하고, AddMonitoredItem으로 노드를 추가한 다음 OnDataChange를 처리하세요. 각 항목에 데드밴드를 지정하면 작은 변화가 핸들러에 전달되지 않아요.

Sign 또는 SignAndEncrypt 모드의 Basic256Sha256, Aes128_Sha256_RsaOaep, Aes256_Sha256_RsaPss와, 오래된 서버를 위한 더 이상 권장하지 않는 Basic128Rsa15와 Basic256, 그리고 테스트 환경용 None을 지원해요.

OnValidateServerCertificate를 처리하고, 신뢰하는 인증서에 대해서만 aAccept를 true로 설정하세요. 예를 들어 저장해 둔 사본과 DER 바이트를 비교해요. 핸들러가 없으면 테스트용으로 AutoAcceptServerCertificate를 설정하지 않는 한 모든 보안 연결이 거부돼요.

클라이언트가 OnError와 OnDisconnect를 발생시켜요. WatchDog.Enabled = true이면 WatchDog.Interval초마다 재시도해요(기본 10초, WatchDog.Attempts가 0이면 제한 없음). 서버에 세션이 남아 있으면 같은 세션을 다시 활성화하고, 그렇지 않으면 새 세션을 열어 구독을 이전하거나 다시 만들어요. OnReconnect가 어느 경로를 택했는지 알려 주고, 구독 객체는 계속 유효해요.

esegece.sgcIndustrial 패키지는 .NET 8, .NET 9, .NET 10, .NET Standard 2.0을 대상으로 하므로 .NET Framework 4.8에서도 실행돼요.

OPC UA 클라이언트는 sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access, 또는 독립형 sgcIndustrial 팩에 포함돼요. OPC UA 서버, HTTPS, JSON, WebSocket 전송, HistoryRead, PubSub, Reverse Connect, Global Discovery Server는 포함되지 않아요.

sgcWebSockets .NET 더 알아보기

산업용 컴포넌트

시리얼 포트, Modbus, OPC UA와 전체 컴포넌트 레퍼런스예요.

C# Modbus TCP 및 RTU

OPC UA 서버 옆에 있는 장치를 위한 Modbus 클라이언트와 서버예요.

C# MQTT 클라이언트

같은 애플리케이션에서 OPC UA 데이터 변경을 MQTT 브로커로 전달해 보세요.

Delphi와 C++Builder에서도 쓸 수 있어요

같은 클래스와 메서드 이름, 같은 WatchDog 재연결을 가진 동일한 OPC UA 클라이언트예요.

최고의 가성비: All-Access모든 eSeGeCe 제품과 프리미엄 지원이 포함되어 연 €1,059부터 이용할 수 있어요.
All-Access 가격 보기

C#으로 첫 OPC UA 노드를 읽어 보세요

sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access, 또는 독립형 sgcIndustrial 팩에 포함.