生成された C 関数インターフェイスをモデルのエントリポイント関数用に構成

エントリポイント関数とは

エントリポイントは、プログラムコントロール (実行) の転送が行われるコード内の場所です。main 関数 (main()) は C/C++ プログラムへのエントリポイントであり、アプリケーションが実行を開始すると呼び出されます。たとえば、関数 main などから、他の関数への呼び出しによって、関数コードにエントリポイントが提供されます。プログラムコントロールは呼び出される関数に転送されます。関数のコードが実行され、終了すると、コントロールが main または他の呼び出し関数に返されます。

モデルのコードを生成するときに、コードジェネレーターは生成されたコードを実行するために呼び出すことができる一連のエントリポイント関数を定義します。生成された関数は、外部コードまたは変更する生成された main 関数のバージョンから呼び出すことができます。

コード生成レポートの [コードインターフェイスレポート] セクションに、コードジェネレーターがモデルに対して生成するエントリポイント関数が一覧表示されます。詳細については、Analyze Generated Data Code Interface Reportを参照してください。

生成されたエントリポイント関数のタイプ

コードジェネレーターは以下のタイプのモデル関数に対してエントリポイント関数を生成します。

モデル関数のタイプ	モデルソース名	生成された既定の関数名	説明
エクスポートした関数 (Embedded Coder^® が必要)	`ExportedFunction:slIdentifier`。ここで、`slIdentifier` はモデル内の関数呼び出し Inport ブロックの名前です。	`function-call-inport-block-name` または `signal-label` (指定した場合)	エクスポートした関数モデルの場合、サブシステムのエクスポート関数。
初期化関数	`Initialize`	`model_initialize`	モデルの初期化コード。アプリケーションコードの開始位置で関数を "一度" 呼び出します。この関数を使用してリアルタイムモデルデータ構造体 (`rtM`) をリセットしないでください。
分割関数	`Partition:slIdentifier`。ここで、`slIdentifier` はモデル内のブロックから明示的に作成され、Simulink® スケジュールエディターに表示される分割 (P1 など)、または [同時実行] ダイアログのタスク名です。	`model_stepn`。ここで、`n` はいずれかのモデルサンプル周期に対して生成された関数を一意に識別します。	モデル分割の場合、出力および更新コード。モデルコンフィギュレーションパラメーター [1 つの出力/更新関数] はオンです (既定の設定)。
分割更新関数	`PartitionUpdate:slIdentifier`。ここで、`slIdentifier` はモデル内のブロックから明示的に作成され、Simulink® スケジュールエディターに表示される分割 (P1 など)、または [同時実行] ダイアログのタスク名です。	`model_outputn` と `model_updaten`。ここで、`n` はいずれかのモデルサンプル周期に対して生成された関数を一意に識別します。	モデル分割の場合、個別の関数内の出力および更新コード。モデルコンフィギュレーションパラメーター [1 つの出力/更新関数] はオフです。
周期的なマルチタスク関数	`Periodic:slIdentifier,`。ここで、`slIdentifier` はマルチタスクモデル (D1 など) の周期レートまたは連続レートに対するサンプル時間の周期に対応する注釈です。	`model_stepn`。ここで、`n` はいずれかのモデルサンプル周期に対して生成された関数を一意に識別します。	マルチタスクに対して構成されたレートベースモデル内のブロックの場合、出力および更新コード。コードジェネレーターはサンプル周期ごとに関数を生成します。モデルコンフィギュレーションパラメーター [1 つの出力/更新関数] はオンです (既定の設定)。
周期的なマルチタスク更新関数	`PeriodicUpdate:slIdentifier,`。ここで、`slIdentifier` はマルチタスクモデル (D1 など) の周期レートまたは連続レートに対するサンプル時間の周期に対応する注釈です。	`model_outputn` と `model_updaten`。ここで、`n` はいずれかのモデルサンプル周期に対して生成された関数を一意に識別します。	マルチタスクに対して構成されたレートベースモデル内のブロックの場合、個別の関数内の出力および更新コード。コードジェネレーターはサンプル周期ごとに出力関数と更新関数を生成します。モデルコンフィギュレーションパラメーター [1 つの出力/更新関数] はオフです。
周期的なシングルタスク関数	`Periodic`	`model_step`	シングルタスクに対して構成されたレートベースモデル内のブロックの場合、出力および更新コード。モデルコンフィギュレーションパラメーター [1 つの出力/更新関数] はオンです (既定の設定)。
周期的なシングルタスク更新関数	`PeriodicUpdate`	`model_output` および `model_update`	シングルタスクに対して構成されたレートベースモデル内のブロックの場合、個別の関数内の出力および更新コード。モデルコンフィギュレーションパラメーター [1 つの出力/更新関数] はオフです。
リセット関数	`Reset:slIdentifier,`。ここで `slIdentifier` はモデル内のリセット関数の名前です。	`model_reset-function-name`	モデルに Reset Function ブロックが含まれている場合、生成されるリセットコード。条件または状態をリセットするには、アプリケーションコードから関数を呼び出します。
Simulink Function	`Simulink Function:slIdentifier,`。ここで `slIdentifier` はモデル内の Simulink Function ブロックの名前です。	グローバルな Simulink Function ブロックの `function-name` またはスコープ内の Simulink Function ブロックの `model_function-name`	エクスポートした関数モデルの場合、Simulink Function ブロックのエクスポート関数。
終了関数	`Terminate`	`model_terminate`	システムをオフにするコード。ERT ベースのモデルの場合、モデルコンフィギュレーションパラメーター[終了関数が必要] (既定で設定されている) をオフにしてこの関数の生成を抑制できます。

Embedded Coder^® ソフトウェアをお持ちの場合、外部コードと生成コードの統合を容易にして、コードの標準とガイドラインに準拠するために、コードジェネレーターがモデルまたはサブシステムから関数インターフェイスを生成する方法を構成できます。

エントリポイント関数が再利用可能かどうかを設定

既定では、コードジェネレーターは、最上位モデルに対して再利用または再呼び出し可能でないコードを生成します。エントリポイント関数には void-void インターフェイスがあります。コードは、共有メモリ内にあるグローバルデータ構造体に直接アクセスすることで他のコードとやりとりします。

アプリケーションに再利用可能なマルチインスタンスのエントリポイント関数コードが必要な場合、一意のデータを使用して各関数 (インスタンス) を呼び出すようにコードジェネレーターを構成できます。この場合、コードは再呼び出し可能です。

モデルコンフィギュレーションパラメーターの[コードインターフェイスのパッケージ化]および関連するパラメーターを使用して、エントリポイント関数が再利用可能かどうかを設定します。選択するパラメーター設定は、システムターゲットファイル、プログラミング言語および引数インターフェイスに関するコンフィギュレーション選択などの要因によって異なります。

単一インスタンスの C エントリポイント関数の既定の設定

既定では、GRT ベースおよび ERT ベースのシステムターゲットファイルに対して、コードジェネレーターは単一インスタンスの C エントリポイント関数を生成します。生成コードは次を実行します。

引数のない実行関数を作成する (void-void)。
(コンパイル時に) モデルデータ構造体に対してメモリを静的に割り当てる。

単一インスタンスのエントリポイント関数のコードを構成するための既定のモデルコンフィギュレーションパラメーター設定は次の通りです。

[言語] を [C] に設定。
[コードインターフェイスのパッケージ化] を [再利用できない関数] に設定。

再利用可能なマルチインスタンス C エントリポイント関数の生成

GRT ベースまたは ERT ベースいずれかのシステムターゲットファイルに対して再利用可能なエントリポイント関数を C で生成するようにコードジェネレーターを構成できます。ただし、既定では、コードジェネレーターが生成する関数インターフェイスはさまざまです。モデルコンフィギュレーションパラメーター[言語] が [C] に設定され、[コードインターフェイスのパッケージ化]が [再利用可能な関数] に設定されていると仮定すると、コードジェネレーターは各システムターゲットファイルシナリオに対してこのエントリポイント関数コードを生成します。

システムターゲットファイルインターフェイス

GRT ベース

システムターゲットファイル	インターフェイス
GRT ベース	再呼び出し可能で、再利用可能なマルチインスタンスの C エントリポイント関数。モデルのルートレベルの Inport ブロックと Outport ブロックの値をリアルタイムモデルデータ構造体にパックします。この構造体を実行関数に引数として参照渡しします。モデルインスタンスのデータの実行時にメモリを動的に割り当てます。`malloc` などの関数を呼び出すことでメモリを割り当てます。
ERT ベース	再呼び出し可能で、再利用可能なマルチインスタンスの C エントリポイント関数。各モデルのルートレベルの Inport ブロックと Outport ブロックの値を個別の引数として実行関数に渡します。モデルデータ構造体に対してメモリを静的に割り当てます。

再呼び出し可能で、再利用可能なマルチインスタンスの C エントリポイント関数。
モデルのルートレベルの Inport ブロックと Outport ブロックの値をリアルタイムモデルデータ構造体にパックします。この構造体を実行関数に引数として参照渡しします。
モデルインスタンスのデータの実行時にメモリを動的に割り当てます。malloc などの関数を呼び出すことでメモリを割り当てます。

ERT ベース

再呼び出し可能で、再利用可能なマルチインスタンスの C エントリポイント関数。
各モデルのルートレベルの Inport ブロックと Outport ブロックの値を個別の引数として実行関数に渡します。
モデルデータ構造体に対してメモリを静的に割り当てます。

ERT ベースのシステムターゲットファイルを使用していて、再呼び出し可能で再利用可能なマルチインスタンスの C エントリポイント関数を生成する場合は、以下を検討します。

動的なメモリ割り当てを使用して、モデルデータ構造体を初期化。[モデルの初期化に動的メモリ割り当てを使用] を選択します。
モデルのルートレベルの Inport ブロックの値を構造体にパックし、ルートレベルの Outport ブロックの値を 2 番目の構造体にパックし、構造体を実行関数に引数として参照渡し。[ルートレベル I/O を以下として渡す] を [構造体参照] に設定します。
モデルのルートレベルの Inport ブロックと Outport ブロックの値をリアルタイムモデルデータ構造体にパックし、その構造体を実行関数に引数として参照渡し。[ルートレベル I/O を以下として渡す] を [モデルデータ構造体の一部] に設定します。

生成された C 関数インターフェイスの構成方法の選択

外部コードと生成コードの統合を容易にして、コードの標準とガイドラインに準拠するために、コードマッピングエディターまたはコードマッピング API を使用して、コードジェネレーターがモデルまたはサブシステムから関数インターフェイスを生成する方法を構成できます。

サービスインターフェイスで構成されたモデルについては、次を構成できます。

関数名
サブコンポーネントの関数および Simulink Function ブロックとして表されるコンポーネントモデルの関数の引数
メモリセクション

構成	詳細
モデル全体の関数のカテゴリ (初期化/終了、実行、共有ユーティリティ) に対する既定の命名規則	Configure Default Code Generation for Functions
個々のエントリポイント関数 (既定の命名規則をオーバーライドする)	個々の C エントリポイント関数に対する名前の設定
基本レートのステップエントリポイント関数に対する対話的なステップ関数インターフェイス (関数名、戻り値、引数 C 型修飾子、名前、順序)	個々のステップ関数に対する名前と引数の設定
Simulink Function ブロックと Function Caller ブロックに対する対話的な関数インターフェイス (関数名、戻り値、引数 C 型修飾子、名前、順序)	Configure Entry-Point Function Interfaces for Simulink Function and Function Caller Blocks

ソフトウェアインザループ (SIL) テストを使用して、カスタマイズされたエントリポイント関数のコードを検証できます。生成コードを使用して SIL ブロックを作成します。次に SIL ブロックをモデルに統合し、生成されたコードが元のモデルまたは非バーチャルサブシステムと同じ結果を提供することを検証します。詳細については、SIL アプローチまたは PIL アプローチの選択を参照してください。

関数カテゴリに対する既定のコード生成設定の構成

モデル全体の関数のカテゴリに対して既定の構成を指定することにより、C コード生成用にモデルを準備する作業を軽減します。たとえば、関数名規則やメモリセクションにおける関数コードの配置を構成できます。既定の構成を適用すると、多数の関数をもつモデルの場合は特に、時間が節約でき、コードでエラーが発生するリスクを抑えることができます。

コードジェネレーターはモデル関数の次のカテゴリに対して、エントリポイント関数を生成します。

関数カテゴリ	説明
初期化/終了	システムを初期化し、オフにする関数
実行	実行とリセットを開始する関数
共有ユーティリティ	共有ユーティリティ関数コード

コードマッピングエディター – C またはコードマッピング API 関数 setFunctionDefault を使用して関数の既定のコードマッピングを構成します。これらのインターフェイスを使用して、関数カテゴリをモデルの Embedded Coder ディクショナリで定義された関数カスタマイズテンプレートに関連付けることができます。

アプリケーションで、メモリ内でのエントリポイント関数の配置を構成する必要がある場合は (生成コードを特定のハードウェア向けに最適化するためなど)、既定のメモリセクションをモデル全体の関数のカテゴリに適用できます。コードマッピングエディターで、特定のメモリセクションを使用するように定義された関数カスタマイズテンプレートに関数カテゴリをマッピングします。関数カスタマイズテンプレートの作成を参照してください。

関数カスタマイズテンプレートが存在しない場合、Embedded Coder ディクショナリを使用して作成できます (Define Service Interfaces, Storage Classes, Memory Sections, and Function Templates for Software Architectureを参照)。

関数カテゴリに対する既定の構成を設定する方法の例については、Configure Default C Code Generation for Categories of Data Elements and Functionsを参照してください。

個々の C エントリポイント関数に対する名前の設定

生成された C コードがコードの標準およびガイドラインに準拠するように、またはそのコードが外部コードとより簡単に統合できるように、個々のエントリポイント関数の名前を設定できます。たとえば、モデルに対して生成された初期化関数に myInitFunc と名前を付けることができます。

モデルが少なくとも次のいずれか 1 つの条件を満たす場合は、関数の名前を個別に設定することを検討してください。

一意の命名要件をもつ複数の関数を使用する。
関数をほとんど使用しない。
関数カテゴリに対する既定の構成があり、特定の関数でこの構成をオーバーライドしなければならない。

コードマッピングエディターまたはコードマッピング API 関数 setFunction を使用して、個々のステップ関数の関数名を設定します。これらのインターフェイスを使用して、関数をモデルの Embedded Coder ディクショナリで定義された関数カスタマイズテンプレートに関連付けて、関数名を使用できます。

この例では、モデル ConfigurationInterface に対する関数 initialize の名前を変更する方法を示します。

モデルを開きます。
```
openExample('ConfigurationInterface')
```
Embedded Coder アプリを開きます。
[C コード] タブで、[コードインターフェイス] 、 [個々の要素コードのマッピング] を選択します。
コードマッピングエディターの [Function] タブで、次のいずれかの方法を使用して関数名を変更します。
- [Function Name] 列で、関数の名前を入力します。
- [Function Preview] 列で、関数プロトタイプのハイパーリンクをクリックし、設定ダイアログボックスを開きます。[C Initialize 関数名] フィールドで、関数名を入力します。[適用] をクリックし、[C 関数プロトタイプ] フィールドで変更を確認するか、[OK] をクリックしてダイアログボックスを終了し、コードマッピングエディターの [Function Preview] 列に関数名を表示します。
この例の場合、関数 initialize の名前を fcnprotoctrl_init に変更します。
モデルを保存します。
コードを生成します。
生成されたコードで変更内容を確認します。[コード] ビューで、関数名 fcnprotoctrl_init のインスタンスを検索します。関数名が生成されたファイル ConfigurationInterface.h と ConfigurationInterface.c に表示されます。
- ConfigurationInterface.h の場合:
```
extern void fcnprotoctrl_init(void);
```
- ConfigurationInterface.c の場合:
```
void fcnprotoctrl_init(void)
{
  ...
}
```

個々のステップ関数に対する名前と引数の設定

ライブスクリプトを開く

生成された C コードがコードの標準およびガイドラインに準拠するように、またはそのコードが外部コードとより簡単に統合できるように、Simulink の周期関数に対して生成された個々のステップ関数の名前と引数を設定できます。ステップ関数の以下の要素をカスタマイズできます。

関数名
引数名
引数の順序
戻り値および引数データの修飾子
引数のバッファリング最適化

モデルが少なくとも次のいずれか 1 つの条件を満たす場合は、ステップ関数の名前と引数を個別に設定することを検討してください。

コードジェネレーターが 1 つのステップ関数を生成する周期的なシングルタスクモデルである。
Execution 関数カテゴリには既定の構成があり、特定のステップ関数についてこの構成をオーバーライドしなければならない。

コードマッピングエディターまたはコードマッピング API 関数 setFunction を使用して、個々のステップ関数のコードマッピングを構成します。これらのインターフェイスを使用して、関数をモデルの Embedded Coder ディクショナリで定義された関数カスタマイズテンプレートに関連付けて、ステップ関数プロトタイプを完全にカスタマイズできます。

この例では、レートベースのシングルタスクモデルに対してステップ関数名と引数をカスタマイズする方法を示します。

構成ダイアログボックスを開く

1. モデル ConfigurationInterface.slx を開きます。

open_system("ConfigurationInterface");

2. Embedded Coder アプリを開きます。

3. [C コード] タブで、[コードインターフェイス]、[個々の要素コードのマッピング] を選択します。

4. コードマッピングエディターで、[Functions] タブをクリックします。

5. ステップ関数行の [Function Preview] 列で、プロトタイプのハイパーリンクをクリックし、[C Step 関数インターフェイスの設定] ダイアログボックスを開きます。

[C Step 関数インターフェイスの設定] ダイアログボックスの [C 関数プロトタイプ] フィールドに、関数プロトタイプに行う変更のプレビューが表示されます。

マルチインスタンスコードを生成するように構成されているモデルについては、最上位モデルからの再呼び出し可能なコードの生成を参照してください。

関数名のカスタマイズ

1. [C Step 関数インターフェイスの設定] ダイアログボックスで、[C Step 関数名前] を configinterface_run に設定します。関数プレビューが更新され、新しい関数名が反映されます。

2. [適用] をクリックし、ダイアログボックスを閉じて、モデルを保存します。

3. コードを生成し、名前の変更を確認します。

[コード] タブをクリックします。[コード] ビューのファイルリストで、ファイル ConfigurationInterface.h を選択します。[検索] フィールドで、コード要素のリストに関数名 configinterface_run が含まれていることを確認します。宣言を表示するには、この関数名を選択します。

コード内で宣言が強調表示されます。

ファイル ConfigurationInterface.c で名前の変更を検証します。ソースコード (定義) を表示するには、[検索] フィールドで configinterface_run を選択します。

他の例については、個々の C エントリポイント関数に対する名前の設定を参照してください。

関数引数のカスタマイズ

グローバルデータ構造体の設定

既定では、最上位モデルまたは参照モデルはステップ関数 void-void を使用してデータを渡します。このタイプの関数では、共有メモリにデータ構造体として保存されたグローバルデータにアクセスし、生成されたコードで外部のコードと通信できます。

ステップ関数 void-void が含まれるようにモデルを構成するには、[C Step 関数インターフェイスの設定] ダイアログボックスを開き、[ステップ関数プロトタイプの引数を設定] チェックボックスをオフにします。[C 関数プロトタイプ] プレビューで変更を確認します。

引数の設定

レートベースモデルのステップ関数は、引数を使用してデータを渡すことができます。以下の引数の設定をカスタマイズできます。

戻り値
型修飾子
名前
順序

例

1. モデルの関数プロトタイプを構成するには、既定のストレージクラスが 'Default' に設定されている必要があります。

コードマッピングエディターの [データの既定の設定] タブで、[入力端子] と [出力端子] の [ストレージクラス] を Default に設定します。

[入力端子] タブで、[In1] の [ストレージクラス] を Model default に設定します。

2. [C Step 関数インターフェイスの設定] ダイアログボックスを開きます。コードマッピングエディターで、[Functions] タブをクリックします。次に、ステップ関数の関数プレビューをクリックします。

3. [C Step 関数インターフェイスの設定] ダイアログボックスで、[ステップ関数プロトタイプの引数を設定] をオンにします。

4. [Get default] をクリックします。ダイアログボックスが展開され、関数の戻り値を設定するフィールドと、入力引数および出力引数の一覧が既定の設定とともにリストされたテーブルが表示されます。

4. ステップ関数の戻り値をカスタマイズします。[C 戻り引数] を void または出力引数の 1 つのいずれかに設定します。この例では void を選択します。

5. 各引数について、[C 型修飾子] を指定します。

型修飾子:

Value:値 (arg など)
Const:const 修飾子をもつ値 (const arg など)
Pointer to const:const 修飾子をもち、ポインターで参照される値 (const *arg など)
Pointer:ポインターによる参照 (*arg など)
Const pointer to const:const 修飾子をもち、ポインターで参照される、ポインター自体である値 (const *const arg など)

参照モデルを含むモデル

参照モデルの場合、ステップ関数インターフェイスでルート入力引数の型修飾子は Auto に設定されます。コードジェネレーターは、ソース信号から const 修飾子を破棄する型キャストを生成して、インターフェイス仕様を使用します。
参照モデルの親の場合、ソース信号の型修飾子は Auto 以外の値に設定されます。この動作をオーバーライドするには、参照モデルに const 型修飾子を追加します。

この例では、C 型修飾子を変更しません。

6. [C 識別子名] 列の値を編集して、引数の名前をカスタマイズします。

この例では、アンダースコアを削除して引数の名前を変更します (arg_In1 を argIn1 に変更するなど)。

7. テーブルの行を新しい場所にドラッグして、引数の順序をカスタマイズします。

この例では、Out1 を 1 番目の位置に移動します。

8. 行った変更を検証してから適用し、ダイアログボックスを閉じたら、モデルを保存します。

9. コードを生成し、[コード] ビューで変更内容を確認します。

[検索] フィールドに関数 configinterface_run が含まれていることをチェックして、ファイル ConfigurationInterface.h で変更内容を確認します。関数宣言を表示するには、関数名を選択します。

ファイル ConfigurationInterface.c で変更内容を確認します。関数の定義を表示するには、関数名 configinterface_run を選択します。

プレビューとは異なるプロトタイプ

[C Step 関数インターフェイスの設定] ダイアログボックスで、参照モデルの関数プロトタイプのプレビューを表示すると、生成コード内の関数プロトタイプよりも引数の数が少なく表示される場合があります。

たとえば、mdlref_counter という名前のモデルを考えます。このモデルには、入力端子 (arg_input)、出力端子 (arg_output)、限度値としてワークスペースパラメーターの引数名 lower_saturation_limit および upper_saturation_limit をもつ Saturation ブロックが含まれます。[C Step 関数インターフェイスの設定] ダイアログボックスでは、関数プロトタイプのプレビューが次のように表示されます。

mdlref_counter_custom(arg_input, arg_output)

生成されたコードでは、プロトタイプに次のパラメーター引数が含まれています。

mdlref_counter_custom(real_T arg_input, real_T arg_output, real_T 
  rtp_lower_saturation_limit, real_T rtp_upper_saturation_limit)

引数のバッファリングの最適化

モデルのステップ関数で I/O 引数に必要なバッファリングを最適化できます。入力端子と出力端子のペアを設定する際にこれらの要件を満たすと、コードジェネレーターは対応する引数をマージして、関連付けられたバッファーを再利用します。

Inport ブロックと Outport ブロックは、データ型、次元、サンプルレートを含め、同じプロパティをもたなければならない。
Inport ブロックと Outport ブロックのサンプルレートはモデルの基本レートと同じでなければならない。
条件付きで実行されるサブシステムでは Outport ブロックを駆動できない。
単一の非バーチャルブロック出力で Outport ブロックを駆動しなければならない。たとえば、複数のバッファーをマージする Mux ブロックは Outport ブロックを駆動できない。
[C Step 関数インターフェイスの設定] ダイアログボックスで、同じ C 型修飾子と識別子名で Inport と Outport を設定しなければならない。

このセクションでは、端子 In2 と端子 Out1 の引数を、モデル例 ConfigurationInterface に対してマージする方法を示します。

1. モデル ConfigurationInterface の [C Step 関数インターフェイスの設定] ダイアログボックスを開きます。

2. [ステップ関数プロトタイプの引数を設定] を選択し、引数の表示を開きます。

3. 端子 In3 と Out2 の場合、[C 型修飾子] を Pointer に、[C 識別子名] を sharedArg に設定します。

4. プレビューに argIn3 と argOut2 のマージされた引数が表示されることを確認します。

5. 行った変更を検証してから適用し、ダイアログボックスを閉じたら、モデルを保存します。

6. コードを生成して表示します。[コード] ビューで、関数 configinterface_run を検索し、関数インターフェイスを調べます。この例では、Inport ブロックには読み取りコード、Outport ブロックには書き込みコードで共有引数が表示されます。

C エントリポイント関数に対するコード生成設定のプログラムによる構成

C コード生成に対するモデル関数の構成を自動化するには、コードマッピングのプログラミングインターフェイスを使用します。たとえば、カスタムブロックライブラリまたはアプリケーションのテスト環境の一部を作成する場合、プログラミングインターフェイスを使用して関数の構成を自動化します。

これらの関数の一般的な使用法には以下が含まれます。

関数インターフェイスを作成する。
既存の関数インターフェイスを変更する。
モデルの既定の構成情報を開始点として、関数インターフェイスを作成する。
モデル関数インターフェイスを既定の ERT 関数の構成にリセットする。

C エントリポイント関数のコード生成設定をプログラムで構成する方法の例については、Configure Default Data and Function Code Generation Programmaticallyを参照してください。この例では、関数カテゴリと個々の関数に対する既定の設定の構成方法を示します。

生成されたエントリポイント関数とインターフェイスをとる方法

モデルのコードが生成された後、[コード] ビューを使用して生成されたエントリポイント関数、および該当する場合は、外部の入力端子と出力端子を表す変数を確認します。
モデルのエントリポイント関数を宣言する生成されたヘッダーファイルを含める #include ステートメントを外部コードに追加します。
生成されたファイル rtwtypes.h を含める #include ステートメントを追加します。このファイルは型定義、#define ステートメント、および列挙型を提供します。
ターゲット固有のデータ構造体とハードウェア (ADC や DAC など) を初期化します。
該当する場合は、再利用可能なモデルの各インスタンスのデータを初期化します。
該当する場合は、モデルの Inport ブロックを表す生成された変数に入力データを書き込みます。
生成されたエントリポイント関数を呼び出し、関数 rt_OneStep の使用を設定します。
該当する場合は、モデルの Outport ブロックを表す生成された変数からデータを読み取ります。

詳細については、Deploy Applications to Target Hardwareを参照してください。

C 関数インターフェイスのカスタマイズの制限事項

次の制限事項は生成された C 関数インターフェイスのカスタマイズに適用されます。

モデルコンフィギュレーションパラメーター [1 つの出力/更新関数] を選択しなければなりません。
マルチレートモデルはサポートされていますが、シングルタスクのモデルを構成しなければなりません。
Default ストレージクラスを使用するようにルートレベルの Inport および Outport を構成しなければなりません。
関数インターフェイスをカスタマイズする場合は、独自のカスタム main プログラムを提供しなければなりません。MathWorks^® が提供する静的な rt_main.c を使用して関数インターフェイスを構成することはできません。既定以外の関数インターフェイスの構成を指定すると、生成されたコードと既定の静的な rt_main.c との間に不一致が発生します。
再利用できない関数によって実装されたサブシステムが 1 つ以上の Inport の値を使用していない限り、コードジェネレーターはモデルのルート Inport に対するデータ構造体を削除します。
MAT ファイルのログを有効にするか、1 つ以上の Outport のサンプル時間が基礎的な基本レート (定数のレートも含め) ではない場合、コードジェネレーターはモデルのルート Outport に対するデータ構造体を削除します。
Subsystem ブロックをコピーして新しいモデル内または同じモデル内でブロックを作成すると、元の Subsystem ブロックの関数インターフェイス情報は新しい Subsystem ブロックにコピーされません。
Stateflow^® をお持ちの場合、モデルのルート Inport の値を使用するかモデルのルート Inport の値を使用するサブシステムを呼び出す Stateflow チャートに対しては、次のいずれかを実行してコードを生成します。
- Stateflow チャートで、[初期化時に指定されたチャートを実行 (入力)] チェックボックスをオフにします。
- 関数 Stateflow を再利用できない関数にします。
- Simulink^® Signal Conversion ブロックをルート Inport の直後に挿入します。Signal Conversion ブロックパラメーターのダイアログボックスで、['ブロック削減' の最適化からこのブロックを排除する] を選択します。
モデルのルート Inport の値が Simscape™ 変換ブロックに接続されている場合、Simulink Signal Conversion ブロックをルート Inport と Simscape 変換ブロックの間に挿入します。Signal Conversion ブロックパラメーターのダイアログボックスで、['ブロック削減' の最適化からこのブロックを排除する] を選択します。
関数インターフェイスで構成された参照モデルをビルドする際は、バーチャルバスを参照モデルに対する入力または出力として使用しないでください。代わりに、非バーチャルバスを使用します。
C 関数インターフェイスが既定ではない場合、その値はモデルコンフィギュレーションパラメーター [コード生成で固定サイズのスカラーのルート入力を値渡しで行う] で無視されます。詳細については、Pass fixed-size scalar root inputs by value for code generationを参照してください。