coder.descriptor.DataInterface Class

Namespace: coder.descriptor

Return information about different types of data interfaces

Description

The coder.descriptor.DataInterface object describes various properties for a specified data interface in the generated code. The different types of data interfaces are:

• Root-level inports and outports: An interface between the model and external models or systems, for exchanging data.

• Parameters: Local and global parameters that describe the data for the block, lookup table, and the associated breakpoint set data.

• Data Stores: A repository to store global and shared data that can be written and read.

• Internal data: Internal data structures including DWork vectors, block I/O, and zero-crossings.

Creation

dataInterface = getDataInterfaces(codeDescObj, dataInterfaceName) creates a coder.descriptor.DataInterface object. The codeDescObj object is the coder.codedescriptor.CodeDescriptor object created for the model by using the getCodeDescriptor function.

Input Arguments

dataInterfaceName — Name of data interface

Inports | Outports | Parameters | GlobalDataStores | SharedLocalDataStores | ExternalParameterObjects | ModelParameters | InternalData

Name of the specified data interface.

Example: 'Inports'

Data Types: string

Properties

Type — Type of data

coder.descriptor.types object

The data type associated with the data such as integer, double, matrix, and its properties.

SID — Simulink^® identifier

character vector

The Simulink identifier (SID) is a unique number within the model that Simulink assigns to the block.

GraphicalName — Name of graphical entity

character vector

The name of the associated graphical entity.

VariantInfo — Variant conditions in the model

coder.descriptor.VariantInfo object

The variant conditions in the model that interact with the data interface.

Implementation — Description of implementation of data

coder.descriptor.DataImplementation object

The description of how the data in the generated code is implemented. This property describes characteristics such as data type and size. In addition, it describes how the data is accessed or declared in the code. The property describes if the data is declared as a variable or structure member.

Timing — Data access rate in run-time environment

coder.descriptor.TimingInterface object

The rate at which data is accessed in a run-time environment.

Unit — Physical unit as attribute on signals

character vector

Specified physical units as attributes on signals at the boundaries of model components.

Range — Range of output value

coder.descriptor.Range object

The range of valid values for the block output signals.

Limitations

A bitfield data structure is generated if you select these configuration parameters:

• Pack Boolean data into bitfields

• Use bitset for storing state configuration

• Use bitset for storing Boolean data

If the coder.descriptor.DataInterface represents a bitfield data structure, the Implementation property of the coder.descriptor.DataInterface object is empty.

For data represented by macros, no coder.descriptor.DataInterface object is returned. Examples include data assigned to the following storage classes:

• Define

• ImportedDefine

• CompilerFlag

Examples

Get All Data Interface Types

1. Open the model.

   openExample(‘CustomCodeComments’)

2. Build the model.

   slbuild('CustomCodeComments')

3. Create a coder.codedescriptor.CodeDescriptor object for the required model.

   codeDescObj = coder.getCodeDescriptor('CustomCodeComments')
   

4. Return a list of all data interface types in the generated code.

   dataInterfaceTypes = getDataInterfaceTypes(codeDescObj)

       {'Inports'         }
       {'Outports'        }
       {'Parameters'      }
       {'ExternalParameterObjects'}
       {'InternalData'    }

5. Return properties of a specified data interface in the generated code.

   dataInterfaces = getDataInterfaces(codeDescObj,'Inports')

   dataInterfaces is an array of coder.descriptor.DataInterface objects. Obtain the details of the first Inport block of the model by accessing the first location in the array.

   dataInterfaces(1)

                 Type: [1×1 coder.descriptor.types.Double]
                  SID: 'CustomCodeComments:1'
        GraphicalName: 'In1'
          VariantInfo: [0×0 coder.descriptor.VariantInfo]
       Implementation: [1×1 coder.descriptor.StructExpression]
               Timing: [1×1 coder.descriptor.TimingInterface]

Version History

Introduced in R2018a