Building and Running the MiniGUI Tutorial

This topic describes how to build a MiniGUI ROM image and how to run the MiniGUI in the emulator.

Variant: ScreenPlay. Target audience: Device creators.

This topic builds on the introduction in the MiniGUI Environment Overview and the ROM Tools Guide.

Building a MiniGUI ROM image

Use a text editor to edit the Window Server configuration file, \epoc32\data\z\wsini_minigui.ini.

Note: This file must be created or saved in Unicode instead of ASCII.
Add the following lines to the wsini_minigui.ini file to start ESHELL as the system shell in the specified screen mode.
```
STARTUP ESHELL
SCREENMODE COLOR16MAP
```
Refer to The wsini.ini File Reference for more information about the parameters.
Make sure that the ROM image description file, minigui.oby, exists under \epoc32\rom\include\. This OBY file is the input file to the BUILDROM tool.

This file contains a statement that refers to the wsini_minigui.ini file.
```
data=DATAZ_\wsini_minigui.ini    system\data\wsini.ini
```
Build a MiniGUI ROM image from a command prompt.

The following commands build a ROM image for H4:

> cd d:\Symbian\epoc32\rom

> buildrom -nosymbols h4hrp minigui

The following commands build a ROM image for H6:

> cd d:\Symbian\epoc32\rom

> buildrom -nosymbols 34xx_sdp minigui

Where minigui stands for the minigui.oby file. The -nosymbols directive means do not generate the symbol file which contains the ROM building information for debugging purpose.

Result: The MiniGUI ROM image is generated in the current directory: d:\Symbian\epoc32\rom.

Make sure that ScreenPlay is enabled and add the following line to the \epoc32\data\epoc.ini file:
```
minigui
```
For more information about enabling ScreenPlay, refer to Enabling the Graphics Architecture Variants.
Add the following lines to the \epoc32\release\winscw\udeb\z\system\data\wsini.ini to start ESHELL as the system shell in the specified screen mode:
```
startup eshell
screenmode color16map
```

Launch the emulator to verify that MiniGUI configuration works. It boots into the black and white ESHELL.

Parent topic: MiniGUI Environment

Related concepts

Enabling the Graphics Architecture Variants