ESP32-C3 是一颗便宜好用的物联网芯片,刷上 MicroPython 后就能用 Python 写程序控制它、连 WiFi、读传感器。但很多新手卡在「怎么把它连上电脑、怎么刷固件、怎么把代码传上去、怎么看打印」。这套流程就是手把手教你怎么用 Thonny(一个对初学者友好的 Python IDE)完成全部这些事。
除了基础烧录/上传/看串口,它还沉淀了一堆「极易误判为代码 bug 的坑」:按 RST 后 Thonny 报连接丢失其实是正常的、Ctrl+D 是软重启快捷键别当文字敲、未接配件驱动报「no module」是预期跳过。以及两个实机验证过的专题:3.3V 主控驱动 5V 继电器 和 长轮询超时 ETIMEDOUT。
thonny.exe。*.bin 文件(如 micropython-1.19.1-esp32c3-2mflash-firmware.bin)。C3 插电脑 USB → 设备管理器「端口(COM & LPT)」应出现新 COM 口(如 COM3);显示未知设备就右键更新驱动或装芯片官网驱动。
打开 Thonny,点右下角当前 Python 版本 → 「配置解释器…」→ 类型选 MicroPython (ESP32) → 端口选刚看到的 COM 口 → OK。
运行 → 配置解释器 → 选 MicroPython(ESP32) → 「安装或更新固件」→ 端口选 COM、固件选 *.bin → 按住 C3 上的 BOOT 键点安装,进度条走完再松手。完成后 Shell 出现 >>>。变体优先选 Espressif ESP32-C3 (generic),别选 Wemos/LOLIN C3 mini。
打开本地 main.py、aht20.py 等 → 每个标签页「文件 → 保存到 → MicroPython 设备」,文件名保持原样(main.py 等)。未到的配件驱动可暂不传。
确保 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+重试间隔。
no module named 'sh1106' 这类提示是优雅跳过,不代表崩。