Symbian3/PDK/Source/GUID-5CDD2D09-33B2-501B-A060-784C401CA373.dita
author Graeme Price <GRAEME.PRICE@NOKIA.COM>
Fri, 15 Oct 2010 14:32:18 +0100
changeset 15 307f4279f433
parent 14 578be2adaf3e
permissions -rw-r--r--
Initial contribution of the Adaptation Documentation.

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE task
  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="GUID-5CDD2D09-33B2-501B-A060-784C401CA373" xml:lang="en"><title>Building
a ROM for Development Board Tutorial</title><shortdesc>This topic describes how to build the ROM for development board. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
<context id="GUID-25CC3018-729C-45AC-BC08-2B922020D450"><p>Two options are involved in ROM creation, for example, vendor
and hardware specific. The ROM is built for hardware reference boards. </p> </context>
<steps id="GUID-0B3249E8-4187-5AF3-84D8-0F8CBFEA4404">
<step id="GUID-4830D5F4-72F9-5183-B363-51E8E52FC639"><cmd>Copy the EPOC32
directory from the CD to the root drive of the Test Controller PC. </cmd>
</step>
<step id="GUID-9B38D9B9-E094-5E78-A497-F3769FBCAB1A"><cmd/>
<info>Compile the <codeph>iperfte</codeph> plug-in, <codeph>testexecute</codeph> and <codeph>ucc</codeph> components
to build the ROM. The Buildcreates a core ROM IMG file. For more information
about the build rom options, see the <xref href="GUID-4D55E43C-B203-5145-9105-D75660D02E3B.dita">reference
page</xref>. </info>
</step>
</steps>
<example><title>Building a ROM for Development Board example</title> <p>The
following steps create a ROM: </p> <codeblock id="GUID-5C5F42E6-259B-5638-82A0-4E823414FD2D" xml:space="preserve">
rem - current path has to be in epoc32\rom
cd /D %EPOCROOT%epoc32\rom

rem – build ROM image
buildrom [macros] [feature manager options] [target device] techview.oby PlatSec.oby [components list] -osys$rom.bin

rem - delete old zipped image if exists
del [card drive]\sys$rom.zip
rem - zip the ROM image and copy it to flash card
zip sys$rom.zip sys$rom.bin
copy sys$rom.zip [card drive]

rem – now eject the cart clearly, either from the "Safely Remove Hardware"
rem - icon in the systray, or running some 3rd party tool such as:
rem - sync –e [card drive]
</codeblock> <p>The following code is an example of how to build a ROM for
a fully automated test driven by <i>TestDriver</i>. </p> <codeblock id="GUID-8480AFD3-B8D5-5746-AD27-9237EFAB01AB" xml:space="preserve">
buildrom -D_SERIAL_DOWNLOAD -D_STARTUPMODE1 -DEXCLUDE_JAVA -DUSE_STRONG_CRYPTOGRAPHY h2 techview.oby
    PlatSec.oby NoWatcher.iby statauto.iby profiler.iby ether802.iby testexecute.iby ced.iby -osys$rom.bin
</codeblock> <p>The following code is an example for a H2 board. The ROM includes
the <i>Delay meter</i> and not the <i>NetPerf</i>, <i>TEF</i> plug-in, which
is transferred by <i>TestDriver</i>: </p> <codeblock id="GUID-EEF9B64D-64A5-5CE4-BDBF-0358D1D166F5" xml:space="preserve">
buildrom -D_SERIAL_DOWNLOAD -D_STARTUPMODE1 -DEXCLUDE_JAVA -DUSE_STRONG_CRYPTOGRAPHY -nofm h2
     techview.oby PlatSec.oby NoWatcher.iby statauto.iby profiler.iby ether802.iby testexecute.iby
     ced.iby netperfdelayplugin.iby -osys$rom.bin
</codeblock> <p>The following code is an example of how to build a ROM for
a semi-automated test for a H4 board: </p> <codeblock id="GUID-7D5139D7-8354-5DBE-B97C-F909312E4DDD" xml:space="preserve">
buildrom -D_SERIAL_DOWNLOAD -D_STARTUPMODE1 -DEXCLUDE_JAVA -DUSE_STRONG_CRYPTOGRAPHY -nofm
     h4hrp techview.oby PlatSec.oby NoWatcher.iby testexecute.iby netperf.iby ucc.iby ether802.iby
     profiler.iby ced.iby ceddump.iby -osys$rom.bin
</codeblock> </example>
</taskbody><related-links>
<link href="GUID-D1B54263-1637-5D4E-8FE1-92612AB2851C.dita"><linktext>Network Performance
Test</linktext></link>
<link href="GUID-72F3CFD2-DDE4-56F1-907A-7C455BEDF674.dita"><linktext>Running the
NetPerf Test                 Suite</linktext></link>
<link href="GUID-C2125B4A-A945-529C-AA2F-BDD00EADF489.dita"><linktext>Configuring
the                 Communications Database for the DUT</linktext></link>
</related-links></task>