Files
MobileGL/docs/Disaggregated/design/04-reverse-channel.md
T

3.5 KiB
Raw Blame History

反向通道(原 ARCHITECTURE §8)

设计细节。设计要点与全部章节的索引见 ../ARCHITECTURE.md。章节编号沿用原 ARCHITECTURE.md,代码注释里的 ARCHITECTURE.md §N 按编号在这里找到。

8. 反向通道

8.1 MGPipeCallbacks(MG_Pipe/MGPipeCallbacks.h)

八个具名回调 + 一个正向终止符(ResourceSubDataComplete),取代后端直接 poke 前端对象的 95 个调用点(具名化是有意偏离 D8)。monolith 下直调,split 下是 SEG_EVENT 上的记录。

回调 作用
OnGlError 延迟的 GL 错误;必须对命令流有序
OnGpuWritten GPU 写过的 buffer 范围(收窄 client 保守自建的 pending 集)
OnBufferWriteback PBO 回读、XFB 捕获结果;必须与 epoch bump 有序
OnTextureWriteback CPU 回退生成 mip 的纹素
OnTexturePullRequest §8.4
OnMipLevelsGenerated 只带形状
OnSurfaceChanged 默认帧缓冲的格式与尺寸(server 拥有显示时 client 靠它得知窗口尺寸)
OnCapsInvalidated 取代 InvalidateCompileEnv

OnLog 已删除(P9 W3,回调 9 → 8):零生产者、零消费者、无 EventKind。server 日志走控制面 LogLine(带 level),由 MG_Remote/Transport/LogForward.h 的队列 + 发送线程转发:≤WARN 有损(队列满即丢、计数、流内 LogForward{Dropped} 标出缺口),≥ERROR 无损 + 限速(超速排队延迟;超出错误字节上限时合并成一条 LogForward{Coalesced}),FATAL 有界等待写出;日志线程永不等 socket。

后端凭空造的前端对象(Magma 占位纹理、swapchain 默认 FB 占位)改为 server 原生;pull 构建里的 m_backend 类成员真删会动 sizeof(G1),随 P13 退役(D-K)。

8.2 有序性是正确性要求

每次 writeback 之后的 epoch bump 必须在任何后续读该 handle 的命令之前被 server 应用。反向通道需要与正向通道相同的有序保证。

8.3 错误、ack 与日志

  • 唯一允许同步 ack 的入口是 glBufferStorage:ResourceRespecify 的 kNeedsAck 由逐记录谓词收窄到"不可变 buffer"(D-A2),纹理 OOM 在 monolith 里本来就推迟到 sync 时刻。respecify 带逐 level 作用域与"只换元数据"的形式,不误丢已接受的待上传。
  • 其余错误一律晚到,走有序的 OnGlError。

8.4 唯一的新停顿类:server 发起的纹理重铸拉取(D-B6)

server 不保留纹素;image-bindable 重铸、整格式再生、view 源重铸会要求重发 level。缓解:ImageBindableHint 预防主因;拉取异步(阻塞 apply 线程,不阻塞应用线程);保留 LRU 默认关(MOBILEGL_PIPE_TEXEL_RETAIN_MB=0);显式终止符可带零个 region。真实语料上发生率可忽略(780 个统计窗口 2 次);split 下这条路径今天仍是具名 Fatal{UnmigratedEmulation, "texture-remint-pull"},归 P9。

8.5 XFB scatter 留在 server

补丁循环需要"捕获前的字节",而拆分后权威影子归 server(StagedShadow),所以 scatter 在 server 原地跑完;回程只有一条 OnBufferWriteback,载补好的整段,按 SEG_EVENT 容量的四分之一切片(MGPipeBufferWritebackSliceBytes),最后一片落地即蕴含之前每一片。孤儿目标(HasDefinedContent == 0)零填充后照常散射。OnXfbScatterReady 已删除(回调 10 → 9)。落地论证见 notes/p34b/README.md(espryt D1)。