diff --git a/README.md b/README.md index 7e7a72a..ca157ee 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ | 设备型号 | 最新固件 | 下载与说明 | | --- | --- | --- | -| AGM-C3（ESP32-C3，4 MB Flash） | v2.1 | [烧录包、应用固件与安装说明](device/AGM-C3/v2.1/README.md) | +| AGM-C3（ESP32-C3，4 MB Flash） | v2.2 | [烧录包、应用固件与安装说明](device/AGM-C3/v2.2/README.md) | 完整设备版本列表见 [设备索引](device/README.md)。服务端与设备固件分别维护版本号。 diff --git a/device/AGM-C3/README.md b/device/AGM-C3/README.md index 9904feb..45f58a8 100644 --- a/device/AGM-C3/README.md +++ b/device/AGM-C3/README.md @@ -6,9 +6,10 @@ | 固件版本 | 发布日期 | AT 协议 | 发布说明 | | --- | --- | --- | --- | +| v2.2 | 2026-10-24 | 2 | [下载与烧录](v2.2/README.md) | | v2.1 | 2026-10-13 | 2 | [下载与烧录](v2.1/README.md) | | v1.4 | 2026-10-11 | 2 | [下载与烧录](v1.4/README.md) | -v2.1 提供新版界面、待机配色、串口 OTA 和启动回滚，推荐搭配 [AgentMate 服务端 v0.6.0](../../service/v0.6.0/README.md)。旧设备请先安装完整烧录包中的回滚 bootloader。 +v2.2 新增自定义 RGB 时间配色及居中的会话状态圆点，过滤已停止会话。v2.1 提供新版界面、待机配色、串口 OTA 和启动回滚，推荐搭配 [AgentMate 服务端 v0.6.0](../../service/v0.6.0/README.md)。旧设备请先安装完整烧录包中的回滚 bootloader。 [设备型号索引](../README.md) · [仓库首页](../../README.md) diff --git a/device/AGM-C3/v2.2/BUILDINFO.txt b/device/AGM-C3/v2.2/BUILDINFO.txt new file mode 100644 index 0000000..f7bac7f --- /dev/null +++ b/device/AGM-C3/v2.2/BUILDINFO.txt @@ -0,0 +1,26 @@ +model=AGM-C3 +firmware_version=2.2 +at_software_version=v2.2 +protocol_version=2 +target=esp32c3 +chip_revision_min=0.3 +flash_size=4MB +flash_mode=dio +flash_frequency=80m +app_offset=0x20000 +app_partition_size=0x1A0000 +app_size_bytes=659264 +bootloader_app_rollback_enabled=1 +ota_test_fail_boot=0 +build_date=2026-10-24 +source_repository=https://git.eehut.com/liuchuansen/agentmate_esp32 +source_commit=411830796df54caf027cb9c7cc572e280aab92e9 +source_tag=v2.2 +components_commit=0d64650af522f1871cf2d96133d9ed78711d8234 +esp_idf=v5.5.1-789-g8d036f2edc +esptool=4.10.0 +compiler=riscv32-esp-elf-gcc 14.2.0 +configuration=sdkconfig.defaults (fresh SDKCONFIG) +verification=idf.py build; image version/checksum/hash; font CRC; ASan/UBSan UI/LED/XMODEM/OTA host tests +hardware_feature_tests=passed on development v2.1 before version bump +release_image_hardware_flash_test=not_performed diff --git a/device/AGM-C3/v2.2/CHANGELOG.md b/device/AGM-C3/v2.2/CHANGELOG.md new file mode 100644 index 0000000..e9712af --- /dev/null +++ b/device/AGM-C3/v2.2/CHANGELOG.md @@ -0,0 +1,92 @@ +# 更新日志 + +## 2.2 — 2026-10-24 + +### 新增 + +- 新增 `AT+CLOCKRGB=r,g,b` 和查询接口，各通道范围 0～255；设置后启用 CUSTOM 时间主题，保存自定义颜色并预览 5 秒。 +- 新增 `AT+CLOCKTHEME=CUSTOM`，切换预设仍保留自定义 RGB；主题和 RGB 合并持久化，兼容旧版保存的预设。 + +### 改进与修复 + +- Session 指示点移至圆屏下半部边沿，采用左侧 5 个、右侧 3 个固定点位；优先左侧，从中间向上下展开，单会话也显示。 +- 各圆点显示对应会话状态色，当前会话使用更大的实心点并按 1.6 秒周期变化，无外圈。 +- 圆点与会话轮播共用展示资格判断，排除 initializing、ready、ended、offline 和未使用槽位；过滤后重新居中，放大标记始终跟随当前会话。 +- 补充 RGB 参数边界、持久化及预览保护的串口验收，增加圆点数量、配色、居中点位和局部刷新回归检查。 + +### 兼容性 + +- 软件版本升级为 `v2.2`，AT 协议仍为 `2`，引脚和 Flash 分区布局保持不变。 +- 从 v2.1 升级时保留预设；降级至旧固件不保证保留新版自定义配色配置。 + +## 2.1 — 2026-10-13 + +- 新增 AT + XMODEM 串口 OTA、应用校验、提交重启、启动健康检查和回滚支持。 +- 成功设置时间主题时预览时间日期页 5 秒，保留注意会话保护及现有灯效。 + +### 时间主题 + +- 时间日期待机页默认采用 B 版暖琥珀配色；增加原版白色、A 版薄荷绿和 Codex 紫色方案。 +- 新增 `AT+CLOCKTHEME=` 与查询指令，立即生效并持久保存，重复设置避免重复写入。 +- 全页面设计稿更新为 v6.3，加入待机配色选择器；该阶段设备侧新增配色能力，AT 协议保持 2。 + +## 2.0 — 2026-10-12 + +### 界面改版 + +- 按 `docs/design/session_page_five_rows.html` v6.2 实现当前支持的全部页面：启动、连接、Session、时间日期待机、Codex 用量、设备信息和产测。 +- 默认屏幕背景统一纯黑；连接顶栏使用更明显的弧形下边界，Session 头部使用 agent 代表色描边和目录文字。 +- Session 图标放大并直接融入黑底，主状态与明细合并布局；状态区保留黑底和彩色动态边框，等待输入与批准沿用原有动效。 +- 明细按工作时长 10 秒、有效 agent 用量 3 秒、有效上下文 3 秒轮换，无效项跳过。单个用量窗口保持原宽度；配额使用紫色面板，上下文使用蓝色面板。 +- 上下文增加 CTX 标题，token 数值右对齐并支持 K／M 单位和三位有效数字；已用与总量使用等高、深浅不同的面板。 +- 待机时间采用 52 px 方正数字，日期放大；Codex 待机用量改为卡片，保留百分比、进度条和重置时间，支持双窗口与单窗口。 +- 产测页面采用统一中文布局，保留原有颜色、字体、背光、LED 测试和自动测试流程。 + +### 资源与刷新 + +- ESP32-C3 目录仅显示可打印 ASCII，其他 Unicode 字符逐个替换为 `?`；协议保存和回读的原始 UTF-8 不变。 +- 移除完整中文目录字库，仅保留固定文案字形；数字按字形绘制，继续使用局部刷新与共享小块缓冲。 +- 增加弧形顶栏缓存、单双用量切换和产测返回的重绘检查，保持状态边框、冒号闪烁与明细轮换独立更新。 + +### 验证与兼容性 + +- 固件构建、主机 ASan／UBSan 渲染回归及真实设备 UI／产测串口检查通过；屏幕颜色与观感仍需目视验收。 +- 软件版本升级为 `v2.0`，主机渲染测试从构建配置读取版本；AT 协议仍为 `2`，引脚、分区及 NVS 格式不变。配对认证仍为二期范围。 + +## 1.4 — 2026-10-09 + +### 新增 + +- Codex 会话支持接收和显示上下文已用百分比、已用 token 数和窗口 token 数。 +- 会话页图标下方每 5 秒轮换配额组（五小时／七天剩余用量）与上下文组；未知上下文显示灰色 `--`。 +- 增加上下文轮换边界、会话切换、局部重绘以及真机 context 写入／回读与非法字段测试。 + +### 改进 + +- 普通上下文和配额刷新不重置轮换计时，切换会话、状态组或连接代际后从配额组开始。 +- Codex 会话页的五小时用量整体下移 3 px，两组用量数字由 15 px 放大为 17 px。 + +### 兼容性 + +- AT 协议保持为 `2`，Codex context 复用现有四字段；服务端与固件需同步升级。 +- Codex 四字段全空保留为不支持上下文语义，此时仅显示配额；Claude 显示保持不变。 + +## 1.3 — 2026-10-06 + +### 新增 + +- Codex 会话页在图标下方显示五小时和一周的剩余用量，上下固定排列，不显示窗口标题。 +- 每组使用整数数字和下方细进度条；数字保持原有大小，进度条从左到右显示剩余比例。 +- 数字和进度条按显示值使用绿色（≥50）、橙色（20–49）或红色（0–19）；未知用量显示 `--` 和空轨道。 +- 增加主机像素回归与真机串口测试，覆盖用量舍入、颜色边界、窗口选择、原子提交、清空及局部重绘。 + +### 改进 + +- 会话页与独立用量页共用 Codex 配额选择规则，用量刷新不重置会话轮播或页面淡入。 +- 主机标识与会话短名之间统一使用中点，例如 `LOCAL·S1`。 +- 固件版本更新为 `v1.3`，同步更新主机测试和 AT 指令文档中的版本信息。 + +### 兼容性 + +- AT 协议版本保持为 `2`，复用现有 `USAGE` 数据，无需扩展电脑端协议。 +- Claude 会话的上下文用量显示保持不变。 diff --git a/device/AGM-C3/v2.2/README.md b/device/AGM-C3/v2.2/README.md new file mode 100644 index 0000000..3e336f3 --- /dev/null +++ b/device/AGM-C3/v2.2/README.md @@ -0,0 +1,78 @@ +# 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 验收，最终屏幕观感仍需目视确认。 diff --git a/device/AGM-C3/v2.2/SHA256SUMS b/device/AGM-C3/v2.2/SHA256SUMS new file mode 100644 index 0000000..c13e2bc --- /dev/null +++ b/device/AGM-C3/v2.2/SHA256SUMS @@ -0,0 +1,2 @@ +6c87ea169dcc1377d8ae9fe56d9a42fe9e4d3f7854400a3d752316c8096a5dc0 agentmate-AGM-C3-v2.2.bin +db2a664ae91dd0482e3065f37691b65e65255350de72c6a6ff376be5c4263b60 agentmate-AGM-C3-v2.2.zip diff --git a/device/AGM-C3/v2.2/agentmate-AGM-C3-v2.2.bin b/device/AGM-C3/v2.2/agentmate-AGM-C3-v2.2.bin new file mode 100644 index 0000000..bf98c29 Binary files /dev/null and b/device/AGM-C3/v2.2/agentmate-AGM-C3-v2.2.bin differ diff --git a/device/AGM-C3/v2.2/agentmate-AGM-C3-v2.2.zip b/device/AGM-C3/v2.2/agentmate-AGM-C3-v2.2.zip new file mode 100644 index 0000000..43681b4 Binary files /dev/null and b/device/AGM-C3/v2.2/agentmate-AGM-C3-v2.2.zip differ diff --git a/device/README.md b/device/README.md index 938194f..f41cbb8 100644 --- a/device/README.md +++ b/device/README.md @@ -2,7 +2,7 @@ | 设备型号 | 芯片与 Flash | 最新版本 | 固件索引 | | --- | --- | --- | --- | -| AGM-C3 | ESP32-C3，4 MB | v2.1 | [版本列表](AGM-C3/README.md) | +| AGM-C3 | ESP32-C3，4 MB | v2.2 | [版本列表](AGM-C3/README.md) | 固件按 `device/<设备型号>/v<版本>/` 保存。每次发布同步更新设备型号索引、版本索引和仓库首页。