データインターフェイスの構成

Embedded Coder^® では、モデルでのデータ要素および関数のカテゴリに既定の構成を指定して、データと関数インターフェイスの設定に必要な作業を減らすことができます。既定の構成を適用すると、大きいモデルや、マルチインスタンスコードの生成に使用するモデルの場合は特に、時間が節約でき、コードのエラーの発生リスクを抑えることができます。既定の構成を適用した後、選択的にデータ要素および関数の既定の設定をオーバーライドすることもできます。

次を実行するように関数 RollAxisAutopilot_step を構成して、モデル RollAxisAutopilot のデータインターフェイスをカスタマイズします。

外部ファイル roll_input_data.h および roll_input_data.c で宣言および定義されているグローバル変数から入力データを読み込みます。
コードジェネレーターによって output_data.h で宣言され、output_data.c で定義されているグローバル変数に出力データを書き込みます。

変更を行うには、これらの外部コードファイルを現在の MATLAB^® 作業フォルダーで使用します。

roll_input_data.c
roll_input_data.h
roll_heading_mode.c
roll_heading_mode.h

実行するデータインターフェイス構成の変更は、コード生成やビルドプロセスでこれらのファイルにアクセス可能かどうかによって異なります。ビルドプロセスでは、これらのファイル内のコードで生成されたコードをコンパイルします。

データの既定のコード生成の設定

既定のコード生成の構成をモデルの入力端子と出力端子用に設定します。

[C コード] タブで、[コードインターフェイス] 、 [既定のコードマッピング] を選択します。
モデルのルートレベルの Inport ブロックを外部コードで定義された別個のグローバル変数として生成コードに表示するように設定します。コードマッピングエディターの [Inports and Outports] でカテゴリ [Inports] を選択します。既定のストレージクラスを [ImportFromFile] に設定します。
この設定を使用すると、生成コードで、入力端子データを表すグローバル変数が定義されません。代わりに、#include ステートメントには、入力変数を宣言するヘッダーファイルが含まれます。プロパティインスペクターでヘッダーファイルの名前を指定します。
アイコンをクリックして、[HeaderFile] を roll_input_data.h に設定します。
外部ヘッダーファイル roll_input_data.h の extern 宣言での入力変数の名前の付け方を確認するには、MATLAB コマンドウィンドウで、現在の作業フォルダーにある roll_input_data.h を開きます。
```
extern boolean_T AP_Eng;
extern real32_T HDG_Ref;
extern real32_T Rate_FB;
extern real32_T Phi;
extern real32_T Psi;
extern real32_T TAS;
extern real32_T Turn_Knob;
```
グローバル変数のコード生成命名規則を設定します。既定では、コードジェネレーターは、接頭字 rt を使用してグローバル変数に名前を付けます。コードジェネレーターで、roll_input_data.h の外部変数宣言と一致するコードを生成するには、それに合わせてグローバル変数用にコード生成の命名規則を設定します。
1. [モデルコンフィギュレーションパラメーター] ダイアログボックスを開きます。ツールストリップで、[C コード] タブの [設定] をクリックします。
2. [コード生成] 、 [識別子] ペインに移動します。
3. パラメーター [グローバル変数] を命名規則 $N$M (rt 接頭字を削除します) に設定します。トークン $N は、モデル内のデータ要素の名前 (たとえば、Inport ブロックまたは Outport ブロックの名前) を表します。トークン $M は、コード内の他のグローバルシンボルとの名前の競合を回避するためにコードジェネレーターで必要に応じて挿入される名前マングリングテキストを表します。
4. 変更を適用します。
モデルのルートレベルの Outport ブロックを別個のグローバル変数として生成コードに表示するように設定します。コードマッピングエディターの [Data Defaults] タブを使用して、カテゴリ [出力端子] の場合は、[ストレージクラス] を [ExportToFile] に設定します。
生成されたコードでは、プロパティインスペクターを使用して指定したヘッダーファイルと定義ファイルで出力端子変数が宣言および定義されます。
アイコンをクリックして、[HeaderFile] を roll_output_data.h に設定し、[DefinitionFile] を roll_output_data.c に設定します。
外部ソースファイル roll_input_data.c および roll_heading_mode.c を含めて、モデルのコード生成を設定します。[コンフィギュレーションパラメーター] ダイアログボックスで、[コード生成] 、 [カスタムコード] 、 [コード情報] 、 [ソースファイル] を roll_input_data.c roll_heading_mode.c に設定します。次に、[適用] をクリックし、[OK] をクリックします。
モデルを保存します。[ビルド] ボタンをクリックしてコードを再生成します。
コンパイラエラーには、変数 HDG_Mode が宣言されていないことが示されます。その変数は、入力端子の既定のヘッダーファイルとして宣言したヘッダーファイル roll_input_data.h で宣言されていません。このエラーは、このチュートリアルの次のセクションで修正します。
モデルは、コード生成が完了した後にコード生成レポートを開くよう設定されています。このチュートリアルの後半で調査するこのレポートウィンドウを最小化します。
Inport ブロックは、外部ヘッダーファイルを使用して入力変数を宣言および定義するよう設定しました。コードビューで、生成されたコードにこの外部ヘッダーファイルが含まれているか、roll_input_data.h を検索して確認します。
ルートレベルの Inport ブロック名 HDG_Ref を検索します。入力時に、緑色の V アイコンを使用して検索の提案を選択します。この検索の提案では、生成されたコードで変数として使用される HDG_Ref のインスタンスが検索されます。HDG_Ref が別個のグローバル変数として定義されているか確認します。
モデル RollAxisAutopilot の Outport ブロック Ail_Cmd をクリックします。ブロックの上の省略記号メニューの上にカーソルを置き、[コードに移動] をクリックします。コードビューで、ブロックに対応する RollAxisAutopilot.c 内のコードが強調表示されます。コードで、出力変数 Ail_Cmd にカーソルを合わせます。[トレーサビリティ] ダイアログボックスには、変数定義が表示されます。このダイアログボックスでは、Ail_Cmd が別個のグローバル変数として定義されているか確認できます。定義コードをクリックすると、roll_output_data.c に定義が表示されます。

個別データ要素の既定の設定のオーバーライド

[Data Defaults] でカテゴリに対して選択した設定は、モデルのそのカテゴリ内の要素に適用されます。個別のデータ要素の既定の設定をオーバーライドするには、コードマッピングエディターを使用します。

入力端子と出力端子の既定の設定を構成した後にコードを生成すると、コンパイラエラーに HDG_Mode が宣言されていないことが示されていました。このエラーは、Inport ブロック HDG_Mode の既定の構成をオーバーライドして修正できます。

コードマッピングエディターの [Inports] タブで、ソース HDG_Mode を選択します。
[ストレージクラス] を [ImportFromFile] に設定します。
アイコンをクリックし、[識別子] を HDG_Mode に設定し、[ヘッダーファイル] を roll_heading_mode.h に設定します。
これらの設定に基づいて、コードジェネレーターではヘッダーファイル roll_heading_mode.h から外部変数 HDG_Mode の宣言がインポートされます。
```
extern boolean_T HDG_Mode;
```
モデルを保存し、コードを再生成します。
このチュートリアルの後半で調査するコード生成レポートウィンドウは最小化します。
コードビューで、roll_heading_mode.h を検索し、それが既定の構成ファイル roll_input_data.h で生成されたコードに含まれているか確認します。
HDG_Mode を検索し、それが別個のグローバル変数として定義されていることを確認します。

次に、モデルパラメーターが生成されたコードでグローバル変数になるよう設定します。グローバル変数として、パラメーター値を実行時に調整できます。

Simulink モデルからの C コードの生成