core/com.nokia.carbide.cpp.doc.user/html/projects/launch/wiz_new_launch_config.htm
author dan.podwall@nokia.com
Mon, 06 Apr 2009 14:56:28 -0500
changeset 56 887bd61e1328
parent 2 d760517a8095
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"
cawthron
parents:
diff changeset
     5
 content="text/html; charset=ISO-8859-1" />
cawthron
parents:
diff changeset
     6
  <meta http-equiv="Content-Style-Type" content="text/css" />
cawthron
parents:
diff changeset
     7
  <meta name="LASTUPDATED" content="06/17/05 11:09:43" />
cawthron
parents:
diff changeset
     8
  <title>New Launch Configuration Wizard</title>
cawthron
parents:
diff changeset
     9
  <link rel="StyleSheet" href="../../../book.css" type="text/css" />
cawthron
parents:
diff changeset
    10
</head>
cawthron
parents:
diff changeset
    11
<body bgcolor="#ffffff">
cawthron
parents:
diff changeset
    12
<h2>New Launch Configuration Wizard </h2>
cawthron
parents:
diff changeset
    13
<p>The <b>New Launch Configuration Wizard</b> launches when no  launch configuration exists for a project. Wherever possible the <b>New Launch Configuration </b> wizard gathers the information from the project and asks additional questions based on the type of launch configuration chosen. For example, a launch configuration using Application TRK requires different information than  one targeted for System TRK. </p>
cawthron
parents:
diff changeset
    14
<p>For Application TRK and System TRK the following pages appear: </p>
cawthron
parents:
diff changeset
    15
<ul>
cawthron
parents:
diff changeset
    16
  <li><a href="#LAUNCH">Launch Type</a></li>
cawthron
parents:
diff changeset
    17
  <li><a href="#EXE_SEL">Executable Selection </a></li>
cawthron
parents:
diff changeset
    18
  <li><a href="#TRK_CONN">TRK Connection Settings</a></li>
cawthron
parents:
diff changeset
    19
  <li><a href="#TRK_SIS">TRK SIS Selection</a> (<i>Application TRK only</i>) </li>
cawthron
parents:
diff changeset
    20
  <li><a href="#FINISH">New Launch Configuration</a></li>
cawthron
parents:
diff changeset
    21
</ul>
cawthron
parents:
diff changeset
    22
<p>For Trace32 launch configurations the following wizard pages appear:</p>
cawthron
parents:
diff changeset
    23
<ul>
cawthron
parents:
diff changeset
    24
  <li><a href="#LAUNCH">Launch Type</a></li>
cawthron
parents:
diff changeset
    25
  <li><a href="#EXE_SEL">Executable Selection </a></li>
cawthron
parents:
diff changeset
    26
  <li><a href="#TRACE32">Trace32 Initialization Settings</a></li>
cawthron
parents:
diff changeset
    27
  <li><a href="#ROM_IMG">Symbian ROM Image  Settings</a></li>
cawthron
parents:
diff changeset
    28
  <li><a href="#FINISH">New Launch Configuration</a></li>
cawthron
parents:
diff changeset
    29
</ul>
cawthron
parents:
diff changeset
    30
<p>For Sophia STI launch configurations the following wizard pages appear:</p>
cawthron
parents:
diff changeset
    31
<ul>
cawthron
parents:
diff changeset
    32
  <li><a href="#LAUNCH">Launch Type</a></li>
cawthron
parents:
diff changeset
    33
  <li><a href="#EXE_SEL">Executable Selection </a></li>
cawthron
parents:
diff changeset
    34
  <li><a href="#SOPHIA">Sophia Initialization Settings</a></li>
cawthron
parents:
diff changeset
    35
  <li><a href="#ROM_IMG">Symbian ROM Image  Settings</a></li>
cawthron
parents:
diff changeset
    36
  <li><a href="#FINISH">New Launch Configuration</a></li>
cawthron
parents:
diff changeset
    37
</ul>
cawthron
parents:
diff changeset
    38
<p>For Attach to Process launch configurations the following wizard pages appear:</p>
cawthron
parents:
diff changeset
    39
<ul>
cawthron
parents:
diff changeset
    40
  <li><a href="#TRK_CONN">TRK Connection Settings</a></li>
cawthron
parents:
diff changeset
    41
  <li><a href="#FINISH">New Launch Configuration</a></li>
cawthron
parents:
diff changeset
    42
</ul>
cawthron
parents:
diff changeset
    43
<p>To access the <b>New Launch Configurtion Wizard</b>, set the Build Target to a Phone Debug target (Figure 1), then click the <b>Debug</b> icon (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle">). If no launch configuration exists for the  build target the wizard is launched. If a launch configuration already exists, then that launch configuration is launched and not the wizard.</p>
cawthron
parents:
diff changeset
    44
<p>For emulator targets, the New Launch Configuration Wizard can gather all the information it needs from the project, so clicking <b>Debug</b> just launches the debug session.</p>
cawthron
parents:
diff changeset
    45
<p align="center"><img src="../../images/icons/menu_build_target.png" width="270" height="120"></p>
cawthron
parents:
diff changeset
    46
<p class="figure">Figure 1 - Build Target selection list </p>
cawthron
parents:
diff changeset
    47
<h3><a name="LAUNCH" id="LAUNCH"></a>Launch Types</h3>
cawthron
parents:
diff changeset
    48
<p>Use the<b> Launch Types</b> page to select the type of launch configuration for the build target. Available types are listed from the most frequently chosen (Application TRK) to the least likely type (Attach to Process). Select a type and click <b>Next</b>. </p>
cawthron
parents:
diff changeset
    49
<p align="center"><img src="../../images/icons/wiz_launch_config_launch_types.png" width="438" height="533"></p>
cawthron
parents:
diff changeset
    50
<p class="figure">Figure 2 - Launch Type page </p>
cawthron
parents:
diff changeset
    51
<p>&nbsp;</p>
cawthron
parents:
diff changeset
    52
<h3><a name="EXE_SEL" id="EXE_SEL"></a>Executable Selection </h3>
cawthron
parents:
diff changeset
    53
<p>Use the <b>Application Selection </b> page to choose a binary created by the project to launch and debug and verify its location. If only a single binary is available the <b>Executable to launch</b> option is disabled. Use the <b>Specify device or emulator path of executable to launch</b> option to specify alternate paths for launching the executable from RAM (c:\sys\bin\), ROM (z:\sys\bin\) or  memory cards (e:\sys\bin\) . </p>
cawthron
parents:
diff changeset
    54
<p>Use the <b>Location</b> field for emulator targets to verify that the correct executable on the host is selected. This field is not used with on-device launch configurations. </p>
cawthron
parents:
diff changeset
    55
<p>Select the Executable to launch, verify it is the correct binary, then click <b>Next</b>. </p>
cawthron
parents:
diff changeset
    56
<p align="center"><img src="../../images/icons/wiz_launch_config_app_selection.png" width="438" height="533"> </p>
cawthron
parents:
diff changeset
    57
<p class="figure">Figure 3 - Executable Selection page </p>
cawthron
parents:
diff changeset
    58
<h3><a name="TRK_CONN" id="TRK_CONN"></a>TRK Connection Settings </h3>
cawthron
parents:
diff changeset
    59
<p>Use the <b>TRK Connection Settings</b> page to specify the COM port used to communicate with the target device. If the device is already connected, the drop down list will include both the COM port and the name of the device using that port. Use the <a href="../../../reference/trk/wnd_on_device_setup.htm">On-Device Setup</a> dialog to verify and update all Carbide software services on the device. Choose the serial port used to communicate with the target device and click <b>Next</b>. </p>
cawthron
parents:
diff changeset
    60
<p align="center"><img src="../../images/icons/wiz_launch_config_trk_conn.png" width="463" height="533"> </p>
cawthron
parents:
diff changeset
    61
<p class="figure">Figure 4 - TRK Connection Settings  page </p>
cawthron
parents:
diff changeset
    62
<p>&nbsp;</p>
cawthron
parents:
diff changeset
    63
<h3><a name="TRK_SIS" id="TRK_SIS"></a>TRK SIS Selection</h3>
cawthron
parents:
diff changeset
    64
<p>Use the <b>TRK SIS Selection</b> page to select the SIS file to install on the target device. Click the <b>Modify SIS builder settings for build configuration</b> link to open the <a href="../../reference/wnd_debug_configuration.htm">SIS Builder</a> properties page to add, edit, or review  the SIS files to build. Once the correct SIS File to Install is selected, click <b>Next</b>. </p>
cawthron
parents:
diff changeset
    65
<p align="center"><img src="../../images/icons/wiz_launch_config_trk_sis.png" width="463" height="533"></p>
cawthron
parents:
diff changeset
    66
<p class="figure">Figure 5 - TRK SIS Selection page </p>
cawthron
parents:
diff changeset
    67
<h3><a name="FINISH" id="FINISH"></a>New Launch Configuration</h3>
cawthron
parents:
diff changeset
    68
<p>Use the <b>New Launch Configuration</b> page to note the name of the configuration, confirm the launch configuration settings,  and then launch the debug session. If something doesn't look right, click <b>Back</b> to return to a page and change its setting. If all the settings are correct, click <b>Finish</b> to start the debug session using this launch configuration. </p>
cawthron
parents:
diff changeset
    69
<p>If you checkmark <b> Advanced settings</b>, the <a href="trace32.htm">Debug</a> dialog appears instead of launching the project. This enables you to make additional changes to the new launch configuration before starting the debug session. By design and intent, this should seldom be required for the initial launch. </p>
cawthron
parents:
diff changeset
    70
<p align="center"><img src="../../images/icons/wiz_launch_config_finish.png" width="438" height="533"></p>
cawthron
parents:
diff changeset
    71
<p class="figure">Figure 6 - New Launch Configuration page </p>
cawthron
parents:
diff changeset
    72
<h3><a name="TRACE32" id="TRACE32"></a>Trace32 Initialization Settings</h3>
cawthron
parents:
diff changeset
    73
<p>Use the <b>Trace32 Initialization Settings</b> page to specify the <a href="sophia.htm">initialization</a> script and target processor of the target device.Enter the Trace32 Initialization Script and choose the Target Processor, then click <b>Next</b>. </p>
cawthron
parents:
diff changeset
    74
<p> This page only appears when creating a Trace32 launch configuration. </p>
cawthron
parents:
diff changeset
    75
<p align="center"><img src="../../images/icons/wiz_launch_config_trace32.png" width="438" height="533"></p>
cawthron
parents:
diff changeset
    76
<p class="figure">Figure 7 - <b>Trace32 Initialization Settings</b> page </p>
cawthron
parents:
diff changeset
    77
<h3><a name="SOPHIA" id="SOPHIA"></a>Sophia STI  Initialization Settings</h3>
cawthron
parents:
diff changeset
    78
<p>Use the <b>Sophia STI  Initialization Settings</b> page to specify the target interface, <a href="page_rom_image.htm">initialization</a> file,  and target processor of the target device. Enter the Sophia Target Interface and Target Initialization File paths, choose a Target Processor, then click <b>Next</b>. </p>
cawthron
parents:
diff changeset
    79
<p>This page only appears when creating a Sophia STI launch configuration. </p>
cawthron
parents:
diff changeset
    80
<p align="center"><img src="../../images/icons/wiz_launch_config_sophia.png" width="438" height="533"></p>
cawthron
parents:
diff changeset
    81
<p class="figure">Figure 8 - Sophia STI  Initialization Settings page </p>
cawthron
parents:
diff changeset
    82
<h3><a name="ROM_IMG" id="ROM_IMG"></a>Symbian ROM Image  Settings</h3>
cawthron
parents:
diff changeset
    83
<p>Use the <b>Symbian ROM Image Settings</b> page to specify the method of <a href="page_debugger.htm">debugging</a>, the start address, and the <a href="../../../reference/launch_configs/stop_mode_rom_image.htm">ROM Image</a> and Log File locations.  </p>
cawthron
parents:
diff changeset
    84
<p>This page  appears when creating a Trace32 or Sophia STI launch configuration. </p>
cawthron
parents:
diff changeset
    85
<p align="center"><img src="../../images/icons/wiz_launch_config_rom_image.png" width="438" height="533"></p>
cawthron
parents:
diff changeset
    86
<p class="figure">Figure 9 - Symbian ROM Image  Settings page</p>
cawthron
parents:
diff changeset
    87
<h5>Other references</h5>
cawthron
parents:
diff changeset
    88
<ul>
cawthron
parents:
diff changeset
    89
  <li><a href="launch_configs_overview.htm">Launch Configuration</a>  </li>
cawthron
parents:
diff changeset
    90
</ul>
cawthron
parents:
diff changeset
    91
<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
    92
</body>
cawthron
parents:
diff changeset
    93
</html>