4.1 KiB
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。
下载
下载后使用 shasum -a 256 -c SHA256SUMS 或 sha256sum -c SHA256SUMS 校验。ZIP 内另有逐文件校验清单。
从 v2.1／v2.2 更新
已安装兼容分区和回滚 bootloader 的设备，可通过服务端面板检查官方更新或选择本地应用 .bin。
应用 OTA 保留 NVS、字库、bootloader 和分区表，提交后重启并执行健康检查。v1.4 或不确定引导程序的设备先用完整烧录包。
不要把应用直接写到固定槽地址作为通用升级方式。
完整烧录
在面板安全移除设备，关闭串口占用程序，安装配套工具：
python -m pip install esptool==4.10.0
解压后进入 agentmate-AGM-C3-v3.0，把 PORT 换成实际串口：
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，标签 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 服务到真机的四项下发、减少及清空也通过。物理屏幕观感仍需目视确认。