跳转至

工程配置开关说明文档

工程:projects/nn_denoise_rtc_sample(通话降噪 / Flash 录音回放) 涉及文件: - project_file/makefile(编译期、决定链接哪个算法库与链接脚本) - src/user_config.h(编译期功能域开关) - src/ci_ssp_config.c (算法参数与在线调参) - system/sdk_default_config.h(#ifndef 默认值)


1. 第一部分:makefile 录音配置

1.1 开关定义(project_file/makefile)

USE_RTC_ENABLE_RECORD   := 0
USE_RTC_DISABLE_RECORD  := 1
#0: CI_RTC_TYPE = USE_RTC_ENABLE_RECORD,开启录音功能并且固件加密。
#1:CI_RTC_TYPE = USE_RTC_DISABLE_RECORD,关闭录音功能且固件未加密。

CI_RTC_TYPE := $(USE_RTC_ENABLE_RECORD)

ifeq ($(CI_RTC_TYPE), $(USE_RTC_ENABLE_RECORD))
C_FLAGS += -DUSE_FLASH_RECORD_PLAY_ENABLE=1
RTC_LINK_LDS := ../src/ci13lc_rtc_enable_record.lds
LIBS := -lrtc_enable_record
else ifeq ($(CI_RTC_TYPE), $(USE_RTC_DISABLE_RECORD))
C_FLAGS += -DUSE_FLASH_RECORD_PLAY_ENABLE=0
RTC_LINK_LDS := ../src/ci13lc_rtc_disable_record.lds
LIBS := -lrtc_disable_record
endif

只改 CI_RTC_TYPE 一行,不要手工改 -DUSE_FLASH_RECORD_PLAY_ENABLE。

1.2 两种取值完整对照

项 CI_RTC_TYPE = 0(USE_RTC_ENABLE_RECORD) CI_RTC_TYPE = 1(USE_RTC_DISABLE_RECORD)
预定义宏 USE_FLASH_RECORD_PLAY_ENABLE=1 USE_FLASH_RECORD_PLAY_ENABLE=0
算法库 libs/librtc_enable_record.a libs/librtc_disable_record.a
链接脚本 src/ci13lc_rtc_enable_record.lds src/ci13lc_rtc_disable_record.lds
固件加密 加密(配合 libs/libflash_encrypt.a) 不加密
SYS_HEAP_SIZE 1024*134(134 KB) 1024*168(168 KB)
录音功能 开(Flash 录音 + 回放) 关
IIS0 采音 不可用(编译 #error) 可用(自动 USE_IIS0_OUT_PRE_RSLT_AUDIO=1)
EQ 模块 不可用(编译 #error) 可用
VOX/AGC 可用 可用
Speex 编解码 可用 不可用
默认输出通路 HPOUT IIS0

2. 第二部分:user_config.h 算法开关

2.1 NN_DENOISE

#define DENOISE_STRENGTH_ADAPT_ENABLE  1   // 0:固定beta  1:按噪声能量自适应
#define DENOISE_TVAD                   0   // 0:关 1:人声才自适应(必须开VOX)

2.2 AGC / VOX

#define VOX_0_AGC_1   0   // 无 VOX,仅 AGC
#define VOX_1_AGC_0   0   // 仅 VOX(AGC 模块挂载但不做增益)
#define VOX_1_AGC_1   0   // VOX + AGC
组合 USE_AGC_MODULE agc_config.compute_agc 实际行为
全 0 0 — AGC 模块不挂载,无 VOX 判决
VOX_0_AGC_1=1 1 true 只做自动增益,不出 VOX 判决
VOX_1_AGC_0=1 1 未赋值(=false) 只出 VOX 判决,不调增益
VOX_1_AGC_1=1 1 true 增益 + VOX 判决同时工作

2.3 EQ 均衡器

#define USE_EQ_MODULE                  0   // 0:关 1:开   与录音互斥(#error)
#define SYS_BOOT_READ_EQ_DRC_FROM_NV   1   // 开机用 NV 的 EQ/DRC 参数

2.4 DRC 动态范围压缩

#define USE_DRC_MODULE   0   // 当前关闭

2.5 AHS 啸叫抑制

#define USE_AHS_MODULE   0   // 对讲/扩音场景建议开

2.6 ALC(模拟输入自动增益)

#define ALC_DEMO_CFG_INDEX   0    // 0 / 1 两组,二选一

3. 第四部分:编译期互锁矩阵(#error 全表)

# 触发条件 错误文本 处理
1 DENOISE_TVAD && !(VOX_1_AGC_0 \|\| VOX_1_AGC_1) use TVAD need VOX module enabled 开 VOX_1_AGC_0 或 VOX_1_AGC_1
2 USE_FLASH_RECORD_PLAY_ENABLE && USE_IIS0_OUT_PRE_RSLT_AUDIO FLASH RECORD PLAY and IIS0 out preslt audio can’t use togher 开录音时 USE_IIS0_OUT_PRE_RSLT_AUDIO 必须 0
3 USE_FLASH_RECORD_PLAY_ENABLE && USE_EQ_MODULE FLASH RECORD PLAY and EQ module can’t use togher 录音与 EQ 二选一(要 EQ 就 CI_RTC_TYPE=1)
4 (VOX_0_AGC_1 \|\| VOX_1_AGC_0 \|\| VOX_1_AGC_1) && !USE_AGC_MODULE use VOX module need AGC module enabled 正常不会触发(USE_AGC_MODULE 已自动派生);手改派生逻辑才会
5 USE_FLASH_RECORD_PLAY_ENABLE && !USE_SPEEX_STORE_LOCAL_ENABLE && (任一 VOX) …not support VOX module and speex store local disable togher 串口上行模式(USE_SPEEX_STORE_LOCAL_ENABLE=0)不支持 VOX
6 USE_FLASH_RECORD_PLAY_ENABLE && USE_AHS_MODULE && ((任一 VOX) \|\| USE_DRC_MODULE) …not support VOX module and AHS module or DRC module togher 录音模式下 AHS 只能”单独开”
7 USE_FLASH_RECORD_PLAY_ENABLE && ((任一 VOX) && USE_DRC_MODULE) …not support VOX module and DRC module togher 录音模式下 VOX 与 DRC 互斥