#****************************************************************************
#
#       Project         : Server/Loader V4.10
#       Component       : Server example.
#       File            : README
#       Author          : 
#       Description     : 
#       History         : 
#
#****************************************************************************

This example program as-is works with a HEPC9 with one HERON4 module
in slot 1. The board ID must be 0 (board ID is the red switch in the
upper left corner of the HEPC9). 

If your configuration is different, please edit the "network" file.

Note that this example cannot run with HEPC8, HEPC6 and legacy
boards (C4x boards). 

To run the example, simply type

	./w32 v

The DSP program (started by 'w32') will ask you:

In a seperate DOS box, now start the 'host' program of this example.

Start a new terminal, change directory to this example directory,
and run the 'host' program:-

	./host

The Server/Loader will now do stdio requests for the DSP in slot 1
via one FIFO, and the 'host' program communicates with the DSP in
slot 1 via another FIFO. (The example will also work with other 
slots if you change the network file.)

To compile the C6x example, you need access to Code Composer Studio.
At the time of writing this, Code Composer Studio is only available
for Windows. Using Code Composer Studio, create a new project with
the Create New HERON-API Project plug-in. If you name the project
'test.mak', then 'test.c' will be automatically included in the 
project.

This example is to show you how you can use the Server/Loader to boot,
run and serve a DSP system, while a second program (written by you) can
run in parallel and communicate with the root processor. 

The w32 script first boots the DSP network using the standard Server/
Loader using the -r (reset), -l (load network) options, then serves
the DSP network (-s option). The DSP program will then ask you to
start another terminal, where you should start host program 'host'.
This communicates with the DSP system using the Hunt Engineering API.
The result is that the DSP program communicates with the Server/Loader
over one FIFO connection with the host, and at the same time the DSP
program communicates with the 'host' program over a different FIFO.

To compile & link this program:

	make

This will use the "Makefile" present in this directory. If you intend
to write one program that both boots the DSP network and serves it, 
and run a separate thread that communicates with the DSP over another
FIFO link, please have a look at the ../threads directory.

The Server/Loader uses a network description file (called "network")
to decide what nodes need to be loaded via what links. This is further
described in the manual ("svloader.pdf" in the manuals directory on the
Hunt Engineering CD).

16/12/2003

