Dialog: Trace Configuration

Symbol:

function: The dialog contains the trace configuration for the Data sampling.

. Call

Trace → Configuration command; context menu
Configuration link in the trace editor
Add Variable link in the trace editor

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

For more information, see: Creating Trace Configuration

Trace Record Tree View

The tree view lists the variables which 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 6. Context menu commands

: 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 disabled, the variable is already displayed in all diagrams.

Enabled

Enabled by default

Disabled variables are displayed as grayed out. They are neither displayed nor recorded.

Presentation (diagrams) Tree View

The tree view lists the diagrams which 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 which can be accessed in the Trace Record tree view.

Table 7. Context menu commands

: Add Diagram

Adds a new diagram below and displays it in the Presentation (diagrams) tree view

: 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. Moreover, 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 disabled, all trace variables are already displayed in the selected diagram.

Record Settings Subdialog

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

Enable Trigger	: 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. : Continuous display of current data sets
Trigger variable	Signal which 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. Permitted 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 which is linked to the `'monitoring'` attribute can then be sampled as a variable.
Trigger parameter	System parameter which is used as a trigger The Input Assistant dialog lists all valid system parameters in the Parameters category of the Categories tab.
	Allows for the selection of Trigger variable or Trigger parameter
Trigger edge	. Defines the edge detection for triggering : positive For a Boolean trigger variable, triggering occurs when the value changes from `FALSE` to `TRUE`. For an analog trigger variable, triggering occurs when the value as defined in Trigger Level is reached "from below". : negative For a Boolean trigger variable, triggering occurs when the value changes from `TRUE` to `FALSE`. For an analog trigger variable, triggering occurs when the value as defined in Trigger Level is reached "from above". : both For a Boolean trigger variable, triggering occurs when the value changes. For an analog trigger variable, triggering occurs when the value as defined in Trigger Level is reached.
Post trigger (samples)	Number of samples per trace variable which are buffered after triggering Default: `50` Value range: `0` to `2`³² `-1`
Trigger Level	Value which is reached in order to start the triggering
Task	Task where the data is recorded
Record condition	At runtime, the application checks the record condition. If it is fulfilled, then the trace data is buffered. . Record condition for data sampling with `CmpTraceMgr` runtime system component As an expression which includes only permitted operators and operands Allowed operators which can also be nested: (logical) `AND`, `NOT` and `OR`, and comparison operators `<`, `<=`, `>`, `>=`, `=` and `<>` Allowed operands: Variables which 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. . Record condition for a data sample with IEC code As an expression which returns a Boolean value
Comment	Comment (for example, from the record condition)
Resolution	Unit of measure for the time stamp which 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	: Persistently saves the trace configuration and the last contents of the runtime buffer to the target device After the device has been restarted, the trace is automatically started if the trigger has not occurred yet.
Advanced	Opens the Advanced Trace Settings dialog

For more information, see: Advanced Trend Settings

Variable Settings Subdialog

Requirement: A trace variable is selected in the Trace Record or Presentation (diagrams) tree view.

Variable	Valid variable Variable; value recorded with full instance path . Valid IEC variable Property Reference Contents of a pointer Array element . Permitted 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 which is linked to the `'monitoring'` attribute can then be recorded as a variable.
Parameters	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.
	Allows for toggling between Variable and Parameter
Color	Color of the variable in the trace diagram
Line type	. Display as line chart Line: The values are connected to form a line. Step: The values are connected in the form of stairs. None: The values are not connected.
Point type	. Display as a scatter chart Dot: The value is displayed as a dot. Cross: The value is displayed as a cross. None: The value is not displayed.
Activate minimum warning	: 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 when the value falls below the limit
Activate maximum warning	: Warning when exceeding the upper limit
Critical upper limit	If the value of the trace variable exceeds the upper limit, then the variable is displayed in the warning color.
Color	Warning color when the value exceeds the limit

Display Mode Subdialog

Requirement: An axis is selected in the Presentation (diagrams) tree view.

Display Mode	. Scaling Auto Automatically scaled time axis Fixed length Time axis segment with a Length constant 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 length of the segment The initial value is adapted automatically.
Grid	: Diagram with grid line in the X-direction Select the grid line color from the list box of colors.

Table 8. Tick Marks

Fixed spacing	: Display of tick marks with Distance and Subdivisions
Distance	Distance between tick marks
Subdivisions	Number of subdivisions between two tick marks

Font	Font which is used for the time axis

Preview link

Displays the preview of the diagram

Diagram Preview

Requirement: A diagram is selected in the Presentation (diagrams) tree view.

Background color

Background color of the diagram

The symbol opens the list box of colors.

Backcolor on selection

Background color of the selected diagram

Add Variable link	Adds a new trace variable (in the Trace Record tree view)
Delete Variable link	Deletes the selected trace variable (in the Trace Record tree view)
Add Diagram link	Adds a new diagram (in the Presentation tree view)
Delete Diagram link	Deletes the selected diagram (in the Presentation tree view)
Reset Display settings link	Resets the display settings of either the selected diagram or Y-axis to the default values

OK	Applies the configuration changes and saves the trace configuration