신규

Delphi OPC UA 클라이언트 컴포넌트

Delphi와 C++Builder용 네이티브 OPC UA 클라이언트예요. PLC, SCADA 서버, 산업용 게이트웨이의 변수를 탐색하고 읽고 쓰며, 메서드를 호출하고, 서명 및 암호화되고 스스로 재연결하는 opc.tcp 연결로 구독을 통해 데이터 변경과 알람을 받아요.

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

OPC UA 클라이언트 측을 위한 컴포넌트 하나

보안 채널, 세션, 서비스, 구독을 Pascal로 작성해 애플리케이션에 컴파일되는 비주얼이 아닌 컴포넌트 하나로 제공해요.

Delphi OPC UA 클라이언트를 사용하면 VCL, FMX, 서비스, 콘솔 애플리케이션이 기계, PLC, SCADA 시스템이 OPC UA 서버를 통해 게시하는 데이터를 읽고, 설정값과 명령을 다시 쓸 수 있어요. sgcWebSockets는 이를 TsgcOPCUAClient로 제공해요. EndpointUrl을 설정하고, SecurityPolicy와 SecurityMode를 고르고, Connect를 호출한 다음 ns=2;s=Line1.Speed나 i=2253 같은 노드 ID로 작업하세요.

서비스 호출은 서버가 응답할 때까지 블로킹되고, 실패하면 OPC UA 상태 코드와 함께 EsgcOPCUAError를 발생시켜요. ReadValue는 Delphi Variant를 반환하고, WriteValue는 먼저 노드의 데이터 타입을 읽기 때문에 WriteValue('ns=2;s=Line1.Setpoint', 75.5)가 Float나 Double을 노드가 기대하는 대로 써요. uses sgcIndustrial; 한 줄이면 컴포넌트와 그 타입, 열거형이 모두 들어와요.

컴포넌트 클래스

TsgcOPCUAClient와 함께 쓰는 TsgcOPCUASubscription, TsgcOPCUAMonitoredItem

전송

PLC와 SCADA 서버가 노출하는 전송 방식인 opc.tcp 위의 OPC UA 바이너리

보안

Basic256Sha256, Aes128_Sha256_RsaOaep, Aes256_Sha256_RsaPss를 사용하는 Sign 및 SignAndEncrypt

플랫폼

Delphi 7~Delphi 13 및 C++Builder, Windows 32/64비트, Linux 64비트

OPC UA 서비스, 각각 메서드 하나로

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

서비스 세트서비스메서드
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

Delphi 몇 줄로 기계 읽기

컴포넌트를 만들고, 엔드포인트를 설정하고, 메서드를 호출하세요. 이 페이지의 모든 샘플은 Delphi 7과 Delphi 13에서 컴파일돼요.

uses
  sgcIndustrial;

procedure TForm1.ReadLine1;
begin
  OPCUA := TsgcOPCUAClient.Create(Self);
  OPCUA.EndpointUrl := 'opc.tcp://192.168.1.60:4840';
  OPCUA.Connect;
  try
    Memo1.Lines.Add('Speed: ' + VarToStr(OPCUA.ReadValue('ns=2;s=Line1.Speed')));
    // write with an explicit built-in type
    OPCUA.WriteValue('ns=2;s=Line1.Mode', 2, uabtUInt16);
  except
    on E: EsgcOPCUAError do
      Memo1.Lines.Add('Status ' + IntToHex(Int64(E.StatusCode), 8) + ': ' + E.Message);
  end;
end;
uses
  sgcIndustrial, sgcOPCUA_Types;

procedure TForm1.BrowseAndCall;
var
  vRefs: TsgcOPCUAReferenceDescriptionArray;
  vInputs, vOutputs: TsgcOPCUAVariantArray;
  i: Integer;
begin
  // i=85 is the Objects folder
  vRefs := OPCUA.Browse('i=85');
  for i := 0 to Length(vRefs) - 1 do
    Memo1.Lines.Add(vRefs[i].DisplayName.Text + ' = ' +
      sgcOPCUANodeIdToString(vRefs[i].NodeId.NodeId));
  // resolve a browse path to a node id
  Memo1.Lines.Add(sgcOPCUANodeIdToString(OPCUA.TranslateBrowsePath('i=85', '/2:Line1/2:Speed')));
  // call a method with two Int32 arguments
  SetLength(vInputs, 2);
  vInputs[0] := sgcOPCUAVariantSimple(uabtInt32, 2);
  vInputs[1] := sgcOPCUAVariantSimple(uabtInt32, 3);
  vOutputs := OPCUA.Call('ns=2;s=Methods', 'ns=2;s=Methods.Add', vInputs);
  Memo1.Lines.Add('Result: ' + VarToStr(vOutputs[0].Value));
end;
procedure TForm1.WatchLine1;
var
  oSubscription: TsgcOPCUASubscription;
begin
  OPCUA.OnDataChange := OnOPCUADataChange;
  oSubscription := OPCUA.CreateSubscription(1000);
  // sampling 100 ms, keep the 10 newest samples between two publishes
  FSpeed := OPCUA.AddMonitoredItem(oSubscription, 'ns=2;s=Line1.Speed', 100, 10);
  // only changes of more than 2 percent of the EURange of the variable
  OPCUA.AddMonitoredItem(oSubscription, 'ns=2;s=Line1.Level', 500, 1, True, uadbtPercent, 2);
end;

procedure TForm1.OnOPCUADataChange(Sender: TObject; aSubscription: TsgcOPCUASubscription;
  aMonitoredItem: TsgcOPCUAMonitoredItem; const aValue: TsgcOPCUADataValue);
begin
  if aMonitoredItem = FSpeed then
    Memo1.Lines.Add('Speed: ' + VarToStr(aValue.Value.Value))
  else
    Memo1.Lines.Add('Level: ' + VarToStr(aValue.Value.Value));
end;
uses
  sgcIndustrial, sgcOPCUA_Encoding;

procedure TForm1.WatchAlarms;
var
  oSubscription: TsgcOPCUASubscription;
begin
  OPCUA.OnEvent := OnOPCUAEvent;
  oSubscription := OPCUA.CreateSubscription(1000);
  // i=2253 is the Server object, which reports the events of the whole server
  OPCUA.AddEventMonitoredItem(oSubscription, 'i=2253', ['Message', 'Severity', 'SourceName']);
end;

procedure TForm1.OnOPCUAEvent(Sender: TObject; aSubscription: TsgcOPCUASubscription;
  aMonitoredItem: TsgcOPCUAMonitoredItem; const aEventFields: TsgcOPCUAVariantArray);
begin
  // the fields arrive in the order of the select clauses
  Memo1.Lines.Add(VarToStr(sgcOPCUAVariantToDelphi(aEventFields[2])) + ' (' +
    VarToStr(sgcOPCUAVariantToDelphi(aEventFields[1])) + '): ' +
    VarToStr(sgcOPCUAVariantToDelphi(aEventFields[0])));
end;
procedure TForm1.StartMonitor;
begin
  OPCUA := TsgcOPCUAClient.Create(Self);
  OPCUA.EndpointUrl := 'opc.tcp://192.168.1.60:4840';
  // try to reconnect every 5 seconds, with no limit of attempts
  OPCUA.WatchDog.Enabled := True;
  OPCUA.WatchDog.Interval := 5;
  OPCUA.WatchDog.Attempts := 0;
  OPCUA.OnStatusChange := OnOPCUAStatusChange;
  OPCUA.OnReconnect := OnOPCUAReconnect;
  OPCUA.Connect;
end;

procedure TForm1.OnOPCUAStatusChange(Sender: TObject; aState: TsgcOPCUAClientState);
begin
  if aState = opccsReconnecting then
    Memo1.Lines.Add('Connection lost, reconnecting');
end;

procedure TForm1.OnOPCUAReconnect(Sender: TObject; aMethod: TsgcOPCUAReconnectMethod);
begin
  case aMethod of
    opcrmSessionReactivated:
      Memo1.Lines.Add('Same session, missing notifications republished');
    opcrmSubscriptionsTransferred:
      Memo1.Lines.Add('New session, subscriptions transferred');
    opcrmSubscriptionsRecreated:
      Memo1.Lines.Add('New session, subscriptions created again');
  else
    Memo1.Lines.Add('New session');
  end;
end;

헬퍼 함수 sgcOPCUANodeIdToString과 sgcOPCUAVariantSimple은 sgcOPCUA_Types에, sgcOPCUAVariantToDelphi는 sgcOPCUA_Encoding에 있어요. 사용할 때는 해당 유닛을 추가하세요. Delphi 7~2006은 TBytes를 위해 sgcBase_Helpers도 필요해요.

생산 현장을 위해 만든 OPC UA 클라이언트

구독, 필터, 재연결을 알아서 처리하고, 원하는 곳에서 이벤트를 받아요.

폴링 없는 구독

CreateSubscription은 게시 간격을, AddMonitoredItem은 각 노드의 샘플링 간격과 큐 크기를 설정해요. 컴포넌트는 충분한 Publish 요청을 계속 대기시키고, 모든 알림을 승인하며, 누락된 메시지는 서버에 다시 게시하도록 요청해요.

데드밴드와 트리거

절대 데드밴드(uadbtAbsolute)나 EURange의 퍼센트(uadbtPercent)로 노이즈가 핸들러에 들어가지 않게 해요. 트리거는 상태 변경, 값 변경, 새 타임스탬프 중 무엇을 보고할지 정해요.

이벤트와 알람

AddEventMonitoredItem은 반환할 이벤트 필드(예: Message, Severity, SourceName)와 선택적 where 절을 받아요. 단일 소스를 구독하거나, Server 객체를 구독해 서버의 모든 이벤트를 받을 수 있어요.

WatchDog 재연결

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

재연결 후에도 같은 객체

구독과 모니터링 항목은 클라이언트가 소유하며 WatchDog 재연결 후에도 유지돼요. 서버 ID는 바뀔 수 있지만 항목의 ClientHandle은 절대 바뀌지 않으므로 핸들러가 계속 동작해요.

원하는 곳에서 이벤트 받기

OnDataChange, OnEvent, OnKeepAlive, OnConnect, OnDisconnect, OnError는 NotifyEvents를 통해 전달돼요. 기본은 메인 스레드 큐이고, 동기화하거나, 서비스와 콘솔 애플리케이션을 위해 클라이언트 스레드에서 발생시킬 수도 있어요.

서명 및 암호화, 안전한 기본값

SecurityPolicy를 opcspBasic256Sha256, opcspAes128_Sha256_RsaOaep 또는 opcspAes256_Sha256_RsaPss로, SecurityMode를 opcsmSign 또는 opcsmSignAndEncrypt로 설정하세요. opcspBasic128Rsa15와 opcspBasic256은 OPC Foundation에서 더 이상 권장하지 않으며 오래된 서버를 위해 남겨 두었어요. 클라이언트는 GetEndpoints에서 일치하는 엔드포인트를 고르고, 없으면 오류 메시지에 서버가 제공하는 목록을 보여 줘요.

애플리케이션 인증서

Application.CertificateFile과 PrivateKeyFile이 인스턴스 인증서를 불러와요. 파일이 아직 없으면 클라이언트가 인증서를 만들어 그 위치에 저장하므로, 서버 관리자는 한 번만 신뢰하면 돼요. 파일을 지정하지 않으면 메모리에 만들어져요.

서버 인증서

서버 인증서는 OnValidateServerCertificate가 수락하지 않으면 거부되므로, 새 클라이언트가 모르는 서버를 실수로 신뢰하는 일이 없어요. AutoAcceptServerCertificate는 테스트 환경용이에요.

사용자 ID

Authentication.AuthenticationType으로 Anonymous, 사용자 이름과 비밀번호, X.509 사용자 인증서 중에서 선택해요. 서버의 토큰 정책이 요구하면 비밀번호는 서버 키로 암호화돼요.

독립적인 OPC UA 스택으로 테스트했어요

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

Delphi OPC UA FAQ

TsgcOPCUAClient를 만들고, EndpointUrl을 서버의 opc.tcp 주소로 설정하고, Connect를 호출한 다음 ReadValue('ns=2;s=Line1.Speed')를 호출하세요. Variant를 반환해요. Read는 여러 노드와 속성을 한 번에 읽어요.

게시 간격으로 CreateSubscription을 호출하고, AddMonitoredItem으로 노드를 추가한 다음 OnDataChange를 지정하세요. 이벤트는 구독, 모니터링 항목, 상태 코드와 타임스탬프가 담긴 새 TsgcOPCUADataValue를 받아요.

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

WatchDog.Enabled를 켜면 클라이언트가 WatchDog.Interval초마다 재시도해요. 서버에 세션이 남아 있으면 같은 세션을 다시 활성화하고, 그렇지 않으면 새 세션을 열어 구독을 이전하거나 다시 만들어요. OnReconnect가 어느 경로를 택했는지 알려 주고, 구독 객체는 계속 유효해요.

네. 메시지 루프가 없으면 NotifyEvents := neNoSync로 설정하세요. 그러면 이벤트가 클라이언트 스레드에서 실행돼요. 그 이벤트 안에서 Connect나 다른 블로킹 서비스를 호출하지 말고, 재연결은 WatchDog에 맡기세요.

Delphi 7~Delphi 13 및 C++Builder, Windows(32/64비트)와 Linux 64비트.

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

sgcWebSockets의 더 많은 산업용 컴포넌트

산업용 컴포넌트

한 섹션에서 시리얼 포트, Modbus, OPC UA와 전체 컴포넌트 레퍼런스를 볼 수 있어요.

OPC UA 클라이언트 레퍼런스

C++Builder와 C# 샘플이 포함된 TsgcOPCUAClient의 속성, 메서드, 이벤트예요.

Delphi Modbus TCP 및 RTU

OPC UA를 사용하지 않는 장치를 위한 Modbus 클라이언트와 서버예요.

Delphi MQTT 클라이언트

OPC UA 데이터 변경을 MQTT 토픽으로 전달해 보세요. 공장에서 클라우드로 가는 일반적인 게이트웨이예요.

C#과 .NET에서도 사용 가능

같은 클래스 이름을 가진 동일한 OPC UA 클라이언트를 .NET 8, 9, 10과 .NET Standard 2.0에서 쓸 수 있어요.

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

Delphi에서 첫 OPC UA 노드를 읽어 보세요

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