author | Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com> |
Wed, 23 Jun 2010 15:05:09 +0300 | |
changeset 12 | ae255c9aa552 |
parent 5 | 844b047e260d |
permissions | -rw-r--r-- |
12
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
2 |
<html> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
3 |
<head> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
4 |
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1"> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
5 |
<title>Using the Profiler</title> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
6 |
<link href="../../../book.css" rel="stylesheet" type="text/css"> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
7 |
<style type="text/css"> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
8 |
<!-- |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
9 |
.style1 {font-family: "Courier New", Courier, mono} |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
10 |
--> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
11 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
12 |
</style> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
13 |
</head> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
14 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
15 |
<body> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
16 |
<h2>Using the Profiler</h2> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
17 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
18 |
<h4>Overview</h4> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
19 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
20 |
<p>After successfully <a |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
21 |
href="../../tasks/profiler/prof_installation.htm">installing</a> the Profiler |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
22 |
.SISX file on your target device, you will be able to access the user |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
23 |
interface. Run the <b>CarbidePI</b> application located in the |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
24 |
“Installed” applications (Figure 1).</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
25 |
<p align="center"><img src="../profiler/images/SamplingProfilerMainWindow.png" ></p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
26 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
27 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
28 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
29 |
<p align="center" class="figure">Figure 1 - Profiler Main Window (S60) </p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
30 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
31 |
<p>In Options, configure the necessary run-time options. Specify which traces |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
32 |
you want enabled, where to place the generated .dat profiler data file, the |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
33 |
profiler file prefix, and the trace priority sampling interval.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
34 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
35 |
<p>In the Profiler, the Address/Thread trace is <strong>always</strong> active |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
36 |
when profiling is performed. Other traces are synchronized with the |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
37 |
Address/Thread trace.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
38 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
39 |
<p>In addition to Address/Thread trace, you can enable additional trace options |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
40 |
such as dynamic binary support, memory and power usage, and function calls.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
41 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
42 |
<div class="step"> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
43 |
<h4>Profiling an Application</h4> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
44 |
<ol> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
45 |
<li>Open the Profiler options screen |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
46 |
<p>Select the Tracing options menu from the Profiler menu (Figure 2) </p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
47 |
<p align="center"><img src="images/TracingOptions.png"></p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
48 |
</li> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
49 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
50 |
<p class="figure">Figure 2 - Tracing Options</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
51 |
<li>Enable or disable trace options</li> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
52 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
53 |
<p>Specify On or Off for the available trace items - Dynamic binary support, |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
54 |
Function call capture, and Thread priority capture. (Figure 3).</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
55 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
56 |
<blockquote> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
57 |
<p align="left" class="note"><b>NOTE</b> If the executables you wish to |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
58 |
analyze are not in a ROM image (.symbol file) of your target device, then |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
59 |
you will need to turn on Dynamic binary support.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
60 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
61 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
62 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
63 |
<p align="center"><img src="../profiler/images/TracingOptionsList.png" ></p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
64 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
65 |
<p align="center"><img src="../profiler/images/TracingOptionsList2.png" ></p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
66 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
67 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
68 |
<p align="center" class="figure">Figure 3 - List of Trace Items</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
69 |
<li>Specify Output</li> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
70 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
71 |
<p>Specify the output for the sampled data (Figure 4). The output method can |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
72 |
be either the <span class="style1">File system</span> or <span |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
73 |
class="style1">Debug port</span>. If you select File system, you can save the |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
74 |
data file to a memory card or the target device C:\ drive. With the debug |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
75 |
port output method, you will need hardware (such as the Nokia Musti box) |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
76 |
connected to the XTI/STI debug port to capture the profiler data. There is |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
77 |
less profiler overhead if the debug port is used.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
78 |
<p align="center"> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
79 |
<img src="../profiler/images/OutputOptionsWindow_FileSystem.png" |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
80 |
></p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
81 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
82 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
83 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
84 |
<p align="center" class="figure">Figure 4 - Output Options</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
85 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
86 |
<p>You can specify the file prefix for data files. The name of the profiler |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
87 |
data file is formed from the prefix plus stream.dat. If you perform multiple |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
88 |
traces and use the file output option, include a hash mark (#) in your file |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
89 |
prefix. Subsequent traces will then be saved with different file names. The |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
90 |
hash mark is automatically replaced with a number. For example, if you define |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
91 |
the file prefix as <span class="style1">PI_#_</span>, multiple trace files |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
92 |
will be named <span class="style1">PI_1_STREAM.dat, PI_2_STREAM.dat, … |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
93 |
PI_100_STREAM.dat</span>. Only one hash mark is needed to provide sequential |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
94 |
numbering. If no hash mark is present, the same file will be overwritten with |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
95 |
the same name.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
96 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
97 |
<p class="note"><strong>NOTE</strong> Currently, files names should be 19 |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
98 |
characters or less.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
99 |
<li>Specify Advanced Options</li> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
100 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
101 |
<p>In Advanced options, specify the thread priority sample interval (Figure |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
102 |
5). The operating system is called automatically every millisecond to |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
103 |
determine what thread is currently executing. This interval setting indicates |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
104 |
how often an additional query to the operating system is made to determine |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
105 |
the priority of the currently executing thread. The interval is specified in |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
106 |
milliseconds. The default is 3000 milliseconds (3 seconds). You can get a |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
107 |
thread priority as often as you like but be aware that frequent sampling of |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
108 |
the OS may skew the performance measurement while making the call. There is a |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
109 |
significant overhead to obtaining the priorities of all threads.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
110 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
111 |
<p>You can choose an address/thread sampling interval between 1ms and 10000ms |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
112 |
(10 seconds). For intervals greater than 1 ms, memory, power, priority and |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
113 |
button events are sampled periodically; not every millisecond. Memory and |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
114 |
button events are individual events. For memory and priority the current |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
115 |
memory size and priority are recorded before entering the time interval, then |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
116 |
changes during the interval are recorded and the final memory size and |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
117 |
priority when it exits the interval is recorded.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
118 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
119 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
120 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
121 |
<p align="center"> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
122 |
<img src="../profiler/images/AdvancedOptionsEditBox.png" |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
123 |
></p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
124 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
125 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
126 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
127 |
<p align="center" class="figure">Figure 5 - Priority sample interval</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
128 |
<li>Profile your application</li> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
129 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
130 |
<p>After establishing your desired options, select <strong>Options > |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
131 |
Profiler > Start</strong> from the main window (Figure 6) to begin |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
132 |
sampling.The state will change from "Initializing" to "Sampling" and then |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
133 |
"Finished". When the state has changed to “Profiling” or |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
134 |
"Sampling", the trace activity has begun. Note that none of the |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
135 |
configurations can be changed when the tracing is active.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
136 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
137 |
<p class="note"><b>IMPORTANT!</b> After the trace activity has started, leave |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
138 |
the Profiler running in the background. Now you can proceed with the use case |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
139 |
you wish to analyze. For example, run your application on the device.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
140 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
141 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
142 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
143 |
<p align="center"> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
144 |
<img src="images/profiler_start_profiler.png" |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
145 |
></p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
146 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
147 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
148 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
149 |
<p align="center" class="figure">Figure 6 - Starting a trace session </p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
150 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
151 |
<p>Stop the trace activity by switching back to the profiler and selecting |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
152 |
<strong>Options > Profiler > Stop</strong>. Do not use the profiler |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
153 |
while the trace data is being written to the data file. When the profiler is |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
154 |
stopped, the profiler state shown in the main window will change from |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
155 |
“profiling” to “stopping profiler”, and finally back |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
156 |
to “ready”. The profiler data file is automatically written to |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
157 |
the output previously selected. The actual amount of produced data depends on |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
158 |
the length of time tracing was active and which trace options were selected. |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
159 |
The Address/Thread trace alone produces approximately 1-4 Kbytes / second. |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
160 |
Transfer the data file to your workstation to be analyzed with the |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
161 |
analyzer.</p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
162 |
</ol> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
163 |
</div> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
164 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
165 |
<p><strong>Related references </strong></p> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
166 |
<ul> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
167 |
<li><a href="../../tasks/profiler/prof_installation.htm">Installing the |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
168 |
Profiler on the Target Device</a></li> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
169 |
<li><a href="../../tasks/analyser/an_load_trace_files.htm">Importing Profiler |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
170 |
Data File for Analysis </a></li> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
171 |
</ul> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
172 |
|
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
173 |
<div id="footer"> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
174 |
Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
175 |
reserved. <br> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
176 |
License: <a |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
177 |
href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
178 |
</body> |
ae255c9aa552
Performance Investigator Carbide extension 2.4.0
Toni Pulkkinen <ext-toni.p.pulkkinen@nokia.com>
parents:
5
diff
changeset
|
179 |
</html> |