
This directory contains some sample applications. The following
make target can be used:

leon3		leon3 processor, soft-float
leon3fp		leon3 processor, hard-float
leon3fpv8	leon3 processor, hard-float, V8 mul/div
leon3v8		leon3 processor, soft-float, V8 mul/div
erc32		erc32 processor, hard-float
leon2		leon2 processor, soft-float
leon2fp		leon2 processor, hard-float
leon2fpv8	leon2 processor, hard-float, V8 mul/div
leon2v8		leon2 processor, soft-float, V8 mul/div
ut699  		leon3 processor, hard-float, V8 mul/div, ut699 fixes
gr712		leon3 processor, hard-float, V8 mul/div
ngmp		leon4 processor, hard-float, V8 mul/div, linked to address 0x0

It is also possible to build a single example by calling make <example> or to build a prom image by
calling make <example>.mkprom. The executables will be stored in the root samples directory. When
building individual examples it is possible to control the behaviour by setting the following variables.

CPU         - By setting the CPU variable to one of the cpu-targets, then the hardware specific flags for that cpu-target will be added when compiling.
CFLAGS      - Override common compilation flags
CPUFLAGS    - Override the hardware specific compilation flags
MKPROMFLAGS - Override mkprom2 flags

Most samples are for LEON3/4 or LEON2, most of them include config.c
which configures drivers and help setting up networking. Network
interfaces are assigned a MAC and IP address according to networkconfig.h.

NOTE: The paranoia program may report errors when executed on tsim
on intel hosts. This is due to a bug in paranoia - not the compiler.

Some hints:

* rtems-cdtest is a C++ application that tests exception handling. If you
  run it on leon hardware using dsumon, remember to start dsumon with -nb
  to stop dsumon from breaking on forced exceptions.

* rtems-ttcp is a network test program and needs a lot of memory for 
  network buffers. If you run it on the GR-PCI-XC2V board through the
  dsumon, start dsumon with -nosram to use the 16 (or 64) Mbyte of
  sdram rather than the 1 Mbyte of sram.

* rtems-http is a web server demo program. It also includes an
  ftp server and allows uploading and downloading of files.

* rtems-shell is an demonstraion program for the RTEMS shell.
  Type help at the prompt to see the available commands.

* config.c Configure driver resources, initializes the Driver Manager
  and BSP Networking Stack.

* config_*.c Subsystem configuration.
