ROMBUILD Obey File Structure

The sections are:

a KernelRomSection that defines a bootable ROM image, and includes the Kernel
one or more ExtensionRomSection s that define ROM images that extend +the KernelRomSection.

Every section contains a list of obey statements that specify ROM +configuration information or specifies the files to be included in +the ROM image.

Extension ROM sections are marked by the extensionrom keyword, and can only contain those ROM information +statements that are not related to the Kernel configuration.

The structure is defined as:

+ObeyFile : KernelRomSection [ ExtensionRomList ] +KernelRomSection : ObeyStatementList +ExtensionRomList : ExtensionRomSection | ExtensionRomSection ExtensionRomList +ExtensionRomSection : extensionrom = <RomFileName> ObeyStatementList +ObeyStatementList : ObeyStatement | ObeyStatement ObeyStatementList +ObeyStatement : RomStatement | FileStatement +

See RomStatement
See FileStatement
See extensionrom keyword

RomStatement

A RomStatement is one of the following.

+ + + +

romname =

<rom-file-name>

+ + +

bootbinary =

<boot-file-name>

+ + +codepagingpolicy +

[NOPAGING | ALWAYSPAGE | DEFAULTUNPAGED | DEFAULTPAGED]

+ + +datapagingpolicy +

[NOPAGING | ALWAYSPAGE | DEFAULTUNPAGED | DEFAULTPAGED]

+ + +codepagingoverride +

[NOPAGING | ALWAYSPAGE | DEFAULTUNPAGED | DEFAULTPAGED]

+ + +datapagingoverride +

[NOPAGING | ALWAYSPAGE | DEFAULTUNPAGED | DEFAULTPAGED]

+ + +

demandpagingconfig =

+ + +

kerneldataaddress =

<hex-address>

+ + +

kernelheapmin =

<hex-size>

+ + +

kernelheapmax =

<hex-number>

+ + +

maxunpagedsize

<hex-number>

+ + +

kernelconfig =

<hex-number>

+ + +

multikernel =

+ + +

kerneltrace =

<32 bit hex-number | decimal number> [<32 +bit hex-number | decimal number>]{0,7}

The maximum number of bit mask is 8.

+ + +

kernelromname =

<rom-file-name>

+ + +

romnameodd =

<rom-file-name-odd>

+ + +

romnameeven =

<rom-file-name-even>

+ + +

srecordfilename =

<srec-file-name>

+ + +

srecordbase =

<hex-address>

+ + +

version =

[ <major> ] [ .<minor> ] [ (<build>) + ]

+ + +

romsize =

<hex-size>

+ + +

romlinearbase =

<hex-address>

+ + +

romalign =

<hex-alignment>

+ + +

dataaddress =

<hex-address>

+ + +

romchecksum =

<base-checksum>

+ + +

time =

dd/mm/yyyy hh:mm:ss

+ + +

trace =

<32bit-hex-number>

+ + +

debugport =

<32bit-number>

+ + +

collapse =

+ + +

ascii =

+ + +

unicode =

+ + +

epocwrapper =

+ + +

externaltool =

+ + +

coffwrapper =

+ + +

filecompressnone =

+ + +

filecompressinflate =

+ + +

filecompressbytepair =

+ + +

filecompressnone =

+ + +

filecompressinflate =

+ + +

filecompressbytepair =

+ + +

defaultstackreserve =

default stack reserve

+ + +

demandpagingconfig =

+ + +

dlldatatop =

address of data region

+ + +

memmodel =

moving | direct | multiple <chunk size> <page + size>

+ + +

nowrapper =

+ + +

pagingoverride =

[NOPAGING | ALWAYSPAGE | DEFAULTUNPAGED | + DEFAULTPAGED]

+ + +

pagingpolicy =

[NOPAGING | ALWAYSPAGE | DEFAULTUNPAGED | + DEFAULTPAGED]

+ + +

platsecdiagnostics =

[on | off]

+ + +

platsecdisabledcaps =

[on | off]

+ + +

platsecenforcement =

[on | off]

+ + +

platsecenforcesysbin =

[on | off]

+ + +

platsecprocessisolation =

[on | off]

+ + +

pagingoverride =

[NOPAGING | ALWAYSPAGE | DEFAULTUNPAGED | + DEFAULTPAGED]

+ + +

pagingpolicy =

[NOPAGING | ALWAYSPAGE | DEFAULTUNPAGED | + DEFAULTPAGED]

+ + +

patchdata =

<binary_name> ordinal <ordinal_no.> + <size_bytes> <new_value>

<binary_name> addr <symbol_address> + <size_bytes> <new_value>

Where, <binary_name > is the name of the binary along with its +complete path, <ordinal_no. > is the ordinal +number of the symbol to be patched, <symbol_address > is the address of the data symbol to be patched, <size_bytes > is the size of the symbol in bytes, and <new_value > is the new value for the symbol.

Note: If you want to use the second version of patchdata, you must know the address of the data symbol to be patched.

+ + +

BTrace =

N1 [N2 [N3 [N4 [N5 [N6 [N7 [N8]]]]]]]

+ + +

BTraceBuffer =

+ + +

BTraceMode =

+ + + +

FileStatement FileStatement : ControlStatement | FileSpecificationStatement | RomDirectoryStatement

A ControlStatement is one of the following:

+ + + +

rem =

+ + +

section =

<section-offset>

+ + +

extensionrom =

<rom-filename

+ + +

align =

alignment

+ + +

area =

+ + +

stop =

+ + + +

A FileSpecificationStatement is one of +the following:

+ + + +

data[[HWVD]] =

<source-file> <destination-image-file> + [ FileAttributeList ]

+ + +

file[[HWVD]] =

<Source-file> <destination-file> [ FileAttributeList] [OverrideAttributeList ] [paged | +unpaged]

+ + +

primary[[HWVD]] =