headset_tones.c

bc5_stereo：bluetooth stereo Headset CODE 支持A2DP HSP 和 HSP 。可作为车载免提。BlueLab 2007环境下编译

/****************************************************************************
Copyright (C) Cambridge Silicon Radio Ltd. 2004-2007

FILE NAME
    headset_tones.c
    
DESCRIPTION
    Module responsible for tone generation and playback.
    
*/

#include "headset_amp.h"
#include "headset_debug.h"
#include "headset_tones.h"

#include <audio.h>
#include <csr_cvc_plugin.h>
#include <stream.h>
#include <panic.h>


#ifdef DEBUG_TONES
    #define TONE_DEBUG(x) DEBUG(x)
#else
    #define TONE_DEBUG(x) 
#endif


#define TONES_VOL_PLAYBACK_LEVEL_CVC (14)
#define TONES_VOL_PLAYBACK_LEVEL_NO_CVC (22)
#define TONE_TYPE_RING (0x60FF)


/****************************************************************/
/*
    SIMPLE TONES
 */
/****************************************************************/

/* eg. power tone */
static const audio_note tone_power[] =
{
    AUDIO_TEMPO(120), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    
    AUDIO_NOTE(REST, HEMIDEMISEMIQUAVER),        
    AUDIO_NOTE(G7,   CROTCHET), 
    
    AUDIO_END
};

/* eg. pairing tone */
static const audio_note tone_pairing[] =
{
    AUDIO_TEMPO(2400), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    
    AUDIO_NOTE(REST, CROTCHET),
    AUDIO_NOTE(G5 , SEMIBREVE),
    AUDIO_NOTE(REST, CROTCHET),
    AUDIO_NOTE(REST, QUAVER),
    AUDIO_NOTE(G5 , SEMIBREVE),
    
    AUDIO_END
};

/* eg. mute off */
static const audio_note tone_inactive[] =
{
    AUDIO_TEMPO(2400), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    
    AUDIO_NOTE(REST, CROTCHET),
    AUDIO_NOTE(G6 , SEMIBREVE),
    AUDIO_NOTE(REST, CROTCHET),
    AUDIO_NOTE(C7 , SEMIBREVE),
    
    AUDIO_END
};

/* eg. mute on */
static const audio_note tone_active[] =
{
    AUDIO_TEMPO(2400), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    
    AUDIO_NOTE(REST, CROTCHET),
    AUDIO_NOTE(G6 , SEMIBREVE),
    AUDIO_NOTE(REST, CROTCHET),
    AUDIO_NOTE(G5 , SEMIBREVE),
    
    AUDIO_END
};

/* eg. battery low */
static const audio_note tone_battery[] =
{
    AUDIO_TEMPO(120), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    
    AUDIO_NOTE(REST, HEMIDEMISEMIQUAVER),
    AUDIO_NOTE(G6 , CROTCHET),
    AUDIO_NOTE(REST, HEMIDEMISEMIQUAVER),
    AUDIO_NOTE(G6 , CROTCHET),
    AUDIO_NOTE(REST, HEMIDEMISEMIQUAVER),
    AUDIO_NOTE(G6 , CROTCHET),
    
    AUDIO_END
};

/* eg. vol limit */
static const audio_note tone_vol[] =
{
    AUDIO_TEMPO(600), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    AUDIO_NOTE(REST, SEMIQUAVER),
    AUDIO_TEMPO(200), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    AUDIO_NOTE(G7 , CROTCHET),
    
    AUDIO_END
};

/* eg. connection */
static const audio_note tone_connection[] =
{
    AUDIO_TEMPO(2400), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    
    AUDIO_NOTE(REST, CROTCHET),
    AUDIO_NOTE(G7 , SEMIBREVE),
    
    AUDIO_END
};

/* error tone */
static const audio_note tone_error[] =
{
    AUDIO_TEMPO(120), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    
    AUDIO_NOTE(REST, HEMIDEMISEMIQUAVER),
    AUDIO_NOTE(G5 , CROTCHET),
    
    AUDIO_END
};

/* short confirmation */
static const audio_note tone_short[] =
{
    AUDIO_TEMPO(2400), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    
    AUDIO_NOTE(REST, CROTCHET),
    AUDIO_NOTE(G6 , SEMIBREVE),
    
    AUDIO_END
};

/* long confirmation */
static const audio_note tone_long[] =
{
    AUDIO_TEMPO(1200), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),  
    AUDIO_NOTE(REST, QUAVER),
    AUDIO_TEMPO(150), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine), 
    AUDIO_NOTE(G6 , MINIM),
    
    AUDIO_END
};

static const audio_note tone_mute_reminder[] =
{
    AUDIO_TEMPO(600), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    AUDIO_NOTE(REST, SEMIQUAVER),
    AUDIO_TEMPO(120), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    AUDIO_NOTE(G5, CROTCHET),
    AUDIO_NOTE(REST, CROTCHET),
    AUDIO_NOTE(G5, CROTCHET),
    AUDIO_END
};

/* ringtone 1 */
static const audio_note ring_twilight[] =
{
    AUDIO_TEMPO(180), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
    
    AUDIO_NOTE(E7, QUAVER),
    AUDIO_NOTE(F7, QUAVER),
    AUDIO_NOTE(E7, QUAVER),
    AUDIO_NOTE(C7, QUAVER),
    AUDIO_NOTE(E7, QUAVER),
    AUDIO_NOTE(F7, QUAVER),
    AUDIO_NOTE(E7, QUAVER),
    AUDIO_NOTE(C7, QUAVER),

    AUDIO_END
};

/* ringtone 2 */
static const audio_note ring_greensleeves[] =
{
    AUDIO_TEMPO(400), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),
              
    AUDIO_NOTE(F6,CROTCHET),                                  
    AUDIO_NOTE(AF6,MINIM),                                            
    AUDIO_NOTE(BF6,CROTCHET),                         
    AUDIO_NOTE(C7,CROTCHET),                          
    AUDIO_NOTE_TIE(C7,QUAVER),                                            
    AUDIO_NOTE(DF7,QUAVER),                           
    AUDIO_NOTE(C7,CROTCHET),                                          
    AUDIO_NOTE(BF6,MINIM),                            
    AUDIO_NOTE(G6,CROTCHET),          
    AUDIO_NOTE(EF6,CROTCHET), 
    AUDIO_NOTE_TIE(EF6,QUAVER),
       
    AUDIO_END
};

/* ringtone 3 */
static const audio_note ring_major_scale[] =
{
    AUDIO_TEMPO(300), AUDIO_VOLUME(64), AUDIO_TIMBRE(sine),

    AUDIO_NOTE(E6,QUAVER),                                    
    AUDIO_NOTE(FS6,QUAVER),                                           
    AUDIO_NOTE(GS6,QUAVER),                           
    AUDIO_NOTE(A6,QUAVER),                            
    AUDIO_NOTE(B6,QUAVER),                                            
    AUDIO_NOTE(CS7,QUAVER),                           
    AUDIO_NOTE(DS7,QUAVER),                                           
    AUDIO_NOTE(E7,QUAVER),    

    AUDIO_END
};

/***************************************************************************/
/*
    The Tone Array
*/
/*************************************************************************/
#define NUM_FIXED_TONES (14)


/* This must make use of all of the defined tones - requires the extra space first */
static const audio_note * const gFixedTones [ NUM_FIXED_TONES ] = 
{
/*1*/    tone_power,
/*2*/    tone_pairing,
/*3*/    tone_inactive,
/*4*/    tone_active,
/*5*/    tone_battery,
/*6*/    tone_vol,
/*7*/    tone_connection, 
/*8*/    tone_error,
/*9*/    tone_short,
/*a*/    tone_long,		
/*b*/	 tone_mute_reminder,
/*c*/    ring_twilight,
/*d*/    ring_greensleeves,
/*e*/    ring_major_scale
};    

/****************************************************************************
  FUNCTIONS
*/

/****************************************************************************
NAME    
    IsToneDefined
    
DESCRIPTION
  	Helper fn to determine if a tone has been defined or not.
    
RETURNS
    bool 
*/
static bool IsToneDefined ( HeadsetTone_t pTone )
{
    bool lResult = TRUE ;
    
    if ( pTone == TONE_NOT_DEFINED )
    {
        lResult = FALSE ;
    }
    
    if (  ! gFixedTones [ (pTone - 1) ] )
    {	    /*the tone is also not defined if no entry exists for it*/
        lResult = FALSE ; 
    }
    
    return lResult ;
}


/*****************************************************************************/
void TonesInit ( hsTaskData * pApp ) 
{
    uint16 lEvent = 0 ;
    
    uint16 lSize = 0 ;
    
    TONE_DEBUG (("TONE Init :\n")) ;  
    
    /*need to create the space for the event mapping and the vol tone mapping*/
    lSize = (EVENTS_MAX_EVENTS * sizeof ( HeadsetTone_t ) ) ;
    
    TONE_DEBUG(("TONE: sz[%x] \n",lSize)) ;
    
        /*allocate the total space*/
    pApp->audioData.gEventTones = ( HeadsetTone_t * ) PanicUnlessMalloc ( lSize ) ;
    
    for ( lEvent =  0 ; lEvent  < EVENTS_MAX_EVENTS ; lEvent ++ )
    {
        pApp->audioData.gEventTones[ lEvent ] = TONE_NOT_DEFINED ;
    }
}


/*****************************************************************************/
void TonesConfigureEvent ( hsTaskData * pApp ,headsetEvents_t pEvent , HeadsetTone_t pTone ) 
{
    uint16 lEventIndex = pEvent - EVENTS_EVENT_BASE ;   

    if ( IsToneDefined ( pTone ) ) 
    {
        if (pEvent == TONE_TYPE_RING )
        {   
            TONE_DEBUG(("TONE: ConfRingTone [%x]\n" , pTone)) ;
            pApp->RingTone = pTone ;
        }
        else
        {
                /* gEventTones is an array of indexes to the tones*/
            TONE_DEBUG(("Add Tone[%x][%x]\n" , pEvent , pTone ));
   
            pApp->audioData.gEventTones [ lEventIndex ] = pTone  ;
    
            TONE_DEBUG(("TONE; Add Ev[%x][%x]Tone[%x][%x]\n", pEvent , lEventIndex , pTone 
                                 , (int) pApp->audioData.gEventTones [ lEventIndex] )) ;
        }
    }    
}


/*****************************************************************************/
void TonesPlayEvent ( hsTaskData * pApp,  headsetEvents_t pEvent )
{    
    uint16 lEventIndex = pEvent - EVENTS_EVENT_BASE ;
    
        /*if the tone is present*/
    if (pApp->audioData.gEventTones [ lEventIndex ] != TONE_NOT_DEFINED )
    {
        TONE_DEBUG(("TONE: EvPl[%x][%x][%x]\n", pEvent, lEventIndex , (int) pApp->audioData.gEventTones [ lEventIndex]  )) ;
        
	    TonesPlayTone (pApp ,  pApp->audioData.gEventTones [ lEventIndex] ,TRUE ) ;
    }
    else
    {
        TONE_DEBUG(("TONE: NoPl[%x]\n", pEvent)) ;
    }        
} 


/*****************************************************************************/
void TonesPlayTone ( hsTaskData * pApp , HeadsetTone_t pTone , bool pCanQueue )
{
    if ( IsToneDefined(pTone) )			
    {   
        uint16 lToneVolume;
		uint16 ampOffDelay = pApp->ampOffDelay;
		uint16 newDelay = ampOffDelay;
		
		/* Turn the audio amp on */
		AmpOn(pApp);
		
		/* The audio off delay must be greater than all tone lengths, so if it's
		   set very low then increase it slightly while a tone is played as 
		   otherwise the amp could be turned off before a tone has complete.
		*/
		if (pApp->dsp_process == dsp_process_none)
		{
			/* Only switch amp off if SCO and A2DP not active */
			if (pApp->ampAutoOff && (ampOffDelay < 3))
			{
				newDelay += 3; 
				AmpSetOffDelay(pApp, newDelay);
				AmpOffLater(pApp);
				AmpSetOffDelay(pApp, ampOffDelay);
			}
			else
			{
				AmpOffLater(pApp);
			}
		}
        
        /*if (pApp->features.PlayTonesAtFixedVolume)
        {        
            lToneVolume = TONES_VOL_PLAYBACK_LEVEL ;
        }
        else
        {
            lToneVolume = pApp->audioData.gSMVolumeLevel; 
        }*/
        
		if ((pApp->dsp_process == dsp_process_sco) && pApp->cvcEnabled)
        	lToneVolume = TONES_VOL_PLAYBACK_LEVEL_CVC ;
		else
			lToneVolume = TONES_VOL_PLAYBACK_LEVEL_NO_CVC ;
        
        AudioPlayTone ( gFixedTones [ pTone  - 1 ] , pCanQueue ,pApp->theCodecTask, lToneVolume , TRUE ) ;
    }    
}


/*****************************************************************************/
void ToneTerminate ( hsTaskData * pApp )
{
    AudioStopTone() ;
}