このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
S-Function Builder
C または C++ コードを統合して S-Function を作成する
ライブラリ:
Simulink /
User-Defined Functions
説明
S-function Builder ブロックは、新規あるいは既存の C または C++ コードを統合して、指定した仕様から C MEX S-Function (システム関数) を作成します。C MEX S-Function は、C または C++ で記述された Simulink® ブロックをコンピューター言語で記述したものです。S-Function では、S-Function API と呼ばれる特殊な呼び出し構文を使用して Simulink エンジンと対話できます。この対話は、エンジンと組み込みの Simulink ブロックの間で行われる対話と非常によく似ています。C MEX S-Function の詳細については、S-Function とはを参照してください。S-function Builder ブロックを使用した C MEX S-Function のビルドの詳細については、Build S-Functions Automatically Using S-Function Builderを参照してください。詳しい手順の例については、Use a Bus with S-Function Builder to Create an S-Functionを参照してください。
S-Function Builder ブロックのインスタンスは、Simulink モデルで生成された S-Function のラッパーとしても機能します。S-Function Builder ブロックのインスタンスを含むモデルのシミュレーションを実行すると、Simulink では mdlStart、mdlOutputs、mdlDerivatives、mdlUpdate、および mdlTerminate メソッドのインスタンスで C または C++ コードを呼び出すために、生成された C MEX S-Function を呼び出します。Simulink エンジンと S-Function の相互作用については、Simulink Engine Interaction with C S-Functionsを参照してください。
メモ
S-Function Builder ブロックはマスキングをサポートしません。しかし、S-Function Builder ブロックを含む Subsystem ブロックのマスキングは可能です。詳細については、Create Library Blocks Using Self-Modifiable Masks and Variant Blocksを参照してください。
例
Create S-Function Using S-Function Builder API
Integrate C function using S-Function Builder block API.
アニメーションを使った倒立振子
この例では、Simulink® を使用して倒立振子システムをモデル化およびアニメーション化する方法を示します。倒立振子の重心はピボット点より上にあります。この位置を安定して維持するために、システムは振子が落下を開始するとピボット点を重心より下に移動する制御ロジックを実装します。倒立振子は制御手法のテストに使用される古典力学問題です。
S-Function API を使用するカスタム コードおよびハンド コードされたブロック
このライブラリは、さまざまなタイプの Simulink® S-Function の例を起動します。Simulink S-Function を使用すると、ハンド コードされたブロックを新たに加えて Simulink を拡張したり、カスタム外部コードとのインターフェイスをとったり、他のプログラムへのライブ インターフェイスを作成したりできます。この例を使用して、C、C++、M および Fortran® の S-Function が含まれたモデルにアクセスします。
端子
入力
出力
パラメーター
ブロックの特性
データ型 |
|
直達 |
|
多次元信号 |
|
可変サイズの信号 |
|
ゼロクロッシング検出 |
|
ヒント
S-Function Builder ブロックでの S-Function のビルド後、get_param 関数で次のパラメーターの情報が返されます。
Parameters— 追加の S-Function パラメーターSFunctionModules— コード生成用の追加ファイル (ブロックが C MEX S-Function を表す場合)
拡張機能
バージョン履歴
R2006a より前に導入
