Automatic Gain Control Library
Contents
1. 3 10 LO e N o N II LES ESCAI RE Y B m L ry LJ HIVED I ARC IICONDUCTOR Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 4 Building the Automatic Gain Control Library 4 1 Building the Automatic Gain Control AGC Library The AGC Library combines all of the components described in previous sections into one library agc lib To build this library a Metrowerks CodeWarrior project agc mcp is provided This project and all the necessary components to build the AGC Library are located in the nos telephony age directory of the SDK directory structure There are two methods to execute a system library project build dependency build and direct build 4 1 1 Dependency Build Dependency build is the easiest approach and requires no additional work on the user s part If you add the AGC Library project agc mcp to your application project as shown in Figure 4 1 the AGC Library will automatically build when the application is built Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE MOTOROLA Building the Automatic Gain Control Library 4 1 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCAL2. Go to www freescale com MOTOROLA Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE Specifications Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Call to AGC Init agcInit amp pAGC res FAAZS89SdSC 0L0z Jequieydes 0 Joud sejejs peju eu ui ejes JO JIOdUUI 10J 9 e2s8944 WO ejqe ie e jou oje pueuno eJeu pejeoipui saequunu wed pue saul jonpojd peBexoed vog uoissiuuo ape jeuoneujJeju sejejs paun eui WO JepJo ue Jo esneoeg S002 ONI YOLONGNOOIWNAS 31V9S33 4 A8 Q3AIHOSNHV Automatic Gain Control Library Interfaces 3 7 For More Information On This Product MOTOROLA Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Automatic Gain Control LOSSES le Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 3 3 3 agcProcess Call s Result agcProcess agc_sHandle pAGC Wordl6 pInputSample Wordl6 pOutputSample UWordl6 NumSamples Required Header agc h Arguments Table 3 2 agcProcess Arguments pAGC in Handle to an instance of AGC plnputSample in Pointer to the input sample buffer pOutputSample out Pointer to the output sample buffer NumSamples in Number of samples in the input buffer Description T
3. agcCreate void agc_sHandle pAgc Result res Memory allocation for Handle pAgc agc_sHandle memMallocIM sizeof agc sHandle if pAgc NULL return NULL res agcInit pAgc Initialize the AGC variables return pAgc For details on the agc_sHandle structure please refer to Code Example 3 1 If the agcCreate function is called to create an instance then agcDestroy see Section 3 3 4 should be used to destroy the instance Alternatively the user can allocate memory statically which requires duplicating all statements in the agcCreate function In this case the user can call the agclnit function directly bypassing the agcCreate function If the user dynamically allocates memory without calling agcCreate then the user himself must destroy the memory allocated Returns Upon successful completion the agcCreate function will return a pointer to the specific instance of AGC created If agcCreate is unsuccessful for any reason it will return NULL 3 4 Automatic Gain Control Library MOTOROLA For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc AR
4. loose ocu er ohh n o 0 RL PTT Chapter 1 Introduction 1 1 SE SIME ioa hee ordo Eh doe Rd EE O O adeb O do pl breed 12 Overview of Automatic Gain Control zs eva ses REOR h dek RR n 1 2 1 Cow cuo MT mre 122 Pontes And POCHE iusso peso Sr sd Diete Did P E p UPS Qe qu Chapter 2 Directory Structure 24 Required Core Directories 4422495440445 R3ATYASEITERUPEREL ESTA UPPER pU 2 4 Optional Domain Specific Directories isses eee e E Rh nh n Chapter 3 Automatic Gain Control Library Interfaces 3 1 Automatic Gain Control AGC Services ccc eee eee 3 2 ioo PO ee O V O O eee rrr esse k KL AOR i ue ea oo doe CC dr ae 3l RES i ee ee ee ee ene E EEEE d ee Eq Ea 3 3 2 SEED ETEESI Ea RR Edidi EEATT SENTETE ETTE Eiee PU E MEER 0 A EN EEEE 3 3 4 o SDE na Marr Chapter 4 Building the Automatic Gain Control Library 4 1 Building the Automatic Gain Control AGC Library 0 4 1 1 Dependency Dl sszeossuk lac bass ee nears dak ss ENTE ES 4 1 2 Direct BONG PDC DOTT MOTOROLA Table of Contents For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc A
5. parameters which may be provided in Motorola data sheets and or specifications can and do vary in different applications and actual performance may vary over time All operating parameters including Typicals must be validated for each customer application by customer s technical experts Motorola does not convey any license under its patent rights nor the rights of others Motorola products are not designed intended or authorized for use as components in systems intended for surgical implant into the body or other applications intended to support or sustain life or for any other application in which the failure of the Motorola product could create a situation where personal injury or death may occur Should Buyer purchase or use Motorola products for any such unintended or unauthorized application Buyer shall indemnify and hold Motorola and its officers employees subsidiaries affiliates and distributors harmless against all claims costs damages and expenses and reasonable attorney fees arising out of directly or indirectly any claim of personal injury or death associated with such unintended or unauthorized use even if such claim alleges that Motorola was negligent regarding the design or manufacture of the part Motorola and the Stylized M Logo are registered trademarks of Motorola Inc Motorola Inc is an Equal Opportunity Affirmative Action Employer MOTOROLA and the Stylized M Logo are registered in the US Patent amp Trademark Of
6. 0x000000 LENGTH 0x000082 pIntRAM RWX ORIGIN 0x000082 LENGTH 0x00177e PEXtRAM RWX ORIGIN 0x001800 LENGTH 0x1EE800 MOTOROLA Linking Applications with the Automatic Gain Control Library 5 1 For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Linking Applications with Eresssalasemicanductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 pIntROM RX ORIGIN 0x1F0000 LENGTH 0x000400 xIntRAM RW ORIGIN 0x000000 LENGTH 0x000800 xIntRAM DynamicMem RW ORIGIN 0x000800 LENGTH 0x000800 xStack RW ORIGIN 0x001000 LENGTH 0x000800 XExtRAM_DynamicMem RW ORIGIN 0x001800 LENGTH 0x001000 XExtRAM RW ORIGIN 0x002800 LENGTH 0x1FD400 xPeripherals RW ORIGIN 0x1FFC00 LENGTH 0x000400 xExtRAM2 RW ORIGIN 0x200000 LENGTH OxDFFF00 xCoreRegisters RW ORIGIN OxFFFF00 LENGTH 0x000100 Pk k kk k Ck kk k kk ko k kk kk kk kk k k kk kk k k kk kk k k kk kA X Ak k k k kA X A k k k k AXA k k k kk FORCE ACTIVE FconfigInterruptVector HKK KKK kok k ck kk k kk k kk
7. DSP56852VFE F_Xbss_length X BSS ADDR Copy DATA gt xExtRAM MOTOROLA Linking Applications with the Automatic Gain Control Library 5 3 For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Linking Applications with Fraescale semicanductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 eK kokokok kok k k k kok k k kok k k kK k k K kK k k ke kk k kok kk kk k k kok k kok k A k k I k kk k kkk k k kk kkk I kok FArchlO 0x0000 FArchCore ADDR xCoreRegisters FArchInterrupts ADDR pInterruptVector 5 4 Automatic Gain Control Library MOTOROLA For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 6 Automatic Gain Control Applications 6 1 Test and Demo Applications To verify the Automatic Gain Control AGC algorithm test and demo applications have been developed Refer to the Targeting Motorola DSP568xx Platform Manual for the DSP you are using to see if the test and demo applications are available for your target MOTO
8. September 2010 DSP56852VFE Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 FAAZS89SdSC 0L0z Jequieydes 0 Joud sejejs peju eu ui ejes JO JIOdUUI 10J 9 e2s8944 WO ejqe ie e jou oje pueuno eJeu pejeoipui saequunu wed pue saul jonpojd peBexoed vog uoissiuuo ape jeuoneujJeju sejejs paun eui WO JepJo ue Jo esneoeg S002 ONI YOLONGNOOIWNAS 31V9S33 4 A8 Q3AIHOSNHV MOTOROLA Automatic Gain Control Library For More Information On This Product Go to www freescale com Xii ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 1 Introduction Welcome to Motorola s Family of Digital Signal Processors DSPs This document describes the Auto matic Gain Control AGC Library which is a part of Motorola s comprehensive Embedded Software Development Kit SDK for its DSPs In this manual you will find all the information required to use and maintain the Automatic Gain Control Library interface and algorithms Motorola provides these algorithms to you for use on Motorola DSPs to expedite your application develop ment and reduce the time it takes to bring your own products to market Motorola s Automatic Gain Control Library is licensed for your use on Motorola processors Please refer to the standard Software License Agreement in Chapter 7 for license terms and conditions please consult with your Motorola repres
9. a writing signed by both parties Licensee agrees to jurisdiction and venue in the State of Arizona By using modifying installing compiling or copying the Software Licensee acknowledges that this Agreement has been read and understood and agrees to be bound by its terms and conditions Licensee agrees that this Agreement is the complete and exclusive statement of the agreement between Licensee and Motorola and supersedes any earlier proposal or prior arrangement whether oral or written and any other communications relative to the subject matter of this Agreement 7 2 Automatic Gain Control Library MOTOROLA For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Index A AGC x Automatic Gain Control x API x Application Programming Interface x asm source 2 3 C c sources 2 3 COMI x Communication Port 1 x D Dependency Build 4 1 Direct Build 4 2 DSP x Digital Signal Processor x E EVM xi Evaluation Module xi G G 165 Services 3 1 g165Create 3 4 g165lnit 3 6 g165Process 3 8 VO xi Input Output xi IDE xi MSB xi Most Si
10. available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 on the difference in the input signal level and in the reference level If the input level is lower higher than the reference the gain value is incremented decremented accordingly as depicted in Figure 1 1 Introduction Input sample Output sample _ Gain Estimate Figure 1 1 Functional Blocks of Automatic Gain Control Library 1 2 2 Features and Performance The Automatic Gain Control Library is multichannel and re entrant For details on Memory and MIPS for a particular DSP refer to the Libraries Chapter of the appropriate Targeting manual 1 2 Automatic Gain Control Library MOTOROLA For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 2 Directory Structure Note DSP568xx refers to the specific device for which you re developing as shown in Chapter 1 Introduction 2 1 Require
11. kk kk kk kk k kk k kk k kk k k k kk kA X Ak KA k kA X A k k k k AKA kk k kk a ECTIONS EK RK A k k k kk k k kk k kk kk k kok k k kk kk k kk kA k kk k k kk kk kk kk k kk k kk kk k k kk I kok ApplicationInterruptVector vector c text gt pInterruptVector JENCKCKCKCkC Kk Rk k kk k eA A A kk kk kk k kk k k ko I A A ke A k IA A kk k A I A IK ApplicationCode HE Place all code into Program RAM text rtlib text fp_engine text user text x Place all data into Program RAM F_Pdata_start_addr_in_ROM 0 F_Pdata_start_addr_in_RAM pramdata c data F_Pdata_ROMtoRAM_length 0 F Pbss start addr P BSS ADDR pramdata c bss F Pbss length P BSS ADDR gt pExtRAM EK KA k k k kk kk kk k kk kk A eA A kk kk kk k kk kk k A A A A AA KA A He IK ke 5 2 Automatic Gain Control Library MOTOROLA For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor HRS Control AGC Library ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 ApplicationData Define variables F Xdata start add
12. An inout argument means that a parameter value is an input to the function but the same parameter is also an output from the function Typically inout parameters are input pointer variables in which the caller passes the address of a preallocated data structure to a function The function stores its results within that data structure The actual value of the inout pointer parameter is not changed MOTOROLA Automatic Gain Control Library Interfaces 3 3 For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Automatic Gain Control bregscale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 3 3 1 agcCreate Call s agc_sHandle agcCreate void Required Header agc h Arguments None Description The agcCreate function creates an instance of AGC Multiple instances are possible During the agcCreate call any dynamic resources required by the AGC algorithm are allocated each call of agcCreate allocates four words of internal data memory The library allocates dynamic memory using the mem library routines shown in Code Example 3 2 Code Example 3 2 mem Library include agc h include mem h agc_sHandle
13. CHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Special Considerations e The AGC application is multichannel and re entrant Specifications e If agcCreate is called then the user need not call the agcInit function which is called internally in the agcCreate function Code Example In Code Example 3 3 the application creates an instance of AGC Code Example 3 3 Use of the agcCreate Interface include assert h include mem h include agc h define FRAME_LEN 80 Wordl6 input sample FRAME T7 a d m Wordl6 output sample FRAME LEN void main void agc_sHandle pAGC Result res AGC handle instance PAGC agcCreate if pAGC NULL assert Out of Memory Get FRAME LEN number of samples into input sample buffer res agcProcess pAGC input sample output sample FRAME LEN agcDestroy pAGC if res FAIL assert Buffers could not be flushed return For details on structures used in Code Example 3 3 see Code Example 3 1 MOTOROLA Automatic Gain Control Library Interfaces For More Information On This Product Go to www freescale com 3 5 Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICON
14. DUCTOR INC 2005 Automatic Gain Control LOSSES le Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 3 3 2 agclnit Call s Result agcInit agc_sHandle pAGC Required Header agc h Arguments Table 3 1 agclnit Arguments pAGC in Handle to an instance of AGC Description The agc nit function will initialize the AGC algorithm During initialization each resource will be set to its initial values in preparation for AGC operation Before calling the agc nit function an AGC instance must be created either by calling the agcCreate function see Section 3 3 1 or by statically allocating memory which does not require calling the agcCreate function Returns Upon successful completion a value of PASS will be returned otherwise a value of FALSE will be returned Special Considerations e If agcCreate is called then the user need not call the agcInit function which is called internally in the agcCreate function Code Example In Code Example 3 4 the application creates an instance of AGC The instance is passed to agcInit Code Example 3 4 Use of agclnit Interface include agc h Note This example shows the use of agcInit function when the user does not use agcCreate function define FRAME LEN 80 agc sHandle pAGC Allocate AGC handle void main Result res 3 6 Automatic Gain Control Library For More Information On This Product
15. E Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 FAAZS89SdSC 0L0z Jequieydes 0 Joud sejejs peju eu ui ejes JO JIOdUUI 10J 9 e2s8944 WO ejqe ie e jou oje pueuno eJeu pejeoipui saequunu wed pue saul jonpojd peBexoed vog uoissiuuo ape jeuoneujJeju sejejs paun eui WO JepJo ue Jo esneoeg S002 ONI YOLONGNOOIWNAS 31V9S33 4 A8 Q3AIHOSNHV MOTOROLA Go to www freescale com Automatic Gain Control Library For More Information On This Product viii ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 About This Document This manual describes the Automatic Gain Control AGC algorithm for use with Motorola s Embedded Software Development Kit SDK Audience This document targets software developers implementing the AGC functions within software applications Organization This manual is arranged in the following sections Chapter 1 Introduction provides a brief overview of this document Chapter 2 Directory Structure provides a description of the required core directories Chapter 3 Automatic Gain Control Library Interfaces describes all of the Automatic Gain Control Library functions Chapter 4 Building the Automatic Gain Control Library tells how to execute the system library project build Chapter 5 Linking Applications with the Automatic Gain Control Library describes organization of the Automatic
16. E SEMICONDUCTOR INC 2005 Building the Automatic ohreesgale emiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Taten ESTE External RAM BY Ww A Files Link Order Targets g File e taa ES amp EE Dependencies 0 m H SDK Configuration 0 m E a SDK Projects 0 0 A 2 bsp mcp n a na m rm sys mcp n a n a a m tools mcp n a nia m n a na m v 3 SDK Libs 0 0 a w MSL 56800E 0 mM OEC Sources 0 0 m g m tmain c 0 0 m A M testAGC c 0 0 H 18 files 0 0 Z Figure 4 1 Dependency Build for the Automatic Gain Control Library 4 1 2 Direct Build Direct build allows you to build an AGC Library independently of any other build Follow these steps Step 1 Open agc mcp project as shown in Figure 4 2 B agc mcp o BY SSB Files Link Order Targets HH amp EESIASM Sources o MS Ee B agc asm n 1x agc equ asm c A L AW agc offsets asm 0 Ca ESAPI be co 2 ji agc_create c r 1x be R agc init c lis bi L4 Aj agc destrov c L TM 6 files 117 0 7 Figure 4 2 agc mcp Project Step 2 Execute the build by pressing function key F7 or by choosing the Make command from the Project menu see Figure 4 3 4 2 Automatic Gain Control Library For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently ar
17. E SEMICONDUCTOR INC 2005 2 2 Optional Domain Specific Directories Directory Structure Figure 2 2 demonstrates how the AGC algorithm is encapsulated in the domain specific directories under the directory telephony which includes telephony specific algorithms dsp568xxevm CH nos F applications I bsp F config Am include I modem LJ multimedia I security Hil signal Husi speech I sys __ telephony aec EX Hy caller_id Hi cas detect I cidparse LJ cidtype1 Hag cidtype12 Hag cpt Hi ctg HI dtmf det Ha dtmf gen Zu fdspk HC 9165 H g168 Hill 9711 CH g723 g726 J gec Hz vad HY vad mi tools EH AE E 4 He Ht Ht EHE E 4 4 4 Figure 2 2 Telephony Directory Structure 2 2 Automatic Gain Control Library MOTOROLA For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor M sin specitic Directories ARCHIVED BY FREESCA
18. Freescale Semiconductor Inc o M IC C JN DUCTOR IN 4 MOTOROLA Embedded SDK Software Development Kit Automatic Gain Control Library SDK150 D Rev 3 07 16 2002 ef H s mworonoLA digital dna Motorola Inc 2002 All rights reserved intelligence everywhere For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 FAAZS89SdSC 0L0z Jequieydes 0 Joud sejejs peju eu ui ejes JO JIOdUUI 10J 9 e2s8944 WO ejqe ie e jou oje pueuno eJeu pejeoipui saequunu wed pue saul jonpojd peBexoed vog uoissiuuo ape jeuoneujJeju sejejs paun eui WO JepJo ue Jo esneoeg S002 ONI YOLONGNOOIWAS 31V9S33 ld A8 Q3AIHOSNV For More Information On This Product Go to www freescale com ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Contents About This Document ANE L 4234 49983 ee eee ee Ed ak k MOS n bodn Ts 41 width RERO ee Shwe ee EG RnB ee os eee d OR et Suggested Bandi 645 43udAt bbsAXAdEAALAS de eae sends baedea RE d RR EA deno oo Penn Definitions Acronyms and Abbreviations 2
19. Gain Control Library Chapter 6 Automatic Gain Control Applications describes the use of Automatic Gain Control Library through test demo applications Chapter 7 License provides the license required to use this product Suggested Reading We recommend that you have a copy of the following references DSP56852 Family Manual DSP56852FM AD DSP568xx User s Manual for the DSP device you re implementing Inside CodeWarrior Core Tools Metrowerks Corp MOTOROLA Preface ix For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Conventions This document uses the following notational conventions Typeface Symbol Meaning Examples or Term Courier Commands command Foundational include files Monospaced Type parameters code examples a data structure of type vad tConfigure expressions datatypes and directives Italic Calls functions statements the pConfig argument seen laa 7 defined in the C header file aec h arguments file names an applications makes a call to the Callback procedure B
20. LE SEMICONDUCTOR INC 2005 Figure 2 3 shows the agc directory structure under the telephony directory EH dsp568xxevm mm ag applications I bsp Ha config His include ag modem Hag security signal LY speech I sys 4 telephony x fll aec 29 APIs Am asm sources test c_sources L configextram i io H H caller id EHSEFHEH HREHRFHFHTE Figure 2 3 agc Directory Structure The agc directory includes the following sub directories e APIs includes C APIs for Automatic Gain Control asm sources includes all asm sources required for Automatic Gain Control e fest includes C sources and configuration necessary for testing Automatic Gain Control Library modules c sources contains an example test code configextram contains configuration files appconfig c appconfig h and linker cmd specific to Automatic Gain Control io contains input and reference test files The applications directory includes high level software that exercises the Automatic Gain Control Library As shown in Figure 2 4 the applications directory contains the agc application under telephony MOTOROLA Directory Structure 2 3 For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged prod
21. RCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 5 Linking Applications with the Automatic Gain Control Library ad Automatic Gain Control AGC Library iss reu oxeTrTueer xw Y EE ETT SL M rl o PPM Chapter 6 Automatic Gain Control Applications 6 1 Test and Demo Applications 244455540 s44e cesses EE A WEE EREHE 30r Ad Chapter 7 License T4 Limited Lise License Agreement 42 keys sceeeree tees HS S404 rr RETS ii Automatic Gain Control Library For More Information On This Product Go to www freescale com MOTOROLA Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 List of Tables Table 3 1 PEC APOS oo4s e daz E ERAS RE RREEZKERRASRPS ERE PERKE REA ARP UEM 3 6 Table 3 2 a Are Ca 22 1 163920 ES 3B HERE ERO E EROR OE ER E PS 3 8 Table 3 3 asc Dod DEGERE o ro i eO DIEI o ed RHOD READER RH Ut 3 9 MOTOROLA List of Tables iii For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the Uni
22. ROLA Automatic Gain Control Applications 6 1 For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ductor Inc icon ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 reescale Sem F pp Automatic Gain Control A FAAZS89SdSC 0L0z Jequieydes 0 Joud sejejs peju eu ui ejes JO JIOdUUI 10J 9 e2s8944 WO ejqe ie e jou oje pueuno eJeu pejeoipui saequunu wed pue saul jonpojd peBexoed vog uoissiuuo ape jeuoneujJeju sejejs paun eui WO JepJo ue Jo esneoeg S002 ONI YOLONGNOOIWNAS 31V9S33 4 A8 Q3AIHOSNHV MOTOROLA Automatic Gain Control Library For More Information On This Product Go to www freescale com 6 2 ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 7 License 7 1 Limited Use License Agreement LIMITED USE LICENSE AGREEMENT PLEASE READ THIS AGREEMENT CAREFULLY BEFORE USING THIS SOFTWARE BY USING OR COPYING THE SOFTWARE YOU AGREE TO THE TERMS OF THIS AGREEMENT The software in either source code form Source or object code form Object cumulatively hereinafter Software is provided under a license agreement Agreement as described herein Any use of the Soft
23. d Core Directories Figure 2 1 details required platform directories CT dsp568xxevm FH nos applications a bsp I config include H modem H multimedia 2 security signal speech Hi sys 1 telephony tools Figure 2 1 Core Directories fe HEH EH ME In this example the DSP568xxEVM has a no operating system nos support directory This platform contains the following core directories e applications contains applications software that can be exercised on this platform e bsp contains board support package specific for this platform config contains default hardware and software configurations for this platform include contains SDK header files which define the Application Programming Interface e sys contains required system components e tools contains utilities used by system components There are also optional directories that include domain specific libraries MOTOROLA Directory Structure 2 1 For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCAL
24. e not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor ING control AGC Library ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Metrowerks CodeWarrior Proj eC Aad S nier m test agc mcp BSE ieraetes External RAM TE SEGMEN WHEN EY scompie EE Dependencies iu NE Biles v H DK Configu Disassemble Eit esi rien SDK Project o n 7 F7 Ap BUG LET BT ea v A 2e SDK Libs v EC MSL 56800E E a C Sources E test GC c Ta DIT Figure 4 3 Execute Make At this point if the build is successful an agc lib library file is created in the nos telephony agce Debug directory MOTOROLA Building the Automatic Gain Control Library 4 3 For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Building the Automatic ohreesgale emiconductor Inc FAAZS89SdSC 0L0z Jequieydes 0 Joud sejejs peju eu ui ejes JO JIOdUUI 10J 9 e2s8944 WO ejqe ie e jou oje pueuno eJeu pejeoipui saequunu wed pue saul jonpojd peBexoed vog uoissiuuo ape je
25. entative for premium product licensing 1 1 Quick Start Motorola s Embedded SDK is targeted to a large variety of hardware platforms To take full advantage of a particular hardware platform use Quick Start from the appropriate Targeting Motorola DSP568xx Platform documentation For example the Targeting Motorola DSP56852 Platform manual provides more specific information and examples about this hardware architecture If you are developing an application for an DSP56852EVM board or any other DSP56852 development system refer to the Targeting Motorola DSP56852 Platform manual for Quick Start or other DSP56852 specific information Note DSP568xx refers to the specific device for which you re developing as shown in the preceding example 1 2 Overview of Automatic Gain Control 1 2 1 Background The AGC algorithm maintains the input signal level within a desired range The mean square level of the input signal is tracked and based on this a decision is made to scale up down the signal or to switch off the AGC The scaling factor or gain is applied to the input signal if the AGC is within the desired range otherwise the gain is not applied to the signal The gain value is updated based MOTOROLA Introduction 1 1 For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not
26. fice All other product or service names are the property of their respective owners Motorola Inc 2002 How to reach us USA EUROPE Locations Not Listed Motorola Literature Distribution P O Box 5405 Denver Colorado 80217 1 303 675 2140 or 1 800 441 2447 JAPAN Motorola Japan Ltd SPS Technical Information Center 3 20 1 Minami Azabu Minato ku Tokyo 106 8573 Japan 81 3 3440 3569 ASIA PACIFIC Motorola Semiconductors H K Ltd Silicon Harbour Centre 2 Dai King Street Tai Po Industrial Estate Tai Po N T Hong Kong 852 26668334 Technical Information Center 1 800 521 6274 HOME PAGE http www motorola com semiconductors MOTOROLA For More Information On This Product SDK150 D Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE
27. gnificant Bit xi O OMR xi Operating Mode Register xi OnCE xi On Chip Emulation xi P PC xi Program Counter xi S SDK xi Software Development Kit xi SP xi Stack Pointer xi SPI xi Serial Peripheral Interface xi SR xi Status Register xi SRC xi Source xi T telephony 2 2 algorithms 2 2 test_g165 2 3 Integrated Development Environment xi IRQA xi Interrupt Request A xi L Linking Applications 5 1 M MAC xi Multiply Accumulate xi Metrowerks CodeWarrior 4 1 MIPS xi Million Instructions Per Second xi MOTOROLA Index For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Motorola reserves the right to make changes without further notice to any products herein Motorola makes no warranty representation or guarantee regarding the suitability of its products for any particular purpose nor does Motorola assume any liability arising out of the application or use of any product or circuit and specifically disclaims any and all liability including without limitation consequential or incidental damages Typical
28. he agcProcess function monitors input signal power to decide whether or not to switch AGC on Output signal power is tracked with respect to the reference level 18 dBm and the fine gain is adjusted adaptively on a sample by sample basis Input signal power should be in the range of 35 dBm to 0 dBm The output signal is maintained in the range 26 dBm to 9 dBm The AGC switches off if the input signal power is less than 35 dBm The user can call the agcProcess function any number of times as long as there is data Returns Upon successful completion agcProcess returns PASS if there is any error agcProcess returns FAIL Special Considerations None Code Example See Code Example 3 3 to learn how to use the agcProcess function 3 8 Automatic Gain Control Library MOTOROLA For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 3 3 4 agcDestroy Call s Specifications void agcDestroy agc_sHandle pAGC Required Header agc h Arguments Table 3 3 agcDestroy Arguments pAGC in Handle to an instance of AGC generated by a call t
29. in Control AGC Services The AGC library controls the gain of the input speech signal The data to be supplied must be in 16 bit word fixed point 1 15 format as shown below MSB LSB i information bit s sign bit 3 2 Interface The C interface for AGC services is defined in the C header file agc h shown in Code Example 3 1 Code Example 3 1 C Header File agc h ifndef AGC H define AGC H This include file is the master include file for the Automatic Gain Control The applications using AGC should include this file ORK kok ok k kok k k kok k k k kok k kok k KK I Foundational Include Files FAK AK A KA kA k k kk k include port h MOTOROLA Automatic Gain Control Library Interfaces 3 1 For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Automatic Gain Control Libcsessale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 S EEK K KKK KKK KKK A oko ok I k K k k K k k k k k k k ke ke ke ke ke k ek Structure for AGC Fe KAKA A A A AA AA A HH He He IH AGC handle structure This struct
30. lable from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 FAAZS89SdSC 0L0z Jequieydes 0 Joud sejejs peju eu ui ejes JO JIOdUUI 10J 9 e2s8944 WO ejqe ie e jou oje pueuno eJeu pejeoipui saequunu wed pue saul jonpojd peBexoed vog uoissiuuo ape jeuoneujJeju sejejs paun eui WO JepJo ue Jo esneoeg S002 ONI YOLONGNOOIWNAS 31V9S33 4 A8 Q3AIHOSNHV MOTOROLA Go to www freescale com Automatic Gain Control Library For More Information On This Product vi ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 List of Examples Code Example Code Example Code Example Code Example Code Example MOTOROLA 3 1 3 2 3 3 51 C Header File A000 ouassseuesbseshsri q sz edirki PASE Hd HER TIR ooo ia OE EST EHE HH NEP PEE TE Ie of the asco recate Se bia og hee ee eek CORSO RO Use of agcimt UO Gx czvs svkokosak k kakak kaki sa k k kaka Maker ce sadsn un tadcst ss d snabkodd edd k bi List of Examples For More Information On This Product Go to www freescale com vii Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VF
31. mming Interface Communication Port 1 Digital Signal Processor or Digital Signal Processing Automatic Gain Control Library For More Information On This Product Go to www freescale com MOTOROLA Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 EVM Evaluation Module VO Input Output IDE Integrated Development Environment IRQA Interrupt Request A MAC Multiply Accumulate MIPS Million Instructions Per Second MSB Most Significant Bit OnCE On Chip Emulation OMR Operating Mode Register PC Program Counter SDK Software Development Kit SP Stack Pointer SPI Serial Peripheral Interface SR Status Register SRC Source References The following sources were used to produce this book 1 DSP56652 Family Manual DSP56852FM AD 2 DSP568xx User s Manual 3 Embedded SDK Programmer s Guide MOTOROLA Preface For More Information On This Product Go to www freescale com Xi Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to
32. o agcCreate Description The agcDestroy function destroys the instance of the AGC originally created by a call to the agcCreate function Returns None Special Considerations Calling the agcDestroy function frees the memory allocated during the agcCreate function The agcDestroy function should only be called if the agcCreate function was used to create the instance If the user created the instance himself bypassing the agcCreate function then the user must free the memory Code Example See Code Example 3 3 to learn how to use the agcDestroy function MOTOROLA Automatic Gain Control Library Interfaces 3 9 For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Automatic Gain Control bregscale Semiconductor Inc FAAZS89SdSC 0L0z Jequieydes 0 Joud sejejs peju eu ui ejes JO JIOdUUI 10J 9 e2s8944 WO ejqe ie e jou oje pueuno eJeu pejeoipui saequunu wed pue saul jonpojd peBexoed vog uoissiuuo ape jeuoneujJeju sejejs paun eui WO JepJo ue Jo esneoeg S002 ONI YOLONGNOOIWNAS 31V9S33 4 A8 Q3AIHOSNHV MOTOROLA Automatic Gain Control Library For More Information On This Product Go to www freescale com
33. old Reference sources paths refer to the Targeting DSP56852 Platform D emphasis manual Si see C Program FilesMotorola Embedded G SDK help tutorials Z Bold Italic Directory name project name and contains these core directories 5 applications contains applications software O CodeWarrior project ns mcp is gt Blue Text Linkable on line refer to Chapter 7 License 5 Number Any number is considered a 3V positive value unless preceded 10 Lu by a minus symbol to signify a P A negative value DES mr ALL CAPITAL Variables directives defined INCLUDE DSPFUNC o LETTERS constants files libraries define INCLUDE STACK CHECK L Brackets Function keys by pressing function key F7 LL a Quotation marks Returned messages the message Test Passed is displayed a Jf unsuccessful for any reason it will return LL NULL 2 I o me lt Definitions Acronyms and Abbreviations The following list defines the acronyms and abbreviations used in this document As this template develops this list will be generated from the document As we develop more group resources these acronyms will be easily defined from a common acronym dictionary Please note that while the acronyms are in solid caps terms in the definition should be initial capped ONLY IF they are trademarked names or proper nouns AGC API COMI DSP Automatic Gain Control Application Progra
34. ponsible to maintain the Software provide upgrades to the Software or provide any field service of the Software Motorola reserves the right to make changes to the Software without further notice to Licensee The Software is not designed intended or authorized for use as components in systems intended for surgical implant into the body or other applications intended to support or sustain life or for any other application in which the failure of the Software could create a situation where personal injury or death may occur Should Licensee purchase or use the Software for any such unintended or unauthorized application Licensee shall indemnify and hold Motorola and its officers employees subsidiaries affiliates and distributors harmless against all claims costs damages and expenses and reasonable attorney fees arising out of directly or indirectly any claim of personal injury or death associated with such unintended or unauthorized use even if such claim alleges that Motorola was negligent regarding the design or manufacture of the Software The term of this Agreement is for as long as Licensee uses the Software for its intended purpose and is not in default of any provisions of this Agreement Motorola may terminate this Agreement if Licensee is in default of any of the terms and conditions of this Agreement This Agreement shall be governed by and construed in accordance with the laws of the State of Arizona and can only be modified in
35. r for C initialization code in ROM F StackAddr F StackEndAddr F Xdata start addr ADDR xStack ADDR xStack SIZEOFW xStack 1 in_RAM Define variables for SDK mem library Data X Memory Layout EX BIT 0 Internal Memory Partitions for mem h partitions _NUM_IM_PARTITIONS 1 IM_ADDR_1 no IM_ADDR_2 External Memory Partition for mem h partitions NUM EM PARTITIONS FmemEXbit 1 EM ADDR 1 FmemNumI WRITEH _NU O FmemNumEMpartitions FmemIMpartitionList WRITEH EX BIT artitions r IM PARTITIONS EM PARTITIONS R xIntRAM DynamicMem 2 HOF xIntRAM DynamicMem 1 ist R xExtRAM DynamicMem 2 WRITEH ADD WRITEH SIZ FmemEMpartition WRITEH ADD WRITEH SIZ HOF xExtRAM DynamicMem 1 Add rest of the data into External RAM const data data xXx rtlib data fp_state data F_Xdata_ROMtoRAM_length 0 F_Xbss_start_addr X BSS ADDR rtlib bss lo rtlib bss bss Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010
36. res an export license or other government approval without first obtaining such license or approval License THE SOFTWARE IS PROVIDED ON AN AS IS BASIS AND WITHOUT WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION ANY WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE IN NO EVENT SHALL MOTOROLA BE LIABLE FOR ANY LIABILITY OR DAMAGES OF ANY KIND INCLUDING WITHOUT LIMITATION DIRECT OR INDIRECT OR INCIDENTAL OR CONSEQUENTIAL OR PUNITIVE DAMAGES OR LOST PROFITS OR LOSS OF USE ARISING FROM USE OF THE SOFTWARE OR THE PRODUCT REGARDLESS OF THE FORM OF ACTION OR THEORY OF LIABILITY INCLUDING WITHOUT LIMITATION ACTION IN CONTRACT NEGLIGENCE OR PRODUCT LIABILITY EVEN IF MOTOROLA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE THIS DISCLAIMER OF WARRANTY EXTENDS TO LICENSEE OR USERS OF PRODUCTS AND IS IN LIEU OF ALL WARRANTIES WHETHER EXPRESS IMPLIED OR STATUTORY INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR PARTICULAR PURPOSE Motorola does not represent or warrant that the Software is free of infringement of any third party patents copyrights trade secrets or other intellectual property rights or that Motorola has the right to grant the licenses contained herein Motorola does not represent or warrant that the Software is free of defect or that it meets any particular requirements or need of the Licensee or that it conforms to any documentation or that it meets any standards Motorola shall not be res
37. ted States prior to September 2010 DSP56852VFE Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 FAAZS89SdSC 0L0z Jequieydes 0 Joud sejejs peju eu ui ejes JO JIOdUUI 10J 9 e2s8944 WO ejqe ie e jou oje pueuno eJeu pejeoipui saequunu wed pue saul jonpojd peBexoed vog uoissiuuo ape jeuoneujJeju sejejs paun eui WO JepJo ue Jo esneoeg S002 ONI YOLONGNOOIWNAS 31V9S33 4 A8 Q3AIHOSNHV MOTOROLA Automatic Gain Control Library For More Information On This Product Go to www freescale com iv ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 List of Figures Figure 1 1 Figure 2 1 Figure 2 2 Figure 2 3 Figure 2 4 Figure 4 1 Figure 4 2 Figure 4 3 MOTOROLA Functional Blocks of Automatic Gain Control Library Qn DECEO E o 9 ES ewes Telephony Directory Sa o ee oe B ak n k ak gee Directory SUM 6b cc ekedsbecckeer ed ihsAr nte d Ae hiikdad hn AUC AP EAO dee npa dede Edidta d bd Rd a iP ERR aa aa ird Dependency Build for the Automatic Gain Control Library cR Pete Cp Premie BE ez ess d6d R qERe ERE RTESTCERESESPLP FRE R PESE E List of Figures For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not avai
38. uct lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Directory Structure Hit dsp568xxevm B nos i applications bsp Hsi intelligent speech ag modem ERN security speech Hag telephony Hl age c sources 4 configextram io Ham demo opt 4 demo ctg 4 demo vad dtmf det 4 dtmf gen feature phone H 9165 yy 9168 a 9711 HEM 9723 29 9726 ns bsp Figure 2 4 AGC Application 2 4 Automatic Gain Control Library MOTOROLA For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE N o D IN Freescale Semiconductor Inc ARCHIVED BY F REESCALE SEMICONDUCTOR INC 2005 Chapter 3 Automatic Gain Control Library Interfaces 3 1 Automatic Ga
39. uoneujJeju sejejs paun eui WO JepJo ue Jo esneoeg S002 ONI YOLONGNOOIWNAS 31V9S33 4 A8 Q3AIHOSNV MOTOROLA Automatic Gain Control Library For More Information On This Product Go to www freescale com 4 4 I ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Chapter 5 Linking Applications with the Automatic Gain Control Library 5 1 Automatic Gain Control AGC Library The AGC Library includes APIs which provide an interface between the user application and the Automatic Gain Control modules To invoke Automatic Gain Control APIs must be called in this order agcCreate y agclnit y agcProcess agcDestroy y For details on the AGC interface see Chapter 3 5 1 1 Library Sections Code Example 5 1 shows a sample linker cmd file which may be used in testing the Automatic Gain Control Library Code Example 5 1 linker cmd File HEKK K K k kk kk Ck kk k kk k k kk kk kk kk kk k kk kk k kk Ck k kk kk k kk kk kA X Ak k k ke kA ko ke k k k k AKA k k kc kc k k k k Linker cmd file for DSP56852 External RAM using only external program and data memory HKKK K K K K K K K A k k kk kk K K K K A k k k k k k K k K A K k k k kA k Ak kK k k Kk k k k k k k k k k A k k kk k k k k MEMORY pInterruptVector RWX ORIGIN
40. ure is used internally by AGC for its operation The user should not setup this structure typedef struct long SignalEnergy Input Siganl Energy long GainFine AGC previous Fine Gain agc sHandle RR KKK KKK kk joke k k ke ke kk ek k ek ke k k k Function Prototypes Fe I KAKA A A ke ee eee ke k EXPORT agc sHandle agcCreate void EXPORT Result agcInit agc sHandle pAgc EXPORT Result agcProcess agc sHandle pAgc Wordl6 pInputSample Wordl6 pOutputSample UWord16 NumSamples EXPORT void agcDestroy agc sHandle pAgc endif 3 2 Automatic Gain Control Library For More Information On This Product Go to www freescale com MOTOROLA Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 3 3 Specifications Specifications The following pages describe the Automatic Gain Control AGC library functions Function arguments for each routine are described as in out or inout An in argument means that the parameter value is an input only to the function An out argument means that the parameter value is an output only from the function
41. vative Object Motorola grants Licensee a personal non exclusive non assignable revocable royalty free right to copy use and distribute the Object and the Derivative Object solely for operating on a Motorola semiconductor device having a central processing unit Licensee agrees to a not use modify or copy the Software except as expressly provided herein b not distribute disclose transfer sell assign rent lease or otherwise make available the Software any derivatives thereof or this license to a third party except as expressly provided herein c not remove obliterate or otherwise defeat any copyright trademark patent or proprietary notices related to the MOTOROLA License 7 1 For More Information On This Product Go to www freescale com Because of an order from the United States International Trade Commission BGA packaged product lines and part numbers indicated here currently are not available from Freescale for import or sale in the United States prior to September 2010 DSP56852VFE ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Freescale Semiconductor Inc ARCHIVED BY FREESCALE SEMICONDUCTOR INC 2005 Software d not in any form export re export resell ship or divert or cause to be exported re exported resold shipped or diverted directly or indirectly the Software or a direct product thereof to any country which the United States government or any agency thereof at the time of export or re export requi
42. ware including copying modifying or installing the Software so that it is usable by or accessible by a central processing unit constitutes acceptance of the terms of the Agreement by the person or persons making such use or if employed the employer thereof Licensee and if employed the person s making such use hereby warrants that they have the authority of their employer to enter this license agreement If Licensee does not agree with and accept the terms of this Agreement Licensee must return or destroy any media containing the Software or materials related thereto and destroy all copies of the Software The Software is licensed to Licensee by Motorola Incorporated Motorola for use under the terms of this Agreement Motorola retains ownership of the Software Motorola grants only the rights specifically granted in this Agreement and grants no other rights Title to the Software all copies thereof and all rights therein including all rights in any intellectual property including patents copyrights and trade secrets applicable thereto shall remain vested in Motorola For the Source Motorola grants Licensee a personal non exclusive non assignable revocable royalty free right to use copy and make derivatives of the Source solely in a development system environment in order to produce object code solely for operating on a Motorola semiconductor device having a central processing unit Derivative Object For the Object and Deri
Download Pdf Manuals
Related Search