【雕爷学编程】MicroPython手册之 ESP32 I2S总线

驴友花雕

已于 2023-12-26 19:55:04 修改

阅读量785

点赞数 2

分类专栏： MicroPython手册文章标签：单片机嵌入式硬件物联网 python MicroPython ESP32 I2S总线 ESP32

于 2023-09-27 20:08:43 首次发布

本文链接：https://blog.csdn.net/weixin_41659040/article/details/133307828

版权

MicroPython手册专栏收录该内容

841 篇文章 163 订阅

订阅专栏

在这里插入图片描述
MicroPython是为了在嵌入式系统中运行Python 3编程语言而设计的轻量级版本解释器。与常规Python相比，MicroPython解释器体积小(仅100KB左右)，通过编译成二进制Executable文件运行，执行效率较高。它使用了轻量级的垃圾回收机制并移除了大部分Python标准库，以适应资源限制的微控制器。

MicroPython主要特点包括:
1、语法和功能与标准Python兼容,易学易用。支持Python大多数核心语法。
2、对硬件直接访问和控制,像Arduino一样控制GPIO、I2C、SPI等。
3、强大的模块系统,提供文件系统、网络、图形界面等功能。
4、支持交叉编译生成高效的原生代码,速度比解释器快10-100倍。
5、代码量少,内存占用小,适合运行在MCU和内存小的开发板上。
6、开源许可,免费使用。Shell交互环境为开发测试提供便利。
7、内置I/O驱动支持大量微控制器平台，如ESP8266、ESP32、STM32、micro:bit、掌控板和PyBoard等。有活跃的社区。

MicroPython的应用场景包括:
1、为嵌入式产品快速构建原型和用户交互。
2、制作一些小型的可 programmable 硬件项目。
3、作为教育工具,帮助初学者学习Python和物联网编程。
4、构建智能设备固件,实现高级控制和云连接。
5、各种微控制器应用如物联网、嵌入式智能、机器人等。

使用MicroPython需要注意:
1、内存和Flash空间有限。
2、解释执行效率不如C语言。
3、部分库函数与标准版有差异。
4、针对平台优化语法,订正与标准Python的差异。
5、合理使用内存资源,避免频繁分配大内存块。
6、利用原生代码提升速度关键部位的性能。
7、适当使用抽象来封装底层硬件操作。

总体来说,MicroPython让Python进入了微控制器领域，是一项重要的创新，既降低了编程门槛，又提供了良好的硬件控制能力。非常适合各类物联网和智能硬件的开发。
在这里插入图片描述
ESP32 是一款功能丰富的微控制器，集成了 Wi-Fi 和蓝牙连接功能，适合物联网开发的强大而实惠的平台。ESP32 的主要特点有：

1、处理器：CPU：Xtensa 双核（或单核）32 位 LX6 微处理器，工作频率为 160 或 240 MHz，性能可达 600 DMIPS。超低功耗（ULP）协处理器。
2、内存：520 KiB RAM，448 KiB ROM。
3、无线连接：Wi-Fi：802.11 b/g/n。蓝牙：v4.2 BR/EDR 和 BLE。
4、外设：12 位 SAR ADC 最多支持 18 个通道，2 个 8 位 DAC，10 个触摸传感器，4 个 SPI，2 个 I2S，2 个 I2C，3 个 UART，SD/SDIO/MMC 主机控制器，SDIO/SPI 从设备控制器，以太网 MAC 接口，CAN 总线 2.0，红外远程控制器，电机 PWM，LED PWM 最多支持 16 通道。
4、安全性：硬件加速 AES、SHA-2、RSA、ECC、随机数生成器（RNG）等。
5、可靠性：工作温度范围为 –40°C 到 +125°C。具有动态电压调整和时钟门控等功能，可适应外部条件的变化和降低功耗。
6、灵活性：可作为独立系统运行应用程序或作为主机 MCU 的从设备，通过 SPI / SDIO 或 I2C / UART 接口提供 Wi-Fi 和蓝牙功能。具有高度集成的天线开关、RF balun、功率放大器、低噪声放大器、滤波器和电源管理模块等。

在这里插入图片描述
MicroPython的ESP32 I2S总线是一种使用系统的底层硬件支持来执行I2S总线协议的方法。I2S是一种同步串行协议，用于连接数字音频设备。在物理层面，一个总线由3条线组成：SCK（时钟线）、WS（字选择线）和SD（数据线）。I2S类支持控制器操作，不支持外设操作。I2S类目前作为技术预览提供。在预览期间，鼓励用户提供反馈。根据这些反馈，I2S类的API和实现可能会发生变化。

I2S总线的主要特点有：

可以配置成两组不同的引脚，分别对应两个硬件I2S通道。默认情况下，第一个通道使用GPIO22作为SCK，GPIO21作为SDA；第二个通道使用GPIO25作为SCK，GPIO26作为SDA。这些引脚可以在初始化时修改，但必须符合输入输出的方向性。
可以设置时钟速率、超时时间、是否使用内部上拉电阻等参数。
可以扫描总线上连接的设备地址，也可以读写设备的寄存器或内存。

I2S总线的应用场景有：

连接需要高速数据传输的外部设备，如扬声器、耳机、麦克风等。
连接支持I2S协议的音频编解码器，如WM8960或SGTL5000等。
实现复杂的音频处理功能，如播放WAV音频文件，或将麦克风音频录制到SD卡上的WAV文件中。

I2S总线需要注意的事项有：

在使用I2S之前，需要先导入machine模块，并创建I2S对象。
在使用I2S时，需要注意引脚的选择和连接，避免与其他功能冲突或影响性能。
在使用I2S时，需要注意设备的地址和寄存器或内存的地址，以及读写操作的字节数和格式。

以下是MicroPython的ESP32 I2S总线几个实际运用程序参考代码案例：

案例1：使用I2S连接一个扬声器，并播放一个WAV音频文件：

from machine import Pin, I2C, I2S
import uos # 导入文件系统模块

# 构造一个硬件I2C对象
i2c = I2C(0, scl=Pin(22), sda=Pin(21), freq=400000)

# 构造一个WM8960音频编解码器对象
wm = WM8960(i2c) # 使用WM8960驱动模块

# 初始化WM8960
wm.init()

# 设置音量
wm.volume(50)

# 构造一个硬件I2S对象
i2s = I2S(0, sck=Pin(14), ws=Pin(13), sdout=Pin(12), mode=I2S.TX, bits=16, format=I2S.STEREO, rate=44100)

# 打开一个WAV音频文件
f = uos.open('test.wav', 'rb')

# 跳过文件头部分
f.seek(44)

# 创建一个字节数组用于存储音频数据
buf = bytearray(1024)

# 循环读取文件并播放
while True:
    # 从文件中读取1024个字节到字节数组中
    num_read = f.readinto(buf)
    # 如果读取到了数据
    if num_read > 0:
        # 通过I2S写入扬声器
        i2s.write(buf)
    # 如果读取到了文件末尾
    else:
        # 跳出循环
        break

# 关闭文件
f.close()

案例2：使用I2S连接一个麦克风，并将音频数据录制到一个WAV文件中：

from machine import Pin, I2C, I2S
import uos # 导入文件系统模块
import utime # 导入时间模块

# 构造一个硬件I2C对象
i2c = I2C(0, scl=Pin(22), sda=Pin(21), freq=400000)

# 构造一个WM8960音频编解码器对象
wm = WM8960(i2c) # 使用WM8960驱动模块

# 初始化WM8960
wm.init()

# 设置音量
wm.volume(50)

# 构造一个硬件I2S对象
i2s = I2S(0, sck=Pin(14), ws=Pin(13), sdin=Pin(12), mode=I2S.RX, bits=16, format=I2S.STEREO, rate=44100)

# 打开一个WAV音频文件
f = uos.open('record.wav', 'wb')

# 写入WAV文件头部分，参考7
f.write(b'RIFF') # ChunkID，固定为RIFF
f.write(b'\x00\x00\x00\x00') # ChunkSize，暂时写为0，后面再修改
f.write(b'WAVE') # Format，固定为WAVE
f.write(b'fmt ') # Subchunk1ID，固定为fmt 
f.write(b'\x10\x00\x00\x00') # Subchunk1Size，固定为16
f.write(b'\x01\x00') # AudioFormat，PCM为1
f.write(b'\x02\x00') # NumChannels，双声道为2
f.write(b'\x44\xAC\x00\x00') # SampleRate，采样率为44100Hz
f.write(b'\x10\xB1\x02\x00') # ByteRate，字节率为NumChannels * SampleRate * BitsPerSample / 8
f.write(b'\x04\x00') # BlockAlign，块对齐为NumChannels * BitsPerSample / 8
f.write(b'\x10\x00') # BitsPerSample，位深为16位
f.write(b'data') # Subchunk2ID，固定为data
f.write(b'\x00\x00\x00\x00') # Subchunk2Size，暂时写为0，后面再修改

# 创建一个字节数组用于存储音频数据
buf = bytearray(1024)

# 设置录制时间（秒）
record_time = 10

# 计算开始时间和结束时间（毫秒）
start_time = utime.ticks_ms()
end_time = start_time + record_time * 1000

# 记录已经写入的字节数
num_written = 0

# 循环读取麦克风并写入文件
while True:
    # 获取当前时间（毫秒）
    current_time = utime.ticks_ms()
    # 如果还没有到结束时间
    if current_time < end_time:
        # 通过I2S读取麦克风数据到字节数组中
        i2s.readinto(buf)
        # 将字节数组写入文件中
        num_written += f.write(buf)
    # 如果已经到了结束时间
    else:
        # 跳出循环
        break

# 回到文件头部分的ChunkSize位置（第4个字节）
f.seek(4)

# 计算并写入ChunkSize的值（文件大小减去8个字节）
chunk_size = num_written + 36 - 8 
f.write(chunk_size.to_bytes(4, 'little'))

# 回到文件头部分的Subchunk2Size位置（第40个字节）
f.seek(40)

# 计算并写入Subchunk2Size的值（音频数据的大小）
subchunk2_size = num_written 
f.write(subchunk2_size.to_bytes(4, 'little'))

# 关闭文件
f.close()

案例3：录制音频并保存为WAV文件：

import machine
import uos
import wave

# 配置I2S总线
i2s = machine.I2S(sck=machine.Pin(26), ws=machine.Pin(25), sd=machine.Pin(22))

# 配置音频参数
sample_rate = 44100
bits_per_sample = 16
channels = 2

# 配置WAV文件
filename = "/sdcard/recording.wav"
file = wave.open(filename, "wb")
file.setsampwidth(bits_per_sample // 8)
file.setnchannels(channels)
file.setframerate(sample_rate)

# 录制音频并写入WAV文件
buffer_size = 512
buffer = bytearray(buffer_size)
while True:
    i2s.readinto(buffer)
    file.writeframes(buffer)
    if uos.getlen(filename) >= 10 * 1024 * 1024:  # 设置最大录制大小为10MB
        break

# 关闭WAV文件
file.close()

这个示例演示了如何使用MicroPython通过ESP32的I2S总线录制音频并将其保存为WAV文件。首先使用machine.I2S类创建一个I2S对象，指定SCK、WS和SD引脚。然后配置音频参数，包括采样率、每样本位数和声道数。接下来配置WAV文件，设置采样宽度、声道数和采样率。在循环中从I2S总线读取音频数据，并写入WAV文件，直至达到最大录制大小（这里设置为10MB）。最后关闭WAV文件。

请注意，上述示例中使用了uos.getlen()函数来获取文件的大小。在ESP32上，你可能需要先挂载SD卡，然后才能在/sdcard目录下保存WAV文件。

案例4：播放WAV音频文件：

import machine
import wave

# 配置I2S总线
i2s = machine.I2S(sck=machine.Pin(26), ws=machine.Pin(25), sd=machine.Pin(22))

# 配置WAV文件
filename = "/sdcard/recording.wav"
file = wave.open(filename, "rb")

# 播放WAV音频文件
buffer_size = 512
buffer = bytearray(buffer_size)
while True:
    frames_read = file.readinto(buffer)
    if frames_read == 0:
        break
    i2s.write(buffer)

# 关闭WAV文件
file.close()

这个示例演示了如何使用MicroPython通过ESP32的I2S总线播放WAV音频文件。首先使用machine.I2S类创建一个I2S对象，指定SCK、WS和SD引脚。然后打开WAV文件，以只读模式进行读取。在循环中从WAV文件读取音频数据，并通过I2S总线进行写入，实现音频的播放。当读取的帧数为0时，表示已经将整个WAV文件播放完毕，循环结束。最后关闭WAV文件。

请注意，同样需要先挂载SD卡，并将WAV文件保存在/sdcard目录下。

案例5：使用I2S总线进行音频信号处理：

import machine
import math

# 配置I2S总线
i2s = machine.I2S(sck=machine.Pin(26), ws=machine.Pin(25), sd=machine.Pin(22))

# 生成音频信号
sample_rate = 44100
frequency = 440
amplitude = 0.8

buffer_size = 512
buffer = bytearray(buffer_size)
phase = 0
for i in range(buffer_size):
    sample = int(amplitude * math.sin(2 * math.pi * frequency * phase / sample_rate))
    buffer[i] = sample & 0xFF
    phase += 1

# 播放音频信号
while True:
    i2s.write(buffer)

这个示例演示了如何使用MicroPython通过ESP32的I2S总线生成并播放音频信号。

案例6：配置ESP32的I2S总线输出音频：

import machine

# 配置I2S总线
i2s = machine.I2S(
    machine.I2S.NUM0,
    sck=machine.Pin(26),
    ws=machine.Pin(25),
    sd=machine.Pin(33)
)

# 配置音频参数
sample_rate = 44100
bits_per_sample = 16
channel_format = machine.I2S.MONO

# 配置I2S总线输出音频
i2s.init(
    mode=machine.I2S.TX,
    rate=sample_rate,
    bits=bits_per_sample,
    channel_fmt=channel_format
)

# 发送音频数据
audio_data = bytearray(b"\x00\x01\x02\x03\x04\x05\x06\x07")  # 音频数据
i2s.write(audio_data)

在上述示例中，我们使用machine.I2S()初始化ESP32的I2S总线对象。通过设置machine.I2S.NUM0和引脚参数（sck、ws、sd），我们指定了要使用的I2S总线编号以及时钟、字位选择和数据引脚。然后，我们配置音频参数，如采样率（sample_rate）、每个样本的位数（bits_per_sample）和声道格式（channel_format）。通过调用i2s.init()初始化I2S总线以进行音频输出。最后，我们使用i2s.write()将音频数据发送到I2S总线。

案例7：从I2S总线接收音频数据：

import machine

# 配置I2S总线
i2s = machine.I2S(
    machine.I2S.NUM0,
    sck=machine.Pin(26),
    ws=machine.Pin(25),
    sd=machine.Pin(33)
)

# 配置音频参数
sample_rate = 44100
bits_per_sample = 16
channel_format = machine.I2S.STEREO

# 配置I2S总线接收音频数据
i2s.init(
    mode=machine.I2S.RX,
    rate=sample_rate,
    bits=bits_per_sample,
    channel_fmt=channel_format
)

# 接收音频数据
buffer_size = 1024
audio_data = bytearray(buffer_size)
bytes_read = i2s.readinto(audio_data)
print("Bytes read:", bytes_read)

在上述示例中，我们使用machine.I2S()初始化ESP32的I2S总线对象，并设置了I2S总线编号和引脚参数。然后，我们配置音频参数，包括采样率、每个样本的位数和声道格式。通过调用i2s.init()初始化I2S总线以进行音频输入。最后，我们使用i2s.readinto()从I2S总线接收音频数据，并将其存储在audio_data字节数组中。打印bytes_read变量以显示实际读取的字节数。

案例8：配置ESP32的I2S总线作为外部音频DAC：

import machine

# 配置I2S总线
i2s = machine.I2S(
    machine.I2S.NUM0,
    sck=machine.Pin(26),
    ws=machine.Pin(25),
    sd=machine.Pin(33)
)

# 配置音频参数
sample_rate = 44100
bits_per_sample = 16
channel_format = machine.I2S.MONO

# 配置I2S总线作为外部音频DAC
i2s.init(
    mode=machine.I2S.TX,
    rate=sample_rate,
    bits=bits_per_sample,
    channel_fmt=channel_format
)

# 发送音频数据
audio_data = bytearray(b"\x00\x01\x02\x03\x04\x05\x06\x07")  # 音频数据
i2s.write(audio_data)

在上述示例中，我们使用machine.I2S()初始化ESP32的I2S总线对象，并设置了I2S总线编号和引脚参数。然后，我们配置音频参数，包括采样率、每个样本的位数和声道格式。通过调用i2s.init()初始化I2S总线以将其配置为外部音频DAC。最后，我们使用i2s.write()将音频数据发送到I2S总线，以输出到外部音频DAC。

请注意，以上案例只是为了拓展思路，可能存在不能编译、错误或不适用的情况。不同的硬件平台、使用场景和MicroPython版本可能会导致不同的使用方法。在实际编程中，您需要根据您的硬件配置和具体需求进行调整，并进行多次实际测试。需要正确连接硬件并了解所使用的传感器和设备的规范和特性非常重要。对于涉及到硬件操作的代码，请确保在使用之前充分了解和确认所使用的引脚和电平等参数的正确性和安全性。

在这里插入图片描述

驴友花雕

关注

2
点赞
踩
16

收藏

觉得还不错? 一键收藏
打赏
6
评论
【雕爷学编程】MicroPython手册之 ESP32 I2S总线

在上述示例中，我们使用machine.I2S()初始化ESP32的I2S总线对象，并设置了I2S总线编号和引脚参数。I2S类支持控制器操作，不支持外设操作。4、外设：12 位 SAR ADC 最多支持 18 个通道，2 个 8 位 DAC，10 个触摸传感器，4 个 SPI，2 个 I2S，2 个 I2C，3 个 UART，SD/SDIO/MMC 主机控制器，SDIO/SPI 从设备控制器，以太网 MAC 接口，CAN 总线 2.0，红外远程控制器，电机 PWM，LED PWM 最多支持 16 通道。
复制链接

扫一扫