Übersicht
Die TcUtilities.Lib beinhaltet einige nützliche Funktionsbausteine und Funktionen, mit denen z.B. TwinCAT SPS- oder Betriebssystem-Funktionen aufgerufen werden können. Die meisten Funktionsbausteine basieren intern auf der System-Bibliothek.
Beim Hinzufügen der TcUtilities.Lib werden folgende Bibliotheken automatisch eingebunden: Standard.Lib; TcBase.Lib; TcSystem.Lib;
Betriebssystem Funktionen
Name | Beschreibung |
|---|---|
Das Betriebssystem herunterfahren (shutdown) | |
Den Shutdown-Prozess unterbrechen | |
Ein Restart des Betriebssystems durchführen | |
Die aktuelle lokale Windows-Systemzeit lesen | |
Die aktuelle lokale Windows-Systemzeit setzen | |
Aus der SPS Windows-Anwendungen starten | |
Die lokale Windows-Systemzeit mit der Echtzeituhr des PCs synchronisieren | |
Werte aus der Registrierung auslesen | |
Werte in die Registrierung schreiben | |
Dieser Funktionsbaustein sucht in einem Verzeichnis nach einer Datei oder einem Unterverzeichnis dessen Name dem spezifizierten Namen gleicht. Die gefundenen Einträge können einzeln ausgelesen werden. | |
Dieser Funktionsbaustein sucht in einem Verzeichnis nach einer Datei oder einem Unterverzeichnis dessen Name dem spezifizierten Namen gleicht. Die gefundenen Einträge können Gruppenweise ausgelesen werden. | |
Liest Netzwerkadapterinformationen | |
Liest den Host-Namen des lokalen PCs | |
Konvertiert den Host-Namen in die (IPv4) Internet Protokoll Netzwerkadresse. | |
Liest die Zeitzone-Konfiguration des Betriebssystems | |
Setzt die Zeitzone-Konfiguration des Betriebssystems | |
Liefert die lokale Windows-Systemzeit und Sommerzeit-/Winterzeit-Info |
TwinCAT SPS Funktionen
Name | Beschreibung |
|---|---|
Reset der SPS durchführen | |
SPS starten | |
SPS stoppen | |
Symbolinformationen der SPS lesen | |
Symbolinformationen einer SPS-Variablen anhand des Symbolnamens lesen | |
Symbolinformationen einer SPS-Variablen anhand des Symbolnamens lesen. Der Kommentar wird abgeschnitten wenn die verfügbare Puffergröße nicht ausreichend ist. | |
Die Ausführungszeit vom SPS-Code ermitteln | |
Schreiben der persistenten Daten auf den Datenträger aus der SPS auslösen | |
Schreiben der persistenten Daten auf den Datenträger aus der SPS auslösen (erweiterte Version) |
Checksumme/CRC Funktionen
Name | Beschreibung |
|---|---|
Berechnet die 16 Bit Check Summe | |
Berechnet CRC16-CCITT (zyklische Redundanz Prüfung) von einem beliebigen Datentyp | |
Berechnet CRC16-CCITT (zyklische Redundanz Prüfung) eines einzelnen Datenbytes |
TwinCAT Systemfunktionen
Name | Beschreibung |
|---|---|
TwinCAT System Restart durchführen | |
TwinCAT System stoppen | |
TwinCAT System in den CONFIG-Modus versetzen | |
Die CPU-Auslastung des TwinCAT Systems ermitteln | |
Die aktuelle und maximale Latenzzeit eines TwinCAT Systems ermitteln | |
Router Informationen über die konfigurierten Remote-PCs lesen | |
Die AmsNetId des lokalen TwinCAT PCs lesen | |
TwinCAT Router Statusinformationen lesen. | |
Router Verbindungsinformationen lesen | |
Eine neue Router-Verbindung hinzufügen | |
Eine vorhandene Router-Verbindung löschen |
TwinCAT Scope View Funktionen
Mit den beschriebenen Funktionsbausteinen ist es möglich das TwinCAT Scope View über ADS-Kommandos zu bedienen. Da dafür ein fester ADS-Port erforderlich ist, kann nur die erste Instanz des TwinCAT Scope Views bedient werden. Einige der Funktionen können zur Zeit nur genutzt werden, wenn nur ein View in der Applikation aktiv ist.
Name | Beschreibung |
|---|---|
Scope View Configuration Project in den TwinCAT Scope View laden | |
Scope View in Online-Zustand schalten | |
Scope View in Offline-Zustand schalten | |
Online/Offline - Zustand des Scope View ermitteln | |
Scope View manuell triggern | |
Die Aufnahme-Zeit konfigurieren | |
Die aktuelle Aufnahme-Zeit ermitteln | |
Scope View in ASCII-Datei exportieren | |
Scope View in binäre Datei exportieren | |
Scope View Project unter einem bestimmten Dateinamen speichern | |
TwinCAT Scope View (exe) beenden |
TwinCAT Scope Server
ab Bibliotheks-Version 2.0.52
Name | Beschreibung |
|---|---|
FB_ScopeServerControl | Steuert (start/speichern..) den Scope Server für data logging |
Konvertierungsfunktionen
Name | Beschreibung |
|---|---|
DATE_AND_TIME in Windows Systemzeit-Struktur konvertieren | |
DATE_AND_TIME in Windows File-Time konvertieren | |
Windows Systemzeit-Struktur in DATE_AND_TIME konvertieren | |
Windows Systemzeit-Struktur in File-Time konvertieren | |
Windows Systemzeit-Struktur in String konvertieren | |
String in Windows Systemzeit-Struktur konvertieren | |
Windows File-Time in DATE_AND_TIME konvertieren | |
Windows File-Time in Systemzeit-Struktur konvertieren | |
Dezimal-Zahlen in BCD-Zahlen konvertieren | |
BCD-Zahlen in Dezimal-Zahlen konvertieren | |
Grad-Winkel in Bogenmaß konvertieren | |
Bogenmaß in Grad-Winkel konvertieren | |
TIME-Variable in eine Struktur mit aufgelösten Millisekunden, Sekunden, Minuten usw. konvertieren. | |
Eine Struktur mit aufgelösten Millisekunden, Sekunden, Minuten usw. in TIME-Variable konvertieren. | |
Tauscht um das Hi- und Lo-Word einer REAL-Variablen | |
Konvertiert Byte Array in einen String | |
Konvertiert String in ein Byte Array | |
Konvertiert UTC-Zeit in Lokalzeit und umgekehrt (by bias) | |
Konvertiert kontinuierliche Lokalzeit (file time format) in UTC-Zeit | |
Konvertiert kontinuierliche Lokalzeit (structured system time format) in UTC-Zeit | |
Konvertiert UTC-Zeit (file time format) in Lokalzeit | |
Konvertiert UTC-Zeit (structured system time format) in Lokalzeit |
String-Formatfunktionen
Name | Beschreibung |
|---|---|
Konvertiert eine Fliesskommazahl in einen String mit der gewünschten Anzahl der Nachkommastellen. | |
Konvertiert Dezimalzahl in einen Dezimalstring. | |
Konvertiert Dezimalzahl in einen Hexadezimalstring. | |
Konvertiert Dezimalzahl in einen Oktalstring. | |
Konvertiert Dezimalzahl in einen Binärstring. | |
Konvertiert vorzeichenbehaftete Dezimalzahl in einen Dezimalstring. | |
Konvertiert und formatiert eine Dezimalzahl oder eine Fließkommazahl in einen String. | |
Konvertiert und formatiert bis zu 10 Argumente (Dezimal- oder Fließkommazahlen). | |
Durchsucht einen String nach Zahlen. | |
Konvertiert Kleinbuchstaben in Grossbuchstaben in einem String. | |
Konvertiert Grossbuchstaben in Kleinbuchstaben in einem String. | |
Entfernt Leerzeichen am Anfang eines Strings. | |
Entfernt Leerzeichen am Ende eines Strings. | |
Konvertiert Binärdaten in Hexadezimal-String. | |
Konvertiert Hexadezimal-String in Binärdaten. |
64 bit Funktionen (unsigned)
Name | Beschreibung |
|---|---|
Initialisiert/setzt eine 64 bit Zahl | |
Addiert zwei 64 bit Zahlen | |
Addiert zwei 64 bit Zahlen (mit Overflow check) | |
Subtrahiert zwei 64 bit Zahlen | |
Vergleicht zwei 64 bit Zahlen | |
Multipliziert zwei 32 bit Zahlen. Das Ergebnis ist eine 64 bit Zahl | |
Multipliziert zwei 64 bit Zahlen. Das Ergebnis ist eine 64 bit Zahl | |
Multipliziert zwei 64 bit Zahlen. Das Ergebnis ist eine 64 bit Zahl (mit Overflow check) | |
Division zweier 64 bit Zahlen. | |
Division zweier 64 bit Zahlen (mit Restergebnis). | |
Modulo-Division zweier 64 bit Zahlen | |
Bitweise AND zweier 64 bit Zahlen | |
Bitweise OR zweier 64 bit Zahlen | |
Bitweise NOT einer 64 bit Zahl | |
Bitweise XOR zweier 64 bit Zahlen | |
Bitweise Linksrotation einer 64 bit Zahl | |
Bitweise Rechtsrotation einer 64 bit Zahl | |
Bitweises Links-Shift einer 64 bit Zahl | |
Bitweises Rechts-Shift einer 64 bit Zahl | |
Minimumfunktion | |
Maximumfunktion | |
Limitierung | |
Prüft ob der Wert der 64 bit Zahl ist Null | |
Konvertiert 64 bit Zahl in einen STRING | |
Konvertiert 64 bit Zahl in einen LREAL | |
Konvertiert einen STRING in eine 64 bit Zahl | |
Konvertiert LREAL in eine 64 bit Zahl |
64 bit Funktionen (signed)
Name | Beschreibung |
|---|---|
Initialisiert/setzt eine 64 bit Zahl | |
Addiert zwei 64 bit Zahlen | |
Addiert zwei 64 bit Zahlen (mit Overflow check) | |
Subtrahiert zwei 64 bit Zahlen | |
Vergleicht zwei 64 bit Zahlen | |
Division zweier 64 bit Zahlen (mit Restergebnis) | |
Bitweise NOT einer 64 bit Zahl | |
Prüft ob der Wert der 64 bit Zahl ist Null | |
Negiert eine 64 bit Zahl | |
Konvertiert 64 bit Zahl in einen LREAL | |
Konvertiert LREAL in eine 64 bit Zahl | |
Konvertiert eine vorzeichenbehaftete 64 bit Zahl in eine vorzeichenlose 64 bit Zahl | |
Konvertiert eine vorzeichenlose 64 bit Zahl in eine vorzeichenbehaftete 64 bit Zahl |
16 Bit Festkommazahlen (signed)
Name | Beschreibung |
|---|---|
Addiert zwei Festkommazahlen | |
Ändert die Auflösung einer Festkommazahl | |
Subtrahiert zwei Festkommazahlen | |
Dividiert zwei Festkommazahlen | |
Multipliziert zwei Festkommazahlen | |
Konvertiert LREAL in eine Festkommazahl | |
Konvertiert WORD in eine Festkommazahl | |
Konvertiert eine Festkommazahl in LREAL | |
Konvertiert eine Festkommazahl in WORD |
Byte-Order-Konvertierungsfunktionen
Name | Beschreibung |
|---|---|
Host-To-Network Konvertierung (16 bit Zahl) | |
Host-To-Network Konvertierung (32 bit Zahl) | |
Host-To-Network Konvertierung (64 bit Zahl) | |
Host-To-Network Konvertierung (128 bit Zahl) | |
Network-To-Host Konvertierung (16 bit Zahl) | |
Network-To-Host Konvertierung (32 bit Zahl) | |
Network-To-Host Konvertierung (64 bit Zahl) | |
Network-To-Host Konvertierung (128 bit Zahl) |
Andere
Name | Beschreibung |
|---|---|
Einfacher PID controller | |
Versionsinformationen der Bibliothek lesen | |
Überprüft die Formatierung einer Gleitkommazahl nach der IEEE | |
Ermittelt ob ein Jahr Schaltjahr ist | |
Ermittelt die maximale Anzahl der Monatstage | |
Ermittelt die Nummer des Tages im Jahr | |
Ermittelt den Monat anhand der Nummer des Tages im Jahr | |
Ermittelt die Nummer des Wochentages. | |
Ermittelt die Kalenderwoche | |
Ermittelt das Datum des ersten, zweiten usw Wochentages in einem bestimmten Monat und Jahr | |
"Software"-RTC (Real Time Clock) | |
"Software"-RTC (Real Time Clock) | |
"Software"-RTC (Real Time Clock) | |
Schreibt/liest Datensätze in oder von der Datei (FIFO). | |
Schreibt/liest Datensätze in oder von einer Puffervariable (FIFO). | |
Schreibt/liest Datensätze in oder von einer Puffervariable (FIFO). | |
Schreibt/liest Strings in oder von einer Puffervariable (FIFO). | |
Schreibt/liest Datensätze in oder von einer Puffervariable (LIFO). | |
Einfache Hash-Tabelle. | |
Einfache verkettete Liste (doppelt verkettet). | |
Ein einfacher DCF77-Dekoder. | |
DCF77-Dekoder mit Plausibilitätsprüfung von zwei aufeinanderfolgenden Telegrammen und Zeitzoneninformation. |
CSV-Format Hilfsbausteine
Name | Beschreibung |
|---|---|
Konvertiert den Wert eines Strings mit einem Datenfeld im CSV-Format in eine SPS-Stringvariable | |
Konvertiert den Wert einer SPS-Stringvariablen in einen String mit einem Datenfeld im CSV-Format | |
Konvertiert einen Bytepuffer mit einem Datenfeld im CSV-Format in einen Wert einer beliebigen SPS-Variablen | |
Konvertiert den Wert einer beliebigen SPS-Variablen in einen Bytepuffer mit einem Datenfeld im CSV-Format | |
Teilt Datensätze im CSV-Format die in einem Bytepuffer vorliegen in einzelne Datenfelder. | |
Erzeugt aus einzelnen Datenfeldern einzelne oder mehrere Datensätze in einem Bytepuffer |