.. _AUDIO公共:  


AUDIO公共
=========================================


    AW24N AUDIO包含：
        - 内置Class-D功放的APA模块；（单声道）
        - 模拟DAC模块；（单声道）
        - 模拟ADC模块；（单声道）

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

audio模块采样率列表
################################################################

    +----------+-------+-------+-------+
    |AW24N AUDIO 采样率支持情况        |
    +----------+-------+-------+-------+
    |采样率    |ADC    |DAC    |APA    |
    +==========+=======+=======+=======+
    |8000      |yes    |yes    |yes    |
    +----------+-------+-------+-------+
    |11025     |yes    |yes    |yes    |
    +----------+-------+-------+-------+
    |12000     |yes    |yes    |yes    |
    +----------+-------+-------+-------+
    |16000     |yes    |yes    |yes    |
    +----------+-------+-------+-------+
    |22050     |yes    |yes    |yes    |
    +----------+-------+-------+-------+
    |24000     |yes    |yes    |yes    |
    +----------+-------+-------+-------+
    |32000     |yes    |yes    |yes    |
    +----------+-------+-------+-------+
    |44100     |yes    |yes    |yes    |
    +----------+-------+-------+-------+
    |48000     |yes    |yes    |yes    |
    +----------+-------+-------+-------+
    |64000     |null   |yes    |yes    |
    +----------+-------+-------+-------+
    |88200     |null   |yes    |yes    |
    +----------+-------+-------+-------+
    |96000     |null   |yes    |yes    |
    +----------+-------+-------+-------+

    .. centered:: 表1 AD24N audio 采样率支持情况

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

audio工作模式列表
################################################################

    本小节主要介绍AUDIO 几种模式的工作场景。

AUDIO DAC / APA 工作模式   
*******************************************************************

    +-----------+----------------+
    |AD24N AUDIO 工作模式        | 
    +===========+================+
    |DAC        |单声道单端DAC   |
    +-----------+----------------+
    |APA        |单声道差分APA   |
    +-----------+----------------+

    .. centered:: 表2 AD24N AUDIO DAC 工作模式 

AUDIO ADC 工作模式   
****************************************************************************************************

	+------------------------+--------------------------------------------------------------------------------------------------------+
	| AD24N AUDIO ADC 工作模式                                                                                                        |
	+------------------------+--------------------------------------------------------------------------------------------------------+
	| ADC MIC(模拟麦)        | 供电方式支持MICBIAS供电（使用内部偏置电阻）、MICLDO供电（使用外部偏置电阻）以及外部供电+外部偏置电阻； |
	|                        | 输入方式支持单端和差分输入；                                                                           |
	+------------------------+--------------------------------------------------------------------------------------------------------+
	| LINEIN                 | 支持单端、差分linein输入                                                                               |
	+------------------------+--------------------------------------------------------------------------------------------------------+
	| APA_MIC                | 仅支持APAP&APAN组合做差分输入，APA引脚外接喇叭作为MIC输入，此时声音只能从模拟DAC输出                   |
	+------------------------+--------------------------------------------------------------------------------------------------------+
	| DIGITAL_MIC(数字麦)    | 支持单声道数字麦                                                                                       |
	+------------------------+--------------------------------------------------------------------------------------------------------+

    .. centered:: 表3 AD24N AUDIO ADC 工作模式 

    **注1：APA_MIC模式使用时只能以APAP为P端、APAN为N端作差分输入，且使用时APA输出功能需要关闭，此时如果需要播出的声音只能从模拟DAC输出。**

    **注2：APA_MIC模式使用时，APAP和APAN外接喇叭，且喇叭当MIC用时一般灵敏度比较低，因此需要ADC的MIC_PGA增益使用。**

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Audio 公共配置
################################################################

    1. u32 const config_adda_low_voltage_mode：音频模块电压模式；0为高压模式，1为低压模式
        - 音频系统（模拟DAC/ADC）在vddio < 2.7v时会导致性能下降，此时开启低压模式使能可以优化音频性能；
        - 高压模式：供电给VPWR的电压要在2.7V~5.4V之间
        - 低压模式：VPWR和IOVDD短接，且供电在1.8V~3.6v之间
        - 软件默认使用高压模式；
        - 用户根据产品的使用电压范围，决定是否开启该配置；

    +-----------------+---------------------+-------------------------------+
    | VPWR供电电压    | VPWR和IOVDD是否短接 | config_adda_low_voltage_mode  |
    +=================+=====================+===============================+
    | 2.7V~5.4V之间   |      否             |     配置为0                   |
    +-----------------+---------------------+-------------------------------+
    | 1.8V~3.6v之间   |      是             |     配置为1                   |
    +-----------------+---------------------+-------------------------------+
    
    .. centered:: 表4 AD24N 音频模块电压模式配置、VPWR供电电压以及VPWR相关电路之间的关系

    2. audio.c文件中，audio各个模块依赖的const常量，使用AUDIO模块时，需要把其依赖的常量置1

    +----------------------------+--------------+--------------+--------------+
    |   AD24N AUDIO & APA 工作依赖常量                                        |
    +============================+==============+==============+==============+
    |                            | Audio DAC    | Audio ADC    | Audio APA    |
    +----------------------------+--------------+--------------+--------------+
    |   au_const_apa_en          | ×            | ×            | √            |
    +----------------------------+--------------+--------------+--------------+
    |   au_const_dac_digital_en  | √            | ×            | √            |
    +----------------------------+--------------+--------------+--------------+
    |   au_const_dac_analog_en   | √            | ×            | ×            |
    +----------------------------+--------------+--------------+--------------+
    |   au_const_adda_common_en  | √            | √            | ×            |
    +----------------------------+--------------+--------------+--------------+

    .. centered:: 表5 AD24N AUDIO模块工作与const常量依赖关系

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

VCM(Audio_VBG) trim相关说明
################################################################

    AD24N的 **AUDIO_ADC与AUDIO_DAC （仅包含模拟DAC，不包含APA）** 在使用 **高压模式** 时，第一次上电需要 **根据IOVDD电压来校准VCM(AUDIO_VBG)电压** 。
    
    **校准过程需要依赖vm和SARADC模块** ，校准后的档位值会存到全局变量使用并且写入vm，以便下次开机直接从vm读取校准后的档位值来使用，节省开机时间。

    +-----------------------------------------+----------------------------+
    | AUDIO模块                               | 是否需要VCM(Audio_VBG)TRIM |
    +=========================================+============================+
    | AUDIO_ADC                               | √                          |
    +-----------------------------------------+----------------------------+
    | AUDIO_DAC                               | √                          |
    +-----------------------------------------+----------------------------+
    | AUDIO_APA                               | ×                          |
    +-----------------------------------------+----------------------------+
    
    .. centered:: 表6 AD24N AUDIO模块与VCM(Audio_VBG)TRIM的关系

    VCM TRIM已在公版SDK流程中加入。
    
    .. image:: audio_voltage_trim.png
        :alt: "VCM_TRIM函数“
        :align: center
    .. centered:: VCM_TRIM函数

    校准后的VCM电压结果
    
    .. image:: vcm_trim_vol.png
        :alt: "vcm电压校准结果“
        :align: center
    .. centered:: vcm电压校准结果

    **注1：校准后的VCM电压需要满足一个关系，即 VCM*2 + 0.3V <= IOVDD。如果校准结果不符合该关系，请联系开发人员**
    
    **注2：由于校准后的结果会存在vm用于后续节省开机时间，所以校准后如果需要调节IOVDD，则需要擦除EEPROM区重新校准VCM**