ESP 音频分析工具

[English]

ESP 音频分析工具（ESP Audio Analyzer）简介

随着智能音频设备的快速发展及应用场景的不断拓展，音频效果与系统性能要求持续提升。乐鑫推出全新音频分析工具，提供便捷高效的测试方式与规范化流程，结合直观易用的网页界面与配套测试工程，支持开展标准化的音频测试。

借助该工具，用户可对麦克风、扬声器及 AEC 等关键音频模块进行全面检测，快速定位并排查系统问题，从而有效提升开发效率与产品质量。

平台功能

• 功能全面：覆盖麦克风、扬声器、AEC 三大模块，共 11 项音频测试

• 适配便捷：基于 ESP Board Manager，支持快速适配不同硬件

• 性能分析：提供 THD、SNR 等音频指标，供参考评估系统性能

• 标准化流程：提供统一的测试方法和评判标准

• 源数据下载：支持原始录音文件导出，便于复测和深入分析

• 可视化报告：生成结构化测试报告，包含数据、图表及测试结果

已发布：

• 测试网页：https://audio-tools.espressif.com.cn/

• 配套工程：https://github.com/espressif/esp-adf/tree/master/adf_examples/checks/esp_audio_analyzer_app

备注

此工程无需依赖 ADF 环境，所有依赖通过组件管理器自动下载。

通过组件管理器直接下载工程：https://components.espressif.com/components/espressif/adf_examples/versions/0.1.0/examples/esp_audio_analyzer_app?language=zh

测试流程

1. 环境准备：下载配套的测试工程，并根据测试环境要求，准备电脑、外接音响、麦克风等必要设备，确保硬件齐全并可正常使用。

2. 硬件适配：测试工程的硬件适配能力由 ESP Board Manager 提供，可通过配置硬件描述文件一键生成板级支持代码。

3. 工程配置：根据工程 README 配置 Wi-Fi 等参数，编译并烧录至设备，设备将连接 Wi-Fi 并启动 WebSocket 服务器。

4. 设备连接：根据设备日志提示访问设备地址，手动信任证书后，在音频测试网页左侧输入框确认设备 URL，点击 “连接设备” 后即可开始测试。

5. 音频测试：点击标题栏各测试项启动测试，可对同一测试项多次重复测试以获取稳定结果，测试过程中保持设备网络连接稳定。

6. 生成报告：测试完成后进入测试报告页面下载测试报告，包括详细数据、图表及优化建议等。

首页：

测试项目页：

数据上传分析：

测试报告获取页：

测试报告示例：

• 测试报告示例.pdf

测试项目

序号	测试项	测试方法	测试数据	输出结果
1	麦克风结构气密性验证	音响播放白噪音，待测硬件录制（封堵麦克风重复录制）	2 个 WAV	Pass/Acceptable/Deficient
2	麦克风电声特性	音响播放 1kHz 正弦波，待测硬件录制	WAV	Pass/Acceptable/Deficient, SNR, THD
3	麦克风频响曲线	音响播放连续扫频，待测硬件录制	WAV	Pass/Acceptable/Deficient, Deviation
4	麦克风底噪	无播放，待测硬件封堵麦克风录制	WAV	Pass/Acceptable/Deficient, Noise_Level, Peak
5	麦克风阵列响度一致性	音响播放 1kHz 正弦波，待测硬件录制	WAV	Pass/Acceptable/Deficient, Level
6	麦克风阵列频率响应一致性	音响播放连续扫频，待测硬件录制	WAV	Pass/Acceptable/Deficient, Deviation
7	麦克风阵列相位一致性	音响播放 1kHz 正弦波，待测硬件录制	WAV	Pass/Acceptable/Deficient, Phase
8	喇叭电声特性	待测硬件播放 1kHz 正弦波，其他设备录制	WAV	Pass/Acceptable/Deficient, SNR, THD
9	喇叭扫频测试	待测硬件播放阶跃扫频，其他设备录制	WAV	Pass/Acceptable/Deficient, Level, THD
10	喇叭 PA 底噪	待测硬件播放静音音频，其他设备录制	WAV	Pass/Acceptable/Deficient, Noise_Level, Peak
11	AEC 回声信号相关	待测硬件同时播放录制 1kHz 正弦波	WAV	Pass/Acceptable/Deficient, THD, Level

FAQ

设备经常断开连接

• 请确保电脑和设备连接到同一个 Wi-Fi 网络

• 为了提升连接稳定性，请在干扰较小的环境下进行测试

录制到的音频数据过少，或录制提前中断

• 常见原因是音频数据量过大，导致发送不及时。可以尝试增加 app_websocket.c 中 WS_AUDIO_BUFFER_SIZE 的大小

• 可以尝试提升 Wi-Fi 性能，参考 Wi-Fi 性能优化 文档进行优化，或缩短设备与路由器的距离

无法启动 WebSocket 服务器

• 常见原因是系统内部内存不足，推荐开启 PSRAM 以保留更多内部内存空间

编译链接时提示 IRAM 空间不足

• 请参考 IRAM 优化 文档关闭不必要的优化选项