sschdl.generateOptimizedModel

Replace Simscape switches and converter blocks with dynamic switches optimized for FPGA deployment

Since R2024a

collapse all in page

    Syntax

    generatedModel = sschdl.generateOptimizedModel(input)
    generatedModel = sschdl.generateOptimizedModel(input,Name=Value)

    Description

    generatedModel = sschdl.generateOptimizedModel(input) replaces common Simscape™ switches and converter blocks with their dynamic equivalents to optimize the model for FPGA deployment. To learn more about dynamic switch replacement, see Generate HDL Code for Simscape Models by Using Dynamic Switch Approximation.

    generatedModel = sschdl.generateOptimizedModel(input,Name=Value) replaces Simscape switches or PMSM (Simscape Electrical) block with a dynamic equivalent and tunes the parameter values for the dynamic switches using one or more name-value arguments.

    The generated optimized model has the same name as input but with the suffix _generated. Once the optimized model is generated, open the model and verify the connection. Connect any gate signal inports of the replaced blocks to their respective sources and remove any additional Simulink-PS Converter (Simscape) blocks.

    example

    Examples

    collapse all

    This example uses:

    Open Script

    Open the three-phase PMSM drive model at the MATLAB® command prompt.

    ModelName = 'sschdlexThreePhasePMSMDrive';
open_system(ModelName)

    Open the Three-phase inverter subsystem that contains Simscape blocks.

    open_system([ModelName '/Three-phase inverter'])

    To optimize the model for FPGA deployment, run the sschdl.generateOptimizedModel function at the MATLAB command prompt.

    generatedModel = sschdl.generateOptimizedModel('sschdlexThreePhasePMSMDrive',ReplaceSwitches=1,ReplacePMSM=0);

    The following blocks have been replaced: 
'sschdlexThreePhasePMSMDrive/Three-phase inverter/IGBT A(H)'
'sschdlexThreePhasePMSMDrive/Three-phase inverter/IGBT A(L)'
'sschdlexThreePhasePMSMDrive/Three-phase inverter/IGBT B(H)'
'sschdlexThreePhasePMSMDrive/Three-phase inverter/IGBT B(L)'
'sschdlexThreePhasePMSMDrive/Three-phase inverter/IGBT C(H)'
'sschdlexThreePhasePMSMDrive/Three-phase inverter/IGBT C(L)'

Saving sschdlexThreePhasePMSMDrive as sschdlexThreePhasePMSMDrive_generated and replacing switch and converter blocks with equivalent FPGA HIL supported blocks.

    The generated optimized model for the three-phase PMSM drive model is saved as sschdlexThreePhasePMSMDrive_generated. In this model, the Three-phase inverter subsystem contains the replaced blocks.

    Input Arguments

    collapse all

    Simscape model name or a cell array of Solver Configuration (Simscape) block paths, specified as a character vector or string scalar, or a cell array of character vectors or string scalars. You can specify a Solver Configuration block attached to the Simscape network that you want to optimize within the model.

    Data Types: char | string | cell

    Name-Value Arguments

    collapse all

    Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

    Example: generatedModel = sschdl.generateOptimizedModel("sschdlexThreePhasePMSMDrive",ReplaceSwitches=1,ReplacePMSM=0);

    Example: generatedModel = sschdl.generateOptimizedModel("sschdlexTwoPhaseDCDCConverterExample",AveragedSwitch=1);

    Example: generatedModel = sschdl.generateOptimizedModel("sschdlexHalfWaveRectifierExample",FineTune=true);

    Since R2024b

    Option to replace Simscape switches in the model, specified as numeric or logical 1 (true) or 0 (false).

    Data Types: logical

    Since R2024b

    Option to replace Simscape PMSM (Simscape Electrical) block in the model, specified as numeric or logical 1 (true) or 0 (false). On replacement of the Simscape PMSM block with an equivalent optimized PMSM block, the Simscape network splits and a secondary Solver Configuration (Simscape) block is automatically added and connected.

    The sschdl.generateOptimizedModel function generates an optimized PMSM block with the initial conditions computed for the original Simscape model. You can check the initial conditions of the Simscape PMSM block by using the Configure the Variable Viewer (Simscape). To open the Variable Viewer, in the model window, on the Debug tab, click Simscape > Variable Viewer.

    The sschdl.generateOptimizedModel function automatically sets initial conditions for the optimized PMSM block based on the original Simscape model. If you tune the run-time parameters in the generated optimized model, rerun the sschdl.generateOptimizedModel function to generate optimized PMSM block with updated initial conditions.

    Data Types: logical

    Since R2024b

    Option to replace all Simscape switches in the model with the dynamic equivalents of Averaged Switch, specified as numeric or logical 1 (true) or 0 (false).

    Data Types: logical

    Since R2026a

    Option to enable fine-tuning of the parameter values for dynamic switches in the generated optimized model, specified as numeric or logical 1 (true) or 0 (false).

    Dependencies

    To fine-tune the parameter values for the dynamic switches, you require a Simulink® Design Optimization™ toolbox license.

    Data Types: logical

    Output Arguments

    collapse all

    Path of the generated model that is optimized for HDL code generation, returned as a structure array.

    In the generated optimized model, when you double-click any dynamic switch block, the parameter values of block parameters Conductance and Time scaling are set to Gs and s respectively, and are configured by using a Simulink.Parameter object. The values Gs and s are stored in the base workspace and referenced from the block.

    Limitations

    Version History

    Introduced in R2024a

    expand all

    See Also

    |

    Topics