ESP32-MicroPython 开发环境
Linux/Mac 下使用MicroPython开发ESP32
刷入固件
使用 esptool.py 将 MicroPython 刷入 ESP32 开发板涉及几个步骤。
1. 安装 esptool
如果你还没有安装 esptool.py，你可以使用 pip 来安装它：
pip install esptool
2. 下载 MicroPython 固件
MicroPython - Python for microcontrollers
前往 MicroPython 的官方网站，找到 ESP32 的固件，然后下载合适的 .bin 文件。确保选择与你的 ESP32 开发板兼容的版本。
3. 连接你的 ESP32
使用适当的 USB 数据线将 ESP32 开发板连接到你的计算机。
4. 查找 ESP32 的串口
在终端或命令提示符中，使用以下命令查找 ESP32 的串口：
ls /dev/tty.*
记下 ESP32 的串口名，例如 /dev/ttyUSB0
5. 擦除现有固件
为了确保 MicroPython 正确地安装在 ESP32 上，首先擦除开发板上的现有固件：
esptool.py --port <YOUR_PORT> erase_flash
将 <YOUR_PORT> 替换为你在第4步中找到的串口名。
6. 刷入 MicroPython 固件
使用以下命令将 MicroPython 固件刷入 ESP32：
esptool.py --chip esp32 --port <YOUR_PORT> write_flash -z 0x1000 <PATH_TO_YOUR_MICROPYTHON_BIN_FILE>
替换 <YOUR_PORT> 为你的串口名，并将 <PATH_TO_YOUR_MICROPYTHON_BIN_FILE> 替换为你下载的 .bin 文件的路径。
7. 重启 ESP32
完成刷入操作后，断开并重新连接 ESP32 的电源，或使用开发板上的复位按钮进行复位。
现在，ESP32 上应该已经运行了 MicroPython，你可以使用串口工具screen连接到 ESP32，并开始运行 MicroPython 命令。
上传MicroPython脚本
将写好的 Python 程序刷入 ESP32 来运行并不是直接将 Python 代码烧写到 ESP32 的 flash 中的常规做法。相反，你首先将 MicroPython 烧写到 ESP32，然后将你的 Python 脚本上传到 ESP32 上的文件系统，并在那里运行它。以下是如何做到这一点的步骤：
1. 安装 ampy
ampy 是 Adafruit 提供的一个工具，用于在与 MicroPython 兼容的设备上管理文件。你可以使用 pip 安装它：
pip install adafruit-ampy
2. 上传你的 Python 脚本
使用 ampy 将你的 Python 脚本放入 ESP32 的文件系统中。例如，假设你的脚本名为 main.py：
ampy --port <YOUR_PORT> put main.py
将 <YOUR_PORT> 替换为 ESP32 的串口名（如 /dev/ttyUSB0 ）。
3. 运行你的脚本
连接到 ESP32 的 REPL（Read-Evaluate-Print Loop）：
- 在 Linux 或 macOS 上，你可以使用
screen:
screen <YOUR_PORT> 115200
-
screen基本使用当你使用
screen连接到一个串口或其他设备后，你可以按照以下步骤断开连接：-
按
Ctrl+A键。这是screen的命令键。 -
紧接着按
k键。这将会提示你是否确定要杀死这个screen会话。 -
最后，按
y键确认。
这样就会结束
screen会话并断开连接。另外，你也可以按
Ctrl+A然后按d键来"分离"一个screen会话，这样你可以在后台保留会话并返回到终端。要重新连接到这个会话，可以使用screen -r命令。 -
一旦连接，你应该能够看到 MicroPython 的提示符 >>>。要运行你刚刚上传的脚本，只需输入：
import main
注意：如果你的脚本名为 main.py，ESP32 会在启动时自动运行它。如果你想要在设备启动时自动执行其他名称的脚本，你需要重命名该脚本为 main.py。
示例 main.py 使板子自带的灯呼吸闪烁
from machine import Pin, PWM
import time
# 使用 ESP32 的板载 LED。大多数 ESP32 开发板的板载 LED 连接到 GPIO2。
LED_PIN = 2
# 创建一个 PWM 对象
led = PWM(Pin(LED_PIN), freq=1000)
def breathe():
while True:
# 逐渐增加亮度
for duty in range(0, 1024, 10):
led.duty(duty)
time.sleep(0.05)
# 逐渐减少亮度
for duty in range(1023, -1, -10):
led.duty(duty)
time.sleep(0.05)
breathe()
使用ampy管理文件
使用ampy管理文件系统中的文件
ampy 是由 Adafruit 开发的一个工具，用于在与 MicroPython 兼容的板上管理文件。下面是如何使用 ampy 进行文件管理的常见命令：
1. 列出板上的所有文件
要列出板上的所有文件，你可以使用 ls 命令：
ampy --port <YOUR_PORT> ls
2. 上传文件到板上
要将文件上传到板上，使用 put 命令：
ampy --port <YOUR_PORT> put <LOCAL_FILE>
例如，要上传名为 main.py 的文件，使用：
ampy --port <YOUR_PORT> put main.py
3. 从板上读取文件
要从板上读取文件并将其内容打印到终端，使用 get 命令：
ampy --port <YOUR_PORT> get <REMOTE_FILE>
如果你还想将其保存到本地文件，可以：
ampy --port <YOUR_PORT> get <REMOTE_FILE> <LOCAL_FILE>
4. 删除板上的文件
要删除板上的文件，使用 rm 命令：
ampy --port <YOUR_PORT> rm <REMOTE_FILE>
5. 创建目录
要在板上创建目录，使用 mkdir 命令：
ampy --port <YOUR_PORT> mkdir <DIRECTORY_NAME>
6. 执行脚本并查看输出
你可以使用 run 命令来执行板上的 MicroPython 脚本并看到其输出：
ampy --port <YOUR_PORT> run <SCRIPT_NAME>
注意事项
-
在使用
ampy之前，确保已经断开了其他对板子的连接（例如screen,），否则ampy可能无法与板子通讯。 -
<YOUR_PORT>是你的设备连接的串口。例如/dev/ttyUSB0。
ampy 为管理 MicroPython 板上的文件提供了简单而直接的方法。如果你经常使用相同的串口，你也可以考虑在 .bashrc 或 .bash_profile 中设置 AMPY_PORT 环境变量，这样你就不必每次都指定 --port 参数了。
特殊文件 boot.py main.py
在 ESP32 上运行 MicroPython 时，boot.py 和 main.py 是两个特殊的文件，它们在启动过程中自动执行。它们之间的主要关系和区别如下：
1. 执行顺序：
-
boot.py: 当 ESP32 上的 MicroPython 被启动时，首先执行的是
boot.py。它的主要目的是进行初始化操作，例如设置无线网络连接、配置一些硬件参数或其他任何需要在程序运行之前进行的设置。 -
main.py: 在
boot.py执行完毕后，main.py将被执行。这是你的主应用程序或脚本，通常用于运行你的项目的主要功能或代码。
2. 用途：
-
boot.py: 由于它是首先执行的，
boot.py主要用于设置那些只需要配置一次的东西，如 Wi-Fi 设置或其他系统级初始化。在某些情况下，为了安全起见，你可能想在这里设置异常处理，以确保无论main.py中发生什么，都不会影响到系统的正常启动。 -
main.py: 这是你的主程序代码，可能包括处理循环、事件响应或任何你的项目需要的功能。
