Object 'Trend Recording'

Symbol: _visu_icon_trend_recording

A “Trend Recording” object is always located below a “Trend Recording Manager” and enables editing of the trace configuration. At runtime, CODESYS transfers the configuration that is available to the runtime system component ‎CmpTraceMgr‎. You can configure an application with any number of trend recordings.

NOTICE

Timeout for trend recording

During a trend recording, it can happen that the application task triggers a timeout that is caught with an exception when transitioning from “Running” to “Stop”. Causes can be that file operations with the SQLite database are taking too long or that too many variables are being recorded. This usually happens on a target device with weak performance.

You can avoid the occurrence of an exception:

Configure the trend recording with less memory demand so that the amount of data that is stored is adapted to the target system.
Reduce the number of variables.

The editor includes the configuration for trend recording. The tree view shows the trend configuration and enables navigation there.

The top entry contains the trend name. When this entry is selected, the “Record Settings” are displayed next to it. An entry is located here for each variable whose data was recorded continuously. When a variable is selected, the “Variable Settings” are displayed next to it.

“Add Variable”	When you click the link, a new entry is displayed in the trend configuration with its blank configuration below the “Variable Settings” group.
“Delete Variable”	The selected variable is removed. Requirement: A variable is selected.

See also

'Variable Settings'

“Variable”	Variable for recorded value. IEC variable with valid data type Property Reference Contents of the pointer Array element of a valid data type Enumeration of a valid data type Valid data types are all standard types, except `‎STRING‎`, `‎WSTRING‎`, and `‎ARRAY‎`.
“Parameter”	Parameter for the recorded value The “Input Assistant” dialog lists all valid system parameters in the “Parameters” category of the “Categories” tab.
	Click the symbol to toggle between “Variable” and “Parameter”.
“Recording condition”	Condition under which the application records the data of these “Variables”: IEC variable of type `‎INT‎`. The condition is fulfilled for `‎TRUE‎`. Bit access to an integer variable. The condition is fulfilled for `‎1‎`. As read access to a property The contents of a pointer are not permitted. Note: If no condition is defined, then the recording starts automatically.
“Attached y axis”	Y-axis of the trend diagram that displays the “Variable”. The list box provides the standard Y-axis and the configured Y-axes. Requirement: This option is visible only when the “Trend” visualization element has configured additional Y-axes in the “Edit Display Settings” dialog.
“Display variable name”	: The visualization shows the name of the IEC variable in the trend diagram at runtime. Either alone or in parentheses after the “Description” : The name of the IEC variable is shown and does not appear in parentheses after the “Description”. Requirement: If any text is typed in “Description”, then you can disable the option.
“Description”	Text for the tooltip (example: `‎Sensor A‎`): When a visualization user focuses on the variable in the trend diagram, the visualization shows the text as a tooltip. The text is typed into the “GlobalTextList” object and can be localized there. When the “Display Variable Name” property is activated, then the text is supplemented with the variable name in parentheses. Example: `‎Sensor A (PLC_PRG.iSensor_A)‎` If “Description” does not contain any text, then “Display Variable Name” is enabled. The name is then alone without parentheses (for example, `‎PLC_PRG.iSensor_A‎`). If a legend is assigned to the trend, then the trend variable is labeled in the legend and shown like the trend is configured here.
“Curve type”	“Line” “Area”:
“Graph color”	Color of the curve in the trend diagram
“Line type”	“Line”: Values are linked to form a line. “Step”: Values are linked in the form of steps. “None”: Values are not linked. Requirement: The “Curve type” is “Line”.
“Filling type”	“No filling” “Plain color”: “Gradient” Requirement: The “Curve type” is “Area”.
“Filling color”	: The area is filled with the selected color. Requirement: The “Curve type” is “Area”.
“Transparency”	Value (0 to 255) for defining the transparency of the selected color Example `‎255‎`: The color is opaque. `‎0‎`: The color is completely transparent Requirement: The “Curve type” is “Area”.
“Line width”	Value (in pixels) Example: `‎1‎`
“Line style”	The display of the line is solid, dash, dot, dash-dot, or dash-dot-dot.
“Point type”	Display as scatter chart “Dot”: Value as a dot. “Cross”: Value as a cross. “None”: No dot display Hint: Select “None” for larger size data.
“Activate minimum warning”	: Warning when below the lower limit.
“Critical lower limit”	If the variable value is below the limit, then the variables are displayed with the alert color in the trend diagram.
“Color”	Warning color on falling below the limit
“Activate maximum warning”	: A warning is issued if the upper limit is exceeded.
“Critical upper limit”	If the variable value exceeds the limit, then the variables are displayed with the alert color in the trend diagram.
“Color”	Warning color on exceeding the limit

The settings that affect the trigger are deactivated. Only a trace configuration for a trace editor can configure triggering.
“Task”	Task where data was recorded. Click to open a list box with all tasks available in the project. In general, the trend recording runs in the same task as the main program. For example: `‎MainTask‎`
“Recording condition”	Condition under which the application records data: IEC variable of type `‎INT‎`. The condition is fulfilled for `‎TRUE‎`. Bit access to an integer variable. The condition is fulfilled for `‎1‎`. As read access to a property. The contents of a pointer are not permitted. Note: If no condition is defined, then the recording starts automatically.
“Comment”	Comment (example: `‎Data recording of sensor A‎`)
“Resolution”	Resolution that the application saves the time stamp Note: If the task where the trend object is executed has a cycle time of 1 ms or less, then you should set the resolution of the time stamp to “1 µs”.
“Trend Storage”	The “Trend Storage” dialog opens.
“Advanced”	The “Advanced Trend Settings” dialog opens.