core/com.nokia.carbide.cpp.doc.user/html/tasks/debugger/run_mode_debug_03.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>Configuring Environment Variables</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>Configuring Environment Variables</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
<div class="step">
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    14
<h4><a name="runEnvVars" id="runEnvVars"> </a>Configuring Environment Variables</h4>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    15
<ol>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    16
  <li>Set EPOCROOT variable
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    17
    <ol type="a">
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    18
      <li>Right click on My Computer and select Properties</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    19
      <li>Select the Advanced tab</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    20
      <li>Select the Environmental Variables button</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
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>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    22
      <p>Variable name: <span class="code">EPOCROOT</span><br />
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    23
      Variable value: <span class="code">\bin\techview\</span></p>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    24
    </ol>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    25
   </li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
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>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    27
  <li>Set Path to Tools Directory
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    28
    <ol type="a">
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    29
      <li>If using an installer the tools path is set up automatically and points to:</li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    30
          Variable: <span class="code">PATH</span><br>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    31
          Value: <span class="code">C:\Program Files\Common Files\Symbian\Tools</span>      
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
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>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    33
       Variable: <span class="code">PATH</span><br />
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    34
       Variable Value: <span class="code">\epoc32\tools;\epoc32\gcc\bin;</span>       
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
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>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    36
       Variable: <span class="code">PATH</span><br />
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    37
       Value: <span class="code">\epoc32\tools;\epoc32\gcc\bin;C:\Program Files\Common Files\Symbian\Tools</span>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    38
    </ol>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    39
  </li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    40
  </ol>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    41
</div>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    42
<h5>Other references</h5>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    43
<ul>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    44
  <li><a href="run_mode_debug.htm">Run Mode On-Device Debugging</a>  </li>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    45
</ul>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
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>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    47
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    48
</body>
c4cdf14b6868 BUG 10841/10842 revised TOC and Run mode example for PnP
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    49
</html>