Library Manager
Function: The Library Manager is used to integrate and manage libraries in a project. It provides a good overview of the PLC libraries used in the project.
Call: Double-click on the References object in the PLC project tree
Compilation errors relating to the Library Manager are output in a dedicated category in the message window.
Upper part of the Library Manager
The upper part of the dialog shows the libraries currently integrated in the project. | |
Name | Title, version and company name, as defined in the project properties during library creation. |
Namespace | The default setting for the namespace of a library is the library title. Alternatively, a different namespace can be defined explicitly, either generally for the library in the project properties during library generation, or in the Properties window of the library reference for local use of the library in a project. The namespace of the library must be used as prefix of the identifier, in order to enable unambiguous access to a module that is used several times in a project. |
Effective version | Effective library version, which is referenced. If the library is used as “Always newest”/“*”, the actual library version is displayed here. Further information on the resolution of placeholders can be found in section Placeholder. |
- Libraries that were automatically inserted into the project by a plug-in (e.g. visualization or UML libraries) are displayed in gray font. Manually added libraries (Add library...) are shown in black font.
- A symbol before the library name indicates the library type:
- : TwinCAT 3 PLC library (contains version information)
- : The referenced file was not found or is not a valid library file (see corresponding message in the Error List view). In this case see: Command Try reload library
- If a library has dependencies from other libraries, these are – if they are found – also integrated automatically and shown in a subtree of the entry, preceded by a symbol . Such a subtree can be opened or closed via a plus or minus sign. As an example, the diagram below shows the library "Tc2_Standard" as a direct library and as a sub-library of the library "Tc2_System".
Buttons and commands
The following buttons and commands are available in the upper section of the Library Manager.
Add library | Integrating a library or a placeholder in the project. See also Command Add library. |
Delete library | The command removes the selected library from the Library Manager. |
Details | Opens the Details dialog for the selected library. |
Placeholder | Opens the Placeholder dialog. |
Library Repository | Opens the Library Repository dialog. |
Try reload library | This command is available in the editor window of the Library Manager, if a library is selected which failed to load when the project was opened. See also Command Try reload library |
Lower part of the Library Manager
The lower left part of the editor shows the modules of the library that is selected in the upper part of the editor. The usual sorting and search functions are available via a menu symbol shown to the right of the library name. The following tabs can be found in the lower right section. | |
Inputs/Outputs | The components of the library object currently selected on the left are shown in a table, with (variable) name, data type, basic function block if applicable, address, basic function block if applicable, initial value and comment, as defined in the library. The symbol in front of each variable indicates whether it is an input, output or input/output variable.
The symbol for method return values is the same as the symbol for output variables. |
Library parameters | This tab is only available if the library object currently selected on the left is a parameter list. The variables of the parameter list are displayed in a table with name, data type, (editable) value and comment, as defined in the library. In the (editable) Value column, you can replace the value of the global constant with a project-specific value. For more information, see Object Parameter List. |
Graphical | Graphical representation of the function block |
Documentation | The components of the library object currently selected on the left are shown in a table with (variable) name, data type, basic function block if applicable, address, initial value and a comment, which may have been added to the declaration when the library was created. Adding this kind of comments is therefore a convenient way to automatically make function block documentation available to the user. Further information can be found in section Library documentation. |