ESP32-LyraT V4.2 音频开发板入门指南:硬件架构、DIP 开关配置与 ESP-ADF 应用开发

原创2026-10-14 10:42:141,861 阅读
文章标签:音视频音频处理视频处理嵌入式物联网智能硬件人工智能AI 应用语音MCP 服务即时通讯

ESP32-LyraT V4.2 音频开发板入门指南:硬件架构、DIP 开关配置与 ESP-ADF 应用开发

本篇技术指南围绕 ESP-ADF(Espressif Advanced Development Framework for Multimedia Applications)配套的 ESP32-LyraT V4.2 音频开发板展开,系统讲解板载硬件资源、引脚分配、Function DIP Switch 的三种硬件工作模式,以及从零开始搭建开发环境、烧录并运行首个音频应用的完整流程。读完本文,你将能够正确配置板卡硬件跳线与拨码开关、看懂板级原理图上的关键信号分配,并借助 ESP-ADF 在 ESP32-LyraT V4.2 上快速启动音频播放类项目。

概述与适用场景

ESP32-LyraT 是乐鑫(Espressif)推出的面向双核 ESP32 芯片的音频开发板硬件平台,专为音频类应用设计:Wi-Fi / Bluetooth 音频音箱、语音遥控器、带音频功能的智能家居设备等。它在 ESP32 芯片自带资源之外,额外提供了完整的音频编解码、放大与接口电路,让开发者可以专注于应用层逻辑的开发。

开始使用前,你需要准备以下物料:

物料 数量与规格说明
ESP32-LyraT V4.2 开发板 1 块(本文后续简称为“板卡”)
扬声器或 3.5 mm 耳机 2 个。若使用扬声器,建议额定功率不超过 3 W,需准备 JST PH 2.0 2-Pin 插头;开发阶段也可用杜邦母头跳线代替
Micro-USB 2.0 线(Type A 转 Micro B) 2 根
电脑(PC) 1 台,支持 Windows、Linux 或 macOS

注意:本文出现的上标 * 均表示该产品处于 EOL(停产) 状态,例如 ESP32-WROVER Module*,下文不再重复说明。

板卡的核心硬件构成如下:

  • ESP32-WROVER Module*:集成 Wi-Fi / BT 连接与数据处理能力,并板载 32 Mbit SPI Flash 与 32 Mbit PSRAM,提供灵活的数据存储空间
  • Audio Codec Chip:音频编解码芯片
  • 板载双麦克风
  • 耳机输入接口
  • 2 × 3 W 扬声器输出
  • 双路辅助音频输入(AUX)
  • MicroSD 卡槽(支持 1 线或 4 线模式)
  • 六个按键(2 个物理按键 + 4 个触摸按键)
  • JTAG 排针
  • 集成 USB-UART 桥接芯片
  • 锂离子电池充电管理电路

下图为 ESP32-LyraT 的主要组成及组件间连接关系:

ESP32-LyraT 整体框图

硬件功能详解

板卡上各关键组件、接口与控制件的功能说明如下。

核心模块与状态指示

  • ESP32-WROVER Module*:板卡主控,提供 Wi-Fi / BT 连接、数据处理能力,内部集成 32 Mbit SPI Flash 与 32 Mbit PSRAM。
  • 绿色与红色 LED:两盏通用 LED,由 ESP32-WROVER Module* 通过专用 API 控制,用于指示音频应用的特定运行状态。
  • USB-UART 桥接芯片:单芯片 USB-UART 桥,最高支持 1 Mbps 传输速率。
  • USB-UART Port:PC 与 ESP32 模块之间的通信接口。
  • USB Power Port:为板卡提供电源。

拨码开关与调试接口

  • Function DIP Switch(功能拨码开关):用于配置 GPIO12~GPIO15 的功能。这几个引脚在 JTAG Header 与 MicroSD Card 之间共享。默认所有开关处于 OFF 位置时启用 MicroSD Card;若需启用 JTAG Header,则将第 3、4、5、6 位拨到 ON。当不使用 JTAG 且 MicroSD 卡运行在单线模式时,GPIO12 与 GPIO13 可另作他用。
  • JTAG Header:提供 ESP32-WROVER Module* 的 JTAG 接口,可用于调试、应用烧录以及应用级追踪(Application Level Tracing)等功能。使用前必须先通过 Function DIP Switch 使能;JTAG 工作时 MicroSD 卡不可用,应断开。
  • UART Header:串口,引出 ESP32-WROVER Module* 与 USB-UART 桥接芯片之间的串行 TX/RX 信号。
  • I2C Header:引出 I2C 接口,ESP32-WROVER Module* 与 Audio Codec Chip 均挂接在该接口上。
  • I2S Header:引出 I2S 接口,ESP32-WROVER Module* 与 Audio Codec Chip 均挂接在该接口上。

音频输入输出链路

  • Left / Right Microphone(左/右麦克风):板载麦克风,连接到 Audio Codec Chip 的 IN1 输入。
  • AUX Input(辅助输入):辅助输入插座,使用 3.5 mm 立体声插头连接,接到 Audio Codec Chip 的 IN2(左、右声道)。
  • Headphone Output(耳机输出):连接 3.5 mm 立体声插头耳机的输出插座。
  • Left / Right Speaker Output(左/右扬声器输出):扬声器输出插座,推荐 4 Ω / 3 W 扬声器,引脚间距 2.00 mm(0.08 英寸)。
  • PA Chip(功率放大器):放大 Audio Codec Chip 输出的立体声音频信号,用于驱动两只扬声器。
  • Audio Codec Chip(音频编解码芯片):即 ES8388,一款带耳机放大器的低功耗立体声音频编解码器,包含 2 通道 ADC、2 通道 DAC、麦克风放大器、耳机放大器、数字音效、模拟混音与增益功能。它与 ESP32-WROVER Module* 通过 I2S(音频数据)与 I2C(控制寄存器)总线连接,独立于应用完成硬件级音频处理。

按键、电源与烧录控制

  • Boot / Reset 按键:按住 Boot 并短暂按下 Reset 可进入固件下载模式,随后即可通过串口烧录固件;单独按 Reset 则复位系统。
  • Touch Pad Buttons(触摸按键):四块触摸板,标注为 Play、Sel、Vol+ 与 Vol-,连接到 ESP32-WROVER Module*,用于配合专用 API 开发与测试音频应用 UI。
  • Function Press Keys(功能按键):两个标注为 Rec 与 Mode 的按键,同样连接到 ESP32-WROVER Module*,供音频应用 UI 开发测试使用。
  • EN Header / IO0 Header:在这两个排针上安装跳线帽即可启用应用自动下载功能;两个排针的跳线帽需同时安装或同时移除。
  • Power On Switch(电源开关):拨向左为开机,拨向右为关机。
  • Battery Socket(电池插座):两针插座,用于连接单节锂离子电池。
  • Battery Charger Chip(电池充电芯片):型号 AP5056,单节锂离子电池恒流/恒压线性充电器,通过 Micro USB Port 为电池充电。
  • Standby / Charging LEDs(待机/充电指示灯):绿色 Standby LED 指示 Micro USB Port 已上电;红色 Charging LED 指示电池正在充电。
  • Power On LED(开机指示灯):红色 LED,指示 Power On Switch 已打开。

注意:Power On Switch 不会影响/切断锂离子电池的充电回路,即关机状态下电池仍可通过 USB 充电。

下图为板卡整体布局标注(各组件编号与上表一一对应):

ESP32-LyraT V4.2 板卡布局图

硬件配置选项:Function DIP Switch

板卡通过 Function DIP Switch(8 位拨码开关)提供多种硬件配置方式。三种标准配置模式如下。

模式一:MicroSD 卡 1 线模式(默认)

DIP SW 位置
1 OFF
2 OFF
3 OFF
4 OFF
5 OFF
6 OFF
7 OFF¹
8 n/a

¹ 将 DIP SW 7 拨到 ON 可启用 AUX Input 检测。

此模式下:

  • JTAG 功能不可用
  • Vol- 触摸按键可供 API 使用

模式二:MicroSD 卡 4 线模式

DIP SW 位置
1 ON
2 ON
3 OFF
4 OFF
5 OFF
6 OFF
7 OFF
8 n/a

此模式下:

  • JTAG 功能不可用
  • Vol- 触摸按键不可供 API 使用
  • AUX Input 检测(API 层面)不可用

模式三:使能 JTAG

DIP SW 位置
1 OFF
2 OFF
3 ON
4 ON
5 ON
6 ON
7 ON
8 n/a

此模式下:

  • MicroSD Card 功能不可用,需从卡槽中取出卡
  • Vol- 触摸按键不可供 API 使用
  • AUX Input 检测(API 层面)不可用

每位开关的完整含义

结合上述模式,第 1~8 位开关的功能汇总如下:

位 开关 OFF 开关 ON
1 GPIO12 未分配 MicroSD 卡 4 线模式
2 触摸 Vol- 启用 MicroSD 卡 4 线模式
3 MicroSD 卡 JTAG
4 MicroSD 卡 JTAG
5 MicroSD 卡 JTAG
6 MicroSD 卡 JTAG
7 MicroSD 卡 4 线 AUX IN 检测¹
8 未使用 未使用

¹ 注意:启用 AUX IN 检测后,系统上电时 AUX Input 信号线不应插接,否则 ESP32 可能无法正常启动。

ESP32 引脚分配

板卡将 ESP32 的若干引脚分配给了板载硬件,其中部分引脚(如 GPIO0、GPIO2)承担多路功能。以下各表是开发时的权威参考;如需更详细的信息,请查阅 ESP32-LyraT V4.2 原理图(schematic)。

红/绿 LED

序号 ESP32 Pin LED 颜色
1 GPIO19 Red LED
2 GPIO22 Green LED

触摸板

序号 ESP32 Pin 触摸板功能
1 GPIO33 Play
2 GPIO32 Set
3 GPIO13 Vol-¹
4 GPIO27 Vol+

¹ Vol- 功能在启用 JTAG 或 MicroSD 卡 4 线模式下不可用。

MicroSD 卡槽 / J5

序号 ESP32 Pin MicroSD 信号
1 MTDI / GPIO12 DATA2
2 MTCK / GPIO13 CD / DATA3
3 MTDO / GPIO15 CMD
4 MTMS / GPIO14 CLK
5 GPIO2 DATA0
6 GPIO4 DATA1
7 GPIO21 CD

注意:MicroSD Card 在 JTAG 使能时不可使用。

UART Header / JP2

序号 排针引脚
1 3.3V
2 TX
3 RX
4 GND

EN 与 IO0 排针 / JP23 与 J24

EN Header(JP23):

序号 ESP32 Pin 排针引脚
1 n/a EN_Auto
2 EN EN

IO0 Header(J24):

序号 ESP32 Pin 排针引脚
1 n/a IO0_Auto
2 GPIO0 IO0

在这两组排针上同时安装跳线帽,即可由串口工具自动控制 EN / IO0 完成应用自动下载。

I2S Header / JP4

序号 排针引脚 ESP32 Pin
1 MCLK GPIO0
2 SCLK GPIO5
3 LRCK GPIO25
4 DSDIN GPIO26
5 ASDOUT GPIO35
6 GND GND

I2S 总线是 ESP32 与 Audio Codec Chip 之间的音频数据通道:DSDIN 承载送往 codec 的 DAC 数据,ASDOUT 承载来自 codec ADC 的采集数据。

I2C Header / JP5

序号 排针引脚 ESP32 Pin
1 SCL GPIO23
2 SDA GPIO18
3 GND GND

I2C 总线是 ESP32 与 Audio Codec Chip 之间的控制通道,用于读写 codec 寄存器(如音量、混音、增益等配置)。

JTAG Header / JP7

序号 ESP32 Pin JTAG 信号
1 MTDO / GPIO15 TDO
2 MTCK / GPIO13 TCK
3 MTDI / GPIO12 TDI
4 MTMS / GPIO14 TMS

注意:JTAG 在 MicroSD 卡使能时不可使用。

从硬件到软件:codec 驱动的仓库实现佐证

ESP32-LyraT 系列板卡的编解码芯片是 ES8388,ESP-ADF 的 esp_codec_dev 组件为其提供了完整驱动。从源码结构看,板卡的软件架构遵循“控制通道 + 数据通道”分离的设计:

  • 控制通道(I2C):驱动通过 audio_codec_ctrl_if_t 接口的 read_reg / write_reg 读写 ES8388 寄存器,例如在 es8388.c 中通过 es8388_write_reg 配置 ES8388_MASTERMODE(设置 codec 工作在 I2S Slave 模式)、ES8388_DACCONTROL5 / ES8388_DACCONTROL4(DAC 音量)等寄存器;
  • 数据通道(I2S):音频 PCM 数据通过 audio_codec_data_if_t 接口传输,由 esp_codec_dev_write() / esp_codec_dev_read() 完成播放与录音。

ES8388 的默认 I2C 地址为 0x20(备用地址 0x22),配置结构 es8388_codec_cfg_t(见 es8388_codec.h)支持指定工作模式(ESP_CODEC_DEV_WORK_MODE_BOTH 等)、主从模式、PA 使能引脚(pa_pin)、PA 有效电平(pa_reverted)与硬件增益(hw_gain)。PA 控制与 codec 生命周期绑定:es8388.c 中的 es8388_enable_pa 会根据 pa_pin 与 pa_reverted 自动开/关功率放大器。

值得一提的设计细节:ES8388 的 DAC 音量寄存器支持 0.5 dB 步进,驱动内部将音量范围映射为 -96 dB(静音)到 0 dB(最大),这也是 ESP-ADF 上层音量 API 以 0~100 整数控制、每刻度 0.5 dB 的底层来源。对板级设计感兴趣的读者还可参考 project-design.rst 中关于“带 codec 芯片项目”的软件架构说明。

开始应用开发

在给 ESP32-LyraT V4.2 上电前,请先检查板卡外观完好、无肉眼可见损伤。

初始硬件设置

按以下步骤完成首次应用烧录前的板卡准备:

  1. 在 IO0 与 EN 排针上安装跳线帽,以启用应用自动烧录;若没有跳线帽,可通过 Boot / RST 按键手动触发烧录。
  2. 将扬声器连接到 Right 与 Left Speaker Output;耳机可(可选)连接到 Headphone Output。
  3. 将两根 Micro-USB 线分别连接 PC 与 ESP32-LyraT 的 两个 USB 端口(USB-UART Port 与 USB Power Port)。
  4. 绿色 Standby LED 应点亮。若未接电池,红色 Charging LED 会每隔几秒闪烁一次。
  5. 将 Power On Switch 拨向左侧。
  6. 红色 Power On LED 应点亮。

若 LED 状态与上述一致,板卡即已准备好接收固件,接下来在 PC 上安装与配置开发工具。

搭建软件环境并运行首个应用

板卡就绪后,按 ESP-ADF 的标准流程完成以下步骤(完整步骤参见 ESP-ADF 快速入门文档):

  1. 设置 ESP-IDF:为 ESP32(及 ESP32-S2)芯片安装基于 C 语言的通用开发框架;
  2. 获取 ESP-ADF:克隆 ESP-ADF 仓库以安装音频应用专用 API;
  3. 设置环境:运行 export 脚本,使构建工具链感知音频专用 API。以 Linux / macOS 为例:
cd esp-adf
./install.sh
. ./export.sh
  1. 启动项目:选择一个示例音频应用。仓库当前将例程统一组织在 adf_examples/ 目录下,例如 SD 卡音乐播放器 music_player 例程,其工程入口与板级初始化代码位于 main/app_main.c 与 main/music_player_board.c。进入工程目录:
cd adf_examples/player/music_player
idf.py set-target esp32
idf.py menuconfig
  1. 连接设备:通过 USB 连接板卡,确认串口可见并正常通信(记住串口名,后续命令中使用);
  2. 构建项目:
idf.py build
idf.py -p PORT flash monitor

idf.py flash 会自动完成构建与烧录;若未安装自动烧录跳线,需在烧录工具显示 “Connecting” 之前按住 Boot 键、短按 Reset 键再松开 Boot 键进入下载模式。烧录完成后按 Reset 键运行应用,即可通过扬声器/耳机听到音频输出;退出串口监视器按 Ctrl-]。

提示:仓库例程普遍支持通过 idf.py bmgr(ESP Board Manager)选择开发板。esp_boards 组件提供的板型列表中包含 esp32_lyrat_4_3 等同系列板卡,板级外设(SD 卡、DAC、LCD 等)由板级管理器统一初始化,例如 music_player_board.c 中通过 esp_board_manager_init_device_by_name() 依次初始化 FS_SDCARD 与 AUDIO_DAC,并以 esp_codec_dev_open() / esp_codec_dev_set_out_vol() 配置输出。对于支持 CLI 控制的多源播放场景,可参考 play_music_control 例程,其支持 SD 卡本地音频、HTTP(S) 在线音频与 Flash LittleFS 提示音的混合播放,并提供 scan、list、play、set_vol 等串口命令。

相关文档

如需进一步深入,可继续阅读仓库内的以下文档:

说明:ESP32-LyraT V4.2 使用的 ESP32-WROVER 模块已处于 EOL 状态,选型时建议关注同系列后续版本(如 V4.3 的 ESP32-WROVER-E 模块)与乐鑫最新的音频开发板方案。

登录后查看全文
esp-adf