coder.asap2.export

Generate ASAP2 (A2L) file according to ASAM MCD-2 MC standards

Since R2021a

collapse all in page

Syntax

coder.asap2.export(modelName)
coder.asap2.export(modelName,Name=Value)

Description

coder.asap2.export(modelName) generates an ASAP2 (A2L) file for modelName. The ASAP2 (A2L) file generated for a top model contains information from the referenced models.

example

coder.asap2.export(modelName,Name=Value) specifies additional options for ASAP2 (A2L) creation with one or more "Name=Value" arguments. For example, you can specify a location where to save the ASAP2 file. You can provide the symbol file of the model to replace ECU addresses in the ASAP2 file.

example

Examples

collapse all

Generate an ASAP2 file for the selected model and save it in the build folder of the model by using this command.

% Generate ASAP2 file for model
coder.asap2.export('modelName')

Generate an ASAP2 file by modifying the name of ASAP2 file, location where to save it, version of ASAP2 to be generated, and excluding comments by using this command.

% Export ASAP2 file and save it as
coder.asap2.export('modelName',FileName='test_car')

% Export ASAP2 file to specified path
coder.asap2.export('modelName',Folder='/home/temp/workspace/')

% Generate ASAP2 file with version 1.71
coder.asap2.export('modelName',Version='1.71')

% Generate ASAP2 file with comments excluded
coder.asap2.export('modelName',Comments=false)

Generate an ASAP2 file for the selected model that has ECU addresses based on the ELF symbol file associated with the executable by using this command.

% Generate ASAP2 file for model
coder.asap2.export('modelName',MapFile='model.elf')

Generate an ASAP2 file for the selected model and exclude the A2ML and IF_DATA sections by using this command.

% Generate ASAP2 file with A2ML and IF_DATA excluded
coder.asap2.export('modelName',GenerateXCPInfo=false)

Specify the name of the model class instance. The objName is declared in the global namespace by using this command.

% Use custom specified name as object name in ASAP2 file
coder.asap2.export('modelName',ModelClassInstanceName='objName')

% Specify the name of model class instance declared inside the namespace. Here instance customObj
% is declared in customNameSpace
coder.asap2.export('modelName',ModelClassInstanceName='customNamespace::customObj')

Create a custom base object and specify the fields. Customize the contents of the ASAP2 file by using a custom base object by using this command.

% Create custom base object and provide fields you want to modify
obj = coder.asap2.UserCustomizeBase;
obj.HeaderComment = 'Header comment';
obj.ModParComment = 'Mod Par comment';
obj.ModCommonComment = 'Mod Common comment';
obj.ASAP2FileName = 'File name';
obj.ByteOrder = 'BYTE_ORDER MSB_LAST';

% Generate ASAP2 file with custom base created
coder.asap2.export('modelName',CustomizationObject=obj);

Group the parameters and measurements into arrays, scalars, maps, and curves by using this command.

coder.asap2.export('modelName',CustomizeGroupsBy={'ARRAY','SCALAR','MAP','CURVE'});

Export the record layouts of the base data types to a file named RecordLayouts.a2l by using this command.

coder.asap2.export('modelName',IncludeAllRecordLayouts=true)

Exclude structure elements by using this command.

coder.asap2.export('modelName', SupportStructureElements=false);

Exclude referenced model elements by using this command.

coder.asap2.export('modelName', IncludeReferencedModels=false);

Exclude 64-bit integers by using this command.

coder.asap2.export('modelName', Support64bitIntegers=false);

Specify additional address information in the ASAP2 file by using this command.

coder.asap2.export('modelName', EcuAddressExtension=4);

Generate the ASAP2 file using the settings updated by using this command.

coder.asap2.export('modelName', UseSavedSettings=false);

Exclude AUTOSAR RTE elements in the ASAP2 file for a AUTOSAR classic model by using this command.

coder.asap2.export('autosarclassic-modelName', IncludeAutosarRteElements=false);

Export ASAP2 file by modifying the array layout to view the array data in required format by using this command.

coder.asap2.export('modelName', ToggleArrayLayout=true);

Export record layouts and CompuMethods as separate ASAP2 files for an embedded coder model by using this command.

coder.asap2.export('ert-modelName', IncludeSharedElements=true);

Exclude variant parameters in ASAP2 file by using this command.

coder.asap2.export('modelName', IncludeVariantCoding=false);

Input Arguments

collapse all

Name of the model.

Example: 'MyModel','nav_app'

Name-Value Arguments

collapse all

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: MapFile='model.elf' generates an ASAP2 file for the model containing debug mapping information from the model.elf file.

Generate the ASAP2 file by including or excluding comments.

Example: Comments=true

Update the current ECU description in the ASAP2 file to custom values by creating and providing a description object.

Note

This argument cannot be used with other Name=Value pairs.

Example: CustomEcuDescriptions=description_object

Create a user base and customize the ASAP2 fields such as:

  • ASAP2FileName

  • ByteOrder

  • HeaderComment

  • ModParComment

  • ModCommonComment

Example: CustomizationObject=obj

Group the parameters and signals based on their properties.

Example: CustomizeGroupsBy={'ARRAY','MAP'}

Specify a 16-bit integer value to specify additional address information in the ASAP2 file. By default, no additional address information is required.

Example: EcuAddressExtension=4

Name for the exported ASAP2 file.

Example: FileName='test_car'

Specify export location for the generated ASAP2 file.

Example: Folder='/home/temp/prjct/'

Generate the ASAP2 file by including or excluding A2ML and IF_DATA sections.

Example: GenerateXCPInfo=true

Note

Embedded Coder® is required to generate the A2ML and IF_DATA sections.

Export record layouts of all the base data types to a file named RecordLayouts.a2l according to the version of the ASAP2 file.

Example: IncludeAllRecordLayouts=true

Generate the ASAP2 file by including or excluding the AUTOSAR RTE elements.

Note

This option is applicable only for AUTOSAR classic models.

Example: IncludeAutosarRteElements=true

Specify true to include a default event list in the ASAP2 file.

Example: IncludeDefaultEventList=true

Specify true to include referenced model elements in ASAP2 file. Specify false to exclude.

Example: IncludeReferencedModels=true

Generate separate ASAP2 files for CompuMethods and record layouts.

Note

This option is applicable for models with ERT - based system target files.

Example: IncludeSharedElements=true

Specify true export variant parameters to ASAP2 file. Specify false to skip the variant parameters.

Example: IncludeVariantCoding=true

Generate an ASAP2 file by following indentation.

Example: IndentFile=true

Name of the model symbol file that contains symbols of generated code. For example, the addresses of variables used in generated code.

Example: MapFile='model.elf'

Note

Embedded Coder is required to replace addresses in the ASAP2 file.

Custom model instance name in an ASAP2 file. This argument is applicable only for AUTOSAR adaptive models.

Example: ModelClassInstanceName='customObj' or ModelClassInstanceName='customNameSpace::customObj'

Specify false to exclude 64-bit integers in the generated ASAP2 file.

Example: Support64bitIntegers=false

Specify false to exclude elements that are part of the structure in the generated ASAP2 file.

Example: SupportStructureElements=false

Update the array layout to ROW_DIR or COL_DIR to view the array data in row wise or column wise.

Example: ToggleArrayLayout=true

Save the preferences made and generate the ASAP2 file with the preferences updated such as including the comments, version of the ASAP2 file.

Example: UseSavedSettings=false

ASAP2 file format based on the ASAM MCD-2 MC standard defined by ASAM. There are multiple versions of the ASAM MCD-2 MC standard. Specify the version of ASAP2 that you want.

Example: Version='1.61' or Version='1.31'

Version History

Introduced in R2021a

expand all

See Also

| |

Topics