S-Function

モデルに S-Function を追加

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

説明

S-Function ブロックは、ブロック線図から各 S-Function へのアクセスを提供します。[S-Function 名] パラメーターで名前を付けられる S-Function は、レベル 1 またはレベル 2 の C MEX S-Function です (S-Function を作成する方法の詳細については、MATLAB S-Function の基礎を参照)。

メモ

Level-2 MATLAB S-Function ブロックを使用して、ブロック線図に Level-2 MATLAB^® S-Function をインクルードします。

S-Function ブロックは、指定された S-Function の名前と S-Function により指定される入力端子および出力端子の数を表示します。入力に接続される信号は、入力に対し、S-Function により指定される次元をもつ必要があります。

例

アニメーションを使った倒立振子

この例では、倒立振子をモデル化する方法を示します。このアニメーションは、MATLAB® Handle Graphics® を使用して作成されています。Animation ブロックは、マスク S-Function です。詳細は、コンテキストメニューを使用して Animation ブロックのマスク内を調べ、編集するには S-Function を開いてください。

モデルを開く

S-Function API を使用するカスタムコードおよびハンドコードされたブロック

このライブラリは、さまざまなタイプの Simulink® S-Function の例を起動します。Simulink S-Function を使用すると、ハンドコードされたブロックを新たに加えて Simulink を拡張したり、カスタム外部コードとのインターフェイスをとったり、他のプログラムへのライブインターフェイスを作成したりできます。この例を使用して、C、C++、M および Fortran の S-Function が含まれたモデルにアクセスします。

例を開く

S-Function の品質チェックの実行

この例では、S-Function アナライザープログラムインターフェイスを使用して S-Function の潜在的な問題や改善点について確認する方法を示します。

モデルを開く

パラメーター

すべて展開する

S-Function 名 — S-Function の名前
文字配列 (既定値)

このパラメーターを使用して、S-Function の名前を指定します。

プログラムでの使用

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

型: 文字ベクトル

値: S-Function の名前

既定の設定: 'system'

S-Function パラメーター — 追加の S-Function パラメーター
cell 配列 (既定値)

追加の S-Function パラメーターを指定します。

関数パラメーターは、MATLAB 式で指定するか、コンマ区切りの変数として指定できます。たとえば、次のようにします。

A, B, C, D, [eye(2,2);zeros(2,2)]

それぞれのパラメーターは大かっこで囲めますが、パラメーターのリストは大かっこで囲んではならないことに注意してください。

プログラムでの使用

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

型: 文字ベクトル

値: S-Function パラメーター

既定の設定: ' '

S-Function モジュール — コード生成の追加ファイルをリスト
cell 配列 (既定値)

このパラメーターは、このブロックが C MEX S-Function を表し、このブロックを含むモデルからコードを生成するために、Simulink^® Coder™ ソフトウェアを使用する場合にのみ適用されます。コード生成準備ができているときにこれを使用する場合、最上位モデルコードの再生成の制御 (Simulink Coder)で説明するように、Coder に対して最上位モデルを強制的にリビルドするよう指示しなければなりません。

このパラメーターを使用する方法の詳細については、S-Function の追加ソースファイルの指定 (Simulink Coder)を参照してください。

プログラムでの使用

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

型: 文字ベクトル

値: ファイル名の文字ベクトル

既定の設定: ' '

ブロックの特性

データ型	`Boolean^a` \| `bus^a` \| `double^a` \| `fixed point^b^a` \| `half^a` \| `integer^a` \| `single^a` \| `string^a`
直達	`はい^a`
多次元信号	`はい^a`
可変サイズの信号	`はい^a`
ゼロクロッシング検出	`はい^a`
^a 実際のデータ型または機能のサポートは、ブロックの実装に依存します。 ^b S-Function における固定小数点データ型の使用についての詳細は、「固定小数点 S-Function の作成」を参照してください。

拡張機能

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

実際のコード生成のサポートは、ブロックの実装に依存します。
MATLAB を呼び出す S-Function はコード生成時はサポートされません。

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

実際のデータ型のサポートは、ブロックの実装に依存します。
S-Function における固定小数点データ型の使用の詳細については、外部コードの統合 (Fixed-Point Designer)を参照してください。

S-Function

説明