coder.mapping.api.CodeMapping

C コード生成用のモデルデータおよび関数インターフェイスの構成

R2020b 以降

説明

コードマッピングオブジェクトおよび関連する関数を使用すると、Simulink^® モデルのデータの C コード生成を構成できます。モデルデータ要素について、コードマッピングは、データ要素をストレージクラスとストレージクラスプロパティから成る構成に関連付けます。モデル全体のデータ要素のカテゴリに対して既定の構成を指定することにより、C コード生成用にモデルを準備する作業を軽減します。データ要素を個別に構成することにより、既定の構成をオーバーライドします。小規模なモデルでは、各データ要素を個別に構成することを選択できます。

作成

Simulink エディターの [アプリ] タブから [Simulink Coder] アプリや [Embedded Coder] アプリなどのコード生成アプリを選択すると、コードマッピングがまだ存在しない場合は coder.mapping.api.CodeMapping オブジェクトが作成されます。コードマッピングは、モデルのアクティブなコンフィギュレーションセットオブジェクトに格納されているコードのカスタマイズ設定に基づいて作成されます。コンフィギュレーションセットオブジェクトでは、データと関数に対してメモリセクションを指定できます。

coder.mapping.api.CodeMapping オブジェクトをプログラムで作成するには、関数 coder.mapping.utils.create を呼び出します。

オブジェクト関数

`addSignal`	ブロックの出力信号をモデルコードマッピングに追加する
`coder.mapping.api.get`	モデルのコードマッピングの取得
`coder.mapping.utils.create`	C および C++ コード生成用にデータおよび関数インターフェイスを構成するためのコードマッピングオブジェクトを作成する
`find`	モデルコードマッピングのカテゴリに対するモデル要素の取得
`getDataDefault`	モデルのデータカテゴリに対する既定のストレージクラスまたはストレージクラスプロパティ設定の取得
`getDataStore`	ローカルまたは共有のローカルデータストアに対するコードマッピングからのコードおよびキャリブレーションの構成の取得
`getInport`	ルートレベルの Inport に対するコードマッピングからのコードおよびキャリブレーション構成の取得
`getModelParameter`	モデルパラメーターに対するコードマッピングからのコードおよびキャリブレーション構成の取得
`getOutport`	ルートレベルの Outport に対するコードマッピングからのコードおよびキャリブレーション構成の取得
`getSignal`	ブロックの出力信号に対するコードマッピングからのコードおよびキャリブレーション構成の取得
`getState`	ブロックの状態に対するコードマッピングからのコードおよびキャリブレーション構成の取得
`removeSignal`	ブロックの出力信号をモデルコードマッピングから削除する
`setDataDefault`	モデルデータカテゴリの既定のストレージクラスとストレージクラスプロパティの値を設定する
`setDataStore`	コード生成とキャリブレーションファイル (a2l) 生成用のローカルデータストアまたは共有ローカルデータストアを設定する
`setInport`	コードとキャリブレーションファイル (a2l) の生成用のルートレベルの Inport の構成
`setModelParameter`	コード生成とキャリブレーションファイル (a2l) 生成用のモデルパラメーターを設定する
`setOutport`	コード生成とキャリブレーションファイル (a2l) 生成用にルートレベルの Outport を設定する
`setSignal`	コード生成とキャリブレーションファイル (a2l) 生成用のブロック信号データを設定する
`setState`	コードとキャリブレーションファイル (a2l) の生成用のブロック状態の設定

例

すべて折りたたむ

Simulink $^{®}$ モデルのコードマッピングのプログラムによる作成と使用

ライブスクリプトを開く

プログラムインターフェイスを使用して、Simulink モデルのコードマッピングオブジェクトを作成および使用します。

モデル NoCoderMapping を読み込みます。

simulinkModel = "NoCoderMapping";
load_system(simulinkModel);

try-catch ブロックを使用して、モデル用にコードマッピングオブジェクトが存在するかどうかを判別します。try ブロック内で、関数 coder.mapping.api.get を使用して既存のオブジェクトの取得を試みます。catch ブロック内で、関数 coder.mapping.utils.create を使用して新しいコードマッピングオブジェクトを作成します。コードマッピングオブジェクトを変数 codeMapObj に保存します。

モデルに既存のコードマッピングオブジェクトがあったかどうかを示す出力メッセージを追加します。

try
  codeMapObj = coder.mapping.api.get(simulinkModel);
          fprintf("" + ...
            " ========================================================\n" + ...
            " The model already had code mappings.\n" + ...
            " ========================================================\n");
catch
          fprintf("" + ...
            " ==========================================\n" + ...
            " The model does not have code mappings.\n" + ...
            " Creating new code mappings for the model.\n" + ...
            " ==========================================\n");
  codeMapObj = coder.mapping.utils.create(simulinkModel);
end

 ==========================================
 The model does not have code mappings.
 Creating new code mappings for the model.
 ==========================================

モデルの入力端子 inport_1 のストレージクラスを取得します。

getInport(codeMapObj,"inport_1","StorageClass")

ans = 
'Auto'

入力端子 inport_1 のストレージクラスを ExportedGlobal に設定します。

setInport(codeMapObj,"inport_1",StorageClass="ExportedGlobal")

同じ try-catch ブロックを使用して、関数 coder.mapping.api.get でモデルの既存のコードマッピングをどのように取得できるようになったかを確認します。

try
  codeMapObj = coder.mapping.api.get(simulinkModel);
          fprintf("" + ...
            " ========================================================\n" + ...
            " The model already had code mappings.\n" + ...
            " ========================================================\n");
catch
          fprintf("" + ...
            " ==========================================\n" + ...
            " The model does not have code mappings.\n" + ... 
            " Creating new code mappings for the model.\n" + ...
            " ==========================================\n");
  codeMapObj = coder.mapping.utils.create(simulinkModel);
end

 ========================================================
 The model already had code mappings.
 ========================================================

モデルの入力端子 inport_1 のストレージクラスを取得します。これは、以前に設定したストレージクラスであることに注意してください。

getInport(codeMapObj,"inport_1","StorageClass")

ans = 
'ExportedGlobal'

モデルを保存せずに閉じます。

close_system(simulinkModel,false)

バージョン履歴

R2020b で導入

すべて展開する

R2023a: コードの自動的な候補と補完

R2023a 以降、関数の名前と引数、およびオブジェクトプロパティについて、タブ補完を使用できます。関数、入力引数、またはオブジェクトプロパティの最初の数文字を入力してから Tab キーを押して、MATLAB^® に入力を自動完了させます。MATLAB により、関数、引数またはパラメーターの残りの文字が追加されます。何も入力しない場合、または入力した文字で始まるオプションが複数ある場合、MATLAB により該当する選択肢のリストが開き、そこから選択できます。タブ補完の詳細については、コードの候補と補完を参照してください。

参考

coder.mapping.api.get | coder.mapping.utils.create | coder.mapping.api.CoderDictionary | coder.mapping.api.CodeMappingCPP (Embedded Coder)

トピック

C Data Code Interface Configuration for Model Interface Elements
Programmatically Configure C++ Interface (Embedded Coder)
Service Interfaces (Embedded Coder)