Code Definition and Mapping Limitations and Considerations
If a data element in a model is unnamed (for example, a signal has no label or a state has no name), you must specify a code identifier for the data element when configuring it for C code generation. Set the code identifier by specifying a value for the storage class property Identifier.
You cannot use code mappings to configure MATLAB® variables that are used as block parameters. Convert the variables to
Simulink.Parameterobjects in the model workspace. The resulting data objects appear in the Code Mappings editor as model parameters.
Use code mappings to configure only one discrete state per block in a model.
If a model contains a tunable, nonfinite parameter, for example, with a value of
inf, the code generator does not apply a specified default parameter mapping. The parameter appears as a field in the default parameter data structure
rtP(see Real-Time Model Data Structure).:
Default Code Mapping Constraints
Default code mappings for categories External parameters and Global data stores must be the same for models throughout the model reference hierarchy.
Model Editing Operations and Individual Data Element Code Mappings
While editing a model in the context of a coder app, you should be aware of the relationship between Simulink® model editing tools, such as copy and undo, and code mappings. In the context of a coder app, when you perform copy-and-paste or cut-and-paste editing operations within a model, the coder app preserves the code mappings for individual data elements. For example, within a model, if you copy and paste the source block of a signal that is configured with a specific storage class, the pasted version of the signal port retains the same storage class.
While you can use undo and redo operations for editing actions on model data elements,
they are unavailable while configuring code mappings. For example, if you delete a state
block, and then click Undo, the block reappears in the model canvas
and the code configuration for the state reappears in the code mappings. In the Code
Mappings editor, if you change the storage class setting for a state from
Model default, and then click
Undo, the storage class does not revert to
Auto. In this case, the change pertains to the code mapping, not
to the model data element.
Storage Classes and Reentrant, Multi-Instance Models and Components
The code that you generate from a model or component (referenced model or subsystem)
is multi-instance code if it allows your application to maintain
multiple independent instances of the component during execution. For example, you can
generate reentrant, multi-instance code from an entire model by setting the model
configuration parameter Code interface packaging to
Reusable function. For general information about
multi-instance models and components, see Model Composition and Reuse.
Under some circumstances, applying storage classes can:
Prevent you from generating multi-instance code.
Cause some data elements to appear in the generated code as singletons, which means that each instance of the model or component directly accesses the same shared, global data, creating dependencies between the instances.
To avoid errors and unexpected generation of single-instance code and singleton data, observe the guidelines and limitations below.
Directly Applied Storage Classes
When you apply a storage class directly to a data element (see C Code Generation Configuration for Model Interface Elements):
To generate multi-instance code, you must apply the storage class only to parameter objects, global data stores, shared local data stores, and root-level I/O.
The storage class yields only singleton data.
Storage Classes Applied by Default
When you apply a default storage class (see C Code Generation Configuration for Model Interface Elements):
For these data categories, you can generate only singleton data:
Global data stores
Shared local data stores
For Internal data, you can generate only instance-specific data, which means each instance of the model or component operates on a separate copy of the data. For this category, you must use the example storage class
SignalStruct, which appears after preparing a model for code generation with the Quick Start tool. Alternatively, you can create and use your own structured storage class by using an Embedded Coder Dictionary.
For more information, see What Is Reentrant Code? and Choose Storage Class for Controlling Data Representation in Generated Code.
Copy Code Mappings When Converting Subsystems to Referenced Models
You can copy code mappings when you convert a subsystem to a referenced model.
In the Model Reference Conversion Advisor, select Copy code mappings.
In the MATLAB command window, use the
Simulink.SubSystem.convertToModelReferencefunction with the comma-separated pair consisting of
Mappings Editor – C |