iceboot - boot a system through the JTAG interface
iceboot [-v | -h] [-f configfile] [downloadfile]
- -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
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.
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.
- 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.
DO-007065-TC, Using GDB with ATMOS