ASAP2 文件简介

ASAM MCD-2 MC 标准，也称为 ASAP2，是由自动化和测量系统标准化协会 (ASAM) 提出的数据定义标准。ASAP2 是用于测量、标定和诊断系统的数据的非面向对象的描述。有关 ASAM 和 ASAM MCD-2 MC (ASAP2) 标准的详细信息，请参阅 ASAM 网站，网址为 www.asam.net。

要使用 ASAP2 文件生成和自定义，您应该熟悉以下各项：

ASAM 和 ASAP2 标准和术语。请访问 ASAM 网站，网址为 www.asam.net。
为代码生成配置模型数据元素。请参阅代码映射编辑器 - C。
生成代码中信号和参数的存储和表示。请参阅生成代码中的数据表示。
使用生成标定文件工具。
将自定义数据元素添加到 ASAP2 文件。请参阅Create and Add Custom Data Elements。

定义系统目标文件以生成 ASAP2 文件

您可以使用不同系统目标文件配置生成 ASAP2 文件。例如，基于 ERT、基于 GRT、Simulink Real-Time、AUTOSAR Classic 或 AUTOSAR Adaptive 系统目标配置允许您使用生成标定文件工具或 coder.asap2.export 函数生成 ASAP2 文件。

定义信号和参数的 ASAP2 信息

生成 ASAP2 文件需要关于模型中参数和信号的信息。使用模型数据编辑器和内置的 Simulink^® 数据对象来提供信息，例如使用 Simulink.Signal 对象来提供测量信息，使用 Simulink.Parameter 对象来提供特征信息。您也可以使用从 Simulink.Signal 和 Simulink.Parameter 派生的数据类中的数据对象来提供此信息。

有关详细信息，请参阅数据对象和模型数据编辑器。

Simulink.Signal 在 ASAP2 文件中生成为 Measurement。

Measurement data fields from an ASAP2 fiie

Simulink.Parameter 在 ASAP2 文件中生成为 Characteristic。

Characteristic data fields from an ASAP2 file

为查找表定义 ASAP2 信息

Simulink Coder™ 软件为查找表数据及其断点生成 ASAP2 描述信息。软件将一维表数据表示为 CURVE 信息，将二维表数据表示为 MAP 信息，将断点表示为 AXIS_DESCR 和 AXIS_PTS 信息。您可以使用以下 Simulink Lookup Table 模块之一来建立查找表模型：

软件支持以下类型的查找表断点（轴点）。

断点类型	生成的信息
可调整并在多个表轴中共享（公共轴）	`COM_AXIS`
固定和不可调（固定轴）	`FIX_AXIS` 的以下形式之一： `FIX_AXIS_PAR`（如果断点是具有等距间隔的整数并且等距间隔是 2 的幂） `FIX_AXIS_PAR_DIST`（如果断点是具有等距间隔的整数） `FIX_AXIS_PAR_LIST`（如果断点是具有非等距间距的整数）
可调但不在多个表中共享（标准轴）	`STD_AXIS`

当您为 ASAP2 代码生成配置模块时：

要配置标准轴，请使用 n-D Lookup Table 模块。对表数据使用 Simulink.LookupTable 对象，并将断点设定模块参数指定为 Explicit values。
要配置公共轴，请使用 Interpolation Using Prelookup 模块并在表数据中使用 Simulink.LookupTable 对象。
- 对于 Simulink.LookupTable 对象，将断点设定指定为 Reference。
- 对于断点，使用 Prelookup 模块以及使用 Simulink.Breakpoint 对象的表数据。
要配置固定轴，请使用 n-D Lookup Table 模块。对表数据使用 Simulink.Lookuptable 对象，并将断点设定模块参数指定为等间距。
- 对于 ASAP2 版本 1.31 及更早版本，断点必须在代码中存储为整数。数据类型必须为内置整数类型（int8、int16、int32、uint8、uint16 或 uint32）、定点数据类型或等效别名类型。
- 对于 ASAP2 版本 1.6 及更高版本，断点可以在代码中存储为浮点类型。

以下是 n-D Lookup Table 记录生成为标准轴格式的 ASAP2 文件的示例。

A lookup table object data fields from an ASAP2 file

ASAP2 文件的结构

下表概述了 ASAP2 文件的基本结构，并说明用于创建该文件的每个部分的自定义函数。

ASAP2 文件的静态部分以粗体显示。
使用 coder.asap2.UserCustomizeBase 函数将自定义数据添加到 ASAP2 文件。

文件部分	用于更新该部分的函数
文件头	`HeaderComment`
`/begin PROJECT ""`	`AfterBeginProjectContents`
`/begin HEADER ""` `HEADER` 内容	`AfterBeginHeaderContents`
`/end HEADER`	`/end HEADER`
`/begin MODULE ""` `MODULE` 内容：	`AfterBeginModuleContents`
`- A2ML - MOD_PAR - MOD_COMMON` ...	`AddA2MLSection` `AfterBeginModParContents` `AfterBeginModCommonContents`
依赖模型的 `MODULE` 内容：
`AXIS_PTS`	`coder.asap2.AxisInfo`
`CHARACTERISTIC`	`coder.asap2.Characteristic`
`COMPU_METHOD`	`coder.asap2.CompuMethod`
`FUNCTION`	`coder.asap2.Function`
`GROUP`	`coder.asap2.Group`
`MEASUREMENT`	`coder.asap2.Measurement`
`RECORD_LAYOUT`	`coder.asap2.RecordLayout`
`VARIANT_CODING`	`coder.asap2.VarCharacteristic` `coder.asap2.VarCriterion`
`/end MODULE`	`/end MODULE`
文件尾部	`writeFileTail`

有关如何从 Simulink 模型生成 ASAP2 文件的示例，请参阅生成 ASAP2 和 CDF 数据定义文件。

有关 ASAP2 文件生成问题的更多回答，请参阅Frequently Asked Questions About ASAP2 File Generation。

另请参阅

生成标定文件 | coder.asap2.export | coder.asap2.UserCustomizeBase