core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_03.htm
author fturovic <frank.turovich@nokia.com>
Wed, 15 Sep 2010 09:40:16 -0500
changeset 2009 b622387629d6
parent 1934 4f0cd256d26c
child 2087 617a89f9dffc
permissions -rw-r--r--
changed TRK to CODA in docs except where it related to pre-3.0 versions
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>Configure project for debugging 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: 1646
diff changeset
    10
<body >
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    11
<h2>Configure project for debugging</h2>
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
    12
<p>In this example we demonstrate how to debug applications on a remote device using the Application CODA 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="../trk/trk_installation_instr.htm">Install </a>CODA remote agent (v3.2.7) or later on the target device</li>
1645
0083290c145a minor edits to sync titles across tutorials
fturovic <frank.turovich@nokia.com>
parents: 1642
diff changeset
    16
    <li><strong>Configure project for downloading</strong></li>
1934
4f0cd256d26c BUG 11531 - fixed reported issues from Rooney and Stephen for SDK section
fturovic <frank.turovich@nokia.com>
parents: 1933
diff changeset
    17
    <li><a href="../../tasks/projects/prj_build.htm">Debug</a> project on target device</li>
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    18
    </ol>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    19
<hr>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    20
<p>&nbsp;</p>
1642
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    21
<div class="step">
1645
0083290c145a minor edits to sync titles across tutorials
fturovic <frank.turovich@nokia.com>
parents: 1642
diff changeset
    22
    <h4><strong>Configure project for downloading</strong></h4>
1642
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    23
    <ol>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    24
        <li>Select a configuration to debug the HelloWorld application on the target device.
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    25
    		<p>We choose <strong>Phone Debug (armv5_udeb)</strong> for this example using the <strong>Manage Configurations</strong> icon on the toolbar, but yours name may differ based upon the SDK  selected for your project.</p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    26
            <p><img src="../images/debugging_project_07.png" alt="Select device target"></p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    27
        </li>
1934
4f0cd256d26c BUG 11531 - fixed reported issues from Rooney and Stephen for SDK section
fturovic <frank.turovich@nokia.com>
parents: 1933
diff changeset
    28
        <li>Click the Debug icon (<img src="../../reference/pref_carb_symbian_sdk.htm" alt="Debug icon" width="17" height="17" align="absmiddle">) on the toolbar.
1642
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    29
    		<p>This opens the <strong>New Launch Configuration Wizard</strong> dialog asking for additional information. For the first launch you must define the name of the package to install on the target device.</p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    30
            <p><img src="../images/debugging_project_08.png" alt="New Launch Configuration Wizard" width="538" height="434"></p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    31
            <ol type="a">
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    32
                <li>Click the Change... button in the Debug Process section to open the Change Debug Process dialog.
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    33
                	<p><img src="../images/debugging_project_09.png" alt="New Launch Configuration Wizard" width="621" height="410"></p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    34
                </li>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    35
                <li>Enable the 'Launch program on device' option and select the executable to launch.
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
    36
                	<p>This tells the CODA remote agent which application to launch once its downloaded.</p>
1642
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    37
                </li>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    38
                <li>Click the 'Modify SIS builder settings for build configuration' to open the Properties for <em>project</em> dialog.</li>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    39
                	<p>The <strong>Carbide.c++ &gt; Build Configurations &gt; SIS Builder</strong> tab is shown.</p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    40
                	<p><img src="../images/debugging_project_11.png" alt="SIS Builder tab" width="606" height="297"></p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    41
                <li>Click Add to open the SIS Properties dialog.
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    42
                	<p><img src="../images/debugging_project_10.png" alt="SIS Properties dialog"></p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    43
                </li>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    44
                <li>Select the project's PKG file to download to the device, then click OK.
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    45
                	<p><img src="../images/debugging_project_12.png" alt="SIS Builder tab" width="607" height="292"></p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    46
                </li>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    47
                <li>Verify the PKG in the SIS Builder tab, then click OK.</li>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    48
            </ol>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    49
            <li>Verify the settings in the Change Debug Process, then click OK.
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    50
            	<p><img src="../images/debugging_project_13.png" alt="SIS Builder tab" width="557" height="410"></p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    51
            </li>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    52
        <li>Review the Configure launch configuration setup, then click Debug.
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    53
            <p><img src="../images/debugging_project_14.png" alt="SIS Builder tab" width="516" height="434"></p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    54
            <p>The project is built, downloaded to the target device, and the executable launched on the device.</p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    55
        </li>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    56
    </ol>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    57
    <p>On subsequent launches the project will be compiled and downloaded to the target device without any setup on your part. The only time you should need to perform these actions is if you change anything that effects to launch configuration. Of course, you can always modify the settings by using the <strong>New</strong> or <strong>Debug</strong> window to edit launch configurations.</p>
44a3965e21f2 added new page to debug on device tutorial with new images
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    58
</div>
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    59
<p><strong>NEXT:</strong> <a href="run_mode_debug_example_04.htm">Debug project on target device</a></p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    60
<h4>Other references</h4>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    61
<ul>
1645
0083290c145a minor edits to sync titles across tutorials
fturovic <frank.turovich@nokia.com>
parents: 1642
diff changeset
    62
    <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
    63
</ul>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    64
<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
    65
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    66
</body>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    67
</html>