Nowość

Komponent klienta OPC UA dla Delphi

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.

Jeden komponent po stronie klienta OPC UA

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 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.

Zestaw usługUsługaMetoda
DiscoveryGetEndpointsGetEndpoints
ViewBrowse, BrowseNextBrowse, BrowseNext
ViewTranslateBrowsePathsToNodeIdsTranslateBrowsePath
AttributeReadRead, ReadValue
AttributeWriteWrite, WriteValue
MetodaCallCall
SubscriptionCreateSubscription, DeleteSubscriptions, SetPublishingModeCreateSubscription, DeleteSubscription, SetPublishingMode
MonitoredItemCreateMonitoredItems, ModifyMonitoredItems, DeleteMonitoredItemsAddMonitoredItem, AddEventMonitoredItem, ModifyMonitoredItem, RemoveMonitoredItem
SubscriptionPublish, Republish, TransferSubscriptionsRealizowane przez komponent: OnDataChange, OnEvent, OnKeepAlive, WatchDog

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);
  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;

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 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.

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.

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.

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.

Więcej komponentów przemysłowych w sgcWebSockets

Komponenty przemysłowe

Port szeregowy, Modbus i OPC UA w jednej sekcji, z pełną dokumentacją komponentów.

Dokumentacja klienta OPC UA

Właściwości, metody i zdarzenia TsgcOPCUAClient, z przykładami dla C++Builder i C#.

Delphi Modbus TCP i RTU

Klienty i serwery Modbus dla urządzeń, które nie mówią OPC UA.

Klient MQTT dla Delphi

Przekazuj zmiany danych OPC UA do tematów MQTT: typowa brama z zakładu do chmury.

Także dla C# i .NET

Ten sam klient OPC UA, z tymi samymi nazwami klas, dla .NET 8, 9, 10 i .NET Standard 2.0.

Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

Odczytaj pierwszy węzeł OPC UA z Delphi

W pakiecie sgcWebSockets Enterprise (Delphi i .NET) oraz All-Access, a także w samodzielnym pakiecie sgcIndustrial.