SimulinkRealTime.targetScope

Description

Controls and accesses properties of target scopes.

The kernel acquires a data package and the scope displays the data on the target computer. Depending on the setting of DisplayMode, the data is displayed
numerically or graphically by a redrawing or rolling display.

Sliding display will be removed in a future release. It behaves like rolling
display.

The following lexical rules exist:

Function names are case sensitive. Type the entire
name.

Property names are not case sensitive. You do not
need to type the entire name, as long as the characters that you type
are unique for the property.

You can invoke some of the scope object properties and functions from the target computer command line when you have loaded the real-time application.

Read-only property that determines how the scope collects and displays its
data:

'Host' — The scope collects data on the target computer and displays it on the development computer.

'Target' — The scope collects data on the target computer and displays it on the target computer monitor.

'File' — The scope collects and stores data on
the target computer.

NumSamples — Number of contiguous samples capturedunsigned integer

Number of contiguous samples captured during the acquisition of a data package.

The scope writes data samples into a memory buffer of size
NumSamples. If the scope stops before capturing this number
of samples, the scope writes zeroes after the collected data to the end of the
buffer. Know what type of data you are collecting, because it is possible that your
data contains zeroes.

NumPrePostSamples — Samples collected before or after a trigger event0 (default) | integer

Number of samples collected before or after a trigger event. Entering a negative
value collects samples before the trigger event. Entering a positive value collects
samples after the trigger event. If you set TriggerMode to
'FreeRun', this property has
no
effect on data acquisition.

Decimation — Samples to acquire1 (default) | unsigned integer

If 1, scope acquires every sample. If greater than 1,
scope acquires every Decimationth sample.

TriggerSignal — Signal for signal triggerunsigned integer

If TriggerMode is 'Signal', this parameter
identifies the block output signal to use for triggering the scope. Identify the
signal with a signal index from the target object property
Signal.

TriggerLevel — Signal trigger crossing valuenumeric

If TriggerMode is 'Signal', this parameter
indicates the value that the signal has to cross to trigger the scope and start
acquiring data. The trigger level can be crossed with either a rising or falling
signal.

If TriggerMode is 'Signal',
TriggerSlope indicates the signal behavior that triggers the
scope.

'Either' — The signal triggers the scope when it
crosses TriggerLevel in either the rising or falling
directions.

'Rising' — The signal triggers the scope when it
crosses TriggerLevel in the rising direction.

'Falling' — The signal triggers the scope when
it crosses TriggerLevel in the falling
direction.

TriggerScope — Scope for scope triggerunsigned integer

If TriggerMode is 'Scope', this parameter
identifies the scope to use for a trigger. To trigger a scope when another scope is
triggered, set the slave scope property TriggerScope to the scope
index of the master scope.

If TriggerMode is 'Scope', then
TriggerSample specifies on which sample of the triggering
scope the current scope triggers.

For example, if TriggerSample is 0
(default), the current scope triggers on sample 0 (first sample
acquired) of the triggering scope. In this case, the two scopes are synchronized
with each other.

If TriggerSample is 1, the current scope
triggers on sample 1 (second sample acquired) of the triggering
scope. In this case, the two scopes have a one-sample offset.

Setting TriggerSample to -1 means that the
current scope triggers at the end of the acquisition cycle of the triggering scope.
In this case, the triggered scope acquires its first sample one sample after the
last sample of the triggering scope.