MicroPython 开发环境#

在开始构建项目之前,你需要首先做一些准备,这是非常重要的,你不能跳过。

1. 安装Thonny(重要)#

Thonny是一个免费、开源的软件平台,体积小,界面简单,操作简单,功能丰富,是一个适合初学者的Python IDE。在本教程中,我们使用这个IDE在整个过程中开发ESP32。Thonny支持多种操作系统,包括Windows, Mac OS, Linux。

1. 下载Thonny软件:

进入软件官网:https://thonny.org 下载Thonny软件,根据你的计算机系统选择对应的系统版本下载。

Img

2. Windows上安装Thonny软件(以4.0.2版本为例):

A. 下载后的Thonny图标如下。

Img

B. 双击 “thonny-4.0.2.exe”,会出现下面对话框,我这里是选择 Img 进行操作的。你也可以选择 Img 进行操作的。

Img

C. 如果您不熟悉电脑软件安装,您可以一直单击 “Next” 直到安装完成。

Img

Img

D. 如果您需要更改Thonny软件的安装路径,可以单击 “Browse…” 进行修改。选择安装路径后,单击 “OK”。

如果您不想更改安装路径,只需单击 “Next”;然后又继续单击 “Next”。

Img

Img

E. 选中 “Create desktop icon”,Thonny软件会在你的桌面上生成一个快捷方式,方便你稍后打开Thonny软件。

Img

F. 单击 “Install” 安装软件。

Img

G. 在安装过程中,您只需等待安装完成,千万不要点击 “Cancel”,否则将无法安装成功。

Img

H. 一旦看到如下界面,就表示已经成功安装了Thonny软件,点击 “Finish” 就可以。

Img

I. 如果你在安装过程中选择了 “Create desktop icon”,则可以在桌面上看到如下图标。

Img

2. Thonny软件基本配置#

A. 双击Thonny软件的桌面图标,可以看到如下界面,同时还可以进行语言选择(这里选择简体中文)和初始设置。设置完了点击 “Let’s go!”。

Img

Img

Img

Img

Img

B.. 选择 “视图” → “文件” 和 “Shell”。

Img

Img

Img

3. 烧入Micropython固件(重要)#

要在ESP32主板上运行Python程序,我们需要先将固件烧入到ESP32主板。

下载Micropython固件:

网页列出microPython的ESP32固件:https://micropython.org/download/esp32/

Img

我们可以从上面选择最新版本固件烧录,当然如果出错也可以选择python教程开头资料下载链接提供的固件,即本教程中使用的固件:esp32-20210902-v1.19.bin

烧入Micropython固件:

用USB线连接计算机和ESP32主板。

Img

1. 打开Thonny IDE,点击 “运行” ,选择 “配置解释器”。

Img

2. 选中 “MicroPython (ESP32)”,选中 “Silicon Labs CP210x USB to UART Bridge(COMX)”,然后点击 “安装或更新MicroPython”。(注意:端口选择带有Silicon Labs CP210x USB to UART Bridge的选项即可,后面的COMX不同电脑设备会不同,不必纠结于此)

这里如果没有Silicon Labs CP210x USB to UART Bridge的选项,请检查数据线是否连接到位,更换电脑的USB接口和数据线(可以使用手机充电线)并且重启编程软件重新测试,最后如果依旧无法识别请参照教程的《驱动安装》教程

Img

Img

Img

注意: 这里需要稍等一会下面一步的选择才可以选择。

3. 弹出如下对话框,“Port” 选择 “Silicon Labs CP210x USB to UART Bridge”,单击 “Browse…” 选择之前准备好的microPython固件。检查 “Erase flash before installing” 和 “Flash mode”,然后点击 “安装”,等待安装完成提示。(注意:如果安装固件失败,请再次点击 “安装”,然后按住ESP32主板上的Boot键 Img,出现上传进度百分比再松开Boot键。)

Img

Img

Img

在新版本软件中,界面有所变化,并且固件的烧录方法也有所变化,请按照你安装的软件实际界面进行操作,以下是新版本两种不同操作方法

方法一: 直接通过软件烧录固件(固件不需要另外下载)

按照下面标记选择好后点击 “安装”,然后等待。(如果失败请下载固件直接烧录)

image-20251009193301771

方法二: 直接烧录固件

选择好端口后找到下载的固件,选择固件后不要再进行任何修改,点击 “安装” 等待即可

image-20251009193602955

image-20251009194533282

image-20251009194659178

4. 等待安装完成。安装完成后先点击 “关闭” 再点击 “好的” 就行。

Img

Img

Img

5. 关闭所有对话框,转到主界面,点击 Img。如下图所示:

Img

6. 到目前为止,一切准备工作都已就绪。

4. 测试代码#

测试Shell命令:

在 “Shell” 窗口中输入 “print(‘hello world’)” 并按 Enter键

Img

在线运行:

ESP32需要连接到计算机时,它是在线运行。用户可以使用Thonny IDE编写和调试程序。

1. 打开Thonny并单击 Img打开”。

Img

2. 在新弹出的窗口中,单击 “此电脑”。

Img

在新的对话框中,找到前面下载的代码,在路径为:“…\Python\Python代码、固件\Python_代码\项目01 Hello World” 中选择 “Project_01_HelloWorld.py” 。

Img

Img

单击 Img, “Hello World” 将在 “Shell” 窗口中打印出来。

Img

注意:在线运行时,如果按下ESP32的复位键,用户的代码将不会再次执行。

5. Thonny常见的操作#

本教程中使用的代码保存在(即路径):“…\Python\Python代码、固件\Python_代码”。

Img

你可以把代码移到任何地方。例如,我们将代码保存在 D盘 中,路径为D:\2. 项目教程

Img

上传代码到ESP32:

为了方便起见,我们以 “项目10 8×8点阵屏” 为例。在 “项目10 8×8点阵屏” 文件夹中选择 “ht16k33.py”,右键单击鼠标,选择 “上传到/” 将代码上传到ESP32的根目录中。

Img

Img

下载代码到电脑:

在 “MicroPython 设备” 中选择 “boot.py”,右键选择 “下载到…” 把代码下载到你的电脑里。

Img

删除ESP32根目录下的文件:

在 “MicroPython 设备” 中选择 “ht16k33.py”,右键单击它且选择 “删除”,将 “ht16k33.py” 从ESP32的根目录中删除。

Img

Img

Img