Main Content

coder.asap2.export

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

Since R2021a

Description

example

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 A2L file. You can provide the symbol file of the model to replace ECU addresses in the A2L file.

Examples

collapse all

Generate an A2L file for the selected model and save it in the build folder of the model.

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

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

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

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

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

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

Generate an A2L file for the selected model that has ECU addresses based on the ELF symbol file associated with the executable.

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

Generate an A2L file for the selected model and exclude the A2ML and IF_DATA sections.

% Generate A2L 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.

% Use custom specified name as object name in A2L 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 A2L file by using a custom base object.

% 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 A2L 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.

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

Exclude structure elements by using this command:

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

Exclude 64-bit integers by using this command:

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

Specify additional address information in the A2L 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 A2L 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 compu methods as separate A2L files for an embedded coder model by using this command:

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

Input Arguments

collapse all

Name of the model.

Example: 'MyModel','nav_app'

Name-Value Arguments

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 A2L file for the model containing debug mapping information from the model.elf file.

Full path to a folder in which to place an exported A2L file.

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

Name for the exported A2L file.

Example: FileName='test_car'

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'

A2L 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 A2L that you want.

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

Generate the A2L file by including or excluding comments.

Example: Comments=true

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

Example: GenerateXCPInfo=true

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

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

Generate an A2L file by following indentation.

Example: IndentFile=true

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'}

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

Example: IncludeAllRecordLayouts=true

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

Example: SupportStructureElements=false

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

Example: Support64bitIntegers=false

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

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

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

Note

This option is applicable only for AUTOSAR classic models.

Example: IncludeAutosarRteElements=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

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

Example: IncludeDefaultEventList=true

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

Example: ToggleArrayLayout=true

Generate separate A2L files for compu methods and record layouts.

Note

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

Example: IncludeSharedElements=true

Version History

Introduced in R2021a

expand all