语音/逻辑/参数交互/调试类模块设计文档

本文档覆盖以下模块：ecnr_v1、logic_v1、param_gen_v1、log_window_v1、td_chime_v1。

ecnr_v1 — EC/NR 回声消除/降噪

概述

综合语音增强模块，集成回声消除（EC）、降噪（NR）、自动增益控制（AGC）、语音活动检测（VAD）和去混响（Dereverberation）五大功能，适用于车载免提通话和语音识别前处理。

分类：voice
UI 组件：GenericTuningDialog.vue
通道数：2ch 输入/输出（麦克风 + 参考信号）

参数

参数 ID	类型	范围	默认值	说明
`enable`	bool	—	`true`	启用/禁用
`denoise`	float	0 ~ 1，步长 1	1	降噪功能（0=关/1=开）
`agc`	float	0 ~ 1，步长 1	1	AGC 功能（0=关/1=开）
`vad`	float	0 ~ 1，步长 1	0	VAD 功能（0=关/1=开）
`dervb`	float	0 ~ 1，步长 1	0	去混响功能（0=关/1=开）
`nsSprs`	float	-100 ~ 0 dB，步长 1	-15	噪声抑制量
`ecSprs`	float	-100 ~ 0 dB，步长 1	-40	回声抑制量
`ecSprsAct`	float	-100 ~ 0 dB，步长 1	-15	回声激活阈值
`smpRate`	float	8000 ~ 48000 Hz，步长 1000	16000	处理采样率
`inSmpRate`	float	8000 ~ 48000 Hz，步长 1000	48000	输入采样率
`tailLen`	int	800 ~ 8000 smp，步长 100	1600	回声尾长（采样数）
`frmLen`	int	160 ~ 800 smp，步长 1	160	处理帧长（采样数）
`rsmpQ`	int	1 ~ 10，步长 1	10	重采样质量（1=低/10=高）
`agcIncr`	float	0 ~ 12 dB，步长 1	12	AGC 增量步长
`agcDecr`	float	-40 ~ 0 dB，步长 1	-40	AGC 减量步长
`agcMax`	float	0 ~ 30 dB，步长 1	20	AGC 最大增益
`agcLvl`	int	0 ~ 32767，步长 1	8000	AGC 目标电平（线性值）
`dervbLvl`	float	0 ~ 100 %，步长 1	0	去混响强度
`dervbDcy`	float	0 ~ 100 %，步长 1	0	去混响衰减速度
`prbStr`	float	0 ~ 100 %，步长 1	35	VAD 概率强度
`prbCtn`	float	0 ~ 100 %，步长 1	20	VAD 概率持续时间

UI 布局

┌──────────────────────────────────────────────────────┐
│ ⏻  ecnr_inst · EC/NR                           ×   │
├──────────────────────────────────────────────────────┤
│ 启用       [开]                                      │
│ 降噪       ════════════○  [0~1]      [1]            │
│ AGC        ════════════○  [0~1]      [1]            │
│ VAD        ○════════════  [0~1]      [0]            │
│ 去混响     ○════════════  [0~1]      [0]            │
│ 噪声抑制   ════════════○  [-100~0]   [-15]          │
│ 回声抑制   ════════════○  [-100~0]   [-40]          │
│ 回声激活   ════════════○  [-100~0]   [-15]          │
│ 处理采样率 ══════○══════  [8k~48k]  [16000]         │
│ 输入采样率 ══════════════○ [8k~48k]  [48000]        │
│ 回声尾长   ══════○══════  [800~8000] [1600]         │
│ 帧长       ○═════════════  [160~800]  [160]         │
│ 重采样质量 ═══════════════○ [1~10]    [10]          │
│ AGC 增量   ═══════════════○ [0~12]    [12]          │
│ AGC 减量   ○═════════════  [-40~0]   [-40]          │
│ AGC 最大   ═══════════════○ [0~30]    [20]          │
│ AGC 目标电平 ══════════════ [0~32767] [8000]        │
│ 去混响强度 ○════════════  [0~100]    [0]            │
│ 去混响衰减 ○════════════  [0~100]    [0]            │
│ VAD 概率强度 ════════○════ [0~100]   [35]           │
│ VAD 概率持续 ════○════════ [0~100]   [20]           │
└──────────────────────────────────────────────────────┘

WebSocket 协议

{ "type": "set_params", "instanceId": "ecnr_0", "paramId": "denoise",  "value": 1 }
{ "type": "set_params", "instanceId": "ecnr_0", "paramId": "nsSprs",   "value": -20 }
{ "type": "set_params", "instanceId": "ecnr_0", "paramId": "tailLen",  "value": 2400 }
{ "type": "set_params", "instanceId": "ecnr_0", "paramId": "agcLvl",   "value": 12000 }

DSP 内存布局

binarySize: 256，21 个参数按声明顺序线性排布（uint8/int32/float32 混合）。

logic_v1 — 逻辑处理

概述

基于车辆信号（RPM/速度/踏板/扭矩）的逻辑增益控制模块，根据实时信号驱动 DSP 参数变化，实现驾驶状态自适应音效。

分类：logic
UI 组件：GenericTuningDialog.vue
通道数：20ch

参数

参数 ID	类型	范围	默认值	说明
`enable`	bool	—	`true`	启用/禁用
`rpm`	float	600 ~ 8000 rpm，步长 1	1000	发动机转速
`speed`	float	0 ~ 240 km/h，步长 1	0	车速
`app`	float	0 ~ 100 %，步长 1	0	踏板开度（APP）
`torque`	float	-500 ~ 5000 Nm，步长 1	0	发动机扭矩

UI 布局

┌────────────────────────────────────────────────────┐
│ ⏻  logic_inst · 逻辑处理                     ×   │
├────────────────────────────────────────────────────┤
│ 启用        [开]                                   │
│ RPM       ════○══════════════  [600~8000]  [1000]  │
│ 速度      ○══════════════════  [0~240]     [   0]  │
│ APP（踏板）○═════════════════  [0~100]     [   0]  │
│ 扭矩      ═════════○══════════ [-500~5000] [   0]  │
└────────────────────────────────────────────────────┘

WebSocket 协议

{ "type": "set_params", "instanceId": "logic_0", "paramId": "rpm",    "value": 3000 }
{ "type": "set_params", "instanceId": "logic_0", "paramId": "speed",  "value": 80 }
{ "type": "set_params", "instanceId": "logic_0", "paramId": "app",    "value": 60 }
{ "type": "set_params", "instanceId": "logic_0", "paramId": "torque", "value": 250 }

DSP 内存布局

Offset	Size	类型	说明
0	1 B	uint8	`enable`
1	4 B	float32	`rpm`
5	4 B	float32	`speed`（km/h）
9	4 B	float32	`app`（%）
13	4 B	float32	`torque`（Nm）
17 ~ 127	保留
总计	128 B	—	`binarySize: 128`

param_gen_v1 — 参数生成器

概述

动态参数生成器，根据车辆信号（LFO/线性/梯度/平滑）自动生成 DSP 参数值并下发到目标模块，实现参数自动化控制。上位机侧仅暴露时间常数参数。

分类：paramInteraction
UI 组件：GenericTuningDialog.vue
通道数：20ch（透传）

参数

参数 ID	类型	范围	默认值	说明
`enable`	bool	—	`true`	启用/禁用
`upTime`	float	1 ~ 5000 ms，步长 1	100	参数上升时间常数
`downTime`	float	1 ~ 5000 ms，步长 1	500	参数下降时间常数

UI 布局

┌─────────────────────────────────────────────────┐
│ ⏻  param_gen_inst · 参数生成器             ×   │
├─────────────────────────────────────────────────┤
│ 启用       [开]                                 │
│ 上升时间  ═══○════════════  [1~5000]  [100]     │
│ 下降时间  ══════════○══════  [1~5000]  [500]    │
└─────────────────────────────────────────────────┘

WebSocket 协议

{ "type": "set_params", "instanceId": "param_gen_0", "paramId": "upTime",   "value": 200 }
{ "type": "set_params", "instanceId": "param_gen_0", "paramId": "downTime",  "value": 1000 }

DSP 内存布局

Offset	Size	类型	说明
0	1 B	uint8	`enable`
1	4 B	float32	`upTime`（ms）
5	4 B	float32	`downTime`（ms）
9 ~ 63	保留
总计	64 B	—	`binarySize: 64`

log_window_v1 — 日志窗口

概述

DSP 调试日志显示模块，不对音频信号做任何处理（透传），仅提供与 DSP 日志系统的接口，用于开发和调试阶段查看 DSP 内部运行状态。

分类：debug
UI 组件：GenericTuningDialog.vue
通道数：20ch（透传，不处理）

参数

参数 ID	类型	范围	默认值	说明
`enable`	bool	—	`true`	启用/禁用（禁用时停止日志采集）

UI 布局

┌─────────────────────────────────────────────────┐
│ ⏻  log_window_inst · 日志窗口             ×   │
├─────────────────────────────────────────────────┤
│ 启用   [开]                                     │
└─────────────────────────────────────────────────┘

WebSocket 协议

{ "type": "set_params", "instanceId": "log_window_0", "paramId": "enable", "value": false }

DSP 内存布局

Offset	Size	类型	说明
0	1 B	uint8	`enable`
总计	1 B	—	`binarySize: 1`

td_chime_v1 — TD 提示音

概述

TD（Transit Display）系统提示音播放控制模块，负责播放系统通知音效，支持音量控制。不对外部音频输入做处理，输出为内部合成的提示音信号。

分类：debug
UI 组件：GenericTuningDialog.vue
通道数：20ch

参数

参数 ID	类型	范围	默认值	说明
`enable`	bool	—	`true`	启用/禁用
`volume`	float	-96 ~ 0 dB，步长 0.1	-6	提示音音量

UI 布局

┌──────────────────────────────────────────────────┐
│ ⏻  td_chime_inst · TD 提示音              ×    │
├──────────────────────────────────────────────────┤
│ 启用    [开]                                     │
│ 音量   ═════════════○  [-96~0]  [-6.0]          │
└──────────────────────────────────────────────────┘

WebSocket 协议

{ "type": "set_params", "instanceId": "td_chime_0", "paramId": "enable", "value": true }
{ "type": "set_params", "instanceId": "td_chime_0", "paramId": "volume", "value": -12.0 }

DSP 内存布局

Offset	Size	类型	说明
0	1 B	uint8	`enable`
1	4 B	float32	`volume`（dB）
总计	5 B	—	`binarySize: 5`