69 lines
4.1 KiB
Markdown
69 lines
4.1 KiB
Markdown
# AGM-C3 固件 v3.0
|
||
|
||
发布日期：2026-10-25。型号 AGM-C3；ESP32-C3（最低修订 v0.3）、4 MB Flash、DIO / 80 MHz；AT 协议仍为 2。
|
||
|
||
## 新功能
|
||
|
||
- 新增蓝牙键盘／鼠标电量待机页：由 AgentMate 服务端 0.7.1 选择最多四台外设，设备不自行扫描蓝牙。
|
||
- 1 台大数字、2 台双列、3 台列表、4 台 2×2 卡片，显示名称、类型图标、百分比和电量条。
|
||
- 低于 30% 珊瑚红，30～59% 琥珀色，60～100% 薄荷绿；0% 有效，未知和断开为灰色 `--`。
|
||
- 无选择、全未知或超过 180 秒未续发时跳过本页。存在蓝牙电量时按时间／有效 Codex 用量／蓝牙电量每页 10 秒轮播，工作和等待提醒优先。
|
||
- Session 改为静态发光短弧段，按活动会话加保留完成态统计，弧段间距加大；修复空 Codex 用量页。
|
||
- 保留已有自定义 RGB 时间主题、串口 OTA 和回滚能力。完整变更见 [CHANGELOG.md](CHANGELOG.md)。
|
||
|
||
## 下载
|
||
|
||
- [OTA 应用 agentmate-AGM-C3-v3.0.bin](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v3.0/agentmate-AGM-C3-v3.0.bin)
|
||
- [完整烧录包 agentmate-AGM-C3-v3.0.zip](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v3.0/agentmate-AGM-C3-v3.0.zip)
|
||
- [SHA256SUMS](SHA256SUMS) · [BUILDINFO.txt](BUILDINFO.txt)
|
||
|
||
下载后使用 `shasum -a 256 -c SHA256SUMS` 或 `sha256sum -c SHA256SUMS` 校验。ZIP 内另有逐文件校验清单。
|
||
|
||
## 从 v2.1／v2.2 更新
|
||
|
||
已安装兼容分区和回滚 bootloader 的设备，可通过服务端面板检查官方更新或选择本地应用 `.bin`。
|
||
应用 OTA 保留 NVS、字库、bootloader 和分区表，提交后重启并执行健康检查。v1.4 或不确定引导程序的设备先用完整烧录包。
|
||
不要把应用直接写到固定槽地址作为通用升级方式。
|
||
|
||
## 完整烧录
|
||
|
||
在面板安全移除设备，关闭串口占用程序，安装配套工具：
|
||
|
||
```sh
|
||
python -m pip install esptool==4.10.0
|
||
```
|
||
|
||
解压后进入 `agentmate-AGM-C3-v3.0`，把 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 |
|
||
| agentmate_esp32.bin | 0x020000 |
|
||
| hzk16.bin | 0x380000 |
|
||
|
||
完整包重置 OTA 启动槽为 ota_0，保留 0x9000 起的 NVS。不要整片擦除 Flash；仅适用于 AGM-C3。
|
||
新设备产测完成后发送 `AT+MODE=NORMAL`。`AT+INFO?` 应报告 AGM-C3、v3.0、协议 2。烧录后恢复面板连接。
|
||
|
||
## 选择显示的蓝牙外设
|
||
|
||
安装服务端 0.7.1，在“设备”页的“蓝牙键盘与鼠标”勾选“显示到设备”，最多四台。选择保存在主机私有配置中，默认不选择任何设备。
|
||
选择作用于本节点全部支持此功能的 USB 设备；设备仅接收主机的电量快照。断开、采集失败和过期读数不会作为当前电量显示。
|
||
屏幕长名称会省略，非 ASCII 名称显示为带序号的键盘／鼠标标签；服务面板仍保留完整名称。
|
||
`AT+BATTERY?` 返回最大容量和当前项数。服务端整批下发选项或读数变化，同一快照每分钟续发。
|
||
协议仍为 2；旧固件不会收到不支持的新指令。自定义时钟配色继续断电保存。
|
||
|
||
## 构建与验证
|
||
|
||
源码 [6b7551d11b2b08aae95739a8118dd46fa1ee8d4c](https://git.eehut.com/liuchuansen/agentmate_esp32/commit/6b7551d11b2b08aae95739a8118dd46fa1ee8d4c)，标签 v3.0；components 子模块 `0d64650af522f1871cf2d96133d9ed78711d8234`。
|
||
从 sdkconfig.defaults 生成全新发布配置，ESP-IDF v5.5.1-789-g8d036f2edc，GCC 14.2.0、esptool 4.10.0。
|
||
启用应用回滚，强制失败测试关闭，普通 UART0 控制台日志关闭。
|
||
已通过发布构建、图像版本与 checksum/hash、字体 CRC、ASan/UBSan UI／LED／XMODEM／OTA 主机回归。
|
||
本发布镜像已烧录到真实 AGM-C3 并通过串口参数边界、整批错误、断开／未知、待机轮播与提醒优先级检查，
|
||
Go 服务到真机的四项下发、减少及清空也通过。物理屏幕观感仍需目视确认。
|