Mercurial Mercurial > oss > FCL > sftools > dev > ide > carbidecpp / annotate
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/stop_mode_debug_launchcfg.htm
author fturovic <frank.turovich@nokia.com>
Tue, 31 Aug 2010 22:58:09 -0500
changeset 1934 4f0cd256d26c
parent 1854 49624691da34
permissions -rw-r--r--
BUG 11531 - fixed reported issues from Rooney and Stephen for SDK section
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     2
 
<html>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     3
 
<head>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     4
 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     5
 
<meta http-equiv="Content-Style-Type" content="text/css" />
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     6
 
<title>Stop Mode On-Device Debugging</title>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     7
 
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     8
 
</head>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     9
 
<body bgcolor="#FFFFFF" dir="ltr">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    10
 
<h2> Defining a Stop Mode Debug Configuration</h2>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 819
diff changeset 
    11
 
<p>After installing all necessary software such as Perl, JTAG, compilers, Devkits and SDKs and creating your project, you will need to define a Debug launch configuration for your project. For this example, we will define a Trace32 launch configuration. For new projects that do not have a launch configuration, a New Launch Configuration Wizard will appear and allow you to define settings. You can also cancel the wizard and define a launch configuration from the following instructions.</p>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    12
 
<div class="step">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    13
 
  <h4>Define a Launch Configuration </h4>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    14
 
  <ol>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    15
 
    <li>Access the Debug window
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    16
 
      <ol type="a">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    17
 
        <li>If necessary, import a project's  .mmp or .inf file in Carbide.c++.</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    18
 
          <li>Select the Project in the C/C++ Project view that you want to debug.</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    19
 
          <li>Select the Run &gt; Debug… menu option to display the Debug launch configuration window.</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    20
 
          <li>Define a debug launch configuration to communicate with the on-device debug agent or protocol interface.</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    21
 
          <li>In the Debug window, define the type of debug launch configuration to use when debugging programs on the target device.</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    22
 
      </ol>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    23
 
  </li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    24
 
    <p align="center"><img src="images/Debug_Config_window.png" width="704" height="455" /></p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    25
 
    <p align="left" class="figure">Figure 1 - Debug Configurations</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    26
 
    <p>Select either a Symbian OS Trace32 configuration type for stop mode on-device debugging and click the New launch configuration icon. The following pages require review and possible option settings:</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    27
 
    <ul>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    28
 
      <li> Main - defines the project to be launched on the target device</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    29
 
        <li>Connection - specifies the method used to transfer files to the target device</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    30
 
        <li> Debugger - provides control over entry points, message handling, and instruction set default settings</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    31
 
        <li> ROM Image- specifies startup options and ROM log and image files </li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    32
 
        <li>Source - specifies the source lookup paths </li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    33
 
    <li>Common - specifies general launch configuration settings </li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    34
 
    </ul>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    35
 
    <p>Click <b>Debug</b> after all the preference panels have been set. The Debug window closes and the Carbide.c++ debugger begins a debugging session using the new configuration. The next time you click the Debug icon, this debug launch configuration is used to start a debug session.</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    36
 
    <li>Define Main Tab Settings</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    37
 
    <p>The Main pane shown in Figure 2 defines the project to be launched on the target device. Table 1 defines the fields.</p>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
    38
 
    <p><img src="images/Debug_Config_main.png" width="830" height="506" /></p>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    39
 
    <p class="figure">Figure 2 - Debug Window - Main Tab</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    40
 
    <p>Table 1. Main pane</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    41
 
    <table width="94%"  border="0" cellpadding="2" cellspacing="0">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    42
 
      <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    43
 
        <th width="38%" scope="col">Item</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    44
 
        <th width="62%" scope="col">Explanation</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    45
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    46
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
    47
 
        <td><span class="style12"><strong>Project</strong></span></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    48
 
        <td><p>The project to associate with this debug launch configuration. Click Browse to select a different project.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    49
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    50
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
    51
 
        <td><span class="style12"><strong>Executable</strong></span></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    52
 
        <td><span
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    53
 
 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>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    54
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    55
 
    </table>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    56
 
    <p></p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    57
 
    <li> Define Connection Tab Settings</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    58
 
    <p><img src="images/Debug_Config_connection.png" width="804" height="309" /></p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    59
 
    <p class="figure">Figure 3 -  Debug Window - Connection Tab</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    60
 
    <p>Table 2 - Connection pane</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    61
 
    <table width="94%"  border="0" cellpadding="2" cellspacing="0">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    62
 
      <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    63
 
        <th width="38%" scope="col">Item</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    64
 
            <th width="62%" scope="col">Explanation</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    65
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    66
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
    67
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    68
 
            <p class="style11"><b>Trace32 Executable</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    69
 
            <td><p>Specify the path to the Trace32 executable. The default path assumes that the Trace32 executable is installed in the default location: C:\T32\T32marm.exe.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    70
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    71
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
    72
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    73
 
            <p class="style11"><b>Trace32 Configuration File</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    74
 
            <td>Specify the path to the config.t32 file or other custom configuration file. The default path assumes that the Trace32 configuration file is installed in the default location: C:\T32\config.t32.
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    75
 
              <p>For arm11 processors copy the trace32 configuration file for non-ARM11 processor (config_arm11.t32) to your C:\T32 folder and specify it in the edit box.</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    76
 
              <p>You can modify the config.t32 file to support UDP (User Datagram Protocol) connections by adding the following lines: <br />
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    77
 
                PBI=USB<br />
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    78
 
                RCL=NETASSIST<br />
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    79
 
                PACKLEN=1024<br />
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    80
 
                PORT=20000</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    81
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    82
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
    83
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    84
 
            <p class="style11">
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    85
 
                <b>Trace32 Initialization Script</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    86
 
            <td><p>Specify the path to the initialization <span class="code">cmm</span> file. This script will be run in T32 after connecting to T32. You can specify your own scripts for the targets used.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    87
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    88
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
    89
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    90
 
            <p class="style11"><b>
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    91
 
            View messages between Carbide and Trace32</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    92
 
            <td>Enable to log communications with Trace32 to the console window.</td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    93
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    94
 
    </table>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    95
 
	<p></p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    96
 
    <li>Define Debugger Tab Settings</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    97
 
    <p align="center"><img src="images/Debug_Config_debugger.png" width="594" height="297" /></p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    98
 
    <p class="figure">Figure 4 - Debug Window - Debugger tab</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    99
 
    <p>Table 3 -  Debugger pane</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   100
 
    <table width="94%"  border="0" cellpadding="2" cellspacing="0">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   101
 
      <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   102
 
        <th width="38%" scope="col">Item</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   103
 
        <th width="62%" scope="col">Explanation</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   104
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   105
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   106
 
        <td><span class="style6"><strong>Break at entry point</strong></span></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   107
 
        <td><p>When checked, break at the specified entry point entered in the text field. For .EXE targets, the default entry point is set to <span class="code">E32Main</span>. By default, the <b>Break at entry point</b> option is unchecked for all other target types.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   108
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   109
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   110
 
        <td><span class="style6"><strong>Target Processor </strong></span></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   111
 
        <td>A drop down with a list of all supported processors.  The process selection should help in determining the memory model. This will in turn help determine the base address and the offsets for the Symbian OS kernel aware information.</td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   112
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   113
 
      <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   114
 
        <td>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   115
 
        <p class="style8"><strong>Target Initialization File</strong></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   116
 
        <td><p>Check this box to have the debugger run an initialization script when the debug session starts. For example, if a target device requires initialization for the debugger to be able to read and write memory or registers, you can specify an initialization script here. Click Browse to select a script file using a standard file selection dialog box.</p>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 819
diff changeset 
   117
 
            <p>When using T32, most of the initialization is done in the CMM script file. With other debug protocols you  specify the initialization file, which can be run after connecting to the target.</p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   118
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   119
 
      <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   120
 
        <td>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   121
 
        <p class="style8"><strong>Memory Configuration File</strong></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   122
 
        <td>Controls whether the debugger uses a memory configuration file when a debug session starts. The Carbide debugger uses this configuration file to know which memory is accessible, readable, and writable on the target.</td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   123
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   124
 
      <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   125
 
        <td>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   126
 
        <p class="style8"><strong>Reset target at the start of each debug session</strong></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   127
 
        <td>Forces the Carbide IDE to reset the target at the start of each debug session. This ensures that the debugging session uses the most up-to-date program code.</td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   128
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   129
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   130
 
        <td><p class="style6"><strong>Default Instructon Set </strong></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   131
 
        <td><p>Specifies the default instruction set to use if the debugger cannot determine the processor mode in order to set breakpoints and to disassemble code. This can happen at addresses for which we have no symbolic information. The debugger uses the mode when setting breakpoints and disassembling code. The options are:</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   132
 
            <ul>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   133
 
              <li>Auto (examine code at current PC location) </li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   134
 
              <li>ARM (32-bit) </li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   135
 
              <li>THUMB (16-bit) </li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   136
 
            </ul>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   137
 
            <p>By default the Instruction Set option uses ARM 32-bit.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   138
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   139
 
    </table>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   140
 
    <p></p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   141
 
    <li>Define ROM Image Tab</li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   142
 
    <p align="center"><img src="images/Debug_Config_ROM.png" width="594" height="481" /></p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   143
 
    <p class="figure">Figure 5 - Debug Window - ROM Image Tab</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   144
 
    <p>Table 4 - ROM Image pane</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   145
 
    <table width="94%"  border="0" cellpadding="2" cellspacing="0">
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   146
 
      <tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   147
 
        <th width="38%" scope="col">Item</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   148
 
        <th width="62%" scope="col">Explanation</th>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   149
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   150
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   151
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   152
 
          <p class="style8">
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   153
 
              <b>Start Address</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   154
 
        <td><p>Enter the physical address in memory where the Symbian OS start code begins execution. This address is target-specific. The address should be in hexadecimal format with the 0x prefix. For example, 0x8000000 is a valid entry.</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   155
 
          <p class="note"><b>NOTE</b> The address entered in this field must match the start address specified in the source code used to build the Symbian OS ROM image to be debugged. The Start address must match the Download address.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   156
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   157
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   158
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   159
 
          <p class="style8">
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   160
 
              <b>Debug from Start address</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   161
 
        <td>Select this option to have the debugger halt the program at the address specified in Start Address once the target initialization is done and the OS is downloaded; if the user has chosen to download the OS. You can then step through start-up code or run the target in bare-board mode.</td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   162
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   163
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   164
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   165
 
          <p class="style8">
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   166
 
            <b>Run from start address</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   167
 
        <td>Select this option to have the debugger start the code at the address specified in Start Address once the target initialization is done. If you have breakpoints set, the debugger stops at the first breakpoint encountered. You can click the Break button to halt the device.</td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   168
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   169
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   170
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   171
 
          <p class="style8">
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   172
 
              <b>Symbian ROM Log file</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   173
 
        <td>Check the Parse ROM Log File option and specify the information that the debugger needs in order to show detailed stack information, set breakpoints, and show source level debugging information for ROM images. In the first text field, browse to or enter the full path and name of the log file that corresponds to the ROM image on the target device. This log file is generated by default when the ROM image is built.</td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   174
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   175
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   176
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   177
 
          <p class="style8">
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   178
 
              <b>Symbian OS Kit EPOC32 Directory</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   179
 
        <td class="note"><p>Specifies the epoc32 directory in which the ROM image and log files are stored. Since the log file may not contain full paths to the ROM components on the host PC, you need to enter this epoc32 directory.</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   180
 
            <p class="note"><b>NOTE</b> Always include the epoc32 folder in this path.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   181
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   182
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   183
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   184
 
          <p class="style8">
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   185
 
              <b>Log unresolved modules</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   186
 
        <td class="note"><p>Check this box to have the debugger output a list of components from the specified ROMBUILD log file that do not have debugger symbolic information. The list is displayed in the debugger console window at the beginning of the debug session.</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   187
 
            <p class="note"><b>NOTE</b> You cannot perform source-level debugging on components that do not include symbolic information.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   188
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   189
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   190
 
        <td>
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   191
 
          <p class="style8"><b>Debug non-XIP Executables</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   192
 
        <td><p>Check this box to debug a project, or a dynamically loaded module, that is loaded from NAND-Flash or other removable media (MMC, memory stick, etc.) at run time and executed in RAM. Use this option to debug modules that work fine when executed in place as part of the ROM image, but sometimes fail when placed in NAND-Flash or other removable media.</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   193
 
            <p class="note"> <b>NOTE</b> Selecting this option will affect debugging performance. When the debugger needs to load a module (DLL, EXE, etc.) it will stop the target, read information from it, then restart it.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   194
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   195
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   196
 
        <td>
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   197
 
          <p class="style8"><b>Symbian ROM Image</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   198
 
        <td>Controls the logging of communication with Trace32. Enable to log communications with Trace32 to the console window.</td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   199
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   200
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   201
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   202
 
          <p class="style8"><b>Download Address (hex) </b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   203
 
        <td><p>Enter the physical address in memory at which the debugger should place the ROM image. This address is target-specific. The address should be in hexadecimal format with the 0x prefix. For example, 0x000FFF00 is a valid entry.</p>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   204
 
          <p class="note"> <b>NOTE</b> The address entered in this field must match the download address specified in the source code used to build the Symbian OS ROM image to be debugged. If you leave this field blank, the debugger does not download the ROM image to the device at the beginning of the debug session. The Download address must match the Start address.</p></td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   205
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   206
 
      <tr>
1854
49624691da34 BUG 11654 - pulled most of the TRACE32 refs except those in stop-mode (which needs rewriting yet)
fturovic <frank.turovich@nokia.com>
parents: 1754
diff changeset 
   207
 
        <td>
1754
a1e1c11d5a44 broken links fixed
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
   208
 
          <p class="style8"><b>Ask for download at the start of each debug session</b></p></td>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   209
 
        <td>Check this box to have the debugger display a dialog box at the beginning of every debug session that lets you choose whether or not you want the debugger to download the ROM image to the device.</td>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   210
 
      </tr>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   211
 
    </table>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   212
 
  </ol>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   213
 
</div>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   214
 
<h5>Related Tasks</h5>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   215
 
<ul>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   216
 
  <li><a href="stop_mode_debug_precond.htm">Stop Mode On-Device Debugging Preconditions</a></li>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   217
 
</ul>
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
   218
 












8121a281245c
BUG 10603 - removed sophia text references from 3.0



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




   219


<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>













8121a281245c
BUG 10603 - removed sophia text references from 3.0



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




   220














8121a281245c
BUG 10603 - removed sophia text references from 3.0



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




   221


</body>













8121a281245c
BUG 10603 - removed sophia text references from 3.0



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




   222


</html>















FCL/sftools/dev/ide/carbidecpp