68 lines
3.9 KiB
Markdown
68 lines
3.9 KiB
Markdown
# 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](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v1.4/agentmate-AGM-C3-v1.4.zip)：包含应用、bootloader、分区表、OTA 初始化数据、字库和烧录说明。
|
||
- [单独应用固件 agentmate-AGM-C3-v1.4.bin](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v1.4/agentmate-AGM-C3-v1.4.bin)：仅供已有兼容 bootloader 和分区布局的设备更新应用，不能直接用于空白芯片。
|
||
- [下载校验清单 SHA256SUMS](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v1.4/SHA256SUMS)。
|
||
|
||
下载后用 `shasum -a 256 <文件>`、`sha256sum <文件>` 或 PowerShell `Get-FileHash <文件> -Algorithm SHA256` 与清单中的对应行核对。解压后还可使用包内 `SHA256SUMS` 校验全部烧录文件。
|
||
|
||
## 烧录准备
|
||
|
||
在 AgentMate 面板安全移除当前设备，等待显示“已移除，可烧录”，关闭其他串口工具。电脑需要 Python 和 esptool；以下命令使用本次构建配套的 esptool 4.10.0：
|
||
|
||
```sh
|
||
python -m pip install esptool==4.10.0
|
||
```
|
||
|
||
将命令中的 `PORT` 替换为实际端口，例如 macOS `/dev/cu.usbserialXXXX`、Linux `/dev/ttyUSB0` 或 Windows `COM3`。
|
||
|
||
## 首次烧录或完整安装
|
||
|
||
解压 ZIP，进入 `agentmate-AGM-C3-v1.4` 目录，执行：
|
||
|
||
```sh
|
||
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`：
|
||
|
||
```sh
|
||
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 回归测试。本次没有执行真机烧录或串口验收。
|