From 73086684880fa224fd2e0da824ff93d79dfa3a4e Mon Sep 17 00:00:00 2001 From: Swung0x48 Date: Wed, 30 Sep 2026 13:00:11 -0400 Subject: [PATCH] [Docs] (Anland): kgsl-as-server.md - read with the kernel as the server, routes A and B are about who owns the buffer (6.x + Mesa is A, 5.x is B), plus the split-level analogy to virtio-gpu native context vs virgl / venus; linked from the README --- docs/Disaggregated/notes/anland/README.md | 3 ++ .../notes/anland/kgsl-as-server.md | 47 +++++++++++++++++++ 2 files changed, 50 insertions(+) create mode 100644 docs/Disaggregated/notes/anland/kgsl-as-server.md diff --git a/docs/Disaggregated/notes/anland/README.md b/docs/Disaggregated/notes/anland/README.md index 1267511a..3300e5c3 100644 --- a/docs/Disaggregated/notes/anland/README.md +++ b/docs/Disaggregated/notes/anland/README.md @@ -6,6 +6,7 @@ |---|---| | [`report-anland.md`](report-anland.md) | Anland 侧：缓冲入口契约、伪造 AHB、同步、帧节奏、进程与 SELinux、容器 GPU 现状、Xwayland glamor、衍生项目、改动插入点（382 处引用） | | [`report-mobilegl.md`](report-mobilegl.md) | MobileGL 侧：Linux client 构建与导出、EGL / GLX 能力、split 的 present 路径、AHB / fd / fence 现状、会话与多窗口限制、GL 覆盖面、文档漂移 | +| [`kgsl-as-server.md`](kgsl-as-server.md) | 把内核 kgsl 看成 server：A / B 实为"缓冲归谁"之分，6.x + Mesa 是 A、5.x 是 B；拆分层级与 virtio-gpu native context / virgl 的对应 | | [`brief-anland.md`](brief-anland.md)、[`brief-mobilegl.md`](brief-mobilegl.md) | 派给 Codex 的原始提示词。**两份都把后端名写反了**：Espryt = DirectGLES（GLES），Magma = DirectVulkan（Vulkan）；报告已纠正 | ## 结论 @@ -66,6 +67,8 @@ B 在 6.x 没有对应物（今天只有 waylandbridge 自己往窗口 Surface 6.x 为了让原生合成器不改就能接入，换回了标准 Wayland 缓冲（A 这条路）。 +换个角度——把内核 kgsl 当 server 读这张表——见 [`kgsl-as-server.md`](kgsl-as-server.md)。 + ## 两边现状 | | MobileGL | Anland | diff --git a/docs/Disaggregated/notes/anland/kgsl-as-server.md b/docs/Disaggregated/notes/anland/kgsl-as-server.md new file mode 100644 index 00000000..36330020 --- /dev/null +++ b/docs/Disaggregated/notes/anland/kgsl-as-server.md @@ -0,0 +1,47 @@ +# 把 kgsl 看成 server：A / B 两条路线的另一种读法（2026-09-30） + +> 接 [`README.md`](README.md) 的"对照：容器里现在的 Mesa"。只读推演，没做实验；Anland 事实链到审计版本（6.x `cc169180`、5.x `9ab13eb1`）。 + +## 结论 + +A / B 的区别不在"渲染器放在哪"，而在**缓冲归谁**： + +- **A**：server 分配缓冲、画好，把句柄交给合成器。 +- **B**：窗口把自己的缓冲交给 server，server 直接画进去。 + +把内核 kgsl 当 server，Anland 两代现有路径正好各占一条：6.x + Mesa 是 A，5.x 私有协议是 B。 + +## 对照 + +| | 6.x + Mesa | 5.x 私有协议 | MobileGL A | MobileGL B | +|---|---|---|---|---| +| client | 应用进程里的完整用户态驱动（freedreno / turnip） | 合成器进程（如 KWin）里的 Mesa | 应用进程里的 GL 前端 | 同 A | +| server | 内核 kgsl | 内核 kgsl | Android 用户态进程（厂商驱动，往下仍是 kgsl / kbase） | 同 A | +| 命令通道 | ioctl + 共享 GPU 内存 | 同左 | MGPipe（共享内存环 + 门铃） | 同 A | +| 缓冲归谁 | kgsl 分配 → dma-buf 给 client → `wl_buffer` → Anland 导入（伪造 AHB） | 窗口缓冲队列分配 → `data[0]` 以 dma-buf 交给 kgsl 渲染 → 回 sync_file → Android 端 `queueBuffer` | server 用 gralloc 分配 AHB → Anland | 窗口 Surface 交给 server | +| 形状 | A | B | A | B | + +5.x 出处：[protocol.h:7–49](https://github.com/SuperTurtleDev/anland/blob/9ab13eb146bc9f3dd3cc44cabc268659d9eb0a46/common/protocol.h#L7-L49)、[native_consumer.c:144–172](https://github.com/SuperTurtleDev/anland/blob/9ab13eb146bc9f3dd3cc44cabc268659d9eb0a46/consumers/anland_v5/android_consumer/app/src/main/jni/native_consumer.c#L144-L172)、[:955–1003](https://github.com/SuperTurtleDev/anland/blob/9ab13eb146bc9f3dd3cc44cabc268659d9eb0a46/consumers/anland_v5/android_consumer/app/src/main/jni/native_consumer.c#L955-L1003)；6.x 伪造 AHB 的起因：[awl_ahb.cpp:10–14](https://github.com/SuperTurtleDev/anland/blob/cc1691805fe6aca6851b6fcccb6a1e33019026c1/services/waylandbridge/awl_ahb.cpp#L10-L14)。 + +## 读出来的三点 + +1. **B 不是新东西。** Anland 5.x 就是 B，只是 server 在内核。6.x 放弃它是为了让原生合成器不改就能接入，不是因为做不通。 + +2. **server 在内核时两条路都只需要传 fd；挪到用户态就多一层。** + - 内核对象（dma-buf fd、sync_file）任何进程都认。 + - server 是用户态进程时：A 要传完整 AHB（gralloc 元数据 + dma-buf），B 要传缓冲队列的生产端（Surface）。 + - 与现状正好相反：kgsl 句柄通用但缺 gralloc 元数据，所以 Anland 只能伪造；MobileGL server 的 AHB 本来就带元数据，Anland 只要肯收完整句柄。 + - B 也可以照 5.x 逐缓冲交接（Anland `dequeueBuffer` → 整个 AHB 交 server → 回 sync_file → Anland `queueBuffer`）；对 MobileGL 交 Surface 更省，直接复用 swapchain。 + +3. **拆分层级不同 = virtio-gpu 的 native context 对 virgl / venus。** + + | | Mesa / kgsl（拆在硬件命令层） | MobileGL（拆在 GL 状态层） | + |---|---|---| + | client 要懂什么 | 这块 GPU 的硬件命令 | 只懂 GL | + | 能覆盖的 GPU | 有开源用户态驱动的（现在只有 Adreno） | 有厂商驱动的（含 Mali） | + | 额外开销 | 几乎没有 | 状态序列化 + IPC | + +## 对 MobileGL 的启示 + +- **server 必须天然多 client**：kgsl 同时服务任意多进程、每进程独立 GPU 上下文——对应 README 的 C2（今天每 supervisor 一个会话）。 +- **fence 导出（A2）没有原理障碍**：厂商驱动导出 SYNC_FD，最终也是向 kgsl / kbase 要一个 sync_file，fence 仍是内核对象。