coder.asap2.merge

合并多个 ASAP2 (A2L) 文件中的数据元素

自 R2023a 起

语法

mergeObj = coder.asap2.merge(modelName,a2lFilePath)

说明

mergeObj = coder.asap2.merge(modelName,a2lFilePath) 将 a2lFilePath 中指定的源 A2L 文件中的数据元素与 Simulink 模型 modelName 的 ECU 描述符对象进行合并。您可以使用 Simulink 模型合并多个 A2L 文件。

注意

要使用 coder.asap2.merge 函数，需要 Vehicle Network Toolbox™。

示例

全部折叠

合并 ASAP2 文件

打开一个模型并对其进行编译。该模型可以是没有任何数据元素的虚拟模型。

open_system("ModelName1");
rtwbuild(bdroot);

通过指定要合并的 A2L 文件来调用该函数。

mergeObj = coder.asap2.merge("ModelName1",{"ASAP2File1.a2l","ASAP2File2.a2l"});

模型 ModelName1 的 mergeObj 描述符对象包含来自 ASAP2 文件 ASAP2File1 和 ASAP2File2 的数据元素。

使用命令导出模型的 ASAP2 文件。

coder.asap2.export("ModelName1",CustomEcuDescriptions=mergeObj)

输入参数

全部折叠

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

指定 Simulink 模型名称。在调用模型进行合并之前为其生成代码。

示例: ModelName1

`a2lFilePath` — A2L 文件的路径和名称
字符向量 | 字符串标量

指定 A2L 文件的路径和名称。如果 A2L 文件位于工作目录中，请指定文件名。

示例: folder/asap2FileName1.a2l

示例: asap2FileName2.a2l

名称-值参数

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

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

示例: MapFile='model.elf' 通过包含 model.elf 文件中的调试映射信息来更新模型的 ECU 描述对象。

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

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

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

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

导出的 A2L 文件的名称。

示例: FileName='test_car'

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

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

示例: MapFile='model.elf'

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

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

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

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

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

示例: Comments=true

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

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

示例: GenerateXCPInfo=true

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

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

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

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

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

示例: IndentFile=true

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

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

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

示例: IncludeAllRecordLayouts=true

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

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

示例: SupportStructureElements=false

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

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

示例: Support64bitIntegers=false

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

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

示例: EcuAddressExtension=4

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

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

注意

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

示例: IncludeAutosarRteElements=true

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

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

示例: UseSavedSettings=false

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

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

示例: IncludeDefaultEventList=true

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

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

示例: ToggleArrayLayout=true

`IncludeSharedElements` — 分别导出 Compu 方法和记录布局
true (默认) | false

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

注意

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

示例: IncludeSharedElements=true

输出参量

全部折叠

`mergeObj` — 合并的对象
`Custom ECU Description` 对象

ECU 描述对象，包含指定的 Simulink 模型和 A2L 文件中的数据元素。将该对象与 coder.asap2.export 函数结合使用来导出合并的 A2L 文件。

版本历史记录

在 R2023a 中推出

另请参阅

coder.asap2.export

主题

生成 ASAP2 和 CDF 标定文件

coder.asap2.merge

语法

说明

示例

合并 ASAP2 文件

输入参数

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

a2lFilePath — A2L 文件的路径和名称 字符向量 | 字符串标量

名称-值参数

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

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

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

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

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

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

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

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

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

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

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

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

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

EcuAddressExtension — 指定其他地址信息 int

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

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

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

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

IncludeSharedElements — 分别导出 Compu 方法和记录布局 true (默认) | false

输出参量

mergeObj — 合并的对象 Custom ECU Description 对象

版本历史记录

另请参阅

主题

WeChat

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

`a2lFilePath` — A2L 文件的路径和名称
字符向量 | 字符串标量

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

`IncludeSharedElements` — 分别导出 Compu 方法和记录布局
true (默认) | false

`mergeObj` — 合并的对象
`Custom ECU Description` 对象