mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-19 16:01:57 +09:00
[Docs] (.claude/skills, .github/workflows, CMakeLists.txt, docs/archive, docs/Disaggregated, docs/MobileVA, docs/Performance, MG_Backend, MG_Backend/DirectGLES, MG_Backend/DirectVulkan, MG_Backend/Record, MG_Gbm, MG_Impl, MG_Impl/EGLImpl, MG_Impl/GLImpl, MG_Impl/GLXImpl, MG_Impl/Pipe, MG_IntegrationTest, MG_IntegrationTest/Harness, MG_IntegrationTest/Scenarios, MG_Pipe, MG_Pipe/generated, MG_Remote, MG_Remote/Client, MG_Remote/Server, MG_Remote/Transport, MG_Remote/Wire, MG_State/GLState, MG_Test/Pipe, MG_Test/Util, MG_Test/Wire, MobileGL, scripts, scripts/data, tools/device_bench, userguide): archive the planning notes and agent contracts under docs/archive
- DEBTS.md and OPEN-QUESTIONS.md stay maintained, now in docs/Disaggregated.
This commit is contained in:
@@ -0,0 +1,37 @@
|
||||
# P10 A:fence 轮询本地作答——配对测量与 Espryt 发现
|
||||
|
||||
2026-09-29,`p10/main@8d0a1b6c`,主机 WSL Arch(Espryt = mesa llvmpipe ES 3.2;Magma = lavapipe)。协议与门见 [`CONTRACT-P10.md`](../../contracts/CONTRACT-P10.md) §1。只记录、不设门。
|
||||
|
||||
## 负载
|
||||
|
||||
`FencePollScenario.PacedFrameFenceWaitsBench`(`MGITEST_FENCE_PACE_BENCH=1`):每帧 clear + `glFenceSync` + 交换,再对 N 帧前(`MGITEST_FENCE_PACE_LAG`,默认 2)的 fence 做 `glClientWaitSync(FLUSH, 1 s)`;600 帧。也就是 Minecraft 的形状,这里单独拿出来测(回放语料里只有 `improved-transparency-minecraft-26.3` 带 timed wait,见 [`C-MEASUREMENTS.md`](C-MEASUREMENTS.md) §3)。A/B = `MOBILEGL_IPC_POLL_ESCALATE=0`(每次都往返,P10 之前的行为)对默认 64。
|
||||
|
||||
## 结果(3 轮,ms/帧 与 600 帧里的 fence 往返次数)
|
||||
|
||||
| 后端 · 传输 | esc=0 ms/帧 | esc=64 ms/帧 | esc=64 往返 / 本地作答 |
|
||||
|---|---|---|---|
|
||||
| Magma · inproc | 0.201 / 0.206 / 0.217 | 0.200 / 0.206 / 0.214 | 0 / 598(回复槽记录 601 → 3) |
|
||||
| Magma · tcp | 1.017 / 1.007 / 1.004 | **0.631 / 0.651 / 0.606**(−37%) | 0 / 598 |
|
||||
| Espryt · inproc | 0.816 / 0.672 / 0.816 | 0.808 / 0.843 / 0.848 | 595–598 / 0–3 |
|
||||
| Espryt · tcp | 0.891 / 0.939 / 0.908 | 0.796 / 0.891 / 0.800 | 497–519 / 79–101 |
|
||||
|
||||
表中是 `625f4db4` 的配置。证据:`~/w7/notes/p10/evidence/bench-after-present-report.log`;改动前的一组在 `bench-before-present-report.log`,数字相近。
|
||||
|
||||
## present 时报告(`625f4db4`)
|
||||
|
||||
server 在 `OnPresent` 里、归还 credit **之前**查一次未报告的 fence(状态查询,不提交)。原因:credit 放行的 client 立刻去等一两帧前的 fence,批次结束后才发的报告会输掉这场竞争。实测只有 Espryt·tcp 有变化,本地作答从 36–54 升到 79–101;Magma 在改动前就已经是 0 往返。
|
||||
|
||||
## Espryt 发现:llvmpipe 上 fence 只有被阻塞等待过才可见
|
||||
|
||||
Espryt 的 timed wait 几乎全部过线,这**不是**报告晚到:
|
||||
|
||||
| 探针 | 结果 |
|
||||
|---|---|
|
||||
| lag 1 / 2 / 3 / 4 / 6(`benchlag-present-status.log`) | inproc 本地作答都在 0–6,与 lag 无关——六帧前的 fence 也看不到 |
|
||||
| server 端追踪(临时 `P10DBG`) | 队首 fence 在约 4 帧里的每次检查(含 flush 检查)都是 pending;client 的 timed wait 过线、server 执行 `ClientWaitSync(…, 1 s)` 之后,下一批才报告它。Magma 同一追踪里报告全部早于等待 |
|
||||
| flush 检查改成冲刷最新的 fence | 不变(0–24) |
|
||||
| flush 检查改用 1 ns 的 timed wait | 不变(本地 17 / 596) |
|
||||
|
||||
结论:在这台主机的 mesa llvmpipe(ES 3.2)上,`glGetSynciv(GL_SYNC_STATUS)` 与零超时 `glClientWaitSync` 看不到早已完成的 fence,只有真正阻塞的等待才能让它变成 signaled。这是宿主驱动的行为,与传输无关。A 在这里只是**没有收益**,并没有错:过线的等待语义不变,esc=64 与 esc=0 持平。探针都已撤掉,`ReportSignaledFences` 保持门禁通过时的原样。
|
||||
|
||||
**真机上的答案(C,[`C-MEASUREMENTS.md`](C-MEASUREMENTS.md) §1)**:在红米(Adreno 830)上同一个 bench,Espryt esc=64 时 0 次往返、598 / 598 次本地作答,与 Magma 相同。上面的现象只出现在 llvmpipe 上。
|
||||
@@ -0,0 +1,46 @@
|
||||
# P10 C:真机测量与往返普查
|
||||
|
||||
2026-09-29。真机:Redmi `2f7cbe2e`(Adreno 830),代码 `8d0a1b6c`;CPU 定频 1555200 / 1958400 并回读核验,GPU 未定频。只记录、不设门。原始数据在 `~/w7/notes/p10/evidence/c/`(报告 `~/w7/notes/p10/c-report.md`)。
|
||||
|
||||
## 1. fence bench 在 Adreno 830 上(Split / inproc,600 帧,3 轮交错)
|
||||
|
||||
`FencePollScenario.PacedFrameFenceWaitsBench`,每帧对 2 帧前的 fence 做 timed wait。
|
||||
|
||||
| 后端 | esc=0 ms/帧 | esc=64 ms/帧 | esc=64 fence 往返 / 本地作答 | 回复槽记录 0 → 64 |
|
||||
|---|---|---|---|---|
|
||||
| Espryt | 0.163 / 0.153 / 0.145 | 0.156 / 0.140 / 0.157 | **0 / 598** | 601 → 3 |
|
||||
| Magma(tier 2) | 0.167 / 0.176 / 0.181 | 0.191 / 0.175 / 0.174 | 0 / 598 | 601 → 3 |
|
||||
| Magma(`.Fence.` 带状环境,与主机 bench 同) | 0.171 / 0.167 / 0.164 | 0.182 / 0.160 / 0.182 | 0 / 598 | 601 → 3 |
|
||||
|
||||
- 延迟 4 帧:Espryt 0 / 596;延迟 1 帧:两后端都是 0 / 599。
|
||||
- **结论:真 GPU 上 Espryt 与 Magma 一样,每次等待都在本地作答。** [`A-FENCE-POLL.md`](A-FENCE-POLL.md) 里"fence 只有阻塞等待后才可见"是主机 llvmpipe 独有的行为。inproc 的每帧耗时在噪声内不变(每次运行约 0.1 s,10% 以内的差都是噪声);收益在有往返延迟的链路上(主机 Magma·tcp −37%)。
|
||||
- Spawn 臂没跑:Android 测试框架总是画进 `ANativeWindow`,spawn 出来的 server 拒收(`Fatal{UnmigratedSurface}`)。
|
||||
- **Android 上的 itest 本身跑不了这个 bench**:`SplitRuntimePeek` 在 `__ANDROID__` 下编译掉,itest 又链接的是隐藏符号的 `libMobileGL.so`。测量用的是本地构建补丁(`-DMGITEST_ANDROID_STATIC_PEEK=ON`:Android 上改链静态库并开启 peek,库代码与编译选项不变),未提交,存为 `evidence/c/peek-patch.diff`(ID-P10-14)。
|
||||
|
||||
## 2. `MOBILEGL_IPC_PRESENT_CREDIT` 1 / 2 / 3,设备上 spawn + tcp(127.0.0.1),trace APK,Espryt,3 次交错
|
||||
|
||||
| 臂 · 负载 | credit 1 | credit 2 | credit 3 | 散布 | credit 等待 ms/帧 | 传输等待 ms/帧 | client CPU ms/帧 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| tcp · rd12(稳态 fps) | 51.4 | 51.6 | 52.4 | 1–3% | 0.18–0.24 | 11.2 | 9.9 |
|
||||
| tcp · openra | 399.0 | 384.9 | 391.8 | 最多 8% | 0.16–0.19 | 2.1 | 1.8 |
|
||||
| shm · rd12 | 120.2 | 120.1 | — | ≤ 0.4% | 0 | 0.1 | 8.2 |
|
||||
|
||||
- **结论:loopback 上 credit 没有噪声以外的影响。** rd12·tcp 的 19.4 ms 帧由 client CPU(~9.9 ms)和生产者在传输里的停车(~11.2 ms,发送 + 环 / stage / ack 等待)组成,credit 等待只有 ~0.2 ms。五臂报告(09-28)建议 #2"credit 2"在 loopback 上没有收益;要追的是 stream 传输的停车(性能债,[`../DEBTS.md`](../../../Disaggregated/DEBTS.md))。
|
||||
- 跨机(Wi-Fi)credit 1 → 2 的 +26% 仍以 P12 的数字为准([`../p12/CROSSHOST-ACCEPTANCE.md`](../p12/CROSSHOST-ACCEPTANCE.md)),那里瓶颈是往返延迟。
|
||||
- 五臂报告里 tcp-loopback rd12 的 21–23 fps(74% 在 credit 等待)是旧构建、未定频的结果,与本次不可直接比较。
|
||||
- Magma 没测:`profile_matrix.sh` / `run_matrix.sh` 在两处写死了 DirectGLES。
|
||||
- P12 同款明细(`evidence/c/m2/m2.p12style.md`):rd12 加载帧 10.6–10.8 s、稳态 73–74 MB/s;`wait_replies` 全在第 1 帧(`ResourceCreate`)。
|
||||
|
||||
## 3. 主机 retrace 往返普查(`MOBILEGL_PIPE_STATS=1`,全部 SPLIT / SPAWN 条目)
|
||||
|
||||
集成头 `47bbf5e6`,156 条(39 个 trace × 两后端 × SPLIT / SPAWN),`P65LinkMetrics` 的逐帧 `wait_replies` 按 op 分。全表在 `~/w7/notes/p10/evidence/census.md`,脚本 `~/w7/notes/p10/census.py`。
|
||||
|
||||
| 稳态(第 2 帧起)的回包等待 | 全语料 | 出处 |
|
||||
|---|---|---|
|
||||
| draw / state / upload 路径 | **0** | 没有一条 draw、状态设置或 `ResourceSubData` 记录等待回复 |
|
||||
| `ResourceCreate` | 243,172 | 每个资源一次(modernui-inventory 每帧约 6.5 次);P12 已裁定保持 `kWaitReply`([`../p12/DEVICELOST-AND-UPLOAD-WAITS.md`](../p12/DEVICELOST-AND-UPLOAD-WAITS.md) §2.4) |
|
||||
| `FenceWait` | 10,685 | **只有** `improved-transparency-minecraft-26.3` × Espryt(每帧约 4.4 次 timed wait),即 llvmpipe 的现象(ID-P10-6);同一 trace 在 Magma 上是 0 |
|
||||
| `MapPersistent` | 192 | 每个 trace 1–9 次 |
|
||||
|
||||
- 39 个 trace 里有 34 个建 fence(多数每帧一个),其中 33 个在任何一条臂上都**没有**发出 `FenceWait` / `FenceStatus` 记录,也就是轮询全部在本地作答;唯一的例外是上表中 llvmpipe 上那一条。
|
||||
- iterationrp 的 6 条 retrace 因宿主 JIT 崩溃判红,但崩溃前的帧照常计数。
|
||||
@@ -0,0 +1,20 @@
|
||||
# P10 集成者裁定日志(sync / query / present 节奏)
|
||||
|
||||
> 形式沿用 [`../p9/INTEGRATOR-DECISIONS-P9.md`](../p9/INTEGRATOR-DECISIONS-P9.md):一条裁定一个 ID,只记「定了什么、为什么、影响哪些文件」。计划与范围重划见 [`PLAN-P10.md`](PLAN-P10.md),协议见 `MobileGL/MG_Remote/CONTRACT-P10.md`。
|
||||
|
||||
| ID | 日期 | 裁定 | 理由 | 影响 |
|
||||
|---|---|---|---|---|
|
||||
| ID-P10-1 | 2026-09-29 | 范围按计划 §1 重划:client 铸造 query handle、present 1:1、credit 默认 1 已是现状,关闭;"DirectGLES fence 逐 fence 退休"与"非 present fence tick"不单独做——线上不依赖帧水位(每批后 `RetireThrough(appliedSeq)`),帧水位只喂 Espryt 自己的 buffer 池回收,与 monolith 相同;A 的"空闲时也查 fence"就是线上的非 present tick。 | 路线图行写于 09-22,逐项对照树的现状核对过。 | `PLAN-P10.md` |
|
||||
| ID-P10-2 | 2026-09-29 | A 的形状:server 按创建顺序查 fence,完成的发 `kEventFenceSignaled`(`EventKind` 追加 5,8 字节);client 已知 signaled 的轮询本地作答,不能等的未知轮询本地答"未完成",同一 fence 连续第 `MOBILEGL_IPC_POLL_ESCALATE`(默认 64)次改为一次往返;**可以等的调用(timeout > 0)仍然往返**,语义不变。旋钮为 0 就恢复 P10 之前的行为,作 A/B 控制;设备丢失后一律走往返臂。 | 本地作答只用 server 说过的事实,所以不会早报;升级保证"只轮询不发记录"的循环有界。timed wait 本地等报告需要另一套唤醒路径,往返本身就是那次等待。 | `EventRing.h`、`ServerSession.{h,cpp}`、`PipeApplier.{h,cpp}`、`ServerLoop.cpp`、`ClientSession.{h,cpp}`、`EmitTables.{h,cpp}`、`Config.h`、`ConfigLoader.cpp` |
|
||||
| ID-P10-3 | 2026-09-29 | client 记"已 signaled"的表用独立互斥锁,不用 `g_fenceMutex`。 | 事件排空发生在持有 `g_fenceMutex` 的发射函数内部(`EmitAndWait`、`PollEntry` 都排空),用同一把锁会让 GL 线程自锁。 | `EmitTables.cpp` |
|
||||
| ID-P10-4 | 2026-09-29 | server 将要空闲且有未报告 fence 时:对最老的 pending fence 做一次 `ClientWaitSync(GL_SYNC_FLUSH_COMMANDS_BIT, 0)`(两个后端都会借此提交所持命令的唯一后端无关方式),仍有未报告的就限时停车 1 ms 再查;否则照旧无限期停车。`SEG_EVENT` 满时不报告。 | red-once:去掉空闲复查 → Espryt 需 1 次升级,Magma 升级 15 次仍等不到(Magma 的 fence 不会自己提交)。每批都提交会打掉 Magma 的命令缓冲批处理,所以只在空闲时做。 | `ServerLoop.cpp`、`PipeApplier.cpp` |
|
||||
| ID-P10-5 | 2026-09-29 | `OnPresent` 在归还 present credit **之前**报告一次(状态查询,不提交)。 | credit 放行的 client 会立刻去等一两帧前的 fence;批次结束后才发的报告会输给它。实测只在 Espryt·tcp 有变化(本地作答 36–54 → 79–101 / 598)。 | `PipeApplier.cpp`、`ServerSession.{h,cpp}`(`EventRingHasRoom`) |
|
||||
| ID-P10-6 | 2026-09-29 | 主机 Espryt 上 A 没有收益:在 mesa llvmpipe(ES 3.2)上 `glGetSynciv` 与零超时 `glClientWaitSync` 看不到早已完成的 fence,只有阻塞等待才能让它变成 signaled。另外试了三种做法——空闲 / present 时冲刷最新的 fence、present 时 flush 检查、1 ns 的 timed wait——都没有效果,全部撤回,`ReportSignaledFences` 保持门禁通过时的原样。真 GPU 上的答案由 C 给出(ID-P10-11)。 | lag 1–6 的本地作答都是 0–6;server 端追踪显示队首 fence 在约 4 帧的每次检查里都是 pending,要等 client 的 timed wait 过线、server 阻塞等待之后才被报告。Magma(lavapipe)同一追踪里报告全部早于等待,tcp 每帧 −37%。 | `A-FENCE-POLL.md` |
|
||||
| ID-P10-7 | 2026-09-29 | B:`GL_KHR_parallel_shader_compile` 由 client 的编译开关决定,caps mirror 在采纳快照时重算这一项。 | 编译池与 `GL_MAX_SHADER_COMPILER_THREADS_KHR` 都在 client;Split / Spawn 之所以一致,只是因为 server 继承了 client 的环境,tcp 的共享 fixture server 不继承,于是 Tcp 的 `AsyncOff` 用例两后端都红。 | `CapsMirror.cpp`、`RemoteClientTest.cpp` |
|
||||
| ID-P10-8 | 2026-09-29 | B:发射表的 `SetSwapInterval` 槽改为 server 转发器,`SetSwapInterval_Unmigrated` 与 `BackendObject_Remote` 的覆盖删除;class C 清零(69 已实现 / 0 未迁移)。控制由单元用例 `ServerLoopTest.TheEmitTableSwapIntervalSlotCrossesAsOneDispatchedFrame` 钉住(split 车道观察不到交换间隔)。 | 路线图列为最后一个手写 class-C。原槽是一个永远到不了的具名 Fatal,实际调用一直走另一条路。 | `EmitTables.{h,cpp}`、`BackendObject_Remote.{h,cpp}`、`ServerLoopTest.cpp`、`RemoteClientTest.cpp` |
|
||||
| ID-P10-9 | 2026-09-29 | B 的登记:`AsyncCompileScenario`(`AsyncOn` / `AsyncOff` / `OptimisticShaderStatus` 三形)与 `XfbPrimitiveQueryScenario` 在两后端的 Split / Spawn / Tcp 上登记;`PrimitivesGeneratedNoXfbScenario` 只登记 Magma(Espryt 上每例都按设计跳过),其中 `PrimGenReroute` 不登记 Magma Tcp(共享 fixture server 读不到这个开关,8 例在 `spawn_lane_parity.py` 里具名列出)。 | 保证跳过的登记只会让门看上去更大。 | `MG_IntegrationTest/CMakeLists.txt`、`spawn_lane_parity.py` |
|
||||
| ID-P10-10 | 2026-09-29 | B 查出、**不在 P10 改**的两项:(1) `GL_ARB_gpu_shader_fp64` 按 server 的 `MOBILEGL_ADVERTISE_FP64` 宣告,但 fp64 收窄发生在 client 的编译里,tcp 下 server 环境不同时会不一致,属于同类问题(挂点是 `CapsMirror::Adopt`)→ 债;(2) Magma 没有注册 `SetSwapInterval`,monolith 与 split 下 `eglSwapInterval` 都是空操作 → dev 线独立任务。 | 前者无触发报告,挂点已有;后者是 dev 的缺陷,按规矩不顺手修。 | `DEBTS.md`;独立任务 |
|
||||
| ID-P10-11 | 2026-09-29 | 真机(Adreno 830,`8d0a1b6c`)上 A 成立:同一 bench 在 esc=64 时,Espryt 与 Magma 都是 0 次 fence 往返、598 / 598 次本地作答,回复槽记录 601 → 3;lag 1 / 4 也一样。ID-P10-6 的现象只出现在 llvmpipe 上,A 的实现不需要按后端区分。 | 这正是 ID-P10-6 留给 C 的问题。 | `C-MEASUREMENTS.md` §1 |
|
||||
| ID-P10-12 | 2026-09-29 | **P10 收官**。集成头(A + B,`47bbf5e6`)整套门:G1 符号增 0 减 0、`.text` `0xa52203`(同机 clang 22.1.6,与 P9 相同);fatal census 79、link ratchet 171、spawn parity 0、协议修订 3、wire-declines 53/53;卫生 12/12;unit 2644;integration-split / spawn / tcp 356 / 273 / 277;integration-magma-split / spawn / tcp / full-split 174 / 153 / 130 / 583;integration-gpu monolith / inproc 2348 / 2348。verify 构建 unit / integration-verify / integration-verify-split 2644 / 1238 / 1172。主机 retrace 230 / 236,6 项仍是 iterationrp 的宿主 llvmpipe JIT 崩溃(monolith 同挂,同 P9)。出口门"trace 上 draw / state / upload 往返读零"成立:`MOBILEGL_PIPE_STATS=1` 普查 156 条 SPLIT / SPAWN 条目,稳态回包等待只有 `ResourceCreate`(P12 已裁定保持)、`MapPersistent`,以及 llvmpipe 上 Espryt 的 `FenceWait`(`C-MEASUREMENTS.md` §3)。收官审查沿用 P12:不派 agent / Codex,契约断言由集成者对照代码核过(`kEventFenceSignaled = 5` 与 8 字节载荷、`PollEscalate` 默认 64 且范围 0..1000000、`kFenceIdlePollMs = 1`、控制协议修订 3、class C 无 `_Unmigrated` 桩)。 | — | 全阶段 |
|
||||
| ID-P10-13 | 2026-09-29 | `PRESENT_CREDIT` 默认保持 1。设备上 tcp loopback 的 credit 1 / 2 / 3 在噪声内(rd12 51.4 / 51.6 / 52.4 fps,credit 等待 ~0.2 ms / 帧,传输停车 ~11.2 ms / 帧);跨机 Wi-Fi 的 +26%(P12)是按链路调的旋钮,不是默认值问题。present credit 的直方图不另做:`P65ClientPace` 每次 present 都打 `credit_wait_ms`,分布可以直接从日志得到。loopback 上的下一个开销是 stream 传输的停车:记为性能债,等路线图推完再回头做(用户 09-08:性能只记录)。 | 路线图说"credit > 1 从未量过",现在两条链路都量过了;推翻五臂报告的建议 #2(那组数据是旧构建、未定频)。 | `C-MEASUREMENTS.md` §2 |
|
||||
| ID-P10-14 | 2026-09-29 | 让 Android itest 读到 split 运行时计数的构建补丁(`-DMGITEST_ANDROID_STATIC_PEEK=ON`:改链静态库并开启 `SplitRuntimePeek`)**不入库**,只存为证据(`~/w7/notes/p10/evidence/c/peek-patch.diff`)。 | 只是这一次测量要用;要让设备上的计数门成为一条车道,得先给 Android 框架加 pbuffer 路径(spawn 臂也缺这个),那是单独一项工作。 | 无(证据) |
|
||||
@@ -0,0 +1,38 @@
|
||||
# P10 计划:sync / query / present 节奏(重划范围)
|
||||
|
||||
> 2026-09-29,基于 `feat/disaggregated@de33d401`(P9 收官头)。路线图行(原文在 [`README.md`](README.md))写于 09-22,与树的现状逐项核对如下;**先读 §1**。
|
||||
|
||||
## 1. 路线图每一项的现状
|
||||
|
||||
| 路线图写的 | 现状(核对) | 处置 |
|
||||
|---|---|---|
|
||||
| 轮询入口成门铃点 + `MOBILEGL_IPC_POLL_ESCALATE` | **没做**:`glClientWaitSync` / `glGetSynciv` 都是 `kWaitReply`(`FenceWait` op 9、`FenceStatus` op 8),每次都要等 server 把它之前**所有**记录 apply 完再回复——run-ahead 下等于一次全管线同步。FCL 里的 Minecraft 稳态每帧约 1 次(P12 验收 A);TCP 上再加一个 RTT。旋钮 0 处 | **A**(核心) |
|
||||
| DirectGLES fence 完成度逐 fence 退休;非 present fence tick | 线上**不依赖**帧水位:server 每批 apply 后 `RetireThrough(appliedSeq)`(`ServerLoop.cpp`),`SEG_STAGE` 不会在无 present 负载里饿死。帧水位只喂 Espryt 自己的 buffer 池回收,与 monolith 同 | 不单独做;A 需要"空闲时也检查 fence",那一点就是线上的非 present tick |
|
||||
| `present` 1:1、credit 默认 1、client 铸造 query handle | 已是 | 关闭 |
|
||||
| `PRESENT_CREDIT > 1` 从未量过 | 跨机 Wi-Fi 已量(P12:rd12 稳态 1→2 +26%、2→3 +4%,[`../p12/CROSSHOST-ACCEPTANCE.md`](../p12/CROSSHOST-ACCEPTANCE.md));**TCP loopback 未量**([`../perf-five-arm-20260928`](../perf-five-arm-20260928/README.md) 建议 #2 "未实测,待 A/B") | **C** |
|
||||
| roundtrip 计数器与输入延迟直方图 | 部分已有:`P65LinkMetrics` 逐 op 回包等待 + 回复延迟直方图(P12);trace 稳态回包等待 0(五臂报告)。缺:present credit 等待的直方图、逐 trace 的往返普查记录 | **C**(记录);直方图若缺则补 |
|
||||
| `SetSwapInterval`(最后一个手写 class-C) | `eglSwapInterval` 实际走 `BackendObject_Remote::SetEGLSwapInterval` → 控制帧 `SurfaceControlOp::SetSwapInterval`,跨进程可用;发射表槽 `SetSwapInterval_Unmigrated` 是永远到不了的具名 Fatal | **B**:槽改为同一转发,class-C 清零 |
|
||||
| 门:query / XFB / `AsyncCompile` 场景在 split 下绿 | `SyncWire`、四个 XFB 场景已登记 split;**`AsyncCompileScenario`、`XfbPrimitiveQueryScenario`、`PrimitivesGeneratedNoXfbScenario` 未登记任何 split 臂** | **B** |
|
||||
| 门:零 timeout 轮询有界退出 | 今天靠每次往返保证进度;A 之后由升级规则保证 | **A** 的门 |
|
||||
|
||||
## 2. 工作包
|
||||
|
||||
### A — fence 轮询本地作答(核心)
|
||||
|
||||
- **server**:apply 线程在每个 drain 批次之后、以及空闲等待时(有未报告的 fence 就限时停车,默认 1 ms 再查)按创建顺序用后端表 `GL.GetSyncStatus` 查尚未报告的 fence;新近 signaled 的发一条 `kEventFenceSignaled{handle}`(EventKind 只追加)。后端无关(两个后端都实现 `GL.FenceSync/GetSyncStatus/ClientWaitSync`)。
|
||||
- **client**:排空事件时记下已 signaled 的 fence;`glClientWaitSync` / `glGetSynciv(GL_SYNC_STATUS)`:已知 signaled → 本地答 `GL_ALREADY_SIGNALED` / `GL_SIGNALED`;未知且 timeout = 0 → 先 publish + 敲门铃(轮询入口是门铃点;`GL_SYNC_FLUSH_COMMANDS_BIT` 无条件 flush),排空事件,仍未知则本地答 `GL_TIMEOUT_EXPIRED` / `GL_UNSIGNALED`;同一 fence 连续 N 次(`MOBILEGL_IPC_POLL_ESCALATE`,默认 64;0 = 关闭本地作答,即 A/B 控制)无进展 → 升级成一次真往返;timeout > 0 且未知 → 真往返(语义不变)。
|
||||
- **门**:零 timeout 轮询循环在 split / spawn / tcp × 两后端有界退出;轮询不产生回复槽记录(计数门,red-once = `POLL_ESCALATE=0`);`SyncWireScenario` 不变绿;停车的 server 仍会报告后来才 signaled 的 fence(red-once = 去掉空闲检查)。
|
||||
|
||||
### B — split 覆盖与最后一个 class-C
|
||||
|
||||
- `AsyncCompileScenario`、`XfbPrimitiveQueryScenario`、`PrimitivesGeneratedNoXfbScenario` 登记到两个后端的 Split / Spawn / Tcp 臂,红的修(两后端都修)。
|
||||
- `SetSwapInterval` 发射表槽改为转发,删 `SetSwapInterval_Unmigrated`。
|
||||
|
||||
### C — 测量(A 落地之后)
|
||||
|
||||
- 红米 `2f7cbe2e`:`PRESENT_CREDIT` 1 / 2 / 3 × {spawn+tcp localhost, WSL → 手机 Wi-Fi},rd12 与 openra,每档 ≥ 3 次交错;`POLL_ESCALATE` 0 / 64 的配对。只记录、不设门(性能只记录,用户 09-08)。
|
||||
- 主机 retrace 语料 `MOBILEGL_PIPE_STATS=1`:逐 trace 的稳态回包等待按 op 列表,draw / state / upload 路径应为 0。
|
||||
|
||||
## 3. 门与规矩
|
||||
|
||||
同 P9([`../p9/HANDOFF-P9.md`](../p9/HANDOFF-P9.md) §5–§6):`~/w7/notes/p9/gate.sh` 全套 + verify 构建三车道;G1 同机比较;改 wire 按规矩(EventKind / opcode 只追加);每个新门 red-once;设备只用红米;不拉 LFS;提交一行、无署名尾注。
|
||||
@@ -0,0 +1,25 @@
|
||||
# P10 — sync / query / present 节奏(已收官,2026-09-29)
|
||||
|
||||
> **2026-09-29 收官**。协议与行为:`MobileGL/MG_Remote/CONTRACT-P10.md`;裁定 [`INTEGRATOR-DECISIONS-P10.md`](INTEGRATOR-DECISIONS-P10.md);计划与范围重划 [`PLAN-P10.md`](PLAN-P10.md);测量 [`A-FENCE-POLL.md`](A-FENCE-POLL.md)、[`C-MEASUREMENTS.md`](C-MEASUREMENTS.md)。
|
||||
>
|
||||
> | 包 | 结果 |
|
||||
> |---|---|
|
||||
> | A fence 轮询 | server 报告完成的 fence(`kEventFenceSignaled`,含 present 时、归还 credit 之前),client 本地作答;第 `MOBILEGL_IPC_POLL_ESCALATE`(64)次未答的零超时轮询才往返;timed wait 语义不变。主机 Magma·tcp 每帧 −37%、fence 往返 598 → 0;主机 Espryt 无收益(llvmpipe 上只有阻塞等待才能看到 fence 完成);Adreno 830 上两后端都是 0 次往返、598 / 598 次本地作答 |
|
||||
> | B 覆盖与 class C | `SetSwapInterval` 槽改为 server 转发,class C 清零;`GL_KHR_parallel_shader_compile` 改由 client 决定;AsyncCompile / XfbPrimitiveQuery / PrimitivesGeneratedNoXfb 登记到 split 各臂(Espryt 27 条、Magma 64 条) |
|
||||
> | C 测量 | 设备上 tcp loopback 的 `PRESENT_CREDIT` 1/2/3 在噪声内(rd12 51.4 / 51.6 / 52.4 fps),默认保持 1,下一个开销是传输停车(性能债);主机 retrace 往返普查见 `C-MEASUREMENTS.md` §3 |
|
||||
>
|
||||
> 门(集成头):见 ID-P10-12。
|
||||
>
|
||||
> 下面是该阶段在路线图上的原始范围与出口门(2026-09-24 从 [`ROADMAP.md`](../../../Disaggregated/ROADMAP.md) 阶段表移入,原文照录)。
|
||||
|
||||
## 摘要
|
||||
|
||||
- 轮询入口成门铃点 + `MOBILEGL_IPC_POLL_ESCALATE`;DirectGLES 的 fence 完成度改为逐 fence 退休;非 present fence tick;**`PRESENT_CREDIT > 1` 从未量过**(带延迟链路上的首要杠杆);roundtrip 计数器与输入延迟直方图;`SetSwapInterval`(最后一个手写 class-C)。
|
||||
- 门:query / XFB / `AsyncCompile` 场景在 split 下绿;draw / state / upload 路径 roundtrip 读零;credit 1..3 在 TCP loopback 与跨机臂上的配对记录。
|
||||
|
||||
## 阶段表行(原 `ROADMAP.md`)
|
||||
|
||||
- **阶段**:**P10** sync / query / present 节奏
|
||||
- **状态**:待排
|
||||
- **落地什么 / 范围**:~~client 铸造 query handle~~(已是:`QueryCreate` 为 `kWaitNone`);轮询入口成门铃点 + `MOBILEGL_IPC_POLL_ESCALATE`(0 处;TCP 上是首要杠杆之一);DirectGLES 的 fence 完成度来自逐 fence 退休(`g_completedFrameSerial` 仍只在 `Present` 前进;Magma 那半已由 run-ahead 落地);非 present fence tick(唯一记载处);`present` 1:1(已是);~~credit 默认 1~~(已是默认,`ConfigLoader.cpp:414`);**`PRESENT_CREDIT > 1` 从未量过**(重审 §8.7)——带延迟链路上的首要杠杆,inproc 臂上即可取;roundtrip 计数器与输入延迟直方图(今天只有 `MapPersistentRoundtrips`);`SetSwapInterval`(最后一个手写 class-C,`EmitTables.cpp:1665`)
|
||||
- **验收门 / 证据**:query / XFB / `AsyncCompile` 场景在 split 下绿;trace 上 draw / state / upload 路径 roundtrip 读零;零 timeout 轮询有界退出;credit 1..3 在 TCP loopback 与跨机臂上的配对记录;配对 A/B 记录
|
||||
Reference in New Issue
Block a user