Symbian developer community

 
wiki

ROM.BAT - build text shell ROMs

From Symbian Developer Community

Jump to: navigation, search


The ROM.BAT batch file is used to build text shell roms. These are useful for testing non-UI components and is primarily used for testing and debugging.

Contents

Prerequisites

ROM.BAT requires particular version of cpp.exe, which is bundled with the kits and can be found in epoc32/gcc/bin. This path should be added to the PATH environment variable. If you have other versions of cpp.exe in your path it will need to be added before them - see Kernel & Hardware Services Quick Start\Troubleshooting.

ROM.BAT must be executed from the kernel rombuild dir:

 
.../os/kernelhwsrv/kernel/eka/rombuild
 

Synopsis

 rom <parameters> 

Generate a rom image for the specified target, along with a rom.oby file that can be fed to rombuild to regenerate the image.

Mandatory Parameters

The following options must be supplied on command line:

 
--variant=<variant> e.g. --variant=assabet
--inst=<instruction set> e.g. --inst=arm4
--build=<build> e.g. --build=udeb
--type=<type of rom>
tshell for a text shell rom
e32tests for a rom with e32tests
f32tests for rom with f32tests
alltests for all the tests
 

Optional parameters

The following parameters are optional:

 
--name=<image name> Give image file specified name
--noheader Pass -no-header option on to rombuild
--help This help message.
--clean Remove existing generated files first
--quiet Be less verbose
--modules=<comma separated list> List of additional modules for this ROM
--define=<comma separated list> List of CPP macros to define
 



Note
Parameters may be specified as a short abbreviation, for example -b udeb instead of --build udeb.



Examples

For syborg (urel) text shell:

 
rom --variant=syborg --inst=armv5 --build=urel --type=tshell
 

or debug:

 
rom --variant=syborg --inst=armv5 --build=udeb --type=tshell
 

or for beagle urel:

 
rom --variant=beagle --inst=armv5 --build=urel --type=tshell
 

Other values for type can be 'e32tests', 'f32tests' or 'alltests'.

Comments

Sign in to comment…