【雕爷学编程】MicroPython手册之 ESP32 记忆卡

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、功率放大器、低噪声放大器、滤波器和电源管理模块等。

记忆卡是一种小型可移动存储设备，可以用于存储和传输数据。常见的记忆卡有SD卡、MMC卡、TF卡等。MicroPython的ESP32支持使用记忆卡来扩展内部存储空间，或者作为外部存储介质。

记忆卡的主要特点有：

可以使用machine模块中的SDCard类来创建和控制记忆卡对象。
可以使用uos模块中的mount和umount函数来挂载和卸载记忆卡，使其可以像文件系统一样访问。
可以使用uos模块中的其他函数来对记忆卡上的文件和目录进行操作，如listdir、open、read、write、close等。
可以使用任意的GPIO引脚作为SCK（时钟线）、WS（字选择线）和SD（数据线）。
可以设置时钟速率、超时时间、是否使用内部上拉电阻等参数。

记忆卡的应用场景有：

在需要存储大量数据或文件的情况下，使用记忆卡来增加存储容量，例如音频、视频、图片等。
在需要与其他设备或电脑交换数据或文件的情况下，使用记忆卡来方便地传输数据或文件，例如配置文件、日志文件、固件更新等。
在需要实现一些特殊功能的情况下，使用记忆卡来存储一些必要的资源或代码，例如字体文件、图形库、网络模块等。

记忆卡需要注意的事项有：

在使用记忆卡之前，需要先导入machine和uos模块，并创建SDCard对象。
在使用记忆卡时，需要注意引脚的选择和连接，避免与其他功能冲突或影响性能。
在使用记忆卡时，需要注意在合适的位置挂载和卸载记忆卡，以及关闭打开的文件，否则可能会损坏文件系统或数据。

以下是MicroPython的ESP32 记忆卡几个实际运用程序参考代码案例：

案例1：使用记忆卡来存储一个WAV音频文件，并播放它：

from machine import Pin, I2C, I2S, SDCard
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)

# 构造一个硬件SDCard对象
sd = SDCard(slot=1) # 使用内置SD/MMC硬件

# 挂载SDCard到/sd目录
uos.mount(sd, "/sd")

# 打开一个WAV音频文件
f = uos.open('/sd/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()

# 卸载SDCard
uos.umount("/sd")

案例2：使用记忆卡来存储一个文本文件，并读取它：

from machine import SDCard
import uos # 导入文件系统模块

# 构造一个硬件SDCard对象
sd = SDCard(slot=1) # 使用内置SD/MMC硬件

# 挂载SDCard到/sd目录
uos.mount(sd, "/sd")

# 打开一个文本文件
f = uos.open('/sd/hello.txt', 'r')

# 读取文件内容
content = f.read()

# 打印文件内容
print(content)

# 关闭文件
f.close()

# 卸载SDCard
uos.umount("/sd")

案例3：使用记忆卡来存储一个图像文件，并显示它：

from machine import SDCard, SPI, Pin, I2C, I2S, LCD, ILI9341, ST7789, SSD1306, FrameBuffer
import uos # 导入文件系统模块

# 构造一个硬件SDCard对象
sd = SDCard(slot=1) # 使用内置SD/MMC硬件

# 挂载SDCard到/sd目录
uos.mount(sd, "/sd")

# 打开一个图像文件（BMP格式）
f = uos.open('/sd/image.bmp', 'rb')

# 跳过文件头部分（54个字节）
f.seek(54)

# 创建一个字节数组用于存储图像数据（320x240x2个字节）
buf = bytearray(320*240*2)

# 从文件中读取图像数据到字节数组中
f.readinto(buf)

# 关闭文件
f.close()

# 卸载SDCard
uos.umount("/sd")

# 构造一个SPI对象，用于连接LCD显示屏（ILI9341或ST7789）
spi = SPI(1, baudrate=40000000, polarity=1, phase=0, sck=Pin(14), mosi=Pin(13), miso=Pin(12))

# 构造一个LCD对象，用于控制LCD显示屏（ILI9341或ST7789）
lcd = LCD(spi, 320, 240, dc=Pin(27), cs=Pin(33), rst=Pin(32)) # 使用LCD驱动模块

# 初始化LCD显示屏（ILI9341或ST7789）
lcd.init()

# 创建一个帧缓冲区对象，用于存储图像数据（320x240x16位色彩）
fb = FrameBuffer(buf, 320, 240, FrameBuffer.RGB565)

# 将帧缓冲区对象的内容显示到LCD显示屏上
lcd.blit(fb, 0, 0)

案例4：初始化SD卡并读取文件内容：

import machine
import sdcard

# 初始化SPI总线
spi = machine.SPI(1, baudrate=10000000, polarity=0, phase=0)

# 初始化SD卡
sd = sdcard.SDCard(spi, machine.Pin(16))

# 打开文件
with open('/sd/test.txt', 'r') as file:
    content = file.read()
    print(content)

这个示例演示了如何初始化SD卡并读取文件内容。首先使用machine.SPI()初始化SPI总线，指定相关参数，如波特率、极性和相位等。然后使用sdcard.SDCard()初始化SD卡对象，传入SPI总线对象和SD卡的引脚（这里使用引脚16作为示例）。接下来，通过open()函数打开文件，并使用read()方法读取文件内容，最后将内容打印出来。

案例5：写入数据到SD卡文件：

import machine
import sdcard

# 初始化SPI总线
spi = machine.SPI(1, baudrate=10000000, polarity=0, phase=0)

# 初始化SD卡
sd = sdcard.SDCard(spi, machine.Pin(16))

# 打开文件并写入数据
with open('/sd/data.txt', 'w') as file:
    file.write('Hello, SD card!')

这个示例演示了如何初始化SD卡并将数据写入文件。首先使用machine.SPI()初始化SPI总线，指定相关参数。然后使用sdcard.SDCard()初始化SD卡对象，传入SPI总线对象和SD卡的引脚。接下来，通过open()函数打开文件并以写入模式打开（‘w’），使用write()方法将数据写入文件，这里将字符串’Hello, SD card!'写入到文件中。

案例6：列出SD卡中的文件列表：

import machine
import sdcard

# 初始化SPI总线
spi = machine.SPI(1, baudrate=10000000, polarity=0, phase=0)

# 初始化SD卡
sd = sdcard.SDCard(spi, machine.Pin(16))

# 列出文件列表
files = sd.listdir('/sd')
for file in files:
    print(file)

这个示例演示了如何初始化SD卡并列出SD卡中的文件列表。首先使用machine.SPI()初始化SPI总线，指定相关参数。然后使用sdcard.SDCard()初始化SD卡对象，传入SPI总线对象和SD卡的引脚。接下来，使用listdir()方法传入要列出文件的目录路径（这里是’/sd’），返回一个文件列表。最后使用循环遍历文件列表，并打印每个文件的名称。在使用MicroPython和ESP32进行SD卡操作时，需要确保正确连接SD卡模块并设置正确的引脚和SPI总线参数。具体的引脚和SPI总线参数需根据具体的硬件连接进行调整。

案例7：初始化SD卡并读取文件内容：

import machine
import uos

# 初始化SD卡
sd = machine.SDCard(slot=2, sck=machine.Pin(18), mosi=machine.Pin(23), miso=machine.Pin(19), cs=machine.Pin(4))

# 挂载SD卡
uos.mount(sd, "/sd")

# 读取文件内容
file_path = '/sd/test.txt'
with open(file_path, 'r') as file:
    content = file.read()
    print(content)

# 卸载SD卡
uos.umount("/sd")

在上述示例中，我们使用machine.SDCard()初始化ESP32的SDCard对象，并指定SD卡的槽号和引脚连接。然后，我们使用uos.mount()将SD卡挂载到指定的挂载点（此处为"/sd"）。接下来，我们使用open()打开文件并读取文件内容。最后，我们使用uos.umount()卸载SD卡。

案例8：创建新文件并写入内容到SD卡：

import machine
import uos

# 初始化SD卡
sd = machine.SDCard(slot=2, sck=machine.Pin(18), mosi=machine.Pin(23), miso=machine.Pin(19), cs=machine.Pin(4))

# 挂载SD卡
uos.mount(sd, "/sd")

# 创建新文件并写入内容
file_path = '/sd/test.txt'
with open(file_path, 'w') as file:
    file.write("Hello, SD card!")

# 卸载SD卡
uos.umount("/sd")

在上述示例中，我们使用machine.SDCard()初始化ESP32的SDCard对象，并指定SD卡的槽号和引脚连接。然后，我们使用uos.mount()将SD卡挂载到指定的挂载点（此处为"/sd"）。接下来，我们使用open()打开文件并以写入模式写入内容。在本例中，我们将字符串"Hello, SD card!"写入文件。最后，我们使用uos.umount()卸载SD卡。

案例9：列出SD卡上的文件和目录：

import machine
import uos

# 初始化SD卡
sd = machine.SDCard(slot=2, sck=machine.Pin(18), mosi=machine.Pin(23), miso=machine.Pin(19), cs=machine.Pin(4))

# 挂载SD卡
uos.mount(sd, "/sd")

# 列出文件和目录
file_list = uos.listdir("/sd")
for item in file_list:
    print(item)

# 卸载SD卡
uos.umount("/sd")

在上述示例中，我们使用machine.SDCard()初始化ESP32的SDCard对象，并指定SD卡的槽号和引脚连接。然后，我们使用uos.mount()将SD卡挂载到指定的挂载点（此处为"/sd"）。接下来，我们使用uos.listdir()列出"/sd"目录下的文件和目录列表，并使用循环遍历并打印每个项的名称。最后，我们使用uos.umount()卸载SD卡。

请特别注意，以上示例仅供参考，具体的使用方法可能因不同的硬件平台和MicroPython版本而有所差异。在实际编程中，你需要根据你所使用的硬件和具体需求进行适当的调整。