Novità

Componente client OPC UA per Delphi

Un client OPC UA nativo per Delphi e C++Builder. Esplora, leggi e scrivi le variabili di PLC, server SCADA e gateway industriali, chiama i loro metodi e ricevi variazioni di dati e allarmi tramite sottoscrizioni, su una connessione opc.tcp firmata e cifrata che si riconnette da sola.

Incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial.

Un unico componente per il lato client di OPC UA

Canale sicuro, sessione, servizi e sottoscrizioni in un componente non visuale, scritto in Pascal e compilato nella tua applicazione.

Un client OPC UA per Delphi permette a un'applicazione VCL, FMX, a un servizio o a una console di leggere i dati che macchine, PLC e sistemi SCADA pubblicano tramite un server OPC UA, e di riscrivere setpoint e comandi. sgcWebSockets lo fornisce come TsgcOPCUAClient: imposta EndpointUrl, scegli SecurityPolicy e SecurityMode, chiama Connect e lavora con node id come ns=2;s=Line1.Speed o i=2253.

Le chiamate ai servizi si bloccano finché il server non risponde e sollevano EsgcOPCUAError con il codice di stato OPC UA quando falliscono. ReadValue restituisce un Variant Delphi, e WriteValue legge prima il tipo di dato del nodo, così WriteValue('ns=2;s=Line1.Setpoint', 75.5) scrive un Float o un Double come il nodo si aspetta. Una sola riga uses sgcIndustrial; include il componente, i suoi tipi e le sue enumerazioni.

Classe del componente

TsgcOPCUAClient, con TsgcOPCUASubscription e TsgcOPCUAMonitoredItem

Trasporto

OPC UA binary su opc.tcp, il trasporto esposto da PLC e server SCADA

Sicurezza

Sign e SignAndEncrypt con Basic256Sha256, Aes128_Sha256_RsaOaep e Aes256_Sha256_RsaPss

Piattaforme

Da Delphi 7 a Delphi 13 e C++Builder; Windows a 32 e 64 bit e Linux a 64 bit

I servizi OPC UA, un metodo ciascuno

Gli overload semplici accettano node id come stringhe; gli overload completi accettano i record di richiesta della specifica.

Service setServizioMetodo
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
MetodoCallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptionsGestito dal componente: OnDataChange, OnEvent, OnKeepAlive, WatchDog

Leggi una macchina in poche righe di Delphi

Crea il componente, imposta l'endpoint, chiama un metodo. Ogni esempio di questa pagina si compila con 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;

Le funzioni di supporto sgcOPCUANodeIdToString e sgcOPCUAVariantSimple si trovano in sgcOPCUA_Types, e sgcOPCUAVariantToDelphi in sgcOPCUA_Encoding; aggiungi queste unit quando le usi. Da Delphi 7 a 2006 serve anche sgcBase_Helpers per TBytes.

Un client OPC UA pensato per il reparto produttivo

Sottoscrizioni, filtri e riconnessione gestiti per te, con eventi dove li vuoi.

Sottoscrizioni senza polling

CreateSubscription imposta l'intervallo di pubblicazione, AddMonitoredItem l'intervallo di campionamento e la dimensione della coda di ogni nodo. Il componente mantiene in volo un numero sufficiente di richieste Publish, conferma ogni notifica e chiede al server di ripubblicare qualsiasi messaggio andato perso.

Deadband e trigger

Una deadband assoluta (uadbtAbsolute) o una percentuale dell'EURange (uadbtPercent) tiene il rumore fuori dai tuoi gestori. Il trigger sceglie se vengono segnalati una variazione di stato, una variazione di valore o un nuovo timestamp.

Eventi e allarmi

AddEventMonitoredItem accetta i campi dell'evento da restituire, come Message, Severity e SourceName, e una clausola where opzionale. Sottoscrivi una singola sorgente o l'oggetto Server per ricevere tutti gli eventi del server.

Riconnessione WatchDog

Dopo una caduta di rete, WatchDog riattiva prima la stessa sessione e ripubblica le notifiche perse. Se la sessione non esiste più, ne apre una nuova e trasferisce le sottoscrizioni, oppure le crea di nuovo. OnReconnect segnala quale percorso è stato seguito.

Gli stessi oggetti dopo una riconnessione

Sottoscrizioni e monitored item appartengono al client e sopravvivono a una riconnessione di WatchDog. Gli id del server possono cambiare, il ClientHandle di un item mai, quindi i tuoi gestori continuano a funzionare.

Eventi dove vuoi tu

OnDataChange, OnEvent, OnKeepAlive, OnConnect, OnDisconnect e OnError vengono consegnati tramite NotifyEvents: accodati al thread principale per impostazione predefinita, sincronizzati, oppure sollevati nei thread del client per servizi e applicazioni console.

Firmato e cifrato, con impostazioni predefinite sicure

Imposta SecurityPolicy su opcspBasic256Sha256, opcspAes128_Sha256_RsaOaep o opcspAes256_Sha256_RsaPss e SecurityMode su opcsmSign o opcsmSignAndEncrypt. opcspBasic128Rsa15 e opcspBasic256 sono deprecati dalla OPC Foundation e sono presenti per i server meno recenti. Il client sceglie l'endpoint corrispondente da GetEndpoints e, quando nessuno corrisponde, l'errore elenca ciò che il server offre.

Certificato dell'applicazione

Application.CertificateFile e PrivateKeyFile caricano il certificato dell'istanza. Quando i file non esistono ancora, il client crea il certificato e lo salva lì, così l'amministratore del server lo considera attendibile una sola volta. Se non sono impostati file, viene creato in memoria.

Certificato del server

Un certificato del server viene rifiutato a meno che OnValidateServerCertificate non lo accetti, così un client nuovo non si fida mai per caso di un server sconosciuto. AutoAcceptServerCertificate esiste per i banchi di prova.

Identità utente

Authentication.AuthenticationType seleziona Anonymous, nome utente e password, oppure un certificato utente X.509. La password viene cifrata con la chiave del server ogni volta che la token policy del server lo richiede.

Testato con uno stack OPC UA indipendente

Il client è testato sul cavo con un server di riferimento basato su asyncua, un'implementazione OPC UA open source indipendente: tutti gli undici endpoint del server (ogni policy e modalità), i tre tipi di identità, il browse di 1.000 riferimenti con continuation point, la lettura di 18 tipi built-in con array e matrice, la scrittura di scalari e array, le chiamate ai metodi, le sottoscrizioni a variazioni di dati ed eventi con deadband e clausole where, una prova di pubblicazione di due minuti senza messaggi persi o duplicati e ciascun percorso di riconnessione di WatchDog.

Domande su OPC UA in Delphi

Crea un TsgcOPCUAClient, imposta EndpointUrl sull'indirizzo opc.tcp del server, chiama Connect e poi ReadValue('ns=2;s=Line1.Speed'). Restituisce un Variant. Read legge più nodi e attributi in una sola chiamata.

Chiama CreateSubscription con l'intervallo di pubblicazione, aggiungi i nodi con AddMonitoredItem e assegna OnDataChange. L'evento riceve la sottoscrizione, il monitored item e il nuovo TsgcOPCUADataValue con il suo codice di stato e i timestamp.

Basic256Sha256, Aes128_Sha256_RsaOaep e Aes256_Sha256_RsaPss in modalità Sign o SignAndEncrypt, più le deprecate Basic128Rsa15 e Basic256 per i server meno recenti, e None per i banchi di prova.

Con WatchDog.Enabled il client riprova ogni WatchDog.Interval secondi. Riattiva la stessa sessione se il server la conserva ancora, altrimenti apre una nuova sessione e trasferisce o ricrea le sottoscrizioni. OnReconnect segnala quale percorso è stato seguito, e i tuoi oggetti di sottoscrizione restano validi.

Sì. Imposta NotifyEvents := neNoSync quando non c'è un message loop: gli eventi vengono allora eseguiti nei thread del client. Non chiamare Connect o altri servizi bloccanti da quegli eventi; lascia che sia WatchDog a riconnettere.

Da Delphi 7 a Delphi 13 e C++Builder, su Windows (32 e 64 bit) e Linux a 64 bit.

Il client OPC UA è incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial. Non include un server OPC UA, i trasporti HTTPS, JSON e WebSocket, HistoryRead, PubSub, Reverse Connect e il Global Discovery Server.

Altri componenti industriali in sgcWebSockets

Componenti industriali

Porta seriale, Modbus e OPC UA in un'unica sezione, con il riferimento completo dei componenti.

Riferimento del client OPC UA

Proprietà, metodi ed eventi di TsgcOPCUAClient, con esempi in C++Builder e C#.

Delphi Modbus TCP e RTU

Client e server Modbus per i dispositivi che non parlano OPC UA.

Client MQTT Delphi

Inoltra le variazioni di dati OPC UA a topic MQTT: il tipico gateway dall'impianto al cloud.

Anche per C# e .NET

Lo stesso client OPC UA, con gli stessi nomi di classi, per .NET 8, 9, 10 e .NET Standard 2.0.

La scelta più conveniente: All-AccessTutti i prodotti eSeGeCe, con Supporto Premium incluso, a partire da €1,059/anno.
Vedi i prezzi All-Access

Leggi il tuo primo nodo OPC UA da Delphi

Incluso in sgcWebSockets Enterprise (Delphi e .NET) e All-Access, oppure nel pacchetto standalone sgcIndustrial.