Übersicht

Nicht alle Funktionsbausteine und Funktionen, die häufig in SPS-Applikationen benötigt werden, sind in der IEC61131-3 genormt. Die Bibliothek Tc2_System enthält solche Funktionen und Funktionsbausteine des TwinCAT-Systems, die nicht zum Standardumfang der IEC61131-3 gehören und dementsprechend herstellerspezifisch sind.

Generelle Funktionsbausteine

Name

Beschreibung

DRAND

Zufallszahlengenerator

FB_lecCriticalSection

Kritische Bereiche unter gegenseitigen Ausschluss stellen

FB_SetLedColor_BAPI

Schaltet User-LED auf PCs und Embedded PCs mit BIOS-API-Unterstützung

GETCURTASKINDEX

Ermittelt den aktuellen Taskindex

ADS-Funktionsbausteine

Name

Beschreibung

ADSREAD

Lesen von Daten über ADS

ADSREADEX

Lesen von Daten über ADS und Ermittlung der tatsächlichen Anzahl der gelesenen Bytes

ADSWRITE

Schreiben von Daten über ADS

ADSRDWRT

Schreiben und Lesen von Daten über ADS

ADSRDWRTEX

Schreiben und Lesen von Daten über ADS und Ermittlung der tatsächlichen Anzahl der gelesenen Bytes

ADSRDSTATE

Lesen des Status eines Gerätes über ADS

ADSWRTCTL

Schreiben/Setzen des Status eines Gerätes über ADS

ADSRDDEVINFO

Lesen der Geräteinformation über ADS

Erweiterte ADS-Funktionsbausteine

Name

Beschreibung

ADSREADIND

ADSREAD-Indication

ADSWRITEIND

ADSWRITE-Indication

ADSRDWRTIND

ADSRDWRT-Indication

ADSREADRES

ADSREAD-Response

ADSWRITERES

ADSWRITE-Response

ADSRDWRTRES

ADSRDWRT-Response

Funktionsbausteine für Dateizugriffe

Mit den nachfolgend aufgeführten Funktionsbausteinen können lokal auf dem PC Dateien aus der SPS heraus bearbeitet werden. Durch die AMS-Netzwerkadresse wird das TwinCAT‑Zielsystem identifiziert. Durch diesen Mechanismus ist es unter anderem möglich, Dateien auf anderen TwinCAT-Systemen des Verbundes anzulegen bzw. zu bearbeiten. Der Zugriff auf Dateien besteht aus drei aufeinanderfolgenden Phasen:

  1. Öffnen der Datei
  2. Lesender oder schreibender Zugriff auf die geöffnete Datei
  3. Schließen der Datei

Das Öffnen der Datei dient dazu, eine temporäre Verbindung zwischen der externen Datei, von der zunächst nur der Name bekannt ist, und dem laufenden Programm herzustellen. Das Schließen der Datei dient dazu, das Ende der Bearbeitung anzuzeigen und sie in einen definierten Ausgangszustand für die Bearbeitung durch andere Programme zu versetzen.

Name

Beschreibung

FB_EOF

Testen auf Dateiende

FB_FileOpen

Öffnen einer Datei

FB_FileClose

Schließen einer Datei

FB_FileGets

String aus einer Text-Datei lesen

FB_FilePuts

Nullterminierten-String in eine Text-Datei schreiben

FB_FileRead

Lesen aus einer Datei

FB_FileWrite

Schreiben in eine Datei

FB_FileSeek

Verstellen des Dateizeigers

FB_FileTell

Ermitteln der aktuellen Position des Dateizeigers

FB_FileDelete

Löschen einer Datei

FB_FileRename

Umbenennen einer Datei

FB_CreateDir

Erstellen eines neuen Verzeichnisses

FB_RemoveDir

Löschen eines Verzeichnisses

EventLogger-Funktionsbausteine

Der TwinCAT EventLogger hat die Aufgabe, alle auftretenden Meldungen (Events) im TwinCAT-System zu verwalten, weiterzuleiten und gegebenenfalls in die TwinCAT-Logdatei zu schreiben.

Name

Beschreibung

ADSLOGEVENT

Absenden und Quittieren von Meldungen zum TwinCAT EventLogger.

ADSCLEAREVENTS

Absenden und Quittieren von Meldungen zum TwinCAT EventLogger.

FB_SimpleAdsLogEvent

Absenden und Quittieren von Meldungen zum TwinCAT EventLogger.

Übersicht 1:

TwinCAT EventLogger vs. TwinCAT 3 EventLogger

Der TwinCAT EventLogger wurde durch den Nachfolger TwinCAT 3 EventLogger abgelöst. Der ältere TwinCAT EventLogger wird von TwinCAT 3 bis zur Version 3.1.4024 unterstützt. Neuere TwinCAT-Versionen (>= 3.1.4026.0) unterstützen nur den neueren TwinCAT 3 EventLogger. SPS-Funktionsbausteine hierzu befinden sich in der SPS Bibliothek Tc3_EventLogger.

IEC-Schritt- / SFC-Flags-Funktionsbausteine

Diese Funktionen/Funktionsbausteine werden benötigt, wenn in SFC-Programmen/Projekten die IEC-Schritte oder SFC-Flags benutzt werden.

Name

Beschreibung

AnalyzeExpression

Wird bei der Benutzung der SFC-Flags benötigt

AnalyzeEspressionTable

Wird bei der Benutzung der SFC-Flags benötigt

AnalyzeExpressionCombined

Wird bei der Benutzung der SFC-Flags benötigt

AppendErrorString

Wird bei der Benutzung der SFC-Flags benötigt, um Strings mit Fehlerbeschreibung zu formatieren.

SFCActionControl

Ermöglicht die Benutzung der IEC-Schritte

Watchdog-Funktionsbausteine

Name

Beschreibung

FB_PcWatchdog

Aktiviert oder deaktiviert den PC-Watchdog

Ist nur verfügbar auf IPCs mit den Mainboards IP-4GVI63, CB1050, CB2050, CB3050, CB1051, CB2051, CB3051

FB_PcWatchdog_BAPI

Aktiviert oder deaktiviert den PC-Watchdog

Ist nur verfügbar auf IPCs mit den Mainboards CBxx63 mit einer BIOS-Version >=0.44

Zeitfunktionsbausteine

Name

Beschreibung

GETCPUCOUNTER

Zyklusticker der CPU auslesen

GETCPUACCOUNT

Zyklusticker der SPS-Task auslesen

Generelle Funktionen

Name

Beschreibung

F_CheckMemoryArea

Liefert Informationen darüber, in welchem Speicherbereich sich die angefragte Variable mit angegebener Größer befindet

F_CmpLibVersion

Vergleicht eine existierende Bibliothek mit der Version, die benötigt wird

F_CreateIPv4Addr

Konvertiert einzelne IPv4-Adressbytes in einen String

F_ScanIPv4AddrIds

Konvertiert IPv4-Adressstring in einzelne Adressbytes

F_GetMappingPartner

Liefert die Objekt- ID der Partnerseite des Mappings

F_GetMappingStatus

Liefert den aktuellen Mapping- Status einer SPS- Variablen

F_GetStructMemberAlignment

Liest Informationen über die verwendete Speicherausrichtung (alignment)

F_SplitPathName

Zerlegt den Pfadnamen in vier Einzelkomponenten

SETBIT32

Setzen eines Bits in einem DWORD

CSETBIT32

Setzen/Zurücksetzen eines Bits in einem DWORD

GETBIT32

Lesen eines Bits aus einem DWORD

CLEARBIT32

Löschen eines Bits in einem DWORD

GETCURTASTINDEXEX

Ermitteln des Taskindex

LPTSIGNAL

Ausgabe eines Signals auf einem Pin des parallelen Port

TestAndSet

Flag setzen und prüfen, ohne dass dies unterbrochen werden kann

ADS-Funktionen

Funktionen, die mithilfe der ADS-Schnittstelle Teilfunktionalitäten des Windows-NT-Betriebssystems (wie z. B. die Ausgabe von Message-Boxen) durch Aufrufmöglichkeiten in der SPS zugänglich machen.

Name

Beschreibung

ADSLOGDINT

Ausgabe einer DINT Variablen ins Logbuch und/oder Messagebox

ADSLOGLREAL

Ausgabe einer (L)REAL Variablen ins Logbuch und/oder Messagebox

ADSLOGSTR

Ausgabe einer STRING Variablen ins Logbuch und/oder Messagebox

F_CreateAmsNetId

Generiert einen formatierten AmsNetId-String

F_ScanAmsNetIds

Konvertiert einen AmsNetId-String in einzelnen Adressbytes

Charakter-Funktionen

Name

Beschreibung

F_ToCHR

Konvertiert ASCII-Code in ein Charakterzeichen

F_ToASC

Konvertiert Charakterzeichen in den ASCII-Code

I/O-Portzugriff

Name

Beschreibung

F_IOPortRead

Liest I/O Port

F_IOPortWrite

Beschreibt I/O Port

Memory-Funktionen

Funktionen für den direkten Zugriff auf Speicherbereiche des SPS-Laufzeitsystems.

Hinweis

Systemabsturz oder Zugriff auf unerlaubte Speicherbereiche

Da mit den Funktionen direkt auf den physikalischen Speicher zugegriffen wird, ist bei deren Anwendung besondere Vorsicht geboten. Falsche Parameterwerte können zu einem Systemabsturz oder einem Zugriff auf unerlaubte Speicherbereiche führen.

Name

Beschreibung

MEMCMP

Werte der Variablen in zwei Speicherbereichen vergleichen

MEMCPY

Variablenwerte von einem Speicherbereich in einen anderen kopieren

MEMMOVE

Variablen von überlappenden Speicherbereichen kopieren

MEMSET

Variablen in einem Speicherbereich auf einen bestimmten Wert setzen

Zeit-Funktionen

Name

Beschreibung

F_GetSystemTime

Betriebssystem-Zeitstempel auslesen

F_GetTaskTime

(Soll-)Startzeit der Task auslesen