dl-breadcrumbs__homedl-breadcrumb-item__separatorConfiguration and programmingdl-breadcrumb-item__separatorProgramming with CODESYSdl-breadcrumb-item__separator...dl-breadcrumb-item__separatorCODESYS Development Systemdl-breadcrumb-item__separatorApplication at Runtimedl-breadcrumb-item__separatorData Recording with Tracedl-breadcrumb-item__separatorCreating trace configuration
dl-pagination__prev-inactivedl-pagination__prev-activedl-pagination__next-inactivedl-pagination__next-active
Creating trace configurationdl-permalink__symbolPermalink

For a complete trace configuration, specify at least one task and one variable. In order to trigger the data recording, activate the trigger option and select a trigger variable or specify a recording condition.

Assigning a task

In this task, the data recording is executed in runtime mode. Usually the same task is selected where the variables are written.

  1. Double-click the trace object.

    The trace editor opens with the commands available in the “Trace” menu.

  2. Click “Trace  Configuration”.

    The “Trace Configuration” dialog opens. In the tree view “Trace Record”, the top item is selected and the subdialog “Record Settings” is shown on the right.

  3. Click the "arrow down" symbol (_cds_icon_arrow_down) in the “Task” drop-down list.

    The drop-down list opens with all tasks that are available throughout the application.

  4. Select a task for the trace.

Configuring a trace variable

  1. Double-click the trace object.

    The trace editor opens. The commands of the “Trace” menu are available.

  2. Click “Add Variable”.

    The “Trace Configuration” dialog opens. The subdialog “Variable Settings” is displayed on the right.

  3. Click _cds_icon_three_dots in the input field of the “Variable” setting and select a trace variable in the “Input Assistant” dialog.

    The variable is configured for data recording. The trace record tree and the display tree were extended by the variable.

  4. Click the “Add Variable” link.

    The trace record tree and the display tree receive a new variable. The settings of the variables are available on the right.

  5. Select a trace variable.

  6. Click “OK” to close the dialog.

    The variables are trace variables and are displayed in the trace variable list.

Deleting a trace variable

  1. Double-click the trace object.

  2. Click a variable in the trace record tree.

  3. Click the “Delete Variable” command or press [Del].

  4. Click “OK” to close the dialog.

    The variable is removed from the trace variable list.

Tracing a parameter

  1. Double-click the trace object.

  2. Click “Add Variable”.

    The “Trace Configuration” dialog opens. The subdialog “Variable Settings” is displayed on the right.

  3. Click _cds_icon_arrow_down (right of the “Variable” setting, left of the input field).

  4. Select the “Parameter” option in the drop-down list.

  5. Click _cds_icon_three_dots and select a parameter from the “Input Assistant” dialog.

  6. Configure how the parameter is displayed.

  7. Click “OK” to close the dialog.

    The parameter will be traced and displayed in the trace variable list.

Configuring a trigger

  1. Double-click the trace object.

    The trace editor opens with the commands available in the “Trace” menu.

  2. Click “Trace  Configuration”.

    The “Trace Configuration” dialog opens. The subdialog “Record Settings” is displayed on the right.

  3. Select the “Enable trigger” check box.

  4. Select the task in which the trend record is to be executed.

  5. Select a variable from the “Trigger Variable” field.

  6. Click “OK” to close the dialog.

    The data recording will be triggered.

The trigger time is displayed as a black line in the diagram in runtime mode.

  1. Download the application and start it.

  2. Click “Trace  Download Trace”.

    The trace configuration is loaded. After triggering, the runtime system saves the value graph of the trace variables. The data is displayed in the trace editor. The trigger time is displayed as a black line in the diagram.

Configuring the display of the time axis

  1. Double-click a trace object.

  2. Click the “Configuration” link above the configuration tree.

    The “Trace Configuration” dialog opens.

  3. Select “Time axis” in the display tree (below “Presentation (Diagrams)”).

    The display settings of the time axis are shown on the right.

  4. Edit the presets and click the “Preview” link.

    The changes are seen in the coordinate system preview.

  5. Click “Y-axis” in the display tree. The “Y-axis” item is below every configured diagram. Therefore, the display of the value axis is set for each diagram.

    The subdialog “Display Settings” of the selected axis is displayed on the right.

  6. Change the preset value.

    The changes are applied in the coordinate system preview.

  7. Click OK to close the “Trace Configuration” dialog.

    The display changes are visible in the affected diagrams.

Configuring the display of the trace variable

  1. Double-click a trace object.

  2. Click the “Configuration” link.

    The “Trace Configuration” dialog opens.

  3. Select a variable below “Trace Record”.

    The subdialog “Variable Settings” of the selected variable is displayed on the right.

  4. Change a setting, for example the “Line type”.

  5. Click “OK” to close the dialog.

    The display changes are visible in the affected diagrams.

Configuring the buffer for data on the runtime system

  1. Double-click a trace object.

  2. Click “Trace  Configuration”.

    The “Trace Configuration” dialog opens. The subdialog “Record Settings” is displayed on the right.

  3. Click “Advanced”.

    The “Advanced Trace Settings” dialog opens.

  4. Change the setting “Measure in every n-th cycle” or “Recommended runtime buffer size (samples)”.

  5. Click “OK” to close the dialog.

    The buffer settings are reconfigured. It is applied after the trace configuration is loaded to the RTS the next time.

Editing the trace configuration in runtime mode

Requirement: The application is running on the controller and a trace configuration is loaded.

  1. Double-click a variable in the trace record tree.

    The “Trace Configuration” dialog opens.

  2. Change the color, for example.

    The variable is displayed in the new color in the affected diagrams without interrupting the execution of the application.

If you change essential settings, for example a trace variable, then you must download the trace configuration to the controller again.