非バーチャルサブシステムのモジュラー関数コードの生成

非バーチャルサブシステムのコード生成について

既定では、非バーチャルサブシステムのコードを作成すると、コードジェネレーターによって、非バーチャルサブシステムに関連付けられた内部データが親モデルの内部データと同じデータ構造体に配置されます。これにより、特に再利用できないサブシステムの場合は、コードをトレースおよびテストするのが困難になる場合があります。また、非バーチャルサブシステムを含む大規模なモデルでは、データ構造体が大きくなり、コンパイルが難しくなる可能性があります。

Atomic サブシステムや条件付き実行サブシステムを含む、非バーチャルサブシステムのモジュラー関数コードを生成するには、Subsystem ブロックパラメーターの [別々のデータをもつ関数] を使用します。このブロックパラメーターは、コードジェネレーターに対し、親モデルのデータ構造体に依存しない非バーチャルサブシステム関数のブロック I/O と DWork データ構造体を生成するように指示します。その結果、サブシステムに対して生成されたコードは次のようになります。

簡単にトレースできる。
簡単にテストできる。
モデルのグローバルデータ構造体のサイズが削減される。

[別々のデータをもつ関数] パラメーターを使用するには、次を実行します。

ERT ベースのシステムターゲットファイルを使用してモデルを設定する。
サブシステムが Atomic または条件付き実行になるように設定する。
Subsystem ブロックパラメーター [関数のパッケージ化] を [再利用できない関数] に設定する。

モジュラー関数コードを生成するためにサブシステムを構成するには、[Subsystem パラメーター] ダイアログボックスを開き、表示されている一連の選択を行い、[別々のデータをもつ関数] オプションを有効にします。詳細については、モジュラー関数コードを生成するためのサブシステムの設定と非バーチャルサブシステムのモジュラー関数コードを参照してください。適用される制限については、非バーチャルサブシステムモジュラー関数コードの制限を参照してください。

Atomic サブシステムのコードの生成の詳細については、サブシステムコードを別々の関数およびファイルとして生成および個別のサブシステムのコードと実行可能ファイルの生成を参照してください。

モジュラー関数コードを生成するためのサブシステムの設定

サブシステムを含むモデルが ERT ベースのシステムターゲットファイルを使用しているか確認します。
モジュラー関数コードを生成するサブシステムを選択し、[Subsystem パラメーター] ダイアログボックスを開きます。Atomic サブシステムのダイアログボックスを以下に示します (条件付き実行サブシステムのダイアログボックスでは、ダイアログボックスオプション [Atomic サブシステムとして扱う] がグレー表示になり、手順 3 を省略できます)。
ブロックパラメーター [Atomic サブシステムとして扱う] が選択可能であっても選択されていない場合、サブシステムは Atomic サブシステムにも条件付き実行サブシステムにもなりません。パラメーター [Atomic サブシステムとして扱う] を選択します。これにより、[コード生成] タブの [関数のパッケージ化] パラメーターが有効になります。[コード生成] タブを選択します。
[関数のパッケージ化] パラメーターの場合は、[再利用できない関数] を選択します。この選択を行った後、[別々のデータをもつ関数] パラメーターが表示されます。
[別々のデータをもつ関数] パラメーターを選択して非バーチャルサブシステムのコードを生成する前に、このパラメーターをオフにして関数コードを生成し、後で比較できるように .c ファイルおよび .h ファイルを別のディレクトリに保存しておくことを検討してください。
[別々のデータをもつ関数] パラメーターを選択します。追加のパラメーターが表示されます。
生成されるサブシステム関数とサブシステムファイルの命名を制御するために、サブシステムパラメーター [関数名オプション] と [ファイル名オプション] を変更します。
サブシステムパラメーターの変更を保存し、[OK] をクリックしてダイアログボックスを終了します。
サブシステムのコードを生成し、サブシステムパラメーターの指定に従って命名した関数 .c ファイルおよび .h ファイルを含む、生成されたファイルを調べます。

非バーチャルサブシステムのコード生成の詳細については、サブシステムコードを別々の関数およびファイルとして生成を参照してください。生成されたサブシステムの関数コードの例については、非バーチャルサブシステムのモジュラー関数コードを参照してください。

非バーチャルサブシステムのモジュラー関数コード

この例では、[別々のデータをもつ関数] パラメーターを無効および有効にして非バーチャルサブシステムの関数コードを生成し、その結果を比較する方法を示します。

モデル例 SubsystemAtomic を開きます。
Embedded Coder アプリを開きます。システムターゲットファイルを ert.tlc に変更します。
このモデルでは、バーチャルサブシステムの境界を保持する方法を説明します。Subsystem ブロックパラメーター [Atomic サブシステムとして扱う] を選択すると、サブシステムのコードジェネレーターによって生成されるコードは、Atomic サブシステムとして実行されます。Atomic として設定した場合、[コード生成] タブの [関数のパッケージ化] パラメーターを設定して、コードジェネレーターでのサブシステムの表現方法を指定できます。サブシステムが次のいずれかの実装タイプに変換されることを指定できます。
- インライン: 呼び出しサイトでインライン化されたサブシステムコード。
- 関数: モデルのグローバルデータ構造体に I/O および内部データをもつ void/void 関数。
- 再利用可能な関数: データが関数の引数として渡される再呼び出し可能な関数。
- 自動: コードジェネレーターで、コンテキストに基づいて実装が最適化されます。
SS1 サブシステムをダブルクリックし、内容を確認します。
その後、サブシステムウィンドウを閉じます。
SS1 サブシステムを右クリックし、コンテキストメニューから [ブロックパラメーター (Subsystem)] を選択して、設定を調べます。サブシステムパラメーター [代数ループの発生の最小化] を使用してサブシステムを Atomic にしている場合、Simulink^® およびコードジェネレーターでは、"人為的な" 代数ループを避けることができます。
データの分離を "使用しない" 関数コードを示す SubsystemAtomic のバリアントを作成します。
1. [Subsystem パラメーター] ダイアログボックスで、次を行います。
  - [メイン] タブで、[Atomic サブシステムとして扱う] を選択します。
  - [コード生成] タブで、次を行います。
    
    [関数のパッケージ化] を [再利用可能な関数] に設定します。
    [関数名オプション] を [ユーザー指定] に設定します。
    [関数名] を myfun に設定します。
    [ファイル名オプション] を [関数名を使用] に設定します。この設定はオプションですが、Atomic サブシステムの関数コードがファイル myfun.c と myfun.h に生成されるようにして、後からコード比較のタスクを簡略化することができます。
  [別々のデータをもつ関数] パラメーターは "選択しない" でください。
2. [適用] をクリックして変更を適用し、[OK] をクリックしててダイアログボックスを閉じます。
3. モデルバリアントを一意のファイル名 (SubsystemAtomic1 など) で書き込み可能な場所に保存します。
データの分離を "使用する" 関数コードを示す SubsystemAtomic のバリアントを作成します。
1. モデル SubsystemAtomic を開きます。
2. Embedded Coder アプリを開きます。システムターゲットファイルを ert.tlc に変更します。
3. モデルキャンバスで、SS1 サブシステムを右クリックし、[ブロックパラメーター (Subsystem)] を選択します。[Subsystem パラメーター] ダイアログボックスで、次を行います。
  - [メイン] タブで、[Atomic サブシステムとして扱う] を選択します。
  - [コード生成] タブで、次を行います。
    
    [関数のパッケージ化] を [再利用可能な関数] に設定します。
    [関数名オプション] を [ユーザー指定] に設定します。
    [関数名] を myfun に設定します。
    [ファイル名オプション] を [関数名を使用] に設定します。
    [別々のデータをもつ関数] を選択します。
4. [適用] をクリックして変更を適用し、[OK] をクリックしててダイアログボックスを閉じます。
5. モデルバリアントを一意のファイル名 (SubsystemAtomic2 など) で書き込み可能な場所に保存します。
各モデル (SubsystemAtomic1 や SubsystemAtomic2 など) のコードを生成します。
2 つのモデルから生成された model.c/.h ファイルと myfun.c/.h ファイルを比較します。コードの比較については、非バーチャルサブシステム関数のデータ分離での H ファイルの差および非バーチャルサブシステム関数のデータ分離での C ファイルの差を参照してください。
この例では、ert_main.c、model_private.h、model_types.h、または rtwtypes.h の生成されたバリアントに有意差はありません。

非バーチャルサブシステム関数のデータ分離での H ファイルの差

[別々のデータをもつ関数] を選択すると、コードジェネレーターによって、SubsystemAtomic2 の myfun.h ファイルにサブシステムデータの型定義が配置されます。

/* Block states (default storage) for system '<Root>/SS1' */
typedef struct {
  real_T Integrator_DSTATE;            /* '<S1>/Integrator' */
} DW_myfun_T;

SubsystemAtomic1 では、次のようにサブシステムデータの型定義はモデルに属し、SubsystemAtomic1.h に表示されます。

/* Block signals (default storage) */
typedef struct {
  real_T Sum;                          /* '<Root>/Sum' */
} B_SubsystemAtomic_1_T;

/* Block states (default storage) for system '<Root>' */
typedef struct {
  real_T Integrator_DSTATE;            /* '<S1>/Integrator' */
} DW_SubsystemAtomic_1_T;

[別々のデータをもつ関数] を選択すると、SubsystemAtomic2 について、次の外部宣言が myfun.h ファイルに生成されます。
```
/* Extern declarations of internal data for system '<Root>/SS1' */
extern DW_myfun_T myfun_DW;
extern void myfun_Update(void);
extern void myfun(void);
```
反対に、SubsystemAtomic1 の生成されたコードは、SubsystemAtomic1.h 内にサブシステム BlockIO および D_Work データのモデルレベルの外部宣言を含みます。
```
/* Block signals (default storage) */
extern B_SubsystemAtomic_1_T SubsystemAtomic_1_B;

/* Block states (default storage) */
extern DW_SubsystemAtomic_1_T SubsystemAtomic_1_DW;
```

非バーチャルサブシステム関数のデータ分離での C ファイルの差

[別々のデータをもつ関数] を選択すると、SubsystemAtomic2 について、別のサブシステム初期化関数 myfun_initialize が myfun.c ファイルに生成されます。

void myfun_initialize(void) {
  {
    ((real_T*)&SubsystemAtomic2_myfunB.Integrator)[0] = 0.0;
  }
  SubsystemAtomic2_myfunDW.Integrator_DSTATE = 0.0;
}

myfun.c のサブシステム初期化関数は、SubsystemAtomic2.c のモデル初期化関数で呼び出されます。

/* Model initialize function */

void SubsystemAtomic2_initialize(void)
{
...

  /* Initialize subsystem data */
  myfun_initialize();
}

反対に、SubsystemAtomic1 の場合、サブシステムのデータは SubsystemAtomic1.c のモデル初期化関数で初期化されます。

/* Model initialize function */

void SubsystemAtomic1_initialize(void)
{
...
  /* block I/O */
  {
 ...
    ((real_T*)&SubsystemAtomic1_B.Integrator)[0] = 0.0;
  }

  /* states (dwork) */

  SubsystemAtomic1_DWork.Integrator_DSTATE = 0.0;
...
}

[別々のデータをもつ関数] を選択すると、次の宣言が SubsystemAtomic2 の myfun.c ファイルに生成されます。
```
/* Declare variables for internal data of system '<Root>/SS1' */
DW_myfun_T myfun_DW;
```
反対に、SubsystemAtomic1 の生成されたコードは、SubsystemAtomic1.c 内にサブシステム BlockIO および D_Work データのモデルレベルの宣言を含みます。
```
/* Block signals (default storage) */
B_SubsystemAtomic_1_T SubsystemAtomic_1_B;

/* Block states (default storage) */
DW_SubsystemAtomic_1_T SubsystemAtomic_1_DW;
```
[別々のデータをもつ関数] を選択すると、データ項目のサブシステムの方向を反映する識別子の命名が生成されます。myfun や myfun_update など、サブシステム関数内のサブシステムデータへの参照は、モデルの関数 model_step 内にあります。たとえば、SubsystemAtomic2 の myfun にある次のコードを
```
/*  DiscreteIntegrator: '<S1>/Integrator' */
  SubsystemAtomic_2_Y.Out1 = myfun_DW.Integrator_DSTATE;
```
SubsystemAtomic1 の myfun にある対応するコードと比較します。
```
/* DiscreteIntegrator: '<S1>/Integrator' */
SubsystemAtomic_1_Y.Out1 = SubsystemAtomic_1_DW.Integrator_DSTATE;
```

非バーチャルサブシステムモジュラー関数コードの制限

非バーチャルサブシステムブロックパラメーター [別々のデータをもつ関数] には次の制限があります。

パラメーターは、ERT ベースのシステムターゲットファイルで設定されたモデルで利用できる。
パラメーターが適用される非バーチャルサブシステムは複数のサンプル時間または連続サンプル時間をもつことができない。つまり、サブシステムは、離散サンプル時間をもつシングルレートでなければならない。
非バーチャルサブシステムに連続状態を含めることはできない。
非バーチャルサブシステムは、関数呼び出し信号を出力できない。
非バーチャルサブシステムにインラインでない S-Function を含めることはできない。
非バーチャルサブシステムの生成されたファイルは、model.h や model_private.h などのモデル全体のヘッダーファイルを参照する。
パラメーターは、[クラシックコールインターフェイス] パラメーターと互換性がない。両方のパラメーターを選択すると、エラーが発生する。
パラメーターは、モデルコンフィギュレーションパラメーター [コードインターフェイスのパッケージ化] の [再利用可能な関数] と互換性がない。両方のパラメーターを選択すると、エラーが発生する。

サブシステムのパラメーターを選択した場合、サブシステムを含むモデルには、[モデルインスタンス間で共有する] が選択されている Data Store Memory ブロックを含めることができない。Data Store Memory を参照してください。

非バーチャル サブシステムのモジュラー関数コードの生成

非バーチャル サブシステムのコード生成について

モジュラー関数コードを生成するためのサブシステムの設定

非バーチャル サブシステムのモジュラー関数コード

非バーチャル サブシステム関数のデータ分離での H ファイルの差

非バーチャル サブシステム関数のデータ分離での C ファイルの差

非バーチャル サブシステム モジュラー関数コードの制限