Getting Started

This section provides a quick walk-through of the steps involved in building ROM images.

Installation

You can find ROM tools such as BUILDROM–buildrom.cmd, ROMBUILD–rombuild.exe and ROFSBUILD–rofsbuild.exe under %EPOCROOT%epoc32\tools.

Quick start

Building a ROM image for NOR flash

  1. From a command line, set the EPOCROOT and PATH environment variables.

    PATH must include the path where the Symbian platform tools exist. EPOCROOT is the path under which the epoc32 folder exists. EPOCROOT is used by the tools.

    For example, if Symbian platform is installed under d:\Symbian\9.5, the PATH and EPOCROOT are set as follows:

    > d:

    > set PATH=d:\Symbian\9.5\epoc32\tools;%PATH%

    > set EPOCROOT=\Symbian\9.5\

  2. Issue the command as shown below. h4hrp and techview are two OBY files(h4hrp.oby and techview.oby) under \epoc32\rom\include. They contain information about the ROM image configuration and IBY files for different components to be included.

    > buildrom h4hrp techview

  3. The following files are generated under the directory where the BUILDROM command is issued:

    h4hrp_001.techview.img–The eXecute-In-Place(XIP) ROM image. It contains Symbian platform with the techview GUI application.

    h4hrp_001.techview.log–The log file for the ROM image. It contains information about the binaries that the ROMBUILD tool loads and processes to build the ROM image.

Building a ROM image for NAND flash

  1. From a command line, set the EPOCROOT and PATH environment variables.

    PATH must include the path where the Symbian platform tools exist. EPOCROOT is the path under which the epoc32 folder exists. EPOCROOT is used by the tools.

    For example, if Symbian platform is installed under d:\Symbian\9.5, the PATH and EPOCROOT are set as follows:

    > d:

    > set PATH=d:\Symbian\9.5\epoc32\tools;%PATH%

    > set EPOCROOT=\Symbian\9.5\

  2. Issue the command as shown below. h4hrp and techview are two OBY files(h4hrp.oby and techview.oby) under \epoc32\rom\include. They contain information about the ROM image configuration and IBY files for different components to be included.

    > buildrom -D_NAND2 h4hrp techview

  3. The following files are generated under the same directory where the BUILDROM command is issued:

    h4hrp_001.techview.nand.rofs.img–The non-XIP ROFS image. It contains applications except for the core services.

    h4hrp_001.techview.nand.img–The XIP ROM image contains the core services such as kernel and frequently used drivers and servers.

    h4hrp_001.techview.nand.rofs.log–The log file for the ROFS image. It contains information about the binaries that the ROFSBUILD tool loads and processes to build the ROFS image.

    h4hrp_001.techview.nand.log–The log file for the ROM image. It contains information about the binaries that the ROMBUILD tool loads and processes to build the ROFS image.

    Note: The -D_NAND2 macro for BUILDROM generates a ROFS image and a ROM image for NAND flash.