If you have an HDL Coder™ license, you can generate HDL code from your Simscape™ model for deployment onto FPGA platforms using the Simscape HDL Workflow Advisor. The Simscape HDL Workflow Advisor generates a Simulink® implementation of your Simscape model then converts the Simulink model to HDL code using HDL Coder. Converting your Simscape model to HDL code allows you to:
Accelerate the simulation of physical systems by using an optimized implementation of Simscape models
Rapidly prototype models using the reconfigurability and parallelism capabilities of the FPGA
Simulate the HDL implementation in real time using hardware-in-the-loop (HIL) simulation
Convert a Simscape model to HDL code using the Simscape HDL Workflow Advisor by following these steps.
Generate baseline results for your Simscape model.
Ensure that the model contains only linear or switched linear blocks by
using the simscape.findNonlinearBlocks
function.
Ensure that the simulation results of the model match the baseline results.
Configure the Simscape network for real-time simulation and HDL code generation:
Add blocks that allow you to monitor the progress of the HDL workflow in terms of simulation time.
Display sample time information.
Configure the Simscape network for fixed-step, fixed-cost simulation.
Ensure that simulation results of the discrete model match the baseline results.
Run the Simscape HDL Workflow Advisor tasks by using the sschdladvisor
(HDL Coder) function. The HDL Workflow Advisor:
Checks for HDL code generation compatibility by ensuring that the model contains only linear and switched linear blocks and is configured for real-time simulation.
Extracts state-space coefficients for the Simscape network.
Generates an HDL code generation-compatible implementation of the Simscape network.
Ensure that simulation results from the HDL code generation-compatible implementation match the baseline results.
Generate the HDL code:
Run the hdlsetup
(HDL Coder)
function. The hdlsetup
function configures
the fixed-step solver for HDL code generation and specifies the
simulation start and stop times.
Save the model parameters and validation model generation settings.
Generate code using the makehdl
function.
Before running the Simscape HDL Workflow Advisor, configure your network to exclude:
Events
Mode charts
Delays
Enabled run time parameters
Periodic sources
Nonlinearities that result from network connectivity—If your model does
contain a nonlinearity of this sort, the sschdladvisor
function may run all tasks to completion, but generates a zero-value
output.
This example shows how to convert your Simscape model to HDL code using the Simscape HDL Workflow Advisor. To configure your Simscape network and Simulink model for real-time simulation and HDL code generation, see Model Preparation. To open a version of the model that is already prepared for using the Simscape HDL Workflow Advisor, see Generate HDL Code by Using the Simscape HDL Workflow Advisor.
To prepare your Simscape model for FPGA deployment:
Open the ssc_bridge_rectifier
model and show hidden
block names. At the MATLAB® command prompt,
enter
baselineModel = 'ssc_bridge_rectifier'; load_system(baselineModel) set_param(baselineModel,'HideAutomaticNames','off') open_system(baselineModel)
To compare the baseline simulation results to subsequent iterations, remove the data point limitation on the Scope block labeled Load Voltage scope block and capture the signal that inputs data to the Scope block by enabling data logging to the Simulation Data Inspector for the .
Open the Scope block. Click View > Configuration Properties. On the Logging tab, clear Limit data points to last.
Right-click the connection to the Scope
block and select Log selected
signals
. The logging badge
appears above the
signal.
Simulate the model and view the results in the Simulation Data Inspector.
%% Simulate baseline model sim(baselineModel) %% Get Simulation Data Inspector run IDs for runIDs = Simulink.sdi.getAllRunIDs; runID = runIDs(end); run = Simulink.sdi.getRun(runID); signal1 = run.getSignalByIndex(1); % run.signalCount signal1.checked = true; Simulink.sdi.view
As needed, press the spacebar on your keyboard to fit the Simulation Data Inspector plot to view.
The baseline simulation returns the expected results for the full-wave bridge rectifier load voltage.
Before running the advisor, identify and replace blocks that cause
your network to be nonlinear. To identify the blocks, use the
simcape.findNonlearBlocks
function.
simscape.findNonlinearBlocks(baselineModel)
Found network that contains nonlinear equations in the following blocks: 'ssc_bridge_rectifier/AC Voltage Source' The number of linear or switched linear networks in the model is 0. The number of nonlinear networks in the model is 1. ans = 1×1 cell array {'ssc_bridge_rectifier/AC Voltage Source'}
The model contains an AC Voltage Source block, a periodic source that yields nonlinear equations.
You can replace the periodic source with a Controlled Voltage Source block in the Simscape network with a Sine Wave block outside the network.
Delete the AC Voltage Source block.
Add a Sine Wave block from the Simulink > Sources library.
Add a Simulink-PS Converter block from the Simscape > Utilities library.
Add a Controlled Voltage Source block from the SimscapeFoundation LibraryElectricalElectrical Sources library.
Connect the Sine Wave block to the Simulink-PS Converter block and the Simulink-PS Converter block to the Controlled Voltage Source block.
Configure the Sine Wave block to match the parameters of the AC Voltage Source block that you removed.
Set the Amplitude parameter to
sqrt(2)*120
.
Set the Frequency (rad/sec) parameter
to 60*2*pi
.
Set the Sample time parameter to
1e-5
. Then click the three-dots icon next to the
Sample time box, and select
Create variable. Name the
variable
Ts
and click
Create. You can now view and edit
this variable in you workspace.
Ensure that there are no blocks that cause your network to be nonlinear.
% Simulate sim(baselineModel) % Check for nonlinear blocks simscape.findNonlinearBlocks(baselineModel)
The number of linear or switched linear networks in the model is 1. ans = 0×0 empty cell array
The model contains only blocks that yield linear or switched linear equations.
Simulate the model and compare the results to the baseline results in the Simulation Data Inspector.
% Get Simulation Data Inspector run IDs runIDs = Simulink.sdi.getAllRunIDs; runBaseline = runIDs(end - 1); runSwitchedLinear = runIDs(end); % Open the Simulation Data Inspector Simulink.sdi.view compBaseline1 = Simulink.sdi.compareRuns(runBaseline,... runSwitchedLinear);
The results are similar to the baseline results.
To perform future progress checks for the Simscape HDL Workflow Advisor, add and connect a Digital
Clock block from the Simulink > Sources library and a Display block from the
SimulinkSinks library,
as shown in the figure. For the Digital Clock, set the
Sample time parameter to
Ts
.
The model is stil set to use a variable-step solver. For real time-simulation, you must use a fixed-step solver. Use the sample time colors and annotations to help you to determine if your model contains any continuous settings. To turn on sample time colors and annotations, on the Debug tab, click Information Overlays, and in the Sample Time group, select Colors and Text.
The model diagram updates and the Timing Legend pane displays.
Configure the model for real-time simulation.
Configure the Simulink model for fixed-step, fixed-cost simulation. In the Configuration Parameters window, click Solver and set:
Type to
Fixed-step
Solver to
discrete (no continuous
states)
Configure the Simscape network for fixed-step, fixed-cost simulation. For the Solver Configuration block:
Select Use local solver.
Ensure that Solver type is
set to Backward
Euler
.
Specify Ts
for the
Sample time.
Simulate the model and compare the results to the baseline results in the Simulation Data Inspector.
% Simulate sim(baselineModel) % Get Simulation Data Inspector run IDs runIDs = Simulink.sdi.getAllRunIDs; runBaseline = runIDs(end - 2); runRealTime = runIDs(end); % Open the Simulation Data Inspector Simulink.sdi.view compBaseline1 = Simulink.sdi.compareRuns(runBaseline,... runRealTime);
The results are similar to the baseline results.
Generate HDL code by running the Simscape HDL Workflow Advisor either on the Simscape model that you prepared in the Model Preparation section or by
opening the ssc_bridge_rectifier_hdl
model, which is prepared for
code generation.
Rename the model.
If you prepared the model in the Model Preparation section,
rename the model ssc_model
.
To open and use a model that is already prepared for HDL code generation, at the MATLAB command prompt, enter
open_system('ssc_bridge_rectifier_hdl')
Save the model to a local directory as
ssc_model
.
Run the Simscape HDL Workflow Advisor.
sschdladvisor('ssc_model')
The Simscape HDL Workflow Advisor opens.
Run the code generation compatibility checks.
Select Code generation compatibility > Check solver configuration , then click Run This Task.
Select Check model compatibility, then click Run this task.
The advisor reports when the model passes these checks.
Extract the state-space coefficients. Select State-space conversion and click Run All. The conversion can take some time.
After running the task, the advisor displays a summary of the state-space representation and a table of parameters.
Number of states: 5
Number of inputs: 1
Number of outputs: 1
Number of modes: 7
Number of differential variables: 1
Discrete sample time: 1e-05
Parameter | Parameter size |
A | 5 x 5 x 7 |
B | 5 x 1 x 7 |
F0 | 5 x 1 x 7 |
C | 1 x 5 x 1 |
D | 1 x 1 x 1 |
Y0 | 1 x 1 x 1 |
The size of the state, mode, and parameter data helps you estimate how much of the FPGA resources are required to deploy the model. The higher the values, the more FPGA resources are required. The input and output data indicate the number and type of I/O connections needed for real-time deployment and visualization.
Generate an HDL implementation of your model. Select Implementation model generation > Generate implementation model and click Run this task.
When the Simscape HDL Workflow Advisor generates the implementation model,
the advisor reports that the task passed and displays a link to the
generated implementation model, which is named
gmStateSpaceHDL_ssc_model
.
Open the generated implementation model by clicking gmStateSpaceHDL_ssc_model.
The model contains blocks from the original model as well as new blocks that support the HDL Workflow Advisor:
Digital Clock, Display, Sine Wave, and Load Voltage—Remnants from your original model
Rate Transition1 — Handles the transfer of data between blocks operating at different rates.
Data Type Conversion1, Data Type Conversion2 — Converts between double and single precision data types. HDL code generation requires single-precision data
HDL Subsystem —Contains an HDL code generation-compatible version of your Simscape network.
Load Voltage — Scope block that displays the load voltage.
Prepare the implementation model for a simulation comparison to the baseline results:
You can adjust the automatically generated model and delete vestigial blocks as necessary to improve model cleanliness. The Digial Clock block and the Display block are unnecessary but will not inhibit the simulation results.
Right-click the input signal to the Scope block and click Log Selected Signals.
The Display block in the model window shows the elapsed simulation time.
To ensure that the HDL subsystem corresponds to your original Simscape model, simulate the model and compare the results to the baseline simulation results.
% Simulate sim('gmStateSpaceHDL_ssc_model') % Get Simulation Data Inspector run IDs runIDs = Simulink.sdi.getAllRunIDs; runBaseline = runIDs(end - 3); runHDLImplementation = runIDs(end); % Open the Simulation Data Inspector Simulink.sdi.view compBaseline1 = Simulink.sdi.compareRuns(runBaseline,... runHDLImplementation);
The results are similar to the baseline results. The Simscape model is compatible with HDL code generation.
Generate HDL code from the implementation:
Access the Configuration Parameters window from the HDL implementation model. Expand HDL Code Generation and select Report. Check the boxes for the Generate traceability report and Generate resource utilization report options.
Run the hdlsetup
function.
hdlsetup('gmStateSpaceHDL_ssc_model')
Save the model and subsystem parameter settings.
hdlsaveparams('gmStateSpaceHDL_ssc_model');
%% Set Model 'gmStateSpaceHDL_ssc_model' HDL parameters hdlset_param('gmStateSpaceHDL_ssc_model', 'FloatingPointTargetConfiguration', hdlcoder.createFloatingPointTargetConfig('NativeFloatingPoint' ... , 'LatencyStrategy', 'MIN') ... ); hdlset_param('gmStateSpaceHDL_ssc_model', 'HDLSubsystem', 'gmStateSpaceHDL_ssc_model/HDL Subsystem'); hdlset_param('gmStateSpaceHDL_ssc_model', 'MaskParameterAsGeneric', 'on'); hdlset_param('gmStateSpaceHDL_ssc_model', 'Oversampling', 49); % Set SubSystem HDL parameters hdlset_param('gmStateSpaceHDL_ssc_model/HDL Subsystem', 'FlattenHierarchy', 'on'); hdlset_param('gmStateSpaceHDL_ssc_model/HDL Subsystem/HDL Algorithm/Mode Selection/Generate Mode Vector', 'Architecture', 'MATLAB Datapath'); % Set SubSystem HDL parameters hdlset_param('gmStateSpaceHDL_ssc_model/HDL Subsystem/HDL Algorithm/State Update/Multiply State', 'SharingFactor', 1);
Save the validation model generation settings.
HDLmodelname = 'gmStateSpaceHDL_ssc_model'; hdlset_param(HDLmodelname, 'GenerateValidationModel', 'on');
Generate HDL code.
makehdl('gmStateSpaceHDL_ssc_model/HDL Subsystem')
### Generating HDL for 'gmStateSpaceHDL_ssc_model/HDL Subsystem'. ### Using the config set for model gmStateSpaceHDL_ssc_model for HDL code generation parameters. ### Running HDL checks on the model 'gmStateSpaceHDL_ssc_model'. ### Begin compilation of the model 'gmStateSpaceHDL_ssc_model'... ### Applying HDL optimizations on the model 'gmStateSpaceHDL_ssc_model'... ### The code generation and optimization options you have chosen have introduced additional pipeline delays. ### The delay balancing feature has automatically inserted matching delays for compensation. ### The DUT requires an initial pipeline setup latency. Each output port experiences these additional delays. ### Output port 1: 1 cycles. ### Begin model generation. ### Model generation complete. ### Clock-rate pipelining results can be diagnosed by running this script: hdlsrc\gmStateSpaceHDL_ssc_model\highlightClockRatePipelining.m ### To clear highlighting, click the following MATLAB script: hdlsrc\gmStateSpaceHDL_ssc_model\clearhighlighting.m ### Generating new validation model: gm_gmStateSpaceHDL_ssc_model_vnl. ### Validation model generation complete. ### Begin VHDL Code Generation for 'gmStateSpaceHDL_ssc_model'. ### MESSAGE: The design requires 49 times faster clock with respect to the base rate = 3.33333e-06. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem/HDL Algorithm/Mode Selection/State Mode Vector To Index/Subsystem7 as ... hdlsrc\gmStateSpaceHDL_ssc_model\Subsystem1.vhd. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem/HDL Algorithm/Mode Selection/State Mode Vector To Index/Subsystem6 as ... hdlsrc\gmStateSpaceHDL_ssc_model\Subsystem1_block.vhd. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem/HDL Algorithm/Mode Selection/State Mode Vector To Index/Subsystem5 as ... hdlsrc\gmStateSpaceHDL_ssc_model\Subsystem1_block1.vhd. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem/HDL Algorithm/Mode Selection/State Mode Vector To Index/Subsystem4 as ... hdlsrc\gmStateSpaceHDL_ssc_model\Subsystem1_block2.vhd. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem/HDL Algorithm/Mode Selection/State Mode Vector To Index/Subsystem3 as ... hdlsrc\gmStateSpaceHDL_ssc_model\Subsystem1_block3.vhd. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem/HDL Algorithm/Mode Selection/State Mode Vector To Index/Subsystem2 as ... hdlsrc\gmStateSpaceHDL_ssc_model\Subsystem1_block4.vhd. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem/HDL Algorithm/Mode Selection/State Mode Vector To Index/Subsystem1 as ... hdlsrc\gmStateSpaceHDL_ssc_model\Subsystem1_block5.vhd. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem/nfp_mul_single as hdlsrc\gmStateSpaceHDL_ssc_model\nfp_mul_single.vhd. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem/nfp_add_single as hdlsrc\gmStateSpaceHDL_ssc_model\nfp_add_single.vhd. ### Working on dot_product_2 as hdlsrc\gmStateSpaceHDL_ssc_model\dot_product_2.vhd. ### Working on dot_product_1 as hdlsrc\gmStateSpaceHDL_ssc_model\dot_product_1.vhd. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem/nfp_uminus_single as hdlsrc\gmStateSpaceHDL_ssc_model\nfp_uminus_single.vhd. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem/nfp_relop_single as hdlsrc\gmStateSpaceHDL_ssc_model\nfp_relop_single.vhd. ### Working on HDL Subsystem_tc as hdlsrc\gmStateSpaceHDL_ssc_model\HDL_Subsystem_tc.vhd. ### Working on gmStateSpaceHDL_ssc_model/HDL Subsystem as hdlsrc\gmStateSpaceHDL_ssc_model\HDL_Subsystem.vhd. ### Generating package file hdlsrc\gmStateSpaceHDL_ssc_model\HDL_Subsystem_pkg.vhd. ### Code Generation for 'gmStateSpaceHDL_ssc_model' completed. ### Creating HDL Code Generation Check Report HDL_Subsystem_report.html ### HDL check for 'gmStateSpaceHDL_ssc_model' complete with 0 errors, 7 warnings, and 2 messages. ### HDL code generation complete.
The HDL code generation report opens and includes any generated errors or warnings. The report includes a link to the resource utilization report, which describes the resource requirements for FPGA deployment.
The generated HDL code and validation model are saved in the
hdlsrc\gmStateSpaceHDL_ssc_model\html
directory. The
generated code is saved as HDL_Subsystem_tc.vhd
.
To generate HDL code for deployment to a specified target, use the HDL Workflow Advisor.
simscape.findNonlinearBlocks
| hdladvisor
(HDL Coder) | hdlsaveparams
(HDL Coder) | hdlset_param
(HDL Coder) | hdlsetup
(HDL Coder) | makehdl
(HDL Coder) | sschdladvisor
(HDL Coder)