Natywny klient OPC UA dla Delphi i C++Builder. Przeglądaj, odczytuj i zapisuj zmienne sterowników PLC, serwerów SCADA i bram przemysłowych, wywołuj ich metody oraz odbieraj zmiany danych i alarmy przez subskrypcje, w podpisanym i szyfrowanym połączeniu opc.tcp, które samo się odtwarza.
W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial.
Bezpieczny kanał, sesja, usługi i subskrypcje w komponencie niewizualnym, napisanym w Pascalu i kompilowanym do Twojej aplikacji.
Klient OPC UA dla Delphi pozwala aplikacji VCL, FMX, usłudze lub aplikacji konsolowej odczytywać dane, które maszyny, sterowniki PLC i systemy SCADA publikują przez serwer OPC UA, oraz zapisywać z powrotem wartości zadane i polecenia. sgcWebSockets dostarcza go jako TsgcOPCUAClient: ustaw EndpointUrl, wybierz SecurityPolicy i SecurityMode, wywołaj Connect i pracuj z identyfikatorami węzłów, takimi jak ns=2;s=Line1.Speed lub i=2253.
Wywołania usług blokują do odpowiedzi serwera i w razie niepowodzenia zgłaszają EsgcOPCUAError z kodem statusu OPC UA. ReadValue zwraca Variant Delphi, a WriteValue najpierw odczytuje typ danych węzła, więc WriteValue('ns=2;s=Line1.Setpoint', 75.5) zapisuje Float lub Double zgodnie z oczekiwaniami węzła. Jedna linia uses sgcIndustrial; dołącza komponent, jego typy i wyliczenia.
Klasa komponentu
TsgcOPCUAClient wraz z TsgcOPCUASubscription i TsgcOPCUAMonitoredItem
Transport
Binarny OPC UA przez opc.tcp, transport udostępniany przez sterowniki PLC i serwery SCADA
Bezpieczeństwo
Sign i SignAndEncrypt z Basic256Sha256, Aes128_Sha256_RsaOaep i Aes256_Sha256_RsaPss
Platformy
Od Delphi 7 do Delphi 13 i C++Builder; Windows 32 i 64 bity oraz Linux 64 bity
Usługi
Usługi OPC UA, po jednej metodzie na każdą
Proste przeciążenia przyjmują identyfikatory węzłów jako ciągi znaków; pełne przeciążenia przyjmują rekordy żądań ze specyfikacji.
Realizowane przez komponent: OnDataChange, OnEvent, OnKeepAlive, WatchDog
QuickStart
Odczyt maszyny w kilku liniach Delphi
Utwórz komponent, ustaw punkt końcowy, wywołaj metodę. Każdy przykład na tej stronie kompiluje się w Delphi 7 i 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;
Funkcje pomocnicze sgcOPCUANodeIdToString i sgcOPCUAVariantSimple znajdują się w sgcOPCUA_Types, a sgcOPCUAVariantToDelphi w sgcOPCUA_Encoding; dodaj te jednostki, gdy z nich korzystasz. Delphi 7 do 2006 wymagają też sgcBase_Helpers dla TBytes.
Klient
Klient OPC UA zbudowany dla hali produkcyjnej
Subskrypcje, filtry i ponowne łączenie obsługiwane za Ciebie, ze zdarzeniami tam, gdzie ich potrzebujesz.
Subskrypcje bez odpytywania
CreateSubscription ustawia interwał publikowania, a AddMonitoredItem interwał próbkowania i rozmiar kolejki każdego węzła. Komponent utrzymuje w locie wystarczającą liczbę żądań Publish, potwierdza każde powiadomienie i prosi serwer o ponowną publikację każdej utraconej wiadomości.
Deadband i wyzwalacze
Bezwzględny deadband (uadbtAbsolute) lub procent EURange (uadbtPercent) trzyma szum z dala od Twoich obsług zdarzeń. Wyzwalacz wybiera, czy raportowana jest zmiana statusu, zmiana wartości, czy nowy znacznik czasu.
Zdarzenia i alarmy
AddEventMonitoredItem przyjmuje pola zdarzenia do zwrócenia, takie jak Message, Severity i SourceName, oraz opcjonalną klauzulę where. Subskrybuj pojedyncze źródło albo obiekt Server, aby otrzymywać każde zdarzenie serwera.
Ponowne łączenie WatchDog
Po zerwaniu sieci WatchDog najpierw reaktywuje tę samą sesję i ponownie publikuje pominięte powiadomienia. Jeśli sesji już nie ma, otwiera nową i przenosi subskrypcje albo tworzy je od nowa. OnReconnect informuje, która ścieżka została wybrana.
Te same obiekty po ponownym połączeniu
Subskrypcje i monitorowane elementy należą do klienta i przetrwają ponowne połączenie WatchDog. Identyfikatory serwera mogą się zmienić, a ClientHandle elementu nigdy, więc Twoje obsługi zdarzeń działają dalej.
Zdarzenia tam, gdzie ich potrzebujesz
OnDataChange, OnEvent, OnKeepAlive, OnConnect, OnDisconnect i OnError są dostarczane przez NotifyEvents: domyślnie kolejkowane do głównego wątku, synchronizowane albo wywoływane w wątkach klienta dla usług i aplikacji konsolowych.
Bezpieczeństwo
Podpisane i szyfrowane, z bezpiecznymi ustawieniami domyślnymi
Ustaw SecurityPolicy na opcspBasic256Sha256, opcspAes128_Sha256_RsaOaep lub opcspAes256_Sha256_RsaPss, a SecurityMode na opcsmSign lub opcsmSignAndEncrypt. opcspBasic128Rsa15 i opcspBasic256 są wycofane przez OPC Foundation i służą starszym serwerom. Klient wybiera pasujący punkt końcowy z GetEndpoints, a gdy żaden nie pasuje, błąd wymienia to, co oferuje serwer.
Certyfikat aplikacji
Application.CertificateFile i PrivateKeyFile ładują certyfikat instancji. Gdy plików jeszcze nie ma, klient tworzy certyfikat i zapisuje go tam, więc administrator serwera musi zaufać mu tylko raz. Bez ustawionych plików jest tworzony w pamięci.
Certyfikat serwera
Certyfikat serwera jest odrzucany, chyba że zaakceptuje go OnValidateServerCertificate, więc nowy klient nigdy przypadkiem nie zaufa nieznanemu serwerowi. AutoAcceptServerCertificate istnieje dla stanowisk testowych.
Tożsamość użytkownika
Authentication.AuthenticationType wybiera Anonymous, nazwę użytkownika i hasło albo certyfikat użytkownika X.509. Hasło jest szyfrowane kluczem serwera zawsze, gdy tego wymaga polityka tokenów serwera.
Współpraca z innymi implementacjami
Przetestowane z niezależnym stosem OPC UA
Klient jest testowany w sieci na serwerze referencyjnym zbudowanym na asyncua, niezależnej implementacji OPC UA o otwartym kodzie: wszystkie jedenaście punktów końcowych serwera (każda polityka i tryb), trzy typy tożsamości, przeglądanie 1000 referencji z punktami kontynuacji, odczyt 18 typów wbudowanych z tablicami i macierzą, zapis skalarów i tablic, wywołania metod, subskrypcje zmian danych i zdarzeń z deadbandami i klauzulami where, dwuminutowy przebieg publikacji bez utraconej ani zduplikowanej wiadomości oraz każda ścieżka ponownego połączenia WatchDog.
FAQ
Pytania o OPC UA w Delphi
Utwórz TsgcOPCUAClient, ustaw EndpointUrl na adres opc.tcp serwera, wywołaj Connect, a potem ReadValue('ns=2;s=Line1.Speed'). Zwraca Variant. Read odczytuje kilka węzłów i atrybutów w jednym wywołaniu.
Wywołaj CreateSubscription z interwałem publikowania, dodaj węzły przez AddMonitoredItem i przypisz OnDataChange. Zdarzenie otrzymuje subskrypcję, monitorowany element i nowy TsgcOPCUADataValue z jego kodem statusu i znacznikami czasu.
Basic256Sha256, Aes128_Sha256_RsaOaep i Aes256_Sha256_RsaPss w trybie Sign lub SignAndEncrypt, a także wycofane Basic128Rsa15 i Basic256 dla starszych serwerów oraz None dla stanowisk testowych.
Przy WatchDog.Enabled klient ponawia próbę co WatchDog.Interval sekund. Reaktywuje tę samą sesję, jeśli serwer ją jeszcze ma, w przeciwnym razie otwiera nową sesję i przenosi lub odtwarza subskrypcje. OnReconnect informuje, która ścieżka została wybrana, a Twoje obiekty subskrypcji pozostają ważne.
Tak. Ustaw NotifyEvents := neNoSync, gdy nie ma pętli komunikatów: zdarzenia działają wtedy w wątkach klienta. Nie wywołuj Connect ani innych usług blokujących z tych zdarzeń; pozwól WatchDog ponownie połączyć.
Od Delphi 7 do Delphi 13 i C++Builder, na Windows (32 i 64 bity) oraz Linux 64 bity.
Klient OPC UA jest zawarty w sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial. Nie obejmuje serwera OPC UA, transportów HTTPS, JSON i WebSocket, HistoryRead, PubSub, Reverse Connect ani Global Discovery Server.