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.
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
Services
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.
Géré par le composant : OnDataChange, OnEvent, OnKeepAlive, WatchDog
QuickStart
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);
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;
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.
Client
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.
Sécurité
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.
Interopérabilité
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.
FAQ
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.