swung0x48/MobileGL
1
0
Fork 0
mirror of https://github.com/MobileGL-Dev/MobileGL synced 2026-11-07 01:53:24 +09:00
Code Issues Packages Projects Releases Wiki Activity
Files
f9c5e0adbcbb6f61baae427a716c774e09a0c169
MobileGL/docs/Disaggregated/notes/p2/README.md
T
swung0x48 43b5cfa94e [Docs] (Disaggregated): the four index documents keep only summaries, and every phase's detail lives in its own notes/<phase>/README.md 
- ROADMAP, MEASUREMENTS and ARCHITECTURE are rewritten as summaries (333 KB of index text -> 84 KB).
  ROADMAP's phase table is one line per phase plus a link; MEASUREMENTS keeps headline numbers under
  its old §1-§13 numbering (plus §14-§16 for P6.5, P7 and P12); ARCHITECTURE keeps every decided rule
  under the same §1-§17 / appendix numbering, so the `ARCHITECTURE.md §N` references in code still
  land, and §17 becomes an index of the phase landing shapes.
- CURRENT_STAGE_PROGRESS now describes the current stage (the P12 on-screen-server subset) and absorbs
  CURRENT_STAGE_STATUS, which is removed. The P7 status tables, the P6 closing snapshot and the P6.5
  first-wave snapshot move to notes/p7, notes/p6 and notes/p65.
- Each phase gets notes/<phase>/README.md: a short summary, then the verbatim material that left
  the index documents (its ROADMAP row, its MEASUREMENTS section with subsection numbers kept, its
  ARCHITECTURE §17 part, milestones) and a file index. P8-P11 and P13 get their planned scope;
  the full open-question list moves to notes/OPEN-QUESTIONS.md.
- The phase reports that sat at the top level move into their phase folders with unchanged names:
  P5D-INPROC-PERFORMANCE, P5E-RUNAHEAD, P5F-WIRE-COMPLETENESS, P6-SPAWN-PLAN, P6-CONTRACT-DRAFT,
  P6-ENDSTATE-REVIEW. Their relative links, CONTRACT-P6.md's links to them and one tool docstring
  are updated; notes/README.md maps every old path and section number to its new place.
- 71 files under notes/recovered/ that were byte-identical copies of phase-folder files are removed.
- Corrections made while condensing: the server process reads Transport as Spawn (CONTRACT-P6 §3.1
  amended the old "child forces monolith" rule); both backends now publish kCapRunAheadApply;
  MOBILEGL_IPC_RESPAWN is a named refusal and MOBILEGL_IPC_IDLE_EXIT_S is not parsed; the Redmi
  pin row is in tools/device_bench/pin_device.sh.

check_doc_citations over docs/Disaggregated/*.md: 0 problems. No relative link is newly broken.
2026-09-24 22:21:09 +00:00

8.4 KiB
Raw Blame History

P2 — 渲染状态 CSO + 第一片 Track H + 残余值块（738b289d）

本页是该阶段的阶段汇总：阶段表行、实测与落地形状的完整文本（2026-09-24 从上层索引移入，原文照录）都在这里；上层只留摘要——ROADMAP.md、MEASUREMENTS.md、ARCHITECTURE.md。文中 file:line 与"今天""当前"按各段写成时的头理解；文中的 MEASUREMENTS.md §N / ARCHITECTURE.md §17.x 编号保留，对照表见 ../README.md。

摘要

  • 落地：前端 Tracker（dirty 位、5 个聚合世代、集合 hash 抑制器）；MGPipeRenderStateSpans chunk 表（7 pipeline chunk 396 B + 8 dynamic chunk 772 B）+ G7；CsoCache（64）；create/bind_render_state + set_dynamic_state（SyncRenderState 一行不动）；ResidualValueBlock 棘轮 1248 → 8；Espryt slot 表 + Magma vertex input 重键（11 条 memo 删除 + 2 条重键）；三个 capability 补真存储。
  • 门：G1 4 处认定 resize、.text +160 B；单元 1566×3；integration-gpu 916 三臂；retrace 79/79 push + verify。
  • GO/NO-GO（2026-09-08）：继续。 Release 下边界代价 +6–12%（两机两后端一致），用户接受，自此性能只记录、不设门。

阶段表行（原 ROADMAP.md）

  • 阶段：P2 渲染状态 CSO + 第一片 Track H + 残余值块
  • 状态：✅ 738b289d
  • 落地什么 / 范围：Tracker（dirty 位、5 个聚合世代、抑制器）；dirty-surface 成门；MGPipeRenderStateSpans chunk 表 + G7；CsoCache（64）；create/bind_render_state + set_dynamic_state（SyncRenderState 一行不动）；pixel pack / patch / attrib defaults；ResidualValueBlock 棘轮 1248 → 8；Espryt slot 表 + Magma vertex input 重键（11 条 memo 删除 + 2 条重键）；MOBILEGL_PIPE_LEGACY_MEMOS；三个 capability 真存储
  • 验收门 / 证据：G1 4 处认定 resize、.text +160 B；G2 名差 0；单元 1566×3；integration-gpu 916 三臂；retrace 79/79 push + verify；对照 44/44。GO/NO-GO（2026-09-08）：继续。§3

实测：P2（738b289d）（原 MEASUREMENTS.md §3）

3.1 门

门 结果
G1 pull 构建符号 0 增 / 0 删 / 0 重命名；4 处认定 resize（RenderState::{RenderState, SetCapability, IsCapabilityEnabled}、_GLOBAL__sub_I_DirectGLES.cpp）；.text +160 B
G5 SyncRenderState RenderStateImpl 段 sha 逐字节相同
G2 / G14 名差 0；0 删除 / +119
单元 1566 × {pull, push, verify}
integration-gpu 916/916 × {pull, push, MOBILEGL_PIPE_PUSH=0}；渲染状态敏感子集 72/72
integration-verify 828 零 Fatal{
79 例 retrace push 79/79；verify 79/79 armed 零分歧
G7 setter 一致性阴性对照 变红并点名 SetColorMask
CsoContentAddressing / verify 三组对照 6/6 / 44/44（PoisonOmitted、VerifyCorrupted、HandleRecycle）

3.2 设备配对 A/B（-O0 勘误）

两机 64 次运行（小米 + Oppo，四 trace × 两后端 × finish 开/关，reboot-clean、钉频、best-of-3、尾 200 帧）所用的两臂 APK 是未优化构建（libMobileGL.so 43.2 MB / .text 21.8 MB，对 Release 15.5 / 9.4 MB），绝对值与差值都是 -O0 读数，不作基准线；Release 基准线以 §4.4 为准。-O0 读数：小米 p50 +8–14%（四 trace 两后端），Oppo Espryt +16–18% / Magma +10–11%，p99 同向；finish 开关两臂几乎一致（多出的是客户端 CPU）；计数器两机逐字相同。原始 32 行表在 git 历史（ea34bccb 版本的本文件 §10）。harness 误杀记录：trace-replay-ci.sh 对 pidof 单次采样失败即 force-stop，dev 侧跟进。

3.3 DriverBench：T1 / T2（桌面 llvmpipe / lavapipe，wsl_p2_bench.sh，Release，240 帧 × 5 次取中位数，ns_per_op）

臂 mc_vanilla_draw（ns/draw） mc_state_toggle（ns/开关对） mc_pass_switch（ns/pass）
native 4771 22968 437759
Espryt pull / push / push PIPE_PUSH=0 / push 位 63 5121 / 5443 / 5671 / 5374 23753 / 24869 / 24584 / 24630 443300 / 446017 / 443807 / 435454
Magma pull / push / push PIPE_PUSH=0 / push 位 63 16900 / 17245 / 17599 / 17444 32705 / 33857 / 34082 / 34780 438406 / 446067 / 445006 / 444758
mc_vanilla_draw，ns/draw Espryt Magma
T1 = push − pull（整个边界） +322（+6.3%） +345（+2.0%）
T2 = push(PIPE_PUSH=0) − pull（P1 残余填充） +550 +699
T1 − T2（P2 自己加的减的） −228 −354
位 63 − push（CSO 内容寻址净值） −69（≈ 0） +200（内容寻址每 draw 省 200）
blend-toggle / pass switch +4.7% / +0.6% +3.5% / +1.7%

读法：P2 的 tracker + CSO 比它替掉的 P1 残余填充便宜；剩下的 T1 是尚未句柄化的填充与 dirty 走查。mc_state_toggle 由 DriverBenchStateToggle 钉住每帧 46 对开关；位 63 对照的开关 CsoContentAddressingScenario 常开（内容寻址臂 csom ≤ 4 且 csom < csob，位 63 臂 csom == csob）。

3.4 计数器读数

resid= 已非零且棘轮压到底（1248 → 8）：桌面 push retrace iris-bsl，resid=197.07 B/帧 = 每 draw 0.64 块；csom/csob = 8 / 1415（CSO 复用比）。小米 push 臂（-O0，计数器与优化无关）：

trace Espryt ers / etl / eub Magma mfp / mpm / mdt resid= B/帧 csom / csob（每 120 帧）
minecraft-1.21.4-in-world 6020/1850 · 6884/986 · 6962/908 0/7278 · 6030/1248 · 5928/1350 178.31 2 / 1719
improved-transparency-minecraft-26.3 78960/1367 · 75378/4949 · 75199/5128 10740/68928 · 67660/1268 · 78800/868 185.36 0 / 1157
minecraft-1.21.4-fabric-iris-bsl-in-world 113/133 · 85/161 · 82/164 0/177 · 86/91 · 81/96 370.67 1 / 122
minecraft-1.21.4-startup 174/185 · 305/54 · 305/54 0/118 · 0/118 · 0/118 25.08 9 / 181

CSO 内容寻址在稳态窗口里几乎不再铸造；memo 门形状与 §1.3 的拉取基线一致。未测：逐 dirty 位触发率（FireCount/WalkCount 已实现但不在汇总行）、每 draw payload 直方图（只在 teardown JSON 里）。

3.5 遗留判定

  • MOBILEGL_ESPRYT_DISABLE_INVALIDATE_FLUSH=1 的 186 条过滤不进比对器（P3a 在 push 下跑了一次 958/958；进比对器推迟到 P3b）。
  • Track H 单位成本的日历口径未记录（产出侧在案：11 条 memo 删除 + 2 条重键零回归）。
  • 句柄 ABA 对照"重键前红"：修复前 HandleRecycle 28 条中 1 条红（AbaControl 期望死对象的红却看到替换对象的绿）；修后 32/32，且关掉 MOBILEGL_PIPE_HANDLE_ABA_CONTROL 两臂都 observed=FRESH 并失败——污染只由被打掉的身份产生。

里程碑记录（原 ROADMAP.md）

  • P2 出口（2026-09-08）：GO/NO-GO 判定继续——五部分门全绿，逐线程 CPU 代价约 +10% 被接受；tracker 绝对 ns 上限降为记录项。

本目录

文件 内容
BRIEF-P2.md P2 implementation brief — the frontend state tracker, render state as a CSO + dynamic state, the residual value block, and the first Track H slice
INTEGRATOR-DECISIONS.md P2 integrator decisions (feat/disaggregated, 2026-09-07)
scout-docs-spec.md P2 specification, extracted from docs/Disaggregated/ (read-only scout)
scout-measure-infra.md P2 measurement & gating: what exists, what is missing, what it costs
scout-render-state.md Scout: render state → CSO + dynamic state (P2 groundwork)
scout-track-h.md Track H, slice 1 — scout report
scout-tracker.md Scout: what the P2 frontend state tracker must do, and what already exists
ab/ 4 个文件：小米 / Oppo 配对 A/B 汇总（-O0 勘误见上文 §3.2）
bench/ 1 个文件：DriverBench T1/T2
devices/ 1 个文件：两台设备的定频报告
p2-results/ 42 个文件：各包（tracker / spans / espryt / magma / gates）的实现与评审稿

捞回的独有材料：../recovered/wf5/（BRIEF-P2 的完整版 / 重放版与分部）。

Reference in New Issue View Git Blame Copy Permalink