Chapter 1. Introduction

1.1 About RealView Profiler
1.2 Availability and compatibility
1.3 RealView Profiler installation
Windows installation
Linux installation
1.4 Licensing RealView Profiler
1.5 RealView Profiler documentation
1.5.1 Additional resources
1.5.2 Contextual help

This chapter introduces RealView Profiler, discusses compatibility, and describes each of the primary components.

1.1 About RealView Profiler

RealView Profiler enables you to see how your code performs on a target system, either by observing your code on actual target hardware using RealView ICE and RealView Trace 2 or by testing code against an ARM Real Time System Model (RTSM). Whichever method works best for you, you will be getting accurate profiling data quickly that will help you pinpoint performance bottlenecks. Once RealView Profiler has finished observing your code in action, it will produce an analysis file that provides fine grain feedback broken down by function and instruction.

Specifically, RealView Profiler makes it possible for you to streamline your source code and design in three ways:

1.2 Availability and compatibility

In order to use all of the features of RealView Profiler, you will need to have the Eclipse Integrated Development Environment (IDE) installed. The current version of RealView Profiler supports Eclipse version 3.2.

Every feature of the toolset is integrated into Eclipse. You will use RealView Profiler's customized perspectives and views within the Eclipse Integrated Development Environment (IDE) to set up hardware preferences, run simulations to produce profile reports and analyze the data all without leaving Eclipse. RealView Profiler works where you already work.

Currently, RealView Profiler works on the following systems:

Although RealView Profiler runs on Linux, RealView Trace 2 does not have the drivers to support it, so profiling using an RTSM is your only option for generating analysis reports on this platform. Hardware profiling is not available on Linux at this time.

1.3 RealView Profiler installation

Windows installation

To install the com.arm.rvp Eclipse plug-in on Windows, run the setup.exe file located on the installation cd and follow the on screen instructions.

Linux installation

To install the com.arm.rvp Eclipse plug-in on Linux, run the setuplinux.bin file located on the installation cd and follow the on screen instructions.

The installer generates a script file that sets up the environment variables for RealView Profiler, install_directory/RVP10env.posh. Use the source command with the appropriate shell script to add the new environment to the current shell. You can also generate these shell script files using the armenv tool. See the RealView Development Suite Getting Started Guide for more details.

After you have run setuplinux.bin and added all of the new environment variables using RVP10env.posh, you will need to log out and log back in to complete the installation process.

1.4 Licensing RealView Profiler

Like the rest of the RealView Development Suite (RVDS), the ARM FLEXlm licensing system handles the licensing for RealView Profiler. For more information regarding ARM FLEXlm licensing, reference ARM DUI 0209, the ARM FLEXlm License Management Guide v4.0.

1.5 RealView Profiler documentation

This manual serves as both a how-to and a reference, providing detailed information on the wealth of data provided by RealView Profiler. It is intended to get you started with RealView Profiler and answer any questions that arise as you become more familiar with its applications and will remain a handy resource when you have questions down the line.

1.5.1 Additional resources

An html version of this document is installed on your computer with the Eclipse plug-in. The install directory also includes a 'readme.html' file, which contains late-breaking information about this release of RealView Profiler.

You can access documentation by selecting Start > All Programs > ARM > RealView Profiler v1.0 > Documentation or by choosing Help > Help Contents from within Eclipse.

In addition to documentation, the RealView Profiler plug-in directory also includes an 'Examples' subdirectory, which contains the doom source code example that you can examine and execute to familiarize yourself with RealView Profiler. You can access the examples directory by choosing Start > All Programs > ARM > RealView Profiler v1.0 > Examples if you installed to the default directory.

To successfully compile and run this example, you will need to obtain the shareware doom WAD file. It can be downloaded from:

ftp://ftp.idsoftware.com/idstuff/doom/doom-1.8.wad.gz

Rename the 'doom-1.8.wad' file to 'doom1.wad' and place it in the same directory as the makefile, replacing the 'doom1.wad' placeholder file that is already there.

Alternatively, you can download a freeware version from here:

http://sep800.mine.nu/files/games/Freeware/Edoom1.wad

Rename the 'Edoom1.wad' file to 'doom1.wad' and place it in the same directory as the makefile, replacing the 'doom1.wad' placeholder file that is already there.

1.5.2 Contextual help

RealView Profiler also provides contextual help for each of its various report types and configuration windows. Pressing F1 in Windows, Shift + F1 in Linux or hitting the help icon that appears in the toolbar will open the help view with a list of topics that relate to the currently open report type or run configuration panel.

Clicking on any of these links will open the corresponding help topic within the help view, so you can browse help topics without leaving your Eclipse workspace.

Copyright © 2007 ARM Limited. All rights reserved. ARM DUI 0412A