延时/滤波器类模块设计文档

本文档覆盖以下模块：ut_delay_20ch_v1、common_eq_v1、eq_4ch_v1、source_eq_v1、speed_eq_v1、ut_eq_20ch_v1。

ut_delay_20ch_v1 — UT 延迟 20ch

概述

UT（Unit Test）专用 20 通道延迟模块，延迟范围 0~960 个采样点（48kHz 下约 0~20ms），通道名使用标准车载 20 通道命名。

分类：delay
UI 组件：GenericTuningDialog.vue
通道数：20ch
通道名：标准车载 20 通道名（FLH … SWF）

参数

参数 ID	类型	范围	默认值	说明
`enable`	bool	—	`true`	启用/禁用
`delay`	int	0 ~ 960 smp，步长 1	0	各通道独立延迟采样数（perChannel，20ch）

delay 为 perChannel 参数，channel 字段 0~19。

UI 布局

┌────────────────────────────────────────────────────┐
│ ⏻  ut_delay_20ch_inst · UT 延迟 20ch          ×  │
├────────────────────────────────────────────────────┤
│ 延迟 (smp)                                         │
│  FLH   ○══════════════  [0~960]  [  0]            │
│  FRH   ○══════════════  [0~960]  [  0]            │
│  ...（共 20 行）                                   │
└────────────────────────────────────────────────────┘

WebSocket 协议

{ "type": "set_params", "instanceId": "ut_delay_0", "paramId": "delay", "value": 48, "channel": 0 }

DSP 内存布局

Offset	Size	类型	说明
0	1 B	uint8	`enable`
1	80 B	int32×20	`delay[0..19]`（采样数）
总计	81 B	—	`binarySize: 81`

common_eq_v1 — 通用 EQ

概述

单通道 10 频段参量均衡器，支持 7 种滤波器类型（FL/LP/HP/LSV/HSV/PK/AP），不含 perChannel 扩展（全局均衡适用于总线处理）。

分类：filter
UI 组件：GenericTuningDialog.vue
通道数：20ch（全局 EQ，参数不拆分通道）

参数

共 1（enable）+ 10×4 = 41 个参数。每个频段 b（0~9）：

参数 ID	类型	范围	默认值	说明
`enable`	bool	—	`true`	启用/禁用
`type#b`	enum	FL/LP/HP/LSV/HSV/PK/AP	PK	Band b+1 滤波器类型
`freq#b`	float	20 ~ 20000 Hz，步长 1	1000	Band b+1 中心/截止频率
`gain#b`	float	-14 ~ 14 dB，步长 0.1	0	Band b+1 增益（对 LP/HP 无效）
`q#b`	float	0.1 ~ 10，步长 0.01	0.71	Band b+1 Q 值

滤波器类型： - FL — 平坦（直通） - LP — 低通 - HP — 高通 - LSV — 低架式（Low Shelf） - HSV — 高架式（High Shelf） - PK — 峰值（Peaking） - AP — 全通（All-Pass）

UI 布局（示例 Band 0~3）

┌────────────────────────────────────────────────────┐
│ ⏻  common_eq_inst · 通用 EQ                   ×  │
├────────────────────────────────────────────────────┤
│ Band1 类型   [PK ▼]                                │
│ Band1 频率  ══════○══════  [20~20000]  [1000]      │
│ Band1 增益  ════════○════  [-14~14]    [0.0]       │
│ Band1 Q值   ════════○════  [0.1~10]    [0.71]      │
│ ─────────────────────────────────────────────────  │
│ Band2 类型   [PK ▼]                                │
│ ...（共 10 组）                                    │
└────────────────────────────────────────────────────┘

WebSocket 协议

{ "type": "set_params", "instanceId": "common_eq_0", "paramId": "type#0", "value": "HSV" }
{ "type": "set_params", "instanceId": "common_eq_0", "paramId": "freq#0", "value": 8000 }
{ "type": "set_params", "instanceId": "common_eq_0", "paramId": "gain#0", "value": 3.5 }
{ "type": "set_params", "instanceId": "common_eq_0", "paramId": "q#0",    "value": 0.71 }

DSP 内存布局

Offset	Size	类型	说明
0	1 B	uint8	`enable`
1	4 B	uint8/uint32	`type#0` ~ `type#9`（枚举索引）
5	4×10 B	float32×10	`freq#0` ~ `freq#9`
45	4×10 B	float32×10	`gain#0` ~ `gain#9`
85	4×10 B	float32×10	`q#0` ~ `q#9`
总计	≈ 161 B	—	`binarySize: 1+1044 = 161`

eq_4ch_v1 — 4ch EQ

概述

四通道均衡器，通道为 FL/FR/RL/RR，每通道各 15 个频段（仅支持 freq/gain/q 三参数，类型固定为 PK）。

分类：filter
UI 组件：GenericTuningDialog.vue
通道数：4ch（FL/FR/RL/RR）

参数

共 1（enable）+ 15×3 perChannel（4ch）= 181 个参数。每频段 b（0~14）：

参数 ID	类型	范围	默认值	说明
`enable`	bool	—	`true`	启用/禁用
`freq#b`	float	20 ~ 20000 Hz，步长 1	100	Band b+1 频率（perChannel，4ch）
`gain#b`	float	-14 ~ 14 dB，步长 0.1	0	Band b+1 增益（perChannel，4ch）
`q#b`	float	0.1 ~ 10，步长 0.1	1.0	Band b+1 Q 值（perChannel，4ch）

UI 布局

┌────────────────────────────────────────────────────┐
│ ⏻  eq_4ch_inst · 4ch EQ                       ×  │
├────────────────────────────────────────────────────┤
│ Band1 频率 (Hz)                                    │
│  FL    ══════○═══════════  [20~20000]  [100]       │
│  FR    ══════○═══════════  [20~20000]  [100]       │
│  RL    ══════○═══════════  [20~20000]  [100]       │
│  RR    ══════○═══════════  [20~20000]  [100]       │
│ Band1 增益 (dB)                                    │
│  FL    ════════○══════════  [-14~14]   [0.0]       │
│  ...（共 15 组 × 3 行 × 4 通道）                  │
└────────────────────────────────────────────────────┘

WebSocket 协议

// 设置 FL 通道 Band1 频率
{ "type": "set_params", "instanceId": "eq_4ch_0", "paramId": "freq#0", "value": 200, "channel": 0 }
// 设置 RR 通道 Band3 增益
{ "type": "set_params", "instanceId": "eq_4ch_0", "paramId": "gain#2", "value": -3.0, "channel": 3 }

DSP 内存布局

Offset	Size	类型	说明
0	1 B	uint8	`enable`
1	4×15×3×4 B	float32	`freq/gain/q` × 15bands × 4ch
总计	≈ 721 B	—	`binarySize: 1+1543*4 = 721`

source_eq_v1 — Source EQ

概述

源信号均衡器，结构与 common_eq_v1 完全一致（10 频段，全局，7 种滤波器类型），专门用于对输入源信号进行均衡处理（区别于 common_eq_v1 的总线均衡）。

分类：filter
UI 组件：GenericTuningDialog.vue
参数：与 common_eq_v1 完全相同（参见上文）

WebSocket 协议

{ "type": "set_params", "instanceId": "source_eq_0", "paramId": "gain#2", "value": 2.5 }

DSP 内存布局

与 common_eq_v1 完全相同，binarySize: 161。

speed_eq_v1 — Speed EQ

概述

按车速档位切换的均衡器，DSP 侧根据当前车速在多组 EQ 曲线间平滑切换。上位机侧参数结构与 common_eq_v1 一致（10 频段），但实际 DSP 可能维护多个曲线集合，由车速信号选择激活。

分类：filter
UI 组件：GenericTuningDialog.vue
参数：与 common_eq_v1 完全相同（参见上文）

WebSocket 协议

{ "type": "set_params", "instanceId": "speed_eq_0", "paramId": "freq#5", "value": 3000 }

DSP 内存布局

与 common_eq_v1 完全相同，binarySize: 161。

ut_eq_20ch_v1 — UT EQ 20ch

概述

UT 专用 20 通道均衡器，参数结构与 geq_v1（GEQ 图形均衡器）完全一致，支持每通道最多 50 个频段（每频段 4 参数：类型/频率/增益/Q），通道 perChannel 展开。

分类：filter
UI 组件：GenericTuningDialog.vue
通道数：20ch，每通道最多 50 频段

参数

每频段 b（0~49），perChannel（20ch）：

参数 ID	类型	范围	默认值	说明
`enable`	bool	—	`true`	启用/禁用
`bandsPerChannel`	int	1 ~ 50，步长 1	5	每通道激活频段数
`bandType#b`	enum	LP/HP/PK/LSV/HSV	PK	Band b+1 类型（perChannel，20ch）
`bandFreq#b`	float	20 ~ 20000 Hz，步长 1	1000	Band b+1 频率（perChannel，20ch）
`bandGain#b`	float	-24 ~ 24 dB，步长 0.1	0	Band b+1 增益（perChannel，20ch）
`bandQ#b`	float	0.1 ~ 20，步长 0.01	0.707	Band b+1 Q 值（perChannel，20ch）

WebSocket 协议

// FLH 通道（ch=0）Band 1 频率
{ "type": "set_params", "instanceId": "ut_eq_0", "paramId": "bandFreq#0", "value": 500, "channel": 0 }
// SWF 通道（ch=19）Band 3 增益
{ "type": "set_params", "instanceId": "ut_eq_0", "paramId": "bandGain#2", "value": -6.0, "channel": 19 }

DSP 内存布局

Offset	Size	类型	说明
0	1 B	uint8	`enable`
1	4 B	int32	`bandsPerChannel`
5	50×20×4×4 B	float32/enum	每频段每通道 4 参数
总计	≈ 16005 B	—	`binarySize: 1+4+50204*4 = 16005`