生成されたコード内のデータストア

データストアについて

データストアには、そのデータストアが定義されているレベル以下のモデルの階層でアクセスできるデータが含まれています。データストアによって、サブシステムや参照モデルは I/O 端子を使用してレベル間でデータの受け渡しを行わなくてもデータを共有することができます。Simulink^® のデータストアの詳細については、Data Store Memory ブロックを使用したデータストアを参照してください。この節では、データストアのコード生成についてさらに詳しく説明します。

Data Store Memory ブロックに対するコード生成

Data Store Memory ブロック用に生成されたコードを制御するには、データストアにストレージクラスを適用します。Data Store Memory ブロックをワークスペースまたはデータディクショナリに保存する信号オブジェクトに関連付けて、オブジェクトにストレージクラスを適用することで、ブロックのコード生成を制御できます。

[モデル化] タブで [モデルデータエディター] をクリックします。
モデルデータエディターで、[データストア] タブを選択します。
[Name] 列の対応する行をクリックして、ターゲット Data Store Memory ブロックの名前の編集を開始します。
名前の横のボタンをクリックして [作成と関連付け] を選択します。
[新規データの作成] ダイアログボックスで、[値] を Simulink.Signal に設定します。オプションで、[場所] ドロップダウンリストを使用して、結果の Simulink.Signal オブジェクトを保存するワークスペースを選択します。
[作成] をクリックします。データストアと同じ名前の Simulink.Signal オブジェクトは、ターゲットワークスペースに表示されます。Simulink によりブロックパラメーター [データストア名を Simulink の信号オブジェクトに関連付ける] が選択されます。
オブジェクトに対するプロパティダイアログボックスが開いたら、[OK] をクリックします。
Simulink Coder アプリまたは Embedded Coder アプリでコードマッピングエディターを開きます。[C コード] タブで、[コードインターフェイス] 、 [個々の要素コードのマッピング] を選択します。
[データストア] タブでターゲットストレージクラスを適用します。

メモ:

Data Store Memory ブロックを信号オブジェクトに関連付ける場合、データストアの名前と信号オブジェクトの名前のマッピングは 1 対 1 でなければなりません。同じ名前が付けられた 2 つ以上のエントリを 1 つの信号オブジェクトにマッピングすると、その名前の競合はコードの生成時にエラーとしてフラグが設定されます。詳細については、コード生成のための信号オブジェクトの設定の競合の解決を参照してください。

Data Store Memory ブロックのストレージクラス

ストレージクラスと型修飾子を割り当てることによって、モデル内の Data Store Memory ブロックが生成コード内でどのように格納され、どのように表現されるのかを制御することができます。これは、ブロック状態にストレージクラスと型修飾子を割り当てるのとほとんど同じ方法で行います。

ブロック状態と同様に、Data Store Memory ブロックには既定の設定で [Auto] ストレージクラスが与えられており、メモリは DWork ベクトル内に格納されています。ストレージ場所のシンボリック名は、データストア名が基になっています。

同じデータストア名をもつ複数の Data Store Memory ブロックからコードを生成することは可能ですが、同じ名前のブロックのうち [Auto] 以外のストレージクラスをもつことができるのは "多くても 1 つのブロック" であるという制約があります。この条件が満たされないとエラーが報告されます。

[Auto] ストレージクラスのブロックの場合、コードジェネレーターは各ブロックに固有のシンボリック名を生成して名前が衝突しないようにします。[Auto] 以外のストレージクラスをもつ Data Store Memory ブロックの場合、生成コードはシンボルとしてデータストア名を使用します。

次のモデルでは、Data Store Write ブロックによって Data Store Memory ブロックの myData で宣言されたメモリに書き込みが行われます。

Data Store Memory ブロックのストレージ宣言を制御するには、Coder アプリでコードマッピングエディターを使用します。[データストア] タブで、ブロックの [ストレージクラス] を選択します。

.c ファイルと .cpp ファイルでの Data Store Memory ブロックの初期化と、ヘッダーファイルでの Data Store Memory ブロックの宣言に対してコードが作成されるため、このブロックは非バーチャルです。次の表には、上記のモデル内の Data Store Memory ブロックについて生成されるコードがさまざまなストレージクラスに応じてどのように異なるのかが示されています。以下の表に、myData ブロックについて生成される変数宣言と MdlOutputs コードを示します。

ストレージクラス	宣言	コード
`[Auto]` または `[Model default]` (コードマッピングエディターが `[Default]` ストレージクラスを指定する場合)	`model.h` 内 typedef struct D_Work_tag { real_T myData; } D_Work; `model.c` または `model.cpp` 内 /* Block states (auto storage) */ D_Work model_DWork;	model_DWork.myData = rtb_SineWave;
`ExportedGlobal`	`model.c` または `model.cpp` 内 /* Exported block states */ real_T myData; `model.h` 内 extern real_T myData;	myData = rtb_SineWave;
`ImportedExtern`	`model_private.h` 内 extern real_T myData;	myData = rtb_SineWave;
`ImportedExternPointer`	`model_private.h` 内 extern real_T *myData;	(*myData) = rtb_SineWave;

ストレージクラスの適用の詳細については、モデルインターフェイス要素の C コード生成の構成を参照してください。

ERT モデルの場合は、データストアで多次元配列の次元を保持できます。詳細については、Preserve Dimensions of Multidimensional Arrays in Generated Code (Embedded Coder)を参照してください。

生成コードでのデータストアバッファリング

Data Store Read ブロックは、実行時にデータストアの値を出力バッファーにコピーする非バーチャルブロックです。値がバッファーされると、Data Store Write ブロックで 2 つの下流ブロックが実行される間にデータストアが更新されたとしても、Data Store Read ブロックの出力に接続されている下流ブロックで同じ値が利用されます。

次の図は、任意の実行順序を実現するために優先度が変更されているブロックを使用するモデルを示しています。

次の実行順序が適用されます。

Data Store Read ブロックは、出力時にデータストア A の現在の値をバッファーします。
Abs1 ブロックは Data Store Read のバッファー済みの出力を使用します。
Data Store Write ブロックはデータストアを更新します。
Abs ブロックは Data Store Read のバッファー済みの出力を使用します。

Data Store Read の出力はバッファーであるため、Abs と Abs1 は両方とも同じ値、つまり Data Store Read の実行時のデータストアの値を使用します。

次の図は別の例を示しています。

この例では、次の実行順序が適用されます。

Data Store Read ブロックは、出力時にデータストア A の現在の値をバッファーします。
Atomic Subsystem が実行されます。
Sum ブロックは Atomic Subsystem の出力を Data Store Read の出力に追加します。

Simulink は Atomic Subsystem がデータストアを更新することを前提としているため、Simulink はデータストアをバッファーします。Atomic Subsystem は Data Store Read で出力がバッファーされてから実行されます。また、このバッファーによって、Sum ブロックは Data Store Read の実行時と同じデータストアの値を使用するようになります。

場合によっては、Data Store Read ブロックの出力バッファーを最適化できるかどうかがコードジェネレーターによって判定され、生成されたコードでは Data Store Read ブロックのバッファーされた値ではなくデータストアが直接参照されます。次の図で例を示します。

生成コードで、関数 fabs() の引数はバッファーされた値ではなくデータストア A です。

再利用可能なモデルのインスタンスにより共有されるデータストア

データストアを使用して、再利用可能な参照モデル (参照モデルインスタンス間でのデータの共有を参照) または (コンフィギュレーションパラメーター [コードインターフェイスのパッケージ化] の [再利用可能な関数] への設定により) 再呼び出し可能なコードを生成するために設定するモデルのインスタンス間でデータを共有できます。データストアを Data Store Memory ブロックとして実装して、[モデルインスタンス間で共有する] パラメーターを選択する場合、次のようになります。

既定では、データストアは別個のグローバルシンボルとして生成されたコードに表示されます。
Embedded Coder^® がある場合、モデルから生成されたコードのみがデータストアを使用できる、などのアクセス制限を行うには、ストレージクラス FileScope を適用することでデータストアが static として表示されるように設定します。FileScope およびその他のストレージクラスの詳細については、生成されたコードでのデータ表示を制御するストレージクラスの選択 (Embedded Coder)を参照してください。

データストアを使用する生成コード内の構造体

1 つを超えるデータストアを使用して生成コード内の複数の信号にグローバルなアクセスを実現する場合は、1 つのデータストアを使用して複数の信号を単一の構造体変数にまとめることができます。このように信号データをまとめることで、モデルから生成されたコードを、データを構造体の形式にする必要がある他の既存のコードと統合しやすくなります。

この例では、1 つのデータストアを使用して複数のモデル信号を生成コード内の構造体に格納する方法を示します。複数のデータを 1 つのデータストアに格納するには、データストアが非バーチャルバス信号または非バーチャルバス信号の配列などの合成信号を受け入れるように設定します。

モデル例の確認

モデルを開く

モデル例 BusStructInCode を開きます。

open_system('BusStructInCode')

モデルに含まれている 3 つのサブシステムは、モデルの最上位レベルからの入力に対する計算を実行します。各サブシステムの Data Store Memory ブロックに中間計算信号が格納されます。

モデルを使用してコードを生成します。コード生成レポートで、ファイル BusStructInCode.c を表示します。コードは各データストアのグローバル変数を定義します。

real_T BioBTURate;
real_T CoalBTURate;
real_T GasBTURate;

モデル例から生成されたコードを他の既存のコードと統合するとします。また、既存のコードは 1 つの構造体変数内の 3 つのデータストアのデータにアクセスする必要があるとします。データストアを使用して、生成コード内の構造体にあるターゲットデータを組み合わせることができます。

データストアの設定

バス型を作成してデータストアのデータ型として使用することで、複数の信号を含むデータストアを設定します。生成コードに表示する構造体と同じ要素の階層を使用してバス型を定義します。

型エディターツールを開きます。
```
typeeditor
```
それぞれの 3 つのターゲット信号の 1 つの要素を使用して新しいバス型 Raw_BTU_Rate を定義します。要素 BioBTU、GasBTU および CoalBTU に名前を付けます。
モデル例の最上位レベルに Data Store Memory ブロックを追加します。
[モデル化] タブで [モデルデータエディター] をクリックします。
モデルデータエディターで、[データストア] タブを検査します。
新しい Data Store Memory ブロックの場合、[Value] 列を使用して、データストア名を Raw_BTU_Data に設定します。
[Data Type] 列を使用して、データストアのデータ型を Bus: Raw_BTU_Rate に設定します。
コードマッピングエディターの [データストア] タブで、ストレージクラス [ExportedGlobal] を Raw_BTU_Data に適用します。

データストア要素への書き込み

データストアの特定の要素に書き込むには、Data Store Write ブロックを使用します。ダイアログボックスの [要素の代入] タブで、1 つの要素、要素の集合またはデータストアのコンテンツ全体に書き込むように指定できます。

Biomass Calc Subsystem を開きます。
Data Store Memory ブロックで BioBTURate を削除します。
Data Store Write ブロックのブロックダイアログボックスで、[データストア名] を Raw_BTU_Data に設定します。
[要素の代入] タブの [バス内信号] で、データストア Raw_BTU_Data のコンテンツを展開します。要素 BioBTU をクリックして、[選択] をクリックします。[OK] をクリックします。
Gas Calc Subsystem および Coal Calc Subsystem も同様に変更します。
- 各サブシステムの Data Store Memory ブロックを削除します。
- 各 Data Store Write ブロックのダイアログボックスで、[データストア名] を Raw_BTU_Data に設定します。
- Gas Calc Subsystem で、Data Store Write ブロックを使用してデータストア要素 GasBTU に書き込みます。Coal Calc Subsystem で、要素 CoalBTU に書き込みます。

データストア構造体を使用するコードの生成

モデル例のコードを生成します。
コード生成レポートで、ファイル BusStructInCode.h を表示します。このコードはバス型 Raw_BTU_Rate に対応する構造体を定義します。
```
typedef struct {
  real_T BioBTU;
  real_T GasBTU;
  real_T CoalBTU;
} Raw_BTU_Rate;
```
ファイル BusStructInCode.c を表示します。このコードは、構造体の型 Raw_BTU_Rate のグローバル変数 Raw_BTU_Data を使用するデータストアを表します。モデルステップ関数で、コードは計算済みの信号のデータをグローバル変数 Raw_BTU_Data のフィールドに割り当てます。