CABadge v1.2.0 · 动态壁纸与 Direct 转场

CABadge v1.2.0 — 7.9.16-eaf-transition

本版使用已编译、烧录并完成基本检查的7.9.16二进制，不重新编译。硬件仍为c7c59dff / ESP32-S3R8 / ST77916 360×360 QSPI。

更新

• EAF动态壁纸通过Direct路径播放，支持每个资源独立的固定/逐帧timing；旧资源默认30FPS。
• 导航时冻结并借用当前RGB565帧进行转场，完成后恢复播放，避免转场入口整帧复制/换序。
• 统一壁纸库、BlueMap下载连接复用/两路调度/缓存修复及USB诊断、电池图标和低电量提示。
• 保留静态壁纸、Wi-Fi/BLE、Grok和其他应用。esp_emote_gfx仅保留可选原型，正式后端不变。
• 转换工具不随本次发布提供；格式和转换要求见docs/EAF_TIMING.md，仓库保留上传工具。

安装

解压firmware.zip，校验包内SHA256SUMS.txt。COMx换为实际端口，安装Python/esptool。

已使用相同分区布局的7.9.x设备只更新应用：

python -m esptool --chip esp32s3 --port COMx --baud 115200 write-flash 0x10000 firmware.bin

首次安装或旧v1.0升级需写入三份BIN：

python -m esptool --chip esp32s3 --port COMx --baud 115200 write-flash 0x0 bootloader.bin 0x8000 partitions.bin 0x10000 firmware.bin

不要全片擦除。壁纸分区为0x710000起、大小0x8f0000；旧v1.0升级会扩大分区，升级前保留壁纸原文件，必要时备份整片Flash。已验证设备仅做应用更新，未重新验证所有历史版本迁移。新EAF可占连续多槽，含这些资源的库不应直接交给旧固件写入。

验证范围

当前BIN已完整编译、应用烧录及hash校验；短USB检查覆盖动态首页与控制中心/名片/功能面板往返、暂停恢复和静态切换，增加15次Direct命中且无新增miss。软件检查覆盖冻结帧借用/生命周期、timing和Direct路径。实屏触摸、颜色、残影和撕裂仍需用户目视确认；未做长期压力测试，无TE，不保证无扫描撕裂。未测本次静态/动态转场可比耗时，不宣称提升比例。

附件

• CABadge-v1.2.0-firmware.zip：三个BIN、verification.json、安装说明与校验值。
• CABadge-v1.2.0-debug.zip：ELF、有效sdkconfig与verification.json，用于排查。
• SHA256SUMS.txt：两个ZIP的校验值。

不包含个人素材、Flash/NVS备份、原始设备日志或转换工具。

CABadge v1.1.0 · 正式固件 7.9.2-memory

CABadge v1.1.0 — 正式固件发布

本版发布当前已烧录并完成基本检查的 7.9.2-memory 固件。项目版本为 v1.1.0，设备内部版本仍显示 7.9.2-memory，两者对应同一发布包。此前已有 v1.0，故保留历史版本并递增到 v1.1.0；本次不修改或重新编译已验证二进制。

更新内容

• ESP-IDF 6.1.0、LVGL 9.4.0、esp_lvgl_adapter 0.7.1；QSPI 40 MHz、DRAW_UNIT=1。
• Cached Bitmap + Direct Compositor 页面转场，单份 LCD-native RGB565 缓存、导航预热和按内存压力回收。
• BlueMap 16 KiB HTTP 流式 PNG 解码，直接采样到 RGB565 tile，取消完整 RGBA 中间图；退出时等待后台资源清理。
• 普通显示与 Direct 共用 23,040 B 内部 DMA staging；关闭正式版旧显示诊断数组。
• Flash 内置壁纸直接使用原资源，用户缩略图采用后台加载的五项 LRU；名片复用统一转场缓存。
• 保留 Wi-Fi/BLE、手机本地管理、壁纸库、蓝色名片、Grok、MC 二维地图与奶蛙矿工。

安装

适用于 c7c59dff 基线、ESP32-S3R8 / 8 MiB PSRAM / 16 MiB Flash / ST77916 360×360 QSPI。硬件未改版，硬件制造附件沿用历史 v1.0；J1 选型以 docs/J1-CONNECTOR.md 更正为准。

固件包解压后先校验 SHA256SUMS.txt。安装 Python、esptool、pyserial 后，在 BIN 所在目录执行，COMx 换成实际端口：

python -m esptool --chip esp32s3 --port COMx --baud 115200 write-flash 0x0 bootloader.bin 0x8000 partitions.bin 0x10000 firmware.bin

不要全片擦除。旧 v1.0 壁纸分区是 1 MiB，本版在相同 0x710000 起点扩展到 0x8f0000，因此旧版升级需一起更新 partitions.bin。迁移代码保留，但本次未重新实测从 v1.0 升级；升级前保留壁纸原文件，必要时先用 esptool read-flash 0 0x1000000 backup.bin 备份整片 Flash。备份含用户网络配置，不要公开上传。

已经使用相同分区布局的 7.9.x 用户可只写应用：

python -m esptool --chip esp32s3 --port COMx --baud 115200 write-flash 0x10000 firmware.bin

当前已运行 7.9.2-memory 的设备无需重复烧录。工作台使用者将固件包解压到 outputs/cabadge-v7.9.2-memory/，通过 firmware-v7/run.cmd 打开现有工具。

验证与边界

发布二进制已完整编译、COM3 应用烧录及哈希验证。一次基本检查覆盖主页、设置/连接、图库、Grok、BlueMap 返回；地图取得四瓦片、一玩家、error0，Wi-Fi 连接、BLE 广播，Direct errors0。原八张壁纸的持久化身份保持。

主机检查通过 PNG 碎片输入/采样/CRC/截断拒绝，DMA buffer 生命周期/最终完成通知/错误排空，以及 compositor stride/clip/取消检查。没有进行大规模 benchmark。

实屏触摸、撕裂/残影/颜色、BLE 对端连接和长期稳定性仍需用户验证。无 TE，不能保证所有场景无撕裂。手机管理热点为开放网络且无授权码；GIF、BLE 传图、OTA 不列为本版已交付能力。构建环境有 Windows/F 盘依赖，未验证干净机器字节级重建。

附件

• CABadge-v1.1.0-firmware.zip：三个 BIN、原始 verification.json、校验文件和安装说明。
• CABadge-v1.1.0-debug.zip：ELF、有效 sdkconfig、原始 verification.json。
• SHA256SUMS.txt：发布 ZIP 的 SHA-256。
• Source code：v1.1.0 标签对应当前 firmware-v7 源码，不包含开发缓存和个人设备原始日志。

第三方来源见 docs/THIRD_PARTY.md；第三方素材不因本项目 MIT 许可自动转授其他权利。

CABadge v1.0 · 7.3.7-mem

CABadge v1.0 — 固件 7.3.7-mem

发布状态

CABadge v1.0 对应固件 7.3.7-mem，已上板使用，基本功能可正常使用。目前仍存在较多 Bug，后续将持续修复和完善。本版本作为首个项目发布基线，不代表所有功能、异常场景和长期稳定性均已验证。

该实板状态来自用户在 2026-09-21 的明确反馈。本次整理不重新编译、不连接串口、不烧录，也不将历史软件测试升级为本版实板全项通过。

版本与硬件

• 项目标签：v1.0；固件内部版本：7.3.7-mem。
• 硬件基线：c7c59dff，完整 PCB SHA-256 为 c7c59dff5e6f2065a2157a81414d9d21c5cb1196a7b277656e15007753801a8d。
• 应用固件 SHA-256：0cb362981efb451003435bc424bdccc38edfd879d75f9a6fb037d54fa9e4f44a。
• 保留 40 MHz QSPI、双 PSRAM 绘图缓冲与异步 LCD 传输；不混入 Article 8.x 实验线。

已知问题与验证边界

• 用户确认当前版本仍存在较多 Bug；具体问题及复现步骤将逐项补充，不能视为无缺陷稳定版。
• TE 未连接，不能保证所有动态场景完全无撕裂。7.3.6 的历史缩略图撕裂记录不直接等同于 7.3.7 已确认复现。
• 长期运行、无线并发、异常上传恢复、触摸边界等尚未获得本次逐项验证证据。
• 背光约 5% 上限、CHG_ALLOW 保持 LOW 等工程限制仍保留；完整电源与充电管理不作为已验收能力。
• 桌面构建仍依赖 Windows/F 盘环境；历史说明中的旧版本与路径不是当前安装版本。见 docs/BUILD.md。

附件

• CABadge-v1.0-firmware-7.3.7-mem.zip：三个烧录 BIN、原始 verification.json、SHA256SUMS.txt、安装与发布状态说明。
• CABadge-v1.0-debug-7.3.7-mem.zip：ELF、构建配置、原始 verification.json 与校验值。
• CABadge-v1.0-hardware-c7c59dff.zip：冻结 PCB/钢网包、生产清单及下单说明。
• 源码由 v1.0 标签固定；开发环境、历史发布包和原始设备日志不包含在源码中。

原始 verification.json 中的 hardware_test: PENDING 保留构建时含义；本说明补充其后的用户实板反馈，不覆盖历史记录。首次提交是当前源码快照，未进行从干净环境重建并逐字节匹配固件的验证。

发布后采购更正：J1 屏幕座

首板实际换装商品规格为 FFC/FPC 0.5 mm、18P、抽屉式上接触。当前主分支 BOM / 采购表已更正；厂家型号与尺寸图尚未提供。v1.0 标签源码中的 FPC-05F-18PH20 / C2856802 是原设计记录，不是换座后已确认的采购料号。

复刻请先阅读 J1 连接器更正；历史标签、硬件生产包与固件附件保持不变。