The symbol configuration functionality allows you to create symbol descriptions. The symbols and the variables they represent can then be accessed by external applications, such as Vijeo Designer, EcoStruxure Operator Terminal Expert, or OPC server.
To configure symbols for an application, double-click the
node in the . The editor view opens.The editor contains a table. Depending on the set filter, it shows the available variables, or just those already selected for the symbol configuration. For this purpose, the concerned POUs or libraries are listed in the
column. You can expand them in order to show the particular variables.
Element |
Description |
|
---|---|---|
button |
The button allows you to set the following filters to reduce the number of displayed variables: |
|
|
Even variables not yet added to the symbol configuration, but available for this purpose in the project, are displayed. |
|
|
Also variables from libraries, not yet added to the symbol configuration, but available for this purpose in the project, are displayed. |
|
|
This setting is effective only when the unconfigured variables are displayed (see the two filters described above).
It has the effect that also those variables are listed, which are already selected for getting symbols by { |
|
button |
The button allows you to build the project. The build run refreshes the variables view in the configuration editor. |
|
button |
The button allows you to activate the following options: |
|
|
This function is not supported. |
|
|
This has the effect that comments assigned to variables are also exported to the symbol file. |
|
|
This has the effect that the flags that contain the namespace are also exported to the symbol file. They provide additional information on the origin of the node in the namespace when OPC UA is active. |
|
|
Opens the dialog box that allows you to configure the contents of the symbol configuration and the XML file. |
|
|
Opens the EcoStruxure Machine Expert Menu Commands Online Help. tab of the dialog box of the selected controller. Refer to the description of the option in the
NOTE: Do not activate the option for motion and real time-critical application because the delayed start of IEC tasks leads to a higher jitter.
For further information, refer to the paragraph Additional Information on the Option Configure synchronisation with IEC tasks.... |
|
|
Select this option to calculate the data output in the same way as in SoMachine / SoMachine Motion versions prior to V4.3.
Do not use this layout together with exported The data layout created for the client is adapted as far as possible to the layout created by the compiler. |
|
|
Select this option to calculate the data output in an optimized form, independent of the internal compiler layout. The optimization impacts only variables of a structured type and function blocks. No gaps with padding bytes are generated for members that are not published, for example, because they are deactivated in the . For internal members, for example, function blocks implementing interfaces, no gaps are created either.This option is by default selected for projects created with SoMachine / SoMachine Motion versions V4.3 or later, or with EcoStruxure Machine Expert. The setting is preserved after a . This option requires SoMachine / SoMachine Motion versions V4.3 or later, or EcoStruxure Machine Expert. It is the default setting when creating a new . |
|
|
By default, this option is not selected, as EcoStruxure Machine Expert V2.0 and later versions are delivered with an OPC server V3.5 and later. Select this option for the exchange of variables with an OPC server V2.0 to achieve the following behavior:
|
|
|
This option is only available if the function is supported by the controller. Consult the Programming Guide specific to your controller for further information. If the option is selected, the action can be set in the symbol table for symbols of POUs of type function, function block, method, or program.As a prerequisite, the option must be selected. |
|
|
This option is available if the option is supported by the controller.Select this option to export information about called functions, function blocks, methods, or programs to the symbol file. |
|
|
Select this option to display a toolbar above the Toolbar for Symbol Set Configuration paragraph. table. Also refer to the |
|
button |
|
Opens the dialog box for saving a file in the file system. Allows you to create an XSD (XML Schema Definition) format of the symbol file, for use in external programs. |
Columns of the
table:
Column |
Description |
---|---|
|
The column shows a list of POUs. You can select variables to be exported. If you select variables of a structured data type, all members of the structure will be exported. You may also select only particular member variables in the dialog box . Click the browse button in the column to open this dialog box. For further information, refer to the description of the column. |
|
To modify the access rights for a selected item, click the column.Each mouse-click switches the symbol within the following definitions:
|
|
Shows the maximum access rights. |
|
An icon is displayed if the access right was assigned by attribute. |
|
Shows the data type of the variable. Variables of an alias data type are displayed as shown in the following example of a variable:
In this case, the |
|
Click the button in the column to open the dialog box. It allows you to select only particular member variables. In case of nested types, this dialog box again provides a button to open another dialog box.This selection applies to all instances of this data type for which symbols are exported. If not all members of a structured type are exported, then an asterisk ( ) is displayed in the check boxes of the members to indicate that all exportable members of that type are exported. |
|
Shows any comments which have been added in the declaration of the variable. |
Variables which are configured to be exported but which are not valid in the application, for example because their declaration has been removed, are shown in red. This also applies to the concerned POU or library name.
By default, a symbol file is created with a code generation run. This file is transferred to the device with the next download. If you want to create the file without performing a download, use the command
, by default available in the menu.If the option
is selected in the settings of the symbol configuration, the toolbar for symbol set configuration is available with the following elements:
Element |
Description |
---|---|
List |
The list contains already defined symbol sets. |
![]() |
Opens the dialog box for specifying a name for this set. |
![]() |
Opens the dialog box. It allows you to create a copy of the set selected in the list. You can adapt the default name (<group name>_duplicate) to your individual requirements. |
![]() |
Opens the dialog box for specifying another name for the set selected in the list. |
![]() |
Opens a dialog box prompting whether the set selected in the list should be deleted. |
|
Opens the view of the device editor. |
The
dialog box opens upon clicking . It contains the following elements:
Element |
Description |
---|---|
|
|
|
This function is not supported. |
|
|
|
|
|
|
|
|
|
Namespace node flags provide additional information about the origin of a node in the namespace. Node flags are available in the symbol table when OPC UA is activated. Deselect this option to prevent namespace node flags from being inserted in the XML file if your parser cannot process them. |
|
Select this option to save comments in the XML file. In SoMachine / SoMachine Motion versions prior to V4.4, this includes the setting . |
|
Select this option to save attributes in the XML file. |
|
This option is only available if the option or the option is activated.If this option is selected, the information for type nodes is also included (user-defined types, such as STRUCT and ENUM elements). If this option is not selected, comments and attributes are only available for directly exported variables. |
These parameters are only available if one of the options is activated. |
|
|
Select the options to determine the kind of comments that are saved in the symbol configuration. |
|
|
|
|
|
|
|
|
These parameters are only available if one of the options is activated. |
|
|
Select the options to determine the attributes that are saved in the symbol configuration. |
|
|
|
|
|
To achieve synchronous, consistent access, the runtime system postpones the processing of read or write request of the symbolic client until no IEC task is executed. As soon as this gap is found, the restart of IEC tasks is postponed until the requested values have been copied to the variables list.
This option is useful for permanently running systems without production clocking, for example, if process values are to be written cyclically in fixed time intervals (such as 60 s).
If you intend to use the
option, consider the following points when you define the variable lists that are read and written:Configure synchronous and consistent access only for those variables for which it is necessary.
Create separate lists for consistent variables and for variables that may be inconsistent.
Create several small lists containing consistent variables instead of one large list.
Define the time intervals for cyclically reading values as large as possible.
The option EcoStruxure Machine Expert:
is available at two different locations inIn the
editor, as an option of the button. (If a symbol configuration is available in the application.)In the
tab of the dialog box of the selected controller.