モデルに対する複数のコードマッピングの管理

コードマッピングは、コード生成の構成をモデル設計から切り離します。この分離により、プラットフォームに依存せず、さまざまなターゲットプラットフォーム環境に展開できるように準備されたモデルを設計できます。必要な製品にアクセスできる場合、モデルを複数の異なるプラットフォームのコードマッピングに関連付けることができます。

プラットフォーム	システムターゲットファイル	プログラミング言語	必要な製品
C ラピッドプロトタイピング	GRT ベース	C	Simulink^® Coder™
C 製品	ERT ベース	C	Embedded Coder^®
C++ 製品	ERT ベース	C++	Embedded Coder
AUTOSAR Classic	AUTOSAR	C	AUTOSAR Blockset、Embedded Coder (コード生成用)
AUTOSAR Adaptive	AUTOSAR Adaptive	C++	AUTOSAR Blockset、Embedded Coder (コード生成用)

さまざまなプラットフォームのコードをモデルまたはモデルの階層構造から生成できます。モデルの階層構造に含まれるモデルは同じプラットフォームに関連付けます。

Simulink では、次のいずれかを行うと既存のコードマッピングがアクティブになります。

Simulink エディターで、モデルの Coder アプリを開き、コードマッピングをサポートする出力タイプを指定する。
コードマッピング API を使用してコードマッピングを作成する。

コードマッピングエディターおよびコードマッピングプログラミングインターフェイスにアクティブなコードマッピングが表示されて操作できます。

コンフィギュレーションセットを使用した代替コードマッピングの構成

複数のモデルコンフィギュレーションセットを作成し、アクティブなコンフィギュレーションセットを切り替えることで、モデルに対して代替コードマッピングを構成できます。Simulink では、次のモデルコンフィギュレーションパラメーターの設定に基づいて、モデルのコードマッピングを作成するか既存のコードマッピングを開きます。

システムターゲットファイル
言語
コードインターフェイスのパッケージ化

モデルのコードを生成するプラットフォームごとにコンフィギュレーションセットを作成します。コードマッピングは、次のパラメーター設定の組み合わせでサポートされます。

プラットフォーム	システムターゲットファイル	言語	コードインターフェイスのパッケージ化
C/C++ ラピッドプロトタイピング	`grt.tlc` または `grt.tlc` の導関数	`C/C++`	`Nonreusable function` または `Reusable function`
C/C++ 製品	`ert.tlc` または `ert.tlc` の導関数	`C/C++`	`Nonreusable function` または `Reusable function`
C++ 製品	`ert.tlc` または `ert.tlc` の導関数	`C++`	`C++ class`
AUTOSAR Classic	`autosar.tlc`	`C`	`Nonreusable function` または `Reusable function`
AUTOSAR Adaptive	`autosar_adaptive.tlc`	`C++`	`C++ class`

C++ プラットフォームについては、再利用可能な関数と再利用できない関数で C コードマッピングが使用されます。

目的のコンフィギュレーションセットをアクティブにします。その後、対応するコードマッピングを Simulink エディター (Simulink エディターでのコードマッピングのアクティブ化) またはコードマッピング API (プログラムによるコードマッピングの作成とアクティブ化) で開きます。

Simulink エディターでのコードマッピングのアクティブ化

Simulink エディターでモデルを開くと、次のモデルコンフィギュレーションパラメーターの設定に基づいて、モデルの既存のコードマッピングが Simulink でアクティブになります。

システムターゲットファイル
言語
コードインターフェイスのパッケージ化

次のいずれかの Coder アプリを開くと、アクティブなコンフィギュレーションセットのシステムターゲットファイル設定が Coder アプリの選択と整合しているかどうかが Simulink でチェックされます。

Simulink Coder (GRT ベースのシステムターゲットファイル)
Embedded Coder (ERT ベースのシステムターゲットファイル)
AUTOSAR Component Designer (AUTOSAR システムターゲットファイル)

Simulink で不整合が検出されると、現在のシステムターゲットファイル設定を記載したメッセージがエディターに表示され、その設定を変更するか、あるいは選択した Coder アプリを開くかが確認されます。操作をキャンセルして現在のシステムターゲットファイル設定と整合するアプリを開くか、システムターゲットファイルを変更して選択したアプリをそのまま開くことができます。

現在のシステムターゲットファイルが Coder アプリの選択と整合している場合は、Simulink で Coder アプリが開き、エディターのツールストリップにコードのタブ (たとえば [C コード] や [AUTOSAR]) が追加されます。

Coder アプリが開いた後、ツールストリップの [出力] で C または C++ コード設定を選択するか、AUTOSAR の場合はいずれかの AUTOSAR プラットフォームを選択します。その後、[コードインターフェイス] メニューを使用してコードマッピングエディターを開きます。

プログラムによるコードマッピングの作成とアクティブ化

GRT ベースと ERT ベースのモデルのプラットフォームについて、コードマッピング関数 coder.mapping.utils.create および coder.mapping.api.get を使用してコードマッピングを作成およびアクティブ化できます。

モデルに対して複数のモデルコンフィギュレーションセットオブジェクト (Simulink.ConfigSet) を設定します。たとえば、GRT と ERT の C コード構成を設定したり、再利用可能な関数の生成用と再利用できない関数のコード生成用に 2 つの ERT コード構成を設定したりできます。コンフィギュレーションセットに名前を付け、それらをモデルに付加します。
```
grtConfigObj = Simulink.ConfigSet;
set_param(grtConfigObj,'Name','grtConfig');
attachConfigSet('myModel',grtConfigObj);

ertConfigObj = Simulink.ConfigSet;
set_param(ertConfigObj,'Name','ertConfig');
attachConfigSet('myModel',ertConfigObj);
```
setActiveConfigSet および coder.mapping.utils.create を呼び出して、一方のコンフィギュレーションセットのコードマッピングをアクティブ化および作成します。
```
setActiveConfigSet('myModel','grtConfig');
grt_cm = coder.mapping.utils.create('myModel');
```
2 つ目のコンフィギュレーションセットのコードマッピングをアクティブ化および作成します。
```
setActiveConfigSet('myModel','ertConfig')
ert_cm = coder.mapping.utils.create('myModel');
```
コードマッピングタイプ SimulinkCoderC または EmbeddedCoderC を指定した coder.mapping.api.get の呼び出しを使用して、モデルコードマッピングをアクティブにします。
```
grt_cm = coder.mapping.api.get('myModel','SimulinkCoderC');
.
.
.
# Configure model data elements
.
.
..
ert_cm = coder.mapping.api.get('myModel','EmbeddedCoderC');
```

コードマッピングと Embedded Coder ディクショナリ

Embedded Coder がある場合は、Embedded Coder ディクショナリを使用して、複数のモデルから標準化されたコードを生成できます。Embedded Coder ディクショナリのモデルの定義はモデル要素とは別になっているため、Embedded Coder ディクショナリをモデルの外部の Simulink データディクショナリに格納して定義を共有できます。Separate C Code Interface Configuration Definition from Model-Specific Configurationsを参照してください。

参考

コードマッピングエディター – C | コードマッピング – C++ エディター | Simulink.ConfigSet | setActiveConfigSet | coder.mapping.api.CodeMapping