ARM Profiler User Guide

Chapter 1 Introduction

1.1 About the ARM Profiler ............................................................................... 1-2
1.2 Availability and compatibility ....................................................................... 1-3
1.3 Installation ................................................................................................... 1-4
1.4 Licensing ..................................................................................................... 1-5
1.5 Getting help ................................................................................................. 1-6

Chapter 2 Getting Started with the ARM Profiler

2.1 How to use this tutorial ................................................................................ 2-2
2.2 Opening the ARM Workbench .................................................................... 2-3
2.3 Importing the xvid example ......................................................................... 2-5
2.4 Re-building the project ................................................................................ 2-9
2.5 Profiling using a Real-Time System Model ............................................... 2-10
2.6 Stopping the execution using the live update view ................................... 2-11
2.7 Examining the new analysis file ................................................................ 2-12

Chapter 3 Data Collection Using RealView Trace 2

3.1 Required items ............................................................................................ 3-2

3.2 Opening hardware preferences within the ARM Workbench ...................... 3-3
3.3 Setting the connection options ................................................................... 3-4
3.4 Setting the image options ......................................................................... 3-10
3.5 Setting profiling options ............................................................................ 3-12
3.6 Exporting a launch script .......................................................................... 3-16
3.7 Executing the run configuration ................................................................ 3-17
3.8 Hardware profiling restrictions .................................................................. 3-18
3.9 Hardware profiling execution speed ......................................................... 3-19

Chapter 4 Data Collection Using a Real-Time System Model

4.1 Overview ..................................................................................................... 4-2
4.2 Using the ARM compilation tools in the ARM Workbench .......................... 4-3
4.3 Creating a profiling-enabled RTSM run configuration ................................ 4-4
4.4 Setting the connection options ................................................................... 4-5
4.5 Setting the image options ........................................................................... 4-7
4.6 Setting the profiling options ........................................................................ 4-8
4.7 Running the configuration ......................................................................... 4-10
4.8 Enabling profiling outside of the ARM Workbench ................................... 4-11

Chapter 5 The Analysis Summary

5.1 Analysis summary overview ....................................................................... 5-2
5.2 Opening an analysis summary ................................................................... 5-3
5.3 Analysis summary elements ....................................................................... 5-4
5.4 Live update ............................................................................................... 5-13

Chapter 6 The Table Reports: Functions, Files, Classes, and Call Chains

6.1 Table report basics ..................................................................................... 6-2
6.2 Navigating to other reports ....................................................................... 6-13
6.3 The functions report .................................................................................. 6-17
6.4 The classes report .................................................................................... 6-18
6.5 The files report .......................................................................................... 6-19
6.6 The call chains report ............................................................................... 6-20

Chapter 7 The Code and Replay Views

7.1 Overview ..................................................................................................... 7-2
7.2 Navigating to the code view ........................................................................ 7-3
7.3 Basic code view functionality ...................................................................... 7-5
7.4 The source panel ........................................................................................ 7-7
7.5 The disassembly panel ............................................................................. 7-11
7.6 The replay view ........................................................................................ 7-15

Chapter 8 The Call Graph

8.1 Overview ..................................................................................................... 8-2
8.2 Opening a call graph .................................................................................. 8-3
8.3 Call graph layout ......................................................................................... 8-4
8.4 The mini-map .............................................................................................. 8-6

8.5 Color coding ................................................................................................ 8-7
8.6 Selection behavior ...................................................................................... 8-8
8.7 Contextual menu options ............................................................................ 8-9
8.8 The toolbar ................................................................................................ 8-12
8.9 The outline view ........................................................................................ 8-14

Chapter 9 The Call Summary

9.1 Call summary breakdown ............................................................................ 9-2
9.2 Function box statistics ................................................................................. 9-3
9.3 Filtering instances ....................................................................................... 9-6
9.4 Call summary navigation ............................................................................. 9-8
9.5 Navigating to other report types .................................................................. 9-9

Chapter 10 Merging Analysis Files

10.1 Reasons to merge analysis files ............................................................... 10-2
10.2 Analysis file compatibility .......................................................................... 10-3
10.3 How to merge analysis files ...................................................................... 10-4

Chapter 11 Preferences

11.1 Accessing the ARM Profiler color preferences .......................................... 11-2
11.2 Color preference descriptions ................................................................... 11-3

Chapter 12 Profiling Applications Running on the Symbian OS

12.1 Building the ARM Profiler Symbian OS kernel extension .......................... 12-2
12.2 Building Symbian OS applications ............................................................ 12-4
12.3 Profiling your Symbian OS application ...................................................... 12-5

Chapter 13 Profiling Applications Running on Linux OS

13.1 Installing and patching the Linux kernel extension .................................... 13-2

13.2 Profiling your Linux application ................................................................. 13-4

Appendix A Using the Command Line

A.1 Configuring your system for running the ARM Profiler on the command line ...A-2
A.2 Command line options ................................................................................ A-3

Appendix B Keyboard shortcuts

B.1 Table report keyboard shortcuts ................................................................ B-2
B.2 Code view keyboard shortcuts ................................................................... B-3
B.3 Call graph keyboard shortcuts ................................................................... B-5
B.4 Call summary keyboard shortcuts .............................................................. B-6

Appendix C Troubleshooting guide

C.1 Troubleshooting steps ............................................................................... C-2