ISD9160学习笔记04_ISD9160音频编码代码分析

前言

录音例程涉及了录音和播放两大块内容，上篇笔记说了播放，这篇就来说说录音这块，也就是音频编码这部分功能。

上篇笔记中的这段话太装逼了，我决定再复制下，嘿嘿。

“我的锤子便签中有上个月记下的一句话，“斯蒂芬·平克说，写作之难，在于把网状思考，用树状结构，体现在线性展开的语句里。”这篇代码解析也有类似的困难，代码的网状结构，如何用文章这种线性载体来体现。”

跟上篇笔记的做法一样，还是挑出了主干，来讲下自己的理解。另外在文章最后添加了一个模块拓扑图来帮助消化。

本文作者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。

总结

源码拓扑结构