mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-16 14:33:24 +09:00
143 lines
9.4 KiB
Markdown
143 lines
9.4 KiB
Markdown
# Magma run-ahead
|
||
|
||
**已完成,2026-09-20**。最终生产与实机行为头 `194382c96a8a5f51ef23f412fdccfbd40a82bf78`。
|
||
|
||
后续 `70fb6689` 已修复 RD32 下的 Magma inproc 性能差距:**86.85→116.73 FPS**,
|
||
同包 monolith **115.01 FPS**;根因、缓存生命周期与复测见 [性能修复报告](magma-rd32-performance-fix.md)。
|
||
|
||
后续同包的 **render distance 32 四组合性能测量**见 [rd32-fourway.md](rd32-fourway.md)。
|
||
该轮默认动态频率下,Espryt monolith/inproc 为62.18/64.02 FPS,Magma 为116.08/86.85 FPS;
|
||
不要将下面的功能验证窗口替代这份高负载性能记录。
|
||
|
||
本次是在已完成的 P5f 与 Magma inproc 游戏修复上继续实现异步排队,
|
||
不是重开 P5f 包,也不宣称 P6 spawn 或 P7/P8 全量实现。
|
||
契约见 `MobileGL/MG_Remote/CONTRACT-MAGMA-RUNAHEAD.md`。
|
||
|
||
## 实现
|
||
|
||
- Magma 独立 readiness 条件满足后发布 `kCapRunAheadApply`,复用既有客户端闩、
|
||
wait class、反向事件流控和 present credit。`MOBILEGL_IPC_RUN_AHEAD=0` 保留为配对对照。
|
||
reply、显式同步和 credit 耗尽的等待仍保留。
|
||
- wire draw/clear/color blit 不再逐 draw 提交并 `vkQueueWaitIdle`。render pass、
|
||
framebuffer、view 和 blit descriptor pool 按实际 submit index 延迟释放;
|
||
Present、重建和 shutdown 处理最后一批对象。独立 blit 不复写在途 descriptor set。
|
||
- texture 上传和 GPU 内容保留提交不能越过旧 draw;draw/dispatch 在取得当前
|
||
command buffer 前准备 image、sampled texture 和 FBO attachments。native blit
|
||
后同时失效 pipeline/dynamic state 与 uniform manager 的 descriptor 绑定缓存。
|
||
- GPU buffer readback 后保留后续 draw 已预约的 slice;CPU draw preparation 期间
|
||
不允许 idle-drain 回卷 transient arena。同 layout image transition 保留内存依赖。
|
||
- compute work-group 上限由本地 CapsMirror 回答,不再通过三个 getter 插入无谓
|
||
barrier。修改限于 transport 的两个 compute COUNT/SIZE 查询。
|
||
- Vulkan 验证层发现并修复 descriptor indexing API/extension 启用条件、含 dynamic
|
||
UBO layout 的非法 UPDATE_AFTER_BIND、HOST_WRITE stage 和 Present layout transition
|
||
的写后写依赖。wire 使用已有按内容版本分配的 descriptor set,不原地修改在途 set。
|
||
- 最小化窗口丢弃 recording 后,只有 CPU preparation、renderer submit 和纹理独立
|
||
upload fence 都空闲才回收 future-tag 对象。纹理 fence 只轮询,不新增 queue wait;
|
||
同时避免对象持续累积和误把 renderer watermark 当作整个队列的 idle 证明。
|
||
|
||
## Redmi 发现的 VAO 状态漏发
|
||
|
||
初版 `3c97ea9c` run-ahead 进入世界后触发 `Magma:vertex-layout@P7`。
|
||
`6f764c42` 诊断包关闭 run-ahead 仍复现:enabled attribute 1 对应的 buffer window
|
||
却是 `0+1`。因此没有删去边界检查,也没有把它当作驱动格式限制绕过。
|
||
|
||
根因是 dirty tracker 把 `{VAO lifetime, configVersion}` 用普通 hash-combine
|
||
压成一个值判断身份变化。普通整数对会碰撞;Redmi 实际记录的两个身份为
|
||
`174/37` 与 `48/8026`。缓冲家族因 aggregate 变化发布了新窗口,CSO 家族却
|
||
漏发 bind,形成旧布局与新窗口组合。现在精确比较两个字段,变化时重新检查
|
||
三个 vertex families,各 emitter 仍可抑制自身未变化的记录。
|
||
|
||
新测试通过合法 setter 构造真实 VAO 的碰撞配置,经实际 validate 路径检查
|
||
`A(0+1 enabled) → B(0 enabled) → A` 的绑定及窗口 `2→1→2`,不改私有计数器。
|
||
候选修复 `376c04be` 已在 Redmi 捕获碰撞被修复的日志,世界连续运行 64.167 秒,
|
||
验图正常。该诊断包不是最终交付验收包;初版失败证据保留。
|
||
|
||
## 主机验证
|
||
|
||
七种实际排队场景各测 present credit 1/3,共 14 项:
|
||
buffer SubData/respecify/delete-name-reuse、program/uniform 快照、SSBO 写回读、
|
||
native 与 double-converted vertex slice、旧 texture draw 与后续上传的顺序、
|
||
GPU clear 后首次 storage image 升级、credit 用完时客户端真实停车。
|
||
用已有 apply hook 暂停真实服务端,观察真实 emit/applied watermark 和 producerParked,
|
||
不伪造 capability/sequence,也不把 ARMED 日志当作排队证明。
|
||
|
||
关闭 run-ahead 的负控同一 testcase 必须实际等 apply、失去 client lead 并失败,
|
||
恢复后转绿。同步验证必须证明 Khronos layer 被 loader 插入,完整执行 14 项,
|
||
且零 VUID / SYNC-HAZARD / validation error。两项均已接入 CI,脚本为
|
||
`scripts/ci/magma_runahead_checks.py`。
|
||
|
||
RSP 测试采样也修正了真实的 fixture race:异步 EndFrame 返回不代表 Present
|
||
统计已发布,测试现在等该条已发出的 Present applied 后再读日志;生产未加等待。
|
||
|
||
最终行为头的结果如下,skip 不计 PASS,完整发现集与 JUnit 核对:
|
||
|
||
| 门 | 总数 | PASS | skip | failed |
|
||
|---|---:|---:|---:|---:|
|
||
| unit | 2312 | 2302 | 10 | 0 |
|
||
| integration-gpu | 1401 | 1119 | 282 | 0 |
|
||
| strict integration-split | 180 | 176 | 4 | 0 |
|
||
| 双块 split + magma | 245 | 239 | 6 | 0 |
|
||
| 其中 run-ahead 专项 | 14 | 14 | 0 | 0 |
|
||
| 其中 buffer 专项 | 19 | 19 | 0 | 0 |
|
||
| 其中两后端逐帧 RSP | 2 | 2 | 0 | 0 |
|
||
| Khronos synchronization validation | 14 | 14 | 0 | 0 |
|
||
|
||
- unit / GPU / 双块的 skip 名称与前一轮完整结果集精确相同;普通 GPU 发现的 14 个
|
||
run-ahead 副本只在专用车道运行,因此在那里按 fixture 声明 skip,专用 14 项均执行。
|
||
- strict marker 与双块 fatal 棘轮均空;初版负控与最终 run-ahead-off 负控均真实红转绿。
|
||
Tracker 碰撞回归临时撤掉 exact-pair dirty 分支后 rc=1,恢复后 rc=0;改动已还原。
|
||
- Vulkan layer 实际插入 14 次,零 VUID / SYNC-HAZARD / validation error。日志另外保留
|
||
28 条既有 MobileGL `GL_STENCIL_INDEX8` caps 枚举应用 ERROR;它们不是 layer 消息,
|
||
checker 按来源分列,含 Vulkan 标识的消息和 loader ERROR 仍硬失败。
|
||
- pull / push 构建通过;G1 `.text 10806051 → 10806051`,27815 defined symbols,
|
||
added/removed/resized/renamed **0/0/0/0**。G2 **3017 == 3017**。
|
||
G14 完整 JSON 名称集合 **3774 → 3803,+29 / -0**。
|
||
- G1 上述结论是仓库脚本的 section size / symbol name / symbol size 比较,
|
||
不声称不同构建的原始 `.text` 逐字节相等。额外只读反汇编核对发现原始差异全部
|
||
来自元数据:7255 条 RIP 引用因生成的 SPIRV-Cross version 字符串缩短7字节而
|
||
位移,解引用字符串相同;107 条 immediate 对应同一源码文本的 `__LINE__` 位移。
|
||
生成的版本字符串和时间戳也不同,未把这种构建可复现性差异记成运行逻辑变化。
|
||
- wire/field/dirty generators、field self-test 与四个 include closure probes 全过。
|
||
证据目录 `final-gates-194382c9/`、`negative-194382c9/`、`syncval-194382c9/`、
|
||
`tracker-red-once-194382c9/`,均在上述主机日志根目录下。
|
||
|
||
## FCL 实机验证
|
||
|
||
设备限定 Redmi `2f7cbe2e`,包名 `com.tungsten.fcl.mgdebug.debug`,
|
||
Minecraft `26.3-rc-3`,世界 `test`。复现脚本与准备/恢复步骤见
|
||
`tools/device_bench/magma_runahead/README.md`。
|
||
|
||
最终 APK `FCL-magma-runahead-194382c9.apk` 已覆盖安装,保留游戏数据:
|
||
|
||
- APK SHA256:`69973e2f51b87bd0128420da62b92fa2fb862a11067baf1b54a142f971d13357`
|
||
- `libMobileGL.so` SHA256:`046d86c288ce891b16770148578ba1a6fea4057783b69c2359f5830e58b7b223`
|
||
- APK 内与 `/data/app/.../lib/arm64/libMobileGL.so` 哈希一致,记录在
|
||
`final-artifact-identity.json`。三臂均使用此 APK,分别重启设备后运行。
|
||
|
||
| 臂 | 实际能力 | 世界连续运行 | 帧增量 / 近似 FPS | 图像 |
|
||
|---|---|---:|---:|---|
|
||
| Magma inproc RA=1 | ARMED | 64.472 s | 7680 / 119.122 | 地形、天空、手、hotbar 与方向正常 |
|
||
| Magma inproc RA=0 | 实际 Config run-ahead=0,无 ARMED | 60.589 s | 7320 / 120.813 | 同上 |
|
||
| GLES inproc RA=1 | ARMED | 60.865 s | 7080 / 116.323 | 同上 |
|
||
|
||
三臂数据与截图位于 `final-Magma-on/`、`final-Magma-off/`、`final-GLES-on/`。
|
||
Magma-on 有一次 `adb pidof` 查询超时(rc=124),随后仍为同一 PID `10141`,
|
||
帧与日志持续推进、无进程重启或 crash;不将它写成应用退出。
|
||
三臂共 193 个 stats windows 全部 `rsp=0`,strict=1、role-split-state=1,
|
||
六张世界截图均已检查;证据结论见各目录 `screenshot-review.json` 和汇总
|
||
`final-device-verdict.json`。三个不同 boot-id 分别为
|
||
`300c0044-058f-4c34-9e88-6e888d834877`、`bf9a1b6c-ce58-4ca6-bc71-8da52a856684`、
|
||
`f61e1c51-e354-4867-b708-72ca463e2119`。
|
||
|
||
原 `mg_env.txt`(空文件)和 `mg_transport.txt`(`inproc\n`)已恢复并逐一核对
|
||
SHA256,世界已保存退出;没有回滚世界内容。用户两份 Gradle 配置及父 FCL 的
|
||
原有未合并索引未改动。本轮未将库/APK 二进制提交到 Git。
|
||
|
||
所有主机原始日志保留在 `/home/swung/w7/magma-ra-logs/`;设备证据在
|
||
`C:/Users/geekerwan/.codex/tmp/magma-runahead/`。静态镜头、未锁频、天气和温度不受控,
|
||
帧计数只能作本次运行记录,不能把所有提升都归因于客户端 run-ahead;
|
||
本次还同时取消了 GPU 逐 draw 等待。具名 P7/P8 shape refusals 继续保留。
|
||
|
||
本次 RA=1 与 RA=0 的近似均值接近,不能据此宣称客户端 run-ahead 有特定 FPS 收益;
|
||
能确认的是所测世界已能在约 120 FPS 水平运行,真实排队与 credit 语义由主机专项证明。
|