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
-
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\
-
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
-
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
-
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\
-
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
-
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.