etrace

Configure simulation debugging session to display information when entering and exiting methods

Syntax

etrace lvl

Description

etrace lvl configures method tracing for certain methods according to the value you specify for lvl. You can configure a simulation debugging session to trace:

• No methods

• Model methods

• Model and system methods

• Model, block, and system methods

The simulation debugging session displays information each time the simulation enters or exits a traced method. The information displayed includes the current simulation time, whether the simulation entered or exited the method, the method name, the method ID, and the name of the model, system, or block to which the method belongs.

• When you start the simulation debugging session programmatically, the information is displayed in the MATLAB^® Command Window.

• When you start the simulation debugging session using the Simulink^® Editor, the information is displayed in the Diagnostic Viewer.

You can use this function in a simulation debugging session started:

• Interactively, using the Simulink Toolstrip

• Programmatically, using the sldebug function

• Programmatically, using the sim function with the 'debug' name-value argument

Note

This function is available only for simulation debugging sessions started programmatically and for interactive simulation debugging sessions while paused within a time step.

Input Arguments

lvl — Methods to trace

0 | 1 | 2 | 3

Methods to trace, specified as one of these options:

• 0 — No methods

• 1 — Model methods

• 2 — Model and system methods

• 3 — Model, system, and block methods

Tips

To start a simulation debugging session interactively, add one or more breakpoints to your model, and in the Breakpoints List, check that Pause within time step is selected. When the simulation pauses on a breakpoint, some of the programmatic debugging commands, such as the stop command, are available for use in the MATLAB Command Window.

Version History

Introduced before R2006a

R2024a: sldebug prompt in MATLAB Command Window indicates when simulation debugging session is paused within time step

When you start a simulation debugging session using the Simulink Editor, you can issue some programmatic simulation debugging commands, such as probe or stop, while the simulation is paused within a time step. The sldebug command prompt (sldebug>>) now replaces the MATLAB command prompt (>>) to indicate in the MATLAB Command Window when the simulation is paused within a time step. As in prior releases, you can issue both MATLAB commands and the supported simulation debugging commands at the sldebug command prompt.

For more information, see Simulink Debugging Programmatic Interface.