core/com.nokia.carbide.cpp.doc.user/html/concepts/trk.htm
author fturovic <frank.turovich@nokia.com>
Fri, 06 Aug 2010 14:28:38 -0500
changeset 1791 727385d8e2b3
parent 1777 490bb9a68e6b
child 2009 b622387629d6
permissions -rw-r--r--
added new customize carbide section and some relinking done for deleted duplicate page
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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" />
1777
490bb9a68e6b draft of sbsv2 concept and related index, trk, and TOC changes
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
     7
<title>TRK On-device Debugging</title>
1376
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>
1791
727385d8e2b3 added new customize carbide section and some relinking done for deleted duplicate page
fturovic <frank.turovich@nokia.com>
parents: 1777
diff changeset
    10
<body >
1777
490bb9a68e6b draft of sbsv2 concept and related index, trk, and TOC changes
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    11
<h2>TRK On-device Debugging</h2>
490bb9a68e6b draft of sbsv2 concept and related index, trk, and TOC changes
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    12
<p>The on-device TRK remote 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>
1376
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 &amp; 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>
1777
490bb9a68e6b draft of sbsv2 concept and related index, trk, and TOC changes
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    19
<p>Using the on-device remote 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 Nokia Qt SDK, Symbian^3, and Symbian TechView devkits.</p>
490bb9a68e6b draft of sbsv2 concept and related index, trk, and TOC changes
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    20
<p>The Application TRK remote agents are stored online and can be downloaded and installed using the <a href="../reference/trk/wnd_new_connection_wizard.htm">On-Device Connections &gt; New Connection Wizard &gt; Install remote agents</a> pane.</p>
1376
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>&#8212;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>&#8212;
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
<h5>Related tasks</h5>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    34
<ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    35
  <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
    36
</ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    37
<div class="step">
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    38
  <div id="footer">Copyright &copy; 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
    39
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    40
</div>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    41
</body>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    42
</html>