core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/run_mode_debug_06.htm
author fturovic <frank.turovich@nokia.com>
Tue, 09 Mar 2010 17:31:44 -0600
branchRCL_2_4
changeset 1086 c4cdf14b6868
parent 0 fb279309251b
permissions -rw-r--r--
BUG 10841/10842 revised TOC and Run mode example for PnP
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1086
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     2
<html>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     3
<head>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     7
<title>Run Mode On-Device Debugging</title>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     8
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     9
</head>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    10
<body bgcolor="#FFFFFF">
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    11
<h2>Run Mode On-Device Debugging</h2>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    12
<p>To implement run mode on-device debugging the following tasks need to be completed.</p>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    13
<ol>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    14
  <li><a href="run_mode_debug.htm">Install device connection software</a></li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    15
  <li><a href="run_mode_debug_01.htm">Install Perl</a></li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    16
  <li><a href="run_mode_debug_02.htm">Install an SDK</a></li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    17
  <li><a href="run_mode_debug_03.htm">Setup environment variables</a></li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    18
  <li><a href="run_mode_debug_04.htm">Setup a virtual drive for Techview and Cust Kits</a></li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    19
  <li><a href="run_mode_debug_05.htm">Set the default kit in Devices.xml </a></li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    20
  <li><b>Install the SISX file on the target device</b></li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    21
  <li><a href="run_mode_debug_07.htm">Configure TRK connection on the device</a></li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    22
  <li><a href="run_mode_debug_08.htm">Create a launch configuration</a></li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    23
</ol>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    24
<div class="step">
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    25
<h4><a name="runSISX" id="runSISX"> </a>Install the SISX File on the Target Device</h4>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    26
<p>The on-device debug agent is delivered to the target device as a SISX file. There are two versions of TRK: Application TRK and System TRK.</p>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    27
  <ul>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    28
    <li>Application TRK&mdash; supports application debugging only and available to developers creating applications for devices. Developers do not have access to system level routines, system ROM, and other user application code. User cannot modify the LR and SR registers, and must use a SIS file to debug an application.</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    29
    <li>System TRK&mdash; supports both application and limited ROM debugging; including application executables and limited ROM based components (no device drivers). Also available to original equipment manufacturers (OEMs) for device creation and customization.</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    30
  </ul>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    31
  <p>The following SISX file is officially signed by Nokia: 
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    32
  <span class="code">s60_3_0_app_trk_2_6_nokia_signed.sisx</span></p>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    33
  <h5>Installing using Bluetooth</h5>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    34
  <ol>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    35
    <li>Right click on the Bluetooth item on the system tray and select Quick Connect &gt; File Transfer &gt; Find Devices</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    36
    <li>Refresh the File Transfer window to allow the device to detect all the Bluetooth devices</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    37
    <li>From the list select your device and click Open</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    38
    <li>You should enable the My Bluetooth Places window popup option that creates a connection shortcut &ldquo;MyDeviceOBEX File Transfer&rdquo; in the My Bluetooth Places folder.</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    39
    <li>The Obex File Transfer window for your devices should open from within the My Bluetooth Folder</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    40
    <li>You will be prompted to enter a Bluetooth PIN code. Enter  any number.</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    41
    <li>On the device you will be prompted  to enter the same PIN code. Enter PIN code. </li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    42
    <li>The device will then ask you to accept the connection request from the PC. Press OK.</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    43
    <p>The OBEX folder on the PC should now be available.</p>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    44
    <li>Drop the TRK SISX file into the folder</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    45
    <li>The device will prompt you to accept the connection request from the PC. Press OK.</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    46
    <li>The SISX file should then transfer from the PC to the device</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    47
    <li>Navigate to where the SISX file was placed</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    48
    <p>If you dropped it into the OBEX folder it will be in <span class="code">Applications &gt; Messages &gt; Inbox</span>. If you dropped it into the C folder it will be in <span class="code">Applications &gt; Utilities &gt;FileBrowse &gt; C</span>.</p>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    49
    <li>Select the TRK SISX file on the device to install the TRK debug agent.</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    50
  </ol>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    51
  <h5>Installing using PC Suite</h5>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    52
  <ol>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    53
    <li>Place the SISX file on your PC</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    54
    <li>Connect the USB cable to the phone</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    55
    <li>On the device it will display USB mode:<br />
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    56
      PC Suite<br />
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    57
      File transfer</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    58
    <li>Select PC Suite and the device will connect to the PC</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    59
    <li>Open PC suite. In the bottom left a status display should indicate &ldquo;Series 60 Device connected via USB&rdquo;.</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    60
    <li>Double click &ldquo;Install applications&rdquo;. The Nokia Application Installer wizard will appear.</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    61
    <li>On the left you should see My Computer and on the right My Phone</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    62
    <li>From My Computer select the SISX file on your PC</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    63
    <li>From My Phone select the &ldquo;Phone memory&rdquo; drop down list an select where you want to install the file.</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    64
    <li>Select the green arrow pointing from My Computer to My Device. The SISX file should then be transferred to the device and installed.</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    65
  </ol>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    66
</div>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    67
<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>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    68
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    69
</body>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    70
</html>