completed remote debug tutorial
authorfturovic <frank.turovich@nokia.com>
Tue, 20 Jul 2010 14:14:39 -0500
changeset 1646 7bcb3d758005
parent 1645 0083290c145a
child 1647 0b7be06a7bee
completed remote debug tutorial
core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_00.htm
core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_01.htm
core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_03.htm
core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_00.htm
core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_01.htm
core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_02.htm
core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_03.htm
core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_04.htm
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_00.htm	Tue Jul 20 13:52:51 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_00.htm	Tue Jul 20 14:14:39 2010 -0500
@@ -4,7 +4,7 @@
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
 <meta http-equiv="Content-Style-Type" content="text/css" />
 <meta name="LASTUPDATED" content="06/17/05 11:09:43" />
-<title>Creating and Debugging DLL Projects Tutorial</title>
+<title>DLL Projects Tutorial</title>
 <link rel="StyleSheet" href="../../../book.css" type="text/css"/>
 </head>
 <body bgcolor="#FFFFFF">
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_01.htm	Tue Jul 20 13:52:51 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_01.htm	Tue Jul 20 14:14:39 2010 -0500
@@ -56,7 +56,7 @@
 <strong>NEXT STEP</strong> &gt; <a href="new_proj_from_template_02.htm">Building</a> an executable based on the project sources
 <h4>Other references</h4>
 <ul>
-    <li><a href="new_proj_from_template_00.htm">Creating and Debugging New Projects Tutorial</a><a href="./"></a><a href="./"></a></li>
+    <li><a href="new_proj_from_template_00.htm">Emulator Application Projects</a><a href="./"></a><a href="./"></a></li>
 </ul>
 <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>
 
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_03.htm	Tue Jul 20 13:52:51 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_03.htm	Tue Jul 20 14:14:39 2010 -0500
@@ -57,7 +57,7 @@
 <h4>Other references</h4>
 <ul>
     
-    <li><a href="new_proj_from_template_00.htm">Creating and Debugging New Projects Tutorial</a><a href="./"></a><a href="./"></a></li>
+    <li><a href="new_proj_from_template_00.htm">Emulator Application Projects</a><a href="./"></a><a href="./"></a></li>
 </ul>
 <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>
 
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_00.htm	Tue Jul 20 13:52:51 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_00.htm	Tue Jul 20 14:14:39 2010 -0500
@@ -12,7 +12,7 @@
 <p>In this example we demonstrate how to debug applications on a remote device using the Application TRK 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>
 <ol>
     <li><a href="run_mode_debug_example_01.htm">Connect</a>  target device for PC</li>
-    <li><a href="../trk/trk_installation_instr.htm">Install </a>TRK v3.2.6 remote agent or later on the target device</li>
+    <li><a href="../trk/trk_installation_instr.htm">Install </a>TRK remote agent (v3.2.7) or later on the target device</li>
     <li><a href="run_mode_debug_example_04.htm">Configure</a> project for downloading</li>
     <li><a href="run_mode_debug_example_05.htm">Debug</a> project on target device</li>
 </ol>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_01.htm	Tue Jul 20 13:52:51 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_01.htm	Tue Jul 20 14:14:39 2010 -0500
@@ -12,7 +12,7 @@
 <p>In this example we demonstrate how to debug applications on a remote device using the Application TRK 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>
 <ol>
     <li><strong>Connect target device to PC</strong></li>
-    <li><a href="../trk/trk_installation_instr.htm">Install </a>TRK remote agent (v3.2.6) or later on the target device</li>
+    <li><a href="../trk/trk_installation_instr.htm">Install </a>TRK remote agent (v3.2.7) or later on the target device</li>
     <li><a href="run_mode_debug_example_04.htm">Configure</a> project for downloading</li>
     <li><a href="run_mode_debug_example_05.htm">Debug</a> project on target device</li>
     </ol>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_02.htm	Tue Jul 20 13:52:51 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_02.htm	Tue Jul 20 14:14:39 2010 -0500
@@ -11,7 +11,7 @@
 <p>In this example we demonstrate how to debug applications on a remote device using the Application TRK 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>
 <ol>
     <li><a href="run_mode_debug_example_01.htm">Connect</a> target device to PC</li>
-    <li><strong>Install TRK remote agent (v3.2.6) or later on the target device</strong></li>
+    <li><strong>Install TRK remote agent (v3.2.7) or later on the target device</strong></li>
     <li><a href="run_mode_debug_example_03.htm">Configure</a> project for downloading</li>
     <li><a href="run_mode_debug_example_04.htm">Debug</a> project on target device</li>
     </ol>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_03.htm	Tue Jul 20 13:52:51 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_03.htm	Tue Jul 20 14:14:39 2010 -0500
@@ -12,7 +12,7 @@
 <p>In this example we demonstrate how to debug applications on a remote device using the Application TRK 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>
 <ol>
     <li><a href="run_mode_debug_example_01.htm">Connect</a> target device to PC</li>
-    <li><a href="../trk/trk_installation_instr.htm">Install </a>TRK remote agent (v3.2.6) or later on the target device</li>
+    <li><a href="../trk/trk_installation_instr.htm">Install </a>TRK remote agent (v3.2.7) or later on the target device</li>
     <li><strong>Configure project for downloading</strong></li>
     <li><a href="run_mode_debug_example_05.htm">Debug</a> project on target device</li>
     </ol>
--- a/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_04.htm	Tue Jul 20 13:52:51 2010 -0500
+++ b/core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_04.htm	Tue Jul 20 14:14:39 2010 -0500
@@ -12,13 +12,33 @@
 <p>In this example we demonstrate how to debug applications on a remote device using the Application TRK 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>
 <ol>
     <li><a href="run_mode_debug_example_01.htm">Connect</a> target device to PC</li>
-    <li><a href="../trk/trk_installation_instr.htm">Install</a> TRK remote agent (v3.2.7) or later on the target device</li>
-    <li><a href="run_mode_debug_example_04.htm">Configure</a> project for downloading</li>
+    <li><a href="run_mode_debug_example_02.htm">Install</a> TRK remote agent (v3.2.7) or later on the target device</li>
+    <li><a href="run_mode_debug_example_03.htm">Configure</a> project for downloading</li>
     <li><strong>Debug project on target device</strong></li>
 </ol>
 <hr>
-<p>&nbsp;</p>
-<p>&nbsp;</p>
+<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 TRK 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>
+<div class="step">
+    <h4>Debugging a program on a remote device</h4>
+    <ol>
+        <li>Set breakpoints in the program.
+        	<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>
+        </li>
+        <li>Click the Debug icon (<img src="../images/icon_debug.png" alt="Debug icon" width="17" height="17" align="absmiddle">) to launch the program for debugging on the target device.
+        	<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>
+        </li>
+        <li>Use the Carbide debugger to examine program internals and control its execution.
+        	<p>Use any of the following features to debug your program:</p>
+            <ul>
+                <li>Use the various <a href="../../debugger/debug/debug.htm">stepping</a> commands to walk through the program.</li>
+                <li>Examine and change variables and expressions in the <a href="../../debugger/variables/variables.htm">Variables</a> view.</li>
+                <li>Examine the stack in the <a href="../../debugger/debug/viewing_debug.htm">Debug</a> view</li>
+                <li>Review the assembler code in the <a href="../../reference/view_disassembly.htm">Disassembly</a> view</li>
+                <li>Examine memory usage in the <a href="../../reference/view_memory_wnd.htm">Memory</a> view</li>
+            </ul>
+        </li>
+        </ol>
+</div>
 <h4>Other references</h4>
 <ul>
     <li><a href="run_mode_debug_example_00.htm">Remote Target Debugging (Run-mode)</a></li>