1. 配置环境和条件
-
python 版本: 3.12.6
-
MicroPython固件版本:1.21
-
Python esptool 版本: 4.8.1
-
本文使用的是 ESP32-WROOM模块的开发板,下面的例子都是以ESP32开发板作为例子进行说明,如果你用的是其它的MicroPython开发板,只需要下载相应的固件和工具进行操作,大同小异。
-
操作系统Windows,如果您使用的Mac或者Linux,在下载或安装一些工具的时候会有差别,文章中也会特别说明一下。
-
如果你使用的是最新版的固件,并且执行某些例子代码时遇到问题,可以考虑使用低版本的固件。
2. 配置Python及MicroPython环境
电脑已配置Python环境,MicroPython要求python 3.x的版本;
2.1. Python下载
- Python的下载链接:https://www.python.org/downloads/
根据你操作系统下载相应的版本即可,建议下载3.7或以后的版本即可。下载后执行安装程序,按照相应的提示操作即可。
如果下载的是压缩包,则需要解压缩后把Python下的bin路径加到PATH系统变量,要确保在命令行状态下能执行python和pip
如果在控制台命令窗口输入python能进入python环境表示安装成功;
2.2. MicroPython下载
- 下载micropython库路径: https://micropython.org/download/
- MicroPython库路径: https://docs.micropython.org/en/latest/library/machine.html machine库
3. VsCode环境安装及Python插件扩展安装
3.1. 下载安装VSCode
如果已经安装,请跳过此步骤
VSCode的下载链接:https://code.visualstudio.com/Download 可以根据电脑环境下载相应的版本安装。安装过程比较简单这里不再赘述,按照安装程序引导一步步执行即可。
3.2. 安装RT-Thread MicroPython插件
在VSCode中搜索“RT-Thread MicroPython”或者“MicroPython”,找到插件后点安装。
插件安装后,按照插件的说明文档进行一些基本的设置即可。由于插件可能好久没更新了,有几点需要简单说明下:
在windows11系统,VSCode默认的终端已经是PowerShell,不用再单独设置。
可能好久没更新了,插件使用的MicroPython类库是比较早期的了,看文件日期是2019年12月份的。可以自己在路径中添加一下新版本库文件的搜索路径。
修改工作区Python的设置就可以了,点击上图红框的“在settings.json中编辑”,在python.autoComplete.extraPaths、python.linting.pylintArgs、python.analysis.extraPaths中添加MicroPython的库路径
{
"python.autoComplete.extraPaths": [
"你的路径/micropython-1.21.0/lib/micropython-lib/micropython",
"c:/Users/xxx/.vscode/extensions/rt-thread.rt-thread-micropython-1.0.11/microExamples/code-completion"
],
"python.linting.pylintArgs": [
"--init-hook",
"sys.path.append('你的路径/micropython-1.21.0/lib/micropython-lib/micropython')",
"import sys; sys.path.append('c:/Users/xxx/.vscode/extensions/rt-thread.rt-thread-micropython-1.0.11/microExamples/code-completion')"
],
"python.analysis.extraPaths": [
"你的路径/micropython-1.21.0/lib/micropython-lib/micropython",
"c:/Users/xxx/.vscode/extensions/rt-thread.rt-thread-micropython-1.0.11/microExamples/code-completion"
]
}
具体RT-Thread的使用看它的README文档就可以了,已经介绍的比较详细,大致的步骤是:
新建MicroPython工程,可以选择空的,也可以选它提供的例子
4. windows下烧录芯片固件
- 查询官方microPython官方网站,获取esp32固件二进制包
-
下载esptool刷机 python 库
# 安装esptool pip install esptool # 确认已经安装esptool # 擦洗原有内容, windows下执行二进制.exe文件, linux 下执行.py文件 esptool --chip esp32 --port COM3 erase_flash # 烧录固件 esptool --port COM3 write_flash 0x0 C:\\Users\\Administrator\\Desktop\\ESP环境\\ESP32_GENERIC-OTA-20241129-v1.24.1.bin esptool --chip esp32 --port COM3 write_flash -z 0x1000 C:\\Users\\Administrator\\Desktop\\ESP环境\\ESP32_GENERIC-20220618-v1.19.1.bin esptool --chip esp32 --port COM3 write_flash -z 0x1000 C:\\Users\\Administrator\\Desktop\\ESP环境\\ESP32_GENERIC-20220117-v1.18.bin esptool --chip esp32 --port COM3 write_flash -z 0x1000 0x0 C:\\Users\\Administrator\\Desktop\\ESP环境\\ESP32_GENERIC-20220117-v1.18.bin esptool --chip esp32 --port COM3 write_flash -z 0x1000 0x0 C:\\Users\\Administrator\\Desktop\\ESP环境\\ESP32_GENERIC-20210623-v1.16.bin
至此,烧录固件完成; 烧录高版本需要根据自己板实际情况,当出现问题不响应等问题,可以尝试降低版本。重点: 烧录起始地址建议按照官方建议从0x1000开始;芯片选择esp32;
5. 编写代码并运行
5.1. 连接到开发板
点击左下角的连接按钮,然后在弹出的设备列表中选择想要连接的设备,即可连接 MicroPython 开发板。

5.2. 查看示例代码文件
富的示例代码,可在左侧活动栏中查看示例代码和库文件。右键点击示例文件,在下拉菜单中可以将示例文件添加到工程中。
5.3. 直接在开发板上运行 MicroPython 文件(调试神器)
该功能用于快速调试单个文件,频繁应用在调试代码的过程中。当我们在一个单独的文件中编写测试程序时,使用该功能可以将当前 python 文件下载到开发板的内存中运行,达到快速调试的效果,还可以使用快捷键 alt + q 来触发该功能。
在开发板上运行 MicroPython 代码片段
如果只是想进行代码量不大的代码调试,而不想将文件下载到开发板上,那么可以使用 代码片段 功能。在编辑器中选中想要运行的代码片段,然后在右键下拉菜单中选择 在设备上执行选中的 MicroPython 代码 选项,即可在 REPL 环境中运行所选代码。
5.4. 下载文件/文件夹到开发板
如果想要下载单个文件/文件夹到开发板,此时可以使用 下载单个文件/文件夹到开发板 的功能。在工程中选中想要下载到开发板上的文件/文件夹,在下拉菜单中使用该功能即可。这里需要注意的是,如果开发板上有同名的文件/文件夹,下载操作将会覆盖这些已有的文件/文件夹。
通过在 repl 中输入 os.listdir() 命令可以查看相应的文件/文件夹是否下载成功,同样在 repl 中还可以使用相应的命令 删除文件或文件夹,命令列表如下所示:
查看是否下载文件到esp32板子或删除板上文件
```python
import os;
os.listdir()
```

这里需要注意的是,如果开发板上有同名的文件/文件夹,下载操作将会覆盖这些已有的文件/文件夹。通过在 repl 中输入 os.listdir() 命令可以查看相应的文件/文件夹是否下载成功,同样在 repl 中还可以使用相应的命令 删除文件或文件夹,命令列表如下所示:
```python
os.remove("del_file") #删除文件
os.rmdir("del_dir") #删除文件夹
```
选择文件后右键直接在开发板运行。
另外,RT-Thread提供的REPL支持可以方便的管理开发板上的文件,如果你想开发板上电就运行你的程序,就把要执行的文件名改为boot.py然后上传到开发板。
重点:
- 不要删除工程目录下的 .mpyproject.json 文件,该文件是 MicroPython 工程的配置文件,删除后将无法正常运行 MicroPython 代码程序。
5.5. 同步工程文件目录
点击左下角的同步按钮可以启动工程同步功能。通过该功能可将本地工程中所有目录文件,同步到开发板的文件系统中。该功能推荐在代码调试完成后使用,在调试过程中不必频繁同步工程。
工程同步完成后,可以在 DEVICE FILES LIST 栏目中看到 设备中的文件列表。
微信赞赏
支付宝赞赏