am_c_utilities.h

来自「Motorola synergy audio component」· C头文件 代码 · 共 380 行 · 第 1/2 页

#ifndef AM_C_UTILITIES_H
#define AM_C_UTILITIES_H

#ifdef __cplusplus         /*  Allow #include in a C++ file.  */
extern "C" {
#endif

/*==================================================================================================
                                                                               
     Header Name:  am_c_utilities.h

     General Description:  Provide audio functionality for other tasks.
 
====================================================================================================
                              Motorola Confidential Proprietary
                         Advanced Technology and Software Operations
                      (c) Copyright Motorola 1999-2005, All Rights Reserved
     

Revision History:

Date       Author      CR Number
---------- ----------- ---------------------------------------------------------
2005-07-25 w16355      CR - LIBgg35198
           AM needs to minimize changes between audio events.
           
2005-06-13 w17860      CR - LIBff63840
           Apple 3990042: Sometimes after sync, phone only plays out right headphone

2005-05-05 w17860      CR - LIBgg00249
           INTG: Panic when receive MT call very quickly before ringtone rang.

                            Modification     Tracking
Author                          Date          Number     Description of Changes
-------------------------   ------------    ----------   -------------------------------------------
w17860                      01/26/2005      LIBff42504   Panic with Neptune LTE2 ROM3. Audio shaping not 
                                                         disabled
                                                         - Make sure that CODER_ON is allowed to be sent 
                                                           only when audio queue is empty and the messges 
                                                           have been sent to DSP

w16355                      06/29/2004      LIBdd80946   PTT updates - added new prototypes.

Michael Loutris             04/02/2004      LIBdd93012   RTime never told to stop stereo headset polling.
                                                         - Remove functions to get and set the current
                                                           tone type for LIBdd92010 since the volume is 
                                                           sufficient.


Lori Lareau                 08/21/2003      LIBdd30597   Add fm voice and va clip-on spkrph tables

Ravi Subramanyan            08/12/2003      LIBdd21346   Acc: ACLT: MP4P: Audio does not transfer to 
                                                         external speaker phone

Ravi Subramanyan            07/21/2003      LIBdd19939   Change Audio Gain Table design so that it can be BRed 
                                                         to common MME 

Ravi Subramanyan            05/30/2003      LIBbb96110   Single Binary audio gains

Lori Haegele                10/14/2002      LIBbb60623   Add 4 gain tables for multimedia

baf044                      10/31/2002     LIBbb62132    NEPTUNE LTS: Support PCAP and SEAWEED in Run-Time for Audio.

bob030                      11/07/2002      LIBbb52316   LCA: Use higher gains for ringer playback when TX-ing.
                                                         - added two functions to set and get am_is_call_pending.

bab047                      03/17/2002      LIBbb23280 - LCA catchup for PAN8-G_03.07.1AI 

bmd031                      02/17/2002       LIBbb20411 - LCA Add support for MME

byr003                       01-12-24       LIBbb15362 - LCA catchup for R1.2.1 

Rena Dwork                   09/06/01       LIBbb04889   declare am_hw_gain_table[] and am_hw_vol_step_table[]
                                                         instead of *am_hw_gain_table and *am_hw_vol_step_table

Assaf Freimann               06/11/2001     CSGce94379   Support for LCA
                                                         - change extern const AM_HW_GAINS_DATA am_hw_gain_table[ AM_HW_NO_OF_GAIN_TBLS ] ;
                                                         when this file is not part of a ROM ONLY build
                                                         
Ravi Chebolu                 01/14/2002     LIBbb12603   Improving audio for Bluetooth Headset on GSM

Qi Hu                        05/14/2001     CSGce85432   TDMA gains modification.

Mike Loutris                 03/14/2001     CSGce83858   - Need separate volume settings for voice 
                                                           for each accessory class.
                                                           Added a prototype to  get the volume step
                                                           feature id needed by AM and the Device Layer.

Steve Hagino                 02/28/2001     CSGce89923   RAM Savings - Make gain tables CONST

Mike Loutris                 09/14/2000     CSGce72157   - Changed the number of gain tables from
                                                           43 to 51 to support VA playback speaker
                                                           gains and separate internal speaker
                                                           phone mic tables.

Mike Loutris                 08/31/2000     CSGce70003   - Modify gain return struct to support
                                                           decoupling input and output gains.
Mike Loutris                 05/07/2000     CSGce58879   Initial file creation


====================================================================================================
                                         INCLUDE FILES
==================================================================================================*/
#include "audio_conditional_compile_def.h"
#if (MAKE_NEPTUNE_CHIPSET == TRUE)
#include <BUILD/hardware.h>
#include <BUILD/memory_usage.h>
#endif

#include "td_aud_tone_req_tone_type.h"
#include <SUAPI/su_basictypes.h>
#include <SYNERGY_DEVICE_LAYER/dl_db_feature_ids.h>
#include <SUAPI/suapi.h>                      // Added to support the PCAP timer.

/*==================================================================================================
                                           CONSTANTS
==================================================================================================*/

#define  AM_HW_4_11_SHIFT            11
#define  AM_HW_SHIFT_16_BITS         16

/*  If the number of gains tables changes, just update AM_HW_NO_OF_GAIN_TBLS! 
 *  The number of gain tables verify with the product. Please ensure that when
 *   a new gain table is added for a product, the appropriate value gets updated
 *   for the number of gain tables  
 */
#if (MAKE_HDW_BB_IC == MAKE_HDW_NEPTUNE_LTS) /* This is for the Triplets */
#define  AM_HW_NO_OF_GAIN_TBLS       70
#elif (MAKE_HDW_BB_IC == MAKE_HDW_NEPTUNE_LT) /* This is for E380 */
#define  AM_HW_NO_OF_GAIN_TBLS       58
#else
#define  AM_HW_NO_OF_GAIN_TBLS       80       /* This is for Talon */
#endif

#define  AM_HW_NO_OF_VOL_STEPS        8
#define  AM_HW_VOL_STEP_TBL_SIZE      8

/* This is defined because although the volume step table is an array of UINT16's, the 
 * read from the file would be byte read. So each record for the read should be 16 bytes
 */
#define  AM_HW_VOL_STEP_TBL_SIZE_IN_BYTES (AM_HW_VOL_STEP_TBL_SIZE * (sizeof(UINT16)))

#if (MAKE_HDW_BB_IC == MAKE_HDW_NEPTUNE_LTS) /* This is for the Triplets */
#define  AM_HW_NO_OF_VOL_STEPS_TBLS 10
#else
#define  AM_HW_NO_OF_VOL_STEPS_TBLS 9        /* This is for Talon and E380 */
#endif

/*  The aud_proc_table holds DSP commands to compensate for HW deficiencies. */
#define  AM_HW_AUD_PROC_CMD_LEN       6  /* The number of bytes in a aud_proc commmand. */
#define  AM_HW_AUD_PROC_TBL_LEN      64  /* The maximum number of aud_proc commands. */

#define  AM_HW_INVALID_VOL_STEP_TABLE 0

/*  This is a temporary patch until the DL folks can supply us the real enum. */
#define  DL_ACC_DM_CE_BUS_TEST        254

#define  AM_HARDWARE_DELAY_DURATION   10000  /* This should be about 10 seconds ... */

/*==================================================================================================
                                            MACROS
==================================================================================================*/

/*==================================================================================================
                                             ENUMS
==================================================================================================*/

enum 
{
    AM_HW_INVALID_GAIN_TYPE ,
    AM_HW_SPKR_GAIN_TYPE ,
    AM_HW_MIC_GAIN_TYPE
} ;


/*  DSP MATRIX sources. */
enum
{
    DOWNLINK_SPEECH,
    CODEC_MIC,
    USB_MIC,
    SAP_RX_SLOT_1,
    SAP_RX_SLOT_2,
    SAP_RX_SLOT_3,
    VA_PLAYBACK,
    VR_PROMPTS,
    DSC_MIC,
    TONE_GENERATOR,
    MEDIA_ENGINE,
    MATRIX_SOURCE_MAX = MEDIA_ENGINE,