Main Content

rtwbuild

(非推奨) モデルから生成されたコードをビルド

ページ内をすべて折りたたむ

rtwbuild は推奨されません。代わりに slbuild を使用してください。

構文

rtwbuild(model)
rtwbuild(model,Name,Value)
rtwbuild(subsystem)
rtwbuild(subsystem,'Mode','ExportFunctionCalls')
blockHandle = rtwbuild(subsystem,'Mode','ExportFunctionCalls')

説明

rtwbuild(model) は、現行モデルのコンフィギュレーション パラメーターの設定内容に基づいて、model からコードを生成します。引数 model が、MATLAB® 環境内にまだ読み込まれていない場合は、コードを生成する前に rtwbuild がこれを読み込みます。

[コード生成のみ] のモデル コンフィギュレーション パラメーターをクリアした場合は、関数はコードを生成し、実行可能イメージをビルドします。

コード生成時間を短縮するため、rtwbuild はモデルをリビルドするときに、インクリメンタル モデルのビルドを提供します。コード ジェネレーターは、最後に行われたモデルのビルド以後に変更されたモデルまたはサブモデルのみリビルドします。最上位モデルのビルドを強制的に実行する場合は、引数 'ForceTopModelBuild' を参照してください。

rtwbuild(model,Name,Value) は、1 つ以上の Name,Value 引数のペアによって指定された追加オプションを使用します。

rtwbuild(subsystem) は、現行モデルのコンフィギュレーション パラメーターの設定内容に基づいて、subsystem からコードを生成します。ビルドを開始する前に、親モデルを開くか読み込みます。

[コード生成のみ] のモデル コンフィギュレーション パラメーターをクリアした場合は、関数はコードを生成し、実行可能イメージをビルドします。

Embedded Coder® のソフトウェア ライセンスをお持ちの場合は、rtwbuild(subsystem,'Mode','ExportFunctionCalls') によって、外部アプリケーション コードにエクポートできる関数呼び出しを含む subsystem からコードが生成されます。

[ブロックの作成] コンフィギュレーション パラメーターが [SIL] に設定されていて、Embedded Coder をお持ちの場合、blockHandle = rtwbuild(subsystem,'Mode','ExportFunctionCalls') は指定したサブシステムから生成されたコード用に作成された SIL ブロックに、ハンドルを戻します。これにより、SIL ブロックを数値的等価性のテストに使用できます。

入力引数

すべて折りたたむ

コードを生成する、または実行可能イメージをビルドするモデルです。オブジェクトまたはモデル名を表す文字ベクトルとして指定します。

例: 'rtwdemo_exporting_functions'

コードを生成する、または実行可能イメージをビルドするサブシステムです。サブシステム名または絶対ブロック パスを表す文字ベクトルとして指定します。

例: 'rtwdemo_exporting_functions/rtwdemo_subsystem'

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名、Value は対応する値です。名前と値の引数は他の引数の後に配置しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用して各名前と値を区切り、Name を引用符で囲みます。

例: rtwbuild('TopModelCode','ForceTopModelBuild',true)

true または false として指定された、最上位モデル コードの強制的な再生成です。

アクション指定
参照モデルを含むシステムの最上位モデルのコードをコード ジェネレーターで強制的に再生成する true
モデルおよびモデル パラメーターの変更に基づいて最上位モデルのコードを再生成するかどうかを、コード ジェネレーターが決定するよう指定 false

カスタム ターゲット用のコードなどの外部またはカスタム コードに関連する項目を変更した場合は、最上位モデル用のコードを強制的に再生成させることを考慮します。たとえば、変更を行った場合は、ForceTopModelBuild を true に設定します。

  • TLC コード

  • rtwmakecfg.m ファイルを含む S-Function ソース コード

  • 統合されたカスタム コード

Code generation folder内のフォルダー (たとえば slprj または生成モデル コード フォルダー) を削除することによって、最上位モデル コードを強制的に再生成することもできます。

値を指定しない場合、[コード生成] ペインの [コード生成のみ] (GenCodeOnly) オプションはビルド プロセスの動作を制御します。

値を指定すると、引数は [コード生成] ペインの [コード生成のみ] (GenCodeOnly) をオーバーライドします。

アクション指定

コードのみを生成する。

true

コードを生成して実行可能ファイルをビルドする。

false

  • 'ExportFunctionCalls' –– Embedded Coder をお持ちの場合は、外部アプリケーション コードにエクポートできる関数呼び出しを含む subsystem からコードが生成されます。

  • 'Normal' –– 関数呼び出しをエクスポートしません。

指定したサブシステムに対してエクスポートされた初期化関数に名前を付けます。

例: rtwbuild(subsystem,'Mode','ExportFunctionCalls','ExportFunctionInitializeFunctionName', fcnname)

ビルド情報を [ビルド ステータス] ウィンドウに表示します。true または false として指定します。[ビルド ステータス] ウィンドウの使用方法の詳細については、参照モデルの並列ビルドのモニターを参照してください。

[ビルド ステータス] ウィンドウは参照モデルの階層構造の並列ビルドをサポートします。シリアル ビルドに [ビルド ステータス] ウィンドウを使用しないでください。

アクション指定
ビルド情報を [ビルド ステータス] ウィンドウに表示true
アクションなしfalse

難読化された C コードを生成するかどうかを true または false として指定します。

アクション指定
知的所有権が侵害される可能性が低くなる、サードパーティと共有可能な難読化された C コードを生成します。true
アクションなし。false

モデル参照シミュレーション ターゲットをビルドするオプション。'IncludeModelReferenceSimulationTargets' および true または false で構成されるコンマ区切りのペアとして指定します。

データ型: logical

出力引数

すべて折りたたむ

生成されたサブシステム コード用に作成された SIL ブロックへのハンドルです。次の両方の条件が満たされた場合のみ、返されます。

  • Embedded Coder ソフトウェアを使用するライセンスを持っている。

  • [ブロックの作成] モデル コンフィギュレーション パラメーターが [SIL] に設定されている。

ヒント

以下の方法でコード生成およびビルド プロセスを開始できます。

  • Ctrl+B キーを押す。

  • [コード] 、 [C/C++ コード] 、 [モデルのビルド] を選択する。

  • MATLAB コマンド ラインから slbuild コマンドを実行する。

拡張機能

バージョン履歴

R2009a で導入

すべて展開する

参考

| | | |

トピック