core/com.nokia.carbide.cpp.doc.user/html/reference/ROM_build_settings.html
author fturovic <frank.turovich@nokia.com>
Fri, 12 Feb 2010 14:45:16 -0600
branchRCL_2_4
changeset 949 57698352558c
parent 0 fb279309251b
child 1237 9654af560a30
permissions -rw-r--r--
revised manual reference pages and images
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
949
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     2
<title>ROM Builder pane</title>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     3
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     4
<meta name="keywords" content="ROM Builder" >
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     5
</head>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     6
   <body>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     7
   <h2>ROM Builder pane </h2>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     8
   <p>Use the <b>ROM Builder</b> pane to specify commands and a working directory for building a GUI ROM Image. The tool used to build GUI ROM images is called buildrom and can typically be found in your SDK path, for example in the <span class="code">\Symbian\9.1\S60_3rd\Epoc32\tools</span> directory. The tool used to build text shell images is called ROM. The ROM image generated from the ROM building process specifies a base address for the image to run at. This might be an address in RAM or ROM. The image must be downloaded to the device at this address.</p>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     9
   <p>Building a ROM requires that the following are available, or have been successfully created:</p>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    10
   <ul>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    11
     <li> Symbian OS components making up a set of releasables</li>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    12
     <li> a Bootstrap binary image</li>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    13
     <li> a text file specifying how the ROM image is to be built.</li>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    14
   </ul>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    15
   <p>Rom build assembles executable and data files into a ROM image.</p>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    16
   <p>Executables are pre-processed, relocated, and have their imports and exports bound for a ROM image based at some given virtual address. The files, base address of the ROM, and various other parameters are specified by means of the obey file. This is a file of type .oby and is a text file containing statements that specify how the ROM image is to be built. A .oby file can include other files in the same way that files containing C++ source can #include other C++ files. By convention, the included files have the .iby file type. This structure allows flexibility in the way that ROM images are defined.</p>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    17
   <p class="note"><b>NOTE</b> The ROM image will be rebuilt for any target whenever a change to the project occurs; except for WINSCW targets.</p>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    18
   <p align="center"><img src="images/rom_build.png" width="558" height="203" /></p>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    19
   <p align="center" class="figure">Figure 1. ROM Builder pane </p>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    20
   <h5>Table 1. ROM Build Settings &mdash;items</h5>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    21
   <table cellpadding="2" cellspacing="0"
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    22
border="0">
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    23
	 <tr valign="top"><th width="221" class="Cell">Name</th><th width="558" class="Cell">Function</th></tr>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    24
         <tr valign="top">
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    25
           <td class="Cell"><b>ROM Build Command Line</b></td>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    26
           <td class="Cell"><p>Enter commands to build the GUI ROM Image. For example, the following sample command  is used for building a techview
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    27
             rom image for a H4 reference board.</p>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    28
             <p class="code">buildrom -D_FULL_DEBUG -DRVCT -DSTOP_MODE_DEBUGGING -D_EABI=ARMV5 h4hrp techview -oh4.img</p></td>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    29
        </tr>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    30
         <tr valign="top">
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    31
           <td class="Cell"><b>Working Directory</b></td>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    32
           <td class="Cell"><p>Specify the working directory for building the ROM Image. Typically, the working directory is the folder where you need to have your rom image built.
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    33
Note that your sdk and working directory should be on
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    34
the same drive, otherwise some of the rombuild scripts will fail.</p>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    35
           </td>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    36
     </tr>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    37
   </table>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    38
	 <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>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    39
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    40
   </body>
57698352558c revised manual reference pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    41
   </html>
0
fb279309251b DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff changeset
    42