Erste Schritte Zuletzt aktualisiert: 06.02.2024

DEPRAG Smart ist die digitale Lösung mit zahlreichen Werkzeugen (MQTT, REST, Excel Unterstützung, …) für Ihre Herausforderungen bei der SPS Programmierung. Mit DEPRAG Smart haben Sie ein Werkzeug zur Hand, das weit über eine einfache Bibliothek hinausgeht. DEPRAG Smart liefert die Basis zur Verwirklichung von Industrie 4.0 relevanten Inhalten und bietet zahlreiche Möglichkeiten entsprechend dem industriellen Standard. DEPRAG Smart kann mit unterschiedlichen SPSen (Beckhoff, Siemens) verwendet werden und ist in wenigen Minuten in Ihr SPS Projekt eingebunden und kann direkt verwendet werden.

Systemanforderungen

Die Softwarelösung besteht aus zwei Komponenten: eine OPC UA Server Komponente die auf einem IPC installiert wird und native Clientbibliotheken für Ihre SPS Umgebung. Die Clientbibliotheken bieten dabei eine einfache und schnelle Möglichkeit Daten mit dem OPC UA Server auszutauschen und Funktionen auszuführen.

DEPRAG Smart
Betriebssystem: Windows 10 oder neuer bzw. dementsprechende Serverversion, 64 Bit - alternativ Raspberry Pi 4 oder neuer oder vergleichbare Geräte mit Linux ARM Prozessor
CPU: 2 Kerne mit mindestens 1,5GHz
Festplattenspeicher: mind. 1GB

Die Clientbibliotheken werden für folgende SPS Anbieter bereitgestellt. Andere, nicht aufgeführte SPS Anbieter können - sofern Sie einen OPC UA Client anbieten - durch einfaches Aufrufen des OPC UA Servers verbunden werden.

Beckhoff TwinCAT 3 Siemens TIA Portal
OPC UA fähige Steuerung
Installation des Beckhoff TwinCAT OPC UA Pakets (TF6100)
OPC UA fähige Steuerung
TIA Portal V17
OPC UA Runtime-Lizenz
Aktuelle Firmware-Version der CPU der Steuerung

Installation

Im Nachfolgenden wird erläutert, wie Sie den DEPRAG Smart OPC UA Server auf einem Windows System installieren können. Für die Installation auf einem Raspberry PI 4 führen Sie die Schritte aus der mitgelieferten Readme.txt durch.

Durch Klick auf nachfolgend dargestelltes Icon wird ein Setup gestartet, welcher Sie durch die einzelnen Schritte der Installation führt:
logo
Wählen Sie die Sprache aus, die für den Setup verwendet werden soll.
logo
Es wird eine Begrüßungsseite mit weiteren Hinweisen zur Installation angezeigt.
logo
Wählen Sie den Ziel-Ordner aus, in den DEPRAG Smart installiert wird.
logo

Hier kann ausgewählt werden, wie DEPRAG Smart nach der Installation verwendet werden soll:

Option 1: Installation um DEPRAG Smart manuell zu starten und zu stoppen.
Option 2: Der DEPRAG Smart OPC UA Server sowie die DEPRAG Smart Website werden als Windows-Service registriert und gestartet.
Option 3: Ausschließlich der DEPRAG Smart OPC UA Server wird als Windows-Service registriert und gestartet.
logo
Wählen Sie das Startmenü-Verzeichnis aus.
logo
Auf dieser Seite wird eine Zusammenfassung der während des Setups vorgenommenen Einstellungen angezeigt.
logo
Hier wird der aktuelle Status der laufenden Installation angezeigt.
logo
Auf dieser Seite werden abschließende Hinweise zur Installation angezeigt. Bei Auswahl der Option "Installation um DEPRAG Smart manuell zu starten / stoppen" kann DEPRAG Smart nach Schließen des Setups automatisch gestartet werden.
logo

OPC UA

Im Folgenden wird die Struktur der Rückgabewerte beschrieben. Diese besitzen immer die gleichbleibende, nachfolgende Struktur.

Struktur der Rückgabewerte

    IsOk
    Gibt an, ob die Ausführung der Methode in Ordnung war.

Beckhoff TwinCAT 3

Im Nachfolgenden wird erläutert, wie Sie DEPRAG Smart in Ihr TwinCAT 3 Projekt einbinden und verwenden können.

Download der DEPRAG Smart Bibliothek und TwinCAT 3 Beispiel-Projekt

Auf der DEPRAG Smart Website können in der linken Navigation unter dem Punkt "Service" im Untermenü "SPS-Integration" nachfolgende Inhalte zur Verwendung mit TwinCAT 3 heruntergeladen werden:

Eine Bibliothek, welche nach Einbindung in Ihr TwinCAT 3 Projekt ermöglicht, die Funkionalitäten des DEPRAG Smart OPC UA Servers aufzurufen.
Ein Beispielprojekt, welches zeigt, wie auf den DEPRAG Smart OPC UA Server mit Hilfe der DEPRAG Smart TwinCAT 3 Bibliothek zugegriffen werden kann. Die heruntergeladene zip-Datei enthält zudem die DEPRAG Smart TwinCAT 3 Bibliothek.
logo

Returncodes/Fehlercodes in TwinCAT 3

Jede Methode im TwinCAT 3 Beispiel liefert einen Rückgabewert vom Typ HRESULT zurück. Dieser kann entweder die vordefinierten SUCCESS-Codes oder ERROR-Codes für HRESULT (Zur Beschreibung auf der Beckhoff-Webseite) oder die ERROR-Codes des OPC UA Clients (Zur Beschreibung auf der Beckhoff-Webseite) enthalten.

Vor dem ersten Ausführen und während des Ausführens liefern die Rückgabewerte der Methoden „S_FALSE“ zurück. Bei erfolgreicher Ausführung liefern die Methoden „S_OK“ zurück. Bei fehlerhaften Ausführung liefern die Methoden einen der vorherbeschriebenen ERROR-Codes zurück.

Rückgabewerte vom Typ "STRING"

Grundsätzlich können string-Variablen innerhalb von Methodenrückgaben maximal eine Länge von 80 Zeichen annehmen, auch wenn diese im entsprechenden Rückgabe-Typen mit einer Länge von 255 Zeichen definiert sind.

Siemens TIA Portal

Für die Verwendung ist ein Siemens TIA Portal in der Version V17 oder neuer erforderlich. Es muss eine entsprechende OPC UA Runtimelizenz von Siemens erworben und hinterlegt werden.

Starten Sie DEPRAG Smart und setzen Ihr Siemens TIA Projekt auf. Im Tia Portal können Sie die Online Verbindung zum DEPRAG SMART Server herstellen und die Funktionen verwenden.

Für eine detaillierte Beschreibung der einzelnen Inbetriebnahmeschritte mittels des Siemens TIA Portals sehen Sie bitte in die Unterlagen des SPS Anbieters nach.

Im Nachfolgenden werden Beispiele und Erklärungen bezüglich der Aufrufe von Knoten via Siemens TIA Portal dargestellt.

Inbetriebnahme und OPC UA Client Konfiguration:

Die Inbetriebnahme und die OPC UA Client Konfiguration befindet sich in der S7-Anwenderbaustein Beschreibung des OPC UA Client. "Siemens OPC UA Anwenderbaustein"


Listen und Methodenaufrufe ohne Umschaltung

Die nachfolgenden Schritte beschreiben das Vorgehen der Listen und Methodenaufrufe ohne Umschaltung

Die Funktionen OPC_UA_ReadList_C, OPC_UA_WriteList_C und OPC_UA_MethodCall_C können per Drag & Drop, oder durch einen Doppelklick auf den jeweiligen Funktionsbaustein dem bestehenden Programm hinzugefügt werden.
logo
Wählen Sie nun die Art sowie den Namen der Instanz für den verwendeten Funktionsbaustein aus.
logo
Klicken Sie auf den Instanznamen, um die Konfiguration zu öffnen.
logo
Wählen Sie das jeweilige OPC UA Client Interface aus.
logo
Wählen Sie die Methodenliste mit der auszuführenden Methode aus.
logo
Wählen Sie die benötigte Schreibliste aus.
logo
Wählen Sie die benötigte Leseliste aus.
logo
Die Parameter REQ und MaintainSession werden für den Methodenaufruf benötigt.
Die restlichen Output Parameter (Busy, Done, Error, Status) sind optional.
logo
Ist der Eingang MaintainSession „FALSE“ und es wird eine positive Flanke am Eingang REQ erkannt, wird die Verbindung zum OPC UA Server aufgebaut, die Funktion ausgeführt und anschließend die Verbindung wieder getrennt.
Ist der Eingang MaintainSession „TRUE“, wird die Verbindung zum OPC UA Server aufgebaut und nach dem ausführen der Funktion aufrechterhalten. Die Funktion kann dann durch eine positive Flanke am Eingang REQ gestartet werden.
logo
Die Variablen mit den Endwerten der jeweiligen Funktion sind in dem Datenbaustein „OpcUaClientInterface_Data“ unter der dazugehörigen Struktur zu finden.
logo

Listen und Methodenaufrufe mit Umschaltung

Die nachfolgenden Schritte beschreiben das Vorgehen der Listen und Methodenaufrufe mit Umschaltung

Die Funktionen OPC_UA_ReadList_C, OPC_UA_WriteList_C und OPC_UA_MethodCall_C können per Drag & Drop, oder durch einen Doppelklick auf den jeweiligen Funktionsbaustein dem bestehenden Programm hinzugefügt werden.
logo
Wählen Sie nun die Art sowie den Namen der Instanz für den verwendeten Funktionsbaustein aus.
logo
Klicken Sie auf den Instanznamen, um die Konfiguration zu öffnen.
logo
Wählen Sie das jeweilige OPC UA Client Interface aus.
logo
Legen Sie Variablen für die Funktionsparameter des MethodCall_C Bausteins an und verknüpfen Sie diese mit den jeweiligen Ein-/ Ausgängen des Funktionsbausteins.
Die Indexnummer der Variablen MethodHdl und MethodResult ist abhängig von der Position der Methode in der Methodenliste.
logo
Legen Sie Variablen für die Funktionsparameter des WriteList_C Bausteins an und verknüpfen Sie diese mit den jeweiligen Ein-/ Ausgängen des Funktionsbausteins.
logo
Legen Sie Variablen für die Funktionsparameter des ReadList_C Bausteins an und verknüpfen Sie diese mit den jeweiligen Ein-/ Ausgängen des Funktionsbausteins.
logo
Die Umschaltung erfolgt in diesem Beispiel durch eine IF-Abfrage.
logo
Ist der Eingang MaintainSession „FALSE“ und es wird eine positive Flanke am Eingang REQ erkannt, wird die Verbindung zum OPC UA Server aufgebaut, die Funktion ausgeführt und anschließend die Verbindung wieder getrennt.
Ist der Eingang MaintainSession „TRUE“, wird die Verbindung zum OPC UA Server aufgebaut und nach dem ausführen der Funktion aufrechterhalten. Die Funktion kann dann durch eine positive Flanke am Eingang REQ gestartet werden.
ACHTUNG!
Die Variable MaintainSession muss vor jedem Umschaltvorgang zurückgesetzt werden, da es andernfalls zu Verbindungsproblemen führt.
logo
Die Variablen mit den Endwerten der jeweiligen Funktion sind in dem Datenbaustein „OpcUaClientInterface_Data“ unter der dazugehörigen Struktur zu finden.
logo

Verarbeitung von großen Strings (>255 Zeichen)

Damit der Datentyp WSTRING in der Programmierumgebung TIA Portal mehr als 255 Zeichen darstellen kann, muss diesem Datentyp eine fest definierte Größe zugewiesen werden. Um diese Zuweisung bei den verwendeten PLC-Datentypen abändern zu können, müssen Sie zuerst den zu ändernden PLC-Datentyp kopieren und anschließend umzubenennen.

logo

ACHTUNG! Der Name des kopierten PLC-Datentyps darf nicht mit dem Namen eines bereits existierenden PLC-Datentyps übereinstimmen, da bei dem Kompiliervorgang die Änderungen rückgängig gemacht werden.
In dem neuerstellten PLC-Datentyp kann jetzt der Variable des Datentyps WSTRING eine fest definierte Größe zugewiesen werden.

logo

Legen Sie eine Variable (z.B. lokale Variable in einen Funktionsbaustein) mit dem neuerstellten Datentyp an und verknüpfen Sie diese mit dem jeweiligen Input / Output Arguments des Methodenaufrufs.

logo

ACHTUNG! In den Datenbausteinen OpcUaClienInterface_Data und OpcUaClientInterface_Configuration darf man keine neuen Variablen anlegen oder bestehende Variablen abändern, da bei einem Kompiliervorgang der Ausgangszustand dieser Datenbausteine wiederhergestellt wird.

Sonderfall!
Sollte der kopierte Datentyp mehrere PLC-Datentypen beinhalten müssen alle PLC-Datentypen, die für die Abänderung der Variable betroffen sind, ebenfalls kopiert und neu angelegt werden. Der Datentyp sollte dann, wie vorhergehend beschrieben, über die neu erstellten / bereits vorhanden PLC-Datentypen wieder reproduziert werden.

logo logo

Geräte

Im Bereich Geräte stehen Ihnen diverse Funktionalitäten zur Verwaltung von verschiedenen Geräten zur Verfügung, damit diese in Ihre SPS eingebunden werden können. Als Geräte stehen Ablaufsteuerungen der Firma DEPRAG zur Verfügung. Aber auch Geräte anderer Hersteller können über Open Protocol hinzugefügt werden. Alle Möglichkeiten werden in den nachfolgenden Abschnitten detailliert erläutert.

DEPRAG Geräte

Geräte DEPRAG Geräte

Bietet Funktionalität für die Verwaltung, Abfrage und Parametrierung von Geräten der Firma DEPRAG Schulz GmbH & Co.

Ablaufsteuerung

Geräte DEPRAG Geräte Ablaufsteuerung

Bietet Funktionalität für die Verwaltung, Abfrage und Parametrierung von Geräten der Firma DEPRAG Schulz GmbH & Co.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Fügt ein neues Gerät in die Liste ActiveDevices hinzu. Der Gerätetyp wird über die Variable "AstType" angegeben.

Fügt ein neues Gerät in die Liste "ActiveDevices" hinzu. Das Gerät ist noch nicht konfiguriert und muss über die Methode Configure im Anschluss konfiguriert werden.

Beendet die Verbindung zum Gerät und entfernt es aus der Liste "ActiveDevices".

Beendet die Verbindungen zu allen Geräten und entfernt diese aus der Liste "ActiveDevices".

ActiveDevices

Geräte DEPRAG Geräte Ablaufsteuerung ActiveDevices

Alle aktiven, registrierten DEPRAG Ablaufsteuerungen. Standardmäßig sind bereits 10 unparametrierte Geräteknoten angelegt, die über die "Configure"-Methode konfiguriert werden können.

Ein Client

Geräte DEPRAG Geräte Ablaufsteuerung ActiveDevices Ein Client

Spezifiziert die Struktur und den Aufbau einer DEPRAG Ablaufsteuerung inklusive aller Methoden und Parameter.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Der Befehl konfiguriert ein am DEPRAG Smart OPC UA Server registriertes Gerät. Dieses kann im Anschluss parametriert und abgerufen werden.

Variablen-Knoten / Eigenschaften

OPC UA Knoten
Beschreibung
Schreiben
Lesen
TwinCAT
TIA
Id

Eindeutiger Listen Index, um in der Liste der ActiveDevices das Gerät abzurufen.

AST Geräte Typ: AST12

IP Adresse der DEPRAG Ablaufsteuerung.

Prozessdaten

Geräte DEPRAG Geräte Ablaufsteuerung ActiveDevices Ein Client Prozessdaten

Abfrage der Endwerte der letzten Verschraubung. Die Endwerte beinhalten alle relevanten Informationen zu ausgeführten Schraubstufen und Befehlen. Die Einheit der Werte wird im Objekt mitgegeben.

Schraubablauf

Geräte DEPRAG Geräte Ablaufsteuerung ActiveDevices Ein Client Schraubablauf

In diesem Bereich können die Schraubabläufe der Ablaufsteuerung eingesehen, bearbeitet und gelöscht werden.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Erstellt oder verändert ein vorhandenes Schraubprogramm.

Löscht alle vorhandenen Schraubprogramme auf der verbundenen Ablaufsteuerung.

Löscht das angegebene Schraubprogramm auf der verbundenen Ablaufsteuerung.

Ruft das angegebene Schraubprogramm von der verbundenen Ablaufsteuerung ab.

Einstellungen

Geräte DEPRAG Geräte Ablaufsteuerung ActiveDevices Ein Client Einstellungen

In diesem Bereich können die Einstellungen der Ablaufsteuerung abgerufen und bearbeitet werden.

Datum/Uhrzeit

Geräte DEPRAG Geräte Ablaufsteuerung ActiveDevices Ein Client Einstellungen Datum/Uhrzeit

In diesem Bereich können die Einstellungen zur Systemzeit der Ablaufsteuerung abgerufen oder gesetzt werden. Die Systemzeit des Gerätes dient zur Dokumentation der Schraubergebnisse und damit der Endwerte.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Ruft die aktuelle Systemzeit der Ablaufsteuerung ab.

Setzt die Systemzeit auf der Ablaufsteuerung.

Systeminfo

Geräte DEPRAG Geräte Ablaufsteuerung ActiveDevices Ein Client Systeminfo

In diesem Bereich können Systemdaten der Ablaufsteuerung abgerufen werden. Systemdaten können dabei generelle Informationen, sowie gesetzte Parameter der Ablaufsteuerung sein. Die Systemdaten werden mittels eines Key-Identifiers von der Ablaufsteuerung abgerufen.

Steuerungsdaten

Geräte DEPRAG Geräte Ablaufsteuerung ActiveDevices Ein Client Systeminfo Steuerungsdaten

In diesem Bereich können Systemdaten der Ablaufsteuerung abgerufen werden. Systemdaten können dabei generelle Informationen, sowie gesetzte Parameter der Ablaufsteuerung sein. Die Systemdaten werden mittels eines Key-Identifiers von der Ablaufsteuerung abgerufen.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Ruft einen Eintrag ab.

Ruft die Anzahl an Elementen in den Systemdaten ab.

Fordert einen indexabhänigen Schlüssel aus den Systemdaten an.

Fordert alle Schlüssel der Systemdaten an.

Werkzeugdaten

Geräte DEPRAG Geräte Ablaufsteuerung ActiveDevices Ein Client Systeminfo Werkzeugdaten

In diesem Bereich können Werkzeugdaten des Werkzeuges eingesehen werden. Die Werkzeugdaten beinhalten Informationen über das angeschlossene Schraubwerkzeug. Die Werkzeugdaten werden mittels eines Key-Identifiers von der Ablaufsteuerung abgerufen.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Fordert einen spezifischen Wert der Werkzeugdaten an.

Fordert die Anzahl der Elemente von Werkzeugdaten an.

Fordert einen indexabhänigen Schlüssel der Werkzeugdaten an.

Fordert alle Schlüssel der Werkzeugdaten an.

Herstellerübergreifende Geräte

Geräte Herstellerübergreifende Geräte

Bietet Funktionalitäten für die Verwaltung, Abfrage und Parametrierung von Geräten unterschiedlicher Hersteller.

Open Protocol Geräte

Geräte Herstellerübergreifende Geräte Open Protocol Geräte

Bietet Funktionalitäten für die Verwaltung, Abfrage und Parametrierung von Geräten, die die Open Protocol Schnittstelle unterstützen.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Fügt ein neues Gerät zur Liste "OpenProtocolDevices" hinzu.

Entfernt ein Gerät aus der Liste "OpenProtocolDevices".

Entfernt alle Geräte aus der Liste "OpenProtocolDevices".

OpenProtocolDevices

Geräte Herstellerübergreifende Geräte Open Protocol Geräte OpenProtocolDevices

Alle registrierten Open Protocol Geräte. Standardmäßig sind bereits 10 unparametrierte Geräteknoten angelegt, die über die "Connect"-Methode konfiguriert und verbunden werden können.

Ein Gerät

Geräte Herstellerübergreifende Geräte Open Protocol Geräte OpenProtocolDevices Ein Gerät

Stellt verschiedene Methoden, Events und Eigenschaften zur Verfügung, um mit einem Open Protocol Gerät zu interagieren.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Stellt die Verbindung zu einem Open Protocol Gerät her. DEPRAG Smart agiert dabei als Open Protocol Client, der die Verbindung zu einem Open Protocol Server herstellt.

Trennt die Verbindung zu einem Open Protocol Gerät.

Diese Nachricht kann verwendet werden, um die Startfreigabe zurückzunehmen. Es können keine Schraubläufe gestartet werden, das Gerät ist nicht schraubbereit.

Diese Nachricht kann verwendet werden, um die Startfreigabe zu setzen. Es können Schraubläufe gestartet werden, die Steuerung ist schraubbereit.

Wählt ein Schraubprogramm aus.

Wird benutzt, um eine Anmerkung (entspricht VIN oder VehicleId) an das Gerät zu übertragen.

Abfrage der Endwerte der letzten Verschraubung.

Event-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Das Event wird ausgelöst, sobald ein Schraubergebnis vom verbundenen Open Protocol Server empfangen wird.

Das Event wird ausgelöst, sobald keine Rückantwort vom verbundenen Open Protocol Server auf eine gesendete Keep-Alive-Meldung empfangen wird.

Variablen-Knoten / Eigenschaften

OPC UA Knoten
Beschreibung
Schreiben
Lesen
TwinCAT
TIA
Id

Eindeutiger Listen Index, um in der Liste der OpenProtocolDevices das Gerät abzurufen.

Lokal

Bietet Funktionen für den Zugriff auf lokale Ressourcen.

Laufwerks-Management

Lokal Laufwerks-Management

Funktionen für den Zugriff auf Laufwerke.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Der Befehl gibt eine Liste aller logischen Laufwerke mit ihren Eigenschaften zurück.

Der Befehl gibt die Anzahl der vorhandenen Laufwerke zurück.

Der Befehl gibt die Eigenschaften für das Laufwerk mit dem angegebenen Index zurück.

Datei- und Ordner-Zugriff

Lokal Datei- und Ordner-Zugriff

Funktionen für den Zugriff auf Dateien und Ordner.

Ordner

Lokal Datei- und Ordner-Zugriff Ordner

Funktionen, um auf Ordner auf dem Dateisystem zuzugreifen.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Der Befehl erstellt das angegebene Verzeichnis.

Der Befehl löscht das angegebene Verzeichnis.

Der Befehl gibt ein Array mit allen Verzeichnissen im angegebenen Pfad aus. Jedes Array-Element enthält die Eigenschaften eines Verzeichnisses.

Der Befehl gibt die Anzahl der Verzeichnisse zurück, die im angegebenen Pfad enthalten sind.

Der Befehl gibt die Eigenschaften des Verzeichnisses mit dem angegebenen Index zurück, das im angegebenen Verzeichnis liegt.

Der Befehl gibt ein Array mit allen Dateien im angegebenen Pfad aus. Jedes Array-Element enthält die Eigenschaften einer Datei.

Der Befehl gibt die Anzahl der Dateien zurück, die im angegebenen Pfad enthalten sind.

Der Befehl gibt die Eigenschaften der Datei mit dem angegebenen Index zurück, die im angegebenen Verzeichnis liegt.

Der Befehl liest die Eigenschaften des Verzeichnisses aus.

Der Befehl ruft die Größe des angegebenen Verzeichnisses in Byte ab.

Excel

Lokal Datei- und Ordner-Zugriff Excel

Stellt Funktionen zur Bearbeitung von Excel-Dateien zur Verfügung.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Der Befehl erstellt ein neues Exceltabellenblatt in einem angegebenen Pfad. Falls das angegebene Exceltabellenblatt bereits vorhanden ist, wird kein neues Exceltabellenblatt erstellt.

Der Befehl löscht das Exceltabellenblatt im angegebenen Pfad.

Der Befehl schreibt einen neuen Inhalt in eine Zelle des angegebenen Exceltabellenblatts in einem angegebenen Pfad.

Der Befehl liest einen Inhalt aus einer Zelle des angegebenen Exceltabellenblatts in einem angegebenen Pfad aus.

Der Befehl liest die Inhalte von Zellen einer Zeile mit angegebenen Start- und Endspaltenindex des angegebenen Exceltabellenblatts in einem angegebenen Pfad aus.

Der Befehl liest die Inhalte von der ersten gefüllten bis zur letzten gefüllten Zelle einer Zeile des angegebenen Exceltabellenblatts in einem angegebenen Pfad aus. Sind zwischen der ersten und der letzten gefüllten Zelle leere Einträge enthalten werden diese in die Ausgabe übernommen.

Der Befehl liest die Inhalte aller Zellen einer Zeile des angegebenen Exceltabellenblatts in einem angegebenen Pfad aus.

Der Befehl schreibt neue Inhalte in die Zellen einer Zeile des angegebenen Exceltabellenblatts in einem angegebenen Pfad.

Der Befehl löscht eine Zeile aus dem angegebenen Exceltabellenblatts im angegebenen Pfad.

Datei

Lokal Datei- und Ordner-Zugriff Datei

Funktionen um auf das Dateisystem zuzugreifen.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Der Befehl kopiert eine vorhandene Datei in einen angegebenen Pfad. Ist die angegebene Datei bereits vorhanden wird ein Fehler ausgegeben.

Der Befehl kopiert eine vorhandene Datei in einen angegebenen Pfad. Ist die angegebene Datei bereits vorhanden kann diese überschrieben werden.

Der Befehl löscht die Datei im angegebenen Pfad.

Der Befehl gibt die Dateieigenschaften der angegebenen Datei zurück.

Der Befehl liest den Inhalt der Datei in ein Bytearray ein.

Der Befehl schreibt ein Bytearray in eine Datei.

Der Befehl liest den Inhalt einer Datei in eine Zeichenfolge ein.

Der Befehl schreibt eine Zeichenkette in die angegebene Datei.

JSON-Reader

Lokal Datei- und Ordner-Zugriff JSON-Reader

Stellt die Funktion eines JSON-Readers zur Verfügung.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Der Befehl öffnet eine JSON-Datei zur weiteren Bearbeitung. Der Reader kann über den zurückgegebenen Index aus der Liste "ActiveJsonDocuments" abgerufen werden.

Der Befehl fügt einen JSON-Reader in der Liste ActiveJsonDocuments ein. Der Reader kann über den zurückgegebenen Index aus der Liste "ActiveJsonDocuments" abgerufen werden.

Der Befehl schließt das JSON-Dokument und gibt den Index in der Liste ActiveJsonDocuments frei.

ActiveJsonDocuments

Lokal Datei- und Ordner-Zugriff JSON-Reader ActiveJsonDocuments

Liste der aktiven JSON-Dokumente

Ein JSON-Dokument

Lokal Datei- und Ordner-Zugriff JSON-Reader ActiveJsonDocuments Ein JSON-Dokument

Funktionen die auf ein JSON-Dokument angewendet werden können.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Der Befehl setzt den Pfad des JSON-Dokuments.

Mit diesem Befehl kann geprüft werden, ob das angegebene Element im JSON-Dokument enthalten ist.

Der Befehl gibt den Wert des angegebenen Elements zurück. Dieser Befehl wird genutzt, wenn ein skalarer Wert erwartet wird.

Der Befehl prüft, ob der Wert des angegebenen Elements ein Array enthält.

Der Befehl gibt den Wert des angegebenen Keys zurück. Dieser Befehl wird genutzt, wenn ein Array als Wert erwartet wird.

Variablen-Knoten / Eigenschaften

OPC UA Knoten
Beschreibung
Schreiben
Lesen
TwinCAT
TIA
Id

Eindeutiger Index

Pfad des JSON-Dokuments.

XML-Reader

Lokal Datei- und Ordner-Zugriff XML-Reader

Bietet Funktion für den Zugriff auf XML-Dateien.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Der Befehl öffnet eine XML-Datei zur weiteren Bearbeitung. Der Reader kann über den zurückgegebenen Index aus der Liste "ActiveXMLDocuments" abgerufen werden.

Der Befehl registriert einen nicht konfigurierten XML-Reader. Der Reader kann über den zurückgegebenen Index aus der Liste "ActiveXMLDocuments" abgerufen werden.

Der Befehl schließt das XML-Dokument und gibt den Index in der Liste ActiveXMLDocuments frei.

ActiveXMLDocuments

Lokal Datei- und Ordner-Zugriff XML-Reader ActiveXMLDocuments

Liste der aktiven XML-Dokumente.

Ein Reader

Lokal Datei- und Ordner-Zugriff XML-Reader ActiveXMLDocuments Ein Reader

Ein konkreter XML-Reader.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Der Befehl setzt den Pfad des XML-Dokuments.

Der Befehl gibt den Wert des angegebenen XML-Elements zurück.

Mit diesem Befehl kann geprüft werden, ob das angebende XML-Element im XML-Dokument enthalten ist.

Variablen-Knoten / Eigenschaften

OPC UA Knoten
Beschreibung
Schreiben
Lesen
TwinCAT
TIA
Id

Eindeutiger Index.

Pfad des XML-Dokuments.

Mausfunktionen

Lokal Mausfunktionen

Im Bereich Mausfunktionen stehen Ihnen Funktionalitäten zur Verfügung, um Mausereignisse, wie z. B. das Drücken einer Maustaste, auszuwerten.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Gibt die Position der Maus beim letzten Drücken einer Maustaste zurück. Voraussetzung dafür ist, dass die Detektion der Position vorher über die Funktion "StartDetectingMouseClick" aktiviert wurde.

Startet die Überwachung der Position der Maus beim Drücken einer Maustaste.

Stoppt die Überwachung der Position der Maus beim Drücken einer Maustaste.

Event-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Das Event wird ausgelöst sobald eine Maustaste gedrückt wurde. Voraussetzung dafür ist, dass die Detektion der Position vorher über die Funktion "StartDetectingMouseClick" aktiviert wurde.

Drucken

Lokal Drucken

Im Bereich Drucken stehen Ihnen Funktionalitäten zur Verfügung, um mit dem verbundenen Standarddrucker zu kommunizieren und beispielsweise Dateien zu drucken.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Erlaubt beliebige Dateien auf dem am System eingestellten Standarddrucker auszudrucken.

Netzwerk

Im Bereich Netzwerk stehen Ihnen diverse Netzwerk-Funktionalitäten zur Verfügung, um Ihre SPS in ein modernes Industrie 4.0 Umfeld einzubinden. Hierzu zählen unter anderem Funktionalitäten zum Versenden von E-Mails, MQTT-Funktionen, REST, sowie TCP/IP und allgemeine Netzwerk-Werkzeuge. Diese werden in den nachfolgenden Abschnitten detailliert erläutert.

E-Mail

Netzwerk E-Mail

Stellt Funktionalitäten zum Versenden von E-Mail Nachrichten an mehrere Empfänger zur Verfügung. Optional können Anhänge übermittelt werden. Vor Verwendung der Funktionalität muss der SMTP-Server in den Einstellungen SmtpServerSettings gesetzt werden.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Dieser Befehl sendet eine E-Mail-Nachricht ohne Anhänge an alle im Feld MailAddressTo hinterlegten E-Mail-Adressen. Vor Verwendung der Funktionalität muss der SMTP-Server in den Einstellungen SmtpServerSettings gesetzt werden.

Dieser Befehl sendet eine E-Mail-Nachricht mit Anhängen an alle im Feld MailAddressTo hinterlegten E-Mail-Adressen. Dateianhänge werden im Feld AttachmentFilePaths übergeben. Vor Verwendung der Funktionalität muss der SMTP-Server in den Einstellungen SmtpServerSettings gesetzt werden.

SmtpServerSettings

Netzwerk E-Mail SmtpServerSettings

Ermöglicht die Konfiguration eines SMTP-Servers (Simple Mail Transfer Protocol) für den Versand von E-Mail-Nachrichten.

Variablen-Knoten / Eigenschaften

OPC UA Knoten
Beschreibung
Schreiben
Lesen
TwinCAT
TIA

Legt fest, ob die Verbindung zum SMTP-Server mittels SSL-Protokoll verschlüsselt werden soll.

Adresse des SMTP-Servers.

Port des SMTP-Servers.

Der Benutzernamen, mit dem sich die Anwendung beim SMTP-Server authentifiziert.

Passwort, mit dem sich die Anwendung beim SMTP-Server authentifiziert.

REST Client

Netzwerk REST Client

Erlaubt die Übermittlung von HTTP Anforderungen, Abfragen oder Änderungen (GET, POST, PUT). Es wird eine REST Client (Representational State Transfer) Bibliothek zur Kommunikation mit einer REST API zur Verfügung gestellt.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Der Befehl registriert einen nicht konfigurierten REST Client. Der Client muss vor Verwendung über den Befehl Configure konfiguriert werden.

Erstellt einen neuen, vollständig parametrierten REST Client. Der REST Client kann über den zurückgegebenen Index aus der Liste "ActiveClients" abgerufen werden.

Der Befehl beendet die Verbindung eines konkreten REST Clients und entfernt diesen aus der Liste der aktiven Clients.

Der Befehl beendet alle aktiven REST Verbindungen und entfernt alle REST Clients aus der Liste der aktiven Clients.

ActiveClients

Netzwerk REST Client ActiveClients

Liste der aktiven Clients

Ein Client

Netzwerk REST Client ActiveClients Ein Client

Eigenschaften eines ActiveClients.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Konfiguriert einen REST Client. Dieser Befehl ist auszuführen, wenn der Client über die Methode AddUnparameterizedClient hinzugefügt worden ist oder einer der 10 standardmäßig angelegten Clients verwendet wird.

Der Befehl fügt ein neues Header-Element im Request hinzu.

Der Befehl entfernt den angegebenen Header.

Setzt den Proxy-Server. Der Proxy-Server wird für alle Anfragen an die API verwendet.

Entfernt den Proxy-Server.

Get

Sendet einen GET Request an eine URL.

Sendet einen DELETE Request an eine URL.

Sendet einen POST Befehl an eine URL.

Sendet einen PATCH Befehl an eine URL.

Put

Sendet einen PUT Befehl an eine URL.

Lädt eine Datei vom angegebenen Endpunkt herunter und stellt ein byte-Array als Antwort zur Verfügung.

Lädt eine Datei an den angebenden Endpunkt hoch.

Variablen-Knoten / Eigenschaften

OPC UA Knoten
Beschreibung
Schreiben
Lesen
TwinCAT
TIA
Id

Eindeutige Identifikation des REST Clients.

Setzt oder ruft den Content-Typ HTTP Header ab.

Maximale Zeit in Millisekunden für den Verbindungsaufbau zur REST-API. Kann innerhalb des Zeitintervalls keine Verbindung aufgebaut werden, wird ein Fehler ausgegeben.

Vorgegebene Header, die bei jedem Aufruf der REST-API gesendet werden.

Die Basisadresse der URI für die Aufrufe der REST-API.

Maximale Anzahl der zwischenzuspeichernden Bytes für Aufrufe der REST-API.

MQTT Client

Netzwerk MQTT Client

Hochperformante MQTT (Message Queing Telemetry Transport) Client Bibliothek zur Kommunikation mit MQTT Brokern. Die Implementierung erlaubt eine schnelle Übertragung von MQTT Messages ohne zeitkritischen Overhead.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Erstellt einen neuen, vollständig parametrierten MQTT Client. Der MQTT Client kann über einen nullbasierten Index aus der Liste ActiveClients abgerufen werden.

Der Befehl registriert einen nicht konfigurierten MQTT Client. Das Gerät muss vor Verwendung über den Befehl Configure konfiguriert werden.

Der Befehl beendet die Verbindung eines konkreten MQTT Client und entfernt diesen aus der Liste der aktiven Clients.

Der Befehl beendet alle aktiven MQTT Verbindungen und entfernt alle MQTT Clients aus der Liste der aktiven Clients.

ActiveClients

Netzwerk MQTT Client ActiveClients

Liste der aktiven MQTT Clients.

Ein Client

Netzwerk MQTT Client ActiveClients Ein Client

Eigenschaften eines ActiveClients.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Konfiguriert einen MQTT Client. Dieser Befehl ist auszuführen, wenn der Client über die Methode AddUnparameterizedClient hinzugefügt worden ist.

Der Befehl sendet eine Nachricht mit dazugehörigem Topic an den MQTT Broker.

Der Befehl sendet eine Nachricht mit dazugehörigem Topic an den MQTT Broker.

Parametriert den MQTT Client mit allen Parametern und stellt eine Verbindung zum angegebenen MQTT Broker her.

Parametriert den MQTT Client und stellt eine Verbindung zum angegebenen MQTT Broker her.

Leichtgewichtige Funktion um die Verbindung zum angegebenen MQTT Broker herzustellen.

Parametriert den MQTT Client und stellt eine Verbindung zum angegebenen MQTT Broker her.

Trennt die Verbindung zwischen MQTT Client und dem MQTT Broker.

Abonniert ein MQTT Topic mit Standardeinstellungen vom MQTT Broker.

Abonniert ein MQTT Topic mit QoS vom MQTT Broker.

Abonniert ein MQTT Topic vom MQTT Broker. Die Methode erlaubt alle Eigenschaften eines MQTT Abonnements zu setzen.

Deabonniert ein Abonnement zu einem MQTT Topic vom MQTT Broker.

Event-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Das Event wird ausgelöst sobald die MQTT-Verbindung erfolgreich aufgebaut wurde.

Das Event wird ausgelöst sobald die MQTT-Verbindung unterbrochen wurde.

Das Event wird ausgelöst sobald das Verbinden zum MQTT-Broker fehlgeschlagen ist.

Das Event wird ausgelöst sobald eine MQTT Nachricht empfangen wurde.

Variablen-Knoten / Eigenschaften

OPC UA Knoten
Beschreibung
Schreiben
Lesen
TwinCAT
TIA
Id

Eindeutige Identifikation des MQTT Clients in der Liste der aktiven Clients.

Gibt an, ob der MQTT Client mit dem MQTT Broker verbunden ist.

Gibt an, ob der MQTT Client gestartet ist.

Anzahl an noch nicht übertragenden Messages im lokalen Pufferspeicher. Die Nachrichten müssen noch an den MQTT Broker übertragen werden.

TCP/IP Client

Netzwerk TCP/IP Client

Stellt die Möglichkeit bereit, sich mit einem TCP/IP Server zu verbinden und Nachrichten auszutauschen.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Erstellt einen neuen, vollständig parametrierten TCP/IP Client. Der Client kann über den zurückgegebenen Index aus der Liste "ActiveClients" abgerufen werden.

Der Befehl registriert einen nicht konfigurierten TCP/IP-Client. Der Client muss vor Verwendung über den Befehl "Configure" konfiguriert werden.

Der Befehl beendet die Verbindung eines konkreten TCP/IP-Clients und entfernt diesen aus der Liste "ActiveClients".

Der Befehl beendet alle aktiven TCP/IP-Verbindungen und entfernt alle Clients aus der Liste "ActiveClients".

ActiveClients

Netzwerk TCP/IP Client ActiveClients

Liste der angelegten TCP/IP Clients.

Ein Client

Netzwerk TCP/IP Client ActiveClients Ein Client

Ein konkreter TCP/IP Client.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Konfiguriert einen TCP/IP-Client. Dieser Befehl ist auszuführen, wenn der Client über die Methode AddUnparameterizedClient hinzugefügt worden ist oder einer der 10 standardmäßig angelegten Clients verwendet wird.

Der Befehl sendet eine Zeichenkette als TCP/IP-Nachricht an den Server.

Der Befehl sendet ein Byte-Array als TCP/IP-Nachricht an den Server.

Der Befehl empfängt alle Zeichen bis zum ersten Vorkommen der angegebenen Zeichenkette.

Der Befehl empfängt eine angegebene Anzahl an Zeichen.

Der Befehl stellt eine Verbindung zwischen TCP/IP-Client und Server her.

Der Befehl beendet die Verbindung zwischen TCP/IP-Client und Server.

Variablen-Knoten / Eigenschaften

OPC UA Knoten
Beschreibung
Schreiben
Lesen
TwinCAT
TIA
Id

Eindeutiger Index, mit dem der TCP/IP-Client aus der Liste "ActiveClients" abgerufen werden kann.

IP oder DNS-Adresse des Servers.

Port des Servers.

Gibt an, ob der TCP/IP-Client mit dem Server verbunden ist.

Legt fest ob nach einem Verbindungsabbruch die Verbindung automatisch wiederhergestellt werden soll.

Maximale Zeit in Millisekunden für das Senden einer Nachricht. Kann die Nachricht nicht innerhalb des Zeitintervalls vollständig gesendet werden, wird ein Fehler ausgegeben.

Maximale Zeit in Millisekunden die der Client auf den Empfang einer Nachricht wartet. Kann die Nachricht nicht innerhalb des Zeitintervalls vollständig empfangen werden, wird ein Fehler ausgegeben.

Die Codierung des Nachrichteninhalts: Ascii, BigEndian, Unicode, Default, Latin1, Unicode, Utf32, Utf7, Utf8

Netzwerk-Werkzeuge

Netzwerk Netzwerk-Werkzeuge

Im Bereich Netzwerk-Werkzeuge stehen Ihnen typische Netzwerk-Befehle zur Verfügung mit denen Sie die Erreichbarkeit von Netzwerkteilnehmern prüfen können.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Dieser Befehl sendet an die konfigurierte Hostadresse eine ICMP-Anforderung (Internet Control Message Protocol). Es wird eine entsprechende Antwort von der Hostadresse innerhalb der konfigurierten Zeit erwartet. Diese Funktion ist für den Test von Netzwerkverfügbarkeiten, Erreichbarkeit von SPSen, Statusdiagnose des Netzwerkes, etc. hilfreich.

Mit diesem Befehl kann die Erreichbarkeit eines spezifizierten Ports an einer konfigurierten IP-Adresse überprüft werden.

Softwareversion und Updateverfügbarkeit

Diese Funktion liefert die Möglichkeit nach Updates für DEPRAG Smart zu suchen.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Überprüft ob ein neues Softwareupdate bereit steht.

Variablen-Knoten / Eigenschaften

OPC UA Knoten
Beschreibung
Schreiben
Lesen
TwinCAT
TIA

Eine Zeichenkette die den Herausgeber der Software anzeigt.

Beinhaltet die aktuell verwendete Softwareversion.

Gibt an ob ein Softwareupdate verfügbar ist.

Gibt an ob der Updateserver erreichbar ist.

Gibt an wann zuletzt eine Prüfung nach Softwareupdates durchgeführt worden ist.

Werkzeuge

In diesem Bereich werden kleine, nützliche Funktionalitäten, wie z.B. Funktionalitäten für den Umgang mit Byte-Arrays und Strings, zur Verfügung gestellt.

ByteArray Funktionen

Werkzeuge ByteArray Funktionen

In diesem Bereich werden Funktionalitäten für den Umgang mit Byte-Arrays und Konvertierungsmethoden für diese zur Verfügung gestellt.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Konvertiert die angegebene, Base-64 codierte Zeichenfolge in ein entsprechendes Byte-Array.

Konvertiert ein Byte-Array in die entsprechende Base-64 codierte Zeichenfolgendarstellung.

Konvertiert die angegebene, hexadezimal codierte Zeichenfolge in ein entsprechendes Byte-Array.

Konvertiert ein Byte-Array in die entsprechende hexadezimale Zeichenfolgendarstellung.

Konvertiert die angegebene Zeichenfolge in ein entsprechendes Byte-Array.

Konvertiert ein Byte-Array unter Verwendung der angegebenen Zeichenkodierung in die entsprechende Zeichenfolgendarstellung.

String Funktionen

Werkzeuge String Funktionen

In diesem Bereich werden Funktionalitäten für den Umgang mit Strings (Zeichenketten) zur Verfügung gestellt.

Methoden-Knoten

OPC UA Knoten
Beschreibung
TwinCAT
TIA

Vergleicht zwei angegebene Zeichenketten und gibt eine Ganzzahl zurück, die ihre relative lexikographische Ordnung angibt.

Verkettet die erste angegebene Zeichenkette mit der zweiten angegebenen Zeichenkette.

Überprüft, ob ein Text in einem anderen Text vorkommt und gibt das Ergebnis zurück.

Überprüft ob ein Text mit einem anderen Text endet.

Überprüft ob zwei Texte gleich sind.

Fügt in einen Text an einer angegebenen Indexposition in einen weiteren Text ein und gibt das Ergebnis zurück.

Ersetzt in einem Text alle Vorkommen einer angegebenen Zeichenkette durch eine andere.

Teilt einen Text bei einem Zeichen (Separator) in unterschiedliche Bestandteile.

Überprüft ob ein Text mit einem bestimmten Wert startet.

Gibt den Teil des angegebenen Textes ab einer übergebenen Indexposition zurück.

Gibt einen Teil des angegebenen Textes zurück. Der Teil beginnt ab den Parameter Startindex und endet bei Startindex+Length.

Entfernt alle Leerraumzeichen am Anfang und Ende des angegebenen Textes.

Konvertiert alle Großbuchstaben des angegebenen Textes in Kleinbuchstaben.

Konvertiert alle Kleinbuchstaben des angegebenen Textes in Großbuchstaben.

Sucht einen Text in einem anderen Text und gibt die nullbasierte Position des ersten Auftretens zurück.