coder.asap2.export
Description
coder.asap2.export(
generates an
ASAP2 (A2L) file for modelName
)modelName
. The ASAP2 (A2L) file generated for a
top model contains information from the referenced models.
coder.asap2.export(
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. modelName
,Name=Value
)
Examples
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
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 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
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'
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 R2021aThe function now enables you to export the parameters and signals of ASCII data type as a group.
The function is now applicable for DDS Blockset models.
The function is now applicable for Simulink Real-Time models. Additional name=value pairs are added to save the preferences of ASAP2 file generation, include the default event list, and toggle array layout.
For AUTOSAR classic models, use the function to include/exclude RTE elements.
Additional name=value pairs are added to include/exclude structure elements, 64-bit integers, and add custom ECU descriptions to the ASAP2 file.
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: United States.
You can also select a web site from the following list
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)