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/reference/ROM_build_settings.html
author fturovic <frank.turovich@nokia.com>
Fri, 24 Sep 2010 13:12:07 -0500
changeset 2103 4036e1c78a68
parent 1207 e265bbe56eb0
child 2131 ff0156b93599
permissions -rw-r--r--
additional TOC changes and page editing
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2103
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
     1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><html><head>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
     2
 
<title>ROM Builder pane</title>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
     3
 
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
     4
 
<meta name="keywords" content="ROM Builder" >
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
     5
 
</head>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
     6
 
   <body>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
     7
 
   <h2>ROM Builder pane </h2>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
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.4\S60_5rd\Epoc32\tools</span> directory. The tool used to build text shell images is called ROM. The ROM image generated from the ROM build 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>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
     9
 
   <p>Building a ROM requires that the following are available, or have been successfully created:</p>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    10
 
   <ul>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    11
 
     <li> Symbian OS components making up a set of releasables</li>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    12
 
     <li> a Bootstrap binary image</li>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    13
 
     <li> a text file specifying how the ROM image is to be built.</li>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    14
 
   </ul>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    15
 
   <p>Rom build assembles executable and data files into a ROM image.</p>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
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>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
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>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    18
 
   <p align="center"><img src="images/rom_build.png" width="558" height="203" /></p>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    19
 
   <p align="center" class="figure">Figure 1. ROM Builder pane </p>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    20
 
   <h5>Table 1. ROM Build Settings &mdash;items</h5>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    21
 
   <table cellpadding="2" cellspacing="0"
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    22
 
border="0">
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    23
 
	 <tr valign="top"><th width="221" class="Cell">Name</th><th width="558" class="Cell">Function</th></tr>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    24
 
         <tr valign="top">
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    25
 
           <td class="Cell"><b>ROM Build Command Line</b></td>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
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
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    27
 
             rom image for a H4 reference board.</p>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    28
 
             <p class="code">buildrom -D_FULL_DEBUG -DRVCT -DSTOP_MODE_DEBUGGING -D_EABI=ARMV5 h4hrp techview -oh4.img</p></td>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    29
 
        </tr>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    30
 
         <tr valign="top">
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    31
 
           <td class="Cell"><b>Working Directory</b></td>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
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.
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    33
 
Note that your sdk and working directory should be on
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    34
 
the same drive, otherwise some of the rombuild scripts will fail.</p>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    35
 
           </td>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    36
 
     </tr>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    37
 
   </table>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
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>
4036e1c78a68 additional TOC changes and page editing
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    39
 












4036e1c78a68
additional TOC changes and page editing



fturovic <frank.turovich@nokia.com>


parents: 
1207

diff
changeset




    40


   </body>













4036e1c78a68
additional TOC changes and page editing



fturovic <frank.turovich@nokia.com>


parents: 
1207

diff
changeset




    41


   </html>








0






fb279309251b
DP tools release version Revision: 200912



Deepak Modgil <Deepak.Modgil@Nokia.com>


parents: 

diff
changeset




    42


   














FCL/sftools/dev/ide/carbidecpp