Generate Code and Executables for Individual Subsystems - MATLAB & Simulink (original) (raw)

• Documentation
• Examples
• Functions
• Blocks
• Model Settings
• Apps
• Videos
• Answers

Main Content

You can generate code and build a standalone executable for a subsystem within a model. When you generate code for an individual subsystem, the code generation and build process uses the code generation and build parameters of the root model.

1. Open a model with a subsystem, such as SubsystemAtomic.
   openExample('SubsystemAtomic')
   
2. Open Simulink® Coder™ or Embedded Coder®.
   If you are using Embedded Coder, from the tab, click View Code to open the Code View editor.
3. Right-click the Subsystem block. From the context menu, click . From the Block Parameters: SS1 window, open the Code Generation tab.
4. Use the Function name options and File name options parameters to control the names of the generated functions and files. Set the Function name options parameter to Auto so that the code generator uses the name of the subsystem in the generated file names.
5. Right-click the Subsystem block. From the context menu, select .
6. To configure properties such as the name, class, and storage class of variables (or data objects) that are referenced as block parameters in the subsystem, convert the subsystem to a Model block. Configure the properties through the Code Mappings editor.
   For more information on tunable and inlined parameters and storage classes, see Create Tunable Calibration Parameter in the Generated Code.
   The build process displays status messages in the MATLAB® Command Window. When the build is complete, the generated executable is in your working folder. The name of the generated executable is_`subsystem`_.exe (on PC platforms) or_`subsystem`_ (on The Open Group UNIX® platforms). _`subsystem`_ is the name of the source Subsystem block. In this example, theSubsystem block is named SS1.
   The generated code is in a build subfolder named_`subsystem`__ _`target`__rtw._`subsystem`_ is the name of the source subsystem block and _`target`_ is the name of the target configuration.

Subsystem Build Limitations

These limitations apply to building subsystems:

• You cannot use a subsystem build for a model configured with an ERT-based system target file and service code interface.
• A subsystem build does not support a subsystem that has a function-call trigger input or a function-call output.
• When you build a subsystem that includes an Outport block for which the Data type parameter specifies a bus object, you must address errors that result from setting signal labels. To configure the software to display these errors, in the Configuration Parameters dialog box for the parent model, on the > pane, set the Signal label mismatch parameter toerror.
• When building a subsystem, the code generator inserts traceability tags for root-level Inport and Outport blocks in place of subsystem Inport and Outport blocks, which are virtual (see Nonvirtual and Virtual Blocks). For instance:
  /* Outport: '/Out1' incorporates:
  • Inport: '/In1'
    However, you cannot trace these root-level tags to the Inport and Outport blocks of the root-level model.
• When a subsystem is in a triggered or function-call subsystem, the right-click build process might fail if the subsystem code is not sample-time independent. To determine whether a subsystem is sample-time independent:
  1. Copy all blocks in the subsystem to an empty model.
  2. In the Configuration Parameters dialog box, on the pane, set:
     1. Type to Fixed-step.
     2. Periodic sample time constraint toEnsure sample time independent.
     3. Click Apply.
  3. Update the model. If the model is sample-time dependent, Simulink generates an error in the process of updating the diagram.
• When you use the right-click build process for a subsystem, the code generator attempts to use the subsystem name for generated code files. In some cases, there can be a conflict with the name that you specify when you set, for example, File name options to Use function name orFunction name options to Use subsystem name. You see an error:
  The subsystem 'model/subsys'
  is trying to generate code to an reserved file (subsys) for
  the model 'subsys'...
  To resolve the error, modify one of the conflicting file names so that the names are unique.
• During a subsystem build, the subsystem block might be referenced as a temporary model name. If there is a build warning or error, the message displayed in the Diagnostic Viewer might reference the name of the temporary model and provide a subsystem block path hyperlink to that temporary model. Clicking the hyperlink does not take you to the block. In the Command Window, you see a message:
  ...
  No system or file called 'subsystemName' found.
  ...

See Also

Topics

• Generate Predictable Function Interface to Match Graphical Block Interface
• Generate Subsystem Code as Separate Function and Files
• Modeling Guidelines for Subsystems