工程配置开关说明文档
工程: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 互斥 |