このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

Function Caller

Simulink またはエクスポートされた Stateflow 関数の呼び出し

• 

×

ライブラリ:
Simulink / User-Defined Functions

説明

Function Caller ブロックは、Simulink Function ブロックで定義された関数またはエクスポートされた Stateflow^® 関数を呼び出して実行します。Function Caller ブロックを使用して、モデルまたはチャート階層の任意の場所から関数を呼び出すことができます。

Simulink Function ブロックまたは Function Caller ブロックを選択して、関連するブロックを強調表示できます。1 つ以上の関連するブロックがサブシステムまたは参照モデルに含まれている場合、関連するブロックに加え、その関連ブロックを含む Subsystem ブロックまたは Model ブロックも強調表示されます。

開いているブロック線図または新しいタブに関連するブロックを表示するには、Simulink Function ブロックまたは Function Caller ブロックの選択後に表示される省略記号をポイントします。その後、操作バーから [関連するブロック] を選択します。選択したブロックに複数のブロックが対応している場合は、関連するブロックのリストが開きます。リストはテキスト ボックスに検索語を入力してフィルター処理できます。関連するブロックをリストから選択すると、関連するブロックが表示された開いているブロック線図または新しいタブにウィンドウのフォーカスが移ります。

例

Simulink 関数を使用した共有プリンターでのインク状態の監視

この例では、複数のクライアントから 1 つのサーバーにリクエストを送信し、サーバーから状態を受信する方法を示します。Simulink® 関数を使用すると、さまざまなサブシステムで他のサブシステムの関数を呼び出し、Simulink および Stateflow® でやり取りできます。この例では、Simulink 関数を使用して共有プリンターのインク状態の監視をモデル化します。

• ライブ スクリプトを開く

複数インスタンス化された Simulink 関数を使用した再利用可能なコンポーネントのモデル化

この例では、モデル slexCounterFunctionMdlRef に、カウンターを維持する Simulink® 関数 update が含まれています。複数のインスタンス作成により、このモデル例でこのロジックを CounterA および CounterB として再利用できます。

• モデルを開く

関数の動的な優先順位スケジューリング

この例では、Stateflow® チャートを使って関数の実行を動的にスケジュールする一般的なモデル化パターンを示します。

• モデルを開く

制限

Function Caller ブロックを使用して Simulink^® またはエクスポートされた Stateflow 関数を非同期で呼び出して実行するモデルのコードを生成するには、モデル コンフィギュレーション パラメーター [システム ターゲット ファイル] を autosar_adapative.tlc に設定する必要があります。それ以外のシステム ターゲット ファイル設定については、Function Caller のブロック パラメーター [関数呼び出しを非同期で実行] をオフにします。

端子

入力

Input argument — 入力引数の入力信号

スカラー | ベクトル | 行列

関数に送信される入力引数のための入力信号。

関数プロトタイプにより、Function Caller ブロックに表示される入力端子の数と名前が決まります。信号線を入力端子に接続し、関数入力引数を通してデータを関数に送信します。

たとえば y = myfunction(u) は Function Caller ブロックに 1 つの入力端子 (u) を作成します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus

出力

Output argument — 出力引数の出力信号またはメッセージ

スカラー | ベクトル | 行列 | メッセージ

関数から返される出力引数のための出力信号。

関数プロトタイプにより、Function Caller ブロックに表示される出力端子の数と名前が決まります。信号またはメッセージの線を出力端子に接続し、関数出力引数を通してデータを関数から受信します。Function Caller ブロックでは、[関数呼び出しを非同期で実行] チェック ボックスがオンの場合はメッセージを出力します。

たとえば y = myfunction(u) は Function Caller ブロックに 1 つの出力端子 (y) を作成します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus

パラメーター

関数プロトタイプ — 関数インターフェイスの指定

y=f(u) (既定値) | <関数プロトタイプ>

Function Caller ブロックと Simulink 関数との間の関数インターフェイスを指定します。Simulink 関数は、Simulink Function ブロック、エクスポートされた Stateflow グラフィカル関数、エクスポートされた Stateflow MATLAB^® 関数にすることができます。Simulink Function ブロックの呼び出しの場合、次が適用されます。

• 関数呼び出しの引数名は関数の引数と一致しなければならない。

• 関数名、入力引数、出力引数は有効な MATLAB 識別子でなければならない。

プログラムでの使用

ブロック パラメーター: FunctionPrototype

型: 文字ベクトル

値: 'y=f(u)' | '<function prototype>'

既定の設定: 'y=f(u)'

入力引数の仕様 — 入力引数のデータ型、次元、実数/複素数の指定

<Enter example> (既定値) | <MATLAB 式>

各入力引数のデータ型、次元、実数/複素数 (実数または虚数) の指定を組み合わせた MATLAB 式をコンマ区切りリストで指定します。例については、Simulink Function ブロックの引数の指定を参照してください。

この指定は、Argument Inport ブロックの [データ型] パラメーターで指定された Simulink Function ブロック データ型と一致しなければなりません。

プログラムでの使用

ブロック パラメーター: InputArgumentSpecifications

型: 文字ベクトル

値: '' | '<MATLAB expression>'

既定の設定: ''

出力引数の仕様 — 出力引数のデータ型、次元、実数/複素数の指定

<Enter example> (既定値) | <MATLAB Expression>

各出力引数のデータ型、次元、実数/複素数 (実数または虚数) の指定を組み合わせた MATLAB 式をコンマ区切りリストで指定します。例については、Simulink Function ブロックの引数の指定を参照してください。

この指定は、Argument Outport ブロックの [データ型] パラメーターで指定された Simulink Function ブロック データ型と一致しなければなりません。

プログラムでの使用

ブロック パラメーター: OutputArgumentSpecifications

型: 文字ベクトル

値: '' | '<MATLAB expression>'

既定の設定: ''

サンプル時間 — 関数呼び出しの時間間隔

-1 (既定値) | <サンプル時間>

Function Caller ブロックが指定された Simulink 関数を呼び出す時間間隔を指定します。

既定の設定では、ブロックはモデル内の前後関係に基づいてサンプル時間を継承します。

他のサンプル時間を設定するには、サンプル時間の指定の表にあるサンプル時間形式を使用して値を入力します。

Function Caller ブロックに入力がある場合、それは非ソース ブロックであり、サンプル時間を -1 に設定しなければなりません。

プログラムでの使用

ブロック パラメーター: SampleTime

型: 文字ベクトル

値: '-1' | sample time

既定の設定: '-1'

関数呼び出しを非同期で実行 — 呼び出し元の関数呼び出し要求がサービス実行を待機できるかどうか

off (既定値) | on

この Function Caller ブロックに関連付けられた Simulink Function ブロックに対して関数呼び出しを非同期で実行するかどうかを指定します。

• 呼び出し元 (クライアント) が関数 (サーバー) を呼び出す要求を行う "非同期実行" をモデル化するには、このチェック ボックスをオンにします。関数は、スケジュール エディターで定義されている順序に基づいて実行され、出力引数を呼び出し元に返します。ブロックは、それらの引数をメッセージ出力端子を使用して出力します。

  • 関数出力引数が 1 つの場合、その出力引数がメッセージ ペイロードになります。

  • 関数出力引数が複数の場合、Function Caller ブロックは出力引数を構造体としてまとめ、その構造体がメッセージ ペイロードになります。

  メッセージ出力端子は、即時モードで Message Triggered Subsystem ブロックに接続します。Message Triggered Subsystem ブロックが関数のコールバックとして機能します。

• 呼び出し元が関数を呼び出し、関数が直ちに実行されて出力引数を呼び出し元に返す "同期実行" をモデル化するには、このチェック ボックスをオフにします。

プログラムでの使用

ブロック パラメーター: AsynchronousCaller

型: 文字ベクトル

値: 'on' | 'off'

既定の設定: 'off'

ブロックの特性

データ型	Boolean | bus | double | enumerated | fixed point | integer | single
直達	はい
多次元信号	はい
可変サイズの信号	いいえ
ゼロクロッシング検出	いいえ

拡張機能

C/C++ コード生成
Simulink® Coder™ を使用して C および C++ コードを生成します。

固定小数点の変換
Fixed-Point Designer™ を使用して固定小数点システムの設計とシミュレーションを行います。

バージョン履歴

R2014b で導入

R2022b: 参照モデル内の関連する Simulink Function ブロックの強調表示

R2022b 以降では、関連する Simulink Function ブロックが参照モデル内にある Function Caller ブロックを選択したときに、Simulink Function ブロックと参照モデルの Model ブロックの両方が強調表示されます。

参考

Argument Inport | Argument Outport | Trigger | Simulink Function | MATLAB Function | Chart (Stateflow) | Subsystem | Function-Call Subsystem | Inport | Outport | Function Element Call

トピック

• Simulink 関数の概要
• モデルのスコープ内の Simulink Function ブロック
• モデルへの Simulink 関数の追加