audio.c File Reference

---

Detailed Description

This module provides audio support.

REVISION

• 10/09/2004 DeepB
  Initial creation.

Definition in file audio.c.

#include "../SYSTEM/sys_hardware.h"
#include "../SYSTEM/sys_hiddenfeature.h"
#include "../SYSTEM/sys_main.h"
#include "../SYSTEM/sys_clock.h"
#include "../MESSAGE/message.h"
#include "../codec/codec.h"
#include "../coder/coder.h"
#include "../DECODER/decoder.h"
#include "../encoder/encoder.h"
#include "../fat/fat.h"
#include "../FMXMIT/xmit_inc.h"
#include "../UI/ui.h"
#include "../UI/playQ.h"
#include "audio.h"

Include dependency graph for audio.c:

Go to the source code of this file.

Defines
#define	EQ_VALUE_OFFSET   (15)
	LOCAL DEFINITIONS.
Functions
BOOL	AUDIO_initInterface (AUDIO_MODE mode, AUDIO_FORMAT format, ULONG offset, ULONG duration)
	Function initializes the audio interface.
void	AUDIO_setInterface (AUDIO_CONTROL ctl)
	Function sets to start the audio interface.
void	AUDIO_setCurrentTrack (void)
	Function fetches the current playback file pointer.
void	AUDIO_getCacheTrackFile (int setCacheFile)
	Function fetches the file pointer of that to be cached.
void	AUDIO_speedInit (void)
	Function initializes the speed interface.
int	AUDIO_speedIsOutputBufferFull (void)
	Function checks to see if speed output buffer is full.
BOOL	AUDIO_config (void)
	Function configures the audio system.
void	AUDIO_start (void)
	Function starts the audio interface.
void	AUDIO_pause (void)
	Function pause the audio interface.
void	AUDIO_unmute (void)
	Function unmute the audio interface.
void	AUDIO_stop (void)
	Function shuts down active audio interface and releases all data objects used by active interface.
void	AUDIO_myfiShutdown (void)
	Function shuts down MyFi broadcasting.
void	AUDIO_shutdown (void)
	Function completely shuts down the audio interface and deletes all coder tasks and task level objects.
void	AUDIO_energyInit (st_AUDIOENERGY *pEnergy, unsigned short blockSize)
	Function initializes the energy calculation module.
void	AUDIO_setEQ (int *pEq)
	Function resets the EQ parameters.
ULONG	AUDIO_getFilePtr (void)
	Function returns current audio file pointer offset.
void	AUDIO_setFilePtr (ULONG fptr)
	Function sets audio file pointer to given offset.
void	AUDIO_resetMyfiQuality (void)
	Function resets MyFi quality control.
Variables
st_AUDIO	Audio
	GLOBAL DATA.

---

Define Documentation

#define EQ_VALUE_OFFSET   (15)

LOCAL DEFINITIONS. TI interface EQ ranges from -15 to 15. Definition at line 62 of file audio.c.

---

Function Documentation

BOOL AUDIO_config (  void   )

Function configures the audio system. Returns: TRUE if audio system is successfully configured, otherwise FALSE. Definition at line 351 of file audio.c. References AF_MP3, AF_OGG, AF_PCM, AF_WAV, AF_WMA, AM_MYFI, AM_PLAY, AM_RECFM, AM_RECLINE, AM_RECMIC, Audio, AUDIO_MODE, DECODER_config(), ENCODER_config(), st_CODER::flag, st_AUDIO::format, and st_AUDIO::mode. Referenced by SYS_main(). { AUDIO_MODE mode = Audio.mode; USHORT amode; // 0: playback, 1: record, 2 other. if ((AM_PLAY == mode)||(AM_MYFI == mode)) amode = 0; else if((AM_RECLINE == mode)||(AM_RECMIC == mode)||(AM_RECFM == mode)) amode = 1; else amode = 2; Coder.flag = SYS_isHDDpresent()? F_CODER_USE_CACHE:0; switch(Audio.format) { case AF_MP3: { if( 0 == amode ) { GEN_load(MP3_CODE); GEN_load(MP3_CONST); GEN_reinit(MP3_DECODER_OBJ); DECODER_config(DECMP3); _audioConfig(TRUE, AF_MP3); } else if( 1 == amode ) { GEN_load(MPR_CODE); GEN_load(MPR_CONST); GEN_reinit(MP3_ENCODER_OBJ); ENCODER_config(ENCMP3); _audioConfig(FALSE, AF_MP3); } break; } #ifdef WMA_SUPPORT case AF_WMA: { if( 0 == amode ) { GEN_load(WMA_CODE); GEN_load(WMA_CONST); GEN_reinit(WMA_DECODER_OBJ); DECODER_config(DECWMA); _audioConfig(TRUE, AF_WMA); } break; } #endif #ifdef WAV_SUPPORT case AF_WAV: { if( 0 == amode ) { GEN_load(WAV_CODE); GEN_load(WAV_CONST); GEN_reinit(WAV_DECODER_OBJ); DECODER_config(DECWAV); _audioConfig(TRUE, AF_WAV); } else if( 1 == amode ) { GEN_load(WAVR_CODE); GEN_reinit(WAV_ENCODER_OBJ); ENCODER_config(ENCWAV); _audioConfig(FALSE, AF_WAV); } break; } #endif #ifdef OGG_SUPPORT case AF_OGG: { if( 0 == amode ) { GEN_load(OGG_CODE); GEN_load(OGG_CONST); GEN_reinit(OGG_DECODER_OBJ); DECODER_config(DECOGG); _audioConfig(TRUE, AF_OGG); } break; } #endif case AF_PCM: { if(2 == amode) _audioConfig(-1, DONTCARE); break; } } AUDIO_setIdle(); return TRUE; }

Here is the call graph for this function:

void AUDIO_energyInit (  st_AUDIOENERGY *  pEnergy, unsigned short  blockSize )

Function initializes the energy calculation module. Parameters: pEnergy  Energy data structure. blockSize  Lenght of the block. Definition at line 684 of file audio.c. Referenced by CODEC_recordHdlReset(). { pEnergy->ShortTermEnergy = pEnergy->AverageEnergy = 0; pEnergy->FastPeak = pEnergy->SlowPeak = 0; pEnergy->Index = 1; pEnergy->BlockSize = blockSize-1; }

void AUDIO_getCacheTrackFile (  int  setCacheFile  )

Function fetches the file pointer of that to be cached. Parameters: setCacheFile  If non-zero, reset the cache file, otherwise seek next track only. Definition at line 265 of file audio.c. References Audio, st_AUDIO::cachefile, and UI_getNextAudioFileFromPlayQ(). Referenced by UI_PSF_play(). { if(setCacheFile) { File * fp = UI_getNextAudioFileFromPlayQ(setCacheFile); if(fp) Audio.cachefile = *fp; } else UI_getNextAudioFileFromPlayQ(setCacheFile); }

Here is the call graph for this function:

ULONG AUDIO_getFilePtr (  void   )

Function returns current audio file pointer offset. It currently only supports decoder operation. Returns: File pointer offset in words. Definition at line 738 of file audio.c. References AF_MP3, AF_OGG, AF_WAV, AF_WMA, Audio, and st_AUDIO::format. Referenced by MENU__djControl(), and UI_PSF_play(). { ULONG fptr = 0L; switch(Audio.format) { case AF_MP3: DECODER_mp3fptr(&fptr); break; #ifdef WAV_SUPPORT case AF_WAV: DECODER_wavfptr(&fptr); break; #endif #ifdef OGG_SUPPORT case AF_OGG: DECODER_oggfptr(&fptr); break; #endif #ifdef WMA_SUPPORT case AF_WMA: DECODER_wmafptr(&fptr); break; #endif } return fptr; }

BOOL AUDIO_initInterface (  AUDIO_MODE  mode, AUDIO_FORMAT  format, ULONG  offset, ULONG  duration )

Function initializes the audio interface. Function loads proper audio code into memory. Parameters: mode  Target audio mode. format  Audio data format. offset  Audio data file offset. duration  Audio duration in seconds. Returns: TRUE if audio interface successfully initialized, otherwise FALSE. Definition at line 147 of file audio.c. References AF_NULL, AI_CONFIG, AM_MYFI, AM_PLAY, AM_RECFM, AM_RECLINE, AM_RECMIC, Audio, AUDIO_FORMAT, st_AUDIO::cachefile, st_AUDIO::duration, st_AUDIO::file, st_AUDIO::format, st_AUDIO::fptr, st_AUDIO::mode, st_AUDIO::offset, st_AUDIO::playtime, SAUDIOCTL, SCREATETASK, and UI_getCurrentAudioFileFromPlayQ(). Referenced by UI_PSF_hisi(), UI_PSF_play(), UI_PSF_radio(), and UI_PSF_record(). { USHORT amode; // 0: playback, 1: record, 2 other. if(AF_NULL == format) return FALSE; AUDIO_queryIdle(); Audio.mode = mode; Audio.format = format; if ((AM_PLAY == mode)||(AM_MYFI == mode)) amode = 0; else if((AM_RECLINE == mode)||(AM_RECMIC == mode)||(AM_RECFM == mode)) amode = 1; else amode = 2; if(0 == amode) { Audio.cachefile= Audio.file = *UI_getCurrentAudioFileFromPlayQ(); Audio.playtime = 0L; Audio.fptr = 0L; Audio.offset = offset; Audio.duration = duration; } else if(1 == amode) { Audio.duration = 0L; Audio.fptr = 0L; } // Config coder system. mMSG_send(sysMsgQ, SYS_MSG_ID, SAUDIOCTL, AI_CONFIG, SYS_FOREVER); if(0 == amode) { // Create decoder tasks if not created already. mMSG_send(sysMsgQ, SYS_MSG_ID, SCREATETASK, DECODER_TASKS, SYS_FOREVER); } else if(1 == amode) { // Create encoder tasks if not created already. mMSG_send(sysMsgQ, SYS_MSG_ID, SCREATETASK, ENCODER_TASKS, SYS_FOREVER); } AUDIO_waitIdle(SYS_FOREVER); return TRUE; }

Here is the call graph for this function:

void AUDIO_setEQ (  int *  pEq  )

Function resets the EQ parameters. Parameters: pEq  New EQ parameters pointer. Definition at line 705 of file audio.c. Referenced by MENU__setEq(), and UI_MSF_eq(). { USHORT ii = EQBAR_MAXNUM; int tmp; int eq[EQBAR_MAXNUM] = {15,15,15,15,15}; int * p = &EQgain[0]; if(NULL == pEq) pEq = eq; while(ii--) { tmp = *pEq - EQ_VALUE_OFFSET; if( (tmp < -15) || (tmp > 15) ) { *pEq = 15; tmp = 0; } *p++ = tmp; pEq++; } EQ_setGains(&LeftEQ, EQgain); EQ_setGains(&RightEQ, EQgain); }

void AUDIO_setFilePtr (  ULONG  fptr  )

Function sets audio file pointer to given offset. It currently only supports decoder operation. Parameters: fptr  File pointer offset in words. Definition at line 767 of file audio.c. References Audio, Decoder, st_DECODER::flag, and st_AUDIO::offset. Referenced by UI_PSF_play(). { HWI_disable(); Audio.offset = fptr; Decoder.flag |= DEC_MEDIASEEK; HWI_enable(); }

int AUDIO_speedIsOutputBufferFull (  void   )

Function checks to see if speed output buffer is full. Returns: 1 if full, otherwise 0. Definition at line 317 of file audio.c. Referenced by CODEC_playPcmPut(). { unsigned int outRate; if(sampleCount >= 64) { sampleCount -= 64; return 1; } // Check to reset SRC. outRate = (NORMAL_SPEED != speed)? USRATE: 44100; if(actvRate != outRate) { LeftSRC_params.outputRate = RightSRC_params.outputRate = outRate; SRC_algInit(&LeftSRC, LeftSRC_memRec, NULL, &LeftSRC_params); SRC_algInit(&RightSRC, RightSRC_memRec, NULL, &RightSRC_params); actvRate = outRate; } return 0; }

---

Variable Documentation

st_AUDIO Audio

GLOBAL DATA. This global bridges the GUI and entir audio system. It has to sit in internal memory. Definition at line 122 of file audio.c. Referenced by AUDIO_config(), AUDIO_getCacheTrackFile(), AUDIO_getFilePtr(), AUDIO_initInterface(), AUDIO_setFilePtr(), AUDIO_shutdown(), AUDIO_start(), CODEC_recordHdlReset(), DECODER__mp3(), DECODER__mp3first(), DECODER__mp3media(), DECODER__oggfirst(), DECODER__oggRead(), DECODER__wav(), DECODER__wavfirst(), DECODER__wavmedia(), DECODER__wma(), DECODER__wmainit(), DECODER__wmamedia(), DECODER__wmatask(), DECODER_cache(), DECODER_getData(), DECODER_releaseObj(), DECODER_seek(), ENCODER__mp3(), ENCODER__wav(), ENCODER_cache(), ENCODER_putData(), ENCODER_releaseObj(), UI_PSF_hisi(), UI_PSF_play(), UI_PSF_record(), and UI_setupPlayQ().

---