Übersicht

Die SPS-Bibliothek Tc2_Utilities umfasst Funktionsbausteine und Funktionen zum Aufruf von TwinCAT-Systemfunktionen und Betriebssystemfunktionen sowie verschiedene Konvertierungsfunktionen.

Betriebssystemfunktionen

Name

Beschreibung

NT_Shutdown

Betriebssystem herunterfahren (shutdown).

NT_AbortShutdown

Shutdown-Prozess unterbrechen.

NT_Reboot

Restart des Betriebssystems durchführen.

NT_GetTime

Aktuelle lokale Windows-Systemzeit lesen.

NT_SetLocalTime

Aktuelle lokale Windows-Systemzeit setzen.

NT_StartProcess

Windows-Anwendungen aus der SPS starten.

NT_SetTimeToRTCTime

Die lokale Windows-Systemzeit mit der Echtzeituhr des PCs synchronisieren.

FB_RegQueryValue

Werte aus der Registrierung auslesen.

FB_RegSetValue

Werte in die Registrierung schreiben.

FB_EnumFindFileEntry

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.

FB_EnumFindFileList

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.

FB_GetAdaptersInfo

Liest Netzwerkadapterinformationen.

FB_GetHostName

Liest den Host-Namen des lokalen PCs.

FB_GetHostAddrByName

Konvertiert den Host-Namen in die (IPv4) Internet Protokoll Netzwerkadresse.

FB_GetTimeZoneInformation

Liest die Zeitzone-Konfiguration des Betriebssystems.

FB_SetTimeZoneInformation

Setzt die Zeitzone-Konfiguration des Betriebssystems.

FB_LocalSystemTime

Liefert die lokale Windows-Systemzeit und Sommerzeit-/Winterzeit-Info.

SPS-Funktionen

Name

Beschreibung

PLC_Reset

Reset der SPS durchführen.

PLC_Start

SPS starten.

PLC_Stop

SPS stoppen.

PLC_ReadSymInfo

Symbolinformationen der SPS lesen.

PLC_ReadSymInfoByName

Symbolinformationen einer SPS-Variablen anhand des Symbolnamens lesen.

PLC_ReadSymInfoByNameEx

Symbolinformationen einer SPS-Variablen anhand des Symbolnamens lesen. Der Kommentar wird abgeschnitten wenn die verfügbare Puffergröße nicht ausreichend ist.

Profiler

Ausführungszeit vom SPS-Code ermitteln.

WritePersistentData

Persistente Daten auf den Datenträger aus dem SPS-Programm heraus speichern.

FB_WritePersistentData

Persistente Daten auf den Datenträger aus dem SPS-Programm heraus speichern (erweiterte Version).

Checksumme/CRC-Funktionen

Name

Beschreibung

F_CheckSum16

Berechnet die 16-Bit-Check-Summe.

F_DATA_TO_CRC16_CCITT

Berechnet CRC16-CCITT (zyklische Redundanz Prüfung) von einem beliebigen Datentyp.

F_BYTE_TO_CRC16_CCITT

Berechnet CRC16-CCITT (zyklische Redundanz Prüfung) eines einzelnen Datenbytes.

Systemfunktionen

Name

Beschreibung

TC_Restart

TwinCAT-System Restart durchführen.

TC_Stop

TwinCAT-System stoppen.

TC_Config

TwinCAT-System in den CONFIG-Modus versetzen.

TC_CpuUsage

Die CPU-Auslastung des TwinCAT-Systems ermitteln.

TC_SysLatency

Die aktuelle und maximale Latenzzeit eines TwinCAT-Systems ermitteln.

GetRemotePCInfo

Router-Informationen über die konfigurierten Remote-PCs lesen.

FB_GetLocalAmsNetId

AmsNetId des lokalen TwinCAT-PCs lesen.

FB_GetRouterStatusInfo

Router-Statusinformationen lesen.

FB_EnumRouteEntry

Router-Verbindungsinformationen lesen.

FB_AddRouteEntry

Neue Router-Verbindung hinzufügen.

FB_RemoveRouteEntry

Vorhandene Router-Verbindung löschen.

ROUTETRANSPORT_TO_STRING

Konvertiert die AMS Message Router Transportschichtkennung in einen String.

FB_GetDeviceIdentification

Liest die Geräteidentifikation ein.

FB_GetDeviceIdentificationEx

Liest die Geräteidentifikation ein. (Erlaubt längere Strings bei Hardware Model und Seriennummer.)

FB_GetLicences

Liest die gültigen und ungültigen TwinCAT Lizenzen aus.

FB_GetSystemId

Liest die SystemID als GUID aus.

FB_GetVolumeId

Liest die SystemID und die Volume-System-ID aus.

Scope-View-Funktionen

Scope-View-Funktionen werden von TwinCAT 3 nicht mehr unterstützt.

Scope-Server-Funktionen

Name

Beschreibung

FB_ScopeServerControl

Steuert (start/speichern…) den Scope Server für data logging.

ADS-Monitor-Funktionen

Name

Beschreibung

FB_AmsLogger

AMS Logger aus der SPS starten/stoppen.

Konvertierungsfunktionen

Name

Beschreibung

DT_TO_SYSTEMTIME

DATE_AND_TIME in Windows‑Systemzeit‑Struktur konvertieren.

DT_TO_FILETIME

DATE_AND_TIME in Windows‑File‑Time konvertieren.

SYSTEMTIME_TO_DT

Windows Systemzeit-Struktur in DATE_AND_TIME konvertieren.

SYSTEMTIME_TO_FILETIME

Windows Systemzeit-Struktur in File-Time konvertieren.

SYSTEMTIME_TO_STRING

Windows Systemzeit-Struktur in String konvertieren.

STRING_TO_SYSTEMTIME

String in Windows Systemzeit-Struktur konvertieren.

FILETIME_TO_DT

Windows File-Time in DATE_AND_TIME konvertieren.

FILETIME_TO_SYSTEMTIME

Windows File-Time in Systemzeit-Struktur konvertieren.

DEC_TO_BCD

Dezimal-Zahlen in BCD-Zahlen konvertieren.

BCD_TO_DEC

BCD-Zahlen in Dezimal-Zahlen konvertieren.

DEG_TO_RAD

Grad-Winkel in Bogenmaß konvertieren.

RAD_TO_DEG

Bogenmaß in Grad-Winkel konvertieren.

TIME_TO_OTSTRUCT

TIME-Variable in eine Struktur mit aufgelösten Millisekunden, Sekunden, Minuten usw. konvertieren.

OTSTRUCT_TO_TIME

Struktur mit aufgelösten Millisekunden, Sekunden, Minuten usw. in TIME-Variable konvertieren.

F_SwapRealEx

Tauscht um das Hi- und Lo-Word einer REAL-Variablen.

BYTE_TO_LREALEX

Erlaubt eine explizite Konvertierung vom Typ BYTE in eine positive Fließkommazahl vom Typ LREAL.

DWORD_TO_LREALEX

Erlaubt eine explizite Konvertierung vom Typ DWORD in eine positive Fließkommazahl vom Typ LREAL.

UDINT_TO_LREALEX

Erlaubt eine explizite Konvertierung vom Typ UDINT in eine positive Fließkommazahl vom Typ LREAL.

UINT_TO_LREALEX

Erlaubt eine explizite Konvertierung vom Typ UINT in eine positive Fließkommazahl vom Typ LREAL.

ULINT_TO_ULARGE

Konvertiert eine 64 Bit Zahl vom Typ ULINT in eine 64 Bit Zahl vom Typ T_ULARGE_INTEGER.

USINT_TO_LREALEX

Erlaubt eine explizite Konvertierung vom Typ USINT in eine positive Fließkommazahl vom Typ LREAL.

BYTEARR_TO_MAXSTRING

Konvertiert Byte Array in einen String.

MAXSTRING_TO_BYTEARR

Konvertiert String in ein Byte Array.

F_TranslateFileTimeBias

Konvertiert UTC-Zeit in Lokalzeit und umgekehrt (by bias).

FB_TzSpecificLocalTimeToFileTime

Konvertiert kontinuierliche Lokalzeit (file time format) in UTC-Zeit.

FB_TzSpecificLocalTimeToSystemTime

Konvertiert kontinuierliche Lokalzeit (structured system time format) in UTC-Zeit.

FB_FileTimeToTzSpecificLocalTime

Konvertiert UTC-Zeit (file time format) in Lokalzei.t

FB_SystemTimeToTzSpecificLocalTime

Konvertiert UTC-Zeit (structured system time format) in Lokalzeit.

HEXASCNIBBLE_TO_BYTE

Konvertiert den ASCII-Code eines hexadezimalen Halbbytezeichens in den Dezimalwert.

HEXCHRNIBBLE_TO_BYTE

Konvertiert ein hexadezimales Halbbytezeichen in seinen dezimalen Wert.

GuidsEqualByVal

Vergleicht zwei GUID-Werte

STRING-Funktionen

Name

Beschreibung

LREAL_TO_FMTSTR

Konvertiert eine Fließkommazahl in einen String mit der gewünschten Anzahl der Nachkommastellen.

DWORD_TO_DECSTR

Konvertiert Dezimalzahl in einen Dezimalstring.

DWORD_TO_HEXSTR

Konvertiert Dezimalzahl in einen Hexadezimalstring.

DWORD_TO_OCTSTR

Konvertiert Dezimalzahl in einen Oktalstring.

DWORD_TO_BINSTR

Konvertiert Dezimalzahl in einen Binärstring.

LWORD_TO_DECSTR

Konvertiert Dezimalzahl in einen Dezimalstring.

LWORD_TO_HEXSTR

Konvertiert Dezimalzahl in einen Hexadezimalstring.

LWORD_TO_OCTSTR

Konvertiert Dezimalzahl in einen Oktalstring.

LWORD_TO_BINSTR

Konvertiert Dezimalzahl in einen Binärstring.

PVOID_TO_DECSTR

Konvertiert Adresse (Pointer) in einen Dezimalstring.

PVOID_TO_HEXSTR

Konvertiert Adresse (Pointer) in einen Hexadezimalstring.

PVOID_TO_OCTSTR

Konvertiert Adresse (Pointer) in einen Oktalstring.

PVOID_TO_BINSTR

Konvertiert Adresse (Pointer) in einen Binärstring.

PVOID_TO_STRING

Konvertiert Adresse (Pointer) in einen String.

STRING_TO_PVOID

Konvertiert einen String in eine Adresse (Pointer).

LINT_TO_DECSTR

Konvertiert vorzeichenbehaftete Dezimalzahl (64 Bit) in einen Dezimalstring.

DINT_TO_DECSTR

Konvertiert vorzeichenbehaftete Dezimalzahl (32 Bit) in einen Dezimalstring.

F_FormatArgToStr

Konvertiert und formatiert eine Dezimalzahl oder eine Fließkommazahl in einen String.

BYTE_TO_BINSTR

Konvertiert eine Dezimalzahl vom Typ Byte in einen Binärstring.

BYTE_TO_DECSTR

Konvertiert eine Dezimalzahl in einen Dezimalstring.

BYTE_TO_HEXSTR

Konvertiert eine Dezimalzahl in einen Hexadezimalstring.

BYTE_TO_OCTSTR

Konvertiert eine Dezimalzahl in einen Oktalstring.

WORD_TO_BINSTR

Konvertiert eine Dezimalzahl vom Typ Word in einen Binärstring.

WORD_TO_DECSTR

Konvertiert eine Dezimalzahl vom Typ Word in einen Dezimalstring.

WORD_TO_HEXSTR

Konvertiert eine Dezimalzahl vom Typ Word in einen Hexadezimalstring.

WORD_TO_OCTSTR

Konvertiert eine Dezimalzahl vom Typ Word in einen Oktalstring.

FB_FormatString

Konvertiert und formatiert bis zu 10 Argumente (Dezimal- oder Fließkommazahlen).

FB_EnumStringNumbers

Durchsucht einen String nach Zahlen.

F_ToUCase

Konvertiert Kleinbuchstaben in Großbuchstaben in einem String.

F_ToLCase

Konvertiert Großbuchstaben in Kleinbuchstaben in einem String.

F_LTrim

Entfernt Leerzeichen am Anfang eines Strings.

F_RTrim

Entfernt Leerzeichen am Ende eines Strings.

DATA_TO_HEXSTR

Konvertiert Binärdaten in Hexadezimal-String.

HEXSTR_TO_DATA

Konvertiert Hexadezimal-String in Binärdaten.

GUID_TO_STRING

Konvertiert eine strukturierte GUID-Variable in eine GUID- Stringvariable.

GUID_TO_REGSTRING

Konvertiert eine strukturierte GUID-Variable in eine Registry-GUID-Stringvariable

REGSTRING_TO_GUID

Konvertiert eine Registry-GUID-Stringvariable in eine strukturierte GUID-Variable.

Erweiterte STRING-Funktionen

Name

Beschreibung

CHAR_TO_WCHAR

Konvertiert ein Zeichen vom Typ STRING in ein Zeichen vom Typ WSTRING (mit Null-Terminierung).

CONCAT2

Verkettet zwei beliebig lange Zeichenketten vom Typ STRING.

DELETE2

Entfernt nLen Zeichen einer Zeichenfolge beginnend an der Position nPos.

F_StringIsASCII

Prüft, ob eine Zeichenfolge nur ASCII-Zeichen (0x000 bis 0x7F) enthält und gibt die Anzahl der ASCII-Zeichen zurück.

FIND2

Findet eine ggf. mehrfach vorkommende Zeichenfolge in einer anderen Zeichenfolge.

FindAndDelete

Findet eine ggf. mehrfach vorkommende Zeichenfolge in einer anderen Zeichenfolge und entfernt diese.

FindAndDeleteChar

Findet ein ggf. mehrfach vorkommendes Zeichen in einer Zeichenfolge und entfernt dieses.

FindAndReplace

Findet eine ggf. mehrfach vorkommende Zeichenfolge in einer anderen Zeichenfolge und ersetzt diese durch eine andere Zeichenfolge.

FindAndReplaceChar

Findet ein ggf. mehrfach vorkommendes Zeichen in einer Zeichenfolge und ersetzt dieses durch ein anderes Zeichen.

INSERT2

Fügt eine Zeichenfolge in eine andere Zeichenfolge nach der Position nPos ein.

LEN2

Gibt die Anzahl der Zeichen in einer Zeichenfolge zurück.

REPLACE2

Ersetzt nLen Zeichen einer Zeichenfolge durch eine andere Zeichenfolge beginnend an der Position nPos.

sLiteral_TO_UTF8

Konvertiert eine Beliebige Zeichenfolge vom Datentyp STRING in eine Zeichenfolge im UTF-8-Format.

STRING_TO_UTF8

Konvertiert eine beliebige Zeichenfolge einer Variablen vom Datentyp STRING in eine Zeichenfolge im UTF-8-Format.

STRING_TO_WSTRING2

Konvertiert eine Variable vom Datentyp STRING in eine Variable vom Datentyp WSTRING.

STRNCPY

Kopiert die Zeichenfolge einer Variablen vom Datentyp STRING und prüft, ob die Zeichenfolge vollständig kopiert wurde.

UTF8_TO_STRING

Konvertiert eine Zeichenfolge im UTF8-Format in eine Zeichenfolge vom Datentyp STRING.

UTF8_TO_WSTRING

Konvertiert eine Zeichenfolge im UTF-8-Format in eine Zeichenfolge vom Datentyp WSTRING.

UTF8Len

Gibt die Anzahl der Zeichen einer UTF‑8‑Zeichenfolge zurück.

WCHAR_TO_CHAR

Konvertiert eine Variable vom Datentyp WSTRING in eine Variable vom Datentyp STRING (mit Null-Terminierung).

WCONCAT2

Verkettet zwei beliebig lange Zeichenfolgen vom Datentyp WSTRING.

WLEN2

Gibt die Anzahl der Zeichen in einer Unicode-Zeichenfolge vom Datentyp WSTRING zurück.

wsLiteral_TO_UTF8

Konvertiert eine beliebige Zeichenfolge vom Datentyp WSTRING in eine Zeichenfolge im UTF-8-Format.

WSTRING_TO_STRING2

Konvertiert eine Variable vom Datentyp WSTRING in eine Variable vom Datentyp STRING.

WSTRING_TO_UTF8

Konvertiert eine Zeichenfolge einer Variablen vom Datentyp WSTRING in eine Zeichenfolge im UTF-8-Format.

WSTRNCPY

Kopiert eine Zeichenfolge einer Variablen vom Datentyp WSTRING und prüft, ob die Zeichenfolge vollständig kopiert wurde.

64-Bit-Funktionen (unsigned)

Name

Beschreibung

ULARGE_INTEGER

Initialisiert/setzt eine 64-Bit-Zahl.

UInt64Add64

Addiert zwei 64-Bit-Zahlen.

UInt64Add64Ex

Addiert zwei 64-Bit-Zahlen (mit Overflow check).

UInt64Sub64

Subtrahiert zwei 64-Bit-Zahlen.

UInt64Cmp64

Vergleicht zwei 64-Bit-Zahlen.

UInt32x32To64

Multipliziert zwei 32-Bit-Zahlen. Das Ergebnis ist eine 64-Bit-Zahl.

UInt64Mul64

Multipliziert zwei 64-Bit-Zahlen. Das Ergebnis ist eine 64-Bit-Zahl.

UInt64Mul64Ex

Multipliziert zwei 64-Bit-Zahlen. Das Ergebnis ist eine 64-Bit-Zahl (mit Overflow check).

UInt64Div64

Division zweier 64-Bit-Zahlen.

UInt64Div64Ex

Division zweier 64-Bit-Zahlen (mit Restergebnis).

Uint64Div16Ex

Division einer 64-Bit-Zahl durch eine 16‑Bit‑Zahl. Das Ergebnis ist eine 64-Bit-Zahl.

UInt64Mod64

Modulo-Division zweier 64-Bit-Zahlen.

UInt64And

Bitweise AND zweier 64-Bit-Zahlen.

UInt64Or

Bitweise OR zweier 64-Bit-Zahlen.

UInt64Not

Bitweise NOT einer 64-Bit-Zahlen.

UInt64Xor

Bitweise XOR zweier 64-Bit-Zahlen.

UInt64Rol

Bitweise Linksrotation einer 64-Bit-Zahl.

UInt64Ror

Bitweise Rechtsrotation einer 64-Bit-Zahl.

UInt64Shl

Bitweises Links-Shift einer 64-Bit-Zahl.

UInt64Shr

Bitweises Rechts-Shift einer 64-Bit-Zahl.

UInt64Min

Minimumfunktion

UInt64Max

Maximumfunktion

UInt64Limit

Limitierung

UInt64isZero

Prüft ob der Wert der 64-Bit-Zahl ist Null.

UINT64_TO_STRING

Konvertiert 64-Bit-Zahl in einen STRING.

UINT64_TO_LREAL

Konvertiert 64-Bit-Zahl in einen LREAL.

STRING_TO_UINT64

Konvertiert einen STRING in eine 64-Bit-Zahl.

LREAL_TO_UINT64

Konvertiert LREAL in eine 64-Bit-Zahl.

LWORD_TO_ULARGE

Konvertiert eine 64-Bit-Zahl vom Typ LWORD in eine 64-Bit-Zahl vom Typ T_ULARGE_INTEGER.

ULARGE_TO_LWORD

Konvertiert eine 64-Bit-Zahl vom Typ T_ULARGE_INTEGER in eine 64-Bit-Zahl vom Typ LWORD.

ULARGE_TO_ULINT

Konvertiert eine 64-Bit-Zahl vom Typ T_ULARGE_INTEGER in eine 64 Bit Zahl ULINT.

64-Bit-Funktionen (signed)

Name

Beschreibung

LARGE_INTEGER

Initialisiert/setzt eine 64-Bit-Zahl.

Int64Add64

Addiert zwei 64-Bit-Zahlen.

Int64Add64Ex

Addiert zwei 64-Bit-Zahlen (mit Overflow check).

Int64Sub64

Subtrahiert zwei 64-Bit-Zahlen.

Int64Cmp64

Vergleicht zwei 64-Bit-Zahlen.

Int64Div64Ex

Division zweier 64-Bit-Zahlen (mit Restergebnis).

Int64Not

Bitweise NOT einer 64-Bit-Zahl.

Int64isZero

Prüft ob der Wert der 64-Bit-Zahl ist Null.

Int64Negate

Negiert eine 64-Bit-Zahl.

INT64_TO_LREAL

Konvertiert 64-Bit-Zahl in einen LREAL.

LREAL_TO_INT64

Konvertiert LREAL in eine 64 Bit Zahl.

LARGE_TO_ULARGE

Konvertiert eine vorzeichenbehaftete 64-Bit-Zahl in eine vorzeichenlose 64-Bit-Zahl.

ULARGE_TO_LARGE

Konvertiert eine vorzeichenlose 64-Bit-Zahl in eine vorzeichenbehaftete 64-Bit-Zahl.

LARGE_TO_LINT

Konvertiert eine vorzeichenbehaftete 64-Bit-Zahl vom Typ LINT in eine vorzeichenbehaftete 64‑Bit‑Zahl vom Typ T_LARGE_INTEGER).

LINT_TO_LARGE

Konvertiert eine vorzeichenbehaftete 64-Bit-Zahl vom Typ T_LARGE_INTEGER in eine vorzeichenbehaftete 64-Bit-Zahl vom Typ LINT.

16-Bit-Festkommazahl-Funktionen (signed)

Name

Beschreibung

FIX16Add

Addiert zwei Festkommazahlen.

FIX16Align

Ändert die Auflösung einer Festkommazahl.

FIX16Sub

Subtrahiert zwei Festkommazahlen.

FIX16Div

Dividiert zwei Festkommazahlen.

FIX16Mul

Multipliziert zwei Festkommazahlen.

LREAL_TO_FIX16

Konvertiert LREAL in eine Festkommazahl.

WORD_TO_FIX16

Konvertiert WORD in eine Festkommazahl.

FIX16_TO_LREAL

Konvertiert eine Festkommazahl in LREAL.

FIX16_TO_WORD

Konvertiert eine Festkommazahl in WORD.

Byte-Order-Konvertierungsfunktionen

Name

Beschreibung

HOST_TO_BE16

Host-To-Network Konvertierung (16-Bit-Zahl)

HOST_TO_BE32

Host-To-Network Konvertierung (32-Bit-Zahl)

HOST_TO_BE64

Host-To-Network Konvertierung (64-Bit-Zahl, „legacy“-Typ: T_ULARGE_INTEGER)

HOST_TO_BE64EX

Host-To-Network Konvertierung (64-Bit-Zahl, „native“-Typ: LWORD)

HOST_TO_BE128

Host-To-Network Konvertierung (128-Bit-Zahl, „legacy“-Typ: T_UHUGE_INTEGER)

BE16_TO_HOST

Network-To-Host Konvertierung (16-Bit-Zahl)

BE32_TO_HOST

Network-To-Host Konvertierung (32-Bit-Zahl)

BE64_TO_HOST

Network-To-Host Konvertierung (64-Bit-Zahl, „legacy“-Typ: T_ULARGE_INTEGER)

BE64_TO_HOSTEX

Network-To-Host Konvertierung (64-Bit-Zahl, „native“-Typ: LWORD)

BE128_TO_HOST

Network-To-Host Konvertierung (128-Bit-Zahl, „legacy“-Typ: T_UHUGE_INTEGER)

FLOAT-Funktionen

Name

Beschreibung

BOOL_TO_FLOAT

Konvertiert eine Variable vom Typ BOOL in eine Variable vom Typ LREAL.

DINT_TO_FLOAT

Konvertiert eine Variable vom Typ DINT in eine Variable vom Typ FLOAT.

FLOAT_TO_BOOL

Konvertiert eine Variable vom Typ FLOAT in eine Variable vom Typ BOOL.

FLOAT_TO_DINT

Konvertiert eine Variable vom Typ FLOAT in eine Variable vom Typ DINT.

FLOAT_TO_INT

Konvertiert eine Variable vom Typ FLOAT in eine Variable vom Typ INT.

FLOAT_TO_SINT

Konvertiert eine Variable vom Typ FLOAT in eine Variable vom Typ SINT.

FLOAT_TO_STRING

Konvertiert eine Variable vom Typ FLOAT in eine Variable vom Typ STRING.

FLOAT_TO_TIME

Konvertiert eine Variable vom Typ FLOAT in eine Variable vom Typ TIME.

FLOAT_TO_UDINT

Konvertiert eine Variable vom Typ FLOAT in eine Variable vom Typ UDINT.

FLOAT_TO_UINT

Konvertiert eine Variable vom Typ FLOAT in eine Variable vom Typ UINT.

INT_TO_FLOAT

Konvertiert eine Variable vom Typ INT in eine Variable vom Typ FLOAT.

SINT_TO_FLOAT

Konvertiert eine Variable vom Typ SINT in eine Variable vom Typ FLOAT.

TIME_TO_FLOAT

Konvertiert eine Variable vom Typ TIME in eine Variable vom Typ FLOAT.

UDINT_TO_FLOAT

Konvertiert eine Variable vom Typ UDINT in eine Variable vom Typ FLOAT.

UINT_TO_FLOAT

Konvertiert eine Variable vom Typ UINT in eine Variable vom Typ FLOAT.

LrealIsFinite

Liefert TRUE, wenn das Argument vom Typ LREAL einen endlichen Wert besitzt.

LrealIsNaN

Liefert TRUE, wenn das Argument vom Typ LREAL einen undefinierten Wert besitzt (NaN).

LCOMPLEX-Funktionen

LcomplexIsNaN

Liefert TRUE, wenn das Argument vom Typ LCOMPLEX einen undefinierten Wert besitzt (NaN).

LcomplexAbs

Liefert den Absolutwert zur übergebenen komplexen Zahl.

P[TYPE]_TO_[TYPE]-Konvertierungsfunktionen

Name

Beschreibung

PBOOL_TO_BOOL

Liefert den Inhalt einer BOOL-Pointervariablen.

PBYTE_TO_BYTE

Liefert den Inhalt einer BYTE-Pointervariablen.

PDATE_TO_DATE

Liefert den Inhalt einer DATE-Pointervariablen.

PDINT_TO_DINT

Liefert den Inhalt einer DINT Pointervariablen.

PDT_TO_TO_DT

Liefert den Inhalt einer DT-Pointervariablen.

PDWORD_TO_DWORD

Liefert den Inhalt einer DWORD‑Pointervariablen.

PHUGE_TO_HUGE

Liefert den Inhalt einer T_HUGE_INTEGER‑Pointervariablen.

PINT_TO_INT

Liefert den Inhalt einer INT‑Pointervariablen.

PLARGE_TO_LARGE

Liefert den Inhalt einer T_LARGE_INTEGER‑Pointervariablen.

PLINT_TO_LINT

Liefert den Inhalt einer LINT‑Pointervariablen.

PLREAL_TO_TO_LREAL

Liefert den Inhalt einer LREAL‑Pointervariablen.

PLWORD_TO_LWORD

Liefert den Inhalt einer LWORD‑Pointervariablen.

PMAXSTRING_TO_MAXSTRING

Liefert den Inhalt einer T_MaxString‑Pointervariablen.

PREAL_TO_REAL

Liefert den Inhalt einer REAL‑Pointervariablen.

PSINT_TO_SINT

Liefert den Inhalt einer SINT‑Pointervariablen.

PSTRING_TO_STRING

Liefert den Inhalt einer STRING‑Pointervariablen.

PTIME_TO_TIME

Liefert den Inhalt einer TIME‑Pointervariablen.

PTOD_TO_TOD

Liefert den Inhalt einer TOD‑Pointervariablen.

PUDINT_TO_UDINT

Liefert den Inhalt einer UDINT-Pointervariablen.

PUHUGE_TO_UHUGE

Liefert den Inhalt einer T_UHUGE_INTEGER‑Pointervariablen.

PUINT_TO_UINT

Liefert den Inhalt einer UINT‑Pointervariablen.

PULARGE_TO_ULARGE

Liefert den Inhalt einer T_ULARGE_INTEGER‑Pointervariablen.

PULINT_TO_ULINT

Liefert den Inhalt einer ULINT‑Pointervariablen.

PUSINT_TO_USINT

Liefert den Inhalt einer USINT‑Pointervariablen.

PWORD_TO_WORD

Liefert den Inhalt einer WORD‑Pointervariablen.

PUINT64_TO_UINT64

Liefert den Inhalt einer T_ULARGE_INTEGER‑Pointervariablen.

T_Arg-Hilfsfunktionen

Name

Beschreibung

F_ARGCMP

Vergleicht zwei Variablen vom Typ T_Arg

F_ARGCPY

Kopiert den Wert einer Variablen vom Typ T_Arg in eine andere Variable und liefert die Anzahl der erfolgreich kopierten Datenbytes zurück.

F_ARGISZERO

Liefert TRUE, wenn eine der T_Arg‑Membervariablen den Wert Null hat oder nicht initialisiert wurde.

F_BIGTYPE

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer Struct- oder Array‑Variablen.

F_BOOL

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer BOOL-Variablen.

F_BYTE

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer BYTE-Variablen.

F_DINT

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer DINT-Variablen.

F_DWORD

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer DWORD-Variablen.

F_HUGE

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer T_HUGE_INTEGER-Variablen.

F_INT

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer INT- Variablen.

F_LARGE

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer T_LARGE_INTEGER‑Variablen.

F_LINT

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer LINT-Variablen.

F_LREAL

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer LREAL-Variablen.

F_LWORD

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer LWORD-Variablen.

F_REAL

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer REAL-Variablen.

F_SINT

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer SINT-Variablen.

F_STRING

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer T_MaxString-Variablen.

F_UDINT

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer UDINT-Variablen.

F_UHUGE

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer T_UHUGE_INTEGER-Variablen.

F_UINT

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer UINT-Variablen.

F_ULARGE

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer T_ULARGE_INTEGER‑Variablen.

F_ULINT

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer ULINT-Variablen.

F_USINT

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer USINT-Variablen.

F_WORD

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer WORD-Variablen.

F_PVOID

Liefert in einer Struktur vom Typ T_Arg Informationen zu einer PVOID-Variablen.

CSV-Formatfunktionen

Name

Beschreibung

CSVFIELD_TO_STRING

Konvertiert den Wert eines Strings mit einem Datenfeld im CSV-Format in eine SPS‑Stringvariable.

STRING_TO_CSVFIELD

Konvertiert den Wert einer SPS-Stringvariablen in einen String mit einem Datenfeld im CSV‑Format.

CSVFIELD_TO_ARG

Konvertiert einen Bytepuffer mit einem Datenfeld im CSV-Format in einen Wert einer beliebigen SPS-Variablen.

ARG_TO_CSVFIELD

Konvertiert den Wert einer beliebigen SPS‑Variablen in einen Bytepuffer mit einem Datenfeld im CSV-Format.

FB_CSVMemBufferReader

Teilt Datensätze im CSV-Format die in einem Bytepuffer vorliegen in einzelne Datenfelder.

FB_CSVMemBufferWriter

Erzeugt aus einzelnen Datenfeldern einzelne oder mehrere Datensätze in einem Bytepuffer

Lizenzierungsfunktionen

Name

Beschreibung

FB_LicFileGetStorageInfo

Liest die StorageInfo des Lizenz-Dongles und das Dateiverzeichnis aus.

FB_LicFileCreate

Erzeugt eine Datei auf dem Lizenz-Dongle.

FB_LicFileDelete

Löscht eine Datei auf dem Lizenz-Dongle.

FB_LicFileRead

Liest eine Datei vom Lizenz-Dongle in einen bereitgestellten Buffer.

FB_LicFileCopyToDongle

Kopiert eine Datei von der Festplatte auf den Lizenz‑Dongle.

FB_LicFileCopyFromDongle

Kopiert eine Datei vom Lizenz-Dongle auf die Festplatte.

FB_CheckLicense

Ermittelt den TwinCAT-3-Lizenzstatus für eine gegebene Lizenz-ID.

FB_GetDongleSystemId

Liest die System-ID und die Volume-ID des TwinCAT-3-Lizenz-Dongles als GUID aus.

FB_GetLicenseDongle

Ermittelt die Anzahl angeschlossener Lizenz-Dongles und liefert Adresse und Status.

FB_GetLicenses

Liest die gültigen und ungültigen TwinCAT-Lizenzen aus.

FB_GetLicensesEx

Ermittelt den Status aller TwinCAT-3-Lizenzen und OEM-Lizenzen.

Andere Funktionen

Name

Beschreibung

FB_BasicPID

Einfacher PID controller

F_GetVersionTcUtilities

Versionsinformationen der Bibliothek lesen.

IsFinite

Überprüft die Formatierung einer Gleitkommazahl nach der IEEE.

F_YearIsLeapYear

Ermittelt ob ein Jahr Schaltjahr ist.

F_GetMaxMonthDays

Ermittelt die maximale Anzahl der Monatstage.

F_GetDOYOfYearMonthDay

Ermittelt die Nummer des Tages im Jahr.

F_GetMonthOfDOY

Ermittelt den Monat anhand der Nummer des Tages im Jahr.

F_GetDayOfWeek

Ermittelt die Nummer des Wochentages.

F_GetWeekOfTheYear

Ermittelt die Kalenderwoche.

F_GetDayOfMonthEx

Ermittelt das Datum des ersten, zweiten usw. Wochentages in einem bestimmten Monat und Jahr.

F_GetWeekOfTheYear

Liefert die Nummer der Kalenderwoche zu einem vorgegebenen Datum.

RTC

"Software"-RTC (Real Time Clock)

RTC_EX

"Software"-RTC (Real Time Clock)

RTC_EX2

"Software"-RTC (Real Time Clock)

FB_FileRingBuffer

Schreibt/liest Datensätze in oder von der Datei (FIFO).

FB_MemRingBuffer

Schreibt/liest Datensätze in oder von einer Puffervariable (FIFO).

FB_MemRingBufferEx

Schreibt/liest Datensätze in oder von einer Puffervariable (FIFO).

FB_StringRingBuffer

Schreibt/liest Strings in oder von einer Puffervariable (FIFO).

FB_MemStackBuffer

Schreibt/liest Datensätze in oder von einer Puffervariable (LIFO).

FB_MemBufferMerge

Fügt einzelne kleinere Datensegmente zu einem größeren Datensegment zusammen.

FB_MemBufferSplit

Teilt einen Speicherbereich (Datenpuffer) in mehrere kleinere Segmente auf.

FB_HashTableCtrl, F_CreateHashTableHnd

Einfache Hash-Tabelle.

FB_LinkedListCtrl, F_CreateLinkedListHnd

Einfache verkettete Liste (doppelt verkettet).

DCF77_TIME

Einfacher DCF77-Dekoder.

DCF77_TIME_EX

DCF77-Dekoder mit Plausibilitätsprüfung von zwei aufeinanderfolgenden Telegrammen und Zeitzoneninformation.