ESP32:非 Arduino 方式驱动 MAX98357A 实现旋律音频播放

极梦网络无忧

已于 2025-02-14 03:14:40 修改

阅读量2.3k

点赞数 11

文章标签：音视频机器人单片机 ESP32

于 2025-02-14 03:02:27 首次发布

本文链接：https://blog.csdn.net/wangzhae/article/details/145603221

版权

一、引言

在嵌入式开发的世界里，让设备播放特定旋律的音频是一件既有趣又具有挑战性的事情。本教程将引导新手使用 ESP32 结合 VSCode 开发环境，以非 Arduino 的方式驱动 MAX98357A 数字功放与喇叭，实现旋律音频的播放。我们会详细介绍从环境搭建、库安装、硬件连接、代码编写到最终烧录的每一个步骤。

因为我没有买专本的腔体喇叭，所以我这边刚开始发出的是沙沙电流音、后来改成了这个后，发出的是有节奏的噗噗音；才确认算是成功的

二、准备工作

硬件准备

ESP32 开发板：作为核心控制单元，负责处理和输出音频数据。
数字功放 MAX98357A 模块：将 ESP32 输出的微弱音频信号放大，以驱动喇叭发出足够响亮的声音。
喇叭：- 腔体喇叭：8Ω 2~3W 或 4Ω 2~3W
杜邦线：用于连接各个硬件模块，确保信号稳定传输。

软件准备

VSCode：一款功能强大且开源的代码编辑器，支持丰富的插件扩展，非常适合嵌入式开发。
ESP - IDF 扩展：在 VSCode 的扩展商店中搜索 “ESP - IDF” 并安装，它能帮助我们集成 ESP - IDF 开发环境。
ESP - IDF 开发框架：从 Espressif 官方网站下载并安装最新版本的 ESP - IDF 开发框架。

三、安装必要的库

1. 安装 VSCode 和 ESP - IDF 扩展

从 VSCode 官方网站下载并安装适合你操作系统的版本。打开 VSCode 后，点击扩展图标，搜索 “ESP - IDF” 并安装。安装完成后，按照提示配置 ESP - IDF 的路径和 Python 解释器。

2. 验证库安装

在 VSCode 终端输入 idf.py --version，如果能正确显示版本信息，说明 ESP - IDF 环境已经配置成功。

四、硬件连接

按照以下表格进行硬件连接：

ESP32	数字功放 MAX98357A
GPIO7	DIN数字信号
GPIO15	BCLK 位时钟
GPIO16	RC 左/右时钟
3v3/3.3v	Vin（或VCC）电源输入短接 SD 关机频道（短接两个共用一个3.3v针脚）
GND	GND 接地短接 GAIN 增益和频道（短接两个共用一个GND针脚）
	音频+ 接喇叭正极（一般红线，不清楚问卖家、或用万用表测或其他方法）
	音频- 接喇叭负极

连接时要确保杜邦线插紧，避免松动导致接触不良。

五、代码实现

#include <stdio.h>
#include "driver/i2s.h"
#include "esp_log.h"
#include <math.h>

// 定义 I2S 接口编号
#define I2S_NUM I2S_NUM_0
// 定义与 MAX98357A 连接的引脚
#define DIN_PIN 7
#define BCLK_PIN 15
#define LRC_PIN 16
// 定义音频采样率，常见的音频采样率为 44100Hz
#define SAMPLE_RATE 44100
// 定义音频数据的振幅，16 位音频数据的最大值为 32767
#define AMPLITUDE 32767

// 定义一些常见音符的频率
#define NOTE_C4 261.63
#define NOTE_D4 293.66
#define NOTE_E4 329.63
#define NOTE_F4 349.23
#define NOTE_G4 392.00
#define NOTE_A4 440.00
#define NOTE_B4 493.88

// 定义一段简单旋律的音符数组
float melody_notes[] = {
    NOTE_C4, NOTE_D4, NOTE_E4, NOTE_F4,
    NOTE_G4, NOTE_A4, NOTE_B4, NOTE_C4 * 2
};

// 定义每个音符的持续时间（以节拍为单位）
int note_durations[] = {
    4, 4, 4, 4,
    4, 4, 4, 4
};

// 定义日志标签，用于区分不同模块的日志信息
static const char *TAG = "MelodyPlayer";

// 初始化 I2S 接口的函数
static void i2s_init(void) {
    // 定义 I2S 配置结构体
    i2s_config_t i2s_config = {
       .mode = I2S_MODE_MASTER | I2S_MODE_TX,  // 设置为 I2S 主模式且用于发送数据
       .sample_rate = SAMPLE_RATE,  // 设置采样率
       .bits_per_sample = I2S_BITS_PER_SAMPLE_16BIT,  // 每个采样点使用 16 位表示
       .channel_format = I2S_CHANNEL_FMT_ONLY_LEFT,  // 单声道模式，只使用左声道
       .communication_format = I2S_COMM_FORMAT_I2S,  // 使用 I2S 标准通信格式
       .dma_buf_count = 8,  // 设置 DMA 缓冲区的数量
       .dma_buf_len = 64,  // 设置每个 DMA 缓冲区的长度
       .use_apll = false  // 不使用 APLL 时钟
    };

    // 定义 I2S 引脚配置结构体
    i2s_pin_config_t pin_config = {
       .bck_io_num = BCLK_PIN,  // 设置 BCLK 引脚
       .ws_io_num = LRC_PIN,  // 设置 LRC 引脚
       .data_out_num = DIN_PIN,  // 设置 DIN 引脚
       .data_in_num = -1  // 不使用数据输入引脚
    };

    // 安装 I2S 驱动程序
    esp_err_t err = i2s_driver_install(I2S_NUM, &i2s_config, 0, NULL);
    if (err != ESP_OK) {
        // 若安装失败，输出错误日志
        ESP_LOGE(TAG, "I2S driver install failed: %s", esp_err_to_name(err));
        return;
    }

    // 设置 I2S 引脚
    err = i2s_set_pin(I2S_NUM, &pin_config);
    if (err != ESP_OK) {
        // 若设置引脚失败，输出错误日志
        ESP_LOGE(TAG, "I2S set pin failed: %s", esp_err_to_name(err));
        return;
    }
}

// 播放单个音符的函数
void play_note(float frequency, int duration) {
    int samples = duration * SAMPLE_RATE / 1000;  // 计算该音符需要播放的采样点数
    for (int i = 0; i < samples; i++) {
        // 生成正弦波音频数据
        int16_t sample = (int16_t)(AMPLITUDE * sin(2 * M_PI * frequency * i / SAMPLE_RATE));
        size_t bytes_written;
        // 通过 I2S 接口写入音频数据
        esp_err_t err = i2s_write(I2S_NUM, &sample, sizeof(sample), &bytes_written, portMAX_DELAY);
        if (err != ESP_OK) {
            // 若写入失败，输出错误日志
            ESP_LOGE(TAG, "I2S write failed: %s", esp_err_to_name(err));
        }
    }
    // 音符之间的短暂停顿
    for (int i = 0; i < SAMPLE_RATE / 10; i++) {
        int16_t sample = 0;
        size_t bytes_written;
        esp_err_t err = i2s_write(I2S_NUM, &sample, sizeof(sample), &bytes_written, portMAX_DELAY);
        if (err != ESP_OK) {
            ESP_LOGE(TAG, "I2S write failed: %s", esp_err_to_name(err));
        }
    }
}

// 主函数，程序的入口点
void app_main(void) {
    i2s_init();  // 调用 I2S 初始化函数

    int num_notes = sizeof(melody_notes) / sizeof(melody_notes[0]);  // 计算音符数量

    while (1) {  // 无限循环，持续播放旋律
        for (int i = 0; i < num_notes; i++) {
            play_note(melody_notes[i], note_durations[i]);  // 依次播放每个音符
        }
    }
}

六、代码解释

1. 头文件包含

stdio.h：提供标准输入输出功能，如 printf 等。
driver/i2s.h：ESP - IDF 提供的 I2S 驱动库，用于配置和控制 I2S 接口。
esp_log.h：用于输出调试日志，方便开发过程中的问题排查。
math.h：提供数学函数，这里用于生成正弦波音频数据。

2. 宏定义

I2S_NUM：指定使用的 I2S 接口编号。
DIN_PIN、BCLK_PIN、LRC_PIN：定义与 MAX98357A 连接的引脚。
SAMPLE_RATE、AMPLITUDE：分别定义音频采样率和振幅。
NOTE_*：定义常见音符的频率。

3. 数组定义

melody_notes：存储一段简单旋律的音符频率。
note_durations：存储每个音符的持续时间。

4. `i2s_init` 函数

配置 i2s_config_t 结构体，设置 I2S 接口的工作模式、采样率、位深度等参数。
配置 i2s_pin_config_t 结构体，指定 I2S 接口使用的引脚。
调用 i2s_driver_install 安装 I2S 驱动程序。
调用 i2s_set_pin 设置 I2S 接口的引脚。

5. `play_note` 函数

根据传入的音符频率和持续时间，生成正弦波音频数据并通过 I2S 接口发送。
音符之间添加短暂停顿，使播放效果更自然。

6. `app_main` 函数

调用 i2s_init 初始化 I2S 接口。
计算音符数量，在无限循环中依次播放每个音符，实现旋律的循环播放。

七、编译与烧录

1. 编译项目

在 VSCode 终端输入 idf.py build，ESP - IDF 会对代码进行编译和链接，生成可烧录的固件文件。如果编译过程中出现错误，根据错误提示修改代码。

2. 烧录固件

将 ESP32 开发板通过 USB 连接到电脑，在 VSCode 终端输入 idf.py -p /dev/ttyUSB0 flash（/dev/ttyUSB0 需要根据你电脑实际识别的串口设备进行修改），将固件烧录到 ESP32 开发板。

3. 烧录注意事项

确保开发板正确连接到电脑，且串口设备路径正确。
若烧录失败，检查硬件连接和开发板是否处于正确的烧录模式。

八、测试与调试

烧录完成后，喇叭应该会循环播放我们定义的简单旋律。如果没有声音，可以按以下步骤排查：

检查硬件连接是否松动或接错。
查看 VSCode 终端的日志输出，检查是否有错误信息。
检查代码中的参数配置是否正确。

九、总结

通过本教程，你学会了如何使用 ESP32 结合 VSCode 和 ESP - IDF 开发框架，以非 Arduino 的方式驱动 MAX98357A 和喇叭实现旋律音频播放。从环境搭建、硬件连接到代码编写和烧录，每一步都进行了详细介绍。你可以在此基础上进一步完善代码，添加更多的旋律或实现更复杂的音频效果，开启更多有趣的嵌入式开发项目。