Software-in-the-Loop Execution From Command Line

Use software-in-the-loop (SIL) execution to verify the numerical behavior of the generated C/C++ code with reference to your original MATLAB^® functions.

To set up and start a SIL execution from the command line:

Create a coder.EmbeddedCodeConfig object.
Configure the object for SIL.
Use the codegen function to generate library code for your MATLAB function and the SIL interface.
Use the coder.runTest function to run the test file for your original MATLAB function.

To terminate the SIL execution, use the clear function_sil or clear mex command.

The following example shows how you can set up and run a SIL execution from the command line.

SIL Execution of Code Generated for a Kalman Estimator

Copy MATLAB code for Kalman estimator
From docroot\toolbox\coder\examples\kalman, copy the following files to your working folder:
- kalman01.m — MATLAB function for the Kalman estimator
- test01_ui.m — MATLAB file to test kalman01.m
- plot_trajectory.m — File that plots actual target trajectory and Kalman estimator output
- position.mat — Input data
src_dir = ... fullfile(docroot,'toolbox','coder','examples','kalman'); copyfile(fullfile(src_dir,'kalman01.m'), '.') copyfile(fullfile(src_dir,'test01_ui.m'), '.') copyfile(fullfile(src_dir,'plot_trajectory.m'), '.') copyfile(fullfile(src_dir,'position.mat'), '.')
For a description of the Kalman estimator in this example, see Generate C Code at the Command Line.

Configure SIL execution

Generate code and run SIL execution
Generate library code for the kalman01 MATLAB function and the SIL interface, and run the MATLAB test file, test01_ui. The test file uses kalman01_sil, the generated SIL interface for kalman01.
codegen -config config -args {zeros(2,1)} kalman01 -test test01_ui
The software creates the following output folders:
- codegen\lib\kalman01 — Standalone code for kalman01.
- codegen\lib\kalman01\sil — SIL interface code for kalman01.
Verify that the output of this run matches the output from the original kalman01.m function.
Note
On a Windows^® operating system, the Windows Firewall can potentially block a SIL or PIL execution. To allow the execution, use the Windows Security Alert dialog box. For example, in Windows 7, click Allow access.
Debug code during SIL execution
If you enable the Microsoft Visual Studio debugger, then running the test file opens the Microsoft Visual Studio IDE with debugger breakpoints at the start of the kalman01_initialize and kalman01 functions.
You can use the debugger features to observe code behavior. For example, you can step through code and examine variables.
To end the debugging session:
1. Remove all breakpoints.
2. Click the Continue button (F5).
  The SIL execution runs to completion.
Terminate SIL execution
Terminate the SIL execution process.
clear kalman01_sil;
You can also use the command clear mex, which clears MEX functions from memory.

Note

Suppose that the MATLAB current working directory (the folder that pwd displays) is a UNC path (for example, \\server\a\b\c) on a Windows platform. If you launch a SIL executable from this path, the location where the SIL executable is launched can be unpredictable and different from the MATLAB current working directory (for example, C:\Windows).

To fix this issue, use a mapped network drive for the UNC path as your MATLAB current working directory.

Related Examples

More About

Code Verification Through Software-in-the-Loop and Processor-in-the-Loop Execution

Documentation