Debug Generated Code During SIL Execution
If a SIL execution fails or you notice differences between the outputs of your original functions and the generated code, you can rerun the SIL execution with a debugger enabled. By inserting breakpoints, you can observe the behavior of code sections, which might help you to understand the cause of the problem.
For a SIL execution failure, you can also view information from the standard output and standard error streams in the MATLAB® Command Window. For example:
Output from
printf
statements in your code.If you enable run-time error detection, messages sent to
stderr
.Some low-level system messages.
Note
During a SIL execution, the SIL application redirects the stdout
and stderr
streams.
When the application terminates, the MATLAB Command Window displays
the information from the redirected streams. The SIL application also
provides a basic signal handler, which captures the POSIX® signals SIGFPE
, SIGILL
, SIGABRT
,
and SIGSEV
. For this signal handler, the SIL application
includes the file signal.h
.
This table gives information about debugger support.
Operating System | Supported Debuggers |
---|---|
Windows® | Microsoft® Visual Studio® IDE. |
Visual Studio Code with MinGW® GDB. Requires installation of MATLAB Coder™ Interface for Visual Studio Code Debugging support package, which you can download from MATLAB Central™ File Exchange. | |
macOS | LLDB. |
Visual Studio Code with LLDB. Requires installation of MATLAB Coder Interface for Visual Studio Code Debugging support package, which you can download from MATLAB Central File Exchange. | |
Linux® | GNU® Data Display Debugger (DDD). |
Visual Studio Code with GDB. Requires installation of MATLAB Coder Interface for Visual Studio Code Debugging support package, which you can download from MATLAB Central File Exchange. |
Note
You can perform SIL debugging only if the MATLAB product family supports your Microsoft Visual C++®, Xcode, or GNU GCC compiler. For more information, see supported compilers.
To run a SIL execution with debugging enabled:
On the Generate Code page, click Verify Code.
Select the Enable source-level debugging for SIL check box.
Click Run Generated Code.
On a Windows computer, your
or
user_fn
.c
file opens, for
example, in the Microsoft
Visual Studio IDE with debugger breakpoints at the start of the
user_fn
.cppuser_fn
_initialize
and
user_fn
functions.
You can now use the debugger features to observe code behavior. For example, you can step through code and examine variables.
To end the debugging session:
Remove all breakpoints.
Click the Continue button (F5).
The SIL execution runs to completion.
To terminate the SIL execution process, on the Test Output tab, click the link that follows
To terminate execution
, for example,clear kalman01_sil
.The Microsoft Visual Studio IDE closes automatically.
Note
If you select Debug > Stop Debugging, the SIL execution times out with the following error message:
Communications error: failed to send data to the target. There might be multiple reasons for this failure. ... ...