MATLAB Function ブロックを使用した C コードの統合

Simulink^® モデルに使用する C コードがある場合、MATLAB Function ブロックを使用してモデルに外部 C コードを呼び出すことができます。MATLAB Function ブロックは、MATLAB^® コマンドを使用して C コードを呼び出します。外部 C コードを呼び出す MATLAB Function ブロックを含むモデルからコードを生成することもできます。

Simulink モデルからの C コードの呼び出し

Simulink モデルの外部 C コードを呼び出すには、次の手順に従います。

モデルで使用する C コードを含むソース (.c) ファイルとヘッダー (.h) ファイルを特定します。
MATLAB Function ブロックをモデルに挿入します。
MATLAB Function ブロックで、関数 coder.ceval を使用して C コードを呼び出します。データを参照によって渡すには、coder.ref、coder.rref または coder.wref を使用します。
[コンフィギュレーションパラメーター] ウィンドウの [シミュレーションターゲット] ペインで C ソースおよびヘッダーファイルを指定します。二重引用符を使用してヘッダーファイルを含めます (たとえば、#include "program.h")。作業フォルダー外の C ソースおよびヘッダーファイルにアクセスする必要がある場合は、[シミュレーションターゲット] ペインで、[インクルードディレクトリ] テキストボックスにパスの一覧を作成します。
または、関数 coder.cinclude および関数 coder.updateBuildInfo を使用して、MATLAB コード内でソースファイルおよびヘッダーファイルを指定します。外部コードへのインターフェイスを開発するために、coder.ExternalDependency クラスを使用できます。サポートされるワークフローを確認するには、カスタムコードのインポートを参照してください。
Simulink モデルをテストし、正しく機能することを確認します。
Simulink Coder™ ライセンスがある場合は、ターゲットのコードを生成できます。コード生成で同じソースおよびヘッダーファイルを使用するには、[コンフィギュレーションパラメーター] を開き、[コード生成] 、 [カスタムコード] ペインに移動して、[シミュレーションターゲットと同じカスタムコードの設定を使用] を有効にします。異なるソースおよびヘッダーファイルを指定することもできます。
シミュレーションおよびコード生成用のさまざまなコマンドを実行するコードに条件を付ける場合、関数 coder.target を使用できます。

MATLAB Function ブロックの例での `coder.ceval` の使用

この例では、単純な C プログラム doubleIt を MATLAB Function ブロックから呼び出す方法を示します。

現在の作業フォルダーにソースファイル doubleIt.c を作成します。
```
#include "doubleIt.h"

double doubleIt(double u)
{
     return(u*2.0);
}
```
現在の作業フォルダーにヘッダーファイル doubleIt.h を作成します。
```
#ifndef MYFN
#define MYFN

double doubleIt(double u);

#endif
```
新しい Simulink モデルを作成します。myModel として保存します。
ライブラリブラウザーで、[Simulink] 、 [User-Defined Functions] ライブラリに移動し、MATLAB Function ブロックをモデルに追加します。
ブロックをダブルクリックして MATLAB Function ブロックエディターを開きます。doubleIt プログラムを呼び出すコードを入力します。
```
function y = callingDoubleIt(u)

y = 0.0;
y = coder.ceval("doubleIt",u);
```
3.5 の値をもつ Constant ブロックを MATLAB Function ブロックの入力端子に接続します。
Display ブロックを出力端子に接続します。
[コンフィギュレーションパラメーター] ウィンドウを開き、[シミュレーションターゲット] ペインに移動します。
[コード情報] タブで、[インクルードヘッダー] をクリックし、「#include "doubleIt.h"」と入力します。
[ソースファイル] タブをクリックし、「doubleIt.c」と入力します。[OK] をクリックします。
シミュレーションを実行します。値 7 が Display ブロックに表示されます。

インポートされたバスと列挙型定義の制御

MATLAB Function ブロックを使用して外部 C コードを呼び出すと、モデルでインポートされたバスと列挙の型定義を制御できます。Simulink で型定義を生成するか、ユーザーによる型定義を含むヘッダーファイルを与えることができます。この動作は、[インポートしたバスと列挙型に対して typedef を生成する] パラメーターを切り替えて制御できます。このパラメーターを見つけるには、[コンフィギュレーションパラメーター] ウィンドウを開き、[シミュレーションターゲット] ペインに移動して、[詳細設定パラメーター] セクションを展開します。

Simulink で自動的に型定義を生成するように構成するには、[インポートしたバスと列挙型に対して typedef を生成する] を有効にします。列挙型とバス型を定義するカスタムヘッダーファイルを含めるには、[インポートしたバスと列挙型に対して typedef を生成する] をオフにし、[ヘッダーファイル] テキストボックスでヘッダーファイルをリストします。

参考

クラス

coder.ExternalDependency | coder.BuildConfig

関数

coder.ceval | coder.target | coder.cinclude | coder.updateBuildInfo | coder.ref | coder.rref | coder.wref