Object ‘Library Manager’

Use the library manager in order to add libraries to your project and to adapt their properties.

You can add the library manager as an object in the POU view (global) or application-specific in the device tree. You can insert only one library manager at these positions.

The library manager is opened using the Edit Object command or by double-clicking on the object.

The library manager editor is divided into three windows.

  • Top window: list of the integrated libraries
  • Bottom-left window: modules of the selected library in tree structure
  • Bottom-right window: details for the selected module

See also

List of the integrated libraries

The top part of the library manager shows you the libraries currently integrated in the project. If a library depends on other libraries (referenced libraries), these referenced libraries are automatically integrated.

Libraries that were automatically inserted into the project by a plug-in are displayed by the library manager in gray lettering. Libraries inserted manually using the command Add library… are displayed in black lettering.

Name

Title, version and optionally the company name. These details correspond to the settings of the Summary tab of the Project Information dialog box.

Library symbols

  • ad23efddceafc3f3c0a8640e012263e7_72f26fd93648d7cdc0a8640e01155988 :CODESYSV3 library (contains version information).

  • ad23efddceafc3f3c0a8640e012263e7_0bfdb48d364a126ec0a8640e01899916 : referenced library

  • ad23efddceafc3f3c0a8640e012263e7_b3bba813364af16ac0a8640e00191ab5 : CODESYS cannot find the referenced library file or the file is not a valid library file. Note here the messages in the Message window in the Library Manager category.

    The name of the missing library is underlined with a blue wavy line. If the node of the higher-level parent library is closed, the name of the parent library is underlined with a gray wavy line.

  • ad23efddceafc3f3c0a8640e012263e7_35a1a97a364b89cac0a8640e016a2886 : licensed library for which no valid license is currently available.

Namespace You must use the namespace of the library as the prefix of the identifier in order to allow unambiguous access to a module that exists several times in the project. The namespace is also necessary if the use of this prefix is forced by the library property LanguageModelAttribute "qualified-access-only" (unambiguous access to library modules or variables). You can modify the standard namespace of an integrated library for local use (within the project) in the Properties dialog box.
Effective version Version of the library that is currently used in the project in accordance with the definition in the library properties.

See also

Commands in the library manager
Add Library… Opens the dialog box for selecting a library. All libraries installed in the library repository are offered.
Delete Library Removes the presently selected library from the project.
Properties… Opens the dialog for the display and editing of the properties of the presently selected library.
Try to reload Library If you select a library marked as not found, you can attempt to load it into the project again using this command.
Download missing libraries CODESYS browses for the missing libraries in the download servers specified in the project options. After that you can download and install the library.
Details… Opens a dialog box with details for the presently selected library (general information, contents, properties, license information).
Placeholders… Opens the Placeholders dialog box for the diversion of placeholders and library groups to a different version.
Library Repository… Opens the Library Repository dialog box for installing and uninstalling libraries and for defining library locations.

Note

Additionally, the context menu of a library currently selected in the library manager provides the command Export library.

See also

Contents of the library

In the bottom left part of the editor the modules of the currently selected library are also represented in a tree structure. The usual sort and search functions are available to you in a menu bar.

Detail of the modules

Inputs/Outputs: CODESYS displays the components of the library module selected on the left in a table with (variable) name, data type, address, initial value and comment, as defined in the library.

Graphical: graphical display of the module.

Documentation: view of the documentation contained in the library. As a library developer you must follow the rules for documentation inclusion in ‘Guidelines for library development’.

Parameter list: this tab is available only with libraries that contain a ‘parameter list’. You can change the values of these parameters in the column Value (editable).