author | fturovic <frank.turovich@nokia.com> |
Thu, 20 May 2010 10:32:00 -0500 | |
changeset 1376 | 120480c02651 |
parent 0 | fb279309251b |
child 1777 | 490bb9a68e6b |
permissions | -rw-r--r-- |
1376
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
2 |
<html> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
3 |
<head> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
4 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
5 |
<meta http-equiv="Content-Style-Type" content="text/css" /> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
6 |
<meta name="LASTUPDATED" content="06/17/05 11:09:43" /> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
7 |
<title>On-device Debugging</title> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
8 |
<link rel="StyleSheet" href="../../book.css" type="text/css"/> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
9 |
</head> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
10 |
<body bgcolor="#FFFFFF"> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
11 |
<h2>On-device Debugging</h2> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
12 |
<p>The on-device debug agent (Application TRK or System TRK) is a program that enables on-device debugging of phone prototypes, reference boards, and retail phones. An on-device debug agent is a program that is installed on a phone or reference board. It communicates with the debugger using a serial-over-Bluetooth or serial-over-USB connection. Through this serial communication, the on-device debug agent acts as the interface between the Carbide.c++ debugger and the target device. An on-device debug agent provides: </p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
13 |
<ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
14 |
<li>Debug agent running on Symbian OS</li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
15 |
<li>Provides a stable & integrated interface to Symbian OS</li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
16 |
<li>Used to debug applications on actual devices</li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
17 |
<li>Can be built-in to the OS image or installed as a .sis file</li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
18 |
</ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
19 |
<p>Using the on-device debug agent, one can use the Carbide.c++ IDE to debug programs running on phone hardware, making the debugging process much easier. The on-device debug agent works on all S60 3rd Edition devices, UIQ 3rd Edition devices, and Symbian TechView devkits.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
20 |
<p>The Application TRK debug agents are stored online and can be downloaded and installed using the <a href="../reference/trk/wnd_new_connection_wizard.htm">On-Device Connections > New Connection Wizard > Install remote agents</a> pane.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
21 |
<p>Some of the key benefits to using an on-device debug agent include:</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
22 |
<ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
23 |
<li>Easy debugging via serial interface (Bluetooth, USB, IrDA, etc)</li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
24 |
<li>More accurate than emulator debugging</li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
25 |
<li>Can often avoid using expensive hardware debuggers </li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
26 |
</ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
27 |
<p>There are two variations of the on-device debug agent, they are:</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
28 |
<ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
29 |
<li><b>Application TRK</b>—supports application debugging only and available to developers creating applications for devices. Developers do not have access to system level routines, system ROM, other user application code, cannot modify the LR and SR registers, and must use a SIS file to debug an application.</li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
30 |
<li><b>System TRK</b>— |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
31 |
supports both application and limited ROM debugging (includes application executables and limited ROM based components (i.e. no device drivers) and available to original equipment manufacturers (OEM) for device creation and customization</li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
32 |
</ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
33 |
<p class="note"><b>NOTE</b> The type of on-device debug agent you have is based upon which Carbide.c++ product you have licensed. System TRK is only available with the Professional or OEM version of the product. </p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
34 |
<h5>Related tasks</h5> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
35 |
<ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
36 |
<li><a href="../tasks/trk/trk_overview.htm">On-device Debugging Overview</a> </li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
37 |
</ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
38 |
<div class="step"> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
39 |
<div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
40 |
|
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
41 |
</div> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
42 |
</body> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
43 |
</html> |