## 前言
录音例程涉及了录音和播放两大块内容,上篇笔记说了播放,这篇就来说说录音这块,也就是音频编码这部分功能。
上篇笔记中的这段话太装逼了,我决定再复制下,嘿嘿。
"我的锤子便签中有上个月记下的一句话,“斯蒂芬·平克说,写作之难,在于把网状思考,用树状结构,体现在线性展开的语句里。”这篇代码解析也有类似的困难,代码的网状结构,如何用文章这种线性载体来体现。"
跟上篇笔记的做法一样,还是挑出了主干,来讲下自己的理解。另外在文章最后添加了一个模块拓扑图来帮助消化。
本文作者twowinter,转载请注明:
http://blog.csdn.net/iotisan/
查看代码主逻辑,主要是App_StartRec和App_ProcessRec这两个函数。下面就分别进行分析。
## 第一部分 App_StartRec
App_StartRec是由按键触发的,也就是按键按下去就开始录音。
- BOOL App_StartRec(void)
- {
- S_AUDIOCHUNK_HEADER sAudioChunkHeader;
-
- // 这回就不是Decode了,改用Encode。
- // Initiate NuLiteEx audio encode lib with temp buffer provided for lib.
- NuLiteExApp_EncodeInitiate(&g_sApp.sNuLiteExAppEncode, (UINT8 *)&g_sApp.uTempBuf);
-
- // Start to encode NuLiteEx data with sample rate, bit per frame and saved data information into audio chunk header.
- if (NuLiteExApp_EncodeStart(&g_sApp.sNuLiteExAppEncode, &sAudioChunkHeader, ADC_SAMPLE_RATE, E_NULITEEX_ENCODE_BPS_10) == FALSE)
- return FALSE;
-
- // SPIFlash utility function provide encode data write into SPIFlash.
- // detail info please refer "SPIFlashUtil.h"
- SPIFlahUtil_StartWriteEncodeData(&sAudioChunkHeader, AUDIOROM_STORAGE_START_ADDR, NULL);
-
- // Light record led for display status.
- OUT5(0);
-
- // Start to record PCM data into buffer for produc NuLiteEx encode data.
- Record_StartRec();
-
- return TRUE;
- }
可以看到App_StartRec主要牵扯了NuLiteExApp_EncodeStart和Record两部分子函数。
### 重中之重NuLiteExApp_EncodeStart
NuLiteExApp_EncodeStart(&g_sApp.sNuLiteExAppEncode, &sAudioChunkHeader, ADC_SAMPLE_RATE, E_NULITEEX_ENCODE_BPS_10);照例对代码做了中文注解方便消化。
g_sApp.sNuLiteExAppEncode是全局变量,涉及编码库的操作。sAudioChunkHeader是一个临时变量,用来做音频块头部信息。
- BOOL NuLiteExApp_EncodeStart( S_NULITEEX_APP_ENCODE *psNuLiteExAppEncode, S_AUDIOCHUNK_HEADER *psAudioChunkHeader,
- UINT16 u16SampleRate, enum eNuLiteExEncodeBPS eBitPerSample)
- {
- if ( (eBitPerSample > NULITEEXAPP_ENCODE_MAX_BITRATE) || (u16SampleRate == 0) )
- return FALSE;
- else
- {
- psAudioChunkHeader->u16SmplRate = u16SampleRate;
- psAudioChunkHeader->u32BitPerFrame = eBitPerSample;
- }
-
- // 将全局变量申请的内存传入给编码库,方便其工作执行。将音频块头部传入,编码库最后的输出结果会体现在这里。另外的采样率信息是输入变量,辅助生成最后的音频块。
- // NuLiteEx encoder initiates work buffer.
- // Set bit rate and sample rate information for audio chunk header.
- NuLiteEx_EncodeInitiate((UINT8 *)psNuLiteExAppEncode->au32WorkBuf, psNuLiteExAppEncode->pau8TempBuf,
- psAudioChunkHeader, (enum eNuLiteExEncodeBPS)psAudioChunkHeader->u32BitPerFrame, psAudioChunkHeader->u16SmplRate);
-
- // Reset encode buffer read index and write index
- psNuLiteExAppEncode->sEncodeBufCtrl.u16BufWriteIdx = 0;
- psNuLiteExAppEncode->sEncodeBufCtrl.u16BufReadIdx = 0;
-
- // Set Encoded frame size, Storage Utility will refer to this size to write data.
- psNuLiteExAppEncode->sEncodeBufCtrl.u16FrameSize = (psAudioChunkHeader->u32BitPerFrame)>>3;
- psNuLiteExAppEncode->sEncodeBufCtrl.u16BufCount = (psNuLiteExAppEncode->sEncodeBufCtrl.u16FrameSize)*NULITEEXAPP_ENCODE_BUF_COUNT;
-
- // 这一步很关键,设置录音模块部分的缓存。
- // Set input buffer size, PCM buffer pointer, frame size and sample rate.
- Record_SetInBufRecord( &psNuLiteExAppEncode->sInBufCtrl,
- NULITEEXAPP_IN_BUF_SIZE,
- psNuLiteExAppEncode->i16InBuf,
- NULITEEX_ENCODE_SAMPLE_PER_FRAME,
- psAudioChunkHeader->u16SmplRate);
-
- // 都要做这一步操作,录音模块的操作顺序就是这样:SetInBufRecord ->Add -> StartRec。
- // Set application input buffer to record(ADC) output buffer.
- Record_Add(&psNuLiteExAppEncode->sInBufCtrl, psAudioChunkHeader->u16SmplRate);
-
- return TRUE;
- }
### 也很重要的Record_StartRec
上面说录音模块的操作顺序就是这样:SetInBufRecord ->Add -> StartRec。这就来了。
硬件PDMA这里头涉及一个关键函数,PDMA会把ADC数据直接放到s_pi16AdcBuf里头。
- void Record_StartRec(void)
- {
-
- g_u8AppCtrl |= APPCTRL_RECORD;
- #if (ADC_FILTER_ENABLE == 1)
- NoiseFilter_ResetIIR2();
- s_pi16AdcBuf = g_ai16ADCSamples;
- #else
- // 主要是缓冲区的处理
- if ( BUF_CTRL_ISNOT_CALLBACK(g_psAdcBufCtrl))
- s_pi16AdcBuf = &g_psAdcBufCtrl->pi16Buf[g_psAdcBufCtrl->u16BufWriteIdx];
- else
- s_pi16AdcBuf = g_ai16ADCSamples;
- #endif
-
- // 采用了硬件PDMA的方式
- #if (ADC_PDMA_ENABLE == 1)
- PdmaCtrl_Start(ADC_PDMA_CH, (uint32_t *)&ADC->DAT, (uint32_t *)s_pi16AdcBuf, 8);
- #endif
- MIC_Start();
- }
## 第二部分 App_ProcessRec
这个部分调用了这个关键函数。SPIFlashUtil_WriteEncodeData。主线程会在大部分时间执行SPIFlashUtil_4KPagePartialWriting,将缓冲逐步写入到SPI FLASH中。
另一个关键函数是NuLiteExApp_EncodeProcess。这是NuLiteEx库的一个编码处理应用。
- // Keep encode PCM buffer data to NuLiteEx lib.
- NuLiteExApp_EncodeProcess(&g_sApp.sNuLiteExAppEncode);
其在内部调用了NuLiteEx_EncodeProcess,这是NuLiteEx库的API。
## 总结
源码拓扑结构