NAME

mksrom - create a hex (and/or) binary file for programming into a serial EEPROM


SYNOPSIS

mksrom [-v] [-h] [-d] [-m <aa:bb:cc:dd:ee:ff>] [control file]


ARGUMENTS

-h
print online help

-v
verbose mode

-d
use DOS line endings in hex output (default is Unix)

-m <aa:bb:cc:dd:ee:ff>
specify (or override) MAC address

control file
defaults to mksrom.cfg


DESCRIPTION

mksrom generates a hex (and/or binary) file suitable for programming into a serial EEPROM a Helium family ATMOS system.

The program parameters are set by the control file. All the allowable control keywords are listed below. There are _no_ defaults. The only controls that may be omitted are 'macaddress' (provided it is specified on the command line instead) and one of 'outputfile' or 'binaryfile'.

% comment text ...
- comment lines must start with an '%' character

target <target>
- specifies the target system. Currently only 'helium' and 'beryllium' are supported.

romsize <size>
- the size of the serial ROM, in kilobytes. For example:
       romsize 16

configinfo <size>
- the size of the configuration area, in bytes. At least 32 bytes are required. For example:
       configinfo 256

loaderfile <filename>
- the loader (first stage) boot code object file

mainfile
- the main (second stage) boot code object file

macaddress <aa:bb:cc:dd:ee:ff>
- the MAC address for the system. This may be omitted, in which case the MAC address must be specified on the command line instead. An address specified on the command line will override this setting.

pci <address> <value>
- add an address and data pair to the PCI pairs section of the serial ROM. Any number of pairs can be specified.

outputfile <filename>
- name of the Intel hex output file. Unix line endings will be used by default unless the -d flag is given on the command line. This may be omitted if 'binaryfile' is specified.

binaryfile <filename>
- name of the binary output file. This may be omitted if 'outputfile' is specified.

bootflags <value>
- 'value' is a decimal or hexadecimal (if preceeded by '0x') number representing the combination of bit fields to be set which specify various boot options. For a list of these fields see 'atmos/source/hf_configinfo/hf_configinfo.h'


SEE ALSO

DO-007286-TC, Helium Boot Procedure