6 - The Ressources
window you can monitor the current values of the parameters. If currently no online connection is
established, the parameter lists just can be created locally and saved with the project.
6.11.3 Parameter List Types and Attributes
The Parameter Manager can handle the following parameter list types:
: The entries in parameter lists of this type represent process variables of the project.
: The entries in parameter lists of this type represent parameters whose values are not
attached by the process.
: The entries in parameter lists of this type represent data which are not
attached by the process and which are determined by the target system. System Parameter lists
cannot be deleted or renamed.
: A template does not contain parameter entries which can be directly accessed for the
purpose of data exchange. In fact the entries provide a "basic attribute configuration" for the
components of a function block or a structure. Thus a template can be used in parameters lists of type
: The entries in parameter lists of this type represent parameter entries for variables which
are of type of a function block or structure, that means which are instances or structure variables. For
an easy entering of the parameters a template is used, which has also been created in the Parameter
: This list type is only available, if it is supported by the target system. The entries
represent process variables which are intended to be used in the PDO mapping of a CAN-Device. So
mapping lists basically are variables list, but they are working on a separate index/subindex range.
This range must be defined in the target settings, category Network functionality! In this case a CAN-
Device, which is configured in the PLC Configuration,
will use the entries of list type 'Mapping',
while otherwise all entries of variables or instances lists will be available in the PDO mapping dialog.
Each list type will be displayed in the Parameter Manager Editor according to the attributes defined by
a description file in XML format. If such a file is missing, default settings will be used.
Instances and Templates
An Instance" parameter list ...
... handles parameter entries, which represent a
variable or an
Instance lists for a function block or a structure are each based on a
which is also to be
defined in the Parameter Manager for the respective function block resp. structure. Instance lists for
arrays cannot use a template made in the Parameter Manager, but directly refer to the array which is
used in the project.
A "Template" parameter list ...
... does not contain parameters which are directly accessed for the purpose of data exchange. In fact
it defines index and subindex offsets and certain attributes for parameter entries which represent the
components of a function block or a structure. The template then can be used in a 'Instance'
parameter list (see above), thus providing an easy way to create parameter entries for project
variables which are instances of a function block or a structure.
Creating a Template parameter list:
In the edit field next to
enter the name of the function block or structure for which a
parameter template should be created. Using the input assistant you can browse the available POUs
of the project. Press
to enter the components of the chosen POU in the parameter list editor.
Now edit the attribute fields and close the list to make it available for use in an 'Instance' list.
Insert missing entries
in the context menu or in the 'Extras' menu will cause an
update of the entries according to the current version of the Base POU. This might be necessary after
having deleted some lines or after having changed the Base-POU.
is activated, all read-/write accesses on other POUs defined for any
list entries, will be executed by the target system synchronously with the call of the respective entry.
For creating Instance parameter lists for
it is not necessary to create an template in the
Parameter Manager. The template ARRAY will be available implicitly.
Creating an Instance parameter list:
from the selection list below the table. This list offers all templates currently available
for function blocks or structures in the Parameter Manager plus the option ARRAY, which you select,
if you want to refer directly to an array used in your project. Press
to insert the predefined
components to the parameter list table.
In the edit field
enter exactly that project variable (must be of type of the function block
or the structure or the array which is described by the chosen template), for the components of which
you want to create parameter entries.
for the instance. The indices and subindices of the particular
components then will be calculated automatically by adding the index resp. subindex values which are
defined in the template for each component (in case of arrays the base will be 0). They will be filled
automatically to the respective attribute fields. Example: If you enter a base index "3" for a component,
for which an index offset "3000" is defined in the template, the component will be set to index 3003.
please see above: Creating a Template parameter list.
Insert missing entries
in the context menu or in the 'Extras' menu will cause an
update of the entries according to the current version of the used template. That might be useful after
having deleted entries or after the template has been modified.
Create a function block fubo with input- or output variables: a,b,c. In PLC_PRG define the following FB-
instances: inst1_fubo:fubo; inst2_fubo:fubo. Compile the project.
Now open the Parameter Manager in order to create parameter lists for the variables inst1_fubo.a, inst1_fubo.b,
inst1_fubo.c and inst2_fubo.a, inst2_fubo.b, inst2_fubo. First insert a parameter list which is of type 'Template'
and name it "fubo_template". Define the Base-POU: "fubo". Press Apply and define some attributes for the
components a,b,c: te. Inter alia enter the Index offsets: for a: 16#1, for b: 16#2, for c: 16#3. Also the SubIndex
offsets, e.g. a: 16#2, b: 16#3, c: 16#4.
Now insert a new parameter list which is of type 'Instance'. Choose template "fubo_template". Insert the Base
variable "inst1_fubo". Define a Base index of e.g. 16#2300 and a Base subindex of 30 (you must regard the
ranges defined in the target settings in tab Networkfunctionality !). Now press Apply to get displayed the indices
which are calculated for the components a, b, c by the addition of base offsets and template defined offsets:
Indices: 16#2301, 16#2302, 16#2303; SubIndices:16#23, 16#33, 16#43.
6 - The Ressources
Basing on this automatically created entries now you can continue to edit the parameter list.
6.11.4 Managing parameter lists
To insert a new parameter list in the Parameter Manage use the command 'Insert list...', resp. 'Insert
new list' in the 'Insert' or context menu. The commands are available when the focus is in the empty
navigation window resp. on an already existing entry in the navigation tree. The dialog 'Insert list' will
Insert a Name for the new parameter list (must be unique within the list type) and choose one of the
following list types:
Entries for process variables
Entries for data, whose values remain unattached by the process
Template of attribute setting for the components of a function block or a
Entries for variables of type of a function block or a structure, basing on
the corresponding template (see above)
Entries for process variables, intended for being used in the PDO
mapping of a CAN Device. This type is only available, if supported by the
target system !
Entries for parameters whose values are not attached by the process and
which are defined by the target system
Dialog 'Insert list'
After confirming the settings and closing the dialog with
the new parameter list will appear as an
entry in the navigation window, the list type indicated by the icon. In the table editor the appropriate
attributes will be displayed as column titles. Selection and order of the columns are defined by a target
specific description file, otherwise the default settings are used. Now you can edit the table, by
entering a line for each desired parameter (see Chapter 6.11.4, Editing a parameter list).
The parameter list, which is currently marked in the navigation window, can be renamed by using the
command 'Rename list' which is available in the 'Extras' menu or in the context menu. An edit field will
open, which you also get when doing a double-click with the mouse on the list name.
Cut / Copy /Paste list
Shortcut: <Ctrl> + <X>, <Ctrl> + <C>, <Ctrl> + <V>,
The command 'Cut' (Edit menu) resp. 'Cut list' (context menu) moves the currently marked list from
the navigation window to a temporary buffer, so that you can reinsert it by the 'Paste' command at any
other position in the navigation tree. Before re-inserting mark that list, above which you want to insert.
The command 'Copy' resp. 'Copy list' also uses the temporary buffer, but the original navigation tree
entry will be kept, and a copy will be added by 'Paste'.
The list currently selected in the navigation window will be removed by the command 'Delete' ('Edit'
Menu) resp. 'Delete list' ('Extras' or context menu).
In online mode this command will delete the corresponding list in the runtime system.
6.11.5 Editing parameter lists
Which columns (attributes) are displayed:
The currently marked parameter list (navigation window) will be displayed in the table window as
defined by a target specifc description file resp. according to the default settings.
This means that the attributes' values of each particular parameter will be displayed in a separate
according to the list-type-specific order and selection of columns.
6 - The Ressources
columns by deactivating/activating them in the context menu when the
cursor is pointing to any field of the list column title bar.
For modifying the column move the dividers between the column title fields or use one of the
commands available in the context menu when the cursor is placed on a column title field: Command
Standard column width
will set a standard width for all columns which makes them all visible in the
will change the width of the currently focussed column so that each entry
will be fully displayed.
Commands for editing a parameter list entry
The following commands for editing a parameter list are available in the
resp. in the
' or '
Inserting /Deleting lines:
A new entry (line) will be inserted before that one where the
cursor is currently placed.
New line after
A new entry (line) will be inserted after that one where the
cursor is currently placed. .
The line, where the cursor is currently placed, will be deleted.
Cut, copy, paste line
These commands can be used to move (cut/paste) or to copy
(copy/paste) the selected line.
Editing attribute values:
If a new line for a parameter entry is inserted, the attribute fields will be automatically filled with target
specific default values. See chapter 6.11.3, 'Parameter List Types and Attributes' for the possible
attributes. To enter or edit an attribute value, click on the corresponding field. An edit field will be
opened, if the attribute is editable. The input assistant (
) will be available in fields where a
component of the CoDeSys project should be entered.
to close the entry.
Use the arrow keys to jump to another field.
to delete the entry of the currently edited field.
In order to toggle the input format between 'decimal' and hexadecimal' use the command '
' in the '
in order to set the focus to the navigation window (and back).
Below the table in the editor window there can be activated the following options (availability
depending on list type):
Download with program
: At a program download the list will be downloaded automatically to the
: All read-/write accesses on other POUs defined for any list.
entries, will be executed by the target system synchronously with the call of the
Sorting parameter lists
The sequence of entries within a parameter list can be sorted concerning an attribute (column) in
ascending or descending order of the attribute values. This works in offline and in online mode.
Perform a mouse-click on the field which contains the column title of the desired attribute. Thus the
table lines will be re-sorted and in the column title field of the attribute am arrow symbol will be
displayed, showing the current sorting (pointing upwards = ascending sort sequence, pointing
downwards = descending sort sequence).
6.11.6 Parameter Manager in Online Mode
List transfer between Editor and Controlling Unit
If supported by the target, in online mode the parameter lists, which have been created in the editor,
ed to resp.
ed from the runtime system. Further on you can
to the runtime system. The maximum size of lists of type 'Variable' and
'Parameters' also is defined by the target system.
At login automatically a download of all parameter lists will be done for which the
option 'Load with project' is activated !
The current value of each parameter is
in an additional column which is displayed in the
parameter manager in online mode :
It depends on the target, whether Index and Subindex or RefID and Offset are used for monitoring the
The following commands are available in the 'Extras' menu for handling the list transfer between editor
The list currently marked in the navigation window will be deleted from the PLC
This command will open the dialog 'Copy objects' where you can select from
the available lists those you want to download to the runtime system. The
download will be done as soon as you confirm with OK. It depends on the
target whether for enumerations only the numeric or additionally the symbolic
values will be transferred.
All lists of type 'Parameters' will be read from the runtime system and loaded
into the Parameter Manager. The "upload" of lists of type 'Variables' will be
done only if explicitly supported by the target.
All values defined in column 'Value' will be written to the parameter list in the
runtime system. To write single values, perform a double-click on the
respective field in the column to get the dialog 'Write value', as known from the
function 'Online' 'Write values'.
Write default values
The values defined in column 'Default' will be written to the parameter list in the
Take over values
The current values will be read from the runtime system and be uploaded to
is also available to toggles the input format between 'decimal' and
Parameter lists in boot project
It depends on the target system, whether parameter lists will be regarded when a boot project is
6 - The Ressources
6.11.7 Export / Import of parameter lists
The command 'Export' of the 'Extras' menu can be used to export the lists of the Parameter Manager
to a XML-file. This file for example might be imported to another project by using the import function
in the CoDeSys Parameter Manager. The standard dialog for saving a file will be opened, the file
extension *.prm will be preset. All lists available in the Parameter Manager will be written to the export
The content of the Parameter Manager also can be exported using the general project export function
The command 'Import' of the 'Extras' menu can be used to import a XML-file which describes
parameter lists. This file for example might be created by using the export function in the CoDeSys
If the import file contains a list, the name of which is already used in the Parameter Manager, a dialog
will open asking the user whether the existing list should be overwritten.
6.12 Target Settings
The "Target Settings" is an object of the 'Resources'. Here you define, which target shall be used for
the project and how it will be configured. If a new project is started with
, a dialog will
open where the target, that means a predefined configuration for a target, has to be set.
The list of available targets depends on which Target Support Packages (TSP) are installed on the
computer. These describe platform specific basic configurations and also define, to which extent the
configuration can be modified by the user in the
Target settings dialogs.
If no TSP is available, only the setting '
' will be offered in the target system selection box.
This will switch to simulation mode automatically and no configuration settings will be possible.
A Target Support Package (TSP) must be installed before starting by the aid of the installation
which might be part of the
A Target Support Package (
) contains all the files and configuration information necessary to
control a standard platform with a program created in
. What has to be configured:
codegenerator, memory layout, PLC functionality, I/O modules. In addition libraries, gateway drivers,
ini-files for error messaging and PLC browser have to be linked. The central component of a TSP is
one or more
. A Target file directs to the files which are in addition necessary to configure
the target. It is possible that several target files share these additional files.
The default extension for a Target file is *.
, the format is binary. Additive definitions are attached to
the entries in the target file which determine whether the user can see and edit the settings in the
During installation of a TSP the target file for each target is put to a separate directory and the path is
registered. The associated files are copied to the computer according to the information of a
. The name of the target directory is the same as the targets name. It is recommended to store
the target specific files in a directory which is named with the manufacturers name.
The files which get installed with a TSP are read when
is started. The target settings which
are done in the
dialogs will be saved with the project.
If you use a new target file or if you have changed the existing one,
has to be restarted to
read the updated version.
Dialog Target Settings
will open automatically, when a new project is created. It also can be
opened by selecting the menu item 'Target Settings' in the register 'Resources' in the Object
Choose one of the target configurations offered at
If no Target Support Package has been installed, only '
' can be selected, which means working
in simulation mode. If you choose one of the installed configurations it depends on the entries in the
target files, which possibilities are left to customize this configuration in the
dialogs. If you
choose a target configuration, for which there exists no valid licence on the computer,
you to choose another target.
If a configuration is selected, which is provided with the entry "HideSettings" in the corresponding
target file, you only can see the name of the configuration. Otherwise there are five dialogs available
to modify the given configuration:
1. Target Platform
2. Memory Layout
Please be aware, that each modification of the predefined target configuration can cause severe
changes in performance and behaviour of the target !
Press <Default> if you want to reset the target settings to the standard configuration given by the
6.13 The PLC-Browser
The PLC-Browser is a text-based control monitor (terminal). Commands for the request of specific
information from the controller are entered in an entry line and sent as string to the controller. The
returned response string is displayed in a result window of the browser. This functionality serves
diagnostic- and debugging purposes.
The commands available for the set target-system are made up of the
standard set plus a
possible extension set of the controller manufacturer. They are managed in an ini file and
implemented accordingly in the runtime system.
6.13.1 General remarks concerning PLC-Browser operation
Select the entry PLC-Browser in the Resources tab-control. It will be available there if it is activated in
the current target settings (category networkfunctionality).
Documents you may be interested
Documents you may be interested