C データと関数インターフェイス

モデルデータの要素と関数を、モデルに依存しないコード定義にマッピング

コードの標準とガイドラインに準拠し、生成されたコードを外部コードと統合して、メモリ要件に対応するために、モデルデータ要素とエントリポイント関数の表現をコード生成用に構成します。モデルデータ要素と関数を構成するには、それらを製品で事前定義されたコード定義または Embedded Coder ディクショナリで作成されたコード定義にマッピングします。データ要素の場合は、カスタムストレージクラスデザイナーでパッケージに作成されたコード定義にそれらをマッピングすることもできます。

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

ツール

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

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

オブジェクト

`coder.mapping.api.CodeMapping`	C コード生成用のモデルデータおよび関数インターフェイスの構成 (R2020b 以降)
`coder.mapping.api.CoderDictionary`	Simulink データディクショナリ内にある Embedded Coder ディクショナリの既定値のコード設定のクエリおよび指定 (R2021a 以降)

関数

すべて展開する

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

`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`	Create code mappings object for configuring data and function interface for C and C++ code generation (R2020b 以降)
`find`	Get model elements for the category of model code mappings (R2020b 以降)

既定の構成

`getDataDefault`	Get default storage class or storage class property setting for model data category (R2020b 以降)
`getFunctionDefault`	モデル関数カテゴリに対する既定の関数カスタマイズテンプレートまたはメモリセクションの取得 (R2020b 以降)
`setDataDefault`	Set default storage class and storage class property values for model data category (R2020b 以降)
`setFunctionDefault`	モデル関数カテゴリの既定の関数カスタマイズテンプレートとメモリセクションを設定する (R2020b 以降)

関数の構成

`getFunction`	モデル関数に対するコードマッピングからのコード構成の取得 (R2020b 以降)
`setFunction`	モデル関数のコーダーマッピング情報を設定する (R2020b 以降)

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

`getInport`	Get code and calibration configuration from code mappings for root-level inport (R2020b 以降)
`getOutport`	Get code and calibration configuration from code mappings for root-level outport (R2020b 以降)
`getDeploymentType`	Get deployment type of model (R2022a 以降)
`setInport`	コードとキャリブレーションファイル (a2l) の生成用のルートレベルの Inport の構成 (R2020b 以降)
`setOutport`	Configure root-level outport for code and calibration file (a2l) generation (R2020b 以降)
`setDeploymentType`	Set deployment type of model (R2022a 以降)

パラメーターの構成

`getModelParameter`	Get code and calibration configuration from code mappings for model parameters (R2020b 以降)
`setModelParameter`	コード生成とキャリブレーションファイル (a2l) 生成用のモデルパラメーターを設定する (R2020b 以降)

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

`addSignal`	ブロックの出力信号をモデルコードマッピングに追加する (R2020b 以降)
`getDataStore`	Get code and calibration configuration from code mappings for local or shared local data store (R2020b 以降)
`getSignal`	Get code and calibration configuration from code mappings for block output signal (R2020b 以降)
`getState`	Get code and calibration configuration from code mappings for block state (R2020b 以降)
`removeSignal`	ブロックの出力信号をモデルコードマッピングから削除する (R2020b 以降)
`setDataStore`	コード生成とキャリブレーションファイル (a2l) 生成用のローカルデータストアまたは共有ローカルデータストアを設定する (R2020b 以降)
`setSignal`	コード生成とキャリブレーションファイル (a2l) 生成用のブロック信号データを設定する (R2020b 以降)
`setState`	コードとキャリブレーションファイル (a2l) の生成用のブロック状態の設定 (R2020b 以降)

Coder ディクショナリの構成

`setDataDefault`	Set default code settings for data category (R2021a 以降)
`getDataDefault`	Get default code settings for data category (R2021a 以降)
`setFunctionDefault`	モデル関数カテゴリの既定の関数カスタマイズテンプレートとメモリセクションを設定する (R2021a 以降)
`getFunctionDefault`	モデル関数カテゴリに対する既定の関数カスタマイズテンプレートまたはメモリセクションの取得 (R2021a 以降)

トピック

構成の基礎

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.
Code Definition and Mapping Limitations and Considerations
Restrictions, constraints, and considerations that apply to code definitions and code mappings.
Configure Default C Code Generation for Categories of Data Elements and Functions
Apply default code generation configurations for categories of model data and functions across a model.
モデルに対する複数のコードマッピングの管理
プラットフォームに依存せず、さまざまなランタイム環境に展開できるように準備されたモデルを設計する。
型修飾子 const と volatile を使用したグローバルデータの保護
生成コードのグローバルデータに C 型修飾子 const と volatile を適用することによるデータの破損の防止とコードの安全性の向上。
生成されたコードによる環境とのデータ交換方法
生成されたコードは、データインターフェイスを介して呼び出し環境と信号、状態およびパラメーターデータを交換します。
Configure Generated Code According to Interface Control Document Specifications
Configure code generation settings for a model according to specifications from an interface control document.
モデルデータ構成のコードマッピングへの移行
R2020b より前のリリースで作成されたモデルのコード定義が Simulink^® でコードマッピングに移行される方法と考慮すべき関連情報。
Migration of Memory Section and Shared Utility Settings from Configuration Parameters to Code Mappings
For models created before release R2018a, how Simulink migrates memory section and shared utility function configuration parameter settings to model code mappings for C code generation.

C データの構成

データ構成アプローチの選択
コード生成の要件に基づいて、モデルで使用する設計データについて決定する。
Configure Root-Level Inport Blocks for C Code Generation
Set the storage class and other relevant code generation properties for root-level Inport blocks.
Configure Root-Level Outport Blocks for C Code Generation
Set the storage class and other relevant code generation properties for root-level Outport blocks.
C コード生成のための信号データの構成
信号データに対してストレージクラスおよび関連するその他のコード生成プロパティを設定する。
C コード生成のパラメーターの構成
パラメーターに対してストレージクラスおよび関連するその他のコード生成プロパティを設定する。
C コード生成のためのブロックの状態の構成
ブロックの状態について、ストレージクラスと他の関連するコード生成プロパティを構成します。
Configure Data Stores for C Code Generation
Set the storage class and other relevant code generation properties for data stores.
生成されたコードでのデータ表示を制御するストレージクラスの選択
信号、状態、ブロックパラメーターなどのモデル内のデータ要素に適用するストレージクラスを選択する。
Control Placement of Global Data Definitions and Declarations in Generated Files
Modularize the generated code and establish clear ownership of global data by controlling the file placement of each declaration and definition.
Inport ブロックと Outport ブロックの設定によるデータインターフェイスの設計
モデルのデータインターフェイスをカスタマイズして、生成されたコードと独自のコードを統合でき、コードのトレーサビリティと可読性を向上させます。

C 関数の構成

生成された 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.
非バーチャルサブシステムのモジュラー関数コードの生成
非バーチャルサブシステムのモジュラー関数コードを生成する。
ラピッドプロトタイピングモデル関数
ラピッドプロトタイピングコードを生成します。
Control File Packaging of Generated Entry-Point Functions and Simulink Functions
This example shows how to specify custom filenames for entry-point functions and Simulink® functions using function customization templates. Use custom filenames to group related functions together in generated code.

データアクセスと初期化

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

注目の例

C コード生成用のモデルデータインターフェイスの構成

ブロックパラメーターや信号線などのデータ要素をモデルに構成し、対応する変数が生成コード内に表示されるようにする。

ライブスクリプトを開く

再呼び出し可能なマルチインスタンスコードの生成

この例では、再呼び出し可能なマルチインスタンスコード生成用のモデルを設定する方法を示します。複数のプログラムで再呼び出し可能なコードを同時に使用できます。再入用のモデルを設定すると、実行 (step) エントリポイント関数では、グローバルデータ構造体ではなく、ルートレベルの入力引数と出力引数が使用されます。コンフィギュレーション設定を検査した後に、コードを生成し、生成されたコードを確認します。

スクリプトを開く