Novedad

Componente cliente OPC UA para Delphi

Un cliente OPC UA nativo para Delphi y C++Builder. Explora, lee y escribe las variables de PLC, servidores SCADA y pasarelas industriales, llama a sus métodos y recibe cambios de datos y alarmas mediante suscripciones, a través de una conexión opc.tcp firmada y cifrada que se reconecta sola.

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

Un componente para el lado cliente de OPC UA

Canal seguro, sesión, servicios y suscripciones en un componente no visual, escrito en Pascal y compilado dentro de tu aplicación.

Un cliente OPC UA para Delphi permite que una aplicación VCL, FMX, servicio o consola lea los datos que máquinas, PLC y sistemas SCADA publican a través de un servidor OPC UA, y escriba de vuelta consignas y comandos. sgcWebSockets lo incluye como TsgcOPCUAClient: establece EndpointUrl, elige SecurityPolicy y SecurityMode, llama a Connect y trabaja con ids de nodo como ns=2;s=Line1.Speed o i=2253.

Las llamadas de servicio se bloquean hasta que el servidor responde y lanzan EsgcOPCUAError con el código de estado OPC UA cuando fallan. ReadValue devuelve un Variant de Delphi, y WriteValue lee primero el tipo de datos del nodo, de modo que WriteValue('ns=2;s=Line1.Setpoint', 75.5) escribe un Float o un Double según lo que espere el nodo. Una sola línea uses sgcIndustrial; incorpora el componente, sus tipos y sus enumeraciones.

Clase de componente

TsgcOPCUAClient, con TsgcOPCUASubscription y TsgcOPCUAMonitoredItem

Transporte

OPC UA binario sobre opc.tcp, el transporte que exponen los PLC y los servidores SCADA

Seguridad

Sign y SignAndEncrypt con Basic256Sha256, Aes128_Sha256_RsaOaep y Aes256_Sha256_RsaPss

Plataformas

Delphi 7 a Delphi 13 y C++Builder; Windows de 32 y 64 bits y Linux de 64 bits

Los servicios OPC UA, un método para cada uno

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

Conjunto de serviciosServicioMétodo
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 componente: OnDataChange, OnEvent, OnKeepAlive, WatchDog

Lee una máquina en unas pocas líneas de Delphi

Crea el componente, establece el punto final, llama a un método. Todos los ejemplos de esta página compilan con Delphi 7 y 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;

Las funciones auxiliares sgcOPCUANodeIdToString y sgcOPCUAVariantSimple están en sgcOPCUA_Types, y sgcOPCUAVariantToDelphi en sgcOPCUA_Encoding; añade esas unidades cuando las uses. Delphi 7 a 2006 necesitan además sgcBase_Helpers para TBytes.

Un cliente OPC UA pensado para la planta de producción

Suscripciones, filtros y reconexión resueltos por ti, con eventos donde los quieras.

Suscripciones sin sondeo

CreateSubscription establece el intervalo de publicación y AddMonitoredItem el intervalo de muestreo y el tamaño de la cola de cada nodo. El componente mantiene suficientes peticiones Publish en curso, confirma cada notificación y pide al servidor que vuelva a publicar cualquier mensaje que se haya perdido.

Banda muerta y disparadores

Una banda muerta absoluta (uadbtAbsolute) o un porcentaje del EURange (uadbtPercent) mantiene el ruido fuera de tus manejadores. El disparador elige si se informa de un cambio de estado, un cambio de valor o una nueva marca de tiempo.

Eventos y alarmas

AddEventMonitoredItem recibe los campos del evento que se devolverán, como Message, Severity y SourceName, y una cláusula where opcional. Suscríbete a una sola fuente o al objeto Server para recibir todos los eventos del servidor.

Reconexión WatchDog

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 las suscripciones, o las crea de nuevo. OnReconnect informa de qué camino se siguió.

Los mismos objetos tras una reconexión

Las suscripciones y los elementos monitorizados pertenecen al cliente y sobreviven a una reconexión de WatchDog. Los ids del servidor pueden cambiar, pero el ClientHandle de un elemento nunca, así que tus manejadores siguen funcionando.

Eventos donde los quieres

OnDataChange, OnEvent, OnKeepAlive, OnConnect, OnDisconnect y OnError se entregan a través de NotifyEvents: encolados en el hilo principal por defecto, sincronizados, o lanzados en los hilos del cliente para servicios y aplicaciones de consola.

Firmado y cifrado, con valores por defecto seguros

Establece SecurityPolicy a opcspBasic256Sha256, opcspAes128_Sha256_RsaOaep o opcspAes256_Sha256_RsaPss, y SecurityMode a opcsmSign o opcsmSignAndEncrypt. opcspBasic128Rsa15 y opcspBasic256 están obsoletas según la OPC Foundation y existen para servidores antiguos. El cliente elige el punto final correspondiente de GetEndpoints y, cuando ninguno coincide, el error enumera lo que ofrece el servidor.

Certificado de aplicación

Application.CertificateFile y PrivateKeyFile cargan el certificado de la instancia. Cuando los archivos aún no existen, el cliente crea el certificado y lo guarda allí, de modo que el administrador del servidor solo tiene que confiar en él una vez. Si no se indica ningún archivo, se crea en memoria.

Certificado del servidor

Un certificado de servidor se rechaza a menos que OnValidateServerCertificate lo acepte, así que un cliente nuevo nunca confía por accidente en un servidor desconocido. AutoAcceptServerCertificate existe para bancos de pruebas.

Identidad de usuario

Authentication.AuthenticationType selecciona Anonymous, usuario y contraseña, o un certificado de usuario X.509. La contraseña se cifra con la clave del servidor siempre que la política de tokens del servidor lo pida.

Probado contra una pila OPC UA independiente

El cliente se prueba sobre el cable contra un servidor de referencia construido con asyncua, una implementación OPC UA independiente de código abierto: los once puntos finales del servidor (todas las políticas y modos), los tres tipos de identidad, la exploración de 1,000 referencias con puntos de continuación, la lectura de 18 tipos integrados con arrays y una matriz, la escritura de escalares y arrays, las llamadas a métodos, las suscripciones de cambio de datos y de eventos con bandas muertas y cláusulas where, una ejecución de publicación de dos minutos sin ningún mensaje perdido ni duplicado, y cada camino de reconexión de WatchDog.

Preguntas sobre OPC UA en Delphi

Crea un TsgcOPCUAClient, establece EndpointUrl con la dirección opc.tcp del servidor, llama a Connect y luego a ReadValue('ns=2;s=Line1.Speed'). Devuelve un Variant. Read lee varios nodos y atributos en una sola llamada.

Llama a CreateSubscription con el intervalo de publicación, añade los nodos con AddMonitoredItem y asigna OnDataChange. El evento recibe la suscripción, el elemento monitorizado y el nuevo TsgcOPCUADataValue con su código de estado y sus marcas de tiempo.

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.

Con WatchDog.Enabled, el cliente reintenta cada WatchDog.Interval segundos. 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.

Sí. Establece NotifyEvents := neNoSync cuando no hay bucle de mensajes: los eventos se ejecutan entonces en los hilos del cliente. No llames a Connect ni a otros servicios bloqueantes desde esos eventos; deja que WatchDog reconecte.

Delphi 7 a Delphi 13 y C++Builder, en Windows (32 y 64 bits) y Linux de 64 bits.

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 componentes industriales en sgcWebSockets

Componentes industriales

Puerto serie, Modbus y OPC UA en una sola sección, con la referencia completa de componentes.

Referencia del cliente OPC UA

Propiedades, métodos y eventos de TsgcOPCUAClient, con ejemplos en C++Builder y C#.

Delphi Modbus TCP y RTU

Clientes y servidores Modbus para los dispositivos que no hablan OPC UA.

Cliente MQTT para Delphi

Reenvía los cambios de datos OPC UA a temas MQTT: la pasarela habitual de la planta a la nube.

También para C# y .NET

El mismo cliente OPC UA, con los mismos nombres de clase, para .NET 8, 9, 10 y .NET Standard 2.0.

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 Delphi

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