readme

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

Description :
===================================================================
Demonstrates the use of YAMON's floating point emulator options.
Also demonstrates how to use the YAMON function table interface
and the use of limited standard library (printf).


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

README :       This file.
makefile :     GNU makefile.
start.S :      Start-up code.
main.c :       Main application.
link.xn :      Linker script for GNU based compilers.
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.

Application is loaded using the YAMON "load" command (on appl.rec) 
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 former 80200000 corresponds to
the appropriate linker script, while the latter requires that the
file start.o is first in the object file list and that start.S holds
the label _start as the very first entry.