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)

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)

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.

C API Interface

Exchange Data Between Generated and External Code Using C API
Write host-based or target-based application code that interacts with generated model code.
Use C API to Access Model Parameters
Write application code to interact with model parameters.
Use C API to Access Model Signals and States
Write application code to interact with model signals and states.

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

Create a Host-Based ASAM-ASAP2 Data Definition File for Data Measurement and Calibration

Example to demo the generation of ASAP2 file.

Open Live Script

Customize an ASAP2 File

Add, update, filter, find, and remove ECU descriptions in an ASAP2 file.

Open Live Script