ESP32-S3 搭建 MicroPython 开发环境
计算学徒
2026年03月31日 19:43
收录于文集
共14篇
嵌入式开发

ESP32-S3 是乐鑫推出的一款拥有双核、支持 AI 加速指令并且带有原生 USB 接口的高性能芯片。相比于传统的 C/C++ (ESP-IDF 或 Arduino),使用 MicroPython 开发 ESP32-S3 能够免去漫长的编译过程,让你像写脚本一样快速验证硬件逻辑。

这里我来详细说明如何为 ESP32-S3 开发板搭建 MicroPython 开发环境,并跑通你的第一个“带日志输出”的闪灯程序。

准备工作

在开始之前,请确保手头有以下物品:

  1. ESP32-S3 开发板(任何厂家的均可,我手头的开发板是 BananaPI 的 Bpi-Leaf-S3 开发板)。

  2. Type-C 数据线(一定要确保是“数据线”而不是仅能充电的“供电线”,否则电脑无法识别串口)。

  3. 一台装有 Windows、macOS 或 Linux 的电脑。我使用的是 Windows 电脑。

第一步:下载专属的 MicroPython 固件

MicroPython 相当于开发板的“操作系统”。我们需要先下载与 S3 芯片匹配的系统镜像。

  1. 访问 MicroPython 官方下载页(https://micropython.org/download/ESP32_GENERIC_S3/)。

  2. 下载最新的 Stable (稳定版) .bin 固件文件。

第二步:安装开发利器 Thonny IDE

对于 Python 硬件开发,Thonny IDE 是首选。它不仅是一个代码编辑器,还内置了固件烧录工具和文件交互系统。

  1. 前往 Thonny 官网(https://thonny.org/) 下载并安装对应系统的版本。

  2. 打开 Thonny,通过数据线将 ESP32-S3 连接至电脑。

  3. 如果你的开发板有两个 Type-C 接口(通常标为 UART 和 USB),建议先插 USB 原生接口。

第三步:将固件烧录进开发板

打开刚刚安装好的 Thonny IDE,在"运行"菜单弹出菜单中点击"配置解释器",然后在弹出的"Thonny 选项"对话框上点击"安装或更新":

然后在弹出的 “Install MicroPython (esptool) ” 对话框中设置安装选项:

  • Target port:选择 ESP32-S3 开发板连接的 COM 口。

  • MicroPython family:选择 “ESP32-S3”。

  • variant 和 version:点击“安装”按钮左边的那个小按钮,选择刚刚下载的 MicroPython 固件(.bin文件)即可。

设置完成之后点击“安装”按钮,等待安装完成。

第四步:实战演练

在 Thonny IDE 主界面右下角,选择选择刚刚配置好的 ESP32 解释器:

如果看到 IDE 下面的 Shell 窗口出现了 >>> 的提示符,说明已经 Thonny 已经连接到 EPS32 开发板了。

在 Thonny 中创建一个 .py 代码文件,输入:

代码块
Python
自动换行
复制代码
import machine
import time

# 初始化板载 LED(假设在 GPIO 2,如果你的板子引脚不同请修改)
led = machine.Pin(2, machine.Pin.OUT)

# 初始化一个计数器
count = 0

print("程序开始运行,准备输出日志...")

while True:
    # 翻转 LED 状态(亮 -> 灭 或 灭 -> 亮)
    led.value(not led.value())
    
    # 累加计数
    count += 1
    
    # 获取当前系统运行时间(毫秒)
    uptime = time.ticks_ms()
    
    # 输出日志信息到控制台
    # 使用 f-string 格式化字符串(MicroPython v1.13+ 支持)
    print(f"[LOG] 第 {count} 次执行 | 系统运行时间: {uptime} ms | LED 状态: {'亮' if led.value() else '灭'}")
    
    # 暂停 1 秒
    time.sleep(1)
复制成功

点击工具栏的运行图标,将代码上传到 ESP32 开发板中运行:

代码正常运行就会在 Shell 窗口中看到开发板打印的日志信息。

#ESP32-S3#​ #MicroPython#​ #物联网#​ #嵌入式开发#​ #Thonny#​

(完)