Symbian developer community

 
Home > Wiki > ROM Building Guide
wiki

ROM Building Guide

From Symbian Developer Community

Jump to: navigation, search

Contents

Overview

Image:RomBuildingOverview.jpg

The figure above describes the ROM build system. The two commands which perform most of the tasks are SBS to compile the code and BUILDROM to gather the executables together into a ROM image.

  • The SBS tool compiles the code to generate the .exe or .dll files and exports header files.
  • BUILDROM is invoked with command-line parameters. BUILDROM processes its command-line parameters. For example, if -noimage option is provided, it will suppress ROM, ROFS or data drive image creation.
  • BUILDROM invokes other tools based on the OBY/IBY configurations and command-line parameters. For example, if the ECOM_PLUGIN macro is set in the oby file, SPITOOL will be invoked by BUILDROM to create static plug-in information (SPI) files. If the sisfile keyword is set in the oby file, InterpretSIS is invoked to install the SIS file.
Note
For the sisfile keyword, InterpreteSIS invokes READIMAGE to generate an .iby. This .iby information is then included in the input .oby file for ROMBUILD or ROFSBUILD.


  • The finalised .oby file is generated for ROMBUILD or ROFSBUILD respectively.
  • ROMBUILD or ROFSBUILD is invoked to build the ROM image or the ROFS image respectively.
Note
The -D_NAND2 macro for BUILDROM generates a ROFS image and a ROM image for NAND flash.


  • When ROMBUILD or ROFSBUILD builds an image file, it also creates a log file containing information about files included in the image. MAKSYM can be invoked independently to process this log file. It creates a text file listing the address of every global and exported function in the ROM image.

ROM Building guides for current OS releases

Building Symbian^2 ROM for Syborg and QEMU

Developers can now build ROMs for Syborg/QEMU from the Symbian^2 code base. The instructions are here.

Creating Symbian^2 UI ROM Images

For Zoom2 and Syborg

This article has instructions for building full UI ROMs.

For QEMU using Imaker Tool

This article has instructions for Creating Symbian S60 UI ROM Images for QEMU using Imaker Tool.

Tools for building ROMs

iMaker

iMaker is a ROM-image creation tool with a simple, standardized, platform-independent and configurable creation framework.

Typically, iMaker is the only tool required to create Symbian flash ROM images. Internally, iMaker mainly functions on top of the Symbian buildrom utility which, in turn, integrates rombuild and rofsbuild tools.

Full iMaker documentation is provided with source here

BUILDROM

BUILDROM is a front end to the ROM building tools, rombuild and rofsbuild. See BUILDROM reference for details on BUILDROM.

ROM.BAT

This batch file is used to build text-shell roms for base testing. See ROM.BAT - build text shell ROMs for more information.

rombuild

See rombuild reference for more details.

rofsbuild

See rofsbuild reference for more details.

Retrieved from "http://developer.symbian.org/wiki/index.php/ROM_Building_Guide"

Comments

Sign in to comment…