1. 配置环境和条件
-
python 版本: 3.12.6
-
MicroPython固件版本:1.21
- 下载micropython库路径: https://micropython.org/download/
- MicroPython库路径: https://docs.micropython.org/en/latest/library/machine.html machine库
-
Python esptool 版本: 4.8.1
-
本文使用的是 ESP32-WROOM模块的开发板,下面的例子都是以ESP32开发板作为例子进行说明,如果你用的是其它的MicroPython开发板,只需要下载相应的固件和工具进行操作,大同小异。
-
操作系统Windows,如果您使用的Mac或者Linux,在下载或安装一些工具的时候会有差别,文章中也会特别说明一下。
-
如果你使用的是最新版的固件,并且执行某些例子代码时遇到问题,可以考虑使用低版本的固件。
2. 配置Python及MicroPython环境
电脑已配置Python环境,MicroPython要求python 3.x的版本;
- Python的下载链接:https://www.python.org/downloads/
根据你操作系统下载相应的版本即可,建议下载3.7或以后的版本即可。下载后执行安装程序,按照相应的提示操作即可。
如果下载的是压缩包,则需要解压缩后把Python下的bin路径加到PATH系统变量,要确保在命令行状态下能执行python和pip
如果在控制台命令窗口输入python能进入python环境表示安装成功;
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 esptool --port COM3 write_flash 0x0 C:\\Users\\Administrator\\Desktop\\ESP环境\\ESP32_GENERIC-OTA-20241129-v1.24.1.bin
至此,烧录固件完成
5. 编写代码并运行
连接到开发板
选择文件后右键直接在开发板运行。
另外,RT-Thread提供的REPL支持可以方便的管理开发板上的文件,如果你想开发板上电就运行你的程序,就把要执行的文件名改为boot.py然后上传到开发板。