coder.asap2.export

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

自 R2021a 起

全页折叠

语法

coder.asap2.export(modelName)

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

说明

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

示例

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

示例

全部折叠

为模型生成 ASAP2 文件

使用以下命令为所选模型生成 ASAP2 文件，并将其保存在模型的编译文件夹中。

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

通过使用自定义生成 ASAP2 文件

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

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

使用符号文件为模型生成 ASAP2 文件

使用以下命令，根据与可执行文件相关联的 ELF 符号文件为具有 ECU 地址的所选模型生成 ASAP2 文件。

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

从生成的 ASAP2 文件中排除 A2ML 和 IF_DATA 部分

使用以下命令，为所选模型生成 ASAP2 文件并排除 A2ML 和 IF_DATA 部分。

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

使用自定义模型类实例名称生成 ASAP2 文件

指定模型类实例的名称。使用以下命令在全局命名空间中声明 objName。

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

使用自定义的 ASAP2 字段生成 ASAP2 文件

创建自定义基对象并指定字段。通过使用以下命令，使用自定义基对象自定义 ASAP2 文件的内容。

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

通过对参数和测量进行分组来生成 ASAP2 文件

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

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

导出记录布局

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

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

通过排除结构体生成 ASAP2 文件

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

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

通过排除引用模型元素来生成 ASAP2 文件

使用以下命令排除引用模型元素。

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

通过排除 64 位元素生成 ASAP2 文件

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

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

通过指定 ECU 地址扩展生成 ASAP2 文件

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

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

使用保存的预设项生成 ASAP2 文件

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

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

通过排除 RTE 元素生成 ASAP2 文件

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

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

通过更新数组布局生成 ASAP2 文件

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

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

为记录布局和 CompuMethods 生成单独的 ASAP2 文件

使用以下命令将记录布局和 CompuMethods 导出为 Embedded Coder 模型的单独 ASAP2 文件。

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

通过排除变体参数生成 ASAP2 文件

使用此命令在 ASAP2 文件中排除变体参数。

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

输入参数

全部折叠

`modelName` — 模型的名称
字符向量 | 字符串标量

模型的名称。

示例: 'MyModel','nav_app'

名称-值参数

全部折叠

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

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

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

`Comments` — 在 ASAP2 文件中包括注释
true (默认) | false

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

示例: Comments=true

`CustomEcuDescriptions` — 更新 ECU 描述
`ECU description object`

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

注意

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

示例: CustomEcuDescriptions=description_object

`CustomizationObject` — 自定义 ASAP2 字段
`coder.asap2.UserCustomizeBase` 对象 (默认)

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

ASAP2FileName
ByteOrder
HeaderComment
ModParComment
ModCommonComment

示例: CustomizationObject=obj

`CustomizeGroupsBy` — 自定义 ASAP2 文件中的组
`ARRAY` | `ASCII` | `SCALAR` | `MAP` | `CUBOID` | `CURVE` | `CUBE_4` | `CUBE_5`

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

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

`EcuAddressExtension` — 指定其他地址信息
int

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

示例: EcuAddressExtension=4

`FileName` — 导出的 ASAP2 文件的自定义名称
字符向量 | 字符串标量

导出的 ASAP2 文件的名称。

示例: FileName='test_car'

`Folder` — ASAP2 文件的导出文件夹位置
字符向量 | 字符串标量

为生成的 ASAP2 文件指定导出位置。

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

`GenerateXCPInfo` — 在 ASAP2 文件中包括 A2ML 和 IF_DATA
true (默认) | false

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

示例: GenerateXCPInfo=true

注意

生成 A2ML 和 IF_DATA 部分需要 Embedded Coder^®。

`IncludeAllRecordLayouts` — 导出基本数据类型的记录布局
false (默认) | true

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

示例: IncludeAllRecordLayouts=true

`IncludeAutosarRteElements` — 导出 RTE 元素
true (默认) | false

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

注意

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

示例: IncludeAutosarRteElements=true

`IncludeDefaultEventList` — 创建默认事件
true (默认) | false

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

示例: IncludeDefaultEventList=true

`IncludeReferencedModels` — 导出引用模型元素
true (默认) | false

指定 true 可在 ASAP2 文件中包含引用模型元素。指定 false 可将其排除。

示例: IncludeReferencedModels=true

`IncludeSharedElements` — 单独导出 CompuMethods 和记录布局
true (默认) | false

为 CompuMethods 和记录布局生成单独的 ASAP2 文件。

注意

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

示例: IncludeSharedElements=true

`IncludeVariantCoding` — 导出变体参数
true (默认) | false

指定 true 可将变体参数导出到 ASAP2 文件。指定 false 可跳过变体参数。

示例: IncludeVariantCoding=true

`IndentFile` — 遵从 ASAP2 文件中的缩进
false (默认) | true

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

示例: IndentFile=true

`MapFile` — 模型的符号文件名
ELF | PDB | DWARF

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

示例: MapFile='model.elf'

注意

替换 ASAP2 文件中的地址需要 Embedded Coder。

`ModelClassInstanceName` — 指定类实例和路径名称
字符向量 | 字符串标量

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

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

`Support64bitIntegers` — 包括或排除 ASAP2 文件中的 64 位整数
true (默认) | false

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

示例: Support64bitIntegers=false

`SupportStructureElements` — 包括或排除 ASAP2 文件中的结构体元素
true (默认) | false

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

示例: SupportStructureElements=false

`ToggleArrayLayout` — 修改数组布局
false (默认) | true

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

示例: ToggleArrayLayout=true

`UseSavedSettings` — 保存并使用预设项
false (默认) | true

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

示例: UseSavedSettings=false

`Version` — ASAP2 文件的版本
1.71 (默认) | 1.31 | 1.61

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

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

版本历史记录

在 R2021a 中推出

全部展开

R2024a: ASCII 类型的组参数和信号

该函数现在使您能够将 ASCII 数据类型的参数和信号作为一个组导出。

R2023a: 适用于 DDS Blockset 模型

该函数现在适用于 DDS Blockset 模型。

R2022b: 适用于 SLRT 模型

该函数现在适用于 Simulink Real-Time 模型。添加了其他 name=value 对组来保存 ASAP2 文件生成的预设项，包括默认事件列表和切换数组布局。

对于 AUTOSAR Classic 模型，使用函数包括/排除 RTE 元素。

R2022a: 其他 Name=Value 对组

添加了其他 name=value 对组，以包括/排除结构体元素、64 位整数并向 ASAP2 文件添加自定义 ECU 描述。

另请参阅

coder.cdf.export | 生成标定文件 | coder.asap2.getEcuDescriptions

coder.asap2.export

语法

说明

示例

为模型生成 ASAP2 文件

通过使用自定义生成 ASAP2 文件

使用符号文件为模型生成 ASAP2 文件

从生成的 ASAP2 文件中排除 A2ML 和 IF_DATA 部分

使用自定义模型类实例名称生成 ASAP2 文件

使用自定义的 ASAP2 字段生成 ASAP2 文件

通过对参数和测量进行分组来生成 ASAP2 文件

导出记录布局

通过排除结构体生成 ASAP2 文件

通过排除引用模型元素来生成 ASAP2 文件

通过排除 64 位元素生成 ASAP2 文件

通过指定 ECU 地址扩展生成 ASAP2 文件

使用保存的预设项生成 ASAP2 文件

通过排除 RTE 元素生成 ASAP2 文件

通过更新数组布局生成 ASAP2 文件

为记录布局和 CompuMethods 生成单独的 ASAP2 文件

通过排除变体参数生成 ASAP2 文件

输入参数

modelName — 模型的名称 字符向量 | 字符串标量

名称-值参数

Comments — 在 ASAP2 文件中包括注释 true (默认) | false

CustomEcuDescriptions — 更新 ECU 描述 ECU description object

CustomizationObject — 自定义 ASAP2 字段 coder.asap2.UserCustomizeBase 对象 (默认)

CustomizeGroupsBy — 自定义 ASAP2 文件中的组 ARRAY | ASCII | SCALAR | MAP | CUBOID | CURVE | CUBE_4 | CUBE_5

EcuAddressExtension — 指定其他地址信息 int

FileName — 导出的 ASAP2 文件的自定义名称 字符向量 | 字符串标量

Folder — ASAP2 文件的导出文件夹位置 字符向量 | 字符串标量

GenerateXCPInfo — 在 ASAP2 文件中包括 A2ML 和 IF_DATA true (默认) | false

IncludeAllRecordLayouts — 导出基本数据类型的记录布局 false (默认) | true

IncludeAutosarRteElements — 导出 RTE 元素 true (默认) | false

IncludeDefaultEventList — 创建默认事件 true (默认) | false

IncludeReferencedModels — 导出引用模型元素 true (默认) | false

IncludeSharedElements — 单独导出 CompuMethods 和记录布局 true (默认) | false

IncludeVariantCoding — 导出变体参数 true (默认) | false

IndentFile — 遵从 ASAP2 文件中的缩进 false (默认) | true

MapFile — 模型的符号文件名 ELF | PDB | DWARF

ModelClassInstanceName — 指定类实例和路径名称 字符向量 | 字符串标量

Support64bitIntegers — 包括或排除 ASAP2 文件中的 64 位整数 true (默认) | false

SupportStructureElements — 包括或排除 ASAP2 文件中的结构体元素 true (默认) | false

ToggleArrayLayout — 修改数组布局 false (默认) | true

UseSavedSettings — 保存并使用预设项 false (默认) | true

Version — ASAP2 文件的版本 1.71 (默认) | 1.31 | 1.61

版本历史记录

R2024a: ASCII 类型的组参数和信号

R2023a: 适用于 DDS Blockset 模型

R2022b: 适用于 SLRT 模型

R2022a: 其他 Name=Value 对组

另请参阅

主题

`modelName` — 模型的名称
字符向量 | 字符串标量

`Comments` — 在 ASAP2 文件中包括注释
true (默认) | false

`CustomEcuDescriptions` — 更新 ECU 描述
`ECU description object`

`CustomizationObject` — 自定义 ASAP2 字段
`coder.asap2.UserCustomizeBase` 对象 (默认)

`CustomizeGroupsBy` — 自定义 ASAP2 文件中的组
`ARRAY` | `ASCII` | `SCALAR` | `MAP` | `CUBOID` | `CURVE` | `CUBE_4` | `CUBE_5`

`EcuAddressExtension` — 指定其他地址信息
int

`FileName` — 导出的 ASAP2 文件的自定义名称
字符向量 | 字符串标量

`Folder` — ASAP2 文件的导出文件夹位置
字符向量 | 字符串标量

`GenerateXCPInfo` — 在 ASAP2 文件中包括 A2ML 和 IF_DATA
true (默认) | false

`IncludeAllRecordLayouts` — 导出基本数据类型的记录布局
false (默认) | true

`IncludeAutosarRteElements` — 导出 RTE 元素
true (默认) | false

`IncludeDefaultEventList` — 创建默认事件
true (默认) | false

`IncludeReferencedModels` — 导出引用模型元素
true (默认) | false

`IncludeSharedElements` — 单独导出 CompuMethods 和记录布局
true (默认) | false

`IncludeVariantCoding` — 导出变体参数
true (默认) | false

`IndentFile` — 遵从 ASAP2 文件中的缩进
false (默认) | true

`MapFile` — 模型的符号文件名
ELF | PDB | DWARF

`ModelClassInstanceName` — 指定类实例和路径名称
字符向量 | 字符串标量

`Support64bitIntegers` — 包括或排除 ASAP2 文件中的 64 位整数
true (默认) | false

`SupportStructureElements` — 包括或排除 ASAP2 文件中的结构体元素
true (默认) | false

`ToggleArrayLayout` — 修改数组布局
false (默认) | true

`UseSavedSettings` — 保存并使用预设项
false (默认) | true

`Version` — ASAP2 文件的版本
1.71 (默认) | 1.31 | 1.61