readme

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

Description :
===================================================================
Sample applications

helloworld :

    Demonstrates how to use the YAMON function table interface.
    Also demonstrates the use of limited standard library (printf).

    The application looks up the address of the YAMON "print" 
    function and executes the function. Then in calls printf.

yamon_fpu :

    Demonstrates the use of YAMON's floating point emulator options.

boot : 

    Demonstrates code located at reset exception vector.
    Code is specific for the SEAD board.

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

README :       This file.
helloworld :   Directory holding the "Hello world" application.
yamon_fpu  :   Directory holding the fpu options demonstration.
boot :         Directory holding the boot code demonstration.
lib :          Directory holding limited standard library.
include :      Directory holding common include files.

For contents of a subdirectory, consult the README file contained
in the directory.

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.

Applications (except for boot) are loaded using the YAMON 'load'
command (using s-record file) and executed using the 'go' command.
Alternatively, the binary file may be uploaded to a tftp server and
downloaded using 'fread  tftp://"$bootserver"/appl.bin  80200000'
and executed by 'go 80200000'.

The boot application should be used to program an (E)PROM (s-record
or binary file).