AUTOSAR コンポジション XML 記述およびコンポーネントコードの生成とパッケージ化

Simulink^® Coder™ および Embedded Coder^® ソフトウェアを使用している場合、AUTOSAR アーキテクチャモデルから次を実行できます。

コンポジションとコンポーネントの AUTOSAR XML (ARXML) 記述をエクスポートし、コンポーネントコードを生成する。
オプションで、再置換や統合などのために、モデルの階層構造からビルドアーティファクトをパッケージ化した ZIP ファイルを作成する。
オプションで、ECU 構成をもつ AUTOSAR Classic アーキテクチャモデルの場合、コンポジションのソフトウェアコンポーネントを AUTOSAR ECU にマッピングする ECU 抽出をエクスポートする。

エクスポートは、アーキテクチャモデル全体、入れ子になったコンポジション、単一のコンポーネントに対して可能です。あるコンポジションを含むエクスポートを開始した場合、そのエクスポートには、そのコンポジション、コンポーネントプロトタイプ、コンポジションのポートおよびコネクタの XML 記述が含まれます。

コンポジション XML オプションの設定

ARXML ファイルのエクスポートの準備として、XML オプションを確認し、変更します。エクスポート中、アーキテクチャモデルレベルで指定された XML オプションが、モデル内の各コンポーネントに継承されます。

XML オプションを表示するには、次の手順に従います。

AUTOSAR アーキテクチャモデルを開きます。
たとえば、Classic モデル例 autosar_tpc_composition を開くには、次のように入力します。
```
openExample('autosar_tpc_composition')
```
[モデル化] タブで [エクスポート]、[XML オプションの構成] を選択します。[XML オプション] ダイアログボックスが開きます。
このダイアログボックスには、Classic アーキテクチャモデルの XML オプションが表示されます。これらのオプションに行った変更は、階層内のすべてのコンポーネントに継承されます。

XML options for an AUTOSAR classic architecture model

[System パッケージ] オプションはコンポジションレベルにのみ適用されます。Classic アーキテクチャモデルのコンポジションの ECU 抽出をエクスポートする場合、[System パッケージ] はコンポジション ARXML で生成するシステムパッケージパスを指定します。詳細については、コンポジションの ECU 抽出のエクスポートを参照してください。

R2023a において: XML オプション [エクスポートされた XML ファイルのパッケージ化] は、アーキテクチャモデルのエクスポートでサポートされます。

[エクスポートされた XML ファイルのパッケージ化] パラメーターを設定することで、Simulink で作成された AUTOSAR 要素の XML ファイルのパッケージ化の粒度を指定できます。[単一のファイル] を選択すると、XML が単一のファイルにエクスポートされます。[モジュラー] を選択すると、XML が、含まれている情報のタイプに従って名前が付けられた複数のファイルにエクスポートされます。

各 XML オプションの詳細については、Classic アーキテクチャモデルのオプションについてはAUTOSAR XML オプションの設定を、Adaptive アーキテクチャのオプションについてはAUTOSAR Adaptive XML オプションの設定を参照してください。

コンポジション XML およびコンポーネントコードのエクスポート

アーキテクチャモデルについて ARXML ファイルをエクスポートし、コードを生成するには、次のようにします。

アーキテクチャモデルを開きます。
この例では、Classic モデル例 autosar_tpc_composition を開き、次のように入力します。
```
openExample('autosar_tpc_composition')
```
アーキテクチャモデルをエクスポートします。
[モデル化] タブから [エクスポート]、[コードと ARXML の生成] を選択します。[コンポジションのエクスポート] ダイアログボックスで次を行います。
- 生成されたファイルをパッケージ化する ZIP ファイルの名前を指定します。
- オプションで、エクスポートされた ARXML ファイルを格納するフォルダーへのパスを指定します。
- Classic コンポジションから ECU 抽出をエクスポートするには、[ECU 抽出をエクスポート] を選択します。詳細については、コンポジションの ECU 抽出のエクスポートを参照してください。
エクスポートを開始するには、[OK] をクリックします。
アーキテクチャモデルのビルド中、診断ビューアーでビルドログを閲覧することができます。まず、コンポーネントモデルのそれぞれがスタンドアロンの最上位モデルビルドとしてビルドされます。最後に、コンポジション ARXML がエクスポートされます。ビルドが完了すると、現在のフォルダーに、アーキテクチャモデルのビルドフォルダー、階層構造の各コンポーネントモデル、および指定された ZIP ファイルが格納されます。
ZIP ファイルを展開します。内容は arxml フォルダーと src フォルダーに整理されています。
arxml フォルダーを確認します。
各 AUTOSAR コンポーネントには、コンポーネントおよび実装の記述ファイルが存在し、アーキテクチャモデルにはコンポジション、データ型、インターフェイス、およびタイミングの記述ファイルが存在しています。コンポジションファイルには、コンポジション、コンポーネントプロトタイプ、コンポジションのポートおよびコネクタの XML 記述が含まれます。データ型ファイル、インターフェイスファイル、およびタイミングファイルには、アーキテクチャモデルの全階層の要素が集約されています。
src フォルダーを確認します。
各コンポーネントモデルについてビルドフォルダーがあり、そこにはスタンドアロンのモデルビルドからのアーティファクトが格納されています。

アーキテクチャモデルに含まれる入れ子にされたコンポジションまたは単一のコンポーネントをエクスポートするには、コンポジションまたはコンポーネントブロックキューを使用するか、右クリックオプションを使用します。たとえば、コンポーネントブロックを右クリックして [コンポーネントのエクスポート] を選択します。アーキテクチャモデルからエクスポートされたコンポーネントは、アーキテクチャモデルレベルで指定された XML オプションを継承します。

アーキテクチャモデルをエクスポートする際、アーキテクチャモデルと階層内のコンポーネントモデル間で AUTOSAR スキーマバージョンが一致していなければなりません。エクスポートでバージョン相違のフラグが出された場合、コンポーネントモデルかアーキテクチャモデルのいずれかで不一致を修正します。アーキテクチャモデルのスキーマバージョンを表示するには、[コンフィギュレーションパラメーター] ダイアログボックスを開きます。[モデル化] タブで [モデル設定] を選択します。ダイアログボックスで AUTOSAR コード生成オプションのペインを表示します。

アーキテクチャモデルの階層構造をプログラム的にエクスポートするには、アーキテクチャ関数 export を使用します。たとえば、モデル例 autosar_tpc_composition の ARXML ファイルとコードを生成し、パッケージ化するには、次のようにします。

% Load AUTOSAR architecture model
archModel = autosar.arch.loadModel('autosar_tpc_composition');
% Export ARXML descriptions and code into ZIP file
export(archModel,'PackageCodeAndARXML','myArchModel.zip');

コンポジションの ECU 抽出のエクスポート

AUTOSAR Classic アーキテクチャモデルのコンポジションから ECU 抽出をエクスポートできます。ECU 抽出は AUTOSAR ECU 構成に対する重要な入力です。AUTOSAR Classic アーキテクチャで、最上位のコンポジションは 1 つの AUTOSAR ECU にマッピングされたソフトウェアコンポーネントをモデル化できます。ECU スコープのシステムのソフトウェア記述を作成するには、コンポジションから ECU 抽出をエクスポートします。

開いているアーキテクチャモデルで、Simulink ツールストリップ、ソフトウェアアーキテクチャキャンバス、または関数 export を使用して ARXML をエクスポートできます。たとえば、[モデル化] タブから [エクスポート] 、 [コードと ARXML の生成] を選択します。[コンポジションのエクスポート] ダイアログボックスで、オプション [ECU 抽出をエクスポート] を選択します。エクスポートを開始するには、[OK] をクリックします。

ECU 抽出を生成するために、ソフトウェアはコンポジション内のソフトウェアコンポーネントを ECU に自動的にマッピングします。コンポジションに入れ子にされたコンポジションが含まれている場合、ソフトウェアはコンポーネントのみが含まれているフラットなバージョンのコンポジション階層構造を使用します。たとえば、これらの関数呼び出しは、入れ子にされたコンポジションを含む AUTOSAR アーキテクチャモデル例 autosar_tpc_composition の ECU 抽出をエクスポートします。

% Open and export AUTOSAR architecture model, generating ECU extract
archModel = 'autosar_tpc_composition';
openExample(archModel);
export(archModel,'ExportECUExtract',true);

export 関数呼び出しは、コンポジションフォルダー内にあるファイル System.arxml への ECU 抽出を生成します。autosar_tpc_composition の ECU 抽出は、最上位のコンポジションおよび入れ子にされた Sensors コンポジション両方のコンポーネントを 1 つの ECU にマッピングします。

<SYSTEM UUID="...">
    <SHORT-NAME>EcuExtract</SHORT-NAME>
    <CATEGORY>ECU_EXTRACT</CATEGORY>
    <MAPPINGS>
        <SYSTEM-MAPPING UUID="...">
            <SHORT-NAME>SystemMapping</SHORT-NAME>
            <SW-MAPPINGS>
                <SWC-TO-ECU-MAPPING UUID="...">
                    <SHORT-NAME>SwcToEcuMapping</SHORT-NAME>
                    <COMPONENT-IREFS>
                        <COMPONENT-IREF>
                            <TARGET-COMPONENT-REF DEST="SW-COMPONENT-PROTOTYPE">
                              /Components/TPC_Composition/Ctrl
                            </TARGET-COMPONENT-REF>
                        </COMPONENT-IREF>
                        ...
                        <COMPONENT-IREF>
                            <TARGET-COMPONENT-REF DEST="SW-COMPONENT-PROTOTYPE">
                              /Components/TPC_Composition/PedalSensor
                            </TARGET-COMPONENT-REF>
                        </COMPONENT-IREF>
                    </COMPONENT-IREFS>
                    <ECU-INSTANCE-REF DEST="ECU-INSTANCE">
                      /System/EcuInstance
                    </ECU-INSTANCE-REF>
                </SWC-TO-ECU-MAPPING>
            </SW-MAPPINGS>
        </SYSTEM-MAPPING>
    </MAPPINGS>
    <ROOT-SOFTWARE-COMPOSITIONS>
        <ROOT-SW-COMPOSITION-PROTOTYPE UUID="...">
            <SHORT-NAME>RootSwCompositionPrototype</SHORT-NAME>
            <SOFTWARE-COMPOSITION-TREF DEST="COMPOSITION-SW-COMPONENT-TYPE">
              /Components/TPC_Composition
            </SOFTWARE-COMPOSITION-TREF>
        </ROOT-SW-COMPOSITION-PROTOTYPE>
    </ROOT-SOFTWARE-COMPOSITIONS>
</SYSTEM>

<ECU-INSTANCE UUID="...">
    <SHORT-NAME>EcuInstance</SHORT-NAME>
</ECU-INSTANCE>

ECU 抽出が含まれるシステムパッケージの AUTOSAR パッケージパスを指定するには、コンポジション XML オプション [System パッケージ] を使用します。[System パッケージ] パスの値を表示するには、[モデル化] タブから [エクスポート]、[XML オプションの構成] を選択します。

あるいは、AUTOSAR プロパティ関数 get と set を使用して、AUTOSAR システムパッケージパスを設定します。

openExample('autosar_tpc_composition');
arProps = autosar.api.getAUTOSARProperties('autosar_tpc_composition');
set(arProps,'XmlOptions','SystemPackage','/System');
systemPackage = get(arProps,'XmlOptions','SystemPackage');

AUTOSAR パッケージの階層構造の詳細については、AUTOSAR パッケージの構成を参照してください。

Simulink Report Generator を使用した AUTOSAR ソフトウェアアーキテクチャのレポートの生成

System Composer™ および Simulink Report Generator™ のライセンスをお持ちの場合、AUTOSAR アーキテクチャモデルとそのアーティファクトのレポートを生成できます。詳細については、System Composer Report Generation for Software Architectures (System Composer)を参照してください。

参考

Software Composition | Classic Component | export