start

Start stimulation of root inports of model on target computer

Since R2021a

Syntax

start(target_object.Stimulation,inports)

start(target_object.Stimulation,playbacks)

start(target_object.Stimulation,'all')

start(target_object.Stimulation,blockPath)

Description

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

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

start(target_object.Stimulation,'all') starts the stimulation of all root inports of the model and Playback blocks in the model running on the target computer.

start(target_object.Stimulation,blockPath) starts the stimulation for tunable parameter specified by the block path. The function uses the currently active XCP page.

Examples

Start Stimulation of Specific Inports

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

start(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:
%
% start(tg.Stimulation,[1,3]);

Start Stimulation of Specific Playback Blocks

In a model with five Playback blocks, start the stimulation of Playback blocks named playThis and playThat.

start(tg.Stimulation,{'playThis','playThat'});

Start Stimulation of All Inports

In a model with five inports, start the stimulation of all inports.

start(tg.Stimulation,'all');

Start Stimulation of Specific Tunable Parameters

In a model with tunable parameters, start 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.

start(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.