モデルデータ構成のコードマッピングへの移行

R2020b 以降では、コード生成用にモデルデータを構成する方法として、コードマッピングエディターまたはコードマッピング API を使用する方法が推奨されます。1 つのインターフェイスから、データのカテゴリに対して既定の設定を構成し、必要に応じて特定のデータ要素についてそれらの設定をオーバーライドできます。パラメーターについては、既定でインライン化するか調整可能にするかを指定できます。コードジェネレーターでデータのコードを生成する際、指定したコード定義を使用して、生成コードでのデータの表現方法が決定されます。

R2020b より前のリリースで作成されたモデルを開くと、Simulink^® ではモデルで指定されたコード定義がモデルコードマッピングに移行されます。

移行の影響

モデル内で構成されているデータについて、移行プロセスで既存のストレージクラスの指定が対応するコードマッピングに置き換えられます。コード生成用にモデル内で構成されるデータには、以下で表されるデータが含まれます。

Outport ブロック
信号線
ブロック状態
データストア
モデルワークスペース内のパラメーターオブジェクト

次の表に、特定のモデルの状況とそれに対応する移行結果を示します。

条件	移行結果
モデルがライブラリモデルである。	Simulink は、モデル内で構成されたデータに関連付けられているコード構成を破棄します。
モデル内でデータ要素がコード生成用に構成されていて、そのデータ要素が `Simulink.CoderInfo` オブジェクトに関連付けられており、そのオブジェクトの `StorageClass` プロパティが `Custom` に設定され、`CustomStorageClass` プロパティが `Default` に設定されている。	Simulink は、ストレージクラス設定を `Custom (Default)` から `ExportedGlobal` に変更し、警告を表示します。
`ExportedGlobal` や `ImportedExtern` などの組み込みストレージクラスに `TypeQualifier` ストレージクラスプロパティを使用するように構成されたデータオブジェクトをモデルで使用している。これには、以下として設定されたプロパティが含まれます。ワークスペースまたはデータディクショナリのデータオブジェクトの `CoderInfo.TypeQualifier` プロパティポートパラメーター `RTWStorageTypeQualifier` Data Store Memory、Discrete Filter、Discrete State-Space、Discrete-Time Integrator、Discrete Transfer Fcn、Discrete Zero-Pole、Memory の各ブロックのブロックパラメーター `RTWStateStorageTypeQualifier`	Simulink は、プロパティがサポートされなくなったことを示す警告を発行します。同じ結果を得るために他のインターフェイスを使用できます。
`Simulink.CoderInfo` オブジェクトの `Alignment` プロパティをモデル内で構成されたデータに対して使用している。	Simulink は、プロパティがモデル固有のデータに対してサポートされなくなったことを示す警告を発行します。このプロパティは、ベースワークスペースまたはデータディクショナリに保存されたデータに対しては使用できます。
モデルのモデルワークスペースを MAT ファイル、MATLAB^® ファイル、データディクショナリなどの外部データソースから初期化する。	Simulink は、そのモデルのコードマッピングにパラメーターオブジェクトのコード構成を移動します。
Subsystem ブロックを右クリックしてコードと実行可能プログラムを生成する個々のサブシステムについて、サブシステムの入出力信号に対するストレージクラスおよびストレージクラスプロパティをサブシステムの外部で構成している。	入出力インターフェイスのデータに対する変数は生成コードに含まれません。

次の操作を実行する場合、対応が必要になることがあります。

Simulink エディターを使用して別のモデルにブロックの線をコピーする。Simulink では、コピーするモデリング要素に関連付けられているコード構成情報はコピーされません。詳細については、ブロックと信号線のモデル間でのコピー (Embedded Coder)を参照してください。
モデルのシステムターゲットファイル設定を GRT ベースと ERT ベースのシステムターゲットファイル間で切り替える。Simulink では、コピーするモデルのコピー元バージョンのシステムターゲットファイルのコード構成情報は無視されます。詳細については、GRT ベースと ERT ベースのシステムターゲットファイルの切り替え (Embedded Coder)を参照してください。

移行前の考慮事項

以下の状況に該当する場合は、移行前に以降の節の推奨事項に従って準備することを検討してください。

ライブラリモデル内で構成されたデータ
ストレージクラスの TypeQualifier プロパティ
コード生成用のデータ配置
モデルワークスペース内の初期化されたパラメーターオブジェクトのコード構成
サブシステムの I/O インターフェイスのコード構成

ライブラリモデル内で構成されたデータ

モデルがライブラリモデルの場合、データのコード生成を構成し直します。ライブラリを使用するモデルのコンテキストでデータのコード生成を再構成します (コードインターフェイスの設定を参照)。

モデル内で構成されたデータのコード構成が失われないようにするには、以前のリリースでモデルを読み込み、以下を行う MATLAB スクリプトを作成して実行します。

モデルデータを読み込む。
コード生成用にモデル内で構成されているデータを検索する。
MAT ファイル、MATLAB ファイル、データディクショナリなどの外部ソースに保存するデータオブジェクトにデータの表現を変換する。
外部データオブジェクトを使用するようにモデルを更新する。

ストレージクラスの `TypeQualifier` プロパティ

モデルで ExportedGlobal や ImportedExtern などの組み込みストレージクラスをもつデータオブジェクトを構成し、ストレージクラスの TypeQualifier プロパティを使用している場合、R2020b 以降のリリースでモデルを読み込むと Simulink から警告が発行されます。この警告を回避し、サポートされている代替方法を使用するようにモデルを更新するには、以前のリリースでモデルを読み込み、以下を行う MATLAB スクリプトを作成して実行します。

モデルのデータオブジェクトをモデルワークスペース、ベースワークスペース、またはデータディクショナリから読み込む。
TypeQualifier プロパティが空でない string 値に設定されているデータオブジェクトを検索する。
ストレージクラス設定を必要な型修飾子が事前定義されているストレージクラスに変更する (たとえば、ストレージクラス Const にはデータの宣言と定義に修飾子 const が含まれています)。

次のスクリプト例は、モデルのデータオブジェクトをベースワークスペースから読み込み、ストレージクラスの TypeQualifier プロパティを使用して構成されているデータのインスタンスを検索し、ストレージクラス設定を Const に変更します。

vars = who;

  for idx = 1:length(vars)
    thisVar = evalin('base',vars{idx});
    if (isa(thisVar,'Simulink.Parameter') && (isequal(thisVar.CoderInfo.TypeQualifier, 'const')))
      thisVar.CoderInfo.TypeQualifier = '';
      thisVar.CoderInfo.StorageClass = 'Custom';
      thisVar.CoderInfo.CustomStorageClass = 'Const';
    end
  end

コード生成用のデータ配置

モデルに対して構成されているデータ配置情報を保持するには、モデルの外部のデータオブジェクトでデータを表します。たとえば、以前のリリースの Simulink でモデルを開き、次の表にリストされたアクションを実行します。

データ要素のタイプ	アクション
モデルワークスペース内のパラメーターオブジェクト	モデルエクスプローラーを使用して、モデルワークスペースからベースワークスペースまたはデータディクショナリにオブジェクトを移動します。次に、オブジェクトのストレージクラスと配置のプロパティを設定します。モデルを保存します。
信号線	[信号プロパティ] ダイアログボックスを開き、信号の名前を指定して [信号名を Simulink の信号オブジェクトに関連付ける] を選択します (ストレージクラスは `Auto` でなければなりません)。ベースワークスペースまたはデータディクショナリで `Simulink.Signal` オブジェクトを作成し、オブジェクトのストレージクラスと配置のプロパティを設定します。モデルを保存します。
ブロックの状態	[ブロックパラメーター] ダイアログボックスを開き、状態の名前を指定して [状態名を Simulink の信号オブジェクトに関連付ける] を選択します (ストレージクラスは `Auto` でなければなりません)。ベースワークスペースまたはデータディクショナリで `Simulink.Signal` オブジェクトを作成し、ストレージクラスと配置のプロパティを設定します。モデルを保存します。

あるいは、以下を行う MATLAB スクリプトを作成して実行します。

モデルデータを読み込む。
Simulink.CoderInfo.Alignment を設定するデータオブジェクトを検索する。
MAT ファイル、MATLAB ファイル、データディクショナリなどの外部ソースに保存するデータオブジェクトにデータの表現を変換する。
新しいデータオブジェクトの Simulink.CoderInfo オブジェクトプロパティ Alignment を設定する。

たとえば、次のスクリプトは、パラメーター、ルックアップテーブル、およびブレークポイントのデータオブジェクトに対して Alignment が設定されているかどうかをチェックし、見つかったデータオブジェクトを MAT ファイル savedData.mat に取得します。

filename = 'savedData.mat';
varList = who;
tosaveVars = {};
for idx = 1 : length(varList)
   variable = eval(varList{idx});
   if ((isa(variable, 'Simulink.Parameter') || ...
       isa(variable, 'Simulink.LookupTable') || ...
       isa(variable, 'Simulink.Breakpoint')) && ...
       variable.CoderInfo.Alignment ~= -1)
       tosaveVars{end+1} = varList{idx};       
   end
end
if ~isempty(tosaveVars)
  save('savedData.mat', tosaveVars{:});
end

次のコマンドを使用して、モデルワークスペースでスクリプトを評価します。

mws = get_param(bdroot, 'ModelWorkspace');
evalin(mws, 'SaveMWSParamsWithAlignment');

モデルワークスペース内のパラメーターオブジェクトについては、モデルエクスプローラーインターフェイスを使用して、モデルワークスペースからベースワークスペースまたはデータディクショナリにオブジェクトを移動することもできます。その後、ストレージクラスの [Alignment] プロパティを選択します。

モデルワークスペース内の初期化されたパラメーターオブジェクトのコード構成

R2020b 以降のリリースでモデルを読み込んだ後、モデルのモデルワークスペースを MAT ファイル、MATLAB ファイル、データディクショナリなどの外部データソースから初期化すると、Simulink で以下が実行されます。

Simulink.CoderInfo オブジェクトの内容がモデルコードマッピングに保存されます。
外部データソースで定義されている Simulink.Parameter オブジェクトから Simulink.CoderInfo オブジェクトが削除されます。

パラメーターのコード構成設定を取得および設定するには、コードマッピングエディターまたはコードマッピング API を使用します。コードインターフェイスの設定を参照してください。

サブシステムの I/O インターフェイスのコード構成

R2020b 以降のリリースで、Subsystem ブロックを右クリックしてコードと実行可能プログラムを生成する個々のサブシステムについて、生成されるサブシステムのコードインターフェイスに信号データを含めるには、サブシステムの入出力信号に対するストレージクラスおよびストレージクラスプロパティをサブシステムの内部で構成します。信号をサブシステムの外部で構成している場合、入出力インターフェイスのデータに対する変数は生成コードに含まれません。

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

ブロックと信号線のモデル間でのコピー

R2020b 以降では、Simulink エディターを使用して別のモデルにブロックや信号線をコピーする場合、コピーするモデリング要素に関連付けられているコード構成情報は Simulink でコピーされません。

この変更に対処するには、コードマッピング API を使用して、データ要素のコード構成情報をコピーして貼り付けます。

コピー操作のコピー元とコピー先のモデルを開きます。
コードマッピング API を使用して、コピー元のモデルのコードマッピングオブジェクトを取得します。
コードマッピング API を使用して、コピーするモデル要素のコードマッピング情報を取得します。
コピー先のモデルにコードマッピングオブジェクトが存在しない場合は、コードマッピング API を使用して作成します。
コピー先のモデルにコピーするモデル要素について、コードマッピング API を使用して、コードマッピング情報をコピー元のモデルと同じ値に設定します。
コピー元のモデルを閉じます。
コピー先のモデルを保存して閉じます。

次に例を示します。

.
.
.
srcMdl = 'my_src_mdl';
destMdl = 'my_dest_mdl';

open_system(srcMdl);
open_system(destMdl);

% Get data configuration from source model
srcCM = coder.mapping.api.get(srcMdl);
srcSC = getSignal(srcCM, srcPort, 'StorageClass')

% Set data configuration for destination model to setting of source model
destCM = coder.mapping.api.get(destMdl);
setSignal(destCM, destPort, 'StorageClass', srcSC);

close_system(srcMdl);
save_system(destMdl);
close_system(destMdl);
.
.
.

GRT ベースと ERT ベースのシステムターゲットファイルの切り替え

R2020b 以降では、モデルのシステムターゲットファイル設定を GRT ベースと ERT ベースのシステムターゲットファイル間で切り替えると、各システムターゲットファイルの代替コード構成が Simulink で適用されます。この切り替えは以下の場合に発生する可能性があります。

Simulink Coder™ アプリと Embedded Coder^® アプリを切り替える。
モデルのアクティブなコンフィギュレーションセットを変更する。
モデルコンフィギュレーションパラメーター [システムターゲットファイル] の設定を変更する。

モデル内で構成されたデータのコード構成情報を保持するには、コードマッピング API を使用して関連するコードマッピングをコピーする MATLAB スクリプトを作成して実行します。

保持するコピー元のシステムターゲットファイルとコードマッピングを含むモデルを開きます。
コードマッピング API を使用して、モデルのコードマッピングオブジェクトを取得し、データ要素のデータマッピングオブジェクトを取得します。
コードマッピング API を使用して、モデルのコードマッピングオブジェクトを取得し、データ要素のデータマッピングオブジェクトを設定します。
モデルを保存して閉じます。

次のスクリプトフラグメントは、コードマッピング API を使用して、GRT システムターゲットファイルから ERT システムターゲットファイルに切り替えるときに信号オブジェクトのストレージクラスを保持する方法を示したものです。

.
.
.
mymdl = 'my_shared_mdl';

open_system(mymdl);

% Get data configuration for Simulink Coder (GRT-based) code generation
scCodeMapping = coder.mapping.api.get(model, 'SimulinkCoderC'); 
scStorageClass = getSignal(scCodeMapping, srcPort, 'StorageClass') 

% Set data configuration for Embedded Coder (ERT-based) code generation
ecCodeMapping = coder.mapping.api.get(model, 'EmbeddedCoderC'); 
setSignal(ecCodeMapping, srcPort, 'StorageClass', scStorageClass)

save_system(mymdl);
close_system(mymdl);

.
.
.

ワークフローの変更

R2020b 以降では、モデルのデータ要素をコード生成用に構成する際に、Simulink データオブジェクトを作成および構成する代わりに、またはそれに加えて、コードマッピングエディターまたはコードマッピング API を使用します。次のワークフローを使用します。

[Simulink Coder] アプリを開きます。
コードマッピングエディターで、ストレージ表現の既定の動作を構成します。
個々のデータ要素の既定の構成設定をオーバーライドするかどうかを決定します。設定をオーバーライドしない場合は、手順 8 までスキップします。
個別に構成する MATLAB 変数を特定し、モデルワークスペースに構成を保存します。モデルエクスプローラーで、変数を Simulink.Parameter オブジェクトに変換します。結果のデータオブジェクトがモデルパラメーターとしてコードマッピングエディターに表示されます。
生成コードの実行中に監視するアルゴリズムデータを表す信号を特定し、それらを個別に構成します。特定した信号ごとに、次のいずれかを実行します。
- モデルに固有の (共有されていない) 信号データの場合は、信号をコードマッピングエディターに追加する。モデルで、信号線の上の省略記号で一時停止してアクションバーを開きます。[信号の追加] ボタンをクリックして、コードマッピングエディターに信号を追加します。
- 共有されている信号データの場合は、Simulink.Signal オブジェクトを作成し、構成する。C Data Code Interface Configuration for Model Interface Elementsおよび生成されたコードにおける信号および状態の初期化の制御を参照してください。
個々のデータ要素を構成します。コードマッピングエディターで、カテゴリタブをクリックし、データ要素を選択して、ストレージクラスを設定します。プロパティインスペクターで、ストレージクラスのプロパティ値を設定します。モデルコンフィギュレーションパラメーター [既定のパラメーター動作] の設定を変更するには、ストレージクラスが [自動] に設定されている場合の動作を示すリンクをクリックします。[モデルコンフィギュレーションパラメーター] ダイアログボックスで、パラメーターの設定を [調整可能] または [インライン] に変更します。
ベースワークスペースまたはデータディクショナリ内に保存されている外部データオブジェクトを表示するには、コードマッピングエディターで、コードマッピングエディターの [更新] ボタンをクリックします。
コードの生成とレビュー