core/com.nokia.carbide.cpp.doc.user/html/projects/launch/page_main.htm
author dan.podwall@nokia.com
Mon, 06 Apr 2009 14:56:28 -0500
changeset 56 887bd61e1328
parent 2 d760517a8095
child 279 9abb752d5c0a
permissions -rw-r--r--
merge from RCL_2_0 to default
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
cawthron
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
cawthron
parents:
diff changeset
     2
<html>
cawthron
parents:
diff changeset
     3
<head>
cawthron
parents:
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
cawthron
parents:
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
cawthron
parents:
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
cawthron
parents:
diff changeset
     7
<title>Carbide Main page </title>
cawthron
parents:
diff changeset
     8
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
cawthron
parents:
diff changeset
     9
</head>
cawthron
parents:
diff changeset
    10
<body bgcolor="#FFFFFF">
cawthron
parents:
diff changeset
    11
<h2>Main page </h2>
cawthron
parents:
diff changeset
    12
<p>The options shown in the <b>Main</b> page differ based upon the type of launch configuration. Generally, the options fall into these choices: </p>
cawthron
parents:
diff changeset
    13
<ul>
cawthron
parents:
diff changeset
    14
  <li><a href="#emulator_mode">Emulation Main page</a> (Emulation) </li>
cawthron
parents:
diff changeset
    15
  <li><a href="#run_mode">Run-mode Main page</a> (Application TRK) </li>
cawthron
parents:
diff changeset
    16
  <li><a href="#stop_mode">Stop-Mode Main page</a> (System TRK, Sophia, Trace32) </li>
cawthron
parents:
diff changeset
    17
</ul>
cawthron
parents:
diff changeset
    18
<h3><a name="emulator_mode" id="emulator_mode"></a>Emulation Main page </h3>
cawthron
parents:
diff changeset
    19
<p>The <b>Symbian OS <a href="emulation.htm">Emulation</a></b> launch configuration uses the <b>Main</b> page to define the process to be launched by the emulator. </p>
cawthron
parents:
diff changeset
    20
<p>The behavior that occurs when launching a debug session varies based upon the <a href="page_main.htm">SDK</a>. Normally, <a href="../../tasks/debugger/work_debug_act_start.htm">starting</a> a debug session launches the emulator (<span class="code">epoc.exe</span>) and you must then navigate to your application and open it. However, starting a debug session for an .exe file will, in most cases, launch the .exe directly. This starts the emulator and then opens your application automatically. Note that some SDKs do not support this behavior. In those cases you must still open your application in the emulator manually.</p>
cawthron
parents:
diff changeset
    21
<p align="center"><img src="images/page_debug_main.png" width="639" height="278"></p>
cawthron
parents:
diff changeset
    22
<p class="figure">Figure 1. Main page (Emulation shown) </p>
cawthron
parents:
diff changeset
    23
<h5>Table 1. Emulator Main page &mdash;items </h5>
cawthron
parents:
diff changeset
    24
<table width="94%"  border="0" cellpadding="2" cellspacing="0">
cawthron
parents:
diff changeset
    25
  <tr>
cawthron
parents:
diff changeset
    26
    <th width="38%" scope="col">Item</th>
cawthron
parents:
diff changeset
    27
    <th width="62%" scope="col">Explanation</th>
cawthron
parents:
diff changeset
    28
  </tr>
cawthron
parents:
diff changeset
    29
  <tr>
cawthron
parents:
diff changeset
    30
    <td><b>Project</b></td>
cawthron
parents:
diff changeset
    31
    <td><p>The project to associate with this debug launch configuration. Click <b>Browse</b> to select a different project. </p>    </td>
cawthron
parents:
diff changeset
    32
  </tr>
cawthron
parents:
diff changeset
    33
  <tr>
cawthron
parents:
diff changeset
    34
    <td><b>Process to launch </b></td>
cawthron
parents:
diff changeset
    35
    <td>The path to the emulator or executable to  launch. For Symbian OS 9.1 the emulator path is required. For Symbian OS 9.2 and later the path to the executable should be used.  Click <b>Browse</b> to select a different emulator. </td>
cawthron
parents:
diff changeset
    36
  </tr>
cawthron
parents:
diff changeset
    37
</table>
cawthron
parents:
diff changeset
    38
cawthron
parents:
diff changeset
    39
<h3><a name="run_mode" id="run_mode"></a>Run-mode Main page </h3>
cawthron
parents:
diff changeset
    40
<p>The <b>Symbian OS <a href="run_mode.htm">Application TRK </a></b> launch configuration uses the <b>Main</b> page to defines the project and the process to launch on the target device. </p>
cawthron
parents:
diff changeset
    41
<p align="center"><img src="images/page_main_run_mode.png" width="615" height="264"></p>
cawthron
parents:
diff changeset
    42
<p class="figure">Figure 2 - Main page (Application TRK shown) </p>
cawthron
parents:
diff changeset
    43
<h5>Table 2.  Run-mode Main page &mdash;items </h5>
cawthron
parents:
diff changeset
    44
<table width="94%"  border="0" cellpadding="2" cellspacing="0">
cawthron
parents:
diff changeset
    45
  <tr>
cawthron
parents:
diff changeset
    46
    <th width="38%" scope="col">Item</th>
cawthron
parents:
diff changeset
    47
    <th width="62%" scope="col">Explanation</th>
cawthron
parents:
diff changeset
    48
  </tr>
cawthron
parents:
diff changeset
    49
  <tr>
cawthron
parents:
diff changeset
    50
    <td><b>Project</b></td>
cawthron
parents:
diff changeset
    51
    <td><p>The project to associate with this  launch configuration. Click Browse to select a different project. </p></td>
cawthron
parents:
diff changeset
    52
  </tr>
cawthron
parents:
diff changeset
    53
  <tr>
cawthron
parents:
diff changeset
    54
    <td><b>Remote process to launch </b></td>
cawthron
parents:
diff changeset
    55
    <td><p>The absolute path of the  remote executable to launch on the target device. The binary to debug may be stored on one of several memory locations, the most common  are:</p>
cawthron
parents:
diff changeset
    56
        <ul>
cawthron
parents:
diff changeset
    57
          <li><b>RAM</b> (default) &#8212; programs running in RAM are launched from <span class="code">c:\sys\bin\</span> </li>
cawthron
parents:
diff changeset
    58
          <li><b>ROM</b> &#8212; programs running in ROM are launched from <span class="code">z:\sys\bin\</span></li>
cawthron
parents:
diff changeset
    59
          <li><b>Memory cards</b> &#8212; programs running on a memory card  are launched from <span class="code">e:\sys\bin\</span> </li>
cawthron
parents:
diff changeset
    60
        </ul>
cawthron
parents:
diff changeset
    61
      <p>In the event a program is not launching, verify that the<b> </b>path is correct for the memory location where the binary resides.</p></td>
cawthron
parents:
diff changeset
    62
  </tr>
cawthron
parents:
diff changeset
    63
  <tr>
cawthron
parents:
diff changeset
    64
    <td><b>Use connection</b></td>
cawthron
parents:
diff changeset
    65
    <td>Choose the remote connection type to associate with this launch configuration. Click <a href="../../reference/trk/wnd_new_conn_wiz_add.htm">New</a> to add a new connection, or <a href="../../reference/trk/wnd_new_conn_wiz_edit.htm">Edit</a> to modify the current one.</td>
cawthron
parents:
diff changeset
    66
  </tr>
cawthron
parents:
diff changeset
    67
</table>
cawthron
parents:
diff changeset
    68
<h3><a name="stop_mode" id="stop_mode"></a>Stop-mode Main page </h3>
cawthron
parents:
diff changeset
    69
<p>The <b>Symbian OS <a href="stop_mode.htm">System TRK</a>, <a href="sophia.htm">Sophia</a></b>, and <b><a href="trace32.htm">Trace32</a> </b> launch configurations uses the <b>Main</b> page to defines the project and the executable to launch on the target device. </p>
cawthron
parents:
diff changeset
    70
<p align="center"><img src="images/page_main_stop_mode.png" width="642" height="264" /></p>
cawthron
parents:
diff changeset
    71
<p class="figure">Figure 3. Main page </p>
cawthron
parents:
diff changeset
    72
<h5>Table 3. Stop-mode Main page &mdash; items</h5>
cawthron
parents:
diff changeset
    73
<table width="94%"  border="0" cellpadding="2" cellspacing="0">
cawthron
parents:
diff changeset
    74
  <tr>
cawthron
parents:
diff changeset
    75
    <th width="32%" scope="col">Item</th>
cawthron
parents:
diff changeset
    76
    <th width="68%" scope="col">Explanation</th>
cawthron
parents:
diff changeset
    77
  </tr>
cawthron
parents:
diff changeset
    78
  <tr>
cawthron
parents:
diff changeset
    79
    <td><b>Project</b></td>
cawthron
parents:
diff changeset
    80
    <td>The project to associate with this debug launch configuration. Click Browse to select a different project. </td>
cawthron
parents:
diff changeset
    81
  </tr>
cawthron
parents:
diff changeset
    82
  <tr>
cawthron
parents:
diff changeset
    83
    <td><b>Executable</b></td>
cawthron
parents:
diff changeset
    84
    <td><span
cawthron
parents:
diff changeset
    85
 style="font-weight: normal;">This is the name of the executable that is linked to the project. </span>Click <b>Browse</b> to select a different executable. </td>
cawthron
parents:
diff changeset
    86
  </tr>
cawthron
parents:
diff changeset
    87
  <tr>
cawthron
parents:
diff changeset
    88
    <td><b>Use connection</b></td>
cawthron
parents:
diff changeset
    89
    <td>Choose the remote connection type to associate with this launch configuration. Click <a href="../../reference/trk/wnd_new_conn_wiz_add.htm">New</a> to add a new connection, or <a href="../../reference/trk/wnd_new_conn_wiz_edit.htm">Edit</a> to modify the current one.</td>
cawthron
parents:
diff changeset
    90
  </tr>
cawthron
parents:
diff changeset
    91
</table>
cawthron
parents:
diff changeset
    92
<h4>Other references</h4>
cawthron
parents:
diff changeset
    93
<ul>
cawthron
parents:
diff changeset
    94
  <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
cawthron
parents:
diff changeset
    95
</ul>
cawthron
parents:
diff changeset
    96
<div id="footer">Copyright &copy; 2009 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>
cawthron
parents:
diff changeset
    97
<h5>&nbsp;</h5>
cawthron
parents:
diff changeset
    98
</body>
cawthron
parents:
diff changeset
    99
</html>