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™。

    示例

    示例

    全部折叠

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

    open_system("ModelName1");
slbuild(bdroot);

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

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

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

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

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

    输入参数

    全部折叠

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

    示例: ModelName1

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

    示例: folder/asap2FileName1.a2l

    示例: asap2FileName2.a2l

    名称-值参数

    全部折叠

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

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

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

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

    示例: Comments=true

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

    • ASAP2FileName

    • ByteOrder

    • HeaderComment

    • ModParComment

    • ModCommonComment

    示例: CustomizationObject=obj

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

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

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

    示例: EcuAddressExtension=4

    导出的 A2L 文件的名称。

    示例: FileName='test_car'

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

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

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

    示例: GenerateXCPInfo=true

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

    示例: IncludeAllRecordLayouts=true

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

    注意

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

    示例: IncludeAutosarRteElements=true

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

    示例: IncludeDefaultEventList=true

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

    示例: IncludeReferencedModels=true

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

    注意

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

    示例: IncludeSharedElements=true

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

    示例: IndentFile=true

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

    示例: MapFile='model.elf'

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

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

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

    示例: Support64bitIntegers=false

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

    示例: SupportStructureElements=false

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

    示例: ToggleArrayLayout=true

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

    示例: UseSavedSettings=false

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

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

    输出参量

    全部折叠

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

    版本历史记录

    在 R2023a 中推出

    另请参阅

    主题