mksrom - create a hex (and/or) binary file for programming into a serial EEPROM
mksrom [-v] [-h] [-d] [-m <aa:bb:cc:dd:ee:ff>] [control file]
- -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
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'
DO-007286-TC, Helium Boot Procedure