core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/run_mode_debug_03.htm
author fturovic <frank.turovich@nokia.com>
Tue, 31 Aug 2010 22:58:09 -0500
changeset 1934 4f0cd256d26c
parent 1791 727385d8e2b3
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:
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
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: 1207
diff changeset
     2
<html>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     3
<head>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
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: 1207
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: 1207
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: 1207
diff changeset
     7
<title>Configuring Environment Variables</title>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     8
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     9
</head>
1791
727385d8e2b3 added new customize carbide section and some relinking done for deleted duplicate page
fturovic <frank.turovich@nokia.com>
parents: 1633
diff changeset
    10
<body >
1633
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    11
<h2>Configuring Environment Variables</h2>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    12
<p>To implement run mode on-device debugging the following tasks need to be completed.</p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    13
<div class="step">
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    14
<h4><a name="runEnvVars" id="runEnvVars"> </a>Configuring Environment Variables</h4>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    15
<ol>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    16
  <li>Set EPOCROOT variable
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    17
    <ol type="a">
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    18
      <li>Right click on My Computer and select Properties</li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    19
      <li>Select the Advanced tab</li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    20
      <li>Select the Environmental Variables button</li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    21
      <li>Setup a new System variable called EPOCROOT. The value will depend on the path of the epoc32 folder in the kit, for example: </li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    22
      <p>Variable name: <span class="code">EPOCROOT</span><br />
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    23
      Variable value: <span class="code">\bin\techview\</span></p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    24
    </ol>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    25
   </li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    26
  <p class="note"><b>NOTE</b> Take note of the location of the epoc32 folder when using multiple kits. Some kits place the epoc32 folder at \bin\techview\ and some kits will place it at the root. If you have multiple installations and switch to a new kit, you will need to change the EPOCROOT path; otherwise build problems may occur. When building the ROM image, scripts may complain  about the EPOCROOT path or that it can&rsquo;t find bldmake.bat if an incorrect EPOCROOT path is set.</p>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    27
  <li>Set Path to Tools Directory
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    28
    <ol type="a">
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    29
      <li>If using an installer the tools path is set up automatically and points to:</li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    30
          Variable: <span class="code">PATH</span><br>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    31
          Value: <span class="code">C:\Program Files\Common Files\Symbian\Tools</span>      
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    32
        <li>If installing from zip files you will need to setup the tools path manually. Add the path to the beginning of the PATH variable:</li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    33
       Variable: <span class="code">PATH</span><br />
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    34
       Variable Value: <span class="code">\epoc32\tools;\epoc32\gcc\bin;</span>       
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    35
       <li>If using multiple kits that use a mix of installer and zip files then you can set up your PATH variable like this:</li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    36
       Variable: <span class="code">PATH</span><br />
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    37
       Value: <span class="code">\epoc32\tools;\epoc32\gcc\bin;C:\Program Files\Common Files\Symbian\Tools</span>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    38
    </ol>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    39
  </li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    40
  </ol>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    41
</div>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    42
<h5>Other references</h5>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    43
<ul>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    44
  <li><a href="../../projects/tutorials/run_mode_debug_example_01.htm">Verify System Setup (Run-mode) Tutorial</a><a href="run_mode_debug.htm"></a>  </li>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    45
</ul>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
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: 1207
diff changeset
    47
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    48
</body>
0c69c533fa52 draft of run mode tutorial material
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    49
</html>