The Runtime Service system includes 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 boolean events in the Runtime Service application.

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

Operations

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

Settings

Before starting a recording, you need to setup the parameters for the recorder in the Setup Sampling dialog. 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 Service 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 Studio is used either for simulation or online debugging.

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

Created with the Personal Edition of HelpNDoc: Streamline Your Documentation Creation with a Help Authoring Tool