imp_audio.h

Go to the documentation of this file.

/*
 * Audio utils header file.
 *
 * Copyright (C) 2014 Ingenic Semiconductor Co.,Ltd
 */

#ifndef __IMP_AUDIO_H__
#define __IMP_AUDIO_H__

#include <stdint.h>

#ifdef __cplusplus
#if __cplusplus
extern "C"
{
#endif
#endif /* __cplusplus */

#define MAX_AUDIO_FRAME_NUM 50

typedef enum {
        BLOCK = 0,                              
        NOBLOCK = 1,                    
} IMPBlock;

typedef enum {
        AUDIO_SAMPLE_RATE_8000  = 8000,         
        AUDIO_SAMPLE_RATE_16000 = 16000,        
        AUDIO_SAMPLE_RATE_24000 = 24000,        
        AUDIO_SAMPLE_RATE_44100 = 44100,        
        AUDIO_SAMPLE_RATE_48000 = 48000,        
        AUDIO_SAMPLE_RATE_96000 = 96000,        
} IMPAudioSampleRate;

typedef enum {
        AUDIO_BIT_WIDTH_16 = 16,                
} IMPAudioBitWidth;

typedef enum {
        AUDIO_SOUND_MODE_MONO   = 1,    
        AUDIO_SOUND_MODE_STEREO = 2,    
} IMPAudioSoundMode;

typedef enum {
        PT_PCM          = 0,
        PT_G711A        = 1,
        PT_G711U        = 2,
        PT_G726         = 3,
        PT_AEC          = 4,
        PT_ADPCM        = 5,
        PT_MAX          = 6,
} IMPAudioPalyloadType;

typedef enum {
        ADEC_MODE_PACK   = 0,   
        ADEC_MODE_STREAM = 1,   
} IMPAudioDecMode;

typedef struct {
        IMPAudioSampleRate samplerate;          
        IMPAudioBitWidth bitwidth;                      
        IMPAudioSoundMode soundmode;            
        int frmNum;                                                     
        int numPerFrm;                                          
        int chnCnt;                                                     
} IMPAudioIOAttr;

typedef struct {
        IMPAudioBitWidth bitwidth;                      
        IMPAudioSoundMode soundmode;            
        uint32_t *virAddr;                                      
        uint32_t phyAddr;                                       
        int64_t timeStamp;                                      
        int seq;                                                        
        int len;                                                        
} IMPAudioFrame;

typedef struct {
        int usrFrmDepth;                                        
        int Rev;                                                        
} IMPAudioIChnParam;

typedef struct {
        int chnTotalNum;                                
        int chnFreeNum;                                 
        int chnBusyNum;                                 
} IMPAudioOChnState;

typedef struct {
        uint8_t *stream;                                
        uint32_t phyAddr;                               
        int len;                                                
        int64_t timeStamp;                              
        int seq;                                                
} IMPAudioStream;

typedef struct {
        IMPAudioPalyloadType type;                              
        int bufSize;                                                    
        uint32_t *value;                                                
} IMPAudioEncChnAttr;

typedef struct {
        IMPAudioPalyloadType type;              
        int maxFrmLen;                                  
        char name[16];                                  
        int (*openEncoder)(void *encoderAttr, void
                        *encoder);
        int (*encoderFrm)(void *encoder, IMPAudioFrame
                        *data, unsigned char *outbuf,int *outLen);
        int (*closeEncoder)(void *encoder);
} IMPAudioEncEncoder;

typedef struct {
        IMPAudioPalyloadType type;                      
        int bufSize;                                            
        IMPAudioDecMode mode;                           
        void *value;                                            
} IMPAudioDecChnAttr;

typedef struct {
        IMPAudioPalyloadType type;              
        char name[16];                                  
        int (*openDecoder)(void *decoderAttr, void
                        *decoder);
        int (*decodeFrm)(void *decoder, unsigned char
                        *inbuf,int inLen, unsigned short *outbuf,int
                        *outLen,int *chns);
        int (*getFrmInfo)(void *decoder, void *info);
        int (*closeDecoder)(void *decoder);
} IMPAudioDecDecoder;

typedef struct {
        int TargetLevelDbfs;    
        int CompressionGaindB;  
} IMPAudioAgcConfig;

enum Level_ns {
        NS_LOW,                 
        NS_MODERATE,    
        NS_HIGH,                
        NS_VERYHIGH             
};

int IMP_AI_SetPubAttr(int audioDevId, IMPAudioIOAttr *attr);

int IMP_AI_GetPubAttr(int audioDevId, IMPAudioIOAttr *attr);

int IMP_AI_Enable(int audioDevId);

int IMP_AI_Disable(int audioDevId);

int IMP_AI_EnableChn(int audioDevId, int aiChn);

int IMP_AI_DisableChn(int audioDevId, int aiChn);

int IMP_AI_PollingFrame(int audioDevId, int aiChn, unsigned int timeout_ms);

int IMP_AI_GetFrame(int audioDevId, int aiChn, IMPAudioFrame *frm, IMPBlock block);

int IMP_AI_ReleaseFrame(int audioDevId, int aiChn, IMPAudioFrame *frm);

int IMP_AI_SetChnParam(int audioDevId, int aiChn, IMPAudioIChnParam *chnParam);

int IMP_AI_GetChnParam(int audioDevId, int aiChn, IMPAudioIChnParam *chnParam);

int IMP_AI_EnableAec(int aiDevId, int aiChn, int aoDevId, int aoChn);

int IMP_AI_DisableAec(int aiDevId, int aiChn);

int IMP_AI_EnableNs(IMPAudioIOAttr *attr, int mode);

int IMP_AI_DisableNs(void);

int IMP_AI_EnableAgc(IMPAudioIOAttr *attr, IMPAudioAgcConfig agcConfig);

int IMP_AI_DisableAgc(void);

int IMP_AO_EnableAgc(IMPAudioIOAttr *attr, IMPAudioAgcConfig agcConfig);

int IMP_AO_DisableAgc(void);

int IMP_AI_EnableHpf(IMPAudioIOAttr *attr);

int IMP_AI_DisableHpf(void);

int IMP_AO_EnableHpf(IMPAudioIOAttr *attr);

int IMP_AO_DisableHpf(void);

int IMP_AO_SetPubAttr(int audioDevId, IMPAudioIOAttr *attr);

int IMP_AO_GetPubAttr(int audioDevId, IMPAudioIOAttr *attr);

int IMP_AO_Enable(int audioDevId);

int IMP_AO_Disable(int audioDevId);

int IMP_AO_EnableChn(int audioDevId, int aoChn);

int IMP_AO_DisableChn(int audioDevId, int aoChn);

int IMP_AO_SendFrame(int audioDevId, int aoChn, IMPAudioFrame *data, IMPBlock block);

int IMP_AO_PauseChn(int audioDevId, int aoChn);

int IMP_AO_ResumeChn(int audioDevId, int aoChn);

int IMP_AO_ClearChnBuf(int audioDevId, int aoChn);

int IMP_AO_QueryChnStat(int audioDevId, int aoChn, IMPAudioOChnState *status);

 int IMP_AENC_CreateChn(int aeChn, IMPAudioEncChnAttr *attr);

 int IMP_AENC_DestroyChn(int aeChn);

 int IMP_AENC_SendFrame(int aeChn, IMPAudioFrame *frm);

int IMP_AENC_PollingStream(int AeChn, unsigned int timeout_ms);

 int IMP_AENC_GetStream(int aeChn, IMPAudioStream *stream ,IMPBlock block);

 int IMP_AENC_ReleaseStream(int aeChn,IMPAudioStream *stream);

 int IMP_AENC_RegisterEncoder(int *handle, IMPAudioEncEncoder *encoder);

 int IMP_AENC_ReleaseEncoder(int *handle);

 int IMP_ADEC_CreateChn(int adChn, IMPAudioDecChnAttr *attr);

 int IMP_ADEC_DestroyChn(int adChn);

 int IMP_ADEC_SendStream(int adChn, IMPAudioStream *stream, IMPBlock block);

int IMP_ADEC_PollingStream(int AdChn, unsigned int timeout_ms);

int IMP_ADEC_GetStream(int adChn, IMPAudioStream *stream ,IMPBlock block);

int IMP_ADEC_ReleaseStream(int adChn,IMPAudioStream *stream);

 int IMP_ADEC_ClearChnBuf(int adChn);

 int IMP_ADEC_RegisterDecoder(int *handle, IMPAudioDecDecoder *decoder);

 int IMP_ADEC_ReleaseDecoder(int *handle);

 int IMP_AI_SetVol(int audioDevId, int aiChn, int aiVol);

 int IMP_AI_GetVol(int audioDevId, int aiChn, int *vol);

 int IMP_AI_SetVolMute(int audioDevId, int aiChn, int mute);

 int IMP_AO_SetVol(int audioDevId, int aoChn, int aoVol);

 int IMP_AO_GetVol(int audioDevId, int aoChn, int *vol);

 int IMP_AO_SetVolMute(int audioDevId, int aoChn, int mute);

 int IMP_AI_SetGain(int audioDevId, int aiChn, int aiGain);

 int IMP_AI_GetGain(int audioDevId, int aiChn, int *aiGain);

 int IMP_AO_SetGain(int audioDevId, int aoChn, int aoGain);

 int IMP_AO_GetGain(int audioDevId, int aoChn, int *aoGain);

 int IMP_AO_Soft_Mute(int audioDevId, int aoChn);

 int IMP_AO_Soft_UNMute(int audioDevId, int aoChn);

 int IMP_AI_GetFrameAndRef(int audioDevId, int aiChn, IMPAudioFrame *frm, IMPAudioFrame *ref, IMPBlock block);

 int IMP_AI_EnableAecRefFrame(int audioDevId, int aiChn, int audioAoDevId, int aoChn);

 int IMP_AI_DisableAecRefFrame(int audioDevId, int aiChn, int audioAoDevId, int aoChn);

 int IMP_AO_CacheSwitch(int audioDevId, int aoChn, int cache_en);

 /* @fn int IMP_AO_FlushChnBuf(int audioDevId, int aoChn);
 * Wait for last audio data to play.
 * @param[in] audioDevId audio device number.
 * @param[in] aoChn audio output channel number.
 *
 * @retval 0 success
 * @retval non-0 failure.
 *
 * @remarks no
 * @attention no.
 */
 int IMP_AO_FlushChnBuf(int audioDevId, int aoChn);

#ifdef __cplusplus
#if __cplusplus
}
#endif
#endif /* __cplusplus */

#endif /* __IMP_AUDIO_H__ */