dl-breadcrumbs__homedl-breadcrumb-item__separatorConfiguration and programmingdl-breadcrumb-item__separatorProgramming with CODESYSdl-breadcrumb-item__separatorCODESYS Development Systemdl-breadcrumb-item__separator...dl-breadcrumb-item__separatorReference, User Interfacedl-breadcrumb-item__separatorDialogsdl-breadcrumb-item__separatorDialog 'Trace Configuration'dl-breadcrumb-item__separatorDialog 'Trace Configuration'
dl-pagination__prev-inactivedl-pagination__prev-activedl-pagination__next-inactivedl-pagination__next-active
Dialog 'Trace Configuration'dl-permalink__symbolPermalink

Symbol: _cds_icon_trace

Function: The dialog includes the trace configuration for the data recording.

Call

  • “Trace  Configuration”; context menu

  • Link “Configuration” in the trace editor

  • Link “Add Variable” in the trace editor

Requirement: The editor of a trace object is open and active.

Tree view 'Trace Record'

The tree view lists the variables that are traced and allows for access to the variable settings.

Selected trace name

The “Record Settings” subdialog is displayed on the right.

Selected trace variable

The “Variable Settings” subdialog is displayed on the right.
Table 624: Context menu commands

_cds_icon_add “Add Variable”

Adds a new trace variable. The “Variable Settings” subdialog opens on the right and it is partially configured. Select a variable in the input field of the “Variable” setting to trace its value curve.

“Assign to Diagram”

Lists the diagrams (in the submenu on the right) where the selected variable is not currently displayed. Select a diagram to display the variable there.

The command is available when a variable is selected in the tree view.

Hint: When the command is deactivated, the variable is already displayed in all diagrams.

“Enabled”

Selected by default

Disabled variables are displayed as disabled. They are neither displayed nor recorded.

Tree view 'Presentation (Diagrams)'

The tree view lists the diagrams that are displayed in the trace editor and allows for access to their display mode.

Selected node “Time axis”

The “Display Mode” subdialog for the time axis is displayed on the right. You can specify the time axis display. See below.

Selected diagram name

The settings for the coordinate system of the diagram and a preview are displayed on the right. See below.

Selected node “Y-axis”

The “Display Mode” subdialog is displayed on the right. You can specify the axis display. See below.

“Show variables”

Selected trace variable

The “Variable Settings” subdialog is displayed on the right. You can configure the trace variable. See below.

Note: These are the same settings that can be accessed in the “Trace Record” tree view.
Table 625: Context menu commands

_cds_icon_add “Add Diagram”

Adds a new diagram below and displays it in the tree view “Presentation (Diagrams)”.

_cds_icon_add “Add New Variable”

Adds a new trace variable. The “Variable Settings” subdialog opens on the right and it is partially configured. Select a variable in the input field of the “Variable” setting to trace its value curve. Specify its display. In addition, the variable is assigned to the selected diagram.

“Add Existing Variable”

Lists all trace variables (in the submenu on the right) where the selected diagram is not currently displayed. Select a variable in order to display it in the selected diagram.

Hint: When the command is deactivated, all trace variables are already displayed in the selected diagram.

Subdialog 'Record Settings'

Requirement: The top node is selected in the “Trace Record” tree view.

“Enable trigger”

_cds_icon_option_activated: Triggering is enabled. The trace data is buffered at runtime only when a trigger signal has been sent. You determine how the trigger signal is sent in the “Trigger variable”, “Trigger parameter”, “Trigger edge”, “Post-trigger (Samples)”, and “Trigger level” settings.

_cds_icon_option_deactivated: Continuous display of current records

“Trigger variable”

Signal that is used as a trigger. A complete instance path is required.

A valid trigger signal is an IEC variable, a property, a reference, a pointer, an array element of the application, or an expression. Allowed types are all IEC-based types except ‎STRING‎, ‎WSTRING‎, and ‎ARRAY‎. Enumerations are allowed when the base type is not ‎STRING‎, ‎WSTRING‎, or ‎ARRAY‎ The contents of a pointer are not a valid signal.

When the runtime system uses the ‎CmpTraceMgr‎ component, a property that is linked to the ‎'monitoring'‎ attribute can then be recorded as a variable.

“Trigger parameter”

System parameter that is used as a trigger

The “Input Assistant” dialog lists all valid system parameters in the “Parameters” category of the “Categories” tab.

_cds_icon_drop_down_list

Allows the selection of “Trigger variable” or “Trigger parameter”

“Trigger edge”

Defined the edge detection for triggering:

  • _cds_icon_edge_raising “positive”

    • For Boolean trigger variables, triggering occurs when the values changes from ‎FALSE‎ to ‎TRUE‎.

    • For analog trigger variables, triggering occurs when the value as defined in “Trigger level” is reached from below.

  • _cds_icon_edge_falling “negative”

    • For Boolean trigger variables, triggering occurs when the values changes from ‎TRUE‎ to ‎FALSE‎.

    • For analog trigger variables, triggering occurs when the value as defined in “Trigger level” is reached from above.

  • _cds_icon_edge_both “both”

    • For Boolean trigger variables, triggering occurs when the values changes.

    • For analog trigger variables, triggering occurs when the value as defined in “Trigger level” is reached.

“Post trigger (samples)”

Number of records per trace variable that are buffered after triggering. Default: ‎50‎; value range: ‎0‎ to (‎2‎32‎ - 1‎)

“Trigger level”

Value that is reached to start the triggering

“Task”

Task in which the data is recorded.

“Recording condition”

At runtime, the application checks the recording condition. If it is fulfilled, then the trace data is buffered.

Record condition for data recording with ‎CmpTraceMgr‎ runtime system component:

  • As an expression that includes only permitted operators and operands.

    Allowed operators that can also be nested: (logical) ‎AND‎, ‎NOT‎,‎OR‎, comparison operators ‎<‎, ‎<=‎, ‎>‎, ‎>=‎, ‎=‎, ‎<>‎.

    Allowed operands: Variables that are valid for trace.

  • As a variable.

    Allowed type: ‎BOOL‎, bit access, property. The condition is fulfilled for ‎TRUE‎ or ‎1‎. The contents of a pointer are not permitted.

Recording condition for a data recording with IEC code.

  • As an expression that returns a Boolean value.

“Comment”

Comment (for example, from the recording condition)

“Resolution”

Unit of measure for the time stamp that is recorded per data set

  • “ms”: Time stamp (in milliseconds).

  • “µs”: Time stamp (in microseconds) for a task cycle time of 1 ms or less

“Automatic restart”

_cds_icon_option_activated: Persistently saves the trace configuration and the last contents of the RTS buffer to the target device. After the device has been restarted, the trace is started automatically if the trigger has not occurred yet.

“Advanced”

Opens the “Advanced Trace Settings” dialog.

Subdialog 'Variable Settings'

Requirement: A trace variable is selected in the “Trace Record” or “Display (Diagrams)” tree view.

“Variable”

Valid variable Variable; value recorded with full instance path.

Valid:

  • IEC variable

  • Property

  • Reference

  • Contents of the pointer

  • Array element

Allowed data type

  • IEC-based type except ‎STRING‎, ‎WSTRING‎, or ‎ARRAY‎

  • Enumeration when the base type is not ‎STRING‎, ‎WSTRING‎, or ‎ARRAY‎

When the runtime system uses the ‎CmpTraceMgr‎ component, a property that is linked to the ‎'monitoring'‎ attribute can then be recorded as a variable.

“Parameter”

Parameter whose data is recorded.

Requirement: Runtime system with ‎CmpTraceMgr‎ component

The “Input Assistant” dialog lists all valid system parameters in the “Parameters” category of the “Categories” tab.

_cds_icon_drop_down_list

Allows toggling between “Variable” and “Parameter”

“Color”

Color of the variable in the trace diagram

“Line type”

Display as line chart

  • _cds_icon_line “Line”: Values are linked to form a line.

  • _cds_icon_step “Step”: Values are linked in the form of steps

  • “None”: Values are not linked

“Point type”

Display as scatter chart

  • _cds_icon_dot “Dot”: Value is displayed as a dot

  • _cds_icon_cross “Cross”: Value is displayed as a cross.

  • “None”: value is not displayed

“Activate minimum warning”

_cds_icon_option_activated: Warning when less than the lower limit

“Critical lower limit”

If the value of the trace variable falls below the limit, the variable is displayed in the warning color.

“Color”

Warning color on falling below the limit

“Activate maximum warning”

_cds_icon_option_activated: Warning when exceeding the upper limit

“Critical upper limit”

If the value of the trace variable exceeds the upper limit, the variable is displayed in the warning color.

“Color”

Warning color on exceeding the limit

Subdialog 'Display Mode'

Requirement: An axis is selected in the tree view “Presentation (Diagrams)”

“Display Mode”

Scaling

  • “Auto”:

    Automatically scaled time axis

  • “Fixed length”:

    Time axis segment with a constant “Length”

  • “Fixed”

    Time axis segment from “Minimum” to “Maximum”

“Minimum”

Literal, variable (integer data type), or constant variable (integer data type). It contains the initial value of the segment. Requirement: The “Display Mode” is “Fixed”.

Examples: ‎20,PLC_PRG.iLimit_Min, GVL.c_iLimit_Min‎

Note: The variable has to have an initial value. This is important for the offline display and the scaling subdivision. Example: ‎iLimit_Min : INT := 20‎

“Maximum”

Literal, variable (integer data type), or constant variable (integer data type). It contains the end value of the segment. Requirement: The “Display Mode” is “Fixed”.

Examples: ‎80,PLC_PRG.iLimit_Max, GVL.c_iLimit_Max‎

Note: The variable has to have an initial value. This is important for the offline display and the scaling subdivision. Example: ‎iLimit_Max : INT := 80‎

“Length”

Constant segment length; the initial value is adapted automatically.

“Grid”

_cds_icon_option_activated: Diagram with grid line in the X-direction. Select the grid line color from the list box of colors.
Table 626: “Tick marks”

“Fixed spacing”

_cds_icon_option_activated: Display of tick marks with “Distance” and “Subdivisions”.

“Distance”

Distance between tick marks

“Subdivisions”

Number of subdivisions between two tick marks

“Font”

Font for the time axis.

Link “Preview”

Displays the preview of the diagram.

Diagram preview

Requirement: A diagram is selected in the tree view “Presentation (Diagrams)”

_cds_img_trace_tumbnail

“Background color”

Background color of the diagram. _cds_icon_drop_down_list opens the list box of colors.

“Background color on selection”

Background color of the selected diagram.

Link “Add Variable”

Adds a new trace variable (in the “Trace Record” tree view).

Link “Delete Variable”

Deletes the selected trace variable (in the “Trace Record” tree view).

Link “Add Diagram”

Adds a new diagram (in the “Display” tree view).

Link “Delete Diagram”

Deletes the selected diagram (in the “Display” tree view).

Link “Reset Display Settings”

Resets the display settings of either the selected diagram or Y-axis to the default values.

“OK”

Accepts the configuration changes and saves the trace configuration.