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-21060/21062 (SHARC)
with MAFE Soundport board.

This directory contains all of the make files (*.MAK), batch
files (*.BAT) and other files required for the ADSP-21060 EZ-LAB
board.

If you want to use the programs with the ADSP-21062, first copy
the contents of the ADSP21K directory to your hard disk and then
copy this sub-directory to the same location on your hard disk.

The name of the G21K output DSP executables have a ".21K"
extension and can be loaded and debugged using the DIAG21K
program provided with the EZ_LAB board or they can be renamed
with a ".EXE" extension and used with the ICE.

The make files (*.MAK) or batch files (*.BAT) will create DSP
executables with a ".21K" extension and will automatically be
loaded using the DIAG21K program.  The user can start the
programs using the "PS" command and then change parameters (any
global variable defined in the C programs) while the ADSP-21062
DSP program is running using the DIAG21K memory commands.

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.21K    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.21K    Floating-point version.  Encodes and decodes
                             "chicken little" and then requires a real-time
                             input for encode/decode.

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

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

MU21K.MAK     MU21K.21K      Plays a 6 voice song.

MULAW.MAK     MULAW.21K      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.21K     Plays a tone which drops in frequency.

PS.MAK        PSHIFT.21K     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.21K    FFT based filtering; requires a real-time input.
                             Filter turns on and off every second.

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