setState
Configure block states for code and calibration file (a2l) generation
Since R2020b
Description
setState(
configures specified block states for code and calibration file (a2l) generation. Use this
function to map specified block states to the storage class and storage class property
settings that the code generator uses to produce C code. Or, set the calibration access for
the for the states.myCodeMappingObj
,block
,Name,Value
)
Examples
Configure Storage Class for Block State
In the model code mappings for model
ConfigurationRapidPrototypingInterface
, set the storage class for the
state X
of Unit Delay block Delay
to
ExportedGlobal
.
openExample("ConfigurationRapidPrototypingInterface"); cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface"); setState(cm,"ConfigurationRapidPrototypingInterface/Delay",StorageClass="ExportedGlobal");
Configure Storage Class for Block States in Model to Model default
In the model code mappings for model
ConfigurationRapidPrototypingInterface
, configure the storage class
for block states throughout the model to Model default
.
openExample("ConfigurationRapidPrototypingInterface"); cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface"); blockHandles = find(cm,"States"); setState(cm,blockHandles,StorageClass="Model default");
Configure Code Identifier for Block State
In the model code mappings for model
ConfigurationRapidPrototypingInterface
, configure the code identifier
for the state X
of Unit Delay block
Delay
to dstate_X
.
openExample("ConfigurationRapidPrototypingInterface"); cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface"); blockHandles = find(cm,"States"); setState(cm,blockHandles,StorageClass="Model default"); setState(cm,blockHandles,Identifier="dstate_X");
Configure Calibration Properties for State of Unit Delay Block
From the model code mappings for model
ConfigurationRapidPrototypingInterface
, set the calibration
properties configured for state X
of Unit Delay block
Delay
.
openExample("ConfigurationRapidPrototypingInterface"); cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface"); state = find(cm,"State"); setState(cm,state,Export=true); setState(cm,state,CalibrationAccess="Calibration"); setState(cm,state,CompuMethod="CM_state"); setState(cm,state,DisplayIdentifier="state_X"); setState(cm,state,Format="%4.2");
Input Arguments
myCodeMappingObj
— Code mapping object
CodeMapping
object
Code mapping object (model code mappings) returned by a call to function
coder.mapping.api.get
.
Example: myCM
block
— Path or handle of block
character vector | string scalar | block handle | cell array of character vectors | cell array of string scalars | cell array of block handles
Path or handle of the block containing the state to configure. To specify multiple block states, use a cell array.
Example: blockHandle
Data Types: char
| string
| block_handle
| cell
Name-Value Arguments
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.
Before R2021a, use commas to separate each name and value, and enclose
Name
in quotes.
Example: StorageClass="ExportedGlobal"
StorageClass
— Name of storage class
Auto
| Dictionary default
| ExportedGlobal
| ImportedExtern
| ImportedExternPointer
| Model default
Storage class to set for the specified block state. The name of a predefined storage class or storage class that is defined in the Embedded Coder Dictionary associated with the model. See Configure Block States for C Code Generation.
Identifier
— Name of variable
character vector | string scalar
Name for the variable that represents the block state in the generated code.
Data Types: char
| string
Export
— Enable or disable generation of the block state to calibration file (a2l)
true
(default) | false
Enable this property to generate the block state to calibration file (a2l).
BitMask
— Extract single bits from the block state value
hexadecimal value
Mask value in hexadecimal format to extract single bits from the block state during calibration. This property is applicable only for integers.
Data Types: hexadecimal
CalibrationAccess
— Enable or disable calibration of the block state
NoCalibration
(default) | Calibration
Select Calibration
for the block state to enable the
calibration. Select NoCalibration
to view the value of the block
state and disable the calibration.
CompuMethod
— Name of conversion method
character vector | string scalar
Name of the method for converting the ECU-internal value to a physical value for easy readability.
Data Types: char
| string
DisplayIdentifier
— Display name of the block state
character vector | string scalar
Optional display name of the block state for the measurement purpose in the calibration tool, which is different than the block state name in the Simulink model.
Data Types: char
| string
Format
— Display format of the block state value
%[length].[layout]
Special display format to be specified for measurement in the calibration tool.
This format specification overrules the display format specified in
CompuMethod
of the state.
Version History
Introduced in R2020b
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)