ASAP2 ファイルの概要

ASAM MCD-2 MC 標準 (ASAP2 とも呼ばれる) は Association for Standardization of Automation and Measuring Systems (ASAM) によって推奨されているデータ定義の標準です。ASAP2 は測定、キャリブレーション、および診断システムで使用されるデータの非オブジェクト指向の説明です。ASAM と ASAM MCD-2 MC (ASAP2) 標準の詳細については、www.asam.net の ASAM Web サイトを参照してください。

ASAP2 ファイルの生成およびカスタマイズ機能を使用するには、以下に慣れておく必要があります。

システム ターゲット ファイルの定義による 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 の説明を生成します。本ソフトウェアでは、1 次元テーブル データを CURVE 情報、2 次元テーブル データを 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 オブジェクトを使用し、Breakpoint Specification ブロック パラメーターを Explicit values に指定します。

  • 共通軸を構成するには、Interpolation Using Prelookup ブロックを使用し、テーブル データに Simulink.LookupTable オブジェクトを使用します。

    • Simulink.LookupTable オブジェクトの場合は、Breakpoint Specification を Reference に指定します。

    • ブレークポイントの場合は、Prelookup ブロックと、Simulink.Breakpoint オブジェクトを使用するテーブル データを使用します。

  • 固定軸を構成するには、n-D Lookup Table ブロックを使用します。テーブル データには Simulink.Lookuptable オブジェクトを使用し、Breakpoint Specification ブロック パラメーターを Even Spacing に指定します。

    • ASAP2 Version 1.31 以前では、ブレークポイントはコード内に整数として格納されていなければなりません。データ型は組み込み整数型 (int8、int16、int32、uint8、uint16、または uint32)、固定小数点データ型、または同等のエイリアス タイプでなければなりません。

    • ASAP2 Version 1.6 以降では、ブレークポイントはコード内に浮動小数点型として格納できます。

次の例は、標準軸形式で生成され ASAP2 ファイルに埋め込まれる n-D Lookup Table レコードを示したものです。

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
 ...

モデル依存の 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

/end MODULE

/end MODULE

ファイル フッター/テール

writeFileTail

Simulink モデルから ASAP2 ファイルを生成する方法の例については、ASAP2 および CDF データ定義ファイルの生成を参照してください。

ASAP2 ファイルの生成に関する質問への詳細な回答については、Frequently Asked Questions About ASAP2 File Generationを参照してください。

参考

| |

トピック