ESP32-C3MicroPythonThonny烧录串口调试

ESP32-C3 + Thonny 上手(esp32c3-micropython-thonny)

用 Thonny 给 ESP32-C3 SuperMini 刷 MicroPython 固件、上传代码、查看串口输出的完整流程,含继电器/长轮询等实机踩坑。

一、这个 skill 是做什么的

ESP32-C3 是一颗便宜好用的物联网芯片,刷上 MicroPython 后就能用 Python 写程序控制它、连 WiFi、读传感器。但很多新手卡在「怎么把它连上电脑、怎么刷固件、怎么把代码传上去、怎么看打印」。这套流程就是手把手教你怎么用 Thonny(一个对初学者友好的 Python IDE)完成全部这些事。

除了基础烧录/上传/看串口,它还沉淀了一堆「极易误判为代码 bug 的坑」:按 RST 后 Thonny 报连接丢失其实是正常的、Ctrl+D 是软重启快捷键别当文字敲、未接配件驱动报「no module」是预期跳过。以及两个实机验证过的专题:3.3V 主控驱动 5V 继电器 和 长轮询超时 ETIMEDOUT。

二、什么时候用它

三、前置条件 / 准备

四、具体用法(步骤)

第 1 步:连接与识别

C3 插电脑 USB → 设备管理器「端口(COM & LPT)」应出现新 COM 口(如 COM3);显示未知设备就右键更新驱动或装芯片官网驱动。

第 2 步:配置 Thonny 解释器

打开 Thonny,点右下角当前 Python 版本 → 「配置解释器…」→ 类型选 MicroPython (ESP32) → 端口选刚看到的 COM 口 → OK。

第 3 步:刷 MicroPython 固件

运行 → 配置解释器 → 选 MicroPython(ESP32) → 「安装或更新固件」→ 端口选 COM、固件选 *.bin → 按住 C3 上的 BOOT 键点安装,进度条走完再松手。完成后 Shell 出现 >>>。变体优先选 Espressif ESP32-C3 (generic),别选 Wemos/LOLIN C3 mini。

第 4 步:上传代码文件

打开本地 main.py、aht20.py 等 → 每个标签页「文件 → 保存到 → MicroPython 设备」,文件名保持原样(main.py 等)。未到的配件驱动可暂不传。

第 5 步:运行与看串口

确保 main.py 是当前页,点绿色 ▶(或 F5)。Shell 会实时打印 [传感器] 温度:25℃ 湿度:60%、[上报] 状态码:200。拔插 USB 后 C3 自动跑 main.py,板载 LED 闪 1 下=开机、2 下=上报成功、3 下=失败。

五、可直接照用的示例

你直接对 AI大模型或AI智能体 说:「我刚买了块 ESP32-C3 SuperMini,怎么刷 MicroPython 然后跑个温湿度采集?」

AI大模型或AI智能体 会:让你装 Thonny、用数据线连上看到 COM3;配置解释器为 MicroPython(ESP32) 选 COM3;按住 BOOT 键刷 generic 固件;把 AHT20 接 GPIO4/5,上传 main.py(NODE_TYPE 设对)+aht20.py;软重启(Ctrl+D)看 Shell 出现「温度/湿度→WiFi 已连接→上报状态:200」即打通。

你直接对 AI大模型或AI智能体 说:「我按了板子上的 RST 键,Thonny 突然报 Connection lost / exit code 1,是不是代码崩了?」

AI大模型或AI智能体 会:告诉你这是正常的——RST 等于整芯片断电,会切断 USB 串口,Thonny 据此报连接丢失,与代码无关。点工具栏 Stop/Restart 重连即可,重连后 main.py 自动运行。想重启看输出优先用 Ctrl+D 软重启(键盘快捷键,不断串口)。

你直接对 AI大模型或AI智能体 说:「串口每隔十几秒就刷 [Errno 116] ETIMEDOUT,网络坏了吗?」

AI大模型或AI智能体 会:先让你查超时参数配对——设备端 urequests(timeout=N) 必须明显大于服务端挂起时长 hold。若反过来(服务端挂 30s、设备超时 25s)每轮都先自己断开,100% 失败却误判成网络问题。推荐配对:服务端 hold 20s ←→ 设备 timeout 40s,看门狗 WDT 要 > timeout+重试间隔。

六、常见注意 / 避坑

5V 继电器坑:ESP32-C3 GPIO 只有 0V/3.3V,3.3V 高电平关不净 5V 光耦继电器(吸合易、释放难)。首选解法:开漏低电平触发——IN1 直连 GPIO2(不加零件),模块 S1 跳线帽插 com-low,释放时把 GPIO 设输入高阻借模块容错设计回到释放态。切勿假定 3.3V 能可靠释放 5V 模块。

七、相关 skill / 延伸

← 返回 SKILL 库