为什么换用Timeline同步?Adreno-Tools-Drivers的vk_sync_timeline补丁原理全解

原创2026-10-16 11:51:351,963 阅读

为什么换用Timeline同步?Adreno-Tools-Drivers的vk_sync_timeline补丁原理全解

Adreno-Tools-Drivers 是一个自动构建 Mesa Turnip(Adreno 开源 Vulkan 驱动) 并打包为 adrenotool 安装包的开源项目,它内置的 vk_sync_timeline 补丁将驱动同步机制从传统二进制信号量升级为 Timeline 同步。本文面向新手,用通俗的方式讲清楚:为什么要换 Timeline 同步、vk_sync_timeline 补丁的分层原理,以及它与 KGSL 内核侧补丁如何配合工作。

一、先认识 Adreno-Tools-Drivers:Turnip 驱动的自动流水线

如果你用的是高通骁龙 Adreno GPU 的安卓设备,原生只能跑闭源 Vulkan 驱动。Mesa 社区开源的 Turnip(freedreno 驱动的 Vulkan 部分)是替代方案,而 Adreno-Tools-Drivers 解决的就是"怎么把它编译出来"的问题。

整个仓库结构非常精简:

文件 作用
build_turnip.sh 核心构建脚本:克隆 Mesa、打补丁、用 Android NDK 交叉编译出 libvulkan_freedreno.so
tu8_kgsl_26.patch 针对 Kernel 6.x + KGSL 的 26 个补丁集(UBWC_5/6 支持、gralloc 修复等)
39751.patch 本文主角配套:KGSL Timeline 队列提交与同步原语集成
patches/vk_sync_timeline.patch 本文主角:运行时层 Timeline 同步通用实现
patches/quest3.patch 修复 Quest 3 设备 GPU ID 识别问题
patches/force_sysmem_no_autotuner.patch 强制使用 sysmem 渲染路径
patches/tu_gen8_clean.patch / tu_gen8.patch Gen8(Adreno 800 系)适配补丁

构建流程可以概括为一句话:克隆 Mesa 主分支 → 应用 tu8_kgsl_26.patch → 用 android-ndk-r29 交叉编译 → 打包成 mesa-turnip-main-V1.0.zip(内含驱动库和 meta.json,minApi 为 28)。项目通过 CI 每两周发布一次,普通用户只需下载 zip 用 adrenotool 安装即可。

二、为什么换用 Timeline 同步?先看懂二进制同步的痛点

在深入补丁之前,先建立直觉。Vulkan 里 CPU 和 GPU 是异步的:CPU 把命令"丢"给 GPU 后就返回了,怎么知道 GPU 干完活了?靠同步对象。

传统做法是二进制同步(binary semaphore / fence / syncobj),它像一个只有"未完成/已完成"两档的电灯开关:

  • 一次提交要等 3 个前序任务完成?需要 3 个独立对象分别等待
  • 等完以后对象要重置回收,高频提交下对象池容易紧张
  • CPU 侧只能逐个轮询/等待,无法"一批对象里任意一个完成就醒"

而 Timeline 同步 把对象变成一条只增不减的进度条(一个 64 位计数器):

对比维度 二进制同步(旧) Timeline 同步(新)
状态 0 或 1,两态 单调递增的数值,无限档
等待语义 "这个开关打开了吗" "进度走到 N 了吗"(N 可任意大)
多前序依赖 每依赖 1 个任务要 1 个对象 1 条 Timeline 挂多个"时间点"即可
批量等待 逐个轮询 一次 ioctl 批量 wait,支持 ANY/ALL
对象回收 必须 reset 后才能复用 时间点(point)可被 GC 回收进对象池

对 GPU 驱动来说,收益最直观的是:一次 vkQueueSubmit 的等待和信号可以用一次系统调用批量完成,省掉了大量内核对象分配和多次上下文切换——这正是高帧率游戏最敏感的部分。

三、vk_sync_timeline 补丁逐层拆解

补丁文件 patches/vk_sync_timeline.patch 提供的是 Mesa 运行时层的通用 Timeline 实现(源自 Intel 的 Mesa 社区贡献),它不依赖具体硬件,而是声明"我的点(point)由什么底层同步原语实现",上层逻辑全部复用。

3.1 核心数据结构:一条时间轴 + 两个链表

Timeline 的全部状态封装在 vk_sync_timeline_state 里,vk_sync_timeline_init 初始化时建立:

成员 含义 通俗理解
highest_past 已确认到达的最大值 进度条实际指针位置
highest_pending 已提交、可能已到达的最大值 进度条"已下单"的最远处
pending_points 待完成时间点链表(按值升序) 挂在时间轴上还没走完的里程碑
free_points 空闲时间点对象池 回收站,拿来复用不重分配

3.2 四个关键机制

① 数值只能严格递增。 vk_sync_timeline_signal_locked 中有一道硬性检查:

if (unlikely(value <= state->highest_past)) {
   return vk_device_set_lost(device, "Timeline values must only ever "
                                     "strictly increase.");
}

信号值不能等于或小于当前值,否则直接判定 device lost。这保证了时间轴语义的严谨——进度条永远不会倒流。

② 时间点对象池复用。 每个"等待 N"其实是在时间轴上挂一个 point 对象。vk_sync_timeline_alloc_point_locked 优先从 free_points 池里取现成的,用完归零(vk_sync_reset)再循环使用,避免高频提交下的频繁内存分配。

③ 垃圾回收(GC)。 vk_sync_timeline_gc_locked 按顺序扫描 pending_points:已经 signal 过的 point 就从链表摘掉、引用归零后扔回对象池;如果某个 point 还有人在等(引用数 > 1),就地停下,绝不"从等待者脚下抽走对象"。

④ 等待循环。 vk_sync_timeline_wait_locked 是 CPU 等待的核心:先查 highest_past 是否已达到目标值(达到就直接返回,零开销);没达到就找到第一个 ≥ 目标值的 pending point,释放锁后阻塞等待该 point 对应的底层原语完成,再重新拿锁推进。"无锁等待具体 point"这一步避免了持锁睡眠,是并发的关键细节。

这套实现声明的能力集在 vk_sync_timeline_get_type 中一目了然:

.features = VK_SYNC_FEATURE_TIMELINE |
            VK_SYNC_FEATURE_GPU_WAIT |
            VK_SYNC_FEATURE_CPU_WAIT |
            VK_SYNC_FEATURE_CPU_SIGNAL |
            VK_SYNC_FEATURE_WAIT_ANY |
            VK_SYNC_FEATURE_WAIT_PENDING,

翻译成人话:支持 Timeline 语义、GPU 等 CPU、CPU 等 GPU、CPU 侧直接 signal、批量等待任意一个(ANY)——正是第二章表格里的全部收益。

四、内核侧配套:39751.patch 把 Timeline 接进 KGSL

运行时层的通用 Timeline 要落地,底层 point 必须由硬件内核驱动实现。39751.patch 的第 2 个提交 tu/kgsl: use timeline-based queue and sync primitives when available 做的就是这件事:

  1. 封装 5 个 KGSL timeline ioctl:kgsl_timeline_create / destroy / signal / wait / query(见 39751.patch#L345-L414),一次 wait 可传入多个 timeline+数值批量等待,还支持 KGSL_TIMELINE_WAIT_ANY / ALL。
  2. 每个队列一条专属时间轴:队列创建时初始化 timeline 对象,每次提交 seqno 加 1,用它追踪"本次提交完成没有"。
  3. 零命令快速路径:如果这次提交既没有命令缓冲也没有 bind 操作,且所有等待的 timeline 都已到达,就直接发一个 wait + 一个 signal ioctl 收工——连一条 GPU 辅助命令都不用派发。这是二进制同步路径下做不到的极致快路径。
  4. 慢路径兜底:真正有 GPU 命令时,等待挂在第一条命令前(KGSL_CMD_SYNCPOINT_TYPE_TIMELINE),信号通过 aux 命令在 GPU 侧发出。
  5. 二进制同步被模拟在 Timeline 之上:vk_sync_binary 退化为 Timeline 的一个特例,整个驱动只维护一套底层同步机制。

💡 两个补丁的分工可以这样记:patches/vk_sync_timeline.patch 是"大脑"(运行时状态机与等待逻辑),39751.patch 是"手和脚"(真正敲给内核的 ioctl)。

五、补丁清单速查:Adreno-Tools-Drivers 有哪些补丁?

补丁 路径 解决什么问题
Timeline 同步实现 patches/vk_sync_timeline.patch 运行时层通用 Timeline 状态机
KGSL Timeline 集成 39751.patch 内核 timeline ioctl + 队列快速路径
KGSL 26 补丁集 tu8_kgsl_26.patch UBWC_5/6、gralloc modifier 修复等
Gen8 适配 tu_gen8.patch / patches/tu_gen8_clean.patch Adreno 800 系 GPU 支持
Quest 3 识别 patches/quest3.patch 修复头显芯片 ID 未注册问题
sysmem 强制渲染 patches/force_sysmem_no_autotuner.patch 关闭自动调优,稳定走 sysmem 路径

六、本地构建 Turnip 驱动:一键安装步骤

想了解补丁最终如何变成安装包,可以直接跑构建脚本:

  1. 在 Linux 环境安装依赖:git meson ninja patchelf unzip curl pip flex bison zip glslangValidator python3 patch
  2. 运行 build_turnip.sh:
bash build_turnip.sh
  1. 脚本会自动完成:下载 android-ndk-r29 → 克隆 Mesa 主分支 → 应用 tu8_kgsl_26.patch → 用 meson 交叉配置(仅编译 freedreno Vulkan 驱动,-Dvulkan-drivers=freedreno、-Dfreedreno-kmds=kgsl)→ 打包输出 mesa-turnip-main-V1.0.zip,内含 libvulkan_freedreno.so 与描述驱动版本的 meta.json。

✅ 构建产物就是 adrenotool 可直接安装的包,配合 CI 的两周发布节奏,普通用户完全无需自己编译。

七、小结:Timeline 同步带来的三个直观收益

  1. 更少对象:一条时间轴服务所有提交进度追踪,二进制同步沦为它的特例;
  2. 更快提交:零命令提交走纯 ioctl 快速路径,批量 wait/signal 一次完成;
  3. 更稳资源:point 对象池 + 有序 GC,高频帧循环下内存分配行为可预期。

这正是 patches/vk_sync_timeline.patch 与 39751.patch 在 Adreno-Tools-Drivers 里协同出现的原因——运行时与内核两侧同步升级,Turnip 在高负载场景下的调度开销才真正降了下来。想深入源码,建议从 vk_sync_timeline_wait_locked 的等待循环和 39751.patch 的快速路径两处入手,顺着 ioctl 一路读下去即可。

登录后查看全文
Adreno-Tools-Drivers