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,89 @@
|
||||
# P9 交接:反向通道(重划范围)
|
||||
|
||||
> 2026-09-29,写给实现方。基于 `feat/disaggregated@acfd36785`。**[V]** = 我读了代码 / 文档 / 日志确认;**[I]** = 我的推断,实现前要自己核。
|
||||
> 路线图 P9 那一行(09-22 写的,原文在 [`README.md`](README.md))与树里的现状已经对不上:一半已经做完,一半的设计前提被后来的阶段改掉了。**先读 §2,再动手。**
|
||||
|
||||
## 1. 目标
|
||||
|
||||
server → client 的结果回传(回读、回调、回复)在 split 下不阻塞、不丢、不乱序,剩下的 `Fatal{Unmigrated*}` 与"没生产者的回调"要么落地、要么明确删除。P9 属于 IPC 跑道(`P12 → P9 → P10 → P11`),与 P8(monolith 跑道)互不依赖。
|
||||
|
||||
## 2. 路线图每一项的现状(先看这张表)
|
||||
|
||||
| 路线图写的 | 现状 | 处置 |
|
||||
|---|---|---|
|
||||
| 异步 reply 语义,建在 P6.5 消息式 reply 上 | **[V] 大半已做**,但不在 P9 名下:P12 落了 `ILink::DeclareReplyRead` + `RetainsReplies`(StreamLink 的"声明过的答案"存储,容量 24,溢出是 Fatal 不是淘汰;ShmLink 为 false)、`kRecNoReply`(`Transport/Ring.h`,"这条答案没人读,server 别回")、create 窗口(`MOBILEGL_IPC_CREATE_WINDOW` 默认 10,只在 `RetainsReplies` 的链路上生效)。rd12 加载帧的回包等待从 43,232 降到几百。见 `notes/p12/CREATE-WINDOW-MEASURED.md`、提交 `4e48702f2` / `3a2555805` | 不重做。剩下的只有 §3 的 W1 |
|
||||
| 2 MiB reply cap 与 chunked readback(ID-47) | **[V] 已做**:`ReadPixels` 超过一个回复槽时由 client 切成行带(P7 ID-P7-58,`EmitTables.cpp` 的 `PlanReadbackBands` / `ForEachReadbackBand`,`BandedReadbackScenario`);`GetTextureImage` 按 `DstOffset` 分窗(`TextureReadbackEmit.inc`) | 关闭;只在 W1 里保持行为不变 |
|
||||
| PACK-PBO 回读 fire-and-forget + client `MarkGpuWritten`(ID-57) | **[V] 没做**:目标是 PBO 时,client 仍然等回复、再把行 `UploadSubData` 进 PBO(`EmitReadPixels` 里的 `pbo` / `pboSynced`,`EmitGetTextureImage` 末尾) | **W1** |
|
||||
| 十个回调里未武装的四个:`OnTextureWriteback`、`OnTexturePullRequest`、`OnMipLevelsGenerated`、`OnLog` 分级 | **[V] 回调现有 9 个,`OnCapsInvalidated` 也没有生产者**(server 只装 4 个:`OnGlError`、`OnBufferWriteback`、`OnGpuWritten`、`OnSurfaceChanged`,`Server/ServerSession.cpp:823-827`;client 的消费者只有对应 4 种 `EventKind`,`Transport/EventRing.h`,`ClientSession.cpp` 的 `DrainEventRing`)。caps 失效走控制面的 CapsSnapshot 再到达(R-12),日志走控制面 `LogLine` | 逐个裁定,见 W2 / W3 |
|
||||
| `OnGpuWritten` 收窄;`OnBufferWriteback` 批处理 + epoch 排序 | **[I] 没有实测需求**;writeback 已按 SEG_EVENT 容量的四分之一切片(`MGPipeBufferWritebackSliceBytes`,`MG_Pipe/MGPipeCallbacks.h`),"最后一片落地蕴含此前每一片" | 不做,除非 §5 的计数器显示事件量是问题(W4) |
|
||||
| `OnGlError` 有序 | **[V] P5e 已裁定放宽**:run-ahead 动词的错误在下一个 drain 点观察,最多晚一个 present credit(`CONTRACT-P5E.md` §"glGetError relaxation"、`CONTRACT-P5C.md` §4.2) | 默认保持放宽,只记录(W5) |
|
||||
| 纹理拉取四条缓解 + 终止符(`TextureRemintPullScenario`) | **[V] 拉取协议至今不存在**(`ResourceSubDataComplete` 终止符 op 有,但没有请求事件);split 下重铸路径是 `Fatal{UnmigratedEmulation, "texture-remint-pull"}`(`MG_Backend/DirectGLES/Managers.cpp` 约 6519 / 6536)。**[I] 但设计前提变了**:`design/04-reverse-channel.md` §8.4 写"server 不保留纹素",而 P5c 的 tx 之后 server 有 `StagedTextureStore`(`MG_Remote/Server/StagedTextureStore.h`,`CONTRACT-P5C.md` §2)——已定义的层级字节就在 server 手里 | **W2:先查、再定**,很可能不需要拉取协议 |
|
||||
| XFB 命名空间(`DeleteTransformFeedback` 的 server 泄漏) | **[V] 已做**(`70df57bb2`):`DeleteStreamOutput` op + `ServerVerbSink::OnDeleteStreamOutput`(`Server/PipeApplier.cpp` 约 1105)清 span 与 lifetime id | 关闭 |
|
||||
| 两条故障注入 | 原文没说是哪两条 | §4 里我定了两条 |
|
||||
|
||||
**边界(别越界)**:`generate-mipmap-*`、`copy-image-shadow-mirror` 这些 Fatal 是 **P8**(把仿真挪到 client);`FenceWait` / `Query*` 的每帧回包是 **P10**;`ResourceReadback` / `ReadPixels` 本身是必须等的同步语义,不是 P9 要消掉的。
|
||||
|
||||
## 3. 工作包
|
||||
|
||||
### W1 — PACK-PBO 回读不再等回复(唯一确定要做的)
|
||||
|
||||
- **现在**:client 发 `ReadPixels` / `GetTextureImage` 记录并阻塞等回复;回复里是紧排的像素,client 按 PACK 状态(行长、对齐、skip)散射进 PBO。
|
||||
- **目标**:目标是 PBO 时,client **不等**:记录以 PBO 的 wire 句柄为目的(P5 已裁定"PBO 目的是资源句柄,不需要 `Seg` 字段",`CONTRACT-P5.md` 行 23),带 `kRecNoReply`;client 在发出时把该范围标成"GPU 写过"(`MG_Remote/Client/GpuWritePending.*` 的保守 pending 集),此后任何 CPU 访问(`glMapBufferRange` / `glGetBufferSubData`)走既有的 `ResourceReadback` → `OnBufferWriteback` 路径拿到数据。
|
||||
- **要先弄清的**:(1) monolith 的语义:原生读进驱动的 PBO 之后,**立刻**把整个 PBO 映射出来、`WritebackFromBackend` 进 client 的 buffer 影子,再 `BumpBufferMutationEpoch`(`DirectGLES.cpp` 约 15348–15361,日志 "PBO used, mapping buffer to client memory")——即读完影子就是新的。异步化必须保住"此后任何 CPU 访问都看到数据",有两条路:(a) client 只标"GPU 写过",数据留在 server 的 twin,CPU 访问时惰性拉(既有的 `ResourceReadback`);(b) server 读完后发一条 `OnBufferWriteback`,与 epoch bump 有序(`CONTRACT-P5C.md` §4.2 / §8.2)。选哪条要先量一下(PBO 通常多大、多久被 CPU 读)再定;(2) PACK 状态本来就推给 server(`PipeFill.cpp` 的 `EmitPixelPackState`),server 是否可以直接按 PACK 布局落字节,还是仍然回紧排数据、由 client 散射(后者就得等,等于没做);(3) PBO 太小 / 范围越界仍然是 client 侧的 `RecordReadbackRangeError`,别改。
|
||||
- **门**:新增场景——PBO 读 + 之后 `MapBufferRange` 读回的字节与 monolith 逐字节相同(含非紧 PACK 状态:`PixelStoreSweepScenario` 的形状);该 op 的 `by_op` 回包等待为 0(`MOBILEGL_PIPE_STATS=1` 的 `P65LinkMetrics kind=frame-op`);**red-once**:改回"等回复"后计数门变红;非 PBO 路径(`BandedReadbackScenario`)行为不变。
|
||||
|
||||
### W2 — `texture-remint-pull`:先做普查再定要不要协议
|
||||
|
||||
1. 普查:在四条 A/B trace 与你能拿到的 trace 语料上跑 `MOBILEGL_PIPE_STATS=1`,读 `TextureRemintPulls` 计数(`MG_Util/Metrics/PipeStats`;文档记录过"780 个统计窗口 2 次")。
|
||||
2. 判定:重铸重放的字节是否已在 `StagedTextureStore`(整段 staged run,按 (uploadTarget, level) 覆盖)。**[I]** 若是,client 拉取没有意义,重放应改读 server 自己的 store,`Fatal{UnmigratedEmulation,"texture-remint-pull"}` 变成普通路径;"已定义但没字节"的层(纯 `glTexStorage` 未上传)按 monolith 的行为(跳过 / 零)处理,先在 monolith 里测出来。
|
||||
3. 结论若是"不需要拉取":删掉 `OnTexturePullRequest`(回调 9 → 8,`kMGPipeCallbackCount` 与 `static_assert` 同步),写进裁定日志;`TextureRemintPullScenario` 改成"image 绑定后纹素与 monolith 相同、不 Fatal"。若确有 store 没有字节的层,再按 `design/04` §8.4 设计协议(server 发请求事件、client 回 `ResourceSubData` + `ResourceSubDataComplete{pullSerial}`、apply 线程有界等待、终止符可带零个 region),**并先回来问用户**。
|
||||
- 注意 Magma 与 Espryt 是两条路径(Espryt 的重铸在 `Managers.cpp`,Magma 的 T5 见 `CONTRACT-P5C.md` §2.3)。
|
||||
|
||||
### W3 — 日志分级(`OnLog`)
|
||||
|
||||
- **[V]** server 转发日志时级别写死 Info(`Server/ServerMain.cpp` 的 `ForwardLog`:`CreateLogLine(builder, LogLevel::Info, …)`),因为 `LogForwarder` 的签名没有级别(`MG_Util/Debug/Log.h:139`,`void (*)(void*, const char*)`)。`LogLine` 里本来就有 `level` 字段(`protocol.fbs`),**不需要改 schema**。
|
||||
- **做**:转发签名带上级别;client 写 `<base>.server.log` 时保留级别;`≤WARN` 有损(控制 socket 写不动就丢并计数)、`≥ERROR` 无损 + 限速。决定后把 `OnLog` 回调删掉(没有任何生产者,日志不走 `gMGPipeCallbacks`)。
|
||||
- **门**:单元测试覆盖级别映射与丢弃计数;故障注入 F2(§4)。
|
||||
|
||||
### W4 —(可选)事件量
|
||||
|
||||
只有当 `OnBufferWriteback` / `OnGpuWritten` 的事件数在某个负载里成为问题(看每帧事件数、`eventDropped`、writeback 切片数)才做批处理 / 收窄;否则写进裁定"没有实测需求,不做"。
|
||||
|
||||
### W5 — `OnGlError` 有序(默认不做)
|
||||
|
||||
保持 P5e 的放宽;把"下一 drain 点观察"写进 `CONTRACT-P9.md`。要收紧的话(`glGetError` 触发强制追平)先问用户,会引入新的同步点。
|
||||
|
||||
### 收尾(必做)
|
||||
|
||||
`MG_Remote/CONTRACT-P9.md`(只记实现所需的协议与行为)、`notes/p9/INTEGRATOR-DECISIONS-P9.md`(一条裁定一个 ID,形式同 `notes/p12/INTEGRATOR-DECISIONS-P12.md`)、`notes/p9/README.md` 的阶段状态、`ROADMAP.md` 的 P9 行与 `notes/DEBTS.md`(关掉的债、转出的债)。
|
||||
|
||||
## 4. 故障注入(两条,我定的)
|
||||
|
||||
| 编号 | 场景 | 期望 |
|
||||
|---|---|---|
|
||||
| F1 | server 在 W1 的异步 PBO 读还在飞的时候被杀,随后 client `glMapBufferRange` 该 PBO | 以 device-lost 收场(DECLINED / 具名 Fatal),**不能读到"看起来成功的旧字节"** |
|
||||
| F2 | client 停止读控制 socket(或 SEG_EVENT 不排空),server 持续产生 `≤WARN` 日志与事件 | apply 线程不被日志卡住超过一个有界时间;`≤WARN` 丢弃计数上涨;`≥ERROR` 不丢;事件环走既有的 `ReverseChannelForfeit`(Ph)而不是挂死 |
|
||||
|
||||
沿用 R-16:每条门都要能因它存在的理由变红,并真跑过一次红。
|
||||
|
||||
## 5. 怎么量、怎么验
|
||||
|
||||
- **回包等待的账**:`MOBILEGL_PIPE_STATS=1` 后 client 日志里每帧一行 `P65LinkMetrics kind=frame-op frame=N wait_replies=K by_op=<op>=<n>`,整段的汇总在 `kind=summary`。`op` 是 `MG_Pipe/PipeCalls.def` 里的 **1 起始序号**:回复行是 1 GetCaps、2 ResourceCreate、3 ResourceRespecify、5 MapPersistent、8 FenceStatus、9 FenceWait、14 QueryAvailable、15 QueryResult、47 SetTextureParams、48 ResourceSubData、52 ResourceReadback、55 GetTextureImage、58 ReadPixels、69 QueryTimestamp(共 14 行带 `kReplySlot`)。
|
||||
- **基线(Redmi,WSL client 经 Wi-Fi TCP)**:rd12 整段 324–350 次回包等待,全在加载帧;稳态每帧约 1 次(FCL 里的 Minecraft 是 `FenceWait`,op 9,属于 P10);openra 整段 1 次。数据与做法见 `notes/p12/CROSSHOST-ACCEPTANCE.md`、`tools/device_bench/disagg/crosshost_accept.sh`。**性能只记录、不设门**,对比用逐线程 CPU、Redmi 定频配对 A/B(`guide/pin-verification-2026-09-07.md`)。
|
||||
- **门**(`notes/p12/gate.sh` 是全套的写法):`unit`、`integration-split`、`integration-spawn`、`integration-tcp`、`integration-magma-{split,spawn,tcp}`、`integration-gpu`(`MOBILEGL_TRANSPORT=monolith` 与 `inproc` 各一遍)、卫生检查、`fatal_census.py`(79,只降不升)、`link_ratchet.py`(171)、`protocol_revision_pin.py`、`wire_declines_audit.py`、`check_doc_citations.py --strict`。
|
||||
- **改 wire 就要**:`protocol.fbs` 改动 → `MOBILEGL_PROTOCOL_CONTROL_REVISION` 加 1、`python3 scripts/ci/protocol_revision_pin.py --write`、重新生成头文件;`EventKind` / opcode 只追加;新 `Fatal{Word}` 要在 `MG_Remote/FatalFamilies.def` 有行。
|
||||
- **G1**:pull 构建的符号集与 `.text` 对基线恒等。所有新代码放在 `MOBILEGL_BUILD_DISAGGREGATED` / `MOBILEGL_PIPE_PUSH` 下。**G1 只能在同机同编译器上比**(`gate.sh` 已改成不同源就说"未比较")。本机的做法:WSL Arch 的 `~/w7/pipe`(`build-linux` 是 pull 配置,基线 `.text` = `0xa52203`,符号 0 / 0)。
|
||||
|
||||
## 6. 仓库规矩
|
||||
|
||||
- 提交一行:`[Type] (Scope): description`,**不加 `Co-Authored-By` 或任何署名行**;第一次提交前 `git var GIT_COMMITTER_IDENT` 必须是 `Swung0x48`。推送用 `git push origin refs/heads/feat/disaggregated`(origin = GitHub;Windows 上分支名大小写会撞 `Feat/`)。
|
||||
- 设备只用红米 `2f7cbe2e`(Adreno 830,root),别的 adb 设备一律不碰;只读动作(截图等)不用问。多设备在线时 adb 必须 `-s`。
|
||||
- 不要拉 GitHub LFS(限额):fixture 先从本地已 hydrate 的副本复制;`git lfs checkout` 在 WSL 上会把真文件覆盖成指针。
|
||||
- 临时文件放 scratchpad,阶段结束清掉(WSL 也要);耐久的放 `~/w7/notes/<阶段>/`。
|
||||
- 不顺手修 `dev` 上的 bug;发现的记成独立条目。README 只放介绍与操作流程,排查叙事进 `notes/p9/`。
|
||||
- 收官审查:P12 时用户裁定"不派 agent / Codex,自己核对并跑 G1";P9 收官前先问用户是否沿用。
|
||||
- FCL 是另一个仓库(用户的 fork),P9 不需要动它。
|
||||
|
||||
## 7. 回来汇报时给我
|
||||
|
||||
每个工作包一段:改了什么(提交号)、跑了哪些门(结果)、red-once 是哪条断言变红、没做的与为什么、需要用户裁的点。W2 的结论(要不要拉取协议)和 W3 的 `OnLog` 去留,请在动手实现前先报一次。
|
||||
@@ -0,0 +1,18 @@
|
||||
# P9 集成者裁定日志(反向通道)
|
||||
|
||||
> 形式沿用 [`../p12/INTEGRATOR-DECISIONS-P12.md`](../p12/INTEGRATOR-DECISIONS-P12.md):一条裁定一个 ID,只记「定了什么、为什么、影响哪些文件」。交接与重划范围见 [`HANDOFF-P9.md`](HANDOFF-P9.md),协议见 `MobileGL/MG_Remote/CONTRACT-P9.md`。
|
||||
|
||||
| ID | 日期 | 裁定 | 理由 | 影响 |
|
||||
|---|---|---|---|---|
|
||||
| ID-P9-1 | 2026-09-29 | W1 取交接的 (a):读进 pack buffer 时 client 只标"GPU 写过",字节留在 server,CPU 读时经既有 `resource_readback` 取回;不做 server 主动推送 (b)。 | 读的那一刻两者都不等;(a) 零新机制(`GpuWritePending` 第 4 行 P5 已留好)、从不被 CPU 读的 PBO 零字节过线;(b) 要另一套在飞状态。 | `EmitTables.cpp`、`TextureReadbackEmit.inc` |
|
||||
| ID-P9-2 | 2026-09-29 | 新形式是**两个追加 op**(82 `ReadPixelsToBuffer`、83 `GetTextureImageToBuffer`,共用 104 字节的 `MGPReadbackToBuffer`),不是给 `ReadPixels` 加每记录的免回复标志。 | 目的地要带句柄与 PACK 布局,改 `MGPReadbackInfo` 会同时改两个既有 op 的线上布局;追加 op 是目录的既定做法,且 verb 映射一 op 一 verb。 | `PipeCalls.def`、`MGPipeTypes.h`、`PipeFields.def`、`FieldOwnership.def`、`PipeWireCodec.{h,cpp}`、生成表 |
|
||||
| ID-P9-3 | 2026-09-29 | server 端不用驱动 PBO 读:读紧排像素(与回复形式同一函数)后,按 client 算好的布局经 `MGPipeApplyResourceSubData` 逐段落进目的 buffer。 | Espryt 的 buffer 有两份存储,驱动写只到 GL buffer,之后从 R-11 暂存影子排空的范围会盖回旧字节;Magma 的 `ReadPixels` 没有 pack 路径。走写入口两后端同形。 | `PipeApplier.{h,cpp}` |
|
||||
| ID-P9-4 | 2026-09-29 | client 在五种情况下退回回复形式:旋钮 `MOBILEGL_IPC_PBO_READBACK_SYNC=1`、无回读路径、buffer 已映射(持久映射的读者直接读指针)、范围超 2³¹−1、buffer 无句柄。split 下 UNPACK 源读取先 `SyncGpuWrites`。device lost 时欠着 GPU 写的 buffer 被读 → `Fatal{ReadbackDeclined, "buffer-writeback"}`(F1)。 | 每一条都是"标记兑现不了"的情形;UNPACK 源不同步会让"读进 PBO 再从它上传"上传旧字节;device lost 下返回影子就是把旧字节当像素。 | `TextureReadbackEmit.inc`、`GL_Texture.cpp`、`GpuWritePending.cpp`、`Config.h`、`ConfigLoader.cpp` |
|
||||
| ID-P9-5 | 2026-09-29 | 两个新 sink 的全部形状检查在**读之前**做完,并归到每个 sink 唯一的闩锁点(`"<op>.shape"`,原因作参数);落地函数里不再有闩。准入推导改为"盖该 verb 戳的**每个** op 都等待才算静态屏障"(原实现取表中最后一个 op),自检里以 ReadPixels 为例的对照相应翻转,并加"把新 op 也屏障后该对重新准入"的正向对照。 | `ph_latch_sites.py` 要求每个闩锁点首参为字面量且有原始对端对照行;一个 sink 一个站点只需一行。准入表按 verb 存,一个不等待的 op 就让该 verb 的拉取对它的记录是撕裂读;"最后一个 op"让答案取决于表的顺序。 | `PipeApplier.{h,cpp}`、`PeerLatchTest.cpp`(3 行)、`ph_latch_sites.py`(1 条不可达论证)、`gen_pipe_field_ownership.py` |
|
||||
| ID-P9-6 | 2026-09-29 | W2 取 A:**不要拉取协议**,两后端都是。Espryt split 的重铸已从旧 GPU 纹理读回每级、合并 `StagedTextureStore` 的待定盒(`RequireImageBindableStorageByHandle`,c1bf7e15);Magma 是 `vkCmdCopyImage` GPU→GPU。两处 `Fatal{UnmigratedEmulation, "texture-remint-pull"}` 在传输下不可达(普查 77 行 × 2 臂 = 154 次运行 0 次命中)→ 删除;`OnTexturePullRequest` 删除;`TextureRemintPulls` 在 server 路径计数。只修一个 split 缺陷:只定义未上传的级在重铸时读回失败(`Fatal{ResourceUnavailable,"image-promotion-readback"}`)→ 先问驱动该级是否存在,没有就用暂存或跳过;读回失败且暂存有该级 → 用暂存。 | 交接 §3 W2 的"改读 server 自己的 store"是错的:store 只有 client 上传过的字节,而语料里两次真实重铸(iris-photon、iris-derivative,GLES)都是纯 GPU 内容、store 为空。读 GPU 图像才对。只有确实需要拉取协议时才回来问用户,此处不需要。 | p9/w2 包(`Managers.cpp`、`MGPipeCallbacks.h`、`TextureRemintPullScenario`) |
|
||||
| ID-P9-7 | 2026-09-29 | W4 不做:`OnBufferWriteback` 批处理 / epoch 排序、`OnGpuWritten` 收窄都没有实测需求。普查全语料 0 错误事件、0 环满阻塞、0 丢弃;唯一的大量是 Magma 在 create-indirect 第 1 帧发 7,093 条整 buffer 的 `OnGpuWritten`(client 自己已标同一批 buffer,Espryt 同 trace 为 0),冗余但无害,记为债。 | 交接 §3 W4:只有事件量在某个负载里成为问题才做。 | `DEBTS.md` |
|
||||
| ID-P9-8 | 2026-09-29 | W2 普查查出 monolith Espryt 重铸用陈旧 / 零的 client 纹素覆盖 GPU 写过的级(14 例探针中 7 例错),即 P7 普查 §3 #6 未归因的 iris-derivative × DirectGLES ~26.9k px 差异。**不在 P9 修**,另开独立任务(改 pull 构建 `.text`,属 dev 线)。 | 交接 §6:不顺手修 dev 上的 bug,记成独立条目。 | 过程(独立任务) |
|
||||
| ID-P9-9 | 2026-09-29 | W3:`OnLog` 删除(零生产者、零消费者、无 `EventKind`;日志一直走控制面 `LogLine`)。转发器带级别,由 `Log()` 已收的 Android 优先级映射,`Log()` 签名不变;server 装队列 + 独立发送线程:≤WARN 1 MiB 后丢并计数、每段缺口一行流内说明;ERROR 无损、256 行/s 突发 1024、8 MiB 外合并成一行;FATAL 有界 2 s 且每次卡顿只等一次。限值为常量,不设 `MOBILEGL_IPC_*` 旋钮;计数走会话结束的一行本地日志,不进 PIPE_STATS。F2 为两例(只停控制;控制 + SEG_EVENT 都停)+ server 旋钮 `MOBILEGL_TEST_APPLY_LOG_FLOOD`。 | 交接 §3 W3 与 §4 F2;`protocol.fbs` 的 `LogLine.level` 本来就在,不必改 schema。旋钮要动配置表与 spawn 环境白名单,无实测需求。计数的家当惯例是日志行(同 `ForfeitDrops`)。 | p9/w3 包:`Transport/LogForward.{h,cpp}`、`Log.{h,cpp}`、`ServerMain.cpp`、`ControlInbox.{h,cpp}`、`ServerLoop.{h,cpp}`、`MGPipeCallbacks.h`、`LogForwardTest.cpp`、`EventForfeitPeerTest.cpp` |
|
||||
| ID-P9-10 | 2026-09-29 | W3 查出、**不在 P9 改**的两项转出为债:(1) `TCP_USER_TIMEOUT` = 5000 ms(`SocketTransport.cpp`)——客户端停读控制超过 5 s 且有待发日志字节时,内核仍会断开连接(W3 之后 apply 线程不再被卡,但会话仍会断);(2) `PublishSessionFault`(`FatalFunnel.cpp`)用阻塞写发 SessionFault,对停读的客户端会排在日志发送线程卡住的写之后最多等同样的 5 s。 | 两者都早于 W3,属于传输策略,改动需另行裁定。 | `DEBTS.md` |
|
||||
| ID-P9-11 | 2026-09-29 | `TextureRemintPullScenario` case C(immutable 纹理,GPU clear 后绑成 image)在 Espryt split 上 30 次中 3 次读到 clear 前的纹素,server 侧每个决定在通过与失败的运行里都相同;GL 不要求这里有 barrier,加 `glMemoryBarrier` 后 0/30。场景里暂钉 barrier 并注明,缺陷记为"待归因"债(疑 llvmpipe 的 compute image 读不等待光栅化)。保留路径早于 P9(c1bf7e15)。 | 不让门随机红;也不把一个没归因的现象当成修好。 | `TextureRemintPullScenario.cpp`、`DEBTS.md` |
|
||||
| ID-P9-12 | 2026-09-29 | **P9 收官**。集成头(W1 + W2 + W3)整套门:G1 符号增 0 减 0、`.text` `0xa52203`(同机 clang 22.1.6);fatal census 79、link ratchet 171、spawn parity 0、协议修订 3、wire-declines 53/53;卫生 12/12;unit 2641;integration-split / spawn / tcp 343 / 260 / 264;integration-magma-split / spawn / tcp / full-split 146 / 125 / 110 / 579;integration-gpu monolith / inproc 2301 / 2301。verify 构建(W1 头)unit / integration-verify / integration-verify-split 2626 / 1202 / 1136;主机 retrace(W1 头)230 / 236,6 项为宿主 llvmpipe JIT 崩溃(monolith 同挂)。收官审查沿用 P12:不派 agent / Codex,契约断言由集成者对照代码核过(限值、op 号、载荷大小、回调数、修订号、仿真名单)。未做真机(本阶段无真机门)。 | 交接 §5 的门列表全部通过;ROADMAP 出口门:回读场景 split 下绿、`TextureRemintPullScenario`(含无解用例 G / G3)、拉取计数逐 trace 发布(`notes/p9/W2-REMINT.md`)、两条故障注入。 | 过程 |
|
||||
@@ -0,0 +1,27 @@
|
||||
# P9 — 反向通道(已收官,2026-09-29)
|
||||
|
||||
> **2026-09-29 收官**。协议与行为:`MobileGL/MG_Remote/CONTRACT-P9.md`;裁定 [`INTEGRATOR-DECISIONS-P9.md`](INTEGRATOR-DECISIONS-P9.md)(ID-P9-1..12);包报告 [`W1-PACK-BUFFER-READBACK.md`](W1-PACK-BUFFER-READBACK.md)、[`W2-REMINT.md`](W2-REMINT.md);范围重划与交接 [`HANDOFF-P9.md`](HANDOFF-P9.md)。
|
||||
>
|
||||
> | 包 | 结果 |
|
||||
> |---|---|
|
||||
> | W1 PACK-PBO 回读 | 读进 pack buffer 走 op 82/83,client 不等、标 GPU 写过;server 经 buffer 写入口落行(两后端);UNPACK 源在 split 下先同步;F1 |
|
||||
> | W2 纹理重铸 | 不需要拉取协议:Espryt 读回驱动上存在的层 + store,Magma GPU→GPU;修"只定义未上传的层"的 Fatal;`OnTexturePullRequest` 删;`TextureRemintPullScenario` 14 例 × 两后端 × 四臂 |
|
||||
> | W3 日志分级 | 转发带级别、队列 + 发送线程:≤WARN 有损计数、ERROR 无损限速、FATAL 有界;`OnLog` 删;F2 |
|
||||
> | W4 事件量 | 不做:全语料 0 丢弃、0 阻塞(ID-P9-7) |
|
||||
> | W5 `OnGlError` 有序 | 保持 P5e 放宽,写进契约 §3 |
|
||||
>
|
||||
> 门(集成头):G1 符号增 0 减 0、`.text` 0xa52203;fatal census 79、link ratchet 171;unit、split / spawn / tcp、三条 Magma 双进程车道、integration-gpu 两臂全绿(数字见 ID-P9-12);verify 构建三车道全绿;主机 retrace 230 / 236(6 项为宿主 llvmpipe JIT 崩溃,monolith 同挂)。未做真机。
|
||||
>
|
||||
> 下面是该阶段在路线图上的原始范围与出口门(2026-09-24 从 `ROADMAP.md` 移入,原文照录)。本页保存该阶段在路线图上的完整范围与出口门(2026-09-24 从 [`ROADMAP.md`](../../../Disaggregated/ROADMAP.md) 阶段表移入,原文照录);阶段开工后,计划、裁定与报告都放在本目录。
|
||||
|
||||
## 摘要
|
||||
|
||||
- 异步 reply 语义,建立在 P6.5 的消息式 reply 之上;2 MiB reply cap 与 chunked readback(ID-47);PACK-PBO 回读 fire-and-forget(ID-57);武装剩余回调(`OnTextureWriteback`、`OnTexturePullRequest`、`OnMipLevelsGenerated`、`OnLog` 分级);`OnGlError` 有序;纹理拉取缓解 + 终止符;XFB 命名空间(`DeleteTransformFeedback`)。
|
||||
- 门:回读 / XFB 场景在 split 下绿;`TextureRemintPullScenario`;拉取计数逐 trace 发布;两条故障注入。
|
||||
|
||||
## 阶段表行(原 `ROADMAP.md`)
|
||||
|
||||
- **阶段**:**P9** 反向通道
|
||||
- **状态**:待排,**P6.5 之后**(2026-09-22 重定范围)
|
||||
- **落地什么 / 范围**:**异步 reply 语义**,机制建立在 P6.5 的消息式 reply 之上(不再造 `SEG_REPLY` slot 池——池今天就有,stream 链路会删它);2 MiB reply cap 与 chunked readback(契约 §10.2.3 从 P6 改判至此,ID-47);PACK-PBO 回读 fire-and-forget + client 侧 `MarkGpuWritten`(ID-57,P6 未做);十个回调里未武装的四个:`OnTextureWriteback`、`OnTexturePullRequest`、`OnMipLevelsGenerated`、`OnLog` 分级(`OnXfbScatterReady` 是零生产者、零消费者、无 EventKind 的死声明——随 P3b/P4b 删除,`kMGPipeCallbackCount` 10→9;`ClientSession.cpp:429`;`OnBufferWriteback` / `OnGpuWritten` / `OnSurfaceChanged` / `OnGlError` / `OnCapsInvalidated` 已武装);`OnGpuWritten` 收窄;`OnBufferWriteback` 批处理 + epoch 排序;`OnGlError` 有序(CONTRACT-P5C §4.2);纹理拉取四条缓解 + 终止符;XFB 命名空间(`DeleteTransformFeedback` 的 server 侧泄漏——按裁定无行、最后两个 class-C 之一)。~~`SEG_EVENT` 溢出策略~~ 机制已由 P5e 落地(`ARCHITECTURE.md` §11.7),剩余的"不排空对端杀宿主"归 Ph
|
||||
- **验收门 / 证据**:回读 / XFB 场景在 split 下绿;`TextureRemintPullScenario`(含无解用例);拉取计数逐 trace 发布;两条故障注入
|
||||
@@ -0,0 +1,46 @@
|
||||
# W1:读进 pack buffer 的回读不再等回复
|
||||
|
||||
> 2026-09-29。协议与行为见 `MobileGL/MG_Remote/CONTRACT-P9.md` §1、§4;裁定 `INTEGRATOR-DECISIONS-P9.md` ID-P9-1..4。本页只记为什么这样做、门与红一次的证据。
|
||||
|
||||
## 选了哪条路
|
||||
|
||||
交接 §3 W1 给了两条:(a) client 只标"GPU 写过",数据留在 server,CPU 读时惰性取回;(b) server 读完主动发 `OnBufferWriteback`。取 (a):
|
||||
|
||||
| 点 | (a) 标记 + 惰性取回 | (b) server 主动推 |
|
||||
|---|---|---|
|
||||
| client 在读的那一刻 | 不等 | 不等 |
|
||||
| 此后 CPU 读 | 一次 `resource_readback` 往返(既有路径) | 要知道"推送还在路上"并等它,另一套在飞状态 |
|
||||
| 从不读的 PBO(只作 UNPACK 源或丢弃) | 零字节过线 | 整块字节白推 |
|
||||
| 新机制 | 无:`GpuWritePending` 第 4 行 P5 就留好了,只是没接线 | 新的排序与等待 |
|
||||
|
||||
server 侧不用驱动的 PBO 读,而是读紧排像素后走 applier 的 buffer 写入口(契约 §1 server):Espryt 的 buffer 有两份存储(GL buffer 与 R-11 暂存影子),驱动写只到前者,后续从暂存影子排空的范围会把旧字节盖回;Magma 的 `ReadPixels` 本来就没有 pack 路径。走写入口两后端同形、零新后端代码。
|
||||
|
||||
## 顺带补上的洞
|
||||
|
||||
UNPACK 源读取(`glTexSubImage*` 等以 `GL_PIXEL_UNPACK_BUFFER` 为源,`GL_Texture.cpp` 8 处)直接读 client 影子、从不调 `SyncGpuWrites`。monolith 里 PBO 读完就回写影子所以无事;split 下读进 pack buffer 后立刻当 UNPACK 源上传(GPU→GPU 的常见写法)会上传旧字节。现在 split 下先同步。同一个洞以前对"着色器写过的 SSBO 当 UNPACK 源"也存在,一并关掉(monolith 不动)。
|
||||
|
||||
## 门与红一次
|
||||
|
||||
| 门 | 绿 | 红一次(怎么变红、哪条断言) |
|
||||
|---|---|---|
|
||||
| `PackBufferReadbackScenario`(6 条对等用例 × 单进程/Espryt split·spawn·tcp/Magma split·spawn·tcp) | 全绿 | 去掉 unpack 同步:`APackBufferReadFeedsAnUploadFromTheSameBuffer` 在 split 臂红(见下) |
|
||||
| 计数门 `APackBufferReadPostsNoReplyAndMarksTheBuffer`(split 臂) | 回复槽记录增量 0,标记增量 = 读次数 | `MOBILEGL_IPC_PBO_READBACK_SYNC=1`:两条计数断言都红(见下) |
|
||||
| F1 `RemoteClientControls.APackReadOwedWhenTheDeviceIsLostNeverReadsBackAsTheOldBytes` | 以 `Fatal{ReadbackDeclined, "buffer-writeback"}` 结束 | 去掉 `AwaitBufferWriteback` 的 device-lost 分支:abort 名为 `UnimplementedWritebackWait`,期望的族名找不到 → 红。(设 `MOBILEGL_IPC_PBO_READBACK_SYNC=1` 跑它**不红**:单元子进程不走 `ConfigLoader`,环境旋钮不生效;用例里的 `packReads != 1 → exit 151` 只是前提守卫。) |
|
||||
| 既有 `BandedReadbackScenario` / `PixelStoreSweepScenario`(含 PBO 用例) | 全绿 | — |
|
||||
| G1 | 增 0 减 0,`.text` 0xa52203 | — |
|
||||
| verify 构建(`MOBILEGL_PIPE_VERIFY`)unit / integration-verify / integration-verify-split | 2626 / 1202 / 1136 全绿 | — |
|
||||
| retrace(主机,39 例 × 两后端 × monolith/split/spawn,236 项) | 230 过;`iris-iterationrp-in-world` 6 项在**所有臂含 monolith**上挂于宿主 Mesa llvmpipe 的 JIT(`LLVM ERROR: Cannot select: intrinsic %llvm.x86.vcvtps2ph.256`),环境问题,与本包无关 | — |
|
||||
|
||||
红一次的原始输出:`~/w7/logs/p9/redonce.log`(WSL),摘录:
|
||||
|
||||
```
|
||||
RED (a) MOBILEGL_IPC_PBO_READBACK_SYNC=1, DirectGLES.Split + DirectVulkan.Split.Pbo:
|
||||
PackBufferReadbackScenario.cpp:440 reply-slot records: 65, expected 0
|
||||
PackBufferReadbackScenario.cpp:444 pack-buffer marks: 0, expected 5
|
||||
RED (b2) device-lost arm removed:
|
||||
MGPipe: Fatal{UnimplementedWritebackWait} - ... buffer 1 still has an outstanding GPU write ...
|
||||
RED (c) unpack sync removed, DirectGLES.{Split,Spawn,Tcp} + DirectVulkan.{Split,Spawn,Tcp}.Pbo:
|
||||
493 texels of the uploaded copy differ from the pattern, first at (0,0) (6/6 arms)
|
||||
```
|
||||
|
||||
两处临时改动从备份拷回、`git diff --stat` 只剩本包的改动、重编通过后再跑门。
|
||||
@@ -0,0 +1,101 @@
|
||||
# P9 W2:`texture-remint-pull`——重铸不需要拉取
|
||||
|
||||
> 2026-09-29,分支 `p9/w2`(基线 `ad705a73`)。交接:[`HANDOFF-P9.md`](HANDOFF-P9.md) §3 W2 / W4。
|
||||
> 裁定(集成方):采纳 A——不做拉取协议,删 `OnTexturePullRequest`;monolith Espryt 的缺陷不在 P9 修(§6 单列);W2-b 只退回 store;W4 不做(§5 只记测量)。
|
||||
|
||||
## 1. 结论
|
||||
|
||||
两个后端在 split 下重铸都只用 server 自己的字节,client 从不参与:
|
||||
|
||||
| 后端 | split | monolith |
|
||||
|---|---|---|
|
||||
| Espryt | `RequireImageBindableStorageByHandle`(`MobileGL/MG_Backend/DirectGLES/Managers.cpp:6289`,`c1bf7e15` 落地):驱动上存在的层逐层读回旧 GPU 纹理(`ReadTextureLevelTight`),pending 盒用 `StagedTextureStore` 合并后整层重放;已 immutable 且无需加宽的原样保留(keep) | 前端臂 `RequireImageBindableStorage`(`Managers.cpp:6459`)重放 client 影子 |
|
||||
| Magma | 重建带 `STORAGE` 的 VkImage,`PreserveTextureContentsOnRecreate`(`MobileGL/MG_Backend/DirectVulkan/Renderer/VkTextureManager.cpp:289`)GPU→GPU;wire 臂 `SyncWireTextureShape` 的 `preserve`(`:2254`) | 同一套(`SyncTextureResource`,`:3313`) |
|
||||
|
||||
- **只读 store 不够**:store 只有 client 上传过的字节;GPU 写过的层(渲染目标、clear、生成的 mip)在 store 里是旧的或没有。普查里 Espryt 的两次重铸都是 store 无字节的渲染目标(§4)。
|
||||
- `Fatal{UnmigratedEmulation, "texture-remint-pull"}` 的两处标记都在前端臂里,transport 下不可达(P7 与本次普查都是 0 次),随本包删除。
|
||||
|
||||
## 2. 改了什么
|
||||
|
||||
| 包 | 内容 |
|
||||
|---|---|
|
||||
| W2-a | 回读前问驱动这一层在不在、尺寸对不对(`NativeTextureLevelHasExtent`,`DirectGLES/WireTextureReadback.inc:290`,`glGetTexLevelParameteriv`)。不在:store 覆盖就重放 store,否则跳过(GL 定义为未定义内容)。修的是:在最后一次 sync 之后才定义(空数据,或空数据 + 局部上传)的层,旧代码去读它 → FBO 不完整 → `Fatal{ResourceUnavailable, "image-promotion-readback"}`,合法 GL 让会话死掉 |
|
||||
| W2-b | 驱动拒绝回读(设备上 SNORM / 16 位 norm / 无 `EXT_color_buffer_float` 的浮点不可渲染)而 store 覆盖该层 → 重放 store(= monolith 的答案),`MGLOG_W_ONCE` 带 `remint-readback-fallback`;store 也不覆盖才保留原 Fatal。测试旋钮 `MGITEST_ESPRYT_FORCE_REMINT_READBACK_FAILURE`(server 读) |
|
||||
| W2-c | 删两处 `texture-remint-pull` 标记(transport 专用的提前标记块 + 循环内标记);`PipeCatalogue.EveryUnmigratedEmulationIsNamedOnce` 5 → 4;「remint stall class」注释改写 |
|
||||
| W2-d | `TextureRemintPulls`(`trp=`)在 server 路径也计:ByHandle 重铸已有存储时 +1(keep 不计),名字不改 |
|
||||
| W2-e | 删 `OnTexturePullRequest`,`kMGPipeCallbackCount` 9 → 8;op 50 `ResourceSubDataComplete` 留作退役行(解码仍拒收),不改 `protocol.fbs` |
|
||||
| W2-f/g | `TextureRemintPullScenario`:14 例 × 两后端 × {monolith, Split, Spawn, Tcp};另有 `DirectGLES.{Split,Spawn}.RemintFallback.` 4 例(W2-b 旋钮,tcp 不带,理由同 `MAGMA_SERVER_ENV_KNOB_NO_TCP`) |
|
||||
|
||||
没改:Magma 无功能改动;`MOBILEGL_PIPE_TEXEL_RETAIN_MB`(`Config.h:400-403`)已无消费者但不在 PUSH 守卫内,删它动 pull 的 `Features` / `ConfigLoader`(G1),留到 P13。
|
||||
|
||||
## 3. 覆盖矩阵(场景 14 例)
|
||||
|
||||
内容 → 采样 draw(让后端持有存储)→(按例)GPU 写 → `glBindImageTexture` → compute `imageLoad` 拷到一张「sync 之前就 image 绑定」的 RGBA8 → FBO 回读,比 GL 正确答案。
|
||||
|
||||
| 例 | 内容来源 | store | 驱动上的层 | Espryt mono / pull | Espryt split / spawn / tcp | Magma 全部臂 |
|
||||
|---|---|---|---|---|---|---|
|
||||
| A 可变,上传 | 上传 | 有,= GPU | 有 | ✓ | ✓ | ✓ |
|
||||
| B 可变,上传 → GPU clear | GPU | 旧 | 有 | **✗ 旧影子** | ✓ | ✓ |
|
||||
| C immutable RGBA8,上传 → clear | GPU | 旧 | 有 | **✗** | ✓(keep) | ✓ |
|
||||
| D 空定义 → clear | GPU | 无 | 有 | **✗ 零** | ✓ | ✓ |
|
||||
| E clear → 未 sync 的局部上传 | GPU + 盒 | 盒 | 有 | **✗** | ✓(合并) | ✓ |
|
||||
| F `glGenerateMipmap` 的 level 1 | GPU | 无 | 有 | **✗ 零** | ✓ | ✓ |
|
||||
| F2 上传的 level 1 → clear | GPU | 旧 | 有 | **✗** | ✓ | ✓ |
|
||||
| G sync 后空定义 level 1,绑 level 0 | — | 无 | **无** | ✓ | ✓(W2-a 前 Fatal) | ✓ |
|
||||
| G2 sync 后以更大尺寸空定义 level 0 | — | 无 | 旧尺寸 | 不 Fatal | 不 Fatal | 不 Fatal |
|
||||
| G3 G + 局部上传,绑 level 1 | 上传 | 整层 | **无** | ✓ | ✓(W2-a 前 Fatal) | ✓ |
|
||||
| H 加宽 rg8 immutable,上传 → clear | GPU | 旧 | 有 | **✗** | ✓(promote) | ✓ |
|
||||
| H2 / I / J 加宽 rg8 / RGBA8_SNORM / RGBA16_SNORM,仅上传 | 上传 | 有 | 有 | ✓ | ✓ | ✓ |
|
||||
|
||||
「谁都没有字节」只剩 G / G3,而那里 GL 不要求字节(G)或字节就在 store(G3)。Espryt 重铸代价:一次 `glFinish` + 逐层回读 + 整层重传,主机 0.3–6.5 ms / 次;GPU→GPU 是优化,只记录。
|
||||
|
||||
## 4. 普查(主机 lavapipe/llvmpipe,77 行 × {monolith, inproc} = 154 次,`MOBILEGL_PIPE_STATS=1`)
|
||||
|
||||
口径同 P7 E1(CI 旋钮、每条单独 `ctest`、`-j 2`);154 次 rc 全 0、`Fatal{` 0 行。只有下表非零,其余 71 行全零:
|
||||
|
||||
| case | 后端 | monolith 重铸已有存储(`trp`) | split | mono / split SSIM |
|
||||
|---|---|---|---|---|
|
||||
| `iris-photon-v1.3b` | GLES | 1,RGBA16F 1 层,GPU ≠ 影子 | promote 1,回读 165,888 B,store 无字节,0.3 ms | 0.998774617 / 同(纹理随后被整张覆盖) |
|
||||
| `iris-derivative` | GLES | 1,RGBA16F 1 层,GPU ≠ 影子 | promote 1,回读 3,279,360 B,store 无字节,6.5 ms | **0.996196552 / 0.996376198**(§6) |
|
||||
| `create-indirect` | GLES | 0(首次分配,9 层) | 0(首次分配) | 0.999961275 / 同 |
|
||||
| `iris-photon-v1.3b` / `iris-derivative` / `iris-iterationrp` | Vulkan | STORAGE 升级 1 / 1 / 4 | 1 / 1 / 5 | 全 `preserve`(GPU→GPU) |
|
||||
|
||||
与 P4a 的「780 个统计窗口 2 次」同两条 trace。测量用的是临时插桩(未提交),跑器与原始数据在 `~/w7/notes/p9/w2census/`。
|
||||
|
||||
## 5. W4:反向通道事件量(inproc,server 侧逐事件计,同一次普查)
|
||||
|
||||
| 量 | 读数 |
|
||||
|---|---|
|
||||
| `OnBufferWriteback` | 只有 `create-indirect`:两后端各 6 片、7,180 B,最大单片 6,656 B(上限 SEG_EVENT / 4 = 64 KiB) |
|
||||
| `OnGpuWritten` | 只有 `create-indirect` × Vulkan:7,093 条(每条 1 个 whole-buffer range,几乎全在第一帧);Espryt 同 trace 0 条 |
|
||||
| `OnGlError` / 阻塞(ring 满)/ 丢弃 | 0 / 0 / 0 |
|
||||
|
||||
Magma 的 7,093 条是冗余的:transport 臂每次 draw / dispatch 对每个可写 SSBO / texel buffer / XFB 目标发一条 whole-buffer `OnGpuWritten`(`VkBufferManager.cpp` 的 `MarkWireBufferGpuWritten`),而 client 早已按同一组绑定自标保守集(`MG_Remote/Client/GpuWritePending.h`);Espryt 的同名生产者 P5e fb 已在 transport 下删掉。**裁定:没有阻塞、没有丢弃 = 没有实测需求,不做。** 以后要做,改动是「transport 下只保留 server 簿记、不发事件」。今天没有逐 EventKind 的计数器,`eventDropped` 也不进 stats 行。
|
||||
|
||||
## 6. dev 缺陷:monolith Espryt 重铸重放过期影子(不在 P9 修,单独立项)
|
||||
|
||||
> **2026-09-29 已修**:dev `568090f0`(重铸前先把驱动上的各层读回影子,immutable 且无需加宽的分配直接保留),P11 合并进本线(`notes/p11/INTEGRATOR-DECISIONS-P11.md` ID-P11-6);`TextureRemintPullScenario` 对 monolith DirectGLES 的 7 例 skip 已撤,iris-derivative 的 monolith SSIM 0.996196817 → 0.996376498,与 split 各臂相同。下文是当时的记录。
|
||||
|
||||
- **一句话原因**:前端臂 `RequireImageBindableStorage`(`Managers.cpp:6459`)把每个已定义层标脏、从 client `MipmapStorage` 重放进新 carrier,而影子从没见过 GPU 写的内容(渲染目标、clear、`glGenerateMipmap` 的层、`imageStore`);immutable RGBA8 也走这条(monolith 没有 split 的 keep)。
|
||||
- **复现**:本场景的 B、C、D、E、F、F2、H 在 `DirectGLES.TextureRemintPullScenario.*`(monolith)和 pull 构建(`build-linux`)逐例同错(B:读到上传的图案而不是 clear 的绿;D、F:读到零)。Magma 两臂全对。场景对 monolith DirectGLES 这 7 例按名 skip,理由指向本节。
|
||||
- **真实证据**:`iris-derivative` × DirectGLES,P7 普查 §3 #6 那个「未归因」的 ~26.9k px 系统差。monolith 在该 trace 重铸一张 854×480 RGBA16F(GPU ≠ 影子);把前端臂改成重放 GPU 字节(临时实验)后 monolith 的 `actual.png` 与 split 逐字节相同(sha `ebbe8e9d…`),SSIM 0.996196552 → 0.996376198(更近 golden)。`iris-photon-v1.3b` 同样重铸一次,但纹理随后被整张覆盖,无可见差。
|
||||
- **建议修法**:前端臂在重放前,对 `hadBackendStorage` 且无 pending 的层从旧驱动纹理读回(Espryt 已有同一把工具 `ReadTextureLevelTight`,目前只编进 `MOBILEGL_BUILD_DISAGGREGATED`)写进影子再重放;或更干净地学 Magma:`glCopyImageSubData` / 着色器拷贝 GPU→GPU,影子不参与。
|
||||
- **G1**:函数主体是 pull 构建共用代码;任何修法都会动 pull 的 `.text`(`ReadTextureLevelTight` 还得搬出 disaggregated 守卫)。按规矩在 dev 上单独修,不在 P9。
|
||||
|
||||
## 7. 未决 / 观察
|
||||
|
||||
- **keep 路径的一个排序缺口(非重铸问题)**:C 在 Espryt split 上不加 barrier 时 30 次里 3 次读到 clear 之前的纹素(加 `glMemoryBarrier(GL_ALL_BARRIER_BITS)` 后 0 / 30),失败与通过两种运行里 server 的每个同步决定完全一样(临时日志:keep、无 regen、无上传)。GL 不要求 framebuffer 写之后、imageLoad 之前加 barrier;promote 路径因 `glFinish` 回读被串行化,所以只有 keep 暴露。怀疑 llvmpipe 的 compute image 读没有等待挂起的光栅场景,未归因。场景在 dispatch 前加了 barrier(注释写明),这件事单独记。
|
||||
- **设备格式风险**:Adreno 830 上 SNORM 等格式的回读是否被拒没测(本包不碰设备);W2-b 让这种情况退回 store,只有「GPU 写过 + 不可读 + store 无字节」才 Fatal。
|
||||
- 多重采样:`ReadTextureLevelTight` 对 MS 直接失败;ES 没有 MS image 单元,只有「MS + 需加宽 + 已有存储」才进 promote。理论可达,没见过。
|
||||
|
||||
## 8. 门与 red-once(R-16)
|
||||
|
||||
| 门 | 红的方式(临时改动,已还原,真跑过) | 结果 |
|
||||
|---|---|---|
|
||||
| G:`ALevelDefinedWithoutDataAfterTheLastSyncDoesNotEndTheSession` | 去掉 W2-a 检查 | Split / Spawn / Tcp 3 / 3 `Subprocess aborted` |
|
||||
| G3:`APartialUploadIntoALevelDefinedAfterTheLastSyncReachesTheImage` | W2-a 与 W2-b 一起去掉(G3 被两者各自兜住) | 3 / 3 aborted(G 同) |
|
||||
| `RemintFallback.*`(W2-b) | 退路改回 Fatal | 8 / 8 aborted |
|
||||
| `trp=`(W2-d) | 删 server 路径的 +1 | inproc 上 A、H 红,C(keep)保持绿 |
|
||||
| Espryt 读 GPU 是承重的 | 不改代码,整组 split 场景带 `MGITEST_ESPRYT_FORCE_REMINT_READBACK_FAILURE=1`(= 只读 store) | B、E、F2、H 读到旧字节,D、F aborted(store 无字节);C(keep)、A、G、G2、G3、H2、I、J 绿 |
|
||||
| Magma 的 GPU→GPU 保留 | 两臂 `preserve` 恒 false | 4 臂 × 12 例红(G2、G3 除外) |
|
||||
| 回调数、名单 | `static_assert` + `PipeCatalogue.ReverseChannelHasTenCallbacks`(断言 8)、`EveryUnmigratedEmulationIsNamedOnce`(断言 4) | 编译期 / 名单钉 |
|
||||
Reference in New Issue
Block a user