Digital sampling trace

The runtime system as the simulator include a digital sampling trace recorder. The recorder is used to register periodically the state of up to 8 boolean variables. Samples can be registered either on each cycle or according to a configurable period. The digital sampling trace is a useful tool for tracking aleas and events in the runtime application.

The sampling trace can be configured and watched from the Output window. The sampling trace is available only during simulation or on line debugging.

Important notes

The digital sampling trace is a unique resource of the runtime system. The settings of the recorder are the same for all recorded variables.
The recording is limited to 900 samples of up to 8 BOOL variables.
Sampling trace recorder may be not available on some targets. Please refer to OEM instructions for further details about available features.
The recording of the sampling trace is time consuming and may slow down performances of the runtime system.

Operations

Use the following commands in the Log window when the "Digital Sampling Trace" tab is focused:

	Define the variables and the settings of the sampling trace.
	Start recording
	Stops recording
	Set or reset the auto-scroll mode
+ / -	Zoom in or out (num pad)

Settings

Before starting a recording, you need to setup the parameters for the recorder. This includes the list of spied variables, a period (either a time or on each cycle), plus start and stop conditions. All variables must have the BOOL data type.

Note that, if you program a period for the recorder, it means "wait at least this time between two samples", and does not correspond to an accurate time synchronization.

Press the "Set" button to validate the settings. Press the "Reset" button to clear the current settings in the runtime system.

Start condition

The "Start Condition" tab of the settings box enables you to define which condition will start the recording. The following choices are available:

- Immediately
- Later: you will have to manually start the recorder using the "Start" command
- On the rising or falling edge of a BOOL variable, possibly with a delay.

The delay is expressed as a number of samples omitted after the start condition occured, before the recording actually starts.

Stop condition

The "Stop Condition" tab of the settings box enables you to define which condition will stop the recording. The following choices are available:

- Never: you will have to manually stop the recorder using the "Stop" command
- When the buffer is full
- On the rising or falling edge of a BOOL variable, possibly with a delay.

The delay is expressed as a number of samples passed after the stop condition, before the recording actually stops.

Remarks

The recorder cannot be restarted after points have been registered, even if stopped. To restart the recording, you first have to re-validate the settings.

The sampling trace must be configured or started when the Workbench is used either for simulation or on line debugging.

Use the "File / Save As" and "Edit / Copy" commands for exchanging recorded data with other applications such as spreadsheets.