coder.mapping.utils.create

C および C++ コード生成用にデータおよび関数インターフェイスを構成するためのコードマッピングオブジェクトを作成する

R2020b 以降

構文

coderMapObj = coder.mapping.utils.create(simulinkModel)

説明

coderMapObj = coder.mapping.utils.create(simulinkModel) は、指定されたモデルに対するコードマッピング環境を作成し、コードマッピングが存在しない場合はそれをオブジェクト coderMapObj として返します。コードマッピングはモデルデータ要素と関数を C または C++ コード生成の構成に関連付けます。指定されたモデルに対するコードマッピングが存在する場合、関数はそれらのコードマッピングをオブジェクト coderMapObj として返します。

例

すべて折りたたむ

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)

入力引数

すべて折りたたむ

`simulinkModel` — モデルの名前
ハンドル | 文字ベクトル | string スカラー

コードマッピングオブジェクトを作成して返す Simulink^® モデル。ハンドル、またはモデル名 (.slx ファイル拡張子なし) あるいはモデルファイルの相対パスまたは絶対パス (.slx ファイル拡張子を含む) を含む文字ベクトルまたは string スカラーとして指定します。

メモ

モデルが (たとえば、load_system を使用して) 読み込まれていなければなりません。

例: "configModel"

データ型: char | string | handle

出力引数

すべて折りたたむ

`coderMapObj` — コードマッピングオブジェクト
`CodeMapping` オブジェクト | `CodeMappingCPP` オブジェクト

モデルのコードマッピング。CodeMapping オブジェクトまたは CodeMappingCPP オブジェクトとして返されます。

出力	入力オブジェクト
`coder.mapping.api.CodeMapping`	C コード生成用に構成された Simulink モデル
`coder.mapping.api.CodeMappingCPP` (Embedded Coder)	C++ コード生成用に構成された Simulink モデル