

Adaptive Noise Cancellation using Intel(R) IPP 


Readme.txt 


/***********************************************************
Readme for the Adaptive Noise Cancellation Sample Code for 
Intel(R) Integrated Performance Primitives 


03/12/2003
***********************************************************/

Description

Demonstrates the following IPPs:

1. LMS FIR Adaptive filter
2. Gaussian noise generation
3. Miscellaneous vector manipuations

IMPORTANT:  This example is intended only to demonstrate
the usage of the IPP LMS adaptive filter in an interesting
application.  For noise cancellation in real and typically
demanding applications, please use the building blocks 
provided in the IPP general audio signal processing package.  

An effort has been made to keep the software in the ANSI C 
style whenever possible. Although Intel(R) IPP sample code 
has been tested, no warranty, expressed or implied is to be 
associated with these functions as well as all the associated 
materials in this package. All risk assumed is by the user. 
See the Intel(R) Integrated Performance Primitives License 
Agreement for details.

-------------------------------------------------------------------------------

Usage

1. The default output path is the same as the makefile and 
   source code

2. Type the application name -help (e.g., ANCdemo --help) to 
   obtain a listing of command-line options.

3. Once the application is running, type h <Return> for a 
   listing of the available real-time processing commands.

4. The example provides real-time controls on:
    - select clean singal for output
    - select signal + noise input for output
    - select ANC enhanced signal for output
    - change noise power (standard deviation) 

5. Use -a to force audio device input/output, otherwise use
   file I/O.

6. Input can be from a file or from the audio device.  See 
   code for details.

7. Output will go to the audio device by default (if available) 
   otherwise you must supply an output filename on the command 
   line.  

8. The output file format is raw binary, 16-bits per sample

9. Sample rate is fixed to 8kHz -- see code for details.

-------------------------------------------------------------------------------

Known Problems

The audio device output of raw PCM stream may not function well.

-------------------------------------------------------------------------------

Changes Since Last Release

None

-------------------------------------------------------------------------------

License Definitions

Please refer to the Intel(R) Integrated Performance Primitives 
license file for the license agreement details.

-------------------------------------------------------------------------------

Information in this document is provided in connection with 
Intel(R) products. No license, express or implied, by estoppel 
or otherwise, to any intellectual property rights is granted by 
this document. Except as provided in Intel's Terms and Conditions 
of Sale for such products, Intel assumes no liability whatsoever, 
and Intel disclaims any express or implied warranty, relating to sale 
and/or use of Intel products including liability or warranties relating 
to fitness for a particular purpose, merchantability, or infringement 
of any patent, copyright or other intellectual property right. Intel 
products are not intended for use in medical, life saving, or life 
sustaining applications. 

Intel may make changes to specifications and product descriptions 
at any time, without notice.

Designers must not rely on the absence or characteristics of any 
features or instructions marked "reserved" or "undefined." Intel 
reserves these for future definition and shall have no responsibility 
whatsoever for conflicts or incompatibilities arising from future 
changes to them.

Contact your local Intel sales office or your distributor to obtain 
the latest specifications and before placing your product order.

Copies of documents which have an ordering number and are referenced 
in this document, or other Intel literature may be obtained by 
calling 1-800-548-4725 or by visiting Intel's website at 
http://www.intel.com.

Copyright (c) Intel Corporation, 2003

Intel and Intel XScale are trademarks or registered trademarks of Intel 
Corporation or its subsidiaries in the United States or other countries.

* Other brands and names are the property of their respective owners.
