ROFSBUILD Obey File Structure

A ROFSBUILD obey file consists of a number of sections, each defining a ROFS image.

A ROFS image is used to store code that is not part of the Core OS section. The File Server uses ROFS (the Read-Only File System) to access this, and ROFS uses a Media Driver to read the data from the NAND Flash device and to load this into RAM for access or execution. The Composite File System combines this media area with the Core OS media area and presents the two as a single read-only drive Z:.

A ROFS image contain the following main sections:

  • a CoreImage section that specifies the existing core image to be used as the base for generating the extension image.

  • an ExtensionRomSection that defines the ROM image that extends the core image.

The structure is defined as:

ObeyFile : CoreImageStatement [ ExtensionRomSection ]
CoreImage : coreimage = <CoreImageFileName>
ExtensionRomSection : ObeyStatementList
ObeyStatementList : ObeyStatement | ObeyStatement ObeyStatementList
ObeyStatement : RomStatement | FileStatement

RomStatement

A RofsStatement is one of the following:

autosize =

<block-size>

extensionrofs

extensionrofsname =

<filename>

externaltool=

<toolname>

rofsname =

<filename>

rofsize =

<size-in-bytes>

version =

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

romsize =

<hex-size>

romchecksum =

<base-checksum>

time =

dd/mm/yyyy hh:mm:ss

trace =

<32bit-hex-number>

pagingoverride

[NOPAGING | ALWAYSPAGE | DEFAULTUNPAGED | DEFAULTPAGED]

pagingpolicy

[NOPAGING | ALWAYSPAGE | DEFAULTUNPAGED | DEFAULTPAGED]

patchdata =

<DLLname>@<symbolname> <newvalue>

FileStatement

FileStatement : FileSpecificationStatement | ControlStatement | RomDirectoryStatement

A ControlStatement is one of the following:

rem

<comments>

stop

A FileSpecificationStatement is one of the following:

data[[HWVD]] =

<Source-file> <destination-file> [FileAttributeList]

file[[HWVD]] =

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

A RomDirectoryStatement is one of the following:

hide[[HWVD]] =

<existing-file>

alias[[HWVD]] =

<existing-file> <destination-file> [FileAttributeList]

rename[[HWVD]] =

<existing-file> <destination-file> [ FileAttributeList]

FileAttributeList

FileAttributeList : FileAttribute | FileAttribute  FileAttributeList

A FileAttribute is one of the following:

attrib =

[ s | S ][ h | H ][ r | R | w | W ] | hide

exattrib=

U