EffectTool(eq)调试工具说明文档

📎 原始文档：https://www.kdocs.cn/l/cqh2Iw8Or8xz

EQ调试工具说明文档

Zhuhai Jieli Technologyco.,LTD

版权所有，未经许可，禁止外传

版权所有，侵权必究 1
地址：珠海市吉大石花西路 107号9栋综合楼邮编：519015
电话：0756-6313088 传真：0756-6313081
网站：www.zh-jieli.com

修改记录

版本	更新日期	描述
V1.0	2021/03/12	本文档适用AC695N_soundbox_sdk_release_ 1.0.0版本、以及在1.0.0版本更新的 sdk 版本
V1.0	2021/05/12	增加适用AC700N_earphone_release_V1.0.0版本、以及在1.0.0版本更新的 sdk 版本

版权所有，侵权必究 2
目录
1.文档介绍.............................................................................................................................................................................. 5

1.文档目的................................................................................................................................................................... 5
1.2.参考文献................................................................................................................................................................... 5
[1] ...................................................................................................................................................................................... 5
1.3.术语与缩写词........................................................................................................................................................... 5
2.功能概述.............................................................................................................................................................................. 5
3.其他系统/模块的调用关系................................................................................................................................................. 5
4.性能要求.............................................................................................................................................................................. 5
5.在线 EQ 调试.....................................................................................................................................................................6
1.软件流程修改方法................................................................................................................................................... 6
5.2.通讯方式................................................................................................................................................................... 6
PC工具使用流程方法：..................................................................................................................................................... 7
1.打开配置工具入口，选中新EQ工具.................................................................................................................... 8
6.2.工具UART配置...................................................................................................................................................... 8
6.3.通信是否成功........................................................................................................................................................... 9
6.4.调试各个EQ效果.................................................................................................................................................. 10
6.5. EQ 滤波器特性介绍............................................................................................................................................... 15
6.6. drc 限幅器、多带限幅器、压缩器、多带压缩器调节........................................................................................ 18
6.7.导出固件eq_ cfg_hw.bin ........................................................................................................................................ 22
6.8.下载eq_ cfg_hw.bin ................................................................................................................................................ 22
eq_ cfg_ hw.bin文件重编辑................................................................................................................................................23
8.直接打开工具，进行离线编辑........................................................................................................................................ 26
1.选中对应芯片版本、以及eq版本，点击离线编辑........................................................................................... 26
8.2.设置各个EQ需要使用的段数..............................................................................................................................26
8.3.编辑完成，导出固件eq_ cfg_hw.bin .................................................................................................................... 29
8.4.下载eq_ cfg_hw.bin ................................................................................................................................................ 29
9.蓝牙串口调试eq............................................................................................................................................................... 30
1.软件修改................................................................................................................................................................. 30
9.2.蓝牙串口连接说明................................................................................................................................................. 31
9.2. 1.连上蓝牙.............................................................................................................................................. 31
9.2.2.更多蓝牙配置...................................................................................................................................... 31
9.2.3.传出（电脑启动连接）...................................................................................................................... 31
9.2.4.选中目标蓝牙名................................................................................................................................ 32
9.2.5.打开eq工具.........................................................................................................................................33
9.2.6.选中打开蓝牙串口.............................................................................................................................. 33
9.2.7.通信查询否成功.................................................................................................................................. 34
9.2.8.调试对应模式...................................................................................................................................... 34
9.2.9. drc 限幅器、多带限幅器、压缩器、多带压缩器调节...............................................................38
9.2.10.导出固件eq_ cfg_hw.bin ....................................................................................................................41
9.2. 11.下载eq_ cfg_hw.bin ............................................................................................................................41
10.手机app调试eq.............................................................................................................................................................43
版权所有，侵权必究 3
1.打开Audi。T。。ls，点击“EQ”......................................................................................................................... 45
10.2.点击 “连接”，选择对应的设备，并与之连接............................................................................................... 45
10.3.连接成功，会显示当前的可调的EQ模式，比如普通音频EQ、通话宽频下行EQ等.............................. 46
10.4.比如点击MODE：普通音频EQ，进入设置界面............................................................................................ 46
10.5.点击编辑，进入EQ 曲线调试介面....................................................................................................................46
10.6.如何确定调节的参数是否已经生效................................................................................................................... 47
10.7.在线调试时，参数实时生效............................................................................................................................... 49
10.8.调试完成，点击保存参数。 ............................................................................................................................... 49
10.9.下载eq_ cfg_hw.bin .............................................................................................................................................. 50
版权所有，侵权必究 4

1.文档介绍

1.3.术语与缩写词

缩写、术语	解释

4.性能要求

版权所有，侵权必究 5
地址：珠海市吉大石花西路 107号9栋综合楼邮编：519015
电话：0756-6313088 传真：0756-6313081
网站：www.zh-jieli.com

5.在线 EQ 调试

5.1.软件流程修改方法

修改使用的板机配置文件，例如：board_ac695x_demo_cfg.h 开启动宏TCFG_EQ_ONLINE_ENABLE

5.2.通讯方式

使用串口通讯，默认使用usb DP DM做调试口，波特率 115200，可根据实际使用改用别的IO
如出现无法调试，请检查串口是否被占用，导致无法调试
例如：充电仓的使能了，占用了串口导致串口不够用，无法调试？
例如：usb功能使能了，导致dp dm 无法用作串口，无法调试？版权所有，侵权必究 6

6. PC工具使用流程方法：

6.2.工具UART配置

选用对应COM 口，波特率 115200，普通uart调试时，不选蓝牙串口
版权所有，侵权必究 8

6.3.通信是否成功

点击打开，通讯成功左下角会提示查询版本
有关 sdk对应的 eq版本，请查看eq_config.c文件
版权所有，侵权必究 9

EffectTool EQ调试工具，可调式音乐EQ、以及通话上下行EQ
选中下拉列表，调试对应模式(5种模式:通话宽频下行EQ、通话窄频下行EQ、通话宽频上行EQ、通话窄频下行EQ、普通音频EQ)。
其中蓝牙、music、 linein、 fm、 pc模式播歌的eq对应普通音频EQ。对5种eq进行调节后，导出eq_cfg_hw.bin。
如果是四声道独立eq效果，则有8个模式。其中普通音频EQ、 FR_EQ、 RL_EQ、 RR_EQ 分别对应dac 的 FL、FR、RL、RR 四个通道。对8种eq进行调节后，导出eq_cfg_hw.bin。
版权所有，侵权必究 10

例如：选中普通音频EQ后，点击编辑

版权所有，侵权必究 11
版权所有，侵权必究 12
看到此界面，可以根据需对每一段eq 的频率、增益、q值以及滤波器类型进行调节，调节完毕点击关闭
版权所有，侵权必究 13
注意：EQ调节后，如果最大增益大于0db，信号输出存在削顶失真的情况。
例如：
避免失真有两种方法：
1、通过软件使用限幅器来限制信号的动态范围，避免失真。
2、降低EQ总增益,使最大增益小于等于0db，避免失真。例如：
版权所有，侵权必究 14

6.5. EQ 滤波器特性介绍

Band Pass(带通滤波器)：调节某一频率范围内的频率分量增益
例如：中心截止频率500Hz、增益-3db,Q值0.7（Q值越大通带范围越窄）
High Pass(高通滤波器)：让某一频率以上的信号分量通过
例如：中心截止频率500Hz、 Q值0.7（Q值越大斜率越大，同时导致500Hz 附近增益凸起），增益对高通滤波器无效
版权所有，侵权必究 15
Low Pass(低通滤波器)：让某一频率以下的信号分量通过
例如：中心截止频率500Hz、 Q值0.7（Q值越大斜率越大，同时导致500Hz 附近增益凸起），增益对低通滤波器无效
版权所有，侵权必究 16
High Shelf(高架滤波器)：整体增加或减少，某一频率以上的频率分量
例如：总增益-3db，中心截止频率500Hz、增益3db,Q值0.7（Q值越大斜率越大，同时导致500Hz 附近增益凸起）
Low Shelf(低架滤波器)：整体增加或减少，某一频率以下的频率分量
例如：总增益-3db，中心截止频率500Hz、增益3db,Q值0.7（Q值越大斜率越大，同时导致500Hz 附近增益凸起）
版权所有，侵权必究 17

6.6. drc 限幅器、多带限幅器、压缩器、多带压缩器调节

限幅器：

使音频信号维持在一定的幅度范围内并且不引起饱和失真阈值：是指限幅器启动的信号能量阈值
启动时间：是指当信号能量超过阈值后限幅器启动滞后的时间
释放时间：是指当信号能量从超过阈值回落到阈值之下时，衰减恢复所需的时间

压缩器：

使音频信号按比例进行压缩。
阈值 1、阈值2：是指压缩器启动的信号能量阈值
压缩比 1、压缩比2：是指信号的压缩比例
启动时间：是指当信号能量超过阈值后压缩器启动滞后的时间
释放时间：是指当信号能量从超过阈值回落到阈值之下时，衰减恢复所需的时间

分频器：

根据低频与中高频设置的频率，处理输入数据，输出低频、中频、和高频的三组数据。
分频器阶数：分频器过渡带的陡峭程度（值越大越陡峭，随之消耗的mips也会变大）分频器为多带限幅或者多带压缩器服务

多带限幅器：

对不同频带使用不同的限幅器；

多带压缩器

对不同频带使用不同的压缩器
版权所有，侵权必究 18
选中DRC设置的下拉列表，例如选限幅器，进行设置。
版权所有，侵权必究 19
如果四四声道独立EQ 时，FL、 FR通道 drc类型由FL通道选择的类型决定。RL、 RR通道 drc 类型由RL通道选择的类型决定。
例如：FL选择限幅器，FR通道就默认是限幅器，但FL FR两个通道的阈值可分别设置
版权所有，侵权必究 20
版权所有，侵权必究 21

6.7.导出固件eq_cfg_hw. bin

EQ与DRC调试完成后，点击导出固件eq_cfg_hw.bin 文件。

6.8.下载eq_cfg_hw. bin

将eq_cfg_hw.bin文件放到下载目录，并在download.bat中-res 后添加eq_cfg_hw.bin 文件，此外，调试完成需要将在线eq宏定义关闭,同时使能使用eq文件宏定义
版权所有，侵权必究 22

7. eq_cfg_hw.bin文件重编辑

选中打开固件配置（离线编辑），选中eq_cfg_hw.bin文件，就会弹出与在线调试一致的界面，此时可以对已有的eq_cfg_hw.bin文件进行修改，修改完成，导出固件
版权所有，侵权必究 23
版权所有，侵权必究 24
版权所有，侵权必究 25

8.直接打开工具，进行离线编辑

8.1.选中对应芯片版本、以及eq版本，点击离线编辑

当#define TCFG_EQ_DIVIDE_ENABLE 1时，四声道eq每个声道都是独立的eq，此时的版本选0.7.3.0。其余AC695N 的配置，请选择0.7.2.0

8.2.设置各个EQ需要使用的段数

弹出设置eq段数的界面，设置目标段数，点击确定，会弹出eq离线编辑界面。编辑完成导出固件.
其中通话上下行的eq段数，默认最大是3段。普通音频eq段数可查看sdk头文件确定，版权所有，侵权必究 26
例如：
版权所有，侵权必究 27
版权所有，侵权必究 28

8.3.编辑完成，导出固件eq_cfg_hw. bin

8.4.下载eq_cfg_hw. bin

将eq_cfg_hw.bin文件放到下载目录，并在download.bat中-res 后添加eq_cfg_hw.bin 文件，此外，调试完成需要将在线eq宏定义关闭,同时使能使用eq文件宏定义
版权所有，侵权必究 29

9.蓝牙串口调试eq

通讯成功后，使用方式参照普通串口调试。此处说明，如何使用电脑蓝牙与小机进行连接配置.

9.1.软件修改

使用蓝牙串口调试eq， sdk需要使能宏定义 APP_ONLINE_DEBUG 1
蓝牙串口调试，此处只描述，蓝牙串口和小机连接的过程。
连接成功后，调试的操作过程uart调试操作过程一致，请浏览文档中有关uart调试的操作过程
,
30

9.2.蓝牙串口连接说明

9.2.1.连上蓝牙

9.2.2.更多蓝牙配置

9.2.3.传出（电脑启动连接）

9.2.4.选中目标蓝牙名

选中对应蓝牙名

9.2.5.打开eq工具

选eq

9.2.6.选中打开蓝牙串口

操作打开后，其余调试操作与UART调试，操作方法一致选刚才传出的com 口，波特率默认 115200
版权所有，侵权必究 33

9.2.7.通信查询否成功

点击打开，通讯成功左下角会提示查询版本

9.2.8.调试对应模式

例如：选中普通音频EQ后，点击编辑

9.2.9. drc 限幅器、多带限幅器、压缩器、多带压缩器调节

限幅器：

压缩器：

分频器：

根据低频与中高频设置的频率，处理输入数据，输出低频、中频、和高频的三组数据分频器阶数：分频器过渡带的陡峭程度（值越大越陡峭，随之消耗的mips也会变大）分频器为多带限幅或者多带压缩器服务

多带限幅器：

对不同频带使用不同的限幅器；

多带压缩器

9.2.10.导出固件eq_cfg_hw. bin

9.2.11.下载eq_cfg_hw. bin

例如在earphne 的 standard sdk添加 eq_cfg_hw.bin

10.手机app调试eq

本方式的打开界面跟上面两种方式不一样，需要手机安装杰理的 audio-tools.apk。在对应的 SDK 包如下路径...\tools；目前只支持 android 手机的 APP 调试
#define APP_ONLINE_DEBUG 1//使用蓝牙SPP调试
版权所有，侵权必究 43
在线调试EQ功能，主要是在播歌、通话过程，根据需要，调整EQ各个参数。建议是先播歌或打电话，再进入工具界面，调整参数。调试完成，保存导出eq_cfg_hw. bin配置文件。
版权所有，侵权必究 44

10.1.打开Audio Tools，点击“EQ”

10.2.点击“连接”，选择对应的设备，并与之连接

10.3.连接成功，会显示当前的可调的EQ模式，比如普通音频EQ、通话宽频下行EQ等

10.4.比如点击MODE：普通音频EQ，进入设置界面

10.5.点击编辑，进入EQ曲线调试介面

10.6.如何确定调节的参数是否已经生效

10.7.在线调试时，参数实时生效

可通过测试仪器测量eq 曲线的准确性

10.8.调试完成，点击保存参数。

10.9.下载eq_cfg_hw. bin

将eq_cfg_hw.bin文件放到下载目录，并在download.bat 中-res 后添加eq_cfg_hw.bin文件。此外，调试完成需要将在线eq宏定义关闭,同时使能使用eq文件宏定义
版权所有，侵权必究 50
例如在earphne 的 standard sdk添加 eq_cfg_hw.bin
注意：外部的配置资源一定要放在-res这个所属项里头，例如eq_cfg_hw.bin 的资源，因为跟工具的识别项是同步的。
版权所有，侵权必究 51