========================================================================
 TEXAS INSTRUMENTS, INC.

 C674x DSPLIB  DSP Signal Processing Library

     Release:        Version 1.1
     Snapshot date:  25-June-2009

 This library contains proprietary intellectual property of Texas
 Instruments, Inc.  The library and its source code are protected by
 various copyrights, and portions may also be protected by patents or
 other legal protections.

 This software is licensed for use with Texas Instruments TMS320
 family DSPs.  This license was provided to you prior to installing
 the software.  You may review this license by consulting the file
 TI_license.PDF which accompanies the files in this library.
------------------------------------------------------------------------
         Copyright (C) 2009 Texas Instruments, Incorporated.
                         All Rights Reserved.
========================================================================


This file contains a brief description of the DSP Library and how
to use it.

------------------------------------------------------------------------
Release Directory Structure
C:\CCStudio_v3.3\c674x
 |
 +--dsplib_v11
     |
     +--docs                Library documentation
     |
     +--example             Examples to show DSPLIB usage 
     |
     +--src                 Source code with CCS project examples
     |   |
     |   +--[Kernels]
     |
     |--dsplib674x.h        Header file containing kernel interface
     |                      header files
     |
     |--dsplib674x.lib      Precompiled library
     |
     |--dsplib674x.pjt      Provided project to rebuild library
     |
     |--README.txt          Top-level README file


------------------------------------------------------------------------
Using the DSP Library

There are really two ways the DSP Library can be used, one is from
within Code Composer Studio and the other is by using the command line
tools. In both cases, it's a matter of including the library header
file, linking to the correct build of the library, and calling the
APIs.

------------------------------------------------------------------------
Using the DSP Library in Code Composer Studio

1. First you have to specify to the linker to link the DSP Library
   into your application.  You do this by going to
   "Project->Options->Linker->Include Libraries" and then specify the
   DSP Library, dsplib674x.lib.

2. For each of your C files that you plan to use a DSP Library
   kernel in, you must include either the top-level DSPLIB header file,
   dsplib674x.h, or the individual kernel header.  For instance, to use
   the kernel "DSPF_sp_fir_gen()", you can simply include the kernel
   header src/DSPF_sp_fir_gen/DSPF_sp_fir_gen.h.  The top-level header
   file includes all of the kernel header files and enables the
   use of the entire DSPLIB.

3. Now you may use the DSP Library API at will.


------------------------------------------------------------------------
Using the DSP Library with the Command Line Tools

1. You have to tell the linker to link your application with the
   DSP library.  You can do this by using the linker -l option in
   your linker command file or at the linker command line, i.e
   -l dsplib674x.lib

2. For each of your C files that you plan to use a DSP Library
   kernel in, you must include either the top-level DSPLIB header file,
   dsplib674x.h, or the individual kernel header.  For instance, to use
   the kernel "DSPF_sp_fir_gen()", you can simply include the kernel
   header src/DSPF_sp_fir_gen/DSPF_sp_fir_gen.h.  The top-level header
   file includes all of the kernel header files and enables the
   use of the entire DSPLIB.


------------------------------------------------------------------------
How do I Re-Build the Library?

Open the top-level project file, dsplib674x.pjt.  Build the project to
create a new library file at Release\dsplib674x_rebuild.lib.

------------------------------------------------------------------------
Changes in release version: c674x_dsplib_v11

Bug Fixes
---------
- Corrected errors in lnk.cmd files for demo applications
- Updated several hand assemly files to properly place DSPLIB functions
  in segment ".text" instead of "text"
- Corrected function name typos in files DSPF_sp_fftSPxSP.h and
  DSPF_sp_ifftSPxSP.h
- Updated top-level header to use forward slashes (/) instead of back
  slashes (\) in paths
- Updated some header files to properly end with newlines (required by
  TI DSP codegen tools)
- Corrected IIR natural C cycle count in performance spreadsheet

Enhancements
------------
- Added call_dsplib application in example folder
- Miscellaneous improvements to several *_d.c files
- Enabled full symbolic debug in all *_d.c files


------------------------------------------------------------------------
End of README.TXT