Xiaomi Band LVGL 资源路径动态重定向模块 (
ng.lst.corona)
运行于 Canopus 模块框架之上,免修改系统只读分区即可实现对手环 UI 图片、图标及主题资源的无感重定向与实时热重载。
当前 Manager 已迁入 corona 模块,使用 Canopus ABI 2 原生页面与桌面入口;首批目标为
Band 11 4.100.155、Band 10 Pro 3.101.043 和 REDMI Watch 6 3.100.043。首页状态卡保留原视觉,其他控件使用系统组件。
模块状态和重载结果通过内存快照与内部通知更新,不再轮询控制文件。
CanopusConnect 设备端已接入二进制接收、续传、磁盘校验、分步解压与安装登记;
手机发送端及蓝牙实机验收仍待完成,详见 设备端实现与边界。设计、实现边界与验证记录见
原生 Manager 文档。
Manager 始终生成 version=1 的 launcher、control_center、notifications、
widgets 四个独立配置项,支持图片、blur 和 system;缺省项恢复系统背景。
Band11 的 widgets 仅解析、不执行,不触发该区域的图片检查、加载、模糊或原生挂钩。
p67 3.101.043 默认包含四区域静态背景、LIVE 前景和原生模糊;
每个精确 target 只有一个完整功能产品,不再提供无背景或 launcher-only 构建。
RH_P67_LIVE_LAUNCHER、RH_P67_LIVE_BACKGROUNDS、RH_P67_BLUR_NATIVE
已废弃,设置为 0 或 1 都会明确报错;需要移除这些环境变量。
仅详细诊断保留独立开关:RH_P67_BLUR_DIAGNOSTICS=1(只对 .043 生效)。
背景固定在屏幕坐标并按移动页面裁剪;其余三区保留原生快照生命周期,
隐藏快照图像并显示实时前景。blur 在 REFR_START 按需主动采集到模块自有 BGR888 缓冲,
生成模块自有 RGB565 静态模糊背景;失败在 REFR_READY 重试、不访问原生源池、不做 inline patch,
不使用透明快照、不改日历。模糊不是持续采集的实时效果;必须显式等待 raw GPU fence,不得猜测缓存 API。
静态模糊的设备绘制、GPU/cache 行为与帧时间均为 NOT_PROBED;既有图片背景的
用户反馈不代表新增模糊路径已获设备验证。
详见 p67 审计记录。
.043 自定义控制中心背景还自动启用电池局部透明合成:保留原厂白底、
电量和充电图标,离屏绘制完成后按原遮罩 alpha 恢复平滑透明边缘,
再随实时坐标绘制;不通过删灰色阈值去边。默认离屏区为 122×92 ARGB8888
(约 43.8 KiB,另有原生分配开销),覆盖率缓存另占 3 KiB;
首次或资源变化时临时采样遮罩,滚动不逐像素处理,也不回填壁纸。
旧纯黑抠除及静默绘制回退已删除:恢复失败不绘制电池,并输出有界诊断日志。
修复了采样图片被创建成全屏 screen、实际尺寸无法缩小的问题;子图片采样版待实机验证。
GPU 故障恢复与帧时间仍未验证,详见
电池透明合成与验收。
+-------------------------------------------------------------+
| Corona Editor (PC 端主题包编辑器) |
| 可视化制作资源包 / 映射编辑 / 导出主题包 |
+-------------------------------------------------------------+
| 传输
v
+-------------------------------------------------------------+
| Manager (模块内原生 UI) |
| 资源包管理 / 优先级排序 / 混搭配置 / 内部重载事务 |
+-------------------------------------------------------------+
|
内存快照 / 状态变更通知
active-config 配置代次指针
v
+-------------------------------------------------------------+
| Canopus-Module-Resource-Hook (C 核心) |
| +---------------------+ +-------------------------------+ |
| | 紧凑规则索引 (二分) | | 定向缓存退休 (lv_cache_drop) | |
| | 最长前缀 / @system | | UI 脏区重绘与 Owner 刷新 | |
| +---------------------+ +-------------------------------+ |
+-------------------------------------------------------------+
| Hook
v
+-------------------------------------------------------------+
| LVGL POSIX Driver ('/' 读模式) |
| 透明重定向: ROMFS 原生资源 ==> themes/... 替代资源 |
+-------------------------------------------------------------+
以下为 Hook 各精确适配的历史设备反馈;不代表新增原生 Manager 已在这些设备上实测。
当前原生 Manager 构建目标为 Band 11 .155 / .179、Band 10 Pro .043 和 REDMI Watch 6 .043;.179 与 P65 为精确静态适配,实机与完整 Mirage 验收尚未执行。其余适配源码保留,需另行集成 UI 与验证。
| 设备型号 | 固件版本 | 验证状态 | 图片重定向 | 快应用图标 | 日历动态图标 | 字体热重载 |
|---|---|---|---|---|---|---|
| REDMI Watch 6 (P65) | 3.100.043 |
静态与指令测试通过,NOT_PROBED | 静态 | 静态 | 静态 | 静态 |
| Xiaomi Band 11 | 4.100.179 |
静态适配,NOT_PROBED | 静态 | 静态 | 静态 | 静态 |
| Xiaomi Band 11 | 4.100.177 |
实机通过(用户反馈) | 静态 | 静态 | ✅ | 静态 |
| Xiaomi Band 11 | 4.100.155 |
实机通过(用户反馈) | ✅ | ✅ | ✅ | ✅ |
| Xiaomi Band 11 | 4.100.139 |
实机通过(用户反馈,默认目标) | ✅ | ✅ | ✅ | ✅ |
| Xiaomi Band 10 Pro | 3.101.043 |
实机通过(用户反馈) | ✅ | ✅ | ✅ | ✅ |
P65 默认完整功能: 图片重定向、快应用图标、系统字体热切换、日历文字/图片合成、四区域背景与静态模糊均默认编入,无需额外环境变量。Manager 为
432×514,日历使用模块自有96×96ARGB8888 文件双缓冲,默认配置恢复原厂文件。需要同步修改的 Canopus P65 revision 3 pack 与 Supervisor(含精确字号、删除事件及绘制生命周期绑定)。功能是否应用由主题配置决定;缺省仍为系统外观。此端口的完整 GPU 与实机行为仍为 NOT_PROBED,详见 P65 适配记录。当前源码日历变更: 六个精确 target 均支持
calendar配置。Band11 与 P65 使用独立 ARGB8888 文件 bank;P67.043自定义日历仅 RAM 双缓冲发布,不再落盘或重定向派生文件,默认配置恢复原生日历。.177既有用户反馈与精确 API 审批不等同于逐像素一致性、故障恢复或其他版本的设备证明;本轮 P67 RAM-only 改动为 NOT_PROBED,尚未实机验证。详见 日历配置与限制。注意: 各固件目标使用独立的 ELF、内存布局和地址白名单,严禁混用。
升级说明:本模块与旧版resource_hook/manager_resource_hook不兼容。安装前请先停用并完整重启手环。
- 高性能紧凑重定向:基于内存优化快照(256 条规则仅占 ~13 KiB),二分查找精确命中 + 最长前缀目录回退,支持
@system原生透传与遮蔽。 - 精准定向缓存退休:使用
lv_cache_drop逐键退休受影响的文件缓存并申请局部脏区重绘,拒绝粗暴的全局清空,杜绝掉帧与白屏。 - 动态图标支持:
- 快应用包名图标:支持
@quickapp-icon/<package>声明,UI 线程只读查询真实应用注册记录并精准映射。 - 透明日历图标:Band11 独立 ARGB8888 合成与文件读取重定向;P67 自定义图标仅 RAM 发布,默认配置沿用原生日历。
corona.json的calendar支持 month/day/weekday 文字或图片,底图仍使用原来的资源映射。配置示例见examples/calendar/corona.json。
- 快应用包名图标:支持
- 字体热重载:所有精确目标默认启用受检查的字体事务(P65 /
.177/.179尚未实机验收),保留现有字体 wrapper、fallback 与原厂路径基线,支持字体切换和规则移除后的原厂恢复。需使用不可变字体代次;GPU 故障恢复、框架重启及自定义字体 owner 不在支持范围内。 - 内部状态与配置事务:Manager 与 Hook 共用模块内状态。重载按不可变代次准备完整配置,发布
active-config后等待内部刷新通知;失败保留旧资源引用。 - 独立容错与启动诊断:配置缺失或语法错误自动退回 pass-through 零规则模式,绝不阻断系统启动;启动各阶段独立记入
/data/offlinelog/resource-hook-startup.log。
原生数据根为 get_data_path 返回的 /data/canopus/m.corona/。
active-config 指向 active/<generation>/ 内的 mappings.tsv、backgrounds.cfg、calendar.cfg;
没有指针时读取根目录配置。以下 TSV 格式保持不变(真实 \t 制表符,最多 256 条):
# 目录映射:必须以 '/' 结尾,自动追加子路径
/system/images/icons/ themes/my_theme/icons/
# 精确文件重定向:以 .bin 结尾,完整路径匹配
/system/fonts/default.bin themes/my_theme/fonts/custom.bin
# 系统遮蔽:强行透传原厂文件,不被上层目录规则覆盖
/system/images/icons/battery.bin @system
# 快应用包名图标:按 package 名称自动解析替换启动器图标
@quickapp-icon/ng.lst.corona themes/my_theme/icons/corona.bin- 相邻
../Canopus-Private新版仓库(CMI2 / CPC2;先编译cargo build -p canopus-cli) - Clang / LLVM(支持 ARM target)、
ld.lld、Python 3.11+
框架模块 ID 为 corona,私有数据与主题迁至 /data/canopus/m.corona/。
Canopus.toml 声明 .155 / .043 / .179 及 P65 四个原生 UI target;scripts/build.sh 默认构建 .155。
编译包装器统一启用 RH_NATIVE_MANAGER=1,并注入精确固件宏;
scripts/canopus-ld.sh 合并 ELF sections,满足 Band11 loader 的 section 数量限制。
旧快应用 Manager 源码已删除,当前原生入口不依赖它;共享图片源独立保存在 assets/manager/。
首次读取资源列表时,原生管理器自动检查旧快应用数据根:Band 11 为
/data/quickapp/files/ng.lst.corona/,Band 10 Pro 为 /data/files/ng.lst.corona/。
根据旧 interconnect-themes.json 导入资源包;原生索引已存在时也会合并缺少的包,
同名 ID 保留原生包,已有排序、混搭和活动配置保留。首次全量迁移还复制旧活动资源及尚不存在的配置文件。
旧目录原样保留,复制完成后才发布资源索引;中断可重试。成功后记录
resource-legacy-imported,之后删除的包不会被重新导入,后续对旧目录的修改也不会继续同步。
导入后仍需通过管理器重载应用。框架须包含原生目录项文件名偏移修复(d_name 位于 +1);
旧框架按 +2 读取会截掉文件名首字节,导致资源导入或扫描失败,仅更新模块无法修复该框架错误。
配套 Supervisor 也将 .155 / .179 / .043 的系统右滑接入模块返回回调:内部页面先退一层,
首页再退出。返回时重绘失败保留原页面状态,连续返回可继续重试。
# 1. 编译指定目标 (生成 build/resource-hook.elf)
sh scripts/build.sh xiaomi-band-11-4.100.155
sh scripts/build.sh xiaomi-band-10-pro-3.101.043
sh scripts/build.sh xiaomi-band-11-4.100.179
sh scripts/build.sh redmi-watch-6-3.100.043
# 2. 生成原生模块交付(.canopus + CMI2,无需签名密钥)
python3 scripts/build-delivery.py dist/0.3.2-155 --target xiaomi-band-11-4.100.155
python3 scripts/build-delivery.py dist/0.3.2-179 --target xiaomi-band-11-4.100.179
# 3. 对已有 payload 运行交付校验测试
RESOURCE_HOOK_PAYLOAD=dist/0.3.2-155/payload/xiaomi-band-11-4.100.155 \
RESOURCE_HOOK_TARGET=xiaomi-band-11-4.100.155 python3 tests/test_delivery.py原生交付目录根部的 corona-0.3.2.canopus 是可安装模块包,通过 AstroBox 的 Canopus
入口安装。各原生 UI target 使用相同包格式,可重复 --target 组合;固件精确选择与原生通信由
Canopus 处理。Corona Manager 的内置图片作为 .canopus 包内资源随安装解压到模块私有目录,不打包进模块 ELF;
本轮增加 CanopusConnect 设备端主题接收实现,仍需配套手机发送端与实机验收。
默认交付运行宿主与产物校验;原生页面模拟器脚本为 scripts/test-manager-emulator.py,
每个目标使用独立 --library 与 --work,详见原生 Manager 文档。
Supervisor 的安装表盘仍用于引导框架。build-watchface.py 和
build-quickapp-watchface.py 是保留的旧模块投递工具,不属于新版默认交付。
构建全部 target 后,也可用新 CLI 生成统一模块包:
for target in xiaomi-band-11-4.100.155 xiaomi-band-10-pro-3.101.043 xiaomi-band-11-4.100.179; do
sh scripts/build.sh "$target" || exit 1
done
CANOPUS_ROOT=../Canopus-Private ../Canopus-Private/target/debug/canopus package输出为 dist/corona-0.3.2.canopus,包含每个 target 的 ELF 与 CMI2 回执。
旧 Supervisor 需要按新版框架流程重装;安装及升级语义见 安装说明。
Corona Manager 的 PNG 源图独立保存在 assets/manager/,不再依赖已删除的旧快应用源码。
.179 的逐项地址来源与验证边界见 精确适配记录。
相邻 Canopus .179 pack 需要 revision 2(补齐可见区域函数的精确 Thumb 调用身份),
该函数通过独立静态核对记为 STATIC_RECOVERED,仍为 restricted / PENDING / NOT_PROBED;
需要匹配的 .179 Supervisor;
模块包不代替框架适配或设备验收,旧固件实机反馈不覆盖 .179。
以下为原生 UI 迁移前的 Hook 兼容性记录:四个目标 .043/.139/.155/.177 曾通过 CLI 编译与 ELF 校验,
四目标统一 .canopus 包已通过 CLI 校验;.043 原生完整交付也已通过宿主与产物测试。
.043 需要包含 Canopus 提交 219fcb9 的 target pack(revision 8),其中补齐了图片创建与
控制中心样式的两项精确 XIP 跳板身份。它们仍为 restricted / STATIC_RECOVERED / PENDING,
没有提升实机能力状态。此次兼容构建尚未实机验证。
- 🎨 Corona Editor:官方可视化主题包编辑器,支持图形化配置资源映射、打包主题包并配合 Manager 快速导入。
- 🛠️ 资源图片处理工具:用于只读 ROMFS 提取、LVGL v9 I8 BIN 与 PNG 互相转换及预览的脚本套件。
如果你需要深入了解实现细节、逆向审计证据或协议标准,请参阅:
- 📦 安装、回退与实机验收指南
- 🖥️ 原生 Manager 设计、实现与验收
- 🔌 旧快应用控制协议记录 (
control.request/response) - 🩺 启动诊断日志与错误排查
- ⚙️ 底层生命周期边界、内存基准与固件仿真
- 📅 原生日历图标动态重载机制
- 🔤 字体热重载、实机验收与安全限制
- 🎨 资源图片转换与解包工具说明
本项目采用 GNU Affero General Public License v3.0(AGPL-3.0-only),完整条款见 LICENSE。