このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

クラシック コール インターフェイス

(削除予定) GRT システム ターゲット ファイルで構成されている R2012a より前に作成されたモデルについて、メイン プログラム モジュールと互換性があるモデル関数呼び出しを生成する

モデル コンフィギュレーション ペイン: [コード生成] / [インターフェイス]

[クラシック コール インターフェイス] パラメーターは将来のリリースで削除される予定です。GRT ベースと ERT ベースのシステム ターゲット ファイルに共通のコール インターフェイスを使用するには、このパラメーターの選択を解除します。これは既定の設定です。(R2012a 以降) モデル コンフィギュレーションを更新する方法や統一されたコール インターフェイスを使用するように GRT ベースのカスタム システム ターゲット ファイルを移行する方法の詳細については、バージョン履歴を参照してください。

説明

[クラシック コール インターフェイス] パラメーターは、GRT システム ターゲット ファイルで構成されている R2012a より前に作成されたモデルについて、生成されるメイン プログラム モジュールと互換性があるモデル関数呼び出しを生成するかどうかを指定します。

このパラメーターの設定に応じて、[1 つの出力/更新関数] パラメーターが有効または無効になります。パラメーターの選択を解除すると、[1 つの出力/更新関数] が有効になります (選択されるわけではありません)。このパラメーターを選択すると、[1 つの出力/更新関数] は無効になります。

このパラメーターは次の場合はサポートされません。

• データ型置換を使用している。

• [システム ターゲット ファイル] パラメーターが ERT ベースのシステム ターゲット ファイルに設定されていて、モデルがサービス コード インターフェイスを使用するように構成されている。

依存関係

このパラメーターを有効にするには、次のようにします。

• [コード インターフェイスのパッケージ化] パラメーターを [再利用できない関数] または [再利用可能な関数] に設定します。

• サブシステムの [別々のデータをもつ関数] ブロック パラメーターの選択を解除します。

設定

Off (既定値) | On

オン

GRT ベースのシステム ターゲット ファイルで構成されている R2012a より前に作成されたモデルについて、メイン プログラム モジュール (grt_main.c または grt_main.cpp) と互換性があるモデル関数呼び出しを生成します。

このパラメーターにより、R2012a より前の grt_main.c ファイルまたは grt_main.cpp ファイルをベースにしたメイン プログラム モジュールをもつ GRT ベースのカスタム システム ターゲット ファイルを使用して、現在のリリースで生成されたコードをすばやく使用できます。

オフ

クラシック コール インターフェイスを無効にします。

推奨設定

アプリケーション	設定
デバッグ	影響なし
トレーサビリティ	オフ
効率性	オフ (実行、ROM)、影響なし (RAM)
安全対策	推奨なし

プログラムでの使用

パラメーター: GRTInterface

型: 文字ベクトル

値: 'on' | 'off'

既定の設定: 'off' (ただし、R2012a より前に作成された GRT モデルでは 'on')

バージョン履歴

R2006a より前に導入

R2024a: 削除予定

[クラシック コール インターフェイス] (GRTInterface) パラメーターは将来のリリースで削除される予定です。R2012a で、GRT ベースと ERT ベースのシステム ターゲット ファイルで構成されたモデルについて、生成される C および C++ のエントリポイント関数のコール インターフェイスが統一されて簡略化されました。[クラシック コール インターフェイス] パラメーターは、元の GRT ベースのコール インターフェイスを維持する場合のために同じリリースで導入されたものです。

次の表は、生成されるエントリポイント関数のクラシック コール インターフェイスと統一されたコール インターフェイスを比較したものです。

クラシック コール インターフェイスと統一されたコール インターフェイスの比較

クラシック コール インターフェイス	統一されたコール インターフェイス
void MdlInitializeSizes(void); void MdlInitializeSampleTimes(void); void MdlStart(void); void MdlOutputs(Int_T tid); void MdlUpdate(Int_T tid); void MdlTerminate(void);	void model_initialize(void); void model_step; /* single-tasking */ void model_step(tid); /* multitasking */ void model_reset(void); void model_terminate(void);

統一されたコール インターフェイスを使用するエントリポイント関数を生成するには、[クラシック コール インターフェイス] の選択を解除します。次に、モデルからコードを生成し、生成される main プログラム例でコール インターフェイスのコードを検証します。

統一されたコール インターフェイスを使用するように GRT ベースのカスタム システム ターゲット ファイルを移行するには、カスタム システム ターゲット ファイルを変更して、該当する宣言のコード行を削除するか、クラシック コール インターフェイスを無効にします。サポートを削除または変更する手順は、サポートの宣言方法に応じて異なります。サポートはシステム ターゲット ファイルで直接宣言されている場合と、システム ターゲット ファイルの RTW_OPTION セクションで宣言されたコールバック関数で宣言されている場合があります。コールバック関数は rtwgensettings 構造体の SelectCallback フィールドで宣言されています。

• 直接の宣言

  直接の宣言は次のようになります。

  rtwgensettings.SelectCallback = 'slConfigUISetVal(hDlg,hSrc,...
       ''GRTInterface'',''on'');';

  ステートメントを削除するか、''on'' を ''off'' に変更します。

• 宣言されたコールバック関数

  rtwgensettings 構造体でのコールバック関数の宣言は次のようになります。ここで、enableClassicCallInterface はパラメーター GRTInterface を設定する SelectCallback 関数の名前です。

  rtwgensettings.SelectCallback = 'enableClassicCallInterface(hDlg,hSrc)';

  宣言を削除するか、コールバック関数を更新してクラシック コール インターフェイスを無効にします。コールバック関数 enableClassicCallInterface でクラシック コール インターフェイスを無効にするステートメントは次のとおりです。

  slConfigUISetVal(hDlg, hSrc, 'GRTInterface', 'off');
  slConfigUISetEnabled(hDlg, hSrc, 'GRTInterface', true);

静的メイン プログラムの変更が必要になることもあります。たとえば、以下が必要になる場合があります。

• エントリポイント関数 MdlInitializeSizes、MdlInitializeSampleTimes、および MdlStart の呼び出しを model_initialize の呼び出しと置き換える。

• エントリポイント関数 MdlOutputs および ModelUpdates の呼び出しを model_step または model_step(tid) の呼び出しと置き換える。これは、モデル コンフィギュレーション パラメーター [1 つの出力/更新関数] を選択するのと同じ結果になります。

• エントリポイント関数 MdlTerminate の呼び出しを model_terminate の呼び出しと置き換える。

統一されたコール インターフェイスに対して生成されるエントリポイント関数の詳細については、model_initialize、model_reset、model_step、および model_terminate を参照してください。システム ターゲット ファイルの更新の詳細については、システム ターゲット ファイルのカスタマイズを参照してください。

参考

トピック

• モデル コンフィギュレーション パラメーター: コード生成インターフェイス