readme

Support is available from MIPS Technologies Inc. - problems should be addressed to [e-mail]

Description :
===================================================================
Demonstrates code located at reset exception vector. 
Simply writes to the LED- and ASCII displays of the SEAD board.
!!! Code is specific for the SEAD board !!!

Files :
===================================================================
The following files are available in this distribution :

README :       This file.
makefile :     GNU makefile.
start.S :      Start-up code.
link.xn :      Linker script.
linkghs.lnk :  Linker script for Green Hills Software.
littleend.bld: Project file for Green Hills Software build/multi.
bigend.bld     Project file for Green Hills Software build/multi.


Building and executing :
===================================================================
Set up your specific compiler tool-chain environment.

Using make:
  Invoke make with your specific tool-chain and your target cpu's
  endianess specified on the command line as the example:
     make TOOLCHAIN=sde ENDIAN=EL
  Valid arguments are TOOLCHAIN=sde/cygnus/ghs  ENDIAN=EL/EB
  Please edit makefile's TOOLCHAIN and ENDIAN default values to
  suit your preferences.

Using Green Hills Software build command:
  Run "build littleend.bld" or "build bigend.bld" according to
  your target's endianess.

Using Green Hills Software's tool multi:
  Open and build project "littleend.bld" or "bigend.bld" according
  to your target's endianess.


The files generated are :

appl.rec :     Image in S-record format used by the "load" command.
appl.bin :     Image in binary format.
appl.elf :     Image in ELF format.
appl.map :     Linker generated map file.
appl.dis :     Disassembly of image.

appl.bin should be used to program an (E)PROM.

If compiled for little endian, the makefile will byte-swap appl.bin
using the perl script byteswap.pl. This is necessary since SEAD assumes
(E)PROM data to be big-endian ordered. 

appl.rec may also be used to program an (E)PROM, but it is NOT 
byteswapped, so if you use this file for programming an (E)PROM with
little endian code, you should first byte-swap the image. This can 
be done by the software of most (E)PROM programmers.