coder.asap2.export
说明
coder.asap2.export(
使用一个或多个“Name=Value”参量指定创建 ASAP2 (A2L) 的其他选项。例如,您可以指定保存 A2L 文件的位置。您可以提供模型的符号文件来替换 A2L 文件中的 ECU 地址。 modelName
,Name=Value
)
示例
为模型生成 ASAP2 文件
为所选模型生成 A2L 文件,并将其保存在模型的编译文件夹中。
% Generate A2L file for model coder.asap2.export('modelName')
通过使用自定义生成 A2L 文件
通过修改 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)
使用符号文件为模型生成 ASAP2 文件
根据与可执行文件相关联的 ELF 符号文件,为具有 ECU 地址的所选模型生成 A2L 文件。
% Generate A2L file for model coder.asap2.export('modelName',MapFile='model.elf')
从生成的 A2L 文件中排除 A2ML 和 IF_DATA 部分
为所选模型生成 A2L 文件,并排除 A2ML 和 IF_DATA 部分。
% Generate A2L file with A2ML and IF_DATA excluded coder.asap2.export('modelName',GenerateXCPInfo=false)
使用自定义模型类实例名称生成 ASAP2 文件
指定模型类实例的名称。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')
使用自定义的 ASAP2 字段生成 ASAP2 文件
创建自定义基对象并指定字段。使用自定义基对象自定义 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);
通过对参数和测量进行分组来生成 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);
通过排除 64 位元素生成 ASAP2 文件
使用以下命令排除 64 位整数:
coder.asap2.export('modelName', Support64bitIntegers=false);
通过指定 ECU 地址扩展生成 ASAP2 文件
使用以下命令指定 A2L 文件中的其他地址信息:
coder.asap2.export('modelName', EcuAddressExtension=4);
使用保存的预设项生成 ASAP2 文件
使用通过以下命令更新的设置生成 ASAP2 文件:
coder.asap2.export('modelName', UseSavedSettings=false);
通过排除 RTE 元素生成 ASAP2 文件
使用以下命令排除 AUTOSAR Classic 模型的 A2L 文件中的 AUTOSAR RTE 元素:
coder.asap2.export('autosarclassic-modelName', IncludeAutosarRteElements=false);
通过更新数组布局生成 ASAP2 文件
使用以下命令,通过修改数组布局以所需格式查看数组数据来导出 ASAP2 文件:
coder.asap2.export('modelName', ToggleArrayLayout=true);
为记录布局和 Compu 方法生成单独的 ASAP2 文件
使用以下命令将记录布局和 Compu 方法导出为 Embedded Coder 模型的单独 A2L 文件:
coder.asap2.export('ert-modelName', IncludeSharedElements=true);
输入参数
modelName
— 模型的名称
字符向量 | 字符串标量
模型的名称。
示例: 'MyModel','nav_app'
名称-值参数
将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN
,其中 Name
是参量名称,Value
是对应的值。名称-值参量必须出现在其他参量后,但参量对组的顺序无关紧要。
在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name
引起来。
示例: MapFile='model.elf'
从 model.elf
文件中为包含调试映射信息的模型生成 A2L 文件。
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
指定一个 16 位整数值,用于指定 ASAP2 文件中的其他地址信息。默认情况下,不需要其他地址信息。
示例: EcuAddressExtension=4
CustomEcuDescriptions
— 更新 ECU 描述
ECU description object
通过创建和提供描述对象,将 ASAP2 文件中的当前 ECU 描述更新为自定义值。
注意
此参量不能与其他 Name=Value 对组结合使用。
示例: CustomEcuDescriptions=description_object
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
版本历史记录
在 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 描述。
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
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: .
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)