core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/run_mode_debug_example_02.htm
author fturovic <frank.turovich@nokia.com>
Fri, 06 Aug 2010 14:28:38 -0500
changeset 1791 727385d8e2b3
parent 1646 7bcb3d758005
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:
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>Install TRK remote agent 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"/></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
     9
<body >
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    10
<h2>Install TRK remote agent</h2>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    11
<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>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    12
<ol>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    13
    <li><a href="run_mode_debug_example_01.htm">Connect</a> target device to PC</li>
1646
7bcb3d758005 completed remote debug tutorial
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset
    14
    <li><strong>Install TRK remote agent (v3.2.7) or later on the target device</strong></li>
1645
0083290c145a minor edits to sync titles across tutorials
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    15
    <li><a href="run_mode_debug_example_03.htm">Configure</a> project for downloading</li>
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    16
    <li><a href="run_mode_debug_example_04.htm">Debug</a> project on target device</li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    17
    </ol>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    18
<hr>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    19
<p>To debug on a remote device you need a program to communicate between the Carbide debugger and your executable running on the device. That program is the <strong>TRK</strong> (Terminal Resident Kernel) remote agent, also known as <strong>Application TRK</strong>. </p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    20
<p>&nbsp;</p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    21
<div class="step">
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    22
    <h4>Installing or updating the TRK remote agent</h4>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    23
    <ol>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    24
        <li>Select the Connection to edit in the Remote Connections view.</li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    25
        <li>Click the Edit Settings... icon (<img src="../images/icon_edit_settings.png" alt="Edit Settings icon" width="17" height="17" align="absmiddle">) in the Remote Connections toolbar.<br />
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    26
        	<p><img src="../images/run_mode_debug_05.png" alt="Click Edit Settings icon"></p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    27
        </li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    28
        <li>Click the Install Remote Agents tab. <br />
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    29
        	<p><img src="../images/run_mode_debug_06.png" alt="Click Install Remote Agents tab"></p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    30
        </li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    31
        <li>Select the latest remote agent to install.<br />
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    32
        	<p>Choose the remote agent to install. Since there are different builds for different OSes, knowing the OS installed on the device helps.           </p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    33
        </li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    34
    <p><img src="../images/run_mode_debug_07.png" alt="Click Install Remote Agents tab"></p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    35
        <p class="note"><strong>NOTE</strong> If you don't know what OS version is on the device, always choose the remote agent that supports the highest OS version available. Should that one not work, drop down to the next OS version in line and repeat.</p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    36
        <li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    37
            <p>Click <strong>Install</strong>.</p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    38
        </li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    39
    </ol>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    40
</div>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    41
<p><strong>NEXT:</strong> <a href="run_mode_debug_example_03.htm">Configure project for debugging</a></p>
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>