setModelParameter

Configure model parameter for code and calibration file (a2l) generation

Since R2020b

Syntax

setModelParameter(myCodeMappingObj,modelParameter,Name,Value)

Description

setModelParameter(myCodeMappingObj,modelParameter,Name,Value) configures the specified model parameter for code and calibration file (a2l) generation. Use this function to map the specified model parameter 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 parameter.

Examples

Configure Storage Class for Model Parameter

In the model code mappings for model ConfigurationRapidPrototypingInterface, set the storage class for model parameter K1 to ExportedGlobal.

openExample("ConfigurationRapidPrototypingInterface");
cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface");
setModelParameter(cm,"K1",StorageClass="ExportedGlobal");

Configure Storage Class for Model Parameters in Model to Model default

In the model code mappings for model ConfigurationRapidPrototypingInterface, set the storage class for model parameters throughout the model to Model default.

openExample("ConfigurationRapidPrototypingInterface");
cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface");
paramHandles = find(cm,"ModelParameters")
setModelParameter(cm,paramHandles,StorageClass="Model default");

Configure Storage Class for Model Parameters

In the model code mappings for model ConfigurationRapidPrototypingInterface, set the storage class for model parameters Table1 and Table2 to ExportedGlobal.

openExample("ConfigurationRapidPrototypingInterface");
cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface");
setModelParameter(cm,"Table1",StorageClass="ExportedGlobal",Identifier="mp_Table1");
setModelParameter(cm,"Table2",StorageClass="ExportedGlobal",Identifier="mp_Table2");

Configure Calibration Properties for Model Parameter

From the model code mappings for model ConfigurationRapidPrototypingInterface, set the calibration properties configured for the model parameter argument LOWER.

openExample("ConfigurationRapidPrototypingInterface");
cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface");
setModelParameter(cm,"LOWER",Export=true);
setModelParameter(cm,"LOWER",CalibrationAccess="Calibration");
setModelParameter(cm,"LOWER",CompuMethod="CM_param");
setModelParameter(cm,"LOWER",DisplayIdentifier="param_lower");
setModelParameter(cm,"LOWER",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

modelParameter — Name of model parameter

character vector | string | cell array of character vectors | cell array of string scalars

Name of the model workspace parameter to configure.

Example: "Table1"

Data Types: char | string

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 model parameter. The name of a predefined storage class or storage class that is defined in the Embedded Coder Dictionary associated with the model. See Configure Parameters for C Code Generation.

Identifier — Name of variable

character vector | string scalar

Name for the variable that represents the model parameter in the generated code.

Data Types: char | string

Export — Enable or disable generation of the model parameter to calibration file (a2l)

true (default) | false

Enable this property to generate the model parameter to calibration file (a2l).

BitMask — Extract single bits from the model parameter value

hexadecimal value

Mask value in hexadecimal format to extract single bits from the model parameter during calibration. This property is applicable only for integers.

Data Types: hexadecimal

CalibrationAccess — Enable or disable calibration of the model parameter

Calibration (default) | NoCalibration

Select Calibration for the model parameter to enable the calibration. Select NoCalibration to view the value of the model parameter 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 model parameter

character vector | string scalar

Optional display name of the model parameter for measurement purpose in the calibration tool, which is different than the model parameter name in the Simulink model.

Data Types: char | string

Format — Display format of the model parameter 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 model parameter.

Version History

Introduced in R2020b