モデル例の確認

モデル例rtwdemo_rtwintroを開きます。

open_system('rtwdemo_rtwintro')

アプリ ギャラリーで[Simulink Coder]をクリックします。

モデル データ エディターを開きます。[モデル化]タブで[モデル データ エディター]をクリックします。

[状態]タブを検査します。Unit Delay ブロックの状態について、[初期値]は既定で0に設定されます。つまり、状態の初期値はゼロです。状態の名前はXです。

[初期値]を5などの非ゼロの数値に設定します。

set_param('rtwdemo_rtwintro/X','InitialCondition','5')

コード マッピング エディターを開きます。[C コード]タブで、[コード インターフェイス]、[個々の要素コードのマッピング]を選択します。

[信号/状態]タブの[状態]で、Xの[ストレージ クラス]をExportedGlobalに設定します。この設定により、ブロックの状態が独立したグローバル変数として生成されたコードに現れます。

coder.mapping.utils.create('rtwdemo_rtwintro'); cm = coder.mapping.api.get('rtwdemo_rtwintro'); setState(cm,'rtwdemo_rtwintro/X','StorageClass','ExportedGlobal');

モデルで、Triggered Subsystem であるAmplifierサブシステムを開きます。

モデル データ エディターで、[パラメーター]タブを検査します。信号および状態の初期値の設定および確認のために、[状態]タブではなく[パラメーター]タブを使用できます。

Outport ブロックの[初期出力](InitialOutput) パラメーターが既定値の0に設定されていることがモデル データ エディターに表示されます。このサブシステムは条件付きで実行されるため、このサブシステムの出力には初期値が必要です。初期値は既定のままにします。

モデルで、[コンフィギュレーション パラメーター]、[信号ストレージの再利用]をオフにします。この設定をオフにすると、信号データを保存する目的で生成された構造体のフィールドとして、信号線が生成されたコードに表示されます。この信号の表現により、コード ジェネレーターでデータが初期化される方法を確認しやすくなります。

set_param('rtwdemo_rtwintro','OptimizeBlockIOStorage','off')

モデルで、コンフィギュレーション パラメーター ([コンフィギュレーション パラメーター]、[最適化]、[既定のパラメーター動作]) を検証します。コンフィギュレーション パラメーターはInlinedに設定されています。つまり、初期値を含むブロック パラメーターは、インライン化されたリテラルまたはconstデータとして生成されたコードに現れます。

モデルのルート レベルに移動します。

モデル データ エディターで[追加情報の表示/更新]ボタンをクリックします。

[コンテンツのフィルター]ボックスの近くの[選択を使用してフィルター処理します]ボタンをクリックします。

モデルでINCというラベルの Constant ブロックをクリックします。このブロックの[定数値](Value) パラメーターはINCに設定されていることがモデル データ エディターで表示されます。INCはベース ワークスペース内の MATLAB 変数です。

INCについて、[値]列の値をSimulink.Parameter(uint8(1))に設定します。MATLAB によってINCがSimulink.Parameterオブジェクトに変換されます。

コード マッピング エディターの[パラメーター]タブで、ストレージ クラスExportedGlobalをINCに適用します。この設定により、生成されたコードではINCがグローバル変数として定義されます。初期化の場合、INCはパラメーター データの項目です。

INC = Simulink.Parameter(INC); INC.StorageClass ='ExportedGlobal';

コードの生成と検査

モデルをビルドしてコードを生成するには、Ctrl+Bを押します。

slbuild('rtwdemo_rtwintro');

### Starting build procedure for: rtwdemo_rtwintro ### Successful completion of build procedure for: rtwdemo_rtwintro Build Summary Top model targets built: Model Action Rebuild Reason ================================================================================================= rtwdemo_rtwintro Code generated and compiled Code generation information file does not exist. 1 of 1 models built (0 models already up to date) Build duration: 0h 0m 16.023s

生成されたファイルrtwdemo_rtwintro.cのコードでは、関数定義の外でパラメーター データINCが静的に初期化されています。INCの値は1です。

file = fullfile('rtwdemo_rtwintro_grt_rtw','rtwdemo_rtwintro.c'); rtwdemodbtype(file,'/* Exported block parameters */','uint8_T INC = 1U;',1,1)

/* Exported block parameters */ uint8_T INC = 1U; /* Variable: INC

同じファイル内で関数rtwdemo_rtwintro_initializeの定義を検証します。最初に、この関数はmemsetを使用して、モデル内の内部信号を保存された0の値に初期化します。

rtwdemodbtype(file,'/* block I/O */','sizeof(B_rtwdemo_rtwintro_T));',1,1)

/* block I/O */ (void) memset(((void *) &rtwdemo_rtwintro_B), 0, sizeof(B_rtwdemo_rtwintro_T));

次に、関数は Unit Delay の状態Xをグラウンド値に初期化します。この場合、グラウンド値はゼロです。

rtwdemodbtype(file,'/* exported global states */','X = 0U;',1,1)

/* exported global states */ X = 0U;

また、この関数はルートレベルの入出力 (Inport ブロックと Outport ブロック) を含めたその他のデータもグラウンド値に初期化します。

rtwdemodbtype(file,'/* external inputs */','Amplifier_Trig_ZCE = POS_ZCSIG;',1,1)

/* external inputs */ rtwdemo_rtwintro_U.Input = 0; /* external outputs */ rtwdemo_rtwintro_Y.Output = 0; rtwdemo_rtwintro_PrevZCX.Amplifier_Trig_ZCE = POS_ZCSIG;

次に、関数はXを[初期条件]ブロック パラメーターで指定した値に初期化します。

rtwdemodbtype(file,'/* InitializeConditions for UnitDelay: ''/X'' */',...'X = 5U;',1,1)

/* InitializeConditions for UnitDelay: '/X' */ X = 5U;

最後に、関数はAmplifierサブシステムの出力を初期化します。

rtwdemodbtype(file,'SystemInitialize for Triggered SubSystem',...'End of SystemInitialize for SubSystem',1,1)

/* SystemInitialize for Triggered SubSystem: '/Amplifier' */ /* SystemInitialize for Outport: '/Output' incorporates: * Outport: '/Out' */ rtwdemo_rtwintro_Y.Output = 0;

保存された値と実際値との違いの検証

一部のデータでは、実際の初期値がゼロであってもコンピューターのメモリに非ゼロの値が保存されます。この違いを確認するには、勾配とバイアスでスケーリングされた固定小数点データ型をブロックの状態Xに適用します。この例を実行するには、Fixed-Point Designer™ が必要です。

モデル データ エディターで、[信号]タブを検査します。

モデルで、Switch ブロックswitch_outの出力信号をクリックします。

モデル データ エディターの[データ型]列を使用して、信号のデータ型をfixdt(1,16,1,3)に設定します。この式は1の勾配と3のバイアスをもつ固定小数点データ型を表します。

set_param('rtwdemo_rtwintro/Switch','OutDataTypeStr',...'fixdt(1,16,1,3)')

モデルで、Sum ブロックを選択します。プロパティ インスペクターで、[信号属性]の下の[すべての入力が同じデータ型をもつ]をオフにします。

set_param('rtwdemo_rtwintro/Sum','InputSameDT','off')

異なるプラットフォームでコンパイルエラーを回避するには,モデル コンフィギュレーション パラメーターの[コード生成のみ]を選択します。この設定により、モデルで生成されるのはコードのみになります。

set_param('rtwdemo_rtwintro','GenCodeOnly','on')

モデルをビルドしてコードを生成するには、Ctrl+Bを押します。

slbuild('rtwdemo_rtwintro')

### Starting build procedure for: rtwdemo_rtwintro ### Successful completion of code generation for: rtwdemo_rtwintro Build Summary Top model targets built: Model Action Rebuild Reason =================================================================== rtwdemo_rtwintro Code generated Generated code was out of date. 1 of 1 models built (0 models already up to date) Build duration: 0h 0m 6.8432s

モデル初期化関数は、最初にXを実際のグラウンド値0に初期化します。バイアス3をもつ勾配とバイアスでスケーリングされたデータ型により、この実際値は保存された-3の値に対応します。

rtwdemodbtype(file,'/* exported global states */','X = -3;',1,1)

/* exported global states */ X = -3;

次に、関数はXを[初期条件]ブロック パラメーターで指定した実際の初期値である5に初期化します。この実際値は保存された2の値に対応します。

rtwdemodbtype(file,'/* InitializeConditions for UnitDelay: ''/X'' */',...'X = 2;',1,1)

/* InitializeConditions for UnitDelay: '/X' */ X = 2;