core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_04.htm
author fturovic <frank.turovich@nokia.com>
Tue, 21 Sep 2010 15:50:51 -0500
changeset 2087 617a89f9dffc
parent 2009 b622387629d6
child 2131 ff0156b93599
permissions -rw-r--r--
BUG 12110 - text instances of apptrk/systrk changed, more images yet to update
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     2
<html>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     3
<head>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     7
<title>Debug project on target device Tutorial</title>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     8
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
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: 1658
diff changeset
    10
<body >
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    11
<h2>Debug project on target device</h2>
2087
617a89f9dffc BUG 12110 - text instances of apptrk/systrk changed, more images yet to update
fturovic <frank.turovich@nokia.com>
parents: 2009
diff changeset
    12
<p>In this example we demonstrate how to debug applications on a remote device using the Symbian OS Device (Install SIS) remote debug agent. This enables you to test  programs on the actual device it will operate on while observing its behavior using the Carbide debugger. The steps to do this include:</p>
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    13
<ol>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    14
    <li><a href="run_mode_debug_example_01.htm">Connect</a> target device to PC</li>
2009
b622387629d6 changed TRK to CODA in docs except where it related to pre-3.0 versions
fturovic <frank.turovich@nokia.com>
parents: 1934
diff changeset
    15
    <li><a href="run_mode_debug_example_02.htm">Install</a> CODA remote agent (v3.2.7) or later on the target device</li>
1646
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    16
    <li><a href="run_mode_debug_example_03.htm">Configure</a> project for downloading</li>
1645
0083290c145a minor edits to sync titles across tutorials
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    17
    <li><strong>Debug project on target device</strong></li>
0083290c145a minor edits to sync titles across tutorials
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    18
</ol>
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    19
<hr>
2009
b622387629d6 changed TRK to CODA in docs except where it related to pre-3.0 versions
fturovic <frank.turovich@nokia.com>
parents: 1934
diff changeset
    20
<p>You debug on a remote device using the exact same methods used for the emulator. Once the project is built and downloaded to the target device, the CODA remote agent then takes control. Then, using the Carbide debugger you can use all the debugger features to exercise the program on the device while monitoring its vitals in the <a href="../../reference/perspective_debug.htm">Debug</a> perspective.</p>
1646
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    21
<div class="step">
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    22
    <h4>Debugging a program on a remote device</h4>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    23
    <ol>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    24
        <li>Set breakpoints in the program.
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    25
        	<p><a href="../../debugger/breakpoints/toggling_breakpoints.htm">Set breakpoints</a> at the critical points in the program where you want to stop execution.</p>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    26
        </li>
1934
4f0cd256d26c BUG 11531 - fixed reported issues from Rooney and Stephen for SDK section
fturovic <frank.turovich@nokia.com>
parents: 1933
diff changeset
    27
        <li>Click the Debug icon (<img src="../../reference/pref_carb_symbian_sdk.htm" alt="Debug icon" width="17" height="17" align="absmiddle">) to launch the program for debugging on the target device.
1646
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    28
        	<p>Follow the steps in <a href="run_mode_debug_example_03.htm">Configure project for downloading</a> to build and launch the program for debugging.</p>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    29
        </li>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    30
        <li>Use the Carbide debugger to examine program internals and control its execution.
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    31
        	<p>Use any of the following features to debug your program:</p>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    32
            <ul>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    33
                <li>Use the various <a href="../../debugger/debug/debug.htm">stepping</a> commands to walk through the program.</li>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    34
                <li>Examine and change variables and expressions in the <a href="../../debugger/variables/variables.htm">Variables</a> view.</li>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    35
                <li>Examine the stack in the <a href="../../debugger/debug/viewing_debug.htm">Debug</a> view</li>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    36
                <li>Review the assembler code in the <a href="../../reference/view_disassembly.htm">Disassembly</a> view</li>
1658
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1646
diff changeset
    37
                <li>Examine memory usage in the <a href="../../reference/view_memory.htm">Memory</a> view</li>
1646
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    38
            </ul>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    39
        </li>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    40
        </ol>
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    41
</div>
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    42
<h4>Other references</h4>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    43
<ul>
1645
0083290c145a minor edits to sync titles across tutorials
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    44
    <li><a href="run_mode_debug_example_00.htm">Remote Target Debugging (Run-mode)</a></li>
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    45
</ul>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    46
<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>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    47
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    48
</body>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    49
</html>