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.
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
Servicios
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.
Lo hace el componente: OnDataChange, OnEvent, OnKeepAlive, WatchDog
QuickStart
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);
excepton 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 := 0to Length(vRefs) - 1do
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);
beginif 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);
beginif aState = opccsReconnecting then
Memo1.Lines.Add('Connection lost, reconnecting');
end;
procedure TForm1.OnOPCUAReconnect(Sender: TObject; aMethod: TsgcOPCUAReconnectMethod);
begincase 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.
Cliente
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.
Seguridad
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.
Interoperabilidad
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.
FAQ
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.