Dialog 'Advanced Trace Settings'

Function: This dialog provides extended settings for recording data.

Call: “Advanced” button in “Trace Configuration ” dialog, “Record Settings” subdialog

Requirement: The trace editor is open and active. The dialog “Trace configuration” is open and the top node of the trace record tree is selected so that the subdialog “Record settings” is available.

For the calculation of the values, you have to select a task in the “Trace Configuration” dialog.

The buffer size is defined as "number of samples". CODESYS calculates the time intervals that corresponds to this number and displays the result in normal fonts on the right outside the table (for example, “1h1m1s1ms”). The calculation is possible only with the help of the task configuration settings and when the task cycle time is known.

“Measurement in every n-th cycle”

Data sampling in every n task cycle

Default: ‎1‎; then the application performs the data sampling in each task cycle.

Sampling interval which is automatically calculated from the value specified in the Measurement in every n-th cycle option

Example: ‎100ms‎

“Recommended runtime buffer size (samples)”

Calculated automatically and therefore recommended number of samples which the application can store per trace variable at runtime

This value determines the maximum ring buffer size in the runtime system. This buffer size is automatically calculated from the task cycle time and the value in the “Measure in every n-th cycle” option, and the displayed.

This buffer size is used when the “Override runtime buffer size” option is disabled.

Maximum length of the time interval during which the application samples data on the runtime system

Example: ‎2s‎

Note: The calculation is possible only when the settings of the trace configuration are set in the “Trace Configuration ”dialog and therefore the task cycle time is known.

“Override runtime buffer size”

_cds_icon_option_activated Enables the input field for you to specify your own defined buffer size At runtime, the value which you have specified here is used, not the value displayed in the Recommended runtime buffer size (samples) option.

Example: ‎100‎

At least 10

_cds_icon_option_activated The application uses this value, not the value calculated by CODESYS from the Recommended runtime buffer size (samples) option.

Maximum length of the time interval during which the application samples data on the runtime system without overwriting it.

Example: ‎6s‎

“Trace editor buffer size per variable (samples)”

Number of values that can be stored per variable in the trace editor.

Example: ‎10000‎

The maximum time period for the display in the trace editor results from the maximum number and the sampling interval of the data sampling. You can scroll back a maximum of this time in the trace editor.

Example

Column (1) notifies you about the number of samples.

Column (2) next to it displays the calculated time intervals which result.

_cds_img_trace_example_calculation.png

The information displayed in the example means that one sample is taken per task cycle in the runtime system and continuously cached in a ring buffer, which can hold a maximum of 201 samples. The enabled “Override runtime buffer size” option has the effect that, due to the ring buffer, the first cached values are first overwritten after 100 samples. During this time, 10000 samples are continuously displayed in the trace editor so that a value curve can be displayed over an interval of 1 minute and almost 40 seconds.