C サービスインターフェイス

モデルの要素と関数を Embedded Coder ディクショナリで定義されたサービスインターフェイスにマッピング

C サービスコードインターフェイス構成を使用するコンポーネントモデルからコードを生成するときは、モデルのデータ要素をサービスインターフェイスにマッピングします。サービスインターフェイスにより、ターゲットプラットフォームサービスの要件に応じて、生成コードの関数プロトタイプ情報とデータ通信方法 (Direct Access、Outside Execution、または During Execution) が指定されます。コードジェネレーターでは、サービスインターフェイスのコードを生成するときに制約を適用します。これにより、特定のターゲット環境で使用するためのコードの統合が簡単になります。マッピングに使用できるサービスインターフェイスのリストは、モデルに付加された共有の Embedded Coder ディクショナリで定義されているインターフェイスで決まります。ディクショナリの既定のサービスインターフェイスがターゲットプラットフォームサービスの要件に合致していれば、マッピングに変更を加える必要はなく、コンポーネントインターフェイスのコードの生成と確認に進むことができます。

ツール

コードマッピングエディター – サービスインターフェイス

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

オブジェクト

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`	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 以降)

関数の構成

`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`	Configure root-level inports for code and calibration file (a2l) generation (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`	Configure model parameter for code and calibration file (a2l) generation (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 以降)

データ転送の構成

`getDataTransfer`	Get code configuration from code mappings for signal representing data transfer (R2022b 以降)
`setDataTransfer`	Set code configuration in code mappings for signal representing data transfer (R2022b 以降)

トピック

構成の基礎

Code Definition and Mapping Limitations and Considerations
Restrictions, constraints, and considerations that apply to code definitions and code mappings.
モデルに対する複数のコードマッピングの管理
プラットフォームに依存せず、さまざまなランタイム環境に展開できるように準備されたモデルを設計する。
生成されたコードによる環境とのデータ交換方法
生成されたコードは、データインターフェイスを介して呼び出し環境と信号、状態およびパラメーターデータを交換します。

呼び出し可能な関数の構成

Periodic and Aperiodic Function Interfaces
Generate callable entry-point functions for the algorithm represented by a top model.
Startup, Reset, and Shutdown Function Interfaces
Generate callable entry-point functions for startup, reset, and shutdown processing represented by a model.

サービスインターフェイスの構成

Service Interfaces
Generate C service interface code for components that interact with target environment resources. (R2022b 以降)
Configure Sender and Receiver Service Interfaces for Model Inports and Outports
Configure sender and receiver service interfaces for model Inports and Outports. (R2022b 以降)
Configure Data Transfer Service Interfaces for Data Transfer Signals
Configure data transfer service interfaces for signals representing data transfers between functions. (R2022b 以降)
Configure Parameter and Parameter Argument Tuning Service Interfaces for Model Parameters and Model Parameter Arguments
Configure parameter and parameter argument tuning service interfaces for model parameters and model parameter arguments. (R2022b 以降)
Configure Measurement Service Interfaces for Signals, States, and Data Stores
Configure measurement services for signals, states, and data stores. (R2022b 以降)
Configure Timer Service Interfaces
Configure timer services for export functions. (R2022b 以降)

データアクセスと初期化

異なるデータ型のコンテキストでパラメーターデータを再利用
異なるデータ型のコンテキストで使用できる Simulink.Parameter オブジェクトまたは MATLAB^® の数値変数を作成して、パラメーターデータを再利用します。
生成されたコードにおけるブロックパラメーターの調整可能性の制限
ブロックパラメーターが生成されたコードに調整可能として表示されないように制限できます。これは、コードをコンパイルした後にパラメーター値を操作できなくなることを意味します。
信号、状態、パラメーターデータへの実行時のアクセス
モデルの反復的な開発においては、モデル実行で生成される出力信号や状態のデータを取得します。実行時にはパラメーターの値の調整を行い、出力での結果を確認する。
シミュレーションおよびコード実行時のパラメーター値セットの切り替え
独立した値のセットを構造体配列に格納して、同じブロックパラメーターのこのセットを切り替えます。
生成されたコードのパラメーター引数のパッケージ化の設定
生成されたコード内のパラメーター引数の実装をカスタマイズする。
生成されたコードにおける信号および状態の初期化の制御
たとえば、シャットダウンおよび再起動を行うシステムのモデル化のために、調整可能な初期条件をメモリに格納できるようにするコードを生成します。
生成されたコードでの信号、状態、パラメーターデータの初期化
Simulink^® でシミュレーションの数値を一致させるには、特にブロックの状態とパラメーターに対する初期値を生成されたコードでグローバルデータに代入します。
Compile Code Conditionally for All Values of Variant Parameters with Same and Different Dimensions
This example shows how to generate a C code that contains all the active and inactive values of variant parameters. The values are enclosed in preprocessor conditionals #if and #elif that enables you to compile the code conditionally based on the condition that evaluates to true.

注目の例

Generate Sender and Receiver C Interface Code for Component Deployment

R2022b 以降

ライブスクリプトを開く

Generate C Data Transfer Service Interface Code for Component Deployment

Generate calls to target platform data transfer service functions to exchange data between callable entry-point functions generated from a component model.

R2022b 以降

ライブスクリプトを開く