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.
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
Servizi
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.
Gestito dal componente: OnDataChange, OnEvent, OnKeepAlive, WatchDog
QuickStart
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);
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;
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.
Client
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.
Sicurezza
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.
Interoperabilità
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.
FAQ
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.