固件 / 烧录
新版交付包内置预编译固件 firmware.bin 和一键烧录脚本，不需要安装 Arduino CLI 或 Python 环境。
固件和工具位于交付包的：
release/firmware/esp32_c3_v3_neopixel_oled/包含：
firmware.bin：预编译固件esptool.exe：烧录工具flash-windows.bat：一键烧录脚本agentcore_light_v3_neopixel_oled.ino：固件源码（高级用户参考）
什么时候需要烧录
- 设备首次使用，或当前固件版本过旧。
- 状态灯对命令无响应、灯效与文档不符。
- 设备能正常连接和使用时，请不要随意重刷固件。
烧录前准备
- 用支持数据传输的 USB 线连接状态灯和电脑。
- 关闭占用串口的软件：AgentCore-Light 控制台和后台服务、Arduino IDE 串口监视器、浏览器串口工具等。
一键烧录
双击固件目录中的 flash-windows.bat：
- 脚本自动检测 ESP32-C3 串口（COM 口）。
- 检测到多个设备时按序号选择；未检测到时可手动输入 COM 口。
- 确认后自动烧录，期间不要拔掉设备。
- 完成后提示“固件升级完成”，请重新插拔设备后再测试。
脚本实际执行的命令是：
esptool.exe --chip esp32c3 --port <COM口> --baud 460800 write_flash 0x0 firmware.bin烧录失败排查
- 确认 USB 线支持数据传输（充电线是最常见的失败原因）。
- 确认设备插紧，更换电脑 USB 接口重试。
- 关闭所有可能占用串口的软件后重试。
- 在设备管理器中确认当前 COM 口，再手动选择。
固件技术信息
| 项目 | 参数 |
|---|---|
| 主控 | ESP32-C3 |
| 灯珠 | WS2812 × 8（GPIO 4） |
| 屏幕 | SSD1306 128 × 64 OLED（SDA GPIO 8、SCL GPIO 9，地址 0x3C） |
| 固件串口波特率 | 115200 |
| 烧录波特率 | 460800 |
需要自定义固件时，可参考包内 agentcore_light_v3_neopixel_oled.ino 源码，依赖 Adafruit_NeoPixel、Adafruit_GFX、Adafruit_SSD1306 库。