ADSP-21020/ADSP-21062 Example Real-Time Programs
------------------------------------------------

This software assumes the following:

Analog Devices C compiler release 3.1 or greater
Analog Devices EZ-LAB board for the ADSP-21020 or
Analog Devices EZ-LAB board for the ADSP-21060/21062 (SHARC) with
MAFE soundport board.

This directory contains all of the C source code, make files
(*.MAK), batch files (*.BAT) and other files required for the
ADSP-21020 EZ-LAB board.  If you want to use the programs with
the ADSP-21020, copy the contents of this directory to your hard
disk and then use the make files or batch files to compile the
programs.

The SHARC sub-directory contains make files (*.MAK) and other
files required for the ADSP-21062 (SHARC) EZ-LAB hardware.  If
you want to use the programs with the ADSP-21062, first copy the
contents of this directory to your hard disk and then copy the
SHARC sub-directory to the same location on your hard disk.

The name of the G21K output DSP executables have a ".EXE" extension.
These are not IBM-PC executables.

If you have the ICE21K emulator from Analog Devices then you can debug
and run these programs using the make files as is.  If you do not
have the ICE then you must change the ICE21K command in the make file
to a loader command which will load the executable onto your hardware.
Note that because some make utilities are not compatible with ICE21K,
you may need to type the ICE21K command line in manually.

REAL-TIME PROGRAM NOTES
-----------------------

The following describes the real-time aspects of the programs in
this directory:

 Make File     Executable
   Name        File Name
------------  ------------
EQ.MAK        EQUALIZ.EXE    Change EQ settings by changing the 7 element
                             _gain array. gain[0] is lowest frequency and
                             gain[6] is the highest frequency band. A value
                             of 3 in gain will cause a boost of 12 dB.

G722_21F.MAK  G722MAF.EXE    Floating-point version.  Encodes and decodes
                             "chicken little" and then requires a real-time
                             input for encode/decode.

G722_21K.MAK  G722MAIN.EXE   Fixed-point version.  Encodes and decodes
                             "chicken little" and then requires a real-time
                             input for encode/decode.

IOUT21K.MAK   INTOUT.EXE     Simple Interupt C routine.  Requires ICE21K.

MKGWN.MAK     MKGWN.EXE      Noise filtering with sine wave example.
                             Filter turns on and off every second.

MU21K.MAK     MU21K.EXE      Plays a 6 voice song.

MULAW.MAK     MULAW.EXE      Encodes and decodes G711 (mu-law) speech
                             compression.  Setting _bypass to 1 will
                             pass the signal without compression.  Requires
                             a real-time input for encode/decode.

OSC21K.MAK    OSC21K.EXE     Plays a tone which drops in frequency.

PS.MAK        PSHIFT.EXE     Pitch shift using poly-phase filter.  Requires
                             a real-time input.  Every 4 seconds the pitch
                             shift key increases one semi-tone from -6 to 12.

RF21K.MAK     RFAST21.EXE    FFT based filtering; requires a real-time input.
                             Filter turns on and off every second.

WAVETAB.MAK   WAVETAB.EXE    Wave table music synthesis. Plays a scale from
                             key -12 to 47.