Bibliotheksverwalter

Funktion: Der Bibliotheksverwalter dient dem Einbinden und Verwalten von Bibliotheken in einem Projekt und bietet einen guten Überblick über die im Projekt verwendeten SPS-Bibliotheken.

Aufruf: Doppelklick auf das Objekt References im SPS-Projektbaum

Der Bibliotheksverwalter besteht aus 3 Fensterteilen:

Oberer Fensterbereich: Liste der eingebundenen Bibliotheken
Unterer linker Fensterbereich: Baumstruktur mit allen Objekten der selektierten Bibliothek
Unterer rechter Fensterbereich: Dokumentation zu dem im Baum selektierten Bibliotheksobjekten

Übersetzungsfehler bezüglich des Bibliotheksverwalters werden in einer eigenen Kategorie im Meldungsfenster ausgegeben.

Oberer Teil des Bibliotheksverwalters

Liste der eingebundenen Bibliotheken

Der Bibliotheksverwalter listet alle Bibliotheken auf, die im Projekt eingebunden wurden. Er informiert jeweils über ihren Typ, ihre Eigenschaften und ihren Inhalt. Sie können die Liste der eingebundenen Bibliotheken erweitern oder reduzieren, sowie bei nicht abhängigen Bibliotheken die Bibliothekseigenschaften bearbeiten. Wenn eine Bibliothek von anderen Bibliotheken abhängt, werden diese referenzierten Bibliotheken automatisch eingebunden.

Name

Darstellung der eingebundenen Bibliothek gemäß folgender Syntax:

<Platzhaltername> = <Bibliotheksname>, <Version> (<Firma>):

<Platzhaltername>: Wenn es sich bei der Bibliothek um eine Platzhalterbibliothek handelt, steht der Platzhaltername vor einem =.

<Platzhaltername> = (nicht aufgelöst): Die Platzhalterbibliothek ist ohne Auflösung.

<Bibliotheksname>: Name der Bibliothek, unter dem diese im Bibliotheksrepository verwaltet wird

<Version>: Version, die beim erstmaligen Einbinden referenziert wurde

(<Firma>): Anbieter

Bibliotheksname/Titel, Version und der Firmenname, werden während der Bibliothekserstellung in den Projekteigenschaften definiert.

Namensraum

Namensraum für einen eindeutigen Zugriff auf den Inhalt der Bibliothek

Er wird dazu als Präfix vor einem Bausteinbezeichner verwendet:

Die Standardeinstellung für den Namensraum einer Bibliothek entspricht dem Bibliothekstitel. Alternativ kann auch explizit ein davon abweichender Namensraum definiert werden: entweder allgemein für die Bibliothek bei der Bibliothekserstellung in den Projekteigenschaften oder für den lokalen Gebrauch der Bibliothek in einem Projekt im Eigenschaftenfenster der Bibliotheksreferenz.

Wenn ein Bezeichner mehrfach im Projekt vorhanden ist, muss der Namensraum der Bibliothek als Präfix des Bezeichners verwendet werden, damit ein eindeutiger Zugriff möglich ist.

Hinweis: Wenn für die Bibliothek „qualified_only“ Zugriff aktiviert ist (siehe Kategorie Common), wird ein qualifizierter (eindeutiger) Zugriff erzwungen. In diesem Fall müssen sie im SPS-Projekt immer über den Namensraum auf die Bibliotheksbausteine zugreifen.

Effektive Version

Version der Bibliothek nach der Auflösung

Diese effektive Version der Bibliothek, auf die referenziert wird, wird im SPS-Projekt verwendet.

Beispiel: 3.4.6.0

Wenn die Bibliothek als „immer neueste“/„*“ verwendet wird, wird an dieser Stelle die tatsächlich verwendete Bibliotheksversion angezeigt. Weitere Informationen zu der Auflösung von Platzhaltern finden Sie im Abschnitt Platzhalter.

Bibliotheken, die automatisch durch ein Plug-In im Projekt eingefügt wurden (z. B. Visualisierungs- oder UML-Bibliotheken), sind in grauer Schrift dargestellt. Manuell eingefügte Bibliotheken (Bibliothek hinzufügen…) werden in schwarzer Schrift dargestellt.
Ein Symbol vor dem Bibliotheksnamen zeigt den Typ der Bibliothek an:

: TwinCAT-3-PLC-Bibliothek (enthält Versionsinformationen)
: Die referenzierte Datei konnte nicht gefunden werden oder ist keine gültige Bibliotheksdatei (siehe entsprechende Meldung in der Ansicht Fehlerliste). Siehe in diesem Fall: Befehl Bibliothek erneut laden

Wenn eine Bibliothek Abhängigkeiten von anderen Bibliotheken hat, werden diese – wenn sie gefunden werden – automatisch ebenfalls eingebunden und mit vorangestelltem Symbol in einem Unterbaum des Eintrags dargestellt. Ein solcher Unterbaum kann über ein Plus- oder Minuszeichen geöffnet bzw. geschlossen werden. Als Beispiel sehen Sie unten in der Abbildung die Bibliothek „Tc2_Standard“ als direkte Bibliothek und als Unterbibliothek der Bibliothek „Tc2_System“.

Schaltflächen und Befehle

Die folgenden Schaltflächen und Befehle sind im oberen Bereich des Bibliotheksverwalters verfügbar.

Bibliothek hinzufügen	Öffnet einen Dialog zum Auswählen einer Bibliothek In dem Dialog werden alle im Bibliotheksrepository installierten Bibliotheken angeboten und können als Platzhalterbibliotheken eingefügt werden. Sehen Sie hierzu auch Befehl Bibliothek hinzufügen.
Bibliothek löschen	Entfernt die selektierte Bibliothek aus dem Projekt
Details	Öffnet für die ausgewählte Bibliothek den Dialog Details In dem Dialog werden Details zur selektierten Bibliothek angezeigt (allgemeine Informationen, Inhalt).
Platzhalter	Öffnet den Dialog Platzhalter In dem Dialog wird die aktuelle Auflösung des Platzhalters dargestellt und Sie können sie bearbeiten.
Bibliotheksparameter	Verfügbar ab TC3.1 Build 4026 Öffnet den Dialog Bibliotheksparameter In dem Dialog werden die Parameter der eingebundenen Bibliotheken angezeigt und Sie können die Parameter anpassen.
Bibliotheksrepository	Öffnet den Dialog Bibliotheksrepository In dem Dialog können Sie Bibliotheken installieren und Deinstallieren sowie Speicherorte für die Bibliotheken definieren.
Zusammenfassung	Öffnet den Dialog Bibliothekszusammenfassung In dem Dialog werden die im Projekt referenzierten Bibliotheken angezeigt und diejenigen Bibliotheken, die diese Bibliotheken referenzieren.
Versuchen, Bibliothek neu zu laden	Dieser Befehl ist im Editorfenster des Bibliotheksverwalters verfügbar, wenn eine Bibliothek ausgewählt ist, deren Laden beim Öffnen des Projekts fehlgeschlagen ist. Sehen Sie hierzu auch Befehl Bibliothek erneut laden

Unterer Teil des Bibliotheksverwalters

Baumstruktur aller Bausteine einer selektierten Bibliothek

Im unteren linken Teil des Editors werden die Objekte der Bibliothek dargestellt, die im oberen Teil des Editors ausgewählt ist. Über ein Menüsymbol, das rechts neben dem Bibliotheksnamen dargestellt ist, stehen übliche Sortier- und Suchfunktionen zur Verfügung.

Dokumentation des ausgewählten Bibliotheksobjekts

Im unteren rechten Teil finden sich die folgenden Registerkarten:

Eingänge/Ausgänge	Schnittstelle (Eingänge/Ausgänge) des Bibliotheksobjekts Die Komponenten des gerade links ausgewählten Bibliotheksobjekts werden in einer Tabelle dargestellt, mit (Variablen-)Name, Datentyp, ggf. Basisbaustein, Adresse, Initialwert und Kommentar, wie in der Bibliothek definiert. Das Symbol, das den jeweiligen Variablen vorangestellt ist, zeigt an, ob es sich um eine Eingangs-, Ausgangs- oder Ein-/Ausgangsvariable handelt. Eingangsvariable: Symbol mit Pfeil, der nach unten rechts zeigt Ausgangsvariable: Symbol mit Pfeil, der nach oben links zeigt Ein-/Ausgangsvariable: Symbol mit Pfeil, der sowohl nach unten rechts als auch nach oben links zeigt Das Symbol für Methodenrückgabewerte entspricht dem Symbol für Ausgangsvariablen.
Graphisch	Graphische Darstellung des Bibliotheksobjekts
Dokumentation	Dokumentation des Bibliotheksobjekts Die Komponenten des gerade links ausgewählten Bibliotheksobjekts werden in einer Tabelle dargestellt, mit (Variablen-)Name, Datentyp, ggf. Basisbaustein, Adresse, Initialwert und dem Kommentar, der ggf. bei der Bibliothekserstellung der Deklaration beigefügt wurde. Somit ist das Einfügen solcher Kommentare ein einfacher Weg, dem Anwender automatisch Dokumentation eines Bausteins zur Verfügung zu stellen. Detaillierte Informationen hierzu finden Sie im Abschnitt Bibliotheksdokumentation.
Bibliotheksparameter	Diese Registerkarte ist nur verfügbar, wenn es sich bei dem gerade links ausgewählten Bibliotheksobjekt um eine Parameterliste handelt. Ab TC3.1 Build 4026: Der Befehl Konfigurationsdialog öffnen öffnet den Dialog Bibliotheksparameter, in dem Sie die Werte der globalen Konstanten durch einen projektspezifischen Wert ersetzen können. Bis TC3.1 Build 4024: Die Variablen der Parameterliste werden in einer Tabelle dargestellt, mit Name, Datentyp, Wert (editierbar) und Kommentar, wie in der Bibliothek definiert. Über die Spalte Wert (editierbar) können Sie den Wert der globalen Konstanten durch einen projektspezifischen Wert ersetzen. Weitere Informationen finden Sie im Abschnitt Objekt Parameterliste.

Sehen Sie dazu auch