pause

Pause stimulation of root inports of model on target computer

Since R2021a

Syntax

pause(target_object.Stimulation, inports)

pause(target_object.Stimulation, playbacks)

pause(target_object.Stimulation,'all')

pause(target_object.Stimulation,blockPath)

Description

pause(target_object.Stimulation, inports) pauses the stimulation of the specified root inports of the model running on the Speedgoat^® target computer.

pause(target_object.Stimulation, playbacks) pauses the stimulation of the specified Playback blocks in the model running on the target computer.

pause(target_object.Stimulation,'all') pauses the stimulation of all root inports, Playback blocks, and tunable parameters in the model running on the target computer.

pause(target_object.Stimulation,blockPath) pauses the stimulation of the specified root inports, Playback blocks, and tunable parameters in the model running on the target computer.

Examples

Pause Stimulation of Specific Inports

In a model with five inports, pause the stimulation of inports named first and third.

pause(tg.Stimulation,{'first','third'});
% if the port number of inport named 'first' is 1
% and the port number of inport named 'third' is 3
% this syntax is equivalent to:
%
% pause(tg.Stimulation,[1,3]);

Pause Stimulation of Specific Playback Blocks

In a model with five Playback blocks, pause the stimulation of Playback blocks named first and third.

pause(tg.Stimulation,{'first','third'});

Pause Stimulation of All Inports and Playback blocks

In a model with five inports, pause the stimulation of all inports and Playback blocks.

tg.Stimulation.pause('all');

Pause Stimulation of Specific Tunable Parameters

In a model with tunable parameters, pause the stimulation of parameters with block path slrt_ex_osc/Signal Generator. For more information finding the block path for parameters, see Simulink Real-Time Explorer.

pause(tg.Stimulation,'slrt_ex_osc/Signal Generator');

Input Arguments

target_object — Object that represents target computer

slrealtime.Target object

Provides access to methods that manipulate the target computer properties.

Example: tg

inports — Specific inports of the model on target computer

array of inport numbers | cell array of inport names | cell array of inport block paths

Specifies the numbers of the inports or names of the inports or block paths of the inports present on the model running on the target computer.

Example: [1,3,5], {'in1','in2'}, {'model_name/in1','model_name/in4'}

playbacks — Specific Playback blocks in the model on target computer

cell array of Playback block names | cell array of Playback block paths

Specifies the block names or block paths of the Playback blocks present in the model running on the target computer. If you use a block name that is not unique (more than one block with that name is present) in the model, the function returns an error and suggests using block paths instead.

Example: {'pb1','pb2'}, {'model_name/pb1','model_name/pb4'}

all — Root inports of the model on target computer

'all'

Represents all the available root inports of the model running on the target computer.

Example: 'all'

blockPath — Hierarchical name of the originating block of the tunable parameter

character vector | string scalar | cell array of character vectors or strings

The block_path values for tunable parameters in stimulation operations can be:

• Empty character vector ('') or empty string scalar ("") for base or model workspace variables

• Character vector or string scalar string for block path to parameters in the top model

• Cell array of character vectors or string scalars for model block arguments

Example: '', 'Gain1', {'top/model','sub/model'}

Version History

Introduced in R2021a

R2023b: Apply simulation support for tunable parameters

In R2023b, the stimulation-related functions start, stop, getStatus, reloadData, and pause support tunable parameters in addition to signals.