Bibliothekserstellung in CODESYS: Tipps für die effektive ...

Bibliothekserstellung in CODESYS: 

Tipps für die effektive Vorgehensweise 

CODESYS Users‘ Conference 2013, Ralph Holz 

CODESYS ® a 3S-Smart Software Solutions GmbH trademark 

Bibliothekserstellung 

Agenda 

1 

2 

CODESYS Bibliotheken kurz und bündig 

• Grundlagen 

• Wichtige Eigenschaften 

Wie erzeugt man Bibliotheken? 

3 

Zehn Regeln zur Bibliothekserstellung 

© 3S-Smart Software Solutions GmbH



Grundlagen 

• Eine Bibliothek ist eine Sammlung wiederverwertbarer Elemente 

wie : 

• POUs, z. B. Funktionen der Funktionsblöcke 

• DUTs wie Strukturen, Unions oder Enumerationen 

• Globale Variablen, Konstanten und Parameterlisten 

• Methoden und Eigenschaften von Schnittstellen 

• Textlisten, Bildersammlungen, Visualisierungen 

• Externe Dateien (z.B. Dokumentation) 

• Kurvenscheibentabellen 

© 3S-Smart Software Solutions GmbH 

Grundlagen 



• Eine Bibliothek verwendet den Bibliotheksmanager, um andere zu 

referenzieren und somit ihren Inhalt wiederzuverwenden. 




Wichtige Eigenschaften 

• Der Dateiname 

• Allgemeine Bibliotheken: .library 

• Interface-Bibliotheken: _Itfs.library 

• Container-Bibliotheken: _Cntr.library 






• Erforderliche Metadaten wie Firma, Titel und Version 

System 

ProgramData 

CoDeSys 

Managed Libraries 

System 

CmpIecVarAccess 

3.5.1.0 

CmpIecVarAccess.library 






• Erforderliche Metadaten wie Firma, Titel und Version 

• Optionale, aber empfohlene Eigenschaften wie: 

• Bibliothekskategorien 

• Namensraum der 

Bibliothek 

• Name des Autors 

• Beschreibung des 

Bibliotheksinhalts 

Diese Option benötigt viel 

Speicher und WSTRING 

Unterstützung. 

Bitte nicht verwenden! 





• Einige zusätzliche Eigenschaften, die die Verwendung der 

Bibliothek definieren 

• LanguageModelAttribute (Text) := 'qualified-access-only' 

• IsInterfaceLibrary (Bool) := True | False 

• IsContainerLibrary (Bool) := True | False 

• Placeholder (Text) 




• Templates 




• Bibliothekstypen 

• Allgemeine Bibliothek 

Standard-Typ einer Bibliothek. Keine spezielle Vorgehensweise 

notwendig. 

• Container-Bibliothek 

Ermöglicht die einfache Verwendung von zusammengehörenden 

Bibliotheksgruppen 

Veröffentlicht alle ihre auf oberster Ebene referenzierten Bibliotheken 

Enthält selbst keine Implementierung 

• Interface-Bibliothek 

Definiert die Interfaces (Schnittstellen) zwischen 

Softwarekomponenten 

Kann nur Elemente enthalten, die keinen Code erzeugen (Konstanten, 

Strukturen, Interfaces, …) 

Kann erweitert werden – muss aber kompatibel bleiben 




• Wie referenziert man andere Bibliotheken 

• Allgemeine Bibliothek 

Werden immer mit Platzhalter referenziert 

• Container-Bibliothek 

Werden direkt mit einer festen Version referenziert 

• Interface-Bibliothek 

Werden immer als neueste Bibliothek mit * referenziert 




• Bibliotheksstruktur 




• Was ist ein Namensraum? 

• Eine weltweit eindeutige Folge lateinischer Zeichen 

• So kurz wie möglich! 

• z.B. „LAT“ für eine Bibliothek, die „Lists and Trees“ behandelt 

• Registrierung der Platzhalter erfolgt unter: libregistry@codesys.com 

• Jedes Setup von CODESYS enthält die aktuelle Version von „Prefix.pdf“. 

In diesem Dokument stehen die aktuell registrierten Namensräume. 




• Was ist ein Namensraum? 

• Identifiziert eine Bibliothek auf weltweit eindeutige Weise 

• Jede Bibliothek sollte mit folgender Eigenschaft markiert sein: 

LanguageModelAttribute (Text) := 'qualified-access-only‘ 

Mit diesem Eintrag kann auf die Symbole der Bibliothek nur noch 

qualifiziert zugegriffen werden. 

Somit ist es auch möglich, ohne Probleme in verschiedenen 

Bibliotheken gleiche Symbole zu verwenden. 

– CL2.Send(); SIO.Send(); 





• Applikation 

Für die direkte Verwendung durch den Anwender. Einfache 

Verwendung, z. B. zur Verwaltung der verwendeten Ressourcen. Ihre 

Schnittstellen sind in CFC gut verwendbar. 

• Intern 

Werden in einem CODESYS-Projekt durch CODESYS-Plugins 

eingefügt. Nicht von Hand einfügen oder löschen. 

• System 

Direkte Abhängigkeit zum CODESYS Laufzeitsystem. Nicht direkt in 

einem CODESYS Projekt verwenden, sondern in Bibliotheken, um 

dem Anwender eine schöne Schnittstelle zu bieten. 





• Jedes Setup von CODESYS enthält die aktuelle Version der Datei 

„LibraryCategoryBase.libcat.xml “ 

• Mit Hilfe dieser Datei ist es möglich, eigene Unterkategorien zu 

erzeugen. 

 

2225F435-D4BE-40a7-9B1C-C753ED183FF0 

1.0.0.0 

 

 

E98088BB-59F5-4096-8784-4443932920DF 

 

Composer 

 




• Platzhalter 

• Der Standard, um andere Bibliotheken zu referenzieren: „Platzhalter- 

Referenzen“ 

• Zur Gewährleistung konsistenter Beziehungen zwischen 

unterschiedlichen Bibliotheken 

• Erzeugen eine indirekte Beziehung zwischen Bibliotheken. 

• Um die Referenz einer „Unter“-Bibliothek zu verändern, muss nur die 

Platzhalter-Definition verändert werden. 


Platzhalter 

• CODESYS kennt drei Orte zur Platzhalterdefinition. 

• Die Gerätebeschreibung 



 

… 

 

3S CANopenDevice, 3.5.1.0 

(3S - Smart Software Solutions GmbH) 

 

… 

 




Platzhalter 

• CODESYS kennt drei Orte zur Platzhalterdefinition. 

• Gerätebeschreibung 

• Bibliotheksprofil 

• CODESYS Projekt 

 



Namenskonventionen 

• Die Bibliotheks-Guidelines schlagen eine Art der ungarischen 

Notation vor. 

• Bei dieser Notation bezeichnet der 

Name anhand eines Präfix den 

Variablen-Typ. 

• Einige Beispiele: 

• Die Hilfe enthält hierzu das 

Kapitel: 


Einfache intelligente Interfaces 

• Zwei Arten von Interfaces 

• Externe Interfaces – in der endgültigen Applikation 

• Interne Interfaces – alle anderen 



• Vorschlag für externe Interfaces: 

• Verwenden Sie reduzierte, vereinfachte Parameter-Typen, damit sich 

der Anwender um seine Applikation kümmern kann und sich nicht mit 

gefährlichen und schwierigen Datentypen wie Pointern und Adressen 

(ADR) auseinander setzen muss. 

• Interfaces sollten für die Verwendung in CFC optimiert sein. 

Optimalerweise ist der 1. Eingang und der 1. Ausgang ein boolescher, 

somit kann ein Baustein auch problemlos in Kontaktplan verwendet 

werden 

• Verwenden Sie das allgemeine Verhaltensmodell aus unseren 

Bibliothekstemplates. 




Benutzerfreundliches Fehlerhandling 

• Eine Bibliothek sollte nur Fehlercodes zurückgeben, die in der 

Bibliothek dokumentiert sind (Konstanten oder Enumerationen). 

• Es ist bequem, aber absolut nicht empfohlen, Fehlercodes aus 

untergelagerten Bibliotheken unbehandelt weiterzugeben. 

• Fremde Fehlercodes sollten auf eigene Fehler „gemapped“ werden 


Veröffentlichen bzw. Weitergabe von Bibliotheken 



• Der Quellcode einer Bibliothek sollte nie ungeschützt 

weitergegeben werden. 

• Bibliotheken sollten nur als *.compiled.library veröffentlicht werden. 

• Zusätzlich sollte in Bibliotheken ein Benutzermanagement 

eingeführt werden. 

• Bitte die Sichtbarkeit nicht einschränken für die Objekte 

• Projektinformation 

• Bibliotheksverwalter 



Zehn Regeln zur Bibliothekserstellung 

• Einen “schönen” Dateinamen wählen (erforderlich). 

• Einen eindeutigen Namensraum registrieren (erforderlich). 

• Die Projektinformation ausfüllen (erforderlich). 

• Andere Bibliotheken korrekt referenzieren (erforderlich). 

• Einfache intelligente Interfaces entwerfen (erforderlich). 

• Ein benutzerfreundliches Fehlerhandling implementieren 

(erforderlich). 

• Auf richtige Art veröffentlichen (erforderlich). 

• Templates zur Erstellung nutzen(optional). 

• Eine bekannte Projektstruktur verwenden (optional). 

• Eine klare Namenskonvention verwenden (optional).

Bibliothekserstellung in CODESYS: Tipps für die effektive ...

Sie wollen auch ein ePaper? Erhöhen Sie die Reichweite Ihrer Titel.

Template löschen?

Als Template speichern?