ESP32-LyraT V4.2 音频开发板入门指南:硬件架构、DIP 开关配置与 ESP-ADF 应用开发
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-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 充电。
下图为板卡整体布局标注(各组件编号与上表一一对应):
硬件配置选项: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 上电前,请先检查板卡外观完好、无肉眼可见损伤。
初始硬件设置
按以下步骤完成首次应用烧录前的板卡准备:
- 在 IO0 与 EN 排针上安装跳线帽,以启用应用自动烧录;若没有跳线帽,可通过 Boot / RST 按键手动触发烧录。
- 将扬声器连接到 Right 与 Left Speaker Output;耳机可(可选)连接到 Headphone Output。
- 将两根 Micro-USB 线分别连接 PC 与 ESP32-LyraT 的 两个 USB 端口(USB-UART Port 与 USB Power Port)。
- 绿色 Standby LED 应点亮。若未接电池,红色 Charging LED 会每隔几秒闪烁一次。
- 将 Power On Switch 拨向左侧。
- 红色 Power On LED 应点亮。
若 LED 状态与上述一致,板卡即已准备好接收固件,接下来在 PC 上安装与配置开发工具。
搭建软件环境并运行首个应用
板卡就绪后,按 ESP-ADF 的标准流程完成以下步骤(完整步骤参见 ESP-ADF 快速入门文档):
- 设置 ESP-IDF:为 ESP32(及 ESP32-S2)芯片安装基于 C 语言的通用开发框架;
- 获取 ESP-ADF:克隆 ESP-ADF 仓库以安装音频应用专用 API;
- 设置环境:运行 export 脚本,使构建工具链感知音频专用 API。以 Linux / macOS 为例:
cd esp-adf
./install.sh
. ./export.sh
- 启动项目:选择一个示例音频应用。仓库当前将例程统一组织在
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
- 连接设备:通过 USB 连接板卡,确认串口可见并正常通信(记住串口名,后续命令中使用);
- 构建项目:
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 入门指南:同系列较早版本板卡的入门说明
- ESP32-LyraT V4.3 硬件参考:V4.3 板卡的完整引脚分配、电源分布与自动烧录说明
- ESP32-LyraT 入门指南:LyraT 系列总览
- ESP-ADF 快速入门:开发环境安装、工程创建、构建与烧录的完整分步指南
- ES8388 驱动 API 文档 与 驱动源码
- ESP32-LyraT V4.2 原理图(PDF)(如存在则以此为准,或参考乐鑫官网对应原理图文件)
- ESP32 Datasheet 相关内容可对照板卡布局实物查看
说明:ESP32-LyraT V4.2 使用的 ESP32-WROVER 模块已处于 EOL 状态,选型时建议关注同系列后续版本(如 V4.3 的 ESP32-WROVER-E 模块)与乐鑫最新的音频开发板方案。

