Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

coder.asap2.export

根据 ASAM MCD-2 MC 标准生成 ASAP2 (A2L) 文件

自 R2021a 起

说明

coder.asap2.export(modelName)modelName 生成一个 ASAP2 (A2L) 文件。为顶层模型生成的 ASAP2 (A2L) 文件包含来自引用模型的信息。

示例

coder.asap2.export(modelName,Name=Value) 使用一个或多个“Name=Value”参量指定创建 ASAP2 (A2L) 的其他选项。例如,您可以指定保存 A2L 文件的位置。您可以提供模型的符号文件来替换 A2L 文件中的 ECU 地址。

示例

示例

全部折叠

为所选模型生成 A2L 文件,并将其保存在模型的编译文件夹中。

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

通过修改 ASAP2 文件的名称、保存位置、要生成的 A2L 版本以及排除注释来生成 A2L 文件。

% 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)

根据与可执行文件相关联的 ELF 符号文件,为具有 ECU 地址的所选模型生成 A2L 文件。

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

为所选模型生成 A2L 文件,并排除 A2ML 和 IF_DATA 部分。

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

指定模型类实例的名称。objName 是在全局命名空间中声明的。

% 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')

创建自定义基对象并指定字段。使用自定义基对象自定义 A2L 文件的内容。

% 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);

使用以下命令将参数和测量分组为数组、标量、图和曲线:

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

将基本数据类型的记录布局导出到名为 RecordLayouts.a2l 的文件中。

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

使用以下命令排除结构体元素:

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

使用以下命令排除 64 位整数:

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

使用以下命令指定 A2L 文件中的其他地址信息:

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

使用通过以下命令更新的设置生成 ASAP2 文件:

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

使用以下命令排除 AUTOSAR Classic 模型的 A2L 文件中的 AUTOSAR RTE 元素:

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

使用以下命令,通过修改数组布局以所需格式查看数组数据来导出 ASAP2 文件:

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

使用以下命令将记录布局和 Compu 方法导出为 Embedded Coder 模型的单独 A2L 文件:

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

输入参数

全部折叠

模型的名称。

示例: 'MyModel','nav_app'

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量后,但参量对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来。

示例: MapFile='model.elf'model.elf 文件中为包含调试映射信息的模型生成 A2L 文件。

放置导出的 A2L 文件的文件夹的完整路径。

示例: Folder='/home/temp/prjct/'

导出的 A2L 文件的名称。

示例: FileName='test_car'

包含生成代码符号的模型符号文件的名称。例如,在生成代码中使用的变量的地址。

示例: MapFile='model.elf'

基于 ASAM 定义的 ASAM MCD-2 MC 标准的 A2L 文件格式。ASAM MCD-2 MC 标准有多个版本。指定所需的 A2L 版本。

示例: Version='1.61'Version='1.31'

通过包括或排除注释来生成 A2L 文件。

示例: Comments=true

通过包括或排除 A2ML 和 IF_DATA 部分来生成 A2L 文件。

示例: GenerateXCPInfo=true

A2L 文件中的自定义模型实例名称。此参量仅适用于 AUTOSAR Adaptive 模型。

示例: ModelClassInstanceName='customObj'ModelClassInstanceName='customNameSpace::customObj'

通过遵从缩进生成 A2L 文件。

示例: IndentFile=true

创建一个用户数据库并自定义 ASAP2 字段,例如:

  • ASAP2FileName

  • ByteOrder

  • HeaderComment

  • ModParComment

  • ModCommonComment

示例: CustomizationObject=obj

根据属性对参数和信号进行分组。

示例: CustomizeGroupsBy={'ARRAY','MAP'}

根据 A2L 文件的版本,将所有基本数据类型的记录布局导出到名为 RecordLayouts.a2l 的文件中。

示例: IncludeAllRecordLayouts=true

指定 false 以排除生成的 ASAP2 文件中的结构体元素。

示例: SupportStructureElements=false

指定 false 以排除生成的 ASAP2 文件中的 64 位整数。

示例: Support64bitIntegers=false

指定一个 16 位整数值,用于指定 ASAP2 文件中的其他地址信息。默认情况下,不需要其他地址信息。

示例: EcuAddressExtension=4

通过创建和提供描述对象,将 ASAP2 文件中的当前 ECU 描述更新为自定义值。

注意

此参量不能与其他 Name=Value 对组结合使用。

示例: CustomEcuDescriptions=description_object

通过包括或排除 AUTOSAR RTE 元素来生成 A2L 文件。

注意

此选项仅适用于 AUTOSAR Classic 模型。

示例: IncludeAutosarRteElements=true

保存所设置的预设项,并使用更新后的预设项生成 ASAP2 文件,例如包括注释、ASAP2 文件的版本。

示例: UseSavedSettings=false

指定 true 以在 A2L 文件中包括默认事件列表。

示例: IncludeDefaultEventList=true

将数组布局更新为 ROW_DIRCOL_DIR 以按行或按列查看数组数据。

示例: ToggleArrayLayout=true

为 Compu 方法和记录布局生成单独的 A2L 文件。

注意

此选项适用于具有基于 ERT 的系统目标文件的模型。

示例: IncludeSharedElements=true

版本历史记录

在 R2021a 中推出

全部展开