使用XIAO ESP32S3 上的数字麦克风
在本教程中，我们将为您介绍如何使用XIAO ESP32S3 Sense扩展板的麦克风。首先是对I2S引脚的非常基础的使用，我们将通过I2S和麦克风得到当前环境的响度，并将其显示在串行波形图中。然后我们将介绍如何录制声音并将录制的声音保存到SD卡。
| Seeed Studio XIAO ESP32S3 Sense |
|---|
 |
本教程的所有内容仅适用于XIAO ESP32S3 Sense。
开始
在开始学习本教程之前，您可能需要提前准备好以下硬件和软件。
安装扩展板(for Sense)
安装扩展板非常简单，只需要将扩展板上的连接器对准 XIAO ESP32S3 上的 B2B 连接器，然后用力按下，听到“咔”的一声，安装完成。
准备microSD卡
在进行保存录音的项目时，可能需要MicroSD卡。
XIAO ESP32S3 Sense支持高达32GB的microSD卡，所以如果您准备为XIAO购买microSD卡，请参阅此规格。并在使用microSD卡之前将microSD卡格式化为FAT32格式。
格式化完成后，可以将microSD卡插入microSD卡插槽中。请注意插入的方向，有金手指的那一侧要朝内。
声音响度检测
在第一个项目案例中，我们使用Arduino IDE的串口波形图来检测环境中的噪声，并展示麦克风检测到的环境响度。
下面是完整的示例程序。
检查并确保您使用的是哪个版本的 esp32，以下示例适用于 2.0.x 版本，下面的示例适用于 3.0.x 及更高版本
#include <I2S.h>
void setup() {
// Open serial communications and wait for port to open:
// A baud rate of 115200 is used instead of 9600 for a faster data rate
// on non-native USB ports
Serial.begin(115200);
while (!Serial) {
; // wait for serial port to connect. Needed for native USB port only
}
// start I2S at 16 kHz with 16-bits per sample
I2S.setAllPins(-1, 42, 41, -1, -1);
if (!I2S.begin(PDM_MONO_MODE, 16000, 16)) {
Serial.println("Failed to initialize I2S!");
while (1); // do nothing
}
}
void loop() {
// read a sample
int sample = I2S.read();
if (sample && sample != -1 && sample != 1) {
Serial.println(sample);
}
}
上面的示例仅与版本为 2.0.x 的 esp32 兼容，如果您使用的是最新版本（例如 3.0.x），请使用下面的示例
#include <ESP_I2S.h>
I2SClass I2S;
void setup() {
// Open serial communications and wait for port to open:
// A baud rate of 115200 is used instead of 9600 for a faster data rate
// on non-native USB ports
Serial.begin(115200);
while (!Serial) {
; // wait for serial port to connect. Needed for native USB port only
}
// setup 42 PDM clock and 41 PDM data pins
I2S.setPinsPdmRx(42, 41);
// start I2S at 16 kHz with 16-bits per sample
if (!I2S.begin(I2S_MODE_PDM_RX, 16000, I2S_DATA_BIT_WIDTH_16BIT, I2S_SLOT_MODE_MONO)) {
Serial.println("Failed to initialize I2S!");
while (1); // do nothing
}
}
void loop() {
// read a sample
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接口使用的引脚。该函数接受5个整数参数，分别表示连接到I2S接口的位时钟、单词选择、数据输入、数据输出和通道选择线的GPIO引脚。
I2S.setAllPins(-1, 42, 41, -1, -1);
在这个特定的代码中，-1值表示没有使用相应的引脚，而42和41值分别表示连接到单词选择和数据输入行的GPIO引脚。数据输出和通道选择行在此配置中不使用，而是设置为-1。
if (!I2S.begin(PDM_MONO_MODE, 16000, 16)) {
Serial.println("Failed to initialize I2S!");
while (1); // do nothing
}
在I2S对象上调用begin()函数，用指定的参数初始化I2S接口:PDM_MONO_MODE、16000 Hz采样率和16-bit分辨率。
值得注意的是，对于目前的ESP32-S3芯片，我们只能使用PDM_MONO_MODE，采样位宽只能为16bit。只有采样率可以修改，但经过测试，16kHz的采样率比较稳定。
int sample = I2S.read();
if (sample && sample != -1 && sample != 1) {
Serial.println(sample);
}
在I2S对象上调用read()函数，从I2S接口读取单个音频样本。if语句检查sample变量的值。如果采样值不是0、-1或1，它就被认为是有效的音频采样，并且If块中的代码会被执行。在这种情况下，使用 serial .println()函数将样本值打印到串行控制台。
保存录制的声音到microSD卡
在下一个项目中，我们将指导您如何结合microSD卡的功能，并将录制的声音保存到microSD卡中。那么对于这个项目，请提前准备好microSD卡并格式化为FAT32格式。
如果这是您第一次在XIAO ESP32S3上使用microSD卡，您可以阅读文件系统Wiki内容来了解microSD卡的安装和准备。
下面是这个项目的Arduino程序。
请注意，下面的示例仅与版本为 2.0.x 的 esp32 兼容，并不适用于最新版本（例如 3.0.x）的esp32板载包。
/*
* WAV Recorder for Seeed XIAO ESP32S3 Sense
*/
#include <I2S.h>
#include "FS.h"
#include "SD.h"
#include "SPI.h"
// make changes as needed
#define RECORD_TIME 20 // seconds, The maximum value is 240
#define WAV_FILE_NAME "arduino_rec"
// do not change for best
#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("Failed to initialize I2S!");
while (1) ;
}
if(!SD.begin(21)){
Serial.println("Failed to mount SD Card!");
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("Ready to start recording ...\n");
File file = SD.open("/"WAV_FILE_NAME".wav", FILE_WRITE);
// Write the header to the WAV file
uint8_t wav_header[WAV_HEADER_SIZE];
generate_wav_header(wav_header, record_size, SAMPLE_RATE);
file.write(wav_header, WAV_HEADER_SIZE);
// PSRAM malloc for recording
rec_buffer = (uint8_t *)ps_malloc(record_size);
if (rec_buffer == NULL) {
Serial.printf("malloc failed!\n");
while(1) ;
}
Serial.printf("Buffer: %d bytes\n", ESP.getPsramSize() - ESP.getFreePsram());
// Start recording
esp_i2s::i2s_read(esp_i2s::I2S_NUM_0, rec_buffer, record_size, &sample_size, portMAX_DELAY);
if (sample_size == 0) {
Serial.printf("Record Failed!\n");
} else {
Serial.printf("Record %d bytes\n", sample_size);
}
// Increase volume
for (uint32_t i = 0; i < sample_size; i += SAMPLE_BITS/8) {
(*(uint16_t *)(rec_buffer+i)) <<= VOLUME_GAIN;
}
// Write data to the WAV file
Serial.printf("Writing to the file ...\n");
if (file.write(rec_buffer, record_size) != record_size)
Serial.printf("Write file Failed!\n");
free(rec_buffer);
file.close();
Serial.printf("The recording is over.\n");
}
void generate_wav_header(uint8_t *wav_header, uint32_t wav_size, uint32_t sample_rate)
{
// See this for reference: 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));
}
为了执行这个例子，我们需要使用ESP-32芯片的PSRAM功能，所以请在上传之前打开它。
该程序在用户打开串行监视器后只执行一次，记录20秒，并将记录文件以“arduino_rec.wav”的形式保存到microSD卡中。
当串行监视器每1秒输出一次“。”时，程序执行结束，可以借助读卡器播放录制的声音文件。
要播放从XIAO ESP32S3录制的音频，您可能需要使用支持WAV格式的音频播放器。
程序注释
在这个程序中，我们为记录函数写了两个函数，一个是record_wav()，另一个是generate_wav_header()。
record_wav():记录函数。在这个函数中，程序通过I2S接口从麦克风读取音频数据，并以WAV音频文件的形式存储到SD卡中。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文件的规范生成一个包含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卡或检查microSD卡与扩展板连接是否松动或不稳定。如果卡没有问题，那么音频文件应该大小，如果录音有问题，它可能显示为录制的音频文件大小只有0KB。
例如，在下面的图中，卡片读写存在问题。
如果卡没有问题并且录音很成功的话。然后需要检查软件是否支持WAV格式的音频播放。建议使用专用音乐播放软件播放音频，尽量不要使用视频播放器播放。经过实际测试，有很多视频播放器(虽然支持WAV格式)都不能播放。
技术支持和产品讨论
感谢您选择我们的产品!我们在这里为您提供不同的支持，以确保您使用我们的产品的体验尽可能顺利。我们提供多种沟通渠道，以满足不同的喜好和需求。