examples.txt

使用在TI DSP c54xx系列的 xdaix

NOTE:
The files that do not have _<board> correspond to the default target.

The following directories, firtest and figtest contain the complete
implementations of two algorithm examples, FIR and FIG.  The FIR
example implements an FIR filter.  The FIG example implements 
a "filter group".  A filter group is simply a group of filters
that share the same filter coefficients.

The FIR example is entirely independent of the FIG example.  Thus, it
is possible to create programs that use FIR without bringing any of
the FIG code (or FIG headers).  

FIG is also independent of FIR, but it is designed to be used in
conjunction with FIR.  FIG allows one to share the read-only
coefficient data among multiple FIR instances.  Of course, it is also
possible to create a static array of coefficients, pass them to
multiple FIR objects, and avoid the use of FIG.  However, FIG
illustrates a valuable design technique that allows one to virtually
eliminate all static data from a system.

In the FIR example, we define an IFIR interface which "derives" from
IALG.  The FIR_TI module implements the following interfaces:
	IFIR - the FIR filter interface
	IALG - the XDAS IALG interface (because IFIR derives from IALG)

The FIG example implements a "filter group".  A filter group is simply
a group of filters that share the same filter coefficients.  We've
defined an IFIG interface and the FIG_TI module implements the
following interfaces:
	IFIG - the Filter Group interface
	IALG - the XDAS IALG interface (because IFIG derives from IALG)

These directories also contain test programs that illustrate how
these algorithms are created, used, and deleted.

    firtest -  illustrates how to use a generic FIR interface to 
               create, apply, and delete a FIR filter without being
               tied to any particular FIR implementation.

    firtest1 - illustrates how an application might use vendor
               specific extensions to the "generic" FIR interface.

    figtest -  illustrates how the FIG interface can be used to
               create (and run) multiple FIR instances with the same
               read-only coefficients.

To build these programs you should build the api and algorithm
libraries first.  The following shows different methods to build
the firtest and figtest programs:
	1.  Building programs from the command line.
            a.  From the command line if you type 'gmake' in any firtest
                or figtest example this will build all the necessary 
                libraries and the program in the current directory.

	2.  Building programs with Code Composer Studio.
            a.  Launch Code Composer
            b.  Select Project->Open
            c.  Open a Code Composer project (.pjt) file from any
                firtest or figtest directory.
            d.  Select Project->Rebuild All