- IAR Embedded Workbench for Arm 9.70.x
- C-SPY デバッグ
- プロファイリング
- プロファイラについてのリファレンス情報
プロファイラについてのリファレンス情報
関連項目 :
[関数プロファイラ]ウィンドウ
What do you want to do?

C-SPY ドライバーメニューから [関数プロファイラー]ウィンドウが利用できます。

このウィンドウには関数プロファイラの情報が表示されます。
トレース(フラット) が選択されている場合、ウィンドウの左端の各行にチェックボックスが表示されます。これらのチェックボックスを使用して、プロファイリングに行を含めたり、除外します。除外された行は灰色表示されますが、削除はされません。
要件
以下のいずれかが必要です。
C-SPY シミュレータ。一部のコアおよびデバイスでのみ使用できます。
C-SPY I-jetドライバ。
C-SPY J-Link/J-Traceドライバ
C-SPY CMSIS-DAPドライバ
C-SPY ST-LINKドライバ
C-SPY TI XDSドライバ
ツールバー
ツールバーの内容は以下のとおりです。
- 有効 / 無効

プロファイラを有効 / 無効にします。
- クリア

すべてのプロファイリングデータをクリアします。
- セーブ

標準の[名前を付けて保存]ダイアログボックスを開きます。ウィンドウの内容をタブ区切りでファイルに保存できます。展開されていない行のみがリストファイルに含まれます。
- グラフィック表示

パーセント値を表す列の値をグラフィカルバーにオーバレイします。
- プログレスバー
処理中のプロファイリングデータのバックログを表示します。受信データのレートが、データを処理するプロファイラのレートより高い場合は、バックログが蓄積されます。プログレスバーは、プロファイラがデータ処理を実行中であることを示します。また、プロファイラがどのぐらいの速度で処理中か、おおよその速度も示します。
プロファイラは特定のレートでデータを処理し、ターゲットシステムは違うレートでデータを提供するため、処理待ちのデータ量は増減する可能性があることに注意してください。プログレスバーは、それに従って伸縮します。
- 間隔モード

選択した間隔のプロファイリングと完全なプロファイリングを切り替えます。このツールバーのボタンは、PC サンプリングがデバッグプローブでサポートされている場合にのみ使用できます。
使用する C-SPY ドライバでどのビューがサポートされているかについては、プロファイラの使用に関する要件を参照してください。
- ステータスフィールド
選択した間隔の範囲が表示されます。すなわち、プロファイルされた選択範囲です。間隔プロファイリングモードが有効な場合、このフィールドは黄色です。このフィールドは、PC サンプリングがデバッグプローブ(SWO トレース)でサポートされている場合にのみ使用できます。
使用する C-SPY ドライバでどのビューがサポートされているかについては、プロファイラの使用に関する要件を参照してください。
表示エリア
表示エリアの内容は、プロファイリング情報に使用されるソースによって決まります。
トレース(コール)ソースの場合は、デバッグ情報を有効にしてコンパイルされた各関数が各行に表示されます。複数のプロファイリング情報が収集された場合は、別の関数を呼び出した関数の行を展開できます。特定の関数の子要素には、その親関数によって呼び出されたすべての関数と、関連する統計がリストされます。
トレース(フラット)ソースの場合は、各行にアプリケーションのC関数がそれぞれ表示されます。ランタイムライブラリからのコードまたはデバッグ情報なしの別コードからのセクションが、対応するアセンブラベルによって示されたもののみ、表示されます。トレースデータからの実行済
PCアドレスは、個別のサンプルとして扱われ、[プロファイリング]ウィンドウで対応する行に関連付けられます。各行には、これらのサンプル数が含まれます。
使用する C-SPY ドライバでどのビューがサポートされているかについては、プロファイラの使用に関する要件を参照してください。
表示エリアには以下の情報が表示されます。
- 関数(すべてのソース)
プロファイルされた C 関数の名前。
サンプリングソースの場合は、ランタイムライブラリからのコードまたはデバッグ情報なしの別コードからのセクションが、対応するアセンブラベルによって示されたもののみ表示されます。
- コール(トレース(コール))
関数の呼び出し回数。
- フラット時間(トレース(コール))
関数内で消費された時間(サイクル数)。
- フラット時間 (%)(トレース(コール))
合計時間の割合で表されたフラット時間。
- 累積時間(トレース(コール))
この関数およびこの関数によるすべての呼び出しで消費された時間(サイクル数)。
- 累積時間 (%)(トレース(コール))
合計時間の割合で表された累計時間。
- PC カウント(トレース(フラット)とサンプル)
関数に関連する実行済みの命令(トレース)または PC サンプル(サンプル)。
- PC カウント (%)(トレース(フラット)とサンプル)
実行済みの命令 /PC サンプルの合計数の割合として、関数に関連する実行済みの命令(トレース)や PC サンプル(サンプル)数。
- Power サンプリング(Power サンプリング)
関数に関連する Power サンプリングの数。
- エネルギー (%)(Power サンプリング)
関数に関連するすべての測定値の累計。全測定値に対するパーセントで表します。
- 平均電流 [mA](Power サンプリング)
関数に関連するすべてのサンプルの平均測定値。
- 最小電流 [mA](Power サンプリング)
関数に関連するすべてのサンプルの最小測定値。
- 最大電流 [mA](Power サンプリング)
関数に関連するすべてのサンプルの最大測定値。
コンテキストメニュー
以下のコンテキストメニューがあります。

このメニューの内容は、使用している C-SPY ドライバによって異なります。
以下のコマンドがあります。
- 有効化
プロファイラを有効にします。システムは、ウィンドウを閉じているときも情報を収集します。
- クリア
すべてのプロファイリングデータをクリアします。
- フィルタリング
プロファイルするコードの行を以下から選択します。以下から選択します:
すべてをチェック—すべての行をプロファイリングから除外します。
すべてをチェック解除—すべての行をプロファイリングに含めます。
ロード—保存したファイルから除外された行をすべて読み込みます。
保存—除外された行をすべてファイルに保存します。これは通常、エンジニアのグループが除外したセットを共有する場合に便利です。
これらのコマンドは、トレース(フラット)またはサンプリングのどちらかを使用する場合にのみ利用できます。
- ソース
プロファイリング情報に使用するソースを選択します。ソースのプロファイリングを参照してください。
使用する C-SPY ドライバによって使用可能なソースが決まります。
以下から選択します:
サンプリング—命令プロファイリングの命令カウントは、各命令のサンプル数を示します。
トレース(コール)—命令プロファイリングの命令カウントは、トレースデータ収集時の完了した数のみを示します。
トレース(フラット)—命令プロファイリングの命令カウントは、トレースデータ収集時の完了した数のみを示します。
- Power サンプリング
Power サンプリング情報の有効 / 無効を切り替えます。このコマンドは、I-jet インサーキットデバッグプローブ、J-Link、J-Trace Ultra デバッグプローブでサポートされています。
- ファイルに保存
すべてのプロファイリングデータをファイルに保存します。
- ソースを表示
エディタウィンドウを開き(まだ開いていない場合)、選択したソース行を強調表示します。