Skip to main content

使用 Seeed Studio XIAO ESP32S3 的麦克风

note

本文档由 AI 翻译。如您发现内容有误或有改进建议，欢迎通过页面下方的评论区，或在以下 Issue 页面中告诉我们：https://github.com/Seeed-Studio/wiki-documents/issues

在本教程中，我们将向您介绍如何使用 XIAO ESP32S3 Sense 扩展板上的麦克风。首先是 I2S 引脚的基本使用，我们将通过使用 I2S 和麦克风获取当前环境的响度，并在串口波形图中显示出来。然后我们将解释如何录制声音并将录制的声音保存到 SD 卡中。

Seeed Studio XIAO ESP32S3 Sense
立即购买 🖱️
caution

本教程的所有内容仅适用于 XIAO ESP32S3 Sense。

入门指南​

在开始教程内容之前，您可能需要提前准备以下硬件和软件。

安装扩展板（适用于 Sense）​

安装扩展板非常简单，您只需将扩展板上的连接器与 XIAO ESP32S3 上的 B2B 连接器对齐，用力按压并听到“咔哒”声，安装即完成。

准备 microSD 卡​

在处理保存录音的项目时，您可能需要一张 MicroSD 卡。

XIAO ESP32S3 Sense 支持最大 32GB 的 microSD 卡，因此如果您准备购买用于 XIAO 的 microSD 卡，请参考此规格。在使用 microSD 卡之前，请将其格式化为 FAT32 格式。

格式化后，您可以将 microSD 卡插入 microSD 卡槽。请注意插入方向，带有金手指的一面应朝内。

声音响度检测​

在第一个项目案例中，让我们检测环境中的噪音，并使用 Arduino IDE 的串口波形图显示麦克风检测到的环境响度。

以下是完整的示例程序。

tip

检查并确保您使用的是哪个版本的 esp32，以下示例适用于 2.0.x，后面的示例适用于 3.0.x 及更高版本。

#include <I2S.h>

void setup() {
  // 打开串口通信并等待端口打开：
  // 使用 115200 的波特率而不是 9600，以便在非原生 USB 端口上获得更快的数据速率
  Serial.begin(115200);
  while (!Serial) {
    ; // 等待串口连接，仅适用于原生 USB 端口
  }

  // 以 16 kHz 和 16 位每样本启动 I2S
  I2S.setAllPins(-1, 42, 41, -1, -1);
  if (!I2S.begin(PDM_MONO_MODE, 16000, 16)) {
    Serial.println("初始化 I2S 失败！");
    while (1); // 什么都不做
  }
}

void loop() {
  // 读取一个样本
  int sample = I2S.read();

  if (sample && sample != -1 && sample != 1) {
    Serial.println(sample);
  }
}
tip

上面的示例仅兼容 esp32 的 2.0.x，如果您使用的是最新版本（例如 3.0.x），请使用下面的示例。

#include <ESP_I2S.h>
I2SClass I2S;

void setup() {
  // 打开串口通信并等待端口打开：
  // 使用 115200 的波特率而不是 9600，以便在非原生 USB 端口上获得更快的数据速率
  Serial.begin(115200);
  while (!Serial) {
    ; // 等待串口连接，仅适用于原生 USB 端口
  }

  // 设置 42 PDM 时钟和 41 PDM 数据引脚
  I2S.setPinsPdmRx(42, 41);

  // 以 16 kHz 和 16 位每样本启动 I2S
  if (!I2S.begin(I2S_MODE_PDM_RX, 16000, I2S_DATA_BIT_WIDTH_16BIT, I2S_SLOT_MODE_MONO)) {
    Serial.println("初始化 I2S 失败！");
    while (1); // 什么都不做
  }
}

void loop() {
  // 读取一个样本
  int sample = I2S.read();

  if (sample && sample != -1 && sample != 1) {
    Serial.println(sample);
  }
}

将此程序上传到 XIAO ESP32S3 Sense 并打开 Serial Plotter，您将看到声音响度变化的曲线。

程序注释​

在程序开始时，我们需要首先导入 I2S 库以便使用麦克风引脚。

#include <I2S.h>

在 I2S 对象上调用 setAllPins() 函数以配置用于 I2S 接口的引脚。该函数接受五个整数参数，分别表示连接到 I2S 接口的位时钟、字选择、数据输入、数据输出和通道选择线的 GPIO 引脚。

I2S.setAllPins(-1, 42, 41, -1, -1);

在此代码中，-1 值表示未使用相应的引脚，而 42 和 41 值分别表示连接到字选择和数据输入线的 GPIO 引脚。数据输出和通道选择线在此配置中未使用，因此设置为 -1。

if (!I2S.begin(PDM_MONO_MODE, 16000, 16)) {
    Serial.println("初始化 I2S 失败！");
    while (1); // 什么都不做
}

在 I2S 对象上调用 begin() 函数以使用指定的参数初始化 I2S 接口：PDM_MONO_MODE、16000 Hz 采样率和 16-bit 分辨率。

tip

需要注意的是，对于当前的 ESP32-S3 芯片，我们只能使用 PDM_MONO_MODE，采样位宽只能是 16bit。仅采样率可以修改，但经过测试，16kHz 的采样率相对稳定。

int sample = I2S.read();

if (sample && sample != -1 && sample != 1) {
    Serial.println(sample);
}

read() 函数在 I2S 对象上被调用，用于从 I2S 接口读取单个音频样本。if 语句检查 sample 变量的值。如果 sample 的值不是 0、-1 或 1，则认为是有效的音频样本，并执行 if 块中的代码。在这种情况下，样本值会通过 Serial.println() 函数打印到串行控制台。

将录制的声音保存到 microSD 卡​

在接下来的项目中，我们将指导您如何结合 microSD 卡的功能，将录制的声音保存到 microSD 卡中。因此，请提前准备好 microSD 卡并将其格式化为 FAT32 格式。

如果这是您第一次在 XIAO ESP32S3 上使用 microSD 卡，您可以阅读 文件系统 Wiki 内容，了解 microSD 卡的安装和准备。

以下是该项目的 Arduino 程序。

tip

检查并确保您使用的是哪个版本的 esp32，以下示例适用于 2.0.x，下面的示例适用于 3.0.x 及更高版本。

/* 
 * WAV 录音机 for Seeed XIAO ESP32S3 Sense 
*/

#include <I2S.h>
#include "FS.h"
#include "SD.h"
#include "SPI.h"

// 根据需要进行更改
#define RECORD_TIME   20  // 秒，最大值为 240
#define WAV_FILE_NAME "arduino_rec"

// 为最佳效果请勿更改
#define SAMPLE_RATE 16000U
#define SAMPLE_BITS 16
#define WAV_HEADER_SIZE 44
#define VOLUME_GAIN 2

void setup() {
  Serial.begin(115200);
  while (!Serial) ;
  I2S.setAllPins(-1, 42, 41, -1, -1);
  if (!I2S.begin(PDM_MONO_MODE, SAMPLE_RATE, SAMPLE_BITS)) {
    Serial.println("初始化 I2S 失败！");
    while (1) ;
  }
  if(!SD.begin(21)){
    Serial.println("挂载 SD 卡失败！");
    while (1) ;
  }
  record_wav();
}

void loop() {
  delay(1000);
  Serial.printf(".");
}

void record_wav()
{
  uint32_t sample_size = 0;
  uint32_t record_size = (SAMPLE_RATE * SAMPLE_BITS / 8) * RECORD_TIME;
  uint8_t *rec_buffer = NULL;
  Serial.printf("准备开始录音...\n");

  File file = SD.open("/"WAV_FILE_NAME".wav", FILE_WRITE);
  // 将头信息写入 WAV 文件
  uint8_t wav_header[WAV_HEADER_SIZE];
  generate_wav_header(wav_header, record_size, SAMPLE_RATE);
  file.write(wav_header, WAV_HEADER_SIZE);

  // 使用 PSRAM 分配录音缓冲区
  rec_buffer = (uint8_t *)ps_malloc(record_size);
  if (rec_buffer == NULL) {
    Serial.printf("内存分配失败！\n");
    while(1) ;
  }
  Serial.printf("缓冲区大小: %d 字节\n", ESP.getPsramSize() - ESP.getFreePsram());

  // 开始录音
  esp_i2s::i2s_read(esp_i2s::I2S_NUM_0, rec_buffer, record_size, &sample_size, portMAX_DELAY);
  if (sample_size == 0) {
    Serial.printf("录音失败！\n");
  } else {
    Serial.printf("录制了 %d 字节\n", sample_size);
  }

  // 增加音量
  for (uint32_t i = 0; i < sample_size; i += SAMPLE_BITS/8) {
    (*(uint16_t *)(rec_buffer+i)) <<= VOLUME_GAIN;
  }

  // 将数据写入 WAV 文件
  Serial.printf("正在写入文件...\n");
  if (file.write(rec_buffer, record_size) != record_size)
    Serial.printf("写入文件失败！\n");

  free(rec_buffer);
  file.close();
  Serial.printf("录音结束。\n");
}

void generate_wav_header(uint8_t *wav_header, uint32_t wav_size, uint32_t sample_rate)
{
  // 参考此链接: http://soundfile.sapp.org/doc/WaveFormat/
  uint32_t file_size = wav_size + WAV_HEADER_SIZE - 8;
  uint32_t byte_rate = SAMPLE_RATE * SAMPLE_BITS / 8;
  const uint8_t set_wav_header[] = {
    'R', 'I', 'F', 'F', // ChunkID
    file_size, file_size >> 8, file_size >> 16, file_size >> 24, // ChunkSize
    'W', 'A', 'V', 'E', // Format
    'f', 'm', 't', ' ', // Subchunk1ID
    0x10, 0x00, 0x00, 0x00, // Subchunk1Size (16 for PCM)
    0x01, 0x00, // AudioFormat (1 for PCM)
    0x01, 0x00, // NumChannels (1 channel)
    sample_rate, sample_rate >> 8, sample_rate >> 16, sample_rate >> 24, // SampleRate
    byte_rate, byte_rate >> 8, byte_rate >> 16, byte_rate >> 24, // ByteRate
    0x02, 0x00, // BlockAlign
    0x10, 0x00, // BitsPerSample (16 bits)
    'd', 'a', 't', 'a', // Subchunk2ID
    wav_size, wav_size >> 8, wav_size >> 16, wav_size >> 24, // Subchunk2Size
  };
  memcpy(wav_header, set_wav_header, sizeof(set_wav_header));
}
tip

上述示例仅兼容 esp32 的 2.0.x 版本，如果您使用的是最新版本（例如 3.0.x），请使用以下示例。

#include "ESP_I2S.h"
#include "FS.h"
#include "SD.h"

void setup() {
  // 创建 I2SClass 的实例
  I2SClass i2s;

  // 创建变量以存储音频数据
  uint8_t *wav_buffer;
  size_t wav_size;

  // 初始化串口
  Serial.begin(115200);
  while (!Serial) {
    delay(10);
  }

  Serial.println("正在初始化 I2S 总线...");

  // 设置用于音频输入的引脚
  i2s.setPinsPdmRx(42, 41);

  // 以 16 kHz 的采样率和 16 位采样启动 I2S
  if (!i2s.begin(I2S_MODE_PDM_RX, 16000, I2S_DATA_BIT_WIDTH_16BIT, I2S_SLOT_MODE_MONO)) {
    Serial.println("初始化 I2S 失败！");
    while (1); // 停止运行
  }

  Serial.println("I2S 总线已初始化。");
  Serial.println("正在初始化 SD 卡...");

  // 设置用于 SD 卡访问的引脚
  if(!SD.begin(21)){
    Serial.println("挂载 SD 卡失败！");
    while (1) ;
  }
  Serial.println("SD 卡已初始化。");
  Serial.println("正在录制 20 秒的音频数据...");

  // 录制 20 秒的音频数据
  wav_buffer = i2s.recordWAV(20, &wav_size);

  // 在 SD 卡上创建文件
  File file = SD.open("/arduinor_rec.wav", FILE_WRITE);
  if (!file) {
    Serial.println("打开文件失败！");
    return;
  }

  Serial.println("正在将音频数据写入文件...");

  // 将音频数据写入文件
  if (file.write(wav_buffer, wav_size) != wav_size) {
    Serial.println("写入音频数据失败！");
    return;
  }

  // 关闭文件
  file.close();

  Serial.println("应用程序完成。");
}

void loop() {
  delay(1000);
  Serial.printf(".");
}

要执行此示例，我们需要使用 ESP-32 芯片的 PSRAM 功能，因此请在上传代码之前将其打开。

该程序仅在用户打开串行监视器后执行一次，录制 20 秒并将录音文件保存到 microSD 卡中，文件名为 "arduino_rec.wav"。

当串行监视器每秒输出一个 "." 时，程序执行完成，您可以通过读卡器播放录制的声音文件。

tip

要从 XIAO ESP32S3 播放录制的音频，您可能需要使用支持 WAV 格式的音频播放器。

程序注释​

在此程序中，我们为录音功能编写了两个函数，一个是 record_wav()，另一个是 generate_wav_header()。

  • record_wav()：录音功能。在此函数中，程序通过 I2S 接口从麦克风读取音频数据，并将其存储到 SD 卡中作为 WAV 音频文件。

    a. 初始化变量。程序定义了一个用于存储录音数据的缓冲区 rec_buffer，并设置了录音时间 RECORD_TIME。

    b. 打开 WAV 文件。程序使用 SD.open() 函数打开一个 WAV 音频文件，并将其文件名定义为 WAV_FILE_NAME。

    c. 写入 WAV 文件头。程序使用 generate_wav_header() 函数生成 WAV 音频文件的头部信息，并将其写入已打开的 WAV 文件中。

    d. 分配内存并开始录音。程序使用 ps_malloc() 函数在 ESP32S3 的 PSRAM 中分配一块内存，用于存储录音数据，并使用 esp_i2s::i2s_read() 函数从麦克风读取音频数据。读取的数据存储在 rec_buffer 缓冲区中。

    e. 增加音量。程序通过 VOLUME_GAIN 常量定义的增益值增加录音数据的音量。

    f. 将录音数据写入 WAV 文件。程序使用 file.write() 函数将录音数据写入已打开的 WAV 文件中。

    g. 释放缓冲区内存并关闭 WAV 文件。程序使用 free() 函数释放 rec_buffer 缓冲区的内存，并使用 file.close() 函数关闭已打开的 WAV 文件。

  • generate_wav_header(uint8_t *wav_header, uint32_t wav_size, uint32_t sample_rate)：生成 WAV 文件头部信息的函数。在此函数中，程序根据 WAV 文件的规格生成包含头部信息的字节数组。

    a. 定义 WAV 文件头部信息的常量。程序定义了一个包含 WAV 文件头部信息的字节数组 set_wav_header，并定义了 WAV 文件规格的常量，包括 NUM_CHANNELS、BITS_PER_SAMPLE、WAV_HEADER_SIZE 和 SUB_CHUNK_SIZE。

    b. 设置 WAV 文件头部信息。程序使用步骤 a 中定义的常量设置 WAV 文件头部信息，并根据 WAV 文件规格计算某些字段的值，包括 AUDIO_FORMAT、BYTE_RATE、BLOCK_ALIGN、SAMPLES_PER_CHANNEL 和 CHUNK_SIZE。计算的值存储在 set_wav_header 字节数组中。

    c. 复制 WAV 文件头部信息。程序将存储在 set_wav_header 中的头部信息复制到字节数组 wav_header 中。

故障排除​

为什么我无法播放录制的音频文件？​

如果您遇到无法播放的情况，请检查串行监视器打印的调试信息中是否有关于读写卡的错误消息。如果有，请更换 microSD 卡或检查卡与扩展板的连接是否松动或不稳定。如果卡没有问题，那么应该检查音频文件的大小。如果录音有问题，可能会显示录制的音频文件大小仅为 0KB。

例如，下图中存在读写卡的问题。

如果卡没有问题且录音非常成功，那么您需要检查软件是否支持播放 WAV 格式的音频。我们建议使用专用的音乐播放软件播放音频，尽量不要使用视频播放器播放。经过实际测试，许多视频播放器（尽管支持 WAV 格式）无法播放。

技术支持与产品讨论​

感谢您选择我们的产品！我们为您提供多种支持，以确保您使用我们的产品时体验顺畅。我们提供了多种沟通渠道，以满足不同的偏好和需求。

Loading Comments...