79 lines
4.7 KiB
Markdown
79 lines
4.7 KiB
Markdown
# AGM-C3 固件 v2.2
|
||
|
||
发布日期：2026-10-24。型号：`AGM-C3`；ESP32-C3（最低修订 v0.3）、4 MB Flash、DIO / 80 MHz；AT 协议 `2`。
|
||
|
||
## 本版变化
|
||
|
||
- 新增 `AT+CLOCKRGB=r,g,b` 与查询：每个通道为 0～255，设置后自动启用 CUSTOM 时间主题并预览 5 秒。
|
||
- 新增 `AT+CLOCKTHEME=CUSTOM`，在预设和自定义颜色间切换；自定义 RGB 与当前主题断电保存，兼容旧版预设。
|
||
- Session 指示点采用左 5、右 3 的固定圆弧点位，从中间向上下展开；单会话也显示。
|
||
- 点颜色对应各会话状态，当前点放大并按 1.6 秒周期变化，无外圈。
|
||
- 圆点统计与轮播共用展示资格，排除 initializing、ready、ended、offline 及未使用槽位。
|
||
- 保留已有串口 OTA、回滚、页面优先级、配额和上下文轮换行为。完整修改见 [CHANGELOG.md](CHANGELOG.md)。
|
||
|
||
## 下载与校验
|
||
|
||
- [OTA 应用 agentmate-AGM-C3-v2.2.bin](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v2.2/agentmate-AGM-C3-v2.2.bin)：仅用于已有兼容分区和回滚 bootloader 的设备。
|
||
- [完整烧录包 agentmate-AGM-C3-v2.2.zip](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v2.2/agentmate-AGM-C3-v2.2.zip)：应用、bootloader、分区、OTA 初始化数据、字库、配置、校验清单与说明。
|
||
- [SHA256SUMS](SHA256SUMS) · [BUILDINFO.txt](BUILDINFO.txt)。下载后使用 `shasum -a 256 -c SHA256SUMS` 或 `sha256sum -c SHA256SUMS` 校验；ZIP 内另有文件校验清单。
|
||
|
||
## 串口 OTA 升级
|
||
|
||
已安装 v2.1 或其他兼容串口 OTA 与回滚基础固件的设备，可通过服务端设备面板检查官方更新，或选择本地应用 `.bin` 升级。
|
||
在线更新只选择较新稳定版；同版本重刷或降级使用本地文件。
|
||
OTA 仅更新应用，保留 NVS、字库、bootloader 和分区表。上传完成后仍需提交重启，首次启动需通过健康检查；失败时由回滚 bootloader 恢复旧槽。
|
||
仅应用升级不能替换旧 bootloader。v1.4 或不确定分区及 bootloader 的设备应先使用完整烧录包。
|
||
|
||
## 完整烧录
|
||
|
||
先在 AgentMate 面板安全移除设备，等待串口释放，关闭其他串口工具。安装配套工具：
|
||
|
||
```sh
|
||
python -m pip install esptool==4.10.0
|
||
```
|
||
|
||
解压 ZIP 并进入 `agentmate-AGM-C3-v2.2`，将 PORT 换成实际串口后执行：
|
||
|
||
```sh
|
||
python -m esptool --chip esp32c3 --port PORT --baud 460800 write_flash @flash_args
|
||
```
|
||
|
||
| 文件 | 地址 | 用途 |
|
||
| --- | --- | --- |
|
||
| bootloader.bin | 0x000000 | 启用回滚的引导程序 |
|
||
| partition-table.bin | 0x008000 | 分区表 |
|
||
| ota_data_initial.bin | 0x00F000 | 重置启动槽为 ota_0 |
|
||
| agentmate_esp32.bin | 0x020000 | v2.2 应用 |
|
||
| hzk16.bin | 0x380000 | 16×16 字库 |
|
||
|
||
本操作保留从 0x9000 开始的 NVS，重置 OTA 槽选择；不要整片擦除 Flash。仅适用于 AGM-C3。
|
||
新设备首次启动进入 FACTORY 模式，完成产测后发送 `AT+MODE=NORMAL` 保存模式并重启。
|
||
`AT+INFO?` 应报告 `AGM-C3`、`v2.2` 和协议 `2`。烧录后恢复面板连接。
|
||
|
||
## 自定义时间配色
|
||
|
||
```text
|
||
AT+CLOCKRGB=18,171,239
|
||
OK
|
||
AT+CLOCKRGB?
|
||
+CLOCKRGB:18,171,239
|
||
OK
|
||
AT+CLOCKTHEME?
|
||
+CLOCKTHEME:CUSTOM
|
||
OK
|
||
```
|
||
|
||
切回预设可用 `AT+CLOCKTHEME=AMBER`（也支持 WHITE、MINT、CODEX），不会丢失已保存 RGB。
|
||
`AT+CLOCKTHEME=CUSTOM` 恢复自定义色。设置成功预览 5 秒；等待输入／批准时不覆盖会话页。
|
||
黑色 RGB 合法，时间因此可能不可见。非法参数返回 INVALID_ARG，保存失败返回 STORAGE_ERROR，产测模式返回 UNSUPPORTED_FEATURE。
|
||
日期与辅助文字按输入颜色派生；RGB565 屏幕会对颜色量化。降级至旧固件不保证保留自定义色。
|
||
|
||
## 构建来源与验证
|
||
|
||
源码：[411830796df54caf027cb9c7cc572e280aab92e9](https://git.eehut.com/liuchuansen/agentmate_esp32/commit/411830796df54caf027cb9c7cc572e280aab92e9)；标签 [v2.2](https://git.eehut.com/liuchuansen/agentmate_esp32/src/tag/v2.2)；components 子模块 `0d64650af522f1871cf2d96133d9ed78711d8234`。
|
||
从 `sdkconfig.defaults` 生成全新发布配置，ESP-IDF `v5.5.1-789-g8d036f2edc`，工具链 GCC 14.2.0、esptool 4.10.0。
|
||
启用回滚，关闭强制启动失败测试和普通 UART0 控制台日志；具体配置见 ZIP 中的 sdkconfig 和 BUILDINFO.txt。
|
||
发布构建、版本描述符、镜像 checksum/hash、字体 CRC、ASan/UBSan UI/LED/XMODEM/OTA 主机回归均通过。
|
||
本版功能已在真实 AGM-C3 上做过 RGB 参数、重启持久化、预览保护及混合状态切换串口检查；当时仍报告开发版本 v2.1。
|
||
本次 v2.2 全新发布构建尚未进行独立真机烧录或实机 OTA 验收，最终屏幕观感仍需目视确认。
|