AGM-C3 固件 v1.4
发布日期：2026-10-11。设备型号：AGM-C3；芯片：ESP32-C3，最低修订版本 v0.3；Flash：4 MB，DIO / 80 MHz；AT 协议：2。
本版本支持 Codex 会话的上下文占用读数，并每 5 秒轮换配额与上下文显示。推荐搭配 AgentMate 服务端 v0.3.3；具体变更见包内或版本目录中的 CHANGELOG.md。
下载
- 完整烧录包 agentmate-AGM-C3-v1.4.zip：包含应用、bootloader、分区表、OTA 初始化数据、字库和烧录说明。
- 单独应用固件 agentmate-AGM-C3-v1.4.bin：仅供已有兼容 bootloader 和分区布局的设备更新应用，不能直接用于空白芯片。
- 下载校验清单 SHA256SUMS。
下载后用 shasum -a 256 <文件>、sha256sum <文件> 或 PowerShell Get-FileHash <文件> -Algorithm SHA256 与清单中的对应行核对。解压后还可使用包内 SHA256SUMS 校验全部烧录文件。
烧录准备
在 AgentMate 面板安全移除当前设备，等待显示“已移除，可烧录”，关闭其他串口工具。电脑需要 Python 和 esptool；以下命令使用本次构建配套的 esptool 4.10.0：
python -m pip install esptool==4.10.0
将命令中的 PORT 替换为实际端口，例如 macOS /dev/cu.usbserialXXXX、Linux /dev/ttyUSB0 或 Windows COM3。
首次烧录或完整安装
解压 ZIP，进入 agentmate-AGM-C3-v1.4 目录，执行：
python -m esptool --chip esp32c3 --port PORT --baud 460800 write_flash @flash_args
flash_args 使用下列文件及地址，来自本次构建的分区表和烧录配置：
| 文件 | 烧录地址 | 用途 |
|---|---|---|
| bootloader.bin | 0x000000 | 引导程序 |
| partition-table.bin | 0x008000 | 分区表 |
| ota_data_initial.bin | 0x00F000 | 选择初始 OTA 应用槽 |
| agentmate_esp32.bin | 0x020000 | v1.4 应用，写入 ota_0 |
| hzk16.bin | 0x380000 | 16×16 汉字库 |
以上命令保留 0x9000 开始的 NVS 分区，不包含清空整片 Flash 操作；完整安装会重置 OTA 槽选择到 ota_0。不要将这份固件用于其他设备型号。
已有设备仅更新应用
仅适用于相同分区布局、当前从 ota_0（0x20000）启动的 AGM-C3。使用 ZIP 内的 agentmate_esp32.bin：
python -m esptool --chip esp32c3 --port PORT --baud 460800 write_flash --flash_mode dio --flash_freq 80m --flash_size 4MB 0x20000 agentmate_esp32.bin
若仅下载单独应用文件，将最后的文件名替换为 agentmate-AGM-C3-v1.4.bin。分区布局或当前 OTA 槽不确定时，使用完整烧录包；不清空 NVS 即可保留设备 ID、模式及亮度等设置。
首次启动与恢复连接
新 NVS 首次启动进入 FACTORY 产测模式。产测完成后，通过 UART0（115200、8N1、CRLF）发送 AT+MODE=NORMAL；设备保存模式并重启。AT+INFO? 应报告型号 AGM-C3、软件版本 v1.4 和协议 2。
关闭烧录或串口工具后，在 AgentMate 面板点击“重新连接”，或拔出后再插入设备。
构建来源与验证
源码提交：eaf25e125e30b95789eaabe2cbb35a960209ae6a；components 子模块：0d64650af522f1871cf2d96133d9ed78711d8234。固件版本来自源码根目录 CMakeLists.txt 的 project(... VERSION 1.4)。
使用 ESP-IDF v5.5.1-789-g8d036f2edc，从受版本控制的 sdkconfig.defaults 生成独立发布配置。包内 BUILDINFO.txt、sdkconfig 和 partitions.csv 记录本次构建信息与 Flash 布局。
已通过 ESP-IDF 构建、镜像校验、字库 CRC 校验及主机 UI/LED 回归测试。本次没有执行真机烧录或串口验收。