データおよび関数のインターフェイス

モデルのデータ要素と関数をコード定義にマッピングする

コードの標準規格とガイドラインに準拠し、モデルのデータ要素とエントリポイント関数の表現をコード生成に向けて構成するために、モデルのデータ要素と関数を事前定義されたコード定義にマッピングします。

概要については、C Data Code Interface Configuration for Model Interface Elementsを参照してください。

ツール

コードマッピングエディター

モデル要素とコードインターフェイス定義の関連付け (R2020b 以降)

オブジェクト

coder.mapping.api.CodeMapping C コード生成用のモデルデータおよび関数インターフェイスの構成 (R2020b 以降)

関数

すべて展開する

生成されたエントリポイント

`model_initialize`	Simulink モデルの初期化コードが含まれる、生成された C/C++ エントリポイント関数
`model_reset`	Simulink モデルのリセットコードが含まれる、生成された C/C++ エントリポイント関数
`model_step`	Simulink モデルの各ステップの実行コードが含まれる、生成された C/C++ エントリポイント関数
`model_terminate`	Simulink モデルの終了コードが含まれる、生成された C/C++ エントリポイント関数

C コード生成用のモデル要素の構成

コードマッピングの作成および検索

`coder.mapping.api.get`	モデルのコードマッピングの取得 (R2020b 以降)
`coder.mapping.utils.create`	C および C++ コード生成用にデータおよび関数インターフェイスを構成するためのコードマッピングオブジェクトを作成する (R2020b 以降)
`find`	モデルコードマッピングのカテゴリに対するモデル要素の取得 (R2020b 以降)

既定の構成

`getDataDefault`	モデルのデータカテゴリに対する既定のストレージクラスまたはストレージクラスプロパティ設定の取得 (R2020b 以降)
`setDataDefault`	モデルデータカテゴリの既定のストレージクラスとストレージクラスプロパティの値を設定する (R2020b 以降)

ルートレベルの Inport および Outport の構成

`getInport`	ルートレベルの Inport に対するコードマッピングからのコードおよびキャリブレーション構成の取得 (R2020b 以降)
`getOutport`	ルートレベルの Outport に対するコードマッピングからのコードおよびキャリブレーション構成の取得 (R2020b 以降)
`setInport`	コードとキャリブレーションファイル (a2l) の生成用のルートレベルの Inport の構成 (R2020b 以降)
`setOutport`	コード生成とキャリブレーションファイル (a2l) 生成用にルートレベルの Outport を設定する (R2020b 以降)

パラメーターの構成

`getModelParameter`	モデルパラメーターに対するコードマッピングからのコードおよびキャリブレーション構成の取得 (R2020b 以降)
`setModelParameter`	コード生成とキャリブレーションファイル (a2l) 生成用のモデルパラメーターを設定する (R2020b 以降)

信号、状態、およびデータストアの構成

`addSignal`	ブロックの出力信号をモデルコードマッピングに追加する (R2020b 以降)
`getDataStore`	ローカルまたは共有のローカルデータストアに対するコードマッピングからのコードおよびキャリブレーションの構成の取得 (R2020b 以降)
`getSignal`	ブロックの出力信号に対するコードマッピングからのコードおよびキャリブレーション構成の取得 (R2020b 以降)
`getState`	ブロックの状態に対するコードマッピングからのコードおよびキャリブレーション構成の取得 (R2020b 以降)
`removeSignal`	ブロックの出力信号をモデルコードマッピングから削除する (R2020b 以降)
`setDataStore`	コード生成とキャリブレーションファイル (a2l) 生成用のローカルデータストアまたは共有ローカルデータストアを設定する (R2020b 以降)
`setSignal`	コード生成とキャリブレーションファイル (a2l) 生成用のブロック信号データを設定する (R2020b 以降)
`setState`	コードとキャリブレーションファイル (a2l) の生成用のブロック状態の設定 (R2020b 以降)

トピック

構成の基礎

C Data Code Interface Configuration for Model Interface Elements
Control the representation of model data elements and functions in generated C code by using a data code interface configuration.
モデルまたはサブシステムのコードへの C++ クラスインターフェイスの生成
モデルまたはサブシステムから生成されるコードへの C++ クラスインターフェイスを生成します。
コードの定義とマッピングに関する制限と考慮事項
コード定義とコードマッピングに適用される制限、制約、および考慮事項。
モデルに対する複数のコードマッピングの管理
プラットフォームに依存せず、さまざまなランタイム環境に展開できるように準備されたモデルを設計する。
生成されたコードによる環境とのデータ交換方法
生成されたコードは、データインターフェイスを介して呼び出し環境と信号、状態およびパラメーターデータを交換します。
外部の呼び出しコードと生成コード間のデータ交換
生成コードを外部コードにエクスポートするときに、信号、状態およびパラメーターデータを交換する。
外部コードの外観に一致するコードの生成
コードジェネレーターがどのように識別子 (記号)、コメント、コードスタイル、コード形式、構成を適用するかを設定します。
モデルデータ構成のコードマッピングへの移行
R2020b より前のリリースで作成されたモデルのコード定義が Simulink^® でコードマッピングに移行される方法と考慮すべき関連情報。

データの構成

データ構成アプローチの選択
コード生成の要件に基づいて、モデルで使用する設計データについて決定する。
C コード生成のためのルートレベルの Inport ブロックの構成
ルートレベルの Inport ブロックについて、ストレージクラスと他の関連するコード生成のプロパティを設定する。
C コード生成のためのルートレベルの Outport ブロックの構成
ルートレベルの Outport ブロックについて、ストレージクラスと他の関連するコード生成のプロパティを設定します。
C コード生成のための信号データの構成
信号データに対してストレージクラスおよび関連するその他のコード生成プロパティを設定する。
C コード生成のパラメーターの構成
パラメーターに対してストレージクラスおよび関連するその他のコード生成プロパティを設定する。
C コード生成のためのブロックの状態の構成
ブロックの状態について、ストレージクラスと他の関連するコード生成プロパティを構成します。
C コード生成用のデータストアの構成
データストアに対してストレージクラスおよび関連するその他のコード生成プロパティを設定する。
生成されたコードでのデータ表示を制御するストレージクラスの選択
信号、状態、ブロックパラメーターなどのモデル内のデータ要素に適用するストレージクラスを選択する。
Inport ブロックと Outport ブロックの設定によるデータインターフェイスの設計
モデルのデータインターフェイスをカスタマイズして、生成されたコードと独自のコードを統合でき、コードのトレーサビリティと可読性を向上させます。

関数の構成

生成された C 関数インターフェイスをモデルのエントリポイント関数用に構成
生成された C エントリポイント関数、構成オプション、それらとインターフェイスをとる方について学習する。
生成コードでのデータと関数インターフェイスの制御
生成されたコードが呼び出し環境とデータを交換する方法を制御します。
Configure Entry-Point Function Interfaces for Simulink Function and Function Caller Blocks
Customize entry-point function names and step function arguments for Simulink Function and Function Caller blocks.
ラピッドプロトタイピングモデル関数
ラピッドプロトタイピングコードを生成します。

データアクセスと初期化

生成されたコードにおける調整可能なキャリブレーションパラメーターの作成
生成されたコードで、ラピッドプロトタイピングおよびキャリブレーション時にアクセスできる調整可能なパラメーターデータを作成します。
異なるデータ型のコンテキストでパラメーターデータを再利用
異なるデータ型のコンテキストで使用できる Simulink.Parameter オブジェクトまたは MATLAB^® の数値変数を作成して、パラメーターデータを再利用します。
生成されたコードにおけるブロックパラメーターの調整可能性の制限
ブロックパラメーターが生成されたコードに調整可能として表示されないように制限できます。これは、コードをコンパイルした後にパラメーター値を操作できなくなることを意味します。
信号、状態、パラメーターデータへの実行時のアクセス
モデルの反復的な開発においては、モデル実行で生成される出力信号や状態のデータを取得します。実行時にはパラメーターの値の調整を行い、出力での結果を確認する。
シミュレーションおよびコード実行時のパラメーター値セットの切り替え
独立した値のセットを構造体配列に格納して、同じブロックパラメーターのこのセットを切り替えます。
生成コード内の変数の保持
モデルの反復的な開発において、生成されたコードのシミュレーションまたは実行中にブロックパラメーター値を調整して、信号値および状態値の結果を確認できます。
生成されたコードのパラメーター引数のパッケージ化の設定
生成されたコード内のパラメーター引数の実装をカスタマイズする。
生成されたコードにおける信号および状態の初期化の制御
たとえば、シャットダウンおよび再起動を行うシステムのモデル化のために、調整可能な初期条件をメモリに格納できるようにするコードを生成します。
生成されたコードでの信号、状態、パラメーターデータの初期化
Simulink でシミュレーションの数値を一致させるには、特にブロックの状態とパラメーターに対する初期値を生成されたコードでグローバルデータに代入します。
式の値を使用したパラメーターオブジェクトのコード生成
パラメーターオブジェクト (Simulink.Parameter など) の値を式に設定すると、生成されたコードで式を保持できます。