MicroPython 开发ESP32应用教程 之 I2S、INMP441音频录制、MAX98357A音频播放、SD卡读写

最新推荐文章于 2025-04-28 15:24:20 发布
最新推荐文章于 2025-04-28 15:24:20 发布
阅读量1.4k 收藏 30
点赞数 36
分类专栏： ESP32 物联网IOT 文章标签： MicroPython ESP32S3 SD卡 inmp441音频录制 max98357a音频播放
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weald2000/article/details/147123652
版权

本课程我们讲解Micropython for ESP32 的i2s及其应用，比如INMP441音频录制、MAX98357A音频播放等，还有SD卡的读写。

一、硬件准备

1、支持micropython的ESP32S3开发板
2、INMP441数字全向麦克风模块
3、MAX98357A音频播放模块
4、SD卡模块
5、面包板及连接线若干

连接方式：
                 

inmp441MAX98357AESP32S3
SDIO13
WSIO12
SCKIO11
L/R接地
SD接VCC
GAIN接地
DINIO37
BCLKIO38
LRCIO39
SD卡模块ESP32S3
SCKIO4
MOSIIO5
MISOIO16
CSIO17

       

二、i2s介绍 

一）、I2S协议基础

I2S（Inter-IC Sound）是一种同步串行通信协议，专为数字音频设备设计，支持单向/双向音频数据传输。其物理层包含三条信号线：

  • ‌SCK‌（串行时钟）：同步数据传输速率
  • ‌WS‌（字选择）：区分左右声道或定义采样率
  • ‌SD‌（串行数据）：传输实际音频数据流‌
二）、MicroPython I2S类特性

        A.  仅支持主设备操作模式，可控制SCK和WS信号的生成，适用于连接麦克风、
             DAC等从设备‌

        B. 支持ESP32、STM32、RP2等主流微控制器平台，通过统一接口简化跨硬件开发‌

三）、核心功能实现

  1. ‌音频输入/输出‌

    • ‌录音‌：从麦克风模块获取PCM音频数据
    • ‌播放‌：向DAC或音频解码器发送音频流‌27。

  2. ‌参数灵活配置‌
    初始化时可设置关键参数：

    i2s = I2S(id,  # 硬件实例编号（如I2S.NUM0）
          sck=Pin(11), ws=Pin(12), sd=Pin(13),  # 引脚映射
          mode=I2S.RX,  # 模式（RX/TX）
          bits=16,      # 采样位深
          format=I2S.MONO,  # 声道格式 MONO为单声道，STEREO为立体声
          rate=16000,   # 采样率
          ibuf=8092)   # 输入缓冲区大小‌:ml-citation{ref="4,7" data="citationList"}

  3. ‌中断与DMA支持‌
    支持异步数据读写，通过DMA减少CPU占用率，提升实时性‌

 

 四）、典型应用场景

  1. ‌音频播放器‌
    播放WAV/MP3文件（需解码库支持）‌。

  2. ‌语音采集系统‌
    连接INMP441等数字麦克风实现环境音录制‌。

  3. ‌实时语音处理‌
    结合神经网络进行关键词识别或声纹分析‌

三、MicroPython SD卡介绍 

一）、SD卡初始化与挂载

硬件接口配置‌
使用SPI模式连接SD卡（需4线：CLK/MOSI/MISO/CS），典型ESP32配置示例：

from sdcard import SDCard
import os, time, gc

spi = SPI(2,
                  baudrate=80000000,
                  polarity=0,
                  phase=0,
                  sck=Pin(4),
                  mosi=Pin(5),
                  miso=Pin(16))
sd = SDCard(spi,Pin(17,Pin.OUT))
二）、文件操作API

        基础文件读写‌
        使用标准文件操作接口：

 

def test_sd():
    os.mount(sd,'/sd')
    # 重新查询系统文件目录
    print('挂载SD后的系统目录:{}'.format(os.listdir()))
    with open("/sd/test.txt", "w") as f:
            f.write(str("Hello MicroPython！"))

    # 从sd卡目录下读取hello.txt文件内容
    with open("/sd/test.txt", "r") as f:
        # 打印读取的内容
        data = f.read()
        print (data)

四、inmp4411录制音频

通过前面的讲解，这一小节的内容需要掌握的知识点我们都已经掌握，直接上代码：

audiofilename = '/sd/rec.pcm'
def record_audio(filename=audiofilename, duration=5, sample_rate=16000):
#     # 硬件诊断
    print("初始化I2S...")
    try:
        i2s = I2S(
            0,
            sck=Pin(11), ws=Pin(12), sd=Pin(13),
            mode=I2S.RX,
            bits=16,
            format=I2S.MONO,
            rate=sample_rate,
            ibuf=4096
        )
    except Exception as e:
        print("I2S初始化失败:", e)
        return

    # 计算数据量
    bytes_per_second = sample_rate * 2  # 16bit=2字节
    total_bytes = bytes_per_second * duration
#    header = createWavHeader(sample_rate, 16, 1, total_bytes)
    
    # 录音循环
    try:
        with open(audiofilename, 'wb') as f:
#            f.write(header)
            start_time = time.ticks_ms()
            bytes_written = 0
            buffer = bytearray(2048)  # 小缓冲区减少内存压力
            
            while bytes_written < total_bytes:
                read = i2s.readinto(buffer)
                if read == 0:
                    print("警告：未读取到数据")
                    continue
                
                f.write(buffer[:read])
                bytes_written += read
                gc.collect()
                
                # 实时进度
                elapsed = time.ticks_diff(time.ticks_ms(), start_time) / 1000
                print(f"进度: {bytes_written/total_bytes*100:.1f}%, 时间: {elapsed:.1f}s")
                
    except OSError as e:
        print("文件写入错误:", e)
    finally:
        i2s.deinit()
#        print("录音结束，文件大小:", os.stat(audiofilename)[6], "字节")
        print("录音结束，文件大小:", bytes_written, "字节")

但这里需要说明一下的是，我们刚开始开发的时候，录制的音频文件中的数据全是0，也就是说没有声音，噪音都没有，检查连接线、换IO口等等，各种折腾，但问题依然存在，后来因为出了其它的错误，就暂停了，具体可以参考：MicroPython 开发ESP32应用教程 之 WIFI、BLE共用常见问题处理及中断处理函数注意事项

上文中提到的问题处理完后，我们继续折腾音频录制及播放的功能，奇怪的事情发生了，连接好各功能模块后，测试，居然好了，怀疑是上文中提到的电源的问题，但把外接电源移除，测试没有问题。

也就是说，到现在，我们还是不知道之前为什么有问题？现在为什么好了？只能怀疑电源不稳？

五、MAX98357A音频播放

这个也没什么好讲，直接上代码吧

audiofilename = '/sd/rec.pcm'

audio_out = I2S(1, sck=Pin(38), ws=Pin(39), sd=Pin(37), mode=I2S.TX, bits=16, format=I2S.MONO, rate=16000, ibuf=20000)
def play_audio(filename='/sd/rec.wav', duration=5, sample_rate=16000):        

#    audio_out.volume(80)
    with open(audiofilename,'rb') as f:
 
        # 跳过文件的开头的44个字节，直到数据段的第1个字节
#        pos = f.seek(44) 
     
        # 用于减少while循环中堆分配的内存视图
        wav_samples = bytearray(1024)
        wav_samples_mv = memoryview(wav_samples)
         
        print("开始播放音频...")
        
        #并将其写入I2S DAC
        while True:
            try:
                num_read = f.readinto(wav_samples_mv)
                
                # WAV文件结束
                if num_read == 0: 
                    break
     
                # 直到所有样本都写入I2S外围设备
                num_written = 0
                while num_written < num_read:
                    num_written += audio_out.write(wav_samples_mv[num_written:num_read])
                    
            except Exception as ret:
                print("产生异常...", ret)

六、完整代码
 

该代码简单修改可保存为WAV格式文件，可以用我们常见的音频播放软件播放。

from machine import I2S, Pin,SPI
from sdcard import SDCard
import os, time, gc

spi = SPI(2,
                  baudrate=20000000,
                  polarity=0,
                  phase=0,
                  sck=Pin(4),
                  mosi=Pin(5),
                  miso=Pin(16))
sd = SDCard(spi,Pin(17,Pin.OUT))

audiofilename = '/sd/rec.pcm'
def createWavHeader(sampleRate, bitsPerSample, num_channels, datasize):    
    riff_size = datasize + 36 - 8  # 修正RIFF块大小
    header = bytes("RIFF", 'ascii')
    header += riff_size.to_bytes(4, 'little')
    header += bytes("WAVE", 'ascii')
    header += bytes("fmt ", 'ascii')
    header += (16).to_bytes(4, 'little')          # fmt块大小
    header += (1).to_bytes(2, 'little')            # PCM格式
    header += num_channels.to_bytes(2, 'little')   # 声道数
    header += sampleRate.to_bytes(4, 'little')     # 采样率
    header += (sampleRate * num_channels * bitsPerSample // 8).to_bytes(4, 'little')  # 字节率
    header += (num_channels * bitsPerSample // 8).to_bytes(2, 'little')  # 块对齐
    header += bitsPerSample.to_bytes(2, 'little')  # 位深
    header += bytes("data", 'ascii')
    header += datasize.to_bytes(4, 'little')       # 数据块大小
    return header

def record_audio(filename=audiofilename, duration=5, sample_rate=16000):
#     # 硬件诊断
    print("初始化I2S...")
    try:
        i2s = I2S(
            0,
            sck=Pin(11), ws=Pin(12), sd=Pin(13),
            mode=I2S.RX,
            bits=16,
            format=I2S.MONO,
            rate=sample_rate,
            ibuf=4096
        )
    except Exception as e:
        print("I2S初始化失败:", e)
        return

    # 计算数据量
    bytes_per_second = sample_rate * 2  # 16bit=2字节
    total_bytes = bytes_per_second * duration
#    header = createWavHeader(sample_rate, 16, 1, total_bytes)
    
    # 录音循环
    try:
        with open(audiofilename, 'wb') as f:
#            f.write(header)
            start_time = time.ticks_ms()
            bytes_written = 0
            buffer = bytearray(1024)  # 小缓冲区减少内存压力
            
            while bytes_written < total_bytes:
                read = i2s.readinto(buffer)
                if read == 0:
                    print("警告：未读取到数据")
                    continue
                
                f.write(buffer[:read])
                bytes_written += read
                gc.collect()
                
                # 实时进度
                elapsed = time.ticks_diff(time.ticks_ms(), start_time) / 1000
                print(f"进度: {bytes_written/total_bytes*100:.1f}%, 时间: {elapsed:.1f}s")
                
    except OSError as e:
        print("文件写入错误:", e)
    finally:
        i2s.deinit()
#        print("录音结束，文件大小:", os.stat(audiofilename)[6], "字节")
        print("录音结束，文件大小:", bytes_written, "字节")
        
audio_out = I2S(1, sck=Pin(38), ws=Pin(39), sd=Pin(37), mode=I2S.TX, bits=16, format=I2S.MONO, rate=16000, ibuf=20000)
def play_audio(filename='/sd/rec.wav', duration=5, sample_rate=16000):        

#    audio_out.volume(80)
    with open(audiofilename,'rb') as f:
 
        # 跳过文件的开头的44个字节，直到数据段的第1个字节
#        pos = f.seek(44) 
     
        # 用于减少while循环中堆分配的内存视图
        wav_samples = bytearray(1024)
        wav_samples_mv = memoryview(wav_samples)
         
        print("开始播放音频...")
        
        #并将其写入I2S DAC
        while True:
            try:
                num_read = f.readinto(wav_samples_mv)
                
                # WAV文件结束
                if num_read == 0: 
                    break
     
                # 直到所有样本都写入I2S外围设备
                num_written = 0
                while num_written < num_read:
                    num_written += audio_out.write(wav_samples_mv[num_written:num_read])
                    
            except Exception as ret:
                print("产生异常...", ret)



if __name__ == "__main__":
    try:
        os.mount(sd,'/sd')   
        record_audio(duration=5)
        play_audio()
    except Exception as e:
        print("异常：",e)
# 测试

'''

import time
from machine import I2S, Pin
import math

# I2S配置
i2s = I2S(0,
          sck=Pin(22), ws=Pin(23), sd=Pin(21),
          mode=I2S.RX,
          bits=16,
          rate=16000,
          channel_format=I2S.ONLY_LEFT)

# 参数配置
SILENCE_THRESHOLD = 0.02  # 需根据环境噪声校准
CHECK_INTERVAL = 0.1      # 检测间隔(秒)
SILENCE_DURATION = 1.0    # 目标静默时长

buffer = bytearray(1024)  # 512个16位样本
last_sound_time = time.time()

while True:
    i2s.readinto(buffer)  # 读取I2S数据‌:ml-citation{ref="6" data="citationList"}
    
    # 计算当前块RMS值
    sum_sq = 0
    for i in range(0, len(buffer), 2):
        sample = int.from_bytes(buffer[i:i+2], 'little', True)
        sum_sq += (sample / 32768) ** 2  # 16位有符号转浮点‌:ml-citation{ref="6" data="citationList"}
    rms = math.sqrt(sum_sq / 512)
    
    # 更新最后有声时间戳
    if rms > SILENCE_THRESHOLD:
        last_sound_time = time.time()
    
    # 判断静默持续时间
    if (time.time() - last_sound_time) >= SILENCE_DURATION:
        print("检测到持续静默")
        # 触发后续处理
'''

ESP32设备驱动-I2S播放音频（使用MAX98357A放大器）
视觉与物联智能
06-28 6862
本文将详细介绍如何使用ESP32的I2S接口通过MAX98357A进行音频播放。
【ESP32使用MAX98357播放音频】
vor234的博客
04-14 5353
在物联网和智能家居领域，音频播放功能越来越受到重视。ESP32作为一款功能强大的微控制器，结合MAX98357音频放大器模块，可以实现高品质的音频播放。本文将详细介绍如何使用ESP32的I2S接口通过MAX98357进行音频播放。
ESP32 I2S、INMP441音频录制、MAX98357A音频播放、SD卡读写
04-12
蓝桥杯python ESP32 I2S、INMP441音频录制、MAX98357A音频播放、SD卡读写 可以选择录制的音频先保存到SD卡中，然后再从SD卡中读出，通过max98357播放。 也可以选择录制的音频保存在内存中，然后直接通过max98357播放，这种方式要求有外置PSRAM。
物联网开发笔记（51）- 使用Micropython开发ESP32开发板之通过MAX98357 I2S音频模块播放音乐
zhusongziye的博客
11-24 6915
使用Micropython开发ESP32开发板之通过MAX98357 I2S音频模块播放音乐
一起玩儿物联网人工智能小车（ESP32）——69 使用INMP441模块采集声音
一起玩儿科技
02-25 6609
摘要：本文介绍如何使用INMP441模块采集声音
ESP-IDF实现无损INMP441采集音频+MAX98357A播放音频
qq_44392698的博客
04-07 447
今天弄了一天，直到现在的半夜，终于弄出了没有杂音的音频采集+播放demo。一定有人苦于没有参考代码而抓狂，就像今天的我，故将代码录而记之，以飨后来者。板子：esp32-wroom-32、INMP441、MAX98357A。开发环境：esp-idf v5.2。
基于Arduino的ESP32-S3+inmp441+max98357（录音机/麦克风喇叭）
最新发布
qq_35540725的博客
04-28 1018
本系列将以0基础新手视角，完整演示ESP32+ inmp441+max98357 的全流程及代码实现。建议搭配Arduino IDE 2.0+和ESP32-S3开发板使用。
要使用ESP32控制INMP441采集并用MAX98357播放音频实现对讲机
热门推荐
知识无价，热爱无价。
03-20 1万+
要使用ESP32控制INMP441采集并用MAX98357播放音频实现对讲机
ESP32S3开发板连INMP441麦克风，并用MicroPython控制处理语音信号存为pcm格式文件
skywalk8163的专栏
12-03 5293
本次实践的目标是：ESP32S3开发板连INMP441麦克风，并用MicroPython控制处理语音信号存为pcm格式文件。
基于STM32实现通过I2S协议读取来自INMP441模块的音频数据（皆可应用在毕设/课设/大作业/实训/竞赛/项目开发）
03-31
相关项目设计中，皆可应用在项目开发、毕业设计、课程设计、期末/期中/大作业、工程实训、大创等学科竞赛比赛、初期项目立项、学习/练手等方面中 可借鉴此优质项目实现复刻，也可以基于此项目进行扩展来开发出更多...
运行 MicroPython 的微控制器 上的 I2S 支持示例_python_代码_相关文件_下载
07-07
该存储库提供了 MicroPython 示例代码，展示了如何将 I2S 协议与支持 MicroPython 的开发板一起使用。I2S 协议可用于通过扬声器或耳机播放 WAV 音频文件，或将麦克风音频录制到 SD 卡上的 WAV 文件中。 这些示例在 4 个端口上受支持：stm32、esp32、rp2 和 mimxrt。 要在 Pyboard、esp32、mimxrt 和 Raspberry Pi Pico 上将 I2S 与 MicroPython 一起使用，您需要安装支持 I2S 的 MicroPython 固件版本。对于这些端口，v1.19 版本和所有夜间构建都支持 I2S。 I2S 功能目前处于技术预览阶段，可能会随着收到用户的反馈而发生变化。 已测试的开发板 stm32端口： Pyboard D SF2W Pyboard V1.1 ESP32 端口： Adafruit Huzzah Feather ESP32 带外置 SD 卡 萝琳 D32 Pro Lolin D32 带外置 SD 卡 更多详情、使用方法，请下载后阅读README.md文件
和使用INMP441I2S麦克风的ESP32供电的VU矩阵_C_C++_下.zip
04-13
标题中的“和使用INMP441I2S麦克风的ESP32供电的VU矩阵_C_C++_下”表明这是一个关于使用ESP32微控制器与INMP441I2S数字麦克风交互，并通过C或C++编程实现VU（Volume Unit）音频电平指示器的项目。VU表是一种显示音频...
基于ESP32-S3、INMP441、MAX98357与按键控制的在线语音助手实现
weixin_42146638的博客
08-23 2882
本文介绍如何结合ESP32-S3微控制器、INMP441数字麦克风、MAX98357音频放大器以及物理按键，利用百度的人工智能技术（特别是文心一言大模型和语音识别/语音合成API），构建一个功能丰富的在线语音助手。这一系统不仅能够实现高质量的语音采集与播放，还能通过智能问答提升用户的交互体验。通过集成百度的人工智能技术，该系统不仅具备高质量的音频采集与播放能力，还能实现智能语音问答功能，为用户带来便捷、高效的交互体验。未来，随着技术的不断进步，此类语音助手将在智能家居、物联网等领域发挥更大的作用。
ESP32 读取SD卡音频文件，使用MAX98357A播放音频
知识无价，热爱无价。
03-15 4845
ESP32 读取SD卡音频文件，使用MAX98357A播放音频
一起玩儿物联网人工智能小车（ESP32）——68 使用MAX98357A模块播放声音
一起玩儿科技
02-24 6652
摘要：本文介绍如何使用MAX98357A模块播放声音
ESP32和inmp441实现录音和播放
qq_36501494的博客
02-27 6147
ESP32和INMP411一起实现声音数据的采集和播放
ESP32:非 Arduino 方式驱动 MAX98357A 实现旋律音频播放
王兆镇的博客
02-14 2270
I2S_NUM：指定使用的 I2S 接口编号。DIN_PINBCLK_PINLRC_PIN：定义与 MAX98357A 连接的引脚。AMPLITUDE：分别定义音频采样率和振幅。NOTE_*：定义常见音符的频率。：存储一段简单旋律的音符频率。：存储每个音符的持续时间。通过本教程，你学会了如何使用 ESP32 结合 VSCode 和 ESP - IDF 开发框架，以非 Arduino 的方式驱动 MAX98357A 和喇叭实现旋律音频播放。
ESP32+INMP441+DHT11+OLED+网页+Arduino——“智能”语音天气站（2）：INMP441录音生成wav文件
Laura_Luo的博客
06-25 5088
录音并生成wav文件，包含wav文件知识链接，I2S工作原理和SPIFFS的一些知识
esp32-s3读取麦克风inmp441数据并用MAX98357实时播放，micropython
01-26
### 实现ESP32-S3通过MicroPython读取INMP441麦克风数据并使用MAX98357进行实时音频播放 为了实现这一目标，需要配置I2S接口用于连接INMP441麦克风和MAX98357扬声器模块。下面提供了一个具体的代码实例，展示了如何利用MicroPython完成上述任务。 #### 初始化硬件设置 首先定义所需的引脚分配以及初始化I2S对象： ```python from machine import I2S, Pin # 定义I2S总线参数 bclk = Pin(26) # BCLK pin for INMP441 wsi = Pin(25) # WS/IWS pin for INMP441 din = Pin(22) # DIN/SDATA pin from INMP441 to MAX98357A dout = Pin(21) # DOUT pin of INMP441 (not used here) audio_out = I2S( I2S.NUM0, bck=bclk, ws=wsi, sd=din, mode=I2S.TX, bits=16, format=I2S.MONO, rate=16000, ibuf=20000 ) ``` 这段代码设置了I2S通信模式为传输(TX)，指定了采样率为16kHz，并创建了大小为20KB的内部缓冲区[^1]。 #### 数据处理与回放逻辑 接下来编写循环结构来持续获取来自INMP441的数据流并通过MAX98357输出声音信号： ```python import time while True: try: buf = bytearray(1024) num_read = audio_out.readinto(buf) if not num_read: continue # 将接收到的数据立即发送出去形成回音效果 audio_out.write(buf[:num_read]) except KeyboardInterrupt: break time.sleep_ms(10) ``` 此部分实现了简单的回声功能，即捕获到的声音会几乎同步地被重播出来。`readinto()`方法用来填充字节数组，而`write()`则负责将这些数据推送到DAC端口以便于发声设备发出声响[^2]。 请注意，在实际应用中可能还需要考虑更多细节，比如噪声抑制、增益调整等高级特性；此外，由于这里采用的是最基础的方式来进行即时录音与播放，因此可能会存在轻微延迟现象。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

永远的元子

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值