モデルまたはサブシステムのコードへの C++ クラスインターフェイスの生成

モデルコードへの C++ クラスインターフェイスを生成するには、モデルコンフィギュレーションパラメーターコードインターフェイスのパッケージ化を [C++ クラス] に設定します。生成されたインターフェイスは必要なモデルデータを C++ クラスの属性にカプセル化し、モデルエントリポイント関数を C++ クラスのメソッドにカプセル化します。C++ クラスのカプセル化の利点には、次のようなものがあります。

モデルデータへのアクセスのより厳密な制御
モデルクラスの複数のインスタンスを作成する機能
モデルコードの C++ プログラミング環境への簡単な統合

C++ クラスのカプセル化は、右クリックによる非バーチャルサブシステムのビルドにも機能します(適用される要件の詳細については、非バーチャルサブシステムコードへの C++ クラスインターフェイスの生成を参照してください)。

モデルコードへの C++ クラスインターフェイスの生成

モデルからカプセル化された C++ クラスコードを生成するには、次を行います。

モデルコンフィギュレーションパラメーター [言語] を [C++] に設定します。この選択によってモデルの C++ クラスコードインターフェイスのパッケージ化も有効になります。
モデルコンフィギュレーションパラメーター [コードインターフェイスのパッケージ化] が [C++ クラス] に設定されていることを確認します。
[マルチインスタンスコードのエラーの診断] の設定を調べます。モデルがマルチインスタンスコードの生成に対する要件に違反した場合に、表示される診断の重大度レベルを変更する必要がある場合を除き、パラメーターは既定値 [エラー] のままにしておきます。
モデルのコードを生成します。

生成されたファイル model.h および model.cpp で、C++ モデルクラスコードを調べます。たとえば、モデル例 SecondOrderSystem について生成された H ファイルから抜粋された次のコードは、モデルの C++ クラスの宣言を表しています。

/* Class declaration for model SecondOrderSystem */
class SecondOrderSystemModelClass {
  /* public data and function members */
 public:
  /* External outputs */
  ExtY_SecondOrderSystem_T SecondOrderSystem_Y;

  /* Model entry point functions */

  /* model initialize function */
  void initialize();

  /* model step function */
  void step();

  /* model terminate function */
  void terminate();

  /* Constructor */
  SecondOrderSystemModelClass();

  /* Destructor */
  ~SecondOrderSystemModelClass();

  /* Real-Time Model get method */
  RT_MODEL_SecondOrderSystem_T * getRTM();
...
};

モデルエントリポイント関数の生成と呼び出しの詳細については、生成された C 関数インターフェイスをモデルのエントリポイント関数用に構成を参照してください。

メモ

Embedded Coder^® ライセンスがあり、モデルに ERT ベースのシステムターゲットファイルを選択した場合は、生成された C++ クラスインターフェイスをカスタマイズするための [コード生成] 、 [インターフェイス] ペインの追加のパラメーターを使用します。

非バーチャルサブシステムコードへの C++ クラスインターフェイスの生成

次の要件が満たされている場合、非バーチャルサブシステムを右クリックでビルドするための C++ クラスインターフェイスを生成できます。

モデルは [C++] 言語と [C++ クラス] コードインターフェイスのパッケージ化用に構成されています。
サブシステムは関数 Model を使用して Simulink.SubSystem.convertToModelReference ブロックに変換可能です。参照モデルの変換要件は、Simulink^® のリファレンスページ Simulink.SubSystem.convertToModelReference を参照してください。

要件を満たすサブシステムの C++ クラスインターフェイスを構成するには、以下を実行します。

含まれているモデルを開いて Subsystem ブロックを選択します。
サブシステムを右クリックし、[C/C++ コード] 、 [このサブシステムをビルド] を選択します。
サブシステムのビルドが完了した後、生成されたファイル内の C++ クラスインターフェイスと HTML コード生成レポートを調べます。モデルエントリポイントメソッドの生成と呼び出しの詳細については、生成された C 関数インターフェイスをモデルのエントリポイント関数用に構成を参照してください。

Embedded Coder ライセンスがあり、モデルに ERT ベースのシステムターゲットファイルを選択した場合は、MATLAB^® コマンドの RTW.configSubsystemBuild を使用してサブシステムコードへの生成された C++ クラスインターフェイスをカスタマイズできます。

C++ クラスインターフェイスの制限

[コンフィギュレーションパラメーター] ダイアログボックスの [インターフェイス] ペインで使用可能なデータ交換インターフェイスの中で、[C++ クラス] のコード生成には C API インターフェイスのみがサポートされます。[エクスターナルモード] または [ASAP2 インターフェイス] を選択した場合は、コード生成が検証エラーで失敗します。
モデルのルートの Inport の値が Simscape™ 変換ブロックに接続されている場合、Simulink Signal Conversion ブロックをルートの Inport と Simscape 変換ブロックの間に挿入しなければなりません。Simulink Signal Conversion ブロックパラメーターのダイアログボックスで、['ブロック削減' の最適化からこのブロックを排除する] を選択します。
組み合わせた出力/更新関数を参照モデルがもつことができない場合には、C++ クラスインターフェイスを使用できません。これには、モデルの次のような場合が含まれます。
- 連続サンプル時間がある
- 状態を保存する