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

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

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

ツール

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

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

オブジェクト

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

関数

すべて展開する

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

`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`	モデルのコードマッピングの取得
`coder.mapping.utils.create`	Create code mappings object for configuring data and function interface for C and C++ code generation
`find`	Get model elements for the category of model code mappings

関数の構成

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

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

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

パラメーターの構成

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

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

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

データ転送の構成

`getDataTransfer`	Get code configuration from code mappings for signal representing data transfer
`setDataTransfer`	Set code configuration in code mappings for signal representing data transfer

トピック

構成の基礎

Service Interface Configuration for Model Interface Elements
Control the representation of model data elements and functions in generated C code by using a service code interface configuration.
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.
起動、リセット、シャットダウン関数インターフェイス
モデルで表される起動、リセット、シャットダウン処理の呼び出し可能なエントリポイント関数を生成する。

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

Service Interfaces
Generate C service interface code for components that interact with target environment resources.
Configure Sender and Receiver Service Interfaces for Model Inports and Outports
Configure sender and receiver service interfaces for model Inports and Outports.
Configure Data Transfer Service Interfaces for Data Transfer Signals
Configure data transfer service interfaces for signals representing data transfers between functions.
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.
Configure Measurement Service Interfaces for Signals, States, and Data Stores
Configure measurement services for signals, states, and data stores.
Configure Timer Service Interfaces
Configure timer services for export functions.

データアクセスと初期化

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

注目の例

Generate Sender and Receiver C Interface Code for Component Deployment

ライブスクリプトを開く

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.