AUTOSAR コード生成の構成

AUTOSAR Classic Platform 用に構成されたモデルから AUTOSAR 準拠の C コードと ARXML コンポーネント記述を生成するには次を行います。

[コンフィギュレーションパラメーター] ダイアログボックスの [コード生成] 、 [AUTOSAR コード生成オプション] ペインで AUTOSAR コード生成パラメーターを設定します。
AUTOSAR ディクショナリまたは AUTOSAR プロパティ関数を使用して AUTOSAR XML エクスポートオプションを設定します。
モデルを作成します。

AUTOSAR Classic スキーマの選択

ARXML ファイルのインポートとエクスポートおよび AUTOSAR 互換の C コードの生成に関して、次の AUTOSAR Classic Platform スキーマバージョンがサポートされています。

スキーマバージョンの値	インポートでサポートされるスキーマリビジョン	エクスポートスキーマリビジョン
`R22-11` (既定)	R22-11	R22-11
`R21-11`	R21-11	R21-11
`R20-11`	R20-11	R20-11
`R19-11`	R19-11	R19-11
`4.4`	4.4.0	4.4.0
`4.3`	4.3.0、4.3.1	4.3.1
`4.2`	4.2.1、4.2.2	4.2.2
`4.1`	4.1.1、4.1.2、4.1.3	4.1.3
`4.0`	4.0.1、4.0.2、4.0.3	4.0.3

モデルの AUTOSAR システムターゲットファイルをはじめて選択したときに、スキーマバージョンパラメーターは既定値の [R22-11] に設定されます。

ARXML ファイルを Simulink^® にインポートすると、ARXML インポーターはスキーマバージョンを検出してモデルのスキーマバージョンパラメーターを設定します。たとえば、スキーマ 4.3 のリビジョン 4.3.0 または 4.3.1 に基づく ARXML ファイルをインポートする場合、インポーターはスキーマバージョンパラメーターを [4.3] に設定します。

AUTOSAR モデルをビルドすると、コードジェネレーターは、ARXML 記述をエクスポートし、現在のスキーマバージョン準拠の C コードを生成します。たとえば、[スキーマバージョンの XML ファイルの生成] (Embedded Coder) が [4.3] に等しい場合、エクスポートは上にリストされているスキーマ 4.3 のエクスポートスキーマリビジョン (つまり、リビジョン 4.3.1) を使用します。

AUTOSAR ソフトウェアコンポーネントをエクスポートする前に、選択したスキーマバージョンを確認します。選択したスキーマバージョンを変更する必要がある場合、モデルコンフィギュレーションパラメーター [スキーマバージョンの XML ファイルの生成] を使用します。

メモ

AUTOSAR モデルコンフィギュレーションパラメーターを最上位モデルおよび参照モデルと同じ値に設定します。このガイドラインは [スキーマバージョンの XML ファイルの生成] (Embedded Coder)、[SHORT-NAME の最大長] (Embedded Coder)、[AUTOSAR コンパイラの抽象化マクロの使用] (Embedded Coder) および [1 次元配列を使用したルートレベルの行列の I/O のサポート] (Embedded Coder) に適用されます。

省略名の最大長の指定

AUTOSAR 規格では、SHORT-NAME XML 要素の最大の長さは 128 文字に指定されています。

コードジェネレーターによってエクスポートされた SHORT-NAME 要素の最大の長さを指定するには、モデルコンフィギュレーションパラメーター [SHORT-NAME の最大長] (Embedded Coder) を 32 から 128 までの整数値に設定します。既定の設定は 128 文字です。

AUTOSAR コンパイラ抽象化マクロの設定

16 ビットプラットフォーム用のコンパイラ (S12X 用の Cosmic および Metrowerks や ST10 用の Tasking など) では、限られた 16 ビットのアドレス範囲を扱うために特別なキーワードが使用されます。64k 境界を越えるデータおよびコードの位置は特別なキーワードによって明示的に選択されます。ただし、そのようなキーワードをソースコード内で直接使用した場合、そのソフトウェアはマイクロコントローラーファミリごとに個別に移植しなければなりません。つまりソフトウェアはプラットフォーム依存になります。

AUTOSAR では、C のマクロを指定して、プラットフォームに依存しない方法でコンパイラ命令 (near/far メモリ呼び出し) を抽象化します。これらのコンパイラ命令は 16 ビットプラットフォームに由来し、コンパイラごとにソースコードを個別に移植することなく 16 ビットマイクロコントローラーのコードの効率性を高めることができます。このアプローチによって、ソフトウェアコンポーネントの実装者ではなくシステムインテグレーターが、それぞれのソフトウェアコンポーネントのデータとコードの配置場所を選択できるようになります。

AUTOSAR のコンパイラ抽象化の詳細については、www.autosar.org を参照してください。

AUTOSAR コンパイラマクロ生成を有効にするには、モデルコンフィギュレーションパラメーター [AUTOSAR コンパイラの抽象化マクロの使用] (Embedded Coder) を選択します。

モデルをビルドするときに、生成されるコード内のグローバルなデータと関数の定義にコンパイラ抽象化マクロが適用されます。

データについては、マクロは次の形式になります。

CONST(consttype, memclass) varname;
VAR(type, memclass) varname;

ここで

consttype および type はデータ型です。
memclass はマクロ文字列 SWC_VAR (SWC はソフトウェアコンポーネント識別子) です。
varname は変数識別子です。

関数 (モデルおよびサブシステム) については、マクロは次の形式になります。

FUNC(type, memclass) funcname(void)

ここで

type は戻り引数のデータ型です。
memclass はマクロ文字列です。この文字列はランナブル (外部関数) については SWC_CODE に、内部関数については、SWC_CODE_LOCAL になります (SWC はソフトウェアコンポーネント識別子)。

[AUTOSAR コンパイラの抽象化マクロの使用] オプションを選択 "しない" 場合は、コードジェネレーターによって次のコードが生成されます。

/* Block signals (auto storage) */
BlockIO rtB;

/* Block states (auto storage) */
D_Work rtDWork;

/* Model step function */
void Runnable_Step(void)

[AUTOSAR コンパイラの抽象化マクロの使用] オプションを選択した場合は、コードジェネレーターによってコード内にマクロが生成されます。

/* Block signals (auto storage) */
VAR(BlockIO, SWC1_VAR) rtB;

/* Block states (auto storage) */
VAR(D_Work, SWC1_VAR) rtDWork;

/* Model step function */
FUNC(void, SWC1_CODE) Runnable_Step(void)

ルートレベルの行列の I/O

多次元配列をもつ AUTOSAR コンポーネントモデルの場合、モデルコンフィギュレーションパラメーター [配列のレイアウト] (Simulink Coder) を [行優先] に設定すると、生成された C コードで多次元配列の次元を保持できます。生成されたコードで配列の次元を保持すると、コード統合を向上させることができます。

アプリケーション設計に [列優先] 配列レイアウトが必要である場合、ルートレベルの行列 I/O をサポートするように ARXML エクスポートを設定できます。行列を 1 次元配列で実装する ARXML 記述がエクスポートされます。

既定では、[列優先] 配列レイアウトの場合、ルートレベルの行列 I/O は許可されません。モデルをビルドすると、エラーが生成されます。ルートレベルの行列 I/O を有効にするには、モデルコンフィギュレーションパラメーター [1 次元配列を使用したルートレベルの行列の I/O のサポート] (Embedded Coder) を選択します。

[配列のレイアウト] が [行優先] に設定されている場合、[1 次元配列を使用したルートレベルの行列の I/O のサポート] は影響しません。

AUTOSAR XML オプションの検査

AUTOSAR ディクショナリを使用して設定した XML オプションを確認します。まだ設定していない場合は、AUTOSAR XML オプションの設定を参照してください。

AUTOSAR の C ファイルと XML ファイルの生成

AUTOSAR コード生成オプションと XML オプションを設定したら、コードを生成します。C コードを生成して XML 記述をエクスポートするには、コンポーネントモデルをビルドします。

ビルドプロセスにより、AUTOSAR 準拠の C コードと AUTOSAR XML 記述がモデルビルドフォルダーに生成されます。エクスポートされた XML ファイルには次のものが含まれます。

[エクスポートされた XML ファイルのパッケージ化] を [単一のファイル] または [モジュラー] のどちらに設定するかに基づく、1 つ以上の modelname*.arxml ファイル。
ARXML ファイルを Simulink にインポートした場合は、同じファイルの更新されたバージョン。

AUTOSAR ディクショナリで設定された [エクスポートされた XML ファイルのパッケージ化] オプションの値に基づいて生成される modelname*.arxml ファイルを次の表に示します。

[エクスポートされた XML ファイルのパッケージ化] の値	エクスポートされるファイル名	既定の内容
`単一のファイル`	`modelname.arxml`	ソフトウェアコンポーネント、データ型、実装、インターフェイスおよびタイミングの AUTOSAR 要素。
`モジュラー`	`modelname_component.arxml`	以下を含むソフトウェアコンポーネント: 端子イベントランナブルインターランナブル変数 (IRV) インクルードデータ型セットコンポーネントスコープのパラメーターと変数これは Simulink モデルに対してエクスポートされるメイン ARXML ファイルです。ソフトウェアコンポーネントに加え、コンポーネントファイルには、AUTOSAR 要素カテゴリに基づいてエクスポーターがデータ型、実装、インターフェイス、またはタイミングファイルに移動しない、パッケージ化可能な要素が含まれます。
	`modelname_datatype.arxml`	以下を含むデータ型と関連付けられている要素: アプリケーションデータ型ソフトウェアの基本データ型データ型のマッピングセット定数指定物理データの制約システム定数ソフトウェアのアドレスメソッドモード宣言グループ計算方法単位と単位グループソフトウェアレコードレイアウト内部データ制約
	`modelname_implementation.arxml`	ソフトウェアコンポーネントの実装 (コード記述子など)。
	`modelname_interface.arxml`	インターフェイス (S-R、C-S、M-S、NV、パラメーター、トリガーなどのインターフェイス)。インターフェイスには、S-R データ要素、C-S オペレーション、ポートベースのパラメーター、トリガーなどの型固有の要素が含まれます。
	`modelname_timing.arxml`	タイミングモデル (ランナブル実行順序制約など)。

AUTOSAR XML コンポーネント記述は AUTOSAR オーサリングツールにマージして戻すことができます。AUTOSAR コンポーネント情報は、マージを容易にするために個別のファイルに分割されます。分割は必要なマージ数が最小になるように行われます。データ型ファイルはオーサリングツールにマージする必要はありません。データ型は通常、設計プロセスの初期段階で定義されるからです。ただし、内部動作ファイルについては、その情報がモデル実装の一部となるので、マージしなければなりません。

AUTOSAR オーサリングツール (AAT) と Simulink モデルベースデザイン環境の間において AUTOSAR 要素のラウンドトリップをサポートするために、コードジェネレーターは ARXML インポートおよびエクスポートの全体において AUTOSAR 要素とその汎用一意識別子 (UUID) を保持します。詳細については、AUTOSAR XML ファイル構造と要素情報のラウンドトリップの保存を参照してください。

Simulink モデルから AUTOSAR に準拠した C コードを生成して AUTOSAR XML コンポーネント記述をエクスポートする方法の例については、AUTOSAR C コードおよび XML 記述の生成を参照してください。

すべての XML オプションについては、AUTOSAR XML Options Settingsを参照してください。