README for HEGD9 example with  Code Composer only
=================================================

In this directory there are the following files

README        This file
GD9     C     The .C file that has some useful functions defined.
MAKE    BAT   A batch file to compile the demo for use with TI C compiler
GD9CC   WKS   A Code Composer workspace file that sets up the environment
	      for use with Code Composer

COMPILING
---------

Check your system configuration to find out which comport of the
DSP is connected to the GD1. In the .C file there is a line  

#define ANALOGUE_IN     5       /* Comport for the HEGD9 */

which must be changed to reflect the correct comport connection.

The File HUNT.CMD must be changed to reflect the memory configuration
of your processing module that the HEGD9 is connected to.

The file MAKE.BAT must have the TICC and TILIB varaibles edited to
show the location of your TI compiler.

The demo can then be built using the make batch file or by setting
the option sin the Code Composer Project Build options.

The program cannot print so all data that you want to see must
come from the Code Composer windows.

FOR USE WITH CODE COMPOSER 
--------------------------

If you have copied your demo into the directory c:\hegd9\c4x\cconly
then you can start Code Composer and simply open the workspace provided
(gd9cc.wks). You may have some problems with the paths of the various
files, so you might need to set up some of the workspace yourself.

You must edit a GEL initialisation file based upon the HUNTENG.GEL file
supplied with the Code Composer support from HUNT ENGINEERING so that
it reflects the actual processing module that you are using to connect
to your HEGD9. After starting Code Composer you must use the file menu's
" Load GEL" option to load the GEL file you have edited as above.

Execute the TIM_RESET function from the TIM FUNCTIONS menu that has
appeared. This will reset the processor and setup the DSPs memory 
ready for use.

Use the debug menu's Halt option to stop the processor. 

Load the program using the File menu's load file option, and do the
same for the symbols.

Use the Debug menus Go Main option.

Set a breakpoint at the line below the comment "Heres where we would..."
and use the view menu to select graph and time/frequency options.
In the options given select start address and set it to ch1_data, set
aquisition buffer size and display data size to 100, and set the
maximum Y-value to be 4096, DC value to 0x800 and DSP data type to
unsigned 32bit integer then click OK.

You can add watch points to some variables, the no_of_channels and
LowIsFirst are interesting ones.

Now every time the breakpoint triggers, the graph and watchpoints
will be updated with the values from channel 1 of the A/D.

Animating will give a continuously updating graph.

NOTICE !
--------
Every time a breakpoint happens the whole of the DSP stops.
This means that the reading from  the comport will stop
causing the FIFOs in the data path to overflow.

This example uses a flush function to ensure that all stale
data is removed from those FIFOs before taking real data.  

V 1.0 17-03-2000
