インライン不変信号

生成コードで不変信号のシンボリック名を変換する

モデル コンフィギュレーション ペイン: [コード生成] / [最適化]

説明

[インライン不変信号] パラメーターは、不変信号のシンボリック名を定数値に変換するようにコード ジェネレーターに指示します。

不変信号はブロックの出力信号のなかで、Simulink^® シミュレーション中に変化しない信号のことです。たとえば、次のモデルでは信号 S3 は不変信号です。"不変信号" は "不変定数" と同じではないことに注意してください。2 個の定数 (1 と 2) およびゲイン値 3 が不変定数です。不変定数をインライン化するには、[既定のパラメーター動作] を [インライン] に設定します。

カテゴリ: 最適化

依存関係

このパラメーターは、[既定のパラメーター動作] を [インライン] に設定した場合に有効になります。

設定

off (既定値) | on

オン

Simulink Coder™ ソフトウェアは、生成されたコード内でシンボリック名ではなくモデル パラメーターの数値を使用します。不変信号は、非スカラーまたは複素数であるか、あるいは信号が付加されているブロック入力端子が信号のアドレスを受け取る場合は、インラインではありません。

オフ

モデル パラメーターのシンボリック名を生成されたコードで使用します。

例

インライン不変信号を使用した生成コードの最適化

この例では、インライン不変信号を使用して生成コードを最適化する方法を示します。この最適化により不変信号のシンボリック名が定数値に変換されます。

InlineInvariantSignals の最適化により、以下が実現されます。

• ROM と RAM の消費を低減する。

• 実行速度が向上する。

モデル例

モデル InvariantSignalsInline について見ていきます。

model = 'InvariantSignalsInline';
open_system(model);

コードの生成

Simulink® Coder™ を使用してモデルをビルドします。

slbuild(model)

### Searching for referenced models in model 'InvariantSignalsInline'.
### Total of 1 models to build.
### Starting build procedure for: InvariantSignalsInline
### Successful completion of build procedure for: InvariantSignalsInline

Build Summary

Top model targets:

Model                   Build Reason                                         Status                        Build Duration
=========================================================================================================================
InvariantSignalsInline  Information cache folder or artifacts were missing.  Code generated and compiled.  0h 0m 7.5391s

1 of 1 models built (0 models already up to date)
Build duration: 0h 0m 8.2049s

最適化を行わない生成コードを表示します。以下のコード行は InvariantSignalsInline.c にあります。

cfile = fullfile('InvariantSignalsInline_grt_rtw',...
    'InvariantSignalsInline.c');
coder.example.extractLines(cfile,'/* Output and update for atomic system',...
    '/* Model output', 1, 0);

/* Output and update for atomic system: '<Root>/InlinedConstFcn' */
void InvariantSignal_InlinedConstFcn(int32_T rtu_In1,
  B_InlinedConstFcn_InvariantSi_T *localB, const ConstB_InlinedConstFcn_Invari_T
  *localC)
{
  /* Product: '<S1>/Product' */
  localB->Product = rtu_In1 * localC->Sum_p;
}

最適化の有効化

1. [コンフィギュレーション パラメーター] ダイアログ ボックスを開きます。

2. [最適化] ペインで、[インライン不変信号] を選択します。

代わりに、コマンド ライン API を使用して最適化を有効にできます。

set_param(model, 'InlineInvariantSignals', 'on');

最適化を使用したコードの生成

生成コードは追加の構造体を作成せずに、畳み込まれた定数の数値を使用します。

Simulink Coder を使用してモデルをビルドします。

slbuild(model)

### Searching for referenced models in model 'InvariantSignalsInline'.
### Total of 1 models to build.
### Starting build procedure for: InvariantSignalsInline
### Successful completion of build procedure for: InvariantSignalsInline

Build Summary

Top model targets:

Model                   Build Reason                     Status                        Build Duration
=====================================================================================================
InvariantSignalsInline  Generated code was out of date.  Code generated and compiled.  0h 0m 6.4573s

1 of 1 models built (0 models already up to date)
Build duration: 0h 0m 7.3518s

最適化を行った InvariantSignalsInline.c の生成コードを表示します。

coder.example.extractLines(cfile,...
    '/* Output and update for atomic system', '/* Model output', 1, 0);

/* Output and update for atomic system: '<Root>/InlinedConstFcn' */
void InvariantSignal_InlinedConstFcn(int32_T rtu_In1,
  B_InlinedConstFcn_InvariantSi_T *localB)
{
  /* Product: '<S1>/Product' */
  localB->Product = rtu_In1 << 5;
}

モデルおよびコード生成レポートを閉じます。

bdclose(model)

推奨設定

アプリケーション	設定
デバッグ	オフ
トレーサビリティ	オフ
効率性	オン
安全対策	影響なし

プログラムでの使用

パラメーター: InlineInvariantSignals

型: 文字ベクトル

値: 'on' | 'off'

既定の設定: 'off'

バージョン履歴

R2006a より前に導入

参考

トピック

• モデル コンフィギュレーション パラメーター: コード生成の最適化
• コードの効率性