使用MicroPython库搭建ESP32的VsCode开发环境

  • Embed
  • 134 clicked

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下载

根据你操作系统下载相应的版本即可,建议下载3.7或以后的版本即可。下载后执行安装程序,按照相应的提示操作即可。

如果下载的是压缩包,则需要解压缩后把Python下的bin路径加到PATH系统变量,要确保在命令行状态下能执行python和pip

如果在控制台命令窗口输入python能进入python环境表示安装成功;

2.2. MicroPython下载

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下烧录芯片固件

  1. 查询官方microPython官方网站,获取esp32固件二进制包
  2. 下载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 开发板。

![](https://turbock79.cn/wp-content/uploads/2025/01/vscode-rtthred.jpg)

5.2. 查看示例代码文件

富的示例代码,可在左侧活动栏中查看示例代码和库文件。右键点击示例文件,在下拉菜单中可以将示例文件添加到工程中。

5.3. 直接在开发板上运行 MicroPython 文件(调试神器)

该功能用于快速调试单个文件,频繁应用在调试代码的过程中。当我们在一个单独的文件中编写测试程序时,使用该功能可以将当前 python 文件下载到开发板的内存中运行,达到快速调试的效果,还可以使用快捷键 alt + q 来触发该功能。

在开发板上运行 MicroPython 代码片段
如果只是想进行代码量不大的代码调试,而不想将文件下载到开发板上,那么可以使用 代码片段 功能。在编辑器中选中想要运行的代码片段,然后在右键下拉菜单中选择 在设备上执行选中的 MicroPython 代码 选项,即可在 REPL 环境中运行所选代码。

5.4. 下载文件/文件夹到开发板

如果想要下载单个文件/文件夹到开发板,此时可以使用 下载单个文件/文件夹到开发板 的功能。在工程中选中想要下载到开发板上的文件/文件夹,在下拉菜单中使用该功能即可。这里需要注意的是,如果开发板上有同名的文件/文件夹,下载操作将会覆盖这些已有的文件/文件夹。

通过在 repl 中输入 os.listdir() 命令可以查看相应的文件/文件夹是否下载成功,同样在 repl 中还可以使用相应的命令 删除文件或文件夹,命令列表如下所示:

查看是否下载文件到esp32板子或删除板上文件

```python
import os;
os.listdir()
```
![](https://turbock79.cn/wp-content/uploads/2025/01/image.png)

这里需要注意的是,如果开发板上有同名的文件/文件夹,下载操作将会覆盖这些已有的文件/文件夹。通过在 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 栏目中看到 设备中的文件列表。

赞赏

微信赞赏支付宝赞赏

发表评论

邮箱地址不会被公开。 必填项已用*标注