Main Content

start

Start execution of real-time application on target computer

Description

example

start(target_object,Name-Value Pair Arguments) starts execution of the real-time application that is loaded on the target computer, which is represented by the target_object. Before using this method, you must create and load the real-time application on the target computer. If a real-time application is running, issuing a start command generates an error.

You can also start the real-time application from the RTOS command line. For more information, see Execute Target Computer RTOS Commands at Target Computer Command Line and Target Computer Command-Line Interface.

Examples

collapse all

Start execution of the real-time application that is loaded on the target computer, which is represented by the target object tg.

tg = slrealtime('TargetPC1');
load(tg, 'my_xpctank');
start(tg);

Input Arguments

collapse all

Provides access to methods that manipulate the target computer properties.

Example: tg

Name-Value Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: start(tg,'LogLevel','info')

Selects filtering level that limits Simulink® Real-Time™ target computer system messages that appear in the system log. For more information, see Simulink Real-Time Options Pane.

Example: start(tg,'LogLevel','info')

The real-time application is clocked by a timer interrupt, unless the base sample rate is equal to or below the polling threshold (default is 100 μs). If the base sample rate is less than or equal to the threshold, the real-time application is clocked in polling mode.

Example: start(tg,'PollingThreshold',100)

Select the number of file logs to retain when logs are stored on the target computer instead of uploaded to the development computer after each simulation run.

Example: start(tg,'FileLogMaxRuns',1)

Select stop time value for the real-time application.

Example: start(tg,'StopTime',Inf)

Direct Simulink Real-Time to reload the real-time application on the target computer after the application stops.

Example: start(tg,'ReloadOnStop',false)

Select whether the file log data is uploaded the Simulation Data Inspector on the development computer after the real-time application stops.

Example: start(tg,'AutoImportFileLog',true)

Select whether the file log data is uploaded the Simulink base workspace on the development computer after the real-time application stops

Example: start(tg,'ExportToBaseWorkspace',true)

Introduced in R2020b