DM Auido模块接口详解.docx
- 文档编号:16998342
- 上传时间:2023-07-21
- 格式:DOCX
- 页数:23
- 大小:19.31KB
DM Auido模块接口详解.docx
《DM Auido模块接口详解.docx》由会员分享,可在线阅读,更多相关《DM Auido模块接口详解.docx(23页珍藏版)》请在冰点文库上搜索。
DMAuido模块接口详解
DM_AudioInit
TheDM_AudioInit()functionsetthedefaultvalue,suchasspeakergain,micgainandtheaudiomode,ifyouhavenotcallthisfunction,thesevaluewillbesetwiththeinnervalue.
Usually,youdon’tneedcallthisfunction.
BOOLDM_AudioInit(
DM_SpeakerGainSpeakerGain,
DM_MicGainMicGain,
UINT8Audio_mode
);
Parameters
SpeakerGain
[in]Specifythedefaultspeakergainvalue.ThevaluecanbeoneofthefollowingvalueinDM_SpeakerGain.
MicGain
[in]SpecifythedefaultMicGainvalue.ThevaluecanbeoneofthefollowingvalueinDM_MicGain.
Audio_mode
[in]SpecifythedefaultAudioModevalue.Thevaluecanbeoneofthefollowingvalue:
AudioMode
Description
DM_AUDIO_MODE_HANDSET
耳机模式
DM_AUDIO_MODE_EARPIECE
听筒模式
DM_AUDIO_MODE_LOUDSPEAKER
喇叭模式
ReturnValues
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Remarks
Examplele
VoidMMI_Task(void)
{
DM_AudioInit(DM_AUDIO_SPK_m3dB,DM_AUDIO_MIC_33dB,1);
}
Requirements
BOOLDM_AudioInit(DM_SpeakerGainSpeakerGain,DM_MicGainMicGain,UINT8Audio_mode)
{audio_cfg.spkGain=SpeakerGain;
audio_cfg.micGain=MicGain;
audio_cfg.micSel=Audio_mode;
audio_cfg.spkSel=Audio_mode;
}
DM_StartAudio
TheDM_StartAudiofunctioninitializestheaudioresourcesforacall.Soyoushouldcallitbeforeyouwanthaveacall.
VOIDDM_StartAudio(VOID);
Parameters
None.
ReturnValues
Remarks
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Examplele
#include“dm.h”…………………………………………………….
VoidMMI_Task(void)
{
If(event==connect)//haveacall
DM_StartAudio();
………….
If(event==disconnect)
DM_StopAudio();
}
………;
DM_StopAudio
TheDM_StopAudiofunctionclosetheaudioequipmentafteracall.
VOIDDM_StopAudio(VOID);
Parameters
None.
ReturnValues
Remarks
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Examplele
#include“dm.h”…………………………………………………….
VoidMMI_Task(void)
{
………………………………
}
………;
Requirements
Header:
Declaredindm.h
DM_SpeakerOpen
TheDM_SpeakerOpenconfiguretheoutputoftheaudioandopenthereceive.
YouarenoneedcallitbeforethefunctionDM_StartAudio()andDM_Audio_StartStream().
VOIDDM_SpeakerOpen(VOID);
Parameters
None.
ReturnValues
None.
Remarks
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Examplele
#include“dm.h”…………………………………………………….
VoidMMI_Task(void)
{
………………………………
}
DM_SpeakerClose
TheDM_SpeakerClosefunctionfreesthespeakerresource,andclosestheaudioreceive.
VOIDDM_SpeakerClose(VOID);
Parameters
None.
ReturnValues
Value
Meaning
CII_SUCCESS
Success
Remarks
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Examplele
#include“dm.h”…………………………………………………….
VoidMMI_Task(void)
{
………………………………
}
DM_MicOpen
TheDM_MicOpenfunctionconfiguretheMICmodule.
YouarenoneedcallitbeforethefunctionDM_StartAudio()andDM_Audio_StartStream().
VOIDDM_MicOpen(VOID);
Parameters
None.
ReturnValues
Value
Meaning
TRUE
Success
Remarks
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Examplele
#include“dm.h”…………………………………………………….
VoidMMI_Task(void)
{
………………………………
}
DM_MicClose
TheDM_MicClosefunctionclosestheMICdevice.
VOIDDM_MicClose(VOID);
Parameters
None.
ReturnValues
Value
Meaning
CII_SUCCESS
Success
Remarks
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Examplele
#include“dm.h”…………………………………………………….
VoidMMI_Task(void)
{
………………………………
}
DM_SetAudioMode
TheDM_SetAudioModefunctionsetstheaudiomoderequiredfortheconnectedequipment.
BOOLDM_SetAudioMode(
UINT8nAudioMode
);
Parameters
nAudioMode
[in]Specifytheaudiomodetoset.Theaudiomodecanbeoneofthefollowingvalue:
AudioMode
Description
DM_AUDIO_MODE_HANDSET
耳机模式(插耳机)
(InthismodethereceiversignaloutputfromthepinsnamedAUD_OUT1_PandAUD_OUT1_N;ThemicrophonesignalinputfromthepinsnamedAUD_IN1_PAndAUD_IN1_N)
DM_AUDIO_MODE_EARPIECE
听筒模式(主模式)
(InthismodethereceiversignaloutputfromthepinsnamedAUD_OUT0_PandAUD_OUT0_N;ThemicrophonesignalinputfromthepinsnamedAUD_IN0_PAndAUD_IN0_N)
DM_AUDIO_MODE_LOUDSPEAKER
喇叭模式(免提)
(InthismodethereceiversignaloutputfromthepinsnamedAUD_OUT1_PandAUD_OUT1_N;ThemicrophonesignalinputfromthepinsnamedAUD_IN0_PAndAUD_IN0_N)
ReturnValues
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Remarks
Examplele
#include“dm.h”
……………………………………………………….
VoidMMI_Task(void)
{
}
Requirements
Header:
Declaredindm.h
Library:
dm.lib
SeeAlso
DM_GetAudioMode
TheCFW_GetAudioModefunctionwillreturntheaudiomodecurrently。
BOOLDM_GetAudioMode(
UINT8*pAudioMode
);
Parameters
pAudioMode
[out]PointertotheUINT8typetoreceivetheaudiomode.Theaudiomodecanbeoneofthefollowingvalue:
AudioMode
Description
DM_AUDIO_MODE_HANDSET
耳机模式
DM_AUDIO_MODE_EARPIECE
听筒模式
DM_AUDIO_MODE_LOUDSPEAKER
喇叭模式
ReturnValues
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Remarks
Examplele
#include“dm.h”
……………………………………………………….
VoidMMI_Task(void)
{
}
DM_SetSpeakerGain
TheDM_SetSpeakerGainfunctionsetsthereceiveGain
BOOLDM_SetSpeakerGain(
DM_SpeakerGainnGain
);
Parameters
nGain
[in]Specifythereceivegainvalue.ThevaluecanbeoneofthefollowingvalueinDM_SpeakerGain.
ReturnValues
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Remarks
Examplele
#include“dm.h”…………………………………………………….
VoidMMI_Task(void)
{
………………………………
}
Requirements
Header:
Declaredindm.h
Library:
dm.lib
SeeAlso
DM_SetAudioVolume
TheDM_SetAudioVolumefunctionsetstheaudiovolumerequiredfortheconnectedequipment.
ItisthesamewithDM_SetSpeakerGaininfact.Butyou’dbetterusethisfunctionforincreaseanddecreasetheaudiovolume.
BOOLDM_SetAudioVolume(
UINT8nVolume
);
Parameters
nVolume
[in]Specifytheaudiovolumetoset.Thevaluecanbeform0to11.
ReturnValues
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Remarks
Examplele
#include“dm.h”
……………………………………………………….
VoidMMI_Task(void)
{
}
Requirements
Header:
Declaredindm.h
Library:
dm.lib
SeeAlso
DM_GetSpeakerVolume
TheDM_GetSpeakerVolumefunctionwillreturnthespeakervolumevaluecurrently.
BOOLDM_GetSpeakerVolume(
UINT8*pVolume
);
Parameters
pVolume
[in]PointertotheUINT8typetoreceivethespeakervolumeThevaluecanbefrom0to11.
ReturnValues
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Remarks
Examplele
#include“dm.h”
……………………………………………………….
VoidMMI_Task(void)
{
}
Requirements
Header:
Declaredindm.h
Library:
dm.lib
SeeAlso
DM_SetMicGain
TheDM_SetMicGainfunctionsetstheMICGain.
BOOLDM_SetMicGain(
DM_MicGainnGain
);
Parameters
nGain
[in]SpecifytheMicGainvalue.ThevaluecanbeoneofthefollowingvalueinDM_MicGain.
ReturnValues
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Remarks
Examplele
#include“dm.h”…………………………………………………….
VoidMMI_Task(void)
{
………………………………
}
Requirements
Header:
Declaredindm.h
Library:
dm.lib
DM_SetSideGain
TheDM_SetSideGainfunctionsetstheSideGain.
BOOLDM_SetSideGain(
DM_SideToneGainnGain
);
Parameters
nGain
[in]Specifythesidegainvalue.ThevaluecanbeoneofthefollowingvalueinDM_SideToneGain.
ReturnValues
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Remarks
Examplele
#include“dm.h”…………………………………………………….
VoidMMI_Task(void)
{
………………………………
}
Requirements
Header:
Declaredindm.h
Library:
dm.lib
SeeAlso
DM_Audio_StartStream
TheDM_Audio_StartStreamfunctionstartsplayingastream.
BOOLDM_Audio_StartStream(
UINT32*buffer,
UINT32len,
DM_PlayRingTypecodec,
BOOLloop_mode
);
Parameters
buffer
[in]Startaddressofthemusicdatabuffer
len
Thelengthofthebuffer.
codec
Encodingformatofthebufferdata,canbeinthefollowinginDM_PlayRingType.
loop_mode
Iffalse,itwillstopwhenthelengthisreached.Iftrue,bufferwillactasafifoandtheplayingwillrestartatthebeginningofthebufferwhentheendisreached(overwritewhatwasalreadyinthebuffer)
Tobebrief,ifitistrue,itwillplayincycles.
ReturnValues
None.
Remarks
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunctionfails,thereturnvalueisFALSE.
Examplele
#include“dm.h”
UINT32amr[]={//AMRformat
0x4d412123,
0x913c0a52,
0x66be1617,
0x01000078,
0x0000afe7,
0x00800000,…….
……..};
VoidMMI_Task(void)
{
DM_Audio_StartStream(amr,4000,DM_DICTAPHONE_AMR_RING,0);//playonetime
………….
DM_Audio_StopStream();
…………..
DM_Audio_StartStream(amr,4000,DM_DICTAPHONE_AMR_RING,1);//playcycle
If(event==EV_DM_STREAM_END_IND)//playover
DM_Audio_StopStream();
…………….
}
Requirements
DM_Audio_StopStream
TheDM_Audio_StopStreamfunctionstopstheplayingofstream.
Notice,itmustbecalledaftertheendofonestream.
BOOLDM_Audio_StopStream(void);
Parameters
None.
ReturnValues
None.
Remarks
Ifthefunctionsucceeds,thereturnvalueisTRUE,ifthefunc
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DM Auido模块接口详解 Auido 模块 接口 详解