Generated Code Interfacing

Tune parameters and measure signal data by using ASAP2 and C API interfaces and view generated code metadata

Some applications must exchange data between generated code and external application code. Use the ASAP2 and CDF interface to establish a communication channel between development and target computers, export an ASAP2 file containing description format of the internal ECU variables, or export a Calibration Data Format (CDF) file containing the information about parameters in a machine-readable format. Use the C API to exchange data between generated code and external code.

To obtain metadata about the generated code, use the code descriptor programming interface.

Sample Target Environment Service Implementations of Data Communication Methods shows samples of how target environment services might implement the three types of data communication methods: direct access, outside execution, and during execution.

Tools

Generate Calibration Files

Generate ASAP2 and CDF files (Since R2021b)

Classes

expand all

ASAP2 Customization

`coder.asap2.AxisInfo`	Set values for axis to describe lookup table (Since R2022b)
`coder.asap2.Characteristic`	Create characteristic object (Since R2022b)
`coder.asap2.CompuMethod`	Create compu method object (Since R2022b)
`coder.asap2.Function`	Create function object (Since R2022b)
`coder.asap2.Group`	Create group object (Since R2023b)
`coder.asap2.Measurement`	Create measurement object (Since R2022b)
`coder.asap2.RecordLayout`	Create record layout object (Since R2023a)
`coder.asap2.UserCustomizeBase`	Customize project and module settings (Since R2022b)

Code Descriptor Interface

`coder.codedescriptor.CodeDescriptor`	Return information about generated code
`coder.descriptor.DataInterface`	Return information about different types of data interfaces
`coder.descriptor.FunctionInterface`	Return information about entry-point functions
`coder.descriptor.LookupTableDataInterface`	Return information about Lookup Table blocks that have tunable parameters (Since R2020a)
`coder.descriptor.BreakpointDataInterface`	Return information about tunable breakpoint set data for a lookup table that has tunable parameters (Since R2020a)
`coder.descriptor.DataTransferElement`	Return information about data transfer signal (Since R2022b)
`coder.descriptor.DataTransferFunction`	Return information about function prototypes for data transfer service interfaces (Since R2022b)
`coder.descriptor.DataTransferServiceInterface`	Return information about data transfer service interface (Since R2022b)
`coder.descriptor.MeasurementServiceInterface`	Return information about measurement service interfaces (Since R2023a)
`coder.descriptor.ParameterTuningServiceInterface`	Return information about parameter tuning service interfaces (Since R2023a)
`coder.descriptor.ParameterArgumentTuningServiceInterface`	Return information about parameter argument tuning service interfaces (Since R2023a)
`coder.descriptor.SenderReceiverServiceInterface`	Return information about sender and receiver service interfaces (Since R2022b)
`coder.descriptor.ServiceFunctions`	Return list of service functions that entry-point function calls (Since R2022b)
`coder.descriptor.ServiceInterface`	Return service interface information required to generate service functions (Since R2022b)
`coder.descriptor.TimerFunction`	Retrieve information about function prototypes for timer services (Since R2022b)
`coder.descriptor.TimerServiceInterface`	Return information about timer service interface (Since R2022b)

Code Descriptor Types

`coder.descriptor.types.Aggregate`	Return information about variable of aggregate type (Since R2024a)
`coder.descriptor.types.AggregateElement`	Return information about element of aggregate type (Since R2024a)
`coder.descriptor.types.Argument`	Return information about argument associated with function or method in generated code (Since R2024a)
`coder.descriptor.types.Bool`	Return information about variable of Boolean type (Since R2024a)
`coder.descriptor.types.Char`	Return information about variable of character type (Since R2024a)
`coder.descriptor.types.Complex`	Return information about variable of complex type (Since R2024a)
`coder.descriptor.types.Double`	Return information about variable of double-precision type (Since R2024a)
`coder.descriptor.types.Enum`	Return information about variable of enum type (Since R2024b)
`coder.descriptor.types.Fixed`	Return information about variable of fixed-point type (Since R2024a)
`coder.descriptor.types.Half`	Return information about variable of half-precision type (Since R2024a)
`coder.descriptor.types.Integer`	Return information about variable of integer type (Since R2024a)
`coder.descriptor.types.Matrix`	Return information about variable of matrix type (Since R2024a)
`coder.descriptor.types.Numeric`	Return information about variable of numeric type (Since R2024a)
`coder.descriptor.types.Pointer`	Return information about variable of pointer type (Since R2024a)
`coder.descriptor.types.Prototype`	Return information about function prototype in generated code (Since R2024a)
`coder.descriptor.types.Reference`	Return information about variable of reference type (Since R2024a)
`coder.descriptor.types.Scalar`	Return information about variable of scalar type (Since R2024a)
`coder.descriptor.types.Single`	Return information about variable of single-precision type (Since R2024a)
`coder.descriptor.types.Struct`	Return information about variable of `struct` type (Since R2024a)
`coder.descriptor.types.Type`	Return information about data type of modeling element or corresponding variable in generated code (Since R2024a)
`coder.descriptor.types.Union`	Return information about variable of `union` type (Since R2024a)
`coder.descriptor.types.Void`	Represent base type of void pointer (Since R2024a)

Functions

expand all

ASAP2 and CDF Interface

`coder.asap2.export`	Generate ASAP2 (A2L) file according to ASAM MCD-2 MC standards (Since R2021a)
`coder.asap2.getEcuDescriptions`	ECU description object for model (Since R2022b)
`coder.asap2.merge`	Merge data elements from multiple ASAP2 (A2L) files (Since R2023a)
`coder.cdf.export`	Generate CDF (Calibration Data Format) file according to ASAM AE CDF standards (Since R2021a)
`rtw.asap2SetAddress`	Set ECU address in A2L file

Code Descriptor Interface

getCodeDescriptor Create coder.codedescriptor.CodeDescriptor object for model

Topics

ASAP2 and CDF Interface

Parameter Data Types in the Generated Code
Optimize the generated code and generate code for specific processors by controlling the data types that store parameter data in computer memory.
Create Tunable Calibration Parameter in the Generated Code
In the generated code, create tunable parameter data that you can access during rapid prototyping and calibration.
Calibrate Generated Code and Monitor Signals
Generate XCP external mode target application and ASAP2 file that describes the XCP server configuration.
Generate ASAP2 and CDF Calibration Files
Generate ASAP2 and CDF files according to ASAM MCD-2 MC and ASAM AE CDF standards respectively.
Customize Generated ASAP2 File
Customize the ASAP2 file generated from a Simulink^® model.
Create and Add Custom Data Elements
Add custom data elements to an ASAP2 file.
Customize Using Base Files
Use the base class and files to customize the ASAP2 fields Simulink model.
Configure Model Data Elements for ASAP2 File Generation
Set measurement and calibration properties for model data elements.
Frequently Asked Questions About ASAP2 File Generation
ASAP2 standard defines the description format of the internal electronic control unit (ECU) variables used in measurement and calibration and ASAM CDF standard defines the data for storing the ECU parameter values and the associated meta data.

C API Interface

Get Started with C API

Learn the principles of using C API to interact with the generated model code.
- STEP 1: Explore Measurable and Tunable Model Elements
- STEP 2: Configure Model to Add C API Signals in Code Generation
- STEP 3: Write Code that Interacts with C API Code
Configure Model to Generate C API Code

Learn how to configure your model to include different types of C API elements in the generated code.
Write External Code to Access Generated C API Code

Learn how to write external code that can access generated C API code elements.
Use C API to Monitor and Tune Generated Model Code

Learn the details about how to use the C API to monitor and tune model elements.
- STEP 1: Explore Measurable and Tunable Model Elements
- STEP 2: Configure Model to Add C API Signals in Code Generation
- STEP 3: Write Code to Interact with Generated C API Signal Code
- STEP 4: Interact with C API Signal Code Throughout Execution
- STEP 5: Write Code to Interact with Generated C API Signal and Parameter Code
- STEP 6: Use Custom Monitor to Measure and Tune Model Elements in Real Time

Code Descriptor Interface

Get Code Description of Generated Code
Obtain metadata about the generated code.
Get Generated Type and Name of Inport Structures
Obtain metadata about the inport structures in generated code.
Get Metadata About Service Interface
Obtain metadata about the generated service interface by using the code descriptor programming interface.

Related Information

Featured Examples

Generate ASAP2 and CDF Data Definition Files

Example to demo the generation of ASAP2 file.

Open Live Script

Customize an ASAP2 File

Example to demo customization of ASAP2 file.

Open Live Script