mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-16 06:23:23 +09:00
[Docs] (P8): wave 1 integrated - rulings ID-P8-5..13 (the survey, packages A-F, the integration gate, the wave 2 scope and the monolith defects left to P13), the survey note, open questions 9/11/15 answered, the debts and the P8 contract amendments, the P8 README table, PLAN-P8 wave 2 and the status page
This commit is contained in:
@@ -8,3 +8,12 @@
|
||||
| ID-P8-2 | 2026-09-29 | 门改写:覆盖门 = 归一化后 split ⊆ monolith ∪ 豁免表;create-indirect 往返门 = 多帧设备 trace 加载帧非 `ResourceCreate` 等待 = 0。 | 原两门按字面不可达 / 是空的(trace 只 1 帧)。 | A 包、P8-0 |
|
||||
| ID-P8-3 | 2026-09-29 | G1 不变;各包 split 半边放在 `MOBILEGL_BUILD_DISAGGREGATED` 下。monolith 半边(例如 B2 的 CPU 滤波读陈旧影子)若 red-once 证实,在 dev 上单独修再合并(用户同意)。 | 沿用 P9 / P11 做法。 | B、C、E |
|
||||
| ID-P8-4 | 2026-09-29 | 第一波七包并行(P8-0、A、B、C、D、E、F,树 `~/w7/p8-<包>`,分支 `p8/<包>`,集成树 `~/w7/p9-main` 分支 `p8/main`);G 等 P8-0 的测量;C、D 为 P13 前置。设备只由 P8-0 使用(红米,约半天,用户同意)。 | 各包改动区域不重叠(`DirectGLES.cpp` 按行段分开)。 | 全部 |
|
||||
| ID-P8-5 | 2026-09-30 | **P8-0 普查**(主机 80 + 78 次重放、红米 trace 语料 77 × 两臂、FCL 原版 26.3 实机;插桩不提交):真实内容里只有 D 命中——原版 MC 26.3 × Magma × inproc 把 44,768 次 indirect 调用 / 13,028,030 个 draw(约 870 / 帧)在 CPU 展开;B1 / B2 / C / E 的前提在真实内容 0 命中,靠构造的 red-once 成立。**G 不做**:最大 program archive 354,846 B = arena/4 的 4.2 %,最大 `draw_vbo` 记录 1,936 B。create-indirect 门(ID-P8-2)在多帧 trace 上成立:rd12(250 帧)与 improved-transparency-26.3(1210 帧)加载帧非 `ResourceCreate` 等待 = 0。设备语料 spawn 70/77、monolith 68/77 达 0.99,差的都在基线(未插桩对照)上复现。 | FCL 上只有原版 26.3(无 Iris / Complementary / Create,未下载),B2 实机对照做不了,改用两条 Complementary trace(生成 mip 只见 R11F 与 RGBA8)。 | [`S.md`](S.md);树外 `~/w7/notes/p8/s-report.md` |
|
||||
| ID-P8-6 | 2026-09-30 | **F 落地**(`2b4ae539`):我们的 client 发不出的形状改判 `ProtocolCorruption`——multi-draw `CLIENT_INDICES` / `INSTANCED` 闩、Magma `client-vertex-array`;Magma 生成 mip 着色器形状在 wire 臂由 Fatal 改具名拒绝 `MipmapShaderFormatOrShape`(与 monolith 一致,判定在长链之前);`kCapViewportArray` / `kCapNeedsHost{Index,Ubo}Bytes` 与索引镜像哨兵标保留位、不改号。 | 只有外来 peer 能到;mip 形状是后端覆盖缺口不是坏记录。`@P` 标签本不计入 census(BRIEF-F 前提不成立)。 | [`F.md`](F.md) |
|
||||
| ID-P8-7 | 2026-09-30 | **A 落地**(`8133cd52` + `24b8aef6`):246 个只在 monolith 登记的用例登上 split / spawn / tcp(`P8Coverage.cmake`);五条 server 读的旋钮车道各起一个 tcp supervisor;撤 `ClientSideIndices` / `GuiBatch` 排除;`split_coverage.py` + 豁免表(mechanism / single-backend / no-records / pending-fix)进 CI 与 `gate.sh`,断言归一化后 monolith ⊆ split ∪ 豁免(ID-P8-2)。按名普查 304 例:235 三臂全过、55 同因跳过、13 no-records、1 真红(Espryt spawn / tcp 默认帧缓冲深度读 0,pending-fix,第二波)。 | 旋钮只放 client 环境时 tcp 副本静默跑默认臂(旧 `ForcedDs` tcp 条目同病,已修)。**规则**:server 读的旋钮车道要么独立 tcp supervisor,要么只上 split + spawn,要么证明对其他用例惰性(E 的 13×7 extent 限域)。 | [`A.md`](A.md) |
|
||||
| ID-P8-8 | 2026-09-30 | **B 落地**(`2f530ad8`):Espryt server 按记录的生成窗口 [BASE+1, min(MAX+1, 存储层数, 链长)) 生成 mip(B1,与 Magma 同口径);RGB16F / RGB32F 先试驱动原生,驱动拒绝时 server 从驱动读回基级做 2×2 box(不读 client 影子;读回被拒且暂存覆盖整级才用暂存);split 名 `generate-mipmap-storage` / `generate-mipmap-cpu-filter` 退役。 | 基线 B1 六例 × 三臂、B2 四例 Fatal;只修检查不修链时 BASE=1 会被 level 0 覆盖。强制 CPU 臂旋钮 `MGITEST_ESPRYT_FORCE_CPU_MIPMAP` 只上 split + spawn(合 ID-P8-7 规则)。 | [`B.md`](B.md) |
|
||||
| ID-P8-9 | 2026-09-30 | **C 落地**(`94410715`):split server 给 shader 写过的 buffer 孪生体打标(SSBO / 原子计数、可写 buffer image、XFB),restart 重写、multi-draw rebase、`*IndirectCount`、CPU 取用的 indirect 字段、XFB scatter、fp64 收窄一律经 `SplitHostBytesForCpuRead` 懒刷新后读;T0 臂先落排队常驻写再 `glFinish`(P11-B2 那条债的 split 半,主机无 T0、未能证红)。 | 前提成立:基线 Espryt split / spawn / tcp 21/21 红。monolith 13 条缺陷用例运行时按名跳过(`SkipBrokenMonolith`,原因写在代码里),第二波 dev 修复落地后解除。 | [`C.md`](C.md) |
|
||||
| ID-P8-10 | 2026-09-30 | **D 落地**(`92eab9f3`):Magma wire 臂把 `glDraw*Indirect` / `glMultiDraw*Indirect[Count]` 直接录成 `vkCmdDraw*Indirect[Count]`;CPU 展开只留给设备发不出的 COUNT 形态(与 monolith 同条件);shader 写过的 store 在首个 indirect 读前录一次屏障;范围 / 对齐 / 缺 store 四条具名拒绝。 | create-indirect split 上 321/322 次 indirect 读每次一整 GPU 等待(每次回放约 8 s)→ 0。去屏障的像素用例在 lavapipe 上不红(顺序执行),如实记录。 | [`D.md`](D.md) |
|
||||
| ID-P8-11 | 2026-09-30 | **E 落地**(`39cd8fb7`):审计前提不成立——split 的 `glGetTexImage` 只读 GPU、不碰影子;真实缺口是驱动拒绝 attach(Adreno RGB16 / 16 位 SNORM)时会话以 `Fatal{ReplyError,"ReadPixels"}` 结束。改为由 server 暂存 store 作答(整级、extent 相符、未被驱动写过),store 跟随同格式 `glCopyImageSubData`(FollowCopy),跟不了的打粘性 driver-written 标;否则具名拒绝。死闩 `CopyImageSubData+RENDERBUFFER` 删除,census 79 → 78。 | red-once 11 条。E 的 monolith 半(拷贝后读拷贝前的 CPU 影子)归第二波 dev。 | [`E.md`](E.md) |
|
||||
| ID-P8-12 | 2026-09-30 | **第一波集成头 `39cd8fb7` 整套门**:G1 符号增 0 减 0、`.text` `0xa5ba13`(pull 不变);fatal census 78;link ratchet 172;parity 0;修订 5;wire-declines 58 / 59 站点;卫生 12/12 + `split_coverage`(两后端 monolith 701,Espryt 门控 612 + 豁免 89,missing 0);unit 2721;split / spawn / tcp 735 / 649 / 661;Magma 271 / 248 / 216 / 668;gpu monolith / inproc 3684 / 3684;verify 5471;retrace 230/236(已知 6 例 iterationrp)。集成者裁定:契约旧措辞加 P8 修订注(`CONTRACT-P5B.md`、`CONTRACT-P5E.md`、`CONTRACT-P7.md`);monolith 缺陷共 14 条,全部进第二波 dev 包(ID-P8-3);开放问题 9、11 关闭,15 答「是缺口」。 | 串行集成六次,每次整套门;两处追加冲突(`CMakeLists.txt`、`WireDeclines.def`)都两块保留,一次合并修复(A 的豁免行)。 | 树外 `~/w7/notes/p8/int-*.md` |
|
||||
| ID-P8-13 | 2026-09-30 | **第二波**:split 两包(SE Espryt + 文档、SV Magma)串行合入 `p8/main`;dev 一包(MD)只修 create-* 在 Adreno 上的三条真实负载缺陷,其余 11 条 monolith 缺陷留给 P13(`DEBTS.md`)。 | ID-P8-3 原意是「B2 的 monolith 半边上 dev」,第一波报出 14 条,全在 monolith 专属臂里、P13 换臂即消失;按 P8-0 真实内容命中收窄,只修 Create 在 Adreno 上会碰到的三条(dev 是现行产品)。这是对 ID-P8-3 的收窄,已告知用户。 | `PLAN-P8.md` 第二波 |
|
||||
|
||||
@@ -42,3 +42,27 @@
|
||||
- **trace split 双后端 SSIM ≥ 0.99**(含两个 `coherent_as_flush` fixture),出口再跑。
|
||||
- **P13 前置**:C、D 先于 P13 落地,否则删掉 monolith 臂后继承 split 臂的缺陷。
|
||||
- **G1**:pull 构建不变;split 半边在 `MOBILEGL_BUILD_DISAGGREGATED` 下。monolith 半边若 red-once 证实有缺陷,在 dev 上单独修再合并(ID-P8-3)。
|
||||
|
||||
## 第二波(2026-09-30,ID-P8-13)
|
||||
|
||||
| 包 | 树 / 分支 | 内容 |
|
||||
|---|---|---|
|
||||
| SE(split,Espryt + 文档) | `~/w7/p8-se` / `p8/se` | 默认帧缓冲深度在 Espryt spawn / tcp 读 0(A 的 pending-fix 豁免);B2 的 CPU mip 回退看 E 的 driver-written 标;D 的 case 3 在 Espryt split 臂放开(C 已落地);`PipeCatalogueTest` 名单去死名 `copy-image-shadow-mirror` 并加"名单 = 调用点"的门;B / C / D / E 包说明的行号漂移 |
|
||||
| SV(split,Magma) | `~/w7/p8-sv` / `p8/sv` | 3D 纹理原生 mip blit 把 depth 当 `layerCount`(VUID-vkCmdBlitImage-srcImage-00240);深度模板 mip 拒绝补 `WireDeclineTally` 行;`GenerateWireDepthMipLevel` 拒 1D;wire 臂 `DispatchComputeIndirect` 原生化 |
|
||||
| MD(dev,设备) | `~/w7/dev-p8-md` / `devfix/p8-md` | create-* 在 Adreno 830 上的三条:Espryt create-instancing monolith SSIM 0.870;Espryt 每次 indirect draw 整 buffer 同步回读(设备上挂死 > 10 分钟);Magma 计算写与 indirect 读之间无依赖(可能就是 ID-P7-4)。先在 dev 构建上复现,复现才在 dev 上修;只在 feat 构建上出现的交回集成者 |
|
||||
|
||||
### monolith 缺陷(ID-P8-3)的取舍
|
||||
|
||||
所有 14 条都在 monolith 专属臂里;P13 把 monolith 换到第一波已修好的记录臂上,它们随之消失。按 P8-0 的真实内容命中取舍:
|
||||
|
||||
| 缺陷 | 来源 | 真实内容命中 | 做法 |
|
||||
|---|---|---|---|
|
||||
| Espryt create-instancing monolith 画面错(0.870) | S | Create(Adreno) | **MD 修(dev)** |
|
||||
| Espryt indirect draw 整 buffer 同步回读、设备挂死 | S | Create(Adreno) | **MD 修(dev)** |
|
||||
| Magma 计算写 → indirect 读无依赖 | D | Create(推断,ID-P7-4) | **MD 修(dev)** |
|
||||
| Espryt `*IndirectCount` / 原生 indirect `gl_BaseVertex` / fp64 收窄读未同步影子 | C | 0 | 留给 P13 |
|
||||
| Magma `glMultiDrawArraysIndirectCount` CPU 臂读未同步影子 | C、D | 0 | 留给 P13 |
|
||||
| Magma 录制中途 `SyncGpuWrites` → SIGSEGV | C | 0 | 留给 P13 |
|
||||
| Espryt RGB16F / RGB32F CPU 滤波读陈旧影子;R11F / 深度链无视 BASE / MAX | B | 0 | 留给 P13 |
|
||||
| Magma 无 BLIT 颜色格式缺着色器 mip 臂 | B | 0 | 留给 P13 |
|
||||
| Espryt 拷贝后 `glGetTexImage` 读拷贝前影子 | E | 0 | 留给 P13 |
|
||||
|
||||
@@ -4,16 +4,18 @@
|
||||
|
||||
## 重定界后的包
|
||||
|
||||
| 包 | 内容 |
|
||||
|---|---|
|
||||
| P8-0 | 普查:设备与主机 trace 语料上各拒绝点 / 仿真谓词的命中数;split 日志与逐 op 等待 |
|
||||
| A | 覆盖对齐:monolith 用例登记到 split / spawn / tcp,豁免表 + 归一化名单门 |
|
||||
| B | Espryt 生成 mip:存储检查读计划窗口(B1);RGB16F / RGB32F 在 server 完成(B2) |
|
||||
| C | Espryt server 暂存影子与 GPU 写对账 |
|
||||
| D | Magma wire 臂原生 indirect(不再 CPU 展开 + 等 GPU 空闲) |
|
||||
| E | CopyImage 在 server store 上处理 |
|
||||
| F | 死闩清理与重分类(无行为变化) |
|
||||
| G | 大 blob 分片:按 P8-0 的测量决定做不做 |
|
||||
| 包 | 内容 | 结果 |
|
||||
|---|---|---|
|
||||
| P8-0 | 普查:设备与主机的 trace 语料上各拒绝点 / 仿真谓词的命中数 | ✅ 真实内容只 D 命中;G 不做;create-indirect 门在多帧 trace 上成立([`S.md`](S.md),ID-P8-5) |
|
||||
| A | 覆盖对齐 | ✅ 246 例登上三臂,`split_coverage.py` 进门([`A.md`](A.md),ID-P8-7) |
|
||||
| B | Espryt 生成 mip | ✅ 生成窗口 + RGB16F / RGB32F 在 server 完成,两个 split 名退役([`B.md`](B.md),ID-P8-8) |
|
||||
| C | Espryt server 暂存影子与 GPU 写 | ✅ 基线 21/21 红 → 绿([`C.md`](C.md),ID-P8-9) |
|
||||
| D | Magma wire 臂原生 indirect | ✅ create-indirect 每次整 GPU 等待 321 → 0([`D.md`](D.md),ID-P8-10) |
|
||||
| E | CopyImage / 驱动拒读 | ✅ 前提改正:真实缺口是驱动拒读时会话 Fatal,改由 server store 作答([`E.md`](E.md),ID-P8-11) |
|
||||
| F | 死闩清理与重分类 | ✅([`F.md`](F.md),ID-P8-6) |
|
||||
| G | 大 blob 分片 | 不做(ID-P8-5) |
|
||||
|
||||
第一波集成头 `39cd8fb7` 整套门全绿(ID-P8-12)。第二波见 [`PLAN-P8.md`](PLAN-P8.md)。
|
||||
|
||||
## 摘要(原文,已划掉)
|
||||
|
||||
|
||||
@@ -0,0 +1,47 @@
|
||||
# P8-0 普查(S 包)
|
||||
|
||||
> 插桩不提交(树外 `~/w7/notes/p8/s/instrument.diff`);全文 `~/w7/notes/p8/s-report.md`。裁定 ID-P8-5。设备计数是下限(Android 不跑退出 dump,按 10 / 600 帧周期 dump)。
|
||||
|
||||
## 覆盖
|
||||
|
||||
| 语料 | 臂 | 数 |
|
||||
|---|---|---|
|
||||
| 主机 trace | monolith / inproc,两后端 | 80 / 78 次重放 |
|
||||
| 红米 trace APK(插桩) | monolith / spawn `--matrix` | 77 / 77,达 0.99:68 / 70 |
|
||||
| 红米未插桩对照 | create-indirect、create-instancing | 7 次,区分设备缺陷与插桩 |
|
||||
| FCL 实机 | 原版 26.3-rc-3,两后端 | 约 15,000 帧;无 Iris / Complementary / Create(未下载) |
|
||||
|
||||
## 命中(真实内容)
|
||||
|
||||
| 谓词 | 主机 | 设备 trace | FCL | 结论 |
|
||||
|---|---|---|---|---|
|
||||
| Magma wire indirect CPU 展开(D) | create-indirect 322 次调用 | create-indirect 321 次 | Magma inproc 44,768 次调用 / 13,028,030 draw | **唯一真实命中** |
|
||||
| B1 split 存储检查会失败 | 0 / 1375 次生成(R11F 1357、D16 18) | 0 / 391 | 0 | 路径热、失败形状 0 |
|
||||
| B2 RGB16F / RGB32F 生成 mip | 0 | 0 | 0 | 未见(两条 Complementary trace 只有 R11F 与 RGBA8) |
|
||||
| C GPU 写过的字节被 CPU 读 | 0(只有指针解析 322/322) | 0 | 0 | 未见 |
|
||||
| E 拷贝后经影子 `glGetTexImage` | 0(1,288 次拷进 DEPTH / R32F,无一回读) | 0 | 0 | 未见 |
|
||||
| Magma 生成 mip 着色器形状 | 0 | 0 | 0 | 未见 |
|
||||
|
||||
## G(大 blob)
|
||||
|
||||
| 量 | 最大值 | arena / 4 | 比例 |
|
||||
|---|---|---|---|
|
||||
| program archive | 354,846 B(complementary-unbound) | 8 MiB(SEG_STAGE 32 MiB) | 4.2 % |
|
||||
| `draw_vbo` 记录 | 1,936 B(156 段) | 2 MiB(SEG_CMD / 4) | 0.1 % |
|
||||
|
||||
结论:不做分片。
|
||||
|
||||
## create-indirect 门(ID-P8-2)
|
||||
|
||||
| trace | 帧 | 加载帧非 `ResourceCreate` 等待 |
|
||||
|---|---|---|
|
||||
| rd12 odinlite(设备 spawn,两后端) | 250 | 0 |
|
||||
| improved-transparency-26.3(设备 spawn,两后端) | 1210 | 0 |
|
||||
| create-indirect(1 帧) | 1 | 8(设备)/ 10(主机):`ResourceReadback` 6 + `MapPersistent` |
|
||||
| FCL 原版 26.3(实机 inproc) | ~15,250 | 16(`MapPersistent`) |
|
||||
|
||||
## 设备上基线就有的问题(两臂都有,不归 P8)
|
||||
|
||||
- create-indirect 在 Adreno 830 上 kgsl `Preemption Fault`(两后端两臂;ID-P7-4)。
|
||||
- 1.21.11-main-menu(Espryt 0.890、Magma 0.165)、derivative-main(Espryt 0.851)SSIM < 0.99。
|
||||
- create-instancing × Espryt × monolith 0.870(spawn 0.99998)——monolith 缺陷,进第二波 dev。
|
||||
Reference in New Issue
Block a user