.. _音频降噪算法: 

音频降噪算法(ANS)
=========================================

    AD14 / AD24 支持音频降噪算法。

    SDK默认关闭音频降噪算法(缩写：ANS)，用户需在app_modules.h打开。

    使用音频降噪算法(缩写：ANS)需要注意以下配置：
        1. 输入给降噪算法数据的采样率（最好为16k采样率）
        2. 运行降噪算法时的系统时钟需要在107M以上
        3. 在链接文件里（app_ld.c）降噪算法使用的ans_data段与其他功能的复用，确认在使用降噪算法时，该空间不会被其他功能干扰。

    .. image:: noise_suppress.png
        :alt: "音频降噪宏"
        :align: center
    .. centered:: 音频降噪宏

    | 音频降噪算法(缩写：ANS)的使用可以参考下方gitee链接：
    | `FAQ：音频降噪算法的使用 <https://gitee.com/Jieli-Tech/AW30N/issues/IBKTBY>`_

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

涉及文件
################################

    源文件：
        | ans_api.c
    头文件：
        | ans_api.h
        | NoiseSuppressLib.h
    库文件：
        | libNoiseSuppress_pi32_OnChip.a
        | lib_SW_FFT_pi32_OnChip.a
    链接文件：
        app_ld.C 或 app_ld_overlay_custom.c 文件

    .. image:: ld_ans.png
        :alt: "降噪算法在链接文件复用位置"
        :align: center
    .. centered:: 降噪算法在链接文件复用位置

    SDK在录音模式已加入音频降噪算法。用户可作参考。

    .. image:: rec_link_noise_suppress.png
        :alt: "录音模式串联音频降噪"
        :align: center
    .. centered:: 录音模式串联音频降噪

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



相关参数
################################

    1. 采样率：
   
        | 降噪算法只支持8k和16k采样率。
        | 建议使用16k采样率。

        .. image:: noise_suppress_sr.png
            :alt: "音频降噪采样率配置"
            :align: center
        .. centered:: 音频降噪采样率配置

    2. 系统时钟：

        | 降噪算法需要较高的系统时钟。
        | AD14N经测试最低需要96MHz时钟。
        | AD24N经测试最低需要107MHz时钟。


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


相关函数
################################




void \*link_ans_sound(void \*p_sound_out, void \*p_ans_obuf)
***********************************************************************

    该函数为LINK音频降噪算法，实现算法的启动，并添加到音频链路上，其中参数： :: 
        1. p_sound_out：前级sound
        2. p_ans_obuf：数据输出cbuf

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


int ans_run(void \*hld, short \*inbuf, int len)
***********************************************************************

    该函数为降噪算法数据处理流程。

    该降噪算法固定输入128个样点，经（NoiseSuppress_Process）处理后输出。