getDataStore
Get code and calibration configuration from code mappings for local or shared local data store
Since R2020b
Description
returns the value of a code mapping property or calibration property for the specified local
or shared local data store. For example, use this function to return the storage class or
the calibration access of a measurement property configured for a local or shared local data
store in a model.propertyValue
= getDataStore(myCodeMappingObj
,dataStore
,property
)
Examples
Get Storage Class Configured for Local Data Store
From the model code mappings for model
ConfigurationRapidPrototypingInterface
, get the name of the storage
class that is configured for local data store mode
.
openExample("ConfigurationRapidPrototypingInterface"); cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface"); scMode = getDataStore(cm,"mode","StorageClass");
Get Code Identifier Configured for Local Data Store
From the model code mappings for model
ConfigurationRapidPrototypingInterface
, get the code identifier
configured for the local data store mode
.
openExample("ConfigurationRapidPrototypingInterface"); cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface"); idDSMmode = getDataStore(cm,"mode","Identifier");
Get Calibration Properties Configured for Local Data Store
From the model code mappings for model
ConfigurationRapidPrototypingInterface
, get the calibration
properties such as calibration access and display identifier configured for local data
store mode
.
openExample("ConfigurationRapidPrototypingInterface"); cm = coder.mapping.api.get("ConfigurationRapidPrototypingInterface"); prop_export = getDataStore(cm,"mode","Export"); prop_bitmask = getDataStore(cm,"mode","BitMask"); prop_calaccess = getDataStore(cm,"mode","CalibrationAccess"); prop_compname = getDataStore(cm,"mode","CompuMethod"); prop_dispid = getDataStore(cm,"mode","DisplayIdentifier"); prop_format = getDataStore(cm,"mode","Format");
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
dataStore
— Block path, block handle, or name of data store
character vector | string scalar | block handle
Path 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.
Example: blockHandle
Data Types: char
| string
| block_handle
property
— Code mapping property value to return
StorageClass
| Identifier
| DefinitionFile
| GetFunction
| HeaderFile
| Owner
| PreserveDimensions
| SetFunction
| StructName
| storage class property name | Export
| BitMask
| CalibrationAccess
| CompuMethod
| DisplayIdentifier
| Format
| MeasurementService
Code mapping property for which to return a value. For a storage class defined in the Embedded Coder Dictionary associated with the model, specify a property name or one of these property names.
Information to Return | Property Name |
---|---|
Name of storage class | StorageClass |
Name of variable for data store in the generated code | Identifier |
Name of source definition file that contains definitions for global data that is read by the data store and external code | DefinitionFile |
Name of get function called by code generated for the
data store | GetFunction |
Name of source header file that contains declarations for global data that is read by the data store and external code | HeaderFile |
Name of memory section that contains data read by the state | MemorySection |
Name of model for which the code generator places the definition for a data store shared by multiple models in a model hierarchy | Owner |
Boolean value indicating whether the code generator preserves dimensions of a data store that is represented as a multidimensional array | PerserveDimensions |
Name of set function called by code generated for a
data store | SetFunction |
Name of structure in generated code for a data store | StructName |
Boolean value indicating whether to export the selected data store to a calibration file (a2l) | Export |
Mask value in hexadecimal format to extract single bits from the data store in a calibration tool | BitMask |
Enumeration value indicating the access of calibration.
Calibration for a data store indicates that the data store
can be calibrated. NoCalibration indicates that the data
store can be read-only and cannot be calibrated.
NoCalibration is the default value for the property | CalibrationAccess |
Name of the conversion method used during the calibration | CompuMethod |
Optional display name of the data store for calibration | DisplayIdentifier |
Specifies the display format of the data store being measured in a calibration tool | Format |
Name of measurement service defined in Embedded Coder Dictionary | MeasurementService |
Example: "StorageClass"
Example: "CalibrationAccess"
Output Arguments
propertyValue
— Name of storage class or value of storage class property
character vector
Name of the storage class or value of the specified storage class property configured for the specified data store.
Data Types: char
Version History
Introduced in R2020b
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
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)
Asia Pacific
- Australia (English)
- India (English)
- New Zealand (English)
- 中国
- 日本Japanese (日本語)
- 한국Korean (한국어)