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 concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-ED20B02A-C146-5E28-A102-D3AE11D9015F" xml:lang="en"><title>Building

    13 and Running the MiniGUI Tutorial</title><shortdesc>This topic describes how to build a MiniGUI ROM image and how to

    14 run the MiniGUI in the emulator. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <p> <b>Variant</b>: ScreenPlay. <b>Target audience</b>: Device creators. </p>

    16 <p>This topic builds on the introduction in the <xref href="GUID-E09F74E2-B5A2-51F8-BD9E-882BE2661D5C.dita">MiniGUI

    17 Environment Overview</xref> and the ROM Tools Guide. </p>

    18 <section><title>Building a MiniGUI ROM image</title> <ol id="GUID-AAD227D8-8D67-5951-B359-715D4A0AD33B">

    19 <li id="GUID-9921FB78-9201-5337-95D4-CB62BEFA4C32"><p>Use a text editor to

    20 edit the Window Server configuration file, <filepath>\epoc32\data\z\wsini_minigui.ini</filepath>. </p> <p>Note:

    21 This file must be created or saved in Unicode instead of ASCII. </p> </li>

    22 <li id="GUID-43452758-28A2-5095-88FB-07C2964F49CB"><p>Add the following lines

    23 to the <filepath>wsini_minigui.ini</filepath> file to start ESHELL as the

    24 system shell in the specified screen mode. </p> <codeblock id="GUID-21B815C5-1BE1-5905-87C6-BA14DA659C8B" xml:space="preserve">STARTUP ESHELL

    25 SCREENMODE COLOR16MAP</codeblock> <p>Refer to <xref href="GUID-1D529BDC-6665-58E2-AB3F-7023D8A84F69.dita">The

    26 wsini.ini File Reference</xref> for more information about the parameters. </p> </li>

    27 <li id="GUID-CC5687DF-9863-51C6-B348-D10C10868DAD"><p>Make sure that the ROM

    28 image description file, <filepath>minigui.oby</filepath>, exists under <filepath>\epoc32\rom\include\</filepath>.

    29 This OBY file is the input file to the <filepath>BUILDROM</filepath> tool. </p> <p>This

    30 file contains a statement that refers to the <filepath>wsini_minigui.ini</filepath> file. </p> <codeblock id="GUID-82D32D6F-A2A2-56A0-8AF9-6C021CC3E321" xml:space="preserve">data=DATAZ_\wsini_minigui.ini    system\data\wsini.ini</codeblock> </li>

    31 <li id="GUID-C3015F0E-CDE7-5940-9088-9DBE34468277"><p>Build a MiniGUI ROM

    32 image from a command prompt. </p> <p>The following commands build a ROM image

    33 for H4: </p> <p>&gt; cd d:\Symbian\epoc32\rom </p> <p>&gt; buildrom -nosymbols h4hrp

    34 minigui </p> <p>The following commands build a ROM image for H6: </p> <p>&gt;

    35 cd d:\Symbian\epoc32\rom </p> <p>&gt; buildrom -nosymbols 34xx_sdp minigui </p> <p>Where <filepath>minigui</filepath> stands

    36 for the <filepath>minigui.oby</filepath> file. The <codeph>-nosymbols</codeph> directive

    37 means do not generate the symbol file which contains the ROM building information

    38 for debugging purpose. </p> </li>

    39 </ol> <p> <b>Result</b>: The MiniGUI ROM image is generated in the current

    40 directory: <filepath>d:\Symbian\epoc32\rom</filepath>. </p> </section>

    41 <section><title>Running the MiniGUI in the emulator</title> <ol id="GUID-DC6EB5D4-FDE5-5464-B2CE-0D272F4AAD61">

    42 <li id="GUID-B6913759-85BE-5480-B3A2-F0D52D7E40B7"><p>Make sure that ScreenPlay

    43 is enabled and add the following line to the <filepath>\epoc32\data\epoc.ini</filepath> file: </p> <codeblock id="GUID-EE4BD889-EB25-5259-9183-7F96BF419794" xml:space="preserve">minigui</codeblock> <p>For

    44 more information about enabling ScreenPlay, refer to <xref href="GUID-6D8A1FC7-095B-587E-8274-23C132978C53.dita">Enabling

    45 the Graphics Architecture Variants</xref>. </p> </li>

    46 <li id="GUID-B866EB6F-7817-55F1-9631-ED0B7122B048"><p>Add the following lines

    47 to the <filepath>\epoc32\release\winscw\udeb\z\system\data\wsini.ini</filepath> to

    48 start ESHELL as the system shell in the specified screen mode: </p> <codeblock id="GUID-7ECA751A-5C25-5774-ACBD-DA5D861C125D" xml:space="preserve">startup eshell

    49 screenmode color16map</codeblock> </li>

    50 </ol> <p>Launch the emulator to verify that MiniGUI configuration works. It

    51 boots into the black and white ESHELL. </p> </section>

    52 </conbody><related-links>

    53 <link href="GUID-6D8A1FC7-095B-587E-8274-23C132978C53.dita"><linktext>Enabling

    54 the Graphics Architecture  Variants</linktext></link>

    55 <link href="GUID-85E1E45B-DD05-5B7D-84E7-9911E0A3E3CC.dita"><linktext>The wsini.ini

    56 File</linktext></link>

    57 </related-links></concept>