Novo

Componente cliente OPC UA para Delphi

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.

Um componente para o lado cliente do OPC UA

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

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.

Conjunto de serviçosServiçoMétodo
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
MétodoCallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptionsFeito pelo componente: OnDataChange, OnEvent, OnKeepAlive, WatchDog

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

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.

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.

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.

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.

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.

Mais componentes industriais no sgcWebSockets

Componentes industriais

Porta serial, Modbus e OPC UA em uma seção, com a referência completa dos componentes.

Referência do cliente OPC UA

Propriedades, métodos e eventos do TsgcOPCUAClient, com exemplos em C++Builder e C#.

Delphi Modbus TCP e RTU

Clientes e servidores Modbus para os dispositivos que não falam OPC UA.

Cliente MQTT para Delphi

Encaminhe mudanças de dados OPC UA para tópicos MQTT: o gateway usual da planta para a nuvem.

Também para C# e .NET

O mesmo cliente OPC UA, com os mesmos nomes de classes, para .NET 8, 9, 10 e .NET Standard 2.0.

Melhor custo-benefício: All-AccessTodos os produtos da eSeGeCe, com Suporte Premium incluído, a partir de €1,059/ano.
Ver preços do All-Access

Leia seu primeiro nó OPC UA a partir do Delphi

Incluído no sgcWebSockets Enterprise (Delphi e .NET) e All-Access, ou no pacote independente sgcIndustrial.