C 関数プロトタイプコントロールのサポート

この節では、カスタムの組み込みターゲットを設定して関数プロトタイプコントロールをサポートする方法を説明します。説明されている変更を行わないと、エントリポイント関数インターフェイスをカスタマイズするインターフェイスを使用できません。

関数プロトタイプコントロールは、サービスインターフェイスで構成されたコンポーネントモデルではサポートされません。詳細については、Model Code Interfaces (Embedded Coder)およびChoose Code Interface for Code Generation (Embedded Coder)を参照してください。

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

C 関数プロトタイプコントロールとカスタムターゲットについて

C 関数プロトタイプコントロールをサポートするための要件を次に示します。

システムターゲットファイルは ERT システムターゲットファイルから派生させなければなりません。
C 関数プロトタイプコントロール準拠の宣言に示すように、システムターゲットファイルは C 関数プロトタイプコントロール準拠を宣言しなければなりません。
システムターゲットファイルがカスタムの静的メインプログラムを使用する場合、および既定でない関数プロトタイプコントロールコンフィギュレーションがモデルに関連付けられている場合、カスタムの静的メインプログラムでの C 関数プロトタイプコントロールのサポートに示すように、静的メインプログラムは、関数プロトタイプが制御する初期化関数とステップ関数を呼び出さなければなりません。

カスタムターゲットのオプション機能を設定する方法の例については、システムターゲットファイルのカスタマイズを参照してください。

C 関数プロトタイプコントロール準拠の宣言

ターゲットの C 関数プロトタイプコントロール準拠を宣言するには、ModelStepFunctionPrototypeControlCompliant フラグを設定するコールバック関数を実装して、システムターゲットファイルの rtwgensettings 構造体の SelectCallback フィールドにコールバック関数をインストールしなければなりません。コールバック関数は、システムターゲットファイルブラウザーでターゲットが選択されるたびにトリガーされます。たとえば、次のシステムターゲットファイルコードは、custom_select_callback_handler という名前の関数 SelectCallback をインストールします。

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

関数 SelectCallback への引数 (hDlg、hSrc) は、コールバック API 関数によって使用されるプライベートデータのハンドルです。これらのハンドルは、システムターゲットファイルコールバック関数内での使用に制限され、変更されることなく渡されます。

コールバック関数は、次に示すように ModelStepFunctionPrototypeControlCompliant フラグを設定しなければなりません。

slConfigUISetVal(hDlg,hSrc,'ModelStepFunctionPrototypeControlCompliant','on');
slConfigUISetEnabled(hDlg,hSrc,'ModelStepFunctionPrototypeControlCompliant',false);
hSrc.getConfigSet.refreshDialog;

システムターゲットファイルコールバック API の詳細については、関数 slConfigUIGetVal、slConfigUISetEnabled および slConfigUISetVal のリファレンスページを参照してください。

ModelStepFunctionPrototypeControlCompliant ターゲットコンフィギュレーションパラメーターが on に設定されている場合は、[C Step 関数インターフェイスの設定] ダイアログボックスを使用して、レートベースモデルに対して生成された基本レートのステップ関数の関数プロトタイプを制御できます。

カスタムの静的メインプログラムでの C 関数プロトタイプコントロールのサポート

ターゲットがカスタムの静的メインプログラムを使用する場合、および既定でない関数プロトタイプコントロールコンフィギュレーションがモデルに関連付けられている場合、静的メインプログラムを更新して、関数プロトタイプが制御する初期化関数とステップ関数を呼び出さなければなりません。そのためには、以下のいずれかを実行します。

モデルデータを宣言して、関数プロトタイプが制御する初期化関数とステップ関数を呼び出すように静的メインプログラムを手動で適用させます。
モデルコンフィギュレーションパラメーター [メインプログラム例の生成] を選択してメインプログラムを生成します。生成されたメインプログラムは、モデルデータを宣言して、関数プロトタイプが制御する初期化関数とステップ関数を呼び出します。