Um cliente OPC UA nativo para Delphi e C++Builder. Navegue, leia e grave as variáveis de CLPs, servidores SCADA e gateways industriais, chame seus métodos e receba mudanças de dados e alarmes por subscriptions, em uma conexão opc.tcp assinada e criptografada que se reconecta sozinha.
Incluído no sgcWebSockets Enterprise (Delphi e .NET) e All-Access, ou no pacote independente sgcIndustrial.
Canal seguro, sessão, serviços e subscriptions em um componente não visual, escrito em Pascal e compilado dentro da sua aplicação.
Um cliente OPC UA para Delphi permite que uma aplicação VCL, FMX, serviço ou console leia os dados que máquinas, CLPs e sistemas SCADA publicam por um servidor OPC UA, e grave de volta setpoints e comandos. O sgcWebSockets o oferece como TsgcOPCUAClient: defina EndpointUrl, escolha SecurityPolicy e SecurityMode, chame Connect e trabalhe com node ids como ns=2;s=Line1.Speed ou i=2253.
As chamadas de serviço bloqueiam até o servidor responder e geram EsgcOPCUAError com o código de status OPC UA quando falham. ReadValue retorna um Variant do Delphi, e WriteValue lê primeiro o tipo de dado do nó, de modo que WriteValue('ns=2;s=Line1.Setpoint', 75.5) grava um Float ou um Double como o nó espera. Uma única linha uses sgcIndustrial; traz o componente, seus tipos e suas enumerações.
Classe de componente
TsgcOPCUAClient, com TsgcOPCUASubscription e TsgcOPCUAMonitoredItem
Transporte
OPC UA binário sobre opc.tcp, o transporte que CLPs e servidores SCADA expõem
Segurança
Sign e SignAndEncrypt com Basic256Sha256, Aes128_Sha256_RsaOaep e Aes256_Sha256_RsaPss
Plataformas
Delphi 7 a Delphi 13 e C++Builder; Windows 32 e 64 bits e Linux 64 bits
Serviços
Os serviços OPC UA, um método para cada
As sobrecargas simples recebem node ids como strings; as sobrecargas completas recebem os registros de requisição da especificação.
Feito pelo componente: OnDataChange, OnEvent, OnKeepAlive, WatchDog
QuickStart
Leia uma máquina em poucas linhas de Delphi
Crie o componente, defina o endpoint, chame um método. Todos os exemplos desta página compilam com Delphi 7 e 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;
As funções auxiliares sgcOPCUANodeIdToString e sgcOPCUAVariantSimple ficam em sgcOPCUA_Types, e sgcOPCUAVariantToDelphi em sgcOPCUA_Encoding; adicione essas units quando usá-las. Do Delphi 7 ao 2006 também é necessário sgcBase_Helpers para TBytes.
Cliente
Um cliente OPC UA feito para o chão de fábrica
Subscriptions, filtros e reconexão tratados para você, com eventos onde você quiser.
Subscriptions sem polling
CreateSubscription define o intervalo de publicação, AddMonitoredItem o intervalo de amostragem e o tamanho da fila de cada nó. O componente mantém requisições Publish suficientes em andamento, confirma cada notificação e pede ao servidor que republique qualquer mensagem perdida.
Deadband e triggers
Um deadband absoluto (uadbtAbsolute) ou um percentual do EURange (uadbtPercent) mantém o ruído fora dos seus handlers. O trigger escolhe se uma mudança de status, uma mudança de valor ou um novo timestamp é reportado.
Eventos e alarmes
AddEventMonitoredItem recebe os campos do evento a retornar, como Message, Severity e SourceName, e uma cláusula where opcional. Assine uma única origem ou o objeto Server para todos os eventos do servidor.
Reconexão via WatchDog
Após uma queda de rede, o WatchDog primeiro reativa a mesma sessão e republica as notificações perdidas. Se a sessão não existir mais, abre uma nova e transfere as subscriptions, ou as cria novamente. OnReconnect informa qual caminho foi seguido.
Os mesmos objetos após uma reconexão
Subscriptions e monitored items pertencem ao cliente e sobrevivem a uma reconexão do WatchDog. Os ids do servidor podem mudar, o ClientHandle de um item nunca muda, então seus handlers continuam funcionando.
Eventos onde você precisa deles
OnDataChange, OnEvent, OnKeepAlive, OnConnect, OnDisconnect e OnError são entregues por NotifyEvents: enfileirados para a thread principal por padrão, sincronizados, ou disparados nas threads do cliente para serviços e aplicações console.
Segurança
Assinado e criptografado, com padrões seguros
Defina SecurityPolicy como opcspBasic256Sha256, opcspAes128_Sha256_RsaOaep ou opcspAes256_Sha256_RsaPss e SecurityMode como opcsmSign ou opcsmSignAndEncrypt. opcspBasic128Rsa15 e opcspBasic256 estão obsoletas pela OPC Foundation e existem para servidores mais antigos. O cliente escolhe o endpoint correspondente em GetEndpoints e, quando nenhum corresponde, o erro lista o que o servidor oferece.
Certificado da aplicação
Application.CertificateFile e PrivateKeyFile carregam o certificado da instância. Quando os arquivos ainda não existem, o cliente cria o certificado e o salva ali, de modo que o administrador do servidor o confie uma única vez. Sem arquivos definidos, ele é criado em memória.
Certificado do servidor
Um certificado de servidor é rejeitado, a menos que OnValidateServerCertificate o aceite, então um cliente novo nunca confia em um servidor desconhecido por acidente. AutoAcceptServerCertificate existe para bancadas de teste.
Identidade do usuário
Authentication.AuthenticationType seleciona Anonymous, usuário e senha, ou um certificado de usuário X.509. A senha é criptografada com a chave do servidor sempre que a token policy do servidor exigir.
Interoperabilidade
Testado contra uma pilha OPC UA independente
O cliente é testado na rede contra um servidor de referência construído sobre o asyncua, uma implementação OPC UA open source independente: os onze endpoints do servidor (todas as políticas e modos), os três tipos de identidade, navegação em 1.000 referências com continuation points, leitura de 18 tipos built-in com arrays e uma matriz, gravação de escalares e arrays, chamadas de método, subscriptions de mudança de dados e de eventos com deadbands e cláusulas where, uma execução de publish de dois minutos sem mensagem perdida ou duplicada e cada caminho de reconexão do WatchDog.
FAQ
Perguntas sobre OPC UA em Delphi
Crie um TsgcOPCUAClient, defina EndpointUrl com o endereço opc.tcp do servidor, chame Connect e depois ReadValue('ns=2;s=Line1.Speed'). Ele retorna um Variant. Read lê vários nós e atributos em uma única chamada.
Chame CreateSubscription com o intervalo de publicação, adicione os nós com AddMonitoredItem e atribua OnDataChange. O evento recebe a subscription, o monitored item e o novo TsgcOPCUADataValue com seu código de status e timestamps.
Basic256Sha256, Aes128_Sha256_RsaOaep e Aes256_Sha256_RsaPss nos modos Sign ou SignAndEncrypt, além das obsoletas Basic128Rsa15 e Basic256 para servidores mais antigos, e None para bancadas de teste.
Com WatchDog.Enabled o cliente tenta novamente a cada WatchDog.Interval segundos. Ele reativa a mesma sessão quando o servidor ainda a mantém; caso contrário, abre uma nova sessão e transfere ou recria as subscriptions. OnReconnect informa qual caminho foi seguido, e seus objetos de subscription continuam válidos.
Sim. Defina NotifyEvents := neNoSync quando não houver loop de mensagens: os eventos então são executados nas threads do cliente. Não chame Connect nem outros serviços bloqueantes a partir desses eventos; deixe o WatchDog reconectar.
Delphi 7 a Delphi 13 e C++Builder, no Windows (32 e 64 bits) e Linux 64 bits.
O cliente OPC UA está incluído no sgcWebSockets Enterprise (Delphi e .NET) e All-Access, ou no pacote independente sgcIndustrial. Ele não inclui um servidor OPC UA, os transportes HTTPS, JSON e WebSocket, HistoryRead, PubSub, Reverse Connect e o Global Discovery Server.