1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE task

    11   PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

    12 <task xml:lang="en" id="GUID-5CDD2D09-33B2-501B-A060-784C401CA373"><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><p>The <i>NetPerf</i> test suite is intended for Symbian OS v9.5 or later. The test can also run, with reduced functionality, on any release of Symbian OS since 9.1. 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">

    13 rem - current path has to be in epoc32\rom

    14 cd /D %EPOCROOT%epoc32\rom

    15 

    16 rem – build ROM image

    17 buildrom [macros] [feature manager options] [target device] techview.oby PlatSec.oby [components list] -osys$rom.bin

    18 

    19 rem - delete old zipped image if exists

    20 del [card drive]\sys$rom.zip

    21 rem - zip the ROM image and copy it to flash card

    22 zip sys$rom.zip sys$rom.bin

    23 copy sys$rom.zip [card drive]

    24 

    25 rem – now eject the cart clearly, either from the "Safely Remove Hardware"

    26 rem - icon in the systray, or running some 3rd party tool such as:

    27 rem - sync –e [card drive]

    28 </codeblock> <p>The following code is an example of how to build a ROM for a fully automated test driven by <i>TestDriver</i>. It is a build for a H2 board and for Symbian OS v9.4 or earlier: </p> <codeblock id="GUID-8480AFD3-B8D5-5746-AD27-9237EFAB01AB" xml:space="preserve">

    29 buildrom -D_SERIAL_DOWNLOAD -D_STARTUPMODE1 -DEXCLUDE_JAVA -DUSE_STRONG_CRYPTOGRAPHY h2 techview.oby

    30     PlatSec.oby NoWatcher.iby statauto.iby profiler.iby ether802.iby testexecute.iby ced.iby -osys$rom.bin

    31 </codeblock> <p>The following code is an example for a H2 board and Symbian OS v9.5 or later. 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">

    32 buildrom -D_SERIAL_DOWNLOAD -D_STARTUPMODE1 -DEXCLUDE_JAVA -DUSE_STRONG_CRYPTOGRAPHY -nofm h2

    33      techview.oby PlatSec.oby NoWatcher.iby statauto.iby profiler.iby ether802.iby testexecute.iby

    34      ced.iby netperfdelayplugin.iby -osys$rom.bin

    35 </codeblock> <p>The following code is an example of how to build a ROM for a semi-automated test for a H4 board, with Symbian OS v9.5 environment. This includes the <i>Delay meter</i> library and extra utilities, for example, <codeph>ping</codeph>, <codeph>ipconfig</codeph> and <codeph>ceddump</codeph>: </p> <codeblock id="GUID-7D5139D7-8354-5DBE-B97C-F909312E4DDD" xml:space="preserve">

    36 buildrom -D_SERIAL_DOWNLOAD -D_STARTUPMODE1 -DEXCLUDE_JAVA -DUSE_STRONG_CRYPTOGRAPHY -nofm

    37      h4hrp techview.oby PlatSec.oby NoWatcher.iby testexecute.iby netperf.iby ucc.iby ether802.iby

    38      profiler.iby ced.iby ceddump.iby -osys$rom.bin

    39 </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

    40                 Suite</linktext> </link> <link href="GUID-C2125B4A-A945-529C-AA2F-BDD00EADF489.dita"><linktext>Configuring the

    41                 Communications Database for the DUT</linktext> </link> </related-links></task>