Adreno 810/825/829/830全面解锁:Adreno-Tools-Drivers的Gen8补丁深度剖析
Adreno 810/825/829/830全面解锁:Adreno-Tools-Drivers的Gen8补丁深度剖析
Adreno-Tools-Drivers 是一个基于 mesa 仓库构建 Turnip(freedreno)Vulkan 驱动的自动化工具集,核心成果是整套 Gen8 补丁——它让 Adreno 810、825、829、830 这些新旗舰 GPU 首次在 Android 上跑通开源 Turnip 驱动,并以 AdrenoTool 包的形式通过 GitHub Actions 每两周自动发布。本文带你逐条剖析这些补丁解决了什么问题。
一、Adreno-Tools-Drivers 是什么:Turnip 驱动的自动打包工厂 🏭
Android 上 Adreno GPU 的开源 Vulkan 驱动是 Mesa 中的 Turnip(freedreno 后端)。但普通用户不可能自己交叉编译 Mesa,这个项目把整个流程自动化了:
- 主构建脚本 build_turnip.sh 会下载 Android NDK r29、浅克隆 mesa main 分支源码,交叉编译出
libvulkan_freedreno.so - 编译产物连同 meta.json(声明
minApi: 28、Vulkan 1.4.335)被压缩成一个 AdrenoTool 包(zip),用户装进 AdrenoTool 应用即可替换驱动 - CI 流程 .github/workflows/turnip_build.yml 定期执行脚本、自动创建 Release 并上传驱动包
mesa 源码 + NDK 交叉编译 → libvulkan_freedreno.so + meta.json → AdrenoTool zip 包
真正的技术含量在于仓库里那一堆 .patch 文件——没有它们,Turnip 根本无法识别 Gen8 芯片。
二、Gen8 补丁全景:8 个补丁各自解决什么问题 🔧
核心文件是 tu_gen8.patch,共 8 个补丁,由社区作者 whitebelyash 与 Igalia 的 Zan Dobersek 合作完成。下面按依赖顺序拆解。
2.1 补丁 1/8:UBWC 5 和 UBWC 6 支持
UBWC(Universal Bandwidth Compression)是高通的显存带宽压缩技术,直接决定渲染性能。原版 Turnip 只认识 KGSL_UBWC_4_0 及以前的版本,而 Gen8 芯片走的是更新的内核接口。补丁的思路很聪明:
"The #defines seem to map 1:1, so we can add support even without an updated kgsl uabi header."
也就是说,无需等待内核头文件更新,直接在 tu_gen8.patch 中给 case 5: case 6: 复用 KGSL_UBWC_4_0 的 8 通道宏平铺(FDL_MACROTILE_8_CHANNEL)配置,让 Gen8 的压缩带宽格式立刻可用。
2.2 补丁 2/8:花屏修复——强制走 UBWC 检测路径
这是最"救命"的补丁。Turnip 通过比对 gralloc 缓冲区里的 gmsm 魔数来判断"这块内存是否由高通厂商 gralloc 分配",从而决定设置哪种 DRM format modifier。新版 gralloc 让这个魔数比对永远失败,缓冲区拿不到正确的压缩格式标记——结果就是屏幕上出现大面积花屏。
补丁 tu_gen8.patch 干脆绕过魔数检测,直接读取 UBWC 标志位来决定 modifier。作者也坦承这是 HACK:"TODO: Actually find a way to detect a Qualcomm vendor allocated buffer"。
2.3 补丁 3/8:新增 disable_gmem 设备属性
GMEM 是 Adreno 的片上内存,渲染时能把附件留在芯片里避免反复读写内存,性能更好。但 Gen8 部分芯片的 GMEM 存在稳定性问题(后面会讲)。
补丁在 freedreno_dev_info.h 的 fd_dev_info 结构中新增了 disable_gmem 布尔属性,等效于全局设置 TU_DEBUG=sysmem——强制该 GPU 走 sysmem 渲染路径,绕开 GMEM。这是一个按芯片开关,而不是全局一刀切。
2.4 补丁 4/8:修复 A810 的 GMEM 整数下溢
一个只有 1 行改动的补丁,却非常见功力:
"On A810 this additional offset caused integer underflows because the remaining number was very small due to size of A810 GMEM cache (576K)"
A810 的 GMEM 缓存只有 576K,原有代码对所有 Gen8 芯片都额外减去 0x78000 的偏移,小缓存直接导致整数下溢。修复方式是只有 num_slices > 1(多 slice GPU)才应用该偏移,见 tu_gen8.patch。
2.5 补丁 5/8:A830 属性——上游 Igalia 的官方提交
这个补丁直接来自 Igalia 的 Zan Dobersek(Mesa 官方维护者之一),为 A830 建立了 gen1 基线属性(a8xx_gen1),并注册了两个芯片 ID:0x44050000(FD830)和 0x44050001(KGSL 版本)。同时把魔法寄存器列表重构为 a8xx_base_raw_magic_regs,让 gen1/gen2 共享,见 tu_gen8.patch。
2.6 补丁 6/8:解锁 Adreno 825
注册 FD825(chip_id 0x44030000),规格为 4 CCU / 2 slice,继承属性链 <a href="https://link.gitcode.com/i/307c110abdee248e01a4b5070cebb9a0" target="_blank">a7xx_base, a7xx_gen3, a8xx_base, a8xx_825],见 [tu_gen8.patch。
2.7 补丁 7/8:解锁 Adreno 810
A810(chip_id 0x44010000)是三者中配置最特殊的,见 tu_gen8.patch:
- 2 CCU / 1 slice,tile 对齐 64×32
has_ray_intersection = False——不支持硬件光线追踪disable_gmem = True——GMEM 会导致死锁(hangs),必须走 sysmem- sysmem 深度/颜色缓存刻意压到 32KB,注释里明确写道:"Bigger values cause an integer underflow in freedreno gmem calculations"
2.8 补丁 8/8:解锁 Adreno 829
A829 的芯片 ID 相当曲折:0x44030A00(猜测的 kgsl id)、0x44030A20(测试中发现)、0xffff44030A00 三个 ID 都注册为 FD829,见 tu_gen8.patch。作者的原话是:"Very weird GPU, ugh..",规格 4 CCU / 2 slice,同样 disable_gmem = True。
三、四款芯片关键参数对照 📊
| 芯片 | 内部代号 | chip_id | CCU / Slice | 光线追踪 | GMEM | 特点 |
|---|---|---|---|---|---|---|
| Adreno 810 | FD810 (gen8_3_0) | 0x44010000 |
2 / 1 | ❌ | 禁用(会死锁) | GMEM 仅 576K |
| Adreno 825 | FD825 (gen8_6_0) | 0x44030000 |
4 / 2 | ✅ | 可用 | 深度缓存 96K |
| Adreno 829 | FD829 | 0x44030A00 等 |
4 / 2 | ✅ | 禁用 | 芯片 ID 需多路注册 |
| Adreno 830 | FD830 (gen1) | 0x44050000 / 0x44050001 |
6 / 3 | ✅ | 禁用 | 上游 Igalia 属性 |
💡 表中信息来自 tu_gen8.patch 中各
add_gpus()定义;仓库另有一份 9 补丁版本 patches/tu_gen8_clean.patch,额外包含关闭TU_DEBUG_FLUSHALL的性能补丁(该调试项"Causes huge performance drop in real usage"),适合追求极致性能的场景。
四、配套补丁:仓库里还有哪些弹药 📦
| 文件 | 作用 |
|---|---|
| tu8_kgsl_26.patch | 10 个补丁的另一套 Gen8 方案,含 a830 属性、810/825/829 启用及 GMEM 深度缓存调整 |
| 39751.patch | 2 个上游 MR 补丁:重构 KGSL profiling 逻辑 + 引入 timeline 队列同步原语 |
| patches/vk_sync_timeline.patch | timeline 同步机制的完整源码文件,配合上一项使用 |
| patches/force_sysmem_no_autotuner.patch | 一行的"终极保命补丁":use_sysmem_rendering 直接 return true,彻底关闭 GMEM 自动调优 |
| patches/quest3.patch | 顺带解锁 Quest 3 头显(Adreno 740)的设备注册 |
其中 force_sysmem_no_autotuner.patch 对 A810/A830 用户特别实用——当遇到渲染死锁时,它就是最直接的规避手段。
五、构建与发布流程 🚀
如果你想在本地构建(需要 Linux 环境),README.md 给出的流程是:
- 获取
turnip_builder.sh脚本并在 Linux 终端执行bash ./turnip_builder.sh - 或者直接 clone 仓库:
git clone https://gitcode.com/gh_mirrors/ad/Adreno-Tools-Drivers,运行./build_turnip.sh
构建脚本的关键 meson 参数值得留意(build_turnip.sh):
-Dvulkan-drivers=freedreno+-Dfreedreno-kmds=kgsl——只构建 Turnip,且只走 KGSL(高通内核驱动)路径-Degl=disabled——纯 Vulkan 方案,不带 GLES-Dandroid-stub=true——用桩代码替代 Android 系统库,产物更干净
CI 端每两周由 turnip_build.yml 自动触发:装依赖 → 跑脚本 → 上传 Turnip-Drivers 产物 → 以 v{run_number} 打 Release 标签。
六、总结与使用建议
- 核心价值:这套 Gen8 补丁把 Adreno 810/825/829/830 从"Turnip 不认识的芯片"变成了"可正常渲染的开源驱动设备",其中 UBWC 5/6 支持和花屏修复是渲染正确性的前提,disable_gmem 是稳定性的保险
- 选型建议:A810 用户重点留意 GMEM 死锁问题,遇卡顿时优先尝试 sysmem 方案;A825 规格最均衡;A829 因芯片 ID 混乱,若驱动不识别可核对设备 ID 是否匹配 tu_gen8.patch 中的注册表
- 风险提示:补丁中多处标注
HACK/WIP/TODO,属于社区逆向 + 上游协作的产物,升级系统版本(尤其是 gralloc 行为变化)后可能出现兼容波动,建议关注仓库的周期性 Release 更新
开源驱动生态就是这样一步步"解锁"的:内核接口未更新就靠 1:1 的宏映射,魔数检测失效就强制走正确分支——每一行补丁背后都是实打实的调试。🎮