固件 / 烧录

固件资料来自 sketch_may27a_customer/sketch_may27a.ino、setup_esp32c3_test_env.ps1、build_esp32c3.ps1 和 flash_esp32c3.ps1。

所需工具

• Python 3
• Arduino CLI
• 支持数据传输的 USB 线
• ESP32-C3 状态灯设备

安装 ESP32-C3 所需环境

在项目目录执行：

.\setup_esp32c3_test_env.ps1

脚本会检查并安装：

• ESP32 开发板核心
• Adafruit NeoPixel
• Adafruit GFX Library
• Adafruit SSD1306
• Adafruit BusIO
• Python 依赖 pyserial 和 websockets
• 项目本地虚拟环境 .venv

查看开发板端口

arduino-cli board list

如果自动识别失败，可以设置：

$env:CODEX_LIGHT_PORT="COM40"

请把 COM40 换成你电脑上的实际端口。

编译固件

.\build_esp32c3.ps1

脚本使用：

esp32:esp32:esp32c3
CDCOnBoot=cdc
UploadSpeed=921600

编译并烧录

推荐直接执行：

.\flash_esp32c3.ps1

成功时一般会看到：

Connected to ESP32-C3 on COM40
Hash of data verified.
Hard resetting via RTS pin...

烧录失败排查

• 检查 USB 线是否支持数据传输
• 关闭 Arduino IDE 串口监视器
• 关闭 Python 测试脚本
• 确认 COM 口是否正确
• 必要时设置 CODEX_LIGHT_PORT