Configure local or shared local data store for code generation
setDataStore(
configures the specified local or shared local data store for code generation. Use this
function to map a local or shared local data store to the storage class and storage class
property settings that the code generator uses to produce C code for that data store.myCodeMappingObj
,dataStore
,Name,Value
)
In the model code mappings for model
myConfigModel
, set the storage class for local data store
mode
to ExportedGlobal
.
cm = coder.mapping.api.get('myConfigModel'); setDataStore(cm,'mode','StorageClass','ExportedGlobal');
Model default
In the model code mappings for model
myConfigModel
, set the storage class for local and shared local data
stores throughout the model to Model default
.
cm = coder.mapping.api.get('myConfigModel'); dsmHandles = find(cm,'DataStores') setDataStores(cm,dsmHandles,'StorageClass','Model default');
In the model code mappings, for model
myConfigModel
, set the code identifier for local data store
mode
to ds_mode
.
cm = coder.mapping.api.get('myConfigModel'); setDataStore(cm,'mode','Identifier','ds_mode');
myCodeMappingObj
— Code mapping objectCodeMapping
objectCode mapping object (model code mappings) returned by a call to function
coder.mapping.api.get
.
Example: myCM
dataStore
— Block path, block handle, or name of data storePath of the Data Store Memory block for which to return the code mapping information, specified as a character vector or string scalar. Alternatively, you can specify a block handle or the name of the data store. If you specify the name of a data store and that name is not unique within the model, Simulink® returns an error that instructs you to specify the block path or handle. To specify multiple data stores, use an array.
Example: blockHandle
Data Types: char
| string
| block_handle
| array
Specify comma-separated pairs of Name,Value
arguments.
Name
is the argument name and Value
is the
corresponding value. Name
must appear inside quotes. You can specify
several name and value pair arguments as Name1,Value1,…,NameN,ValueN
. The
order of the name and value pair arguments does not matter.
'StorageClass'
— Name of storage classAuto
| Bitfield
| Dictionary default
| ExportedGlobal
| ExportToFile
| FileScope
| GetSet
| ImportedExtern
| ImportedExternPointer
| ImportFromFile
| Localizable
| Model default
| Struct
| Volatile
| storage class nameStorage class to set for the specified data store. The name of a predefined storage class or storage class that is defined in the Embedded Coder Dictionary associated with the model. See Configure Data Stores for C Code Generation.
'Identifier'
— Name of variableName for the variable that represents the local data store in the generated code.
Data Types: char
| string
'DefinitionFile'
— C source fileFile name for a C source file that contains definitions for global data read by
data elements and external code. Applies to storage classes
ExportToFile
and Volatile
.
Data Types: char
| string
'GetFunction'
— Name of get functionName of a get
function that a data element calls in the
generated code. Applies to storage class GetSet
.
Data Types: char
| string
'HeaderFile'
— C header fileFile name for a C header file that contains declarations for global data read by
data elements and external code. Applies to storage classes
ExportToFile
, GetSet
,
ImportFromFile
, and Volatile
.
Data Types: char
| string
'Owner'
— Owner of global dataName of the model that owns global data that is used by other models in the same
model hierarchy. The code generated for the model that owns the data includes the
global data definition. Applies to storage classes ExportToFile
and
Volatile
.
Data Types: char
| string
'PreserveDimensions'
— Boolean flag indicating whether to preserve dimensions of multidimensional arraysTrue
| False
When model configuration parameter Array layout is set to
Row-major
, a flag that indicates whether to preserve
dimensions of a data element represented in generated code as a multidimensional
array. Applies to storage classes ExportToFile
,
ImportFromFile
, Localizable
, and
Volatile
.
Data Types: logical
'SetFunction'
— Name of set functionName of a set
function that a data element calls in the
generated code. Applies to storage class GetSet
.
Data Types: char
| string
'StructName'
— Name of structureName that the code generator uses to identify the structure for a data element in
the generated code. Applies to storage classes Bitfield
and
Struct
.
Data Types: char
| string
'storageClassPropertyName'
— Value of storage class propertyStorage class property defined in the Embedded Coder Dictionary. Values that you can specify vary depending on the storage class definition.
coder.mapping.api.CodeMapping
| coder.mapping.api.get
| find
| getDataDefault
| getDataStore
| setDataDefault