如何10分钟上手Adreno-Tools-Drivers:从零构建你的第一个Adreno Turnip驱动包
如何10分钟上手Adreno-Tools-Drivers:从零构建你的第一个Adreno Turnip驱动包
📦 Adreno-Tools-Drivers 是一个用于构建 Turnip 驱动的项目:它通过一个 bash 脚本,从 mesa 仓库编译出适配 Android 的 Adreno GPU 开源 Vulkan 驱动,并打包成 adrenotools 格式的驱动包。项目还会通过 GitHub Actions 每两周自动发布一次构建好的包,让普通用户也能轻松用上开源 Adreno 驱动。
🧭 为什么需要 Turnip 驱动?
Turnip 是 Mesa 中针对高通 Adreno GPU(A6xx 及以后)的开源 Vulkan 驱动。相比厂商闭源驱动,它带来这些好处:
- ✅ 完全开源,可自由编译修改
- ✅ 对较新的 Adreno GPU(如 Adreno 730/830)支持更积极
- ✅ 通过 adrenotools 应用安装,无需完整刷机
Adreno-Tools-Drivers 解决的正是"编译门槛高"的问题——你不需要深入理解 Mesa 构建系统,跑一个脚本就能拿到可直接导入的驱动包。
🗂️ 项目结构:一个脚本 + 一组补丁
整个仓库非常精简,核心就是一个构建脚本和若干针对特定芯片的补丁:
| 文件 | 作用 |
|---|---|
| build_turnip.sh | 主构建脚本,一键完成编译与打包 |
| tu8_kgsl_26.patch | Adreno 8xx(gen8)系列补丁集(10 个补丁) |
| tu_gen8.patch | gen8 支持补丁的另一个完整版本(8 个补丁) |
| patches/tu_gen8_clean.patch | 整理后的 gen8 补丁集(9 个补丁),便于阅读与回合 |
| patches/quest3.patch | 为 Quest 3 的 Adreno 740(FD740)添加芯片 ID 与属性 |
| patches/force_sysmem_no_autotuner.patch | 强制使用 sysmem 渲染路径,关闭 autotuner |
| patches/vk_sync_timeline.patch | Vulkan Sync Timeline 扩展的完整实现 |
| 39751.patch | 提取并简化 KGSL profiling / perfetto 集成逻辑 |
💡 补丁是可选的"增强件":
build_turnip.sh默认基于 mesa main 分支直接构建;如果你的芯片(如 Adreno 810/825/829/830)官方支持还不完善,就可以把tu_gen8系列补丁应用到 mesa 源码上再编译。
🛠️ 开始前的准备清单
- Linux 环境(Ubuntu 22.04+ 或 Debian 12+ 推荐)
- 构建依赖:脚本会逐项检查 build_turnip.sh 中列出的工具,缺失任意一项都会直接退出:
git meson ninja patchelf unzip curl pip flex bison zip glslangValidator python3 patch
- 网络与磁盘:脚本会自动下载
android-ndk-r29(约 1GB)并浅克隆 mesa 源码(build_turnip.sh),预留 10GB+ 空闲空间
🚀 三步构建:获取源码 → 运行脚本 → 拿到驱动包
第一步:克隆仓库
git clone https://gitcode.com/gh_mirrors/ad/Adreno-Tools-Drivers
cd Adreno-Tools-Drivers
第二步:执行构建脚本
bash build_turnip.sh
脚本会依次完成(对应 build_turnip.sh 的 run_all):
- check_deps:检查依赖并安装 Python 包
mako - prepare_workdir:下载解压 NDK r29,浅克隆 mesa 到
turnip_workdir/mesa - build_lib_for_android:打补丁 → 交叉编译 → 打包
第三步:取出 adrenotools 驱动包
构建成功后,turnip_workdir/ 目录下会生成:
mesa-turnip-main-V1.0.zip
├── libvulkan_freedreno.so # Turnip Vulkan 驱动
└── meta.json # adrenotools 元数据
其中 meta.json 声明了驱动名称(Mesa Turnip)、最低 API 等级(minApi: 28)和库文件名,这正是 adrenotools 应用识别驱动包所需的格式。
📲 将这个 zip 导入手机上的 adrenotools 应用(需要 root 权限),选择 "Turnip" 作为 Vulkan 驱动即可生效。
⚙️ 构建脚本内部做了什么?
如果你好奇 build_turnip.sh 的细节,关键流程如下:
- 源码适配:用
sed修复 mesa 中 Android stub 头文件的几处不兼容(build_turnip.sh) - 交叉编译配置:生成 meson cross-file,指定 aarch64 + Android API 36(build_turnip.sh)
- 关键构建参数(build_turnip.sh):
| 参数 | 含义 |
|---|---|
-Dvulkan-drivers=freedreno |
只编译 freedreno(Turnip)Vulkan 驱动 |
-Dfreedreno-kmds=kgsl |
使用 Android 上的 KGSL 内核接口 |
-Dandroid-stub=true |
使用 Android 桩头文件,无需完整 AOSP |
-Dvulkan-beta=true |
启用 Vulkan beta 特性 |
-Degl=disabled |
不构建 OpenGL,减小体积 |
- 产物校验:若编译产物中找不到
libvulkan_freedreno.so,脚本立即报错退出(build_turnip.sh),保证不会产出损坏的包
🧩 补丁怎么选?常见芯片对照
| 你的设备 / GPU | 推荐补丁 |
|---|---|
| Adreno 810 / 825 / 829 / 830(gen8) | tu8_kgsl_26.patch 或 patches/tu_gen8_clean.patch |
| Quest 3(Adreno 740) | patches/quest3.patch |
| 渲染异常 / 画面花屏 | 尝试 patches/force_sysmem_no_autotuner.patch 强制走 sysmem 路径 |
| 需要 Sync Timeline 扩展 | patches/vk_sync_timeline.patch |
其中 tu8_kgsl_26.patch 是最重量级的补丁集,包含:UBWC 5/6 支持、gralloc UBWC 检测修复、disable_gmem 属性(tu8_kgsl_26.patch)、Adreno 810/825/829 完整设备属性等 10 个提交,把 gen8 的"半成品"状态拉到了可用水平。
❓ 常见问题(FAQ)
Q1:脚本运行到一半直接退出了?
check_deps 采用"缺一个就退出"的严格策略(build_turnip.sh),先按 Q1 依赖清单装齐工具再重试。
Q2:构建很慢,正常吗? 正常。首次构建要下载 NDK + 完整编译 Mesa 的 freedreno 部分,通常需 20~40 分钟;但"10 分钟上手"指的是你操作的时间——脚本会全自动完成。
Q3:支持哪些设备? 凡是使用 KGSL 内核接口、GPU 属于 Adreno A6xx 及以后的设备理论上均可,包括 Adreno 7xx(710/730/740)与 8xx 系列,最低 Android 9(API 28)。
Q4:驱动导致花屏或崩溃怎么办? 开源驱动仍在快速发展中,建议:保留系统自带驱动作为回退方案(在 adrenotools 中切回即可)、重要数据提前备份、按"常见问题对照表"尝试对应补丁。
📚 延伸阅读
现在,打开终端敲下 bash build_turnip.sh,10 分钟后你就会拥有属于自己的第一个 Adreno Turnip 驱动包 🎉