2 <html> |
2 <html> |
3 <head> |
3 <head> |
4 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> |
4 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> |
5 <meta http-equiv="Content-Style-Type" content="text/css" /> |
5 <meta http-equiv="Content-Style-Type" content="text/css" /> |
6 <meta name="LASTUPDATED" content="06/17/05 11:09:43" /> |
6 <meta name="LASTUPDATED" content="06/17/05 11:09:43" /> |
7 <title>TRK On-device Debugging</title> |
7 <title>Carbide On-device Debug Agent</title> |
8 <link rel="StyleSheet" href="../../book.css" type="text/css"/> |
8 <link rel="StyleSheet" href="../../book.css" type="text/css"/> |
9 </head> |
9 </head> |
10 <body > |
10 <body > |
11 <h2>TRK On-device Debugging</h2> |
11 <h2>Carbide On-device Debug Agent</h2> |
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> |
12 <p>The <b>Carbide On-device Debug Agen</b>t (CODA) 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. The CODA provides: </p> |
13 <ul> |
13 <ul> |
14 <li>Debug agent running on Symbian OS</li> |
14 <li>Debug agent running on Symbian OS</li> |
15 <li>Provides a stable & integrated interface to Symbian OS</li> |
15 <li>Provides a stable & integrated interface to Symbian OS</li> |
16 <li>Used to debug applications on actual devices</li> |
16 <li>Used to debug applications on actual devices</li> |
17 <li>Can be built-in to the OS image or installed as a .sis file</li> |
17 <li>Can be built-in to the OS image or installed as a .sis file</li> |
18 </ul> |
18 </ul> |
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> |
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> |
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 > New Connection Wizard > Install remote agents</a> pane.</p> |
20 <p>The Application CODA is stored online and available for download and installation using the <a href="../reference/trk/wnd_new_connection_wizard.htm">On-Device Connections > New Connection Wizard > Install remote agents</a> pane.</p> |
21 <p>Some of the key benefits to using an on-device debug agent include:</p> |
21 <p>Some of the key benefits to using an on-device debug agent include:</p> |
22 <ul> |
22 <ul> |
23 <li>Easy debugging via serial interface (Bluetooth, USB, IrDA, etc)</li> |
23 <li>Easy debugging via serial interface (Bluetooth, USB, IrDA, etc)</li> |
24 <li>More accurate than emulator debugging</li> |
24 <li>More accurate than emulator debugging</li> |
25 <li>Can often avoid using expensive hardware debuggers </li> |
25 <li>Can often avoid using expensive hardware debuggers </li> |
26 </ul> |
26 </ul> |
27 <p>There are two variations of the on-device debug agent, they are:</p> |
27 <p>There are two variations of the on-device debug agent, they are:</p> |
28 <ul> |
28 <ul> |
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> |
29 <li><b>Application CODA</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> |
30 <li><b>System TRK</b>— |
30 <li><b>System CODA</b>— |
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> |
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> |
32 </ul> |
32 </ul> |
33 <h5>Related tasks</h5> |
33 <h5>Related tasks</h5> |
34 <ul> |
34 <ul> |
35 <li><a href="../tasks/trk/trk_overview.htm">On-device Debugging Overview</a> </li> |
35 <li><a href="../tasks/trk/trk_overview.htm">On-device Debugging Overview</a> </li> |