【亲测免费】 ESP32-audioI2S 项目教程

2026-01-16 09:32:43作者：虞亚竹Luna

项目介绍

ESP32-audioI2S 是一个开源项目，旨在通过 I2S 接口在 ESP32 芯片上播放音频文件。该项目支持多种音频格式，包括 MP3、M4A 和 WAV，并且集成了 HELIX MP3 和 AAC 解码器，以及 OPUS、VORBIS 和 FLAC 解码器。ESP32-audioI2S 主要适用于多核 ESP32 芯片，如 ESP32-S3，不适用于 ESP32-S2 或 ESP32-C3。

项目快速启动

硬件准备

ESP32 开发板
SD 卡
I2S 音频解码器（如 MAX98357A、UDA1334A、PCM5102A 或 CS4344）

软件准备

Arduino IDE
ESP32-audioI2S 库

安装步骤

克隆项目仓库：

git clone https://github.com/schreibfaul1/ESP32-audioI2S.git

安装库：在 Arduino IDE 中，通过“项目”菜单选择“加载库” -> “添加 .ZIP 库”，然后选择克隆的仓库中的 ESP32-audioI2S 文件夹。

配置 WiFi 和音频文件：打开示例代码 PlayMP3FromSD，配置 WiFi 网络和音频文件路径：

#include "Arduino.h"
#include "WiFi.h"
#include "Audio.h"
#include "SD.h"
#include "FS.h"

// Digital I/O used
#define SD_CS 5
#define SPI_MOSI 23
#define SPI_MISO 19
#define SPI_SCK 18
#define I2S_DOUT 25
#define I2S_BCLK 27
#define I2S_LRC 26

Audio audio;
String ssid = "your_SSID";
String password = "your_PASSWORD";

void setup() {
    pinMode(SD_CS, OUTPUT);
    digitalWrite(SD_CS, HIGH);
    SPI.begin(SPI_SCK, SPI_MISO, SPI_MOSI);
    Serial.begin(115200);
    SD.begin(SD_CS);
    WiFi.disconnect();
    WiFi.mode(WIFI_STA);
    WiFi.begin(ssid, password);

    while (WiFi.status() != WL_CONNECTED) {
        delay(1000);
        Serial.println("Connecting to WiFi...");
    }

    audio.connecttoFS(SD, "/test.mp3");
}

void loop() {
    audio.loop();
}