NAME

iceboot - boot a system through the JTAG interface


SYNOPSIS

iceboot [-v | -h] [-f configfile] [downloadfile]


ARGUMENTS

-h
print online help and exit

-v
verbose mode

-f configfile
defaults to iceboot.cfg

downloadfile
if present, overrides the download file specified in the config file


DESCRIPTION

iceboot downloads a mkhfflash-created flash image to a system through the JTAG interface and boots it.

It can also (as of version 1.02) download and run any binary image that is executed by the NP jumping to the first word of the downloaded file. The most common example of this is the update.bin file produced by building the serialboot products.

The program parameters are set by the control file. All the allowable control keywords are listed below.

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

target = <target-string>
- name of the rdi target, in the same form as would be passed to gdb (see DO-007065 ), e.g. ``target = e=192.168.219.122''

setup = <filename>
- name of the file that sizes and configures SDRAM before the main download The tools installation includes files for Helium (he-init), Beryllium (be-init) , Helium 100/200/210 (au-init) and Argon 4x1 (also au-init).

addr1 = <address>
- address to which setup file should be loaded in NP memory (in hex).

Use 0x2000 for Helium and Beryllium

Use 0x6000 for Helium 100 and Helium 200/210

Use 0x0 for Helium 500.

If you are using iceboot 1.08 or later, this can be left out of the configuration file in which case it will be set to the default for the chip detected.

flash = <filename>
- name of the flash image to download. This can be omitted from the config file if a download file is named on the command line.

addr2 = <address>
- address to which flash file should be loaded in NP memory map (in hex). Use 0x10000000

If you are using iceboot 1.08 or later, this can be left out of the configuration file in which case it will be set to the default for the chip detected.

mac0 ... mac5
- Helium only: a MAC address (mac0 is the MSB) to be written into the ethernet hardware at download time. This is needed when downloading a serial ROM update as this reads its MAC address out of the hardware on Helium.

reset = <yes/no>
- Tell iceboot to try and reset the chip when it starts the download process. This may not work on all boards, but is recommended if it works. This value defaults to ``yes''.

idlocation = <address>
 - address from which to read the chip ID register (iceboot 1.08 and
later only). The built-in default is  correct for all chips prior to
Helium 500. For Helium 500 use 0x30000008.


IMPORTANT

The JTAG select on the target must be set to the NP.

The ICE unit (EmbeddedICE or JEENI) should be reset after download. Not doing so will result in degraded performance on subsequent downloads.


FILES

iceboot.cfg
- the default configuration file in .../virata/share

au-init be-init cf-init he-init
- the supplied setup image: this gets installed in /usr/local/virata/share on Linux and Solaris, and in the virata\share subdirectory on NT.


SEE ALSO

DO-007065-TC, Using GDB with ATMOS