Nouveau

Composant client OPC UA Delphi

Un client OPC UA natif pour Delphi et C++Builder. Parcours, lis et écris les variables d'automates, de serveurs SCADA et de passerelles industrielles, appelle leurs méthodes et reçois les changements de données et les alarmes grâce aux abonnements, sur une connexion opc.tcp signée et chiffrée qui se reconnecte toute seule.

Inclus dans sgcWebSockets Enterprise (Delphi et .NET) et All-Access, ou dans le pack autonome sgcIndustrial.

Un seul composant pour le côté client d'OPC UA

Canal sécurisé, session, services et abonnements dans un composant non visuel, écrit en Pascal et compilé dans ton application.

Un client OPC UA Delphi permet à une application VCL, FMX, service ou console de lire les données que les machines, les automates et les systèmes SCADA publient via un serveur OPC UA, et d'écrire en retour des consignes et des commandes. sgcWebSockets le fournit sous le nom TsgcOPCUAClient : renseigne EndpointUrl, choisis SecurityPolicy et SecurityMode, appelle Connect et travaille avec des identifiants de nœuds comme ns=2;s=Line1.Speed ou i=2253.

Les appels de service bloquent jusqu'à la réponse du serveur et lèvent EsgcOPCUAError avec le code d'état OPC UA en cas d'échec. ReadValue renvoie un Variant Delphi, et WriteValue lit d'abord le type de données du nœud, si bien que WriteValue('ns=2;s=Line1.Setpoint', 75.5) écrit un Float ou un Double comme le nœud l'attend. Une seule ligne uses sgcIndustrial; apporte le composant, ses types et ses énumérations.

Classe de composant

TsgcOPCUAClient, avec TsgcOPCUASubscription et TsgcOPCUAMonitoredItem

Transport

OPC UA binaire sur opc.tcp, le transport qu'exposent les automates et les serveurs SCADA

Sécurité

Sign et SignAndEncrypt avec Basic256Sha256, Aes128_Sha256_RsaOaep et Aes256_Sha256_RsaPss

Plateformes

Delphi 7 à Delphi 13 et C++Builder ; Windows 32 et 64 bits et Linux 64 bits

Les services OPC UA, une méthode chacun

Les surcharges simples prennent des chaînes d'identifiants de nœuds ; les surcharges complètes prennent les enregistrements de requête de la spécification.

Ensemble de servicesServiceMéthode
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
MéthodeCallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptionsGéré par le composant : OnDataChange, OnEvent, OnKeepAlive, WatchDog

Lis une machine en quelques lignes de Delphi

Crée le composant, renseigne le point d'accès, appelle une méthode. Chaque exemple de cette page compile avec Delphi 7 et 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;

Les fonctions utilitaires sgcOPCUANodeIdToString et sgcOPCUAVariantSimple se trouvent dans sgcOPCUA_Types, et sgcOPCUAVariantToDelphi dans sgcOPCUA_Encoding ; ajoute ces unités quand tu les utilises. Delphi 7 à 2006 ont aussi besoin de sgcBase_Helpers pour TBytes.

Un client OPC UA conçu pour l'atelier

Abonnements, filtres et reconnexion gérés pour toi, avec des événements là où tu les veux.

Des abonnements sans interrogation

CreateSubscription définit l'intervalle de publication, AddMonitoredItem l'intervalle d'échantillonnage et la taille de la file de chaque nœud. Le composant garde assez de requêtes Publish en vol, acquitte chaque notification et demande au serveur de republier tout message perdu.

Zone morte et déclencheurs

Une zone morte absolue (uadbtAbsolute) ou un pourcentage de l'EURange (uadbtPercent) garde le bruit hors de tes gestionnaires. Le déclencheur choisit si un changement d'état, un changement de valeur ou un nouvel horodatage est signalé.

Événements et alarmes

AddEventMonitoredItem prend les champs d'événement à renvoyer, comme Message, Severity et SourceName, et une clause where facultative. Abonne-toi à une seule source ou à l'objet Server pour tous les événements du serveur.

Reconnexion WatchDog

Après une coupure réseau, WatchDog réactive d'abord la même session et republie les notifications manquées. Si la session a disparu, il en ouvre une nouvelle et transfère les abonnements, ou les recrée. OnReconnect indique quel chemin a été suivi.

Les mêmes objets après une reconnexion

Les abonnements et les éléments surveillés appartiennent au client et survivent à une reconnexion WatchDog. Les identifiants du serveur peuvent changer, le ClientHandle d'un élément jamais, donc tes gestionnaires continuent de fonctionner.

Des événements là où tu les veux

OnDataChange, OnEvent, OnKeepAlive, OnConnect, OnDisconnect et OnError sont livrés via NotifyEvents : mis en file vers le thread principal par défaut, synchronisés, ou déclenchés dans les threads du client pour les services et les applications console.

Signé et chiffré, avec des valeurs par défaut sûres

Mets SecurityPolicy à opcspBasic256Sha256, opcspAes128_Sha256_RsaOaep ou opcspAes256_Sha256_RsaPss et SecurityMode à opcsmSign ou opcsmSignAndEncrypt. opcspBasic128Rsa15 et opcspBasic256 sont dépréciés par l'OPC Foundation et ne sont là que pour les anciens serveurs. Le client choisit le point d'accès correspondant dans GetEndpoints et, si aucun ne correspond, l'erreur liste ce que le serveur propose.

Certificat d'application

Application.CertificateFile et PrivateKeyFile chargent le certificat de l'instance. Quand les fichiers n'existent pas encore, le client crée le certificat et l'y enregistre, de sorte que l'administrateur du serveur n'a à lui faire confiance qu'une fois. Sans fichiers renseignés, il est créé en mémoire.

Certificat du serveur

Un certificat de serveur est rejeté à moins que OnValidateServerCertificate ne l'accepte, donc un client neuf ne fait jamais confiance à un serveur inconnu par accident. AutoAcceptServerCertificate existe pour les bancs de test.

Identité de l'utilisateur

Authentication.AuthenticationType sélectionne Anonymous, nom d'utilisateur et mot de passe, ou un certificat utilisateur X.509. Le mot de passe est chiffré avec la clé du serveur chaque fois que la politique de jeton du serveur le demande.

Testé contre une pile OPC UA indépendante

Le client est testé sur le fil contre un serveur de référence construit sur asyncua, une implémentation OPC UA open source indépendante : les onze points d'accès du serveur (chaque politique et chaque mode), les trois types d'identité, la navigation dans 1 000 références avec points de continuation, la lecture de 18 types intégrés avec tableaux et matrice, l'écriture de scalaires et de tableaux, les appels de méthodes, les abonnements aux changements de données et aux événements avec zones mortes et clauses where, une exécution de publication de deux minutes sans message perdu ni dupliqué, et chaque chemin de reconnexion du WatchDog.

Questions sur le client OPC UA Delphi

Crée un TsgcOPCUAClient, mets dans EndpointUrl l'adresse opc.tcp du serveur, appelle Connect puis ReadValue('ns=2;s=Line1.Speed'). Il renvoie un Variant. Read lit plusieurs nœuds et attributs en un seul appel.

Appelle CreateSubscription avec l'intervalle de publication, ajoute les nœuds avec AddMonitoredItem et assigne OnDataChange. L'événement reçoit l'abonnement, l'élément surveillé et le nouveau TsgcOPCUADataValue avec son code d'état et ses horodatages.

Basic256Sha256, Aes128_Sha256_RsaOaep et Aes256_Sha256_RsaPss en mode Sign ou SignAndEncrypt, plus Basic128Rsa15 et Basic256 (dépréciés) pour les anciens serveurs, et None pour les bancs de test.

Avec WatchDog.Enabled, le client réessaie toutes les WatchDog.Interval secondes. Il réactive la même session si le serveur la possède encore, sinon il ouvre une nouvelle session et transfère ou recrée les abonnements. OnReconnect indique quel chemin a été suivi, et tes objets d'abonnement restent valides.

Oui. Mets NotifyEvents := neNoSync quand il n'y a pas de boucle de messages : les événements s'exécutent alors dans les threads du client. N'appelle pas Connect ni d'autres services bloquants depuis ces événements ; laisse WatchDog se reconnecter.

Delphi 7 à Delphi 13 et C++Builder, sous Windows (32 et 64 bits) et Linux 64 bits.

Le client OPC UA est inclus dans sgcWebSockets Enterprise (Delphi et .NET) et All-Access, ou dans le pack autonome sgcIndustrial. Il n'inclut pas de serveur OPC UA, ni les transports HTTPS, JSON et WebSocket, HistoryRead, PubSub, Reverse Connect et le Global Discovery Server.

Plus de composants industriels dans sgcWebSockets

Composants industriels

Port série, Modbus et OPC UA dans une seule section, avec la référence complète des composants.

Référence du client OPC UA

Propriétés, méthodes et événements de TsgcOPCUAClient, avec des exemples C++Builder et C#.

Modbus TCP et RTU pour Delphi

Des clients et serveurs Modbus pour les appareils qui ne parlent pas OPC UA.

Client MQTT pour Delphi

Transmets les changements de données OPC UA vers des topics MQTT : la passerelle habituelle entre l'usine et le cloud.

Aussi pour C# et .NET

Le même client OPC UA, avec les mêmes noms de classes, pour .NET 8, 9, 10 et .NET Standard 2.0.

Meilleur rapport qualité-prix : All-AccessTous les produits eSeGeCe, Support Premium inclus, à partir de €1,059/an.
Voir les tarifs All-Access

Lis ton premier nœud OPC UA depuis Delphi

Inclus dans sgcWebSockets Enterprise (Delphi et .NET) et All-Access, ou dans le pack autonome sgcIndustrial.