Repository navigation
Experimental build based on Mesa (main branch).
Not officially supported — do not report issues to Mesa upstream.
Support
- Need help? https://t.me/vauzi_17
Driver Variants
- Regular / Universal (
Turnip-710-720-722-v4.6.zip):
Universal build based directly on upstream Mesa for broad compatibility across different emulators and native applications. - Switch (
Turnip-710-720-722-v4.6-sw.zip):
Specifically tuned and optimized for Nintendo Switch emulators (Eden, etc.) on Adreno 7xx and 8xx. - Winlator (
Turnip-710-720-722-v4.6-win.zip):
Specifically tuned and optimized for Winlator and Windows/DirectX emulation environments on Android.
Environment Configuration (default_env.conf) (Optional)
Download: default_env.conf
File Placement
Save the downloaded default_env.conf file to:
- Per-App Storage:
/sdcard/Android/data/<package_name>/files/default_env.conf- Eden:
/sdcard/Android/data/<package_name>/files/default_env.conf - Winlator:
/sdcard/Android/data/com.winlator/files/default_env.conf
- Eden:
- Global Fallback:
/sdcard/default_env.conf
Note: Settings already active by default in the driver are commented out with
#. You only need to remove the#or adjust the value if you want to override the driver's default behavior.
Build Info
| Mesa | 27.0.0-devel |
| Mesa commit | 6384fd603787 (2026-11-08) |
| Vulkan | 1.4.367 |
| Android NDK | r29 |
| Build date | 2026-11-08 |
Applied Patches
Regular / Universal (Upstream)
01-u_gralloc-always-use-ubwc-detection.patch— u_gralloc: always use the UBWC detection path
Switch (SW)
01-u_gralloc-always-use-ubwc-detection.patch— u_gralloc: always use the UBWC detection path06-a8xx-cube-coord-sanitize.patch— ir3: Sanitize cube map directions on A8XX07-a8xx-kgsl-ib-vbo-alias.patch— tu/kgsl: Fetch A8XX command streams through a virtual BO08-tu-kgsl-cache-retired-a8xx-ib-storage.patch— tu/kgsl: Cache retired A8XX IB storage09-tu-ir3-subgroup-half-warp.patch— tu,ir3: Support a required subgroup size of half a wave11-wn-fix-a8xx-dev-info.py— Idempotent fixup for freedreno_dev_info.h and tu_cmd_buffer.cc12-wn-apply-a8xx-gpus.py— WN-Turnip A8xx GPU support applicator for freedreno_devices.py14-wn-apply-a7xx-gen2-ubwc-hint.py— WN-Turnip A7xx_gen2 UI-corruption fix for FD740 / Adreno X1-8515-wn-add-aimapper-gralloc.py— Add the IMapper5 stable-C gralloc backend (SP-HAL loaded) to Mesa16-wn-add-ubwc-swapchain-usage.py— Request UBWC-compressed swapchain buffers on Adreno17-wn-apply-perf-variant.py— Apply aggressive autotune and variant-specific GPU clock forcing for performance18-wn-a8xx-shared-mem.py— Robust equivalent of whitebelyash/mesa-unified turnip/gen8 commit20-default-env.py— Built-in default environment variables for Turnip with app override support30-tu-z-mutable.py— Turnip-Z port: keep MUTABLE_FORMAT images tiled (and UBWC) on all GPUs31-tu-z-lrz-rescue.py— Turnip-Z port: LRZ rescue on in-render-pass depth clears32-tu-z-texfast.py— Turnip-Z port: cheaper texture sampling33-tu-z-bgra-swap.py— Turnip-Z port: real color swap for B8G8R8A8 on tiled images36-tu-z-sysmem-only.py— Turnip-Z port: force sysmem rendering, and keep the bin-restore preamble37-tu-z-bgra-companion.py— Turnip-Z port: BGRA8 companion changes with multi-mode color swap support40-fd710-blob.py— FD710: consolidated hardware property and register tuning from Adreno 710 blob analysis (V@0615)48-a8xx-lrz-color-mask.py— A8xx: Emit GRAS_LRZ_COLOR_COMP_MASK (0x810c) in blend dynamic state50-fd720-blob.py— FD720: register tuning from Adreno 720 blob analysis (V@0676)51-fd810-blob.py— FD810: unified Adreno 810 hardware tuning from Vulkan blob trace analysis (V@0800.74)52-a8xx-resolve-cr-cntl.py— A8XX: Emit REG_A8XX_RB_RESOLVE_CR_CNTL=1 in preamble magic registers53-a8xx-lrz-bidir-disable.py— A8XX: Set FORCE_BI_DIR_LRZ_DISABLE in sysmem and disabled LRZ render passes54-a8xx-sp-hysteresis.py— A8XX: Initialize Shader Processor hysteresis thresholds in context preamble56-fd722-blob.py— FD722: register tuning and hardware properties for Adreno 722 from Qualcomm blob analysis (chip_id 0x43020100)60-tu-sysmem-wfi-relax.py— Relax subpass slice wait from WFI to WAIT_FOR_ME in sysmem mode61-tu-lrz-fs-sideeffects-no-invalidate.py— Preserve LRZ state across draws when fragment shader has side effects62-tu-draw-state-skip-identical.py— Avoid redundant dynamic draw state packet emission63-ir3-sched-prefer-lower-live.py— Prioritize instructions with lower live register effect during pressure growth65-tu-z-shader-cache.py— Turnip-Z port: optional on-disk shader cache for Android emulators
Winlator / Windows (WIN)
01-u_gralloc-always-use-ubwc-detection.patch— u_gralloc: always use the UBWC detection path06-a8xx-cube-coord-sanitize.patch— ir3: Sanitize cube map directions on A8XX07-a8xx-kgsl-ib-vbo-alias.patch— tu/kgsl: Fetch A8XX command streams through a virtual BO08-tu-kgsl-cache-retired-a8xx-ib-storage.patch— tu/kgsl: Cache retired A8XX IB storage09-tu-ir3-subgroup-half-warp.patch— tu,ir3: Support a required subgroup size of half a wave11-wn-fix-a8xx-dev-info.py— Idempotent fixup for freedreno_dev_info.h and tu_cmd_buffer.cc12-wn-apply-a8xx-gpus.py— WN-Turnip A8xx GPU support applicator for freedreno_devices.py14-wn-apply-a7xx-gen2-ubwc-hint.py— WN-Turnip A7xx_gen2 UI-corruption fix for FD740 / Adreno X1-8515-wn-add-aimapper-gralloc.py— Add the IMapper5 stable-C gralloc backend (SP-HAL loaded) to Mesa16-wn-add-ubwc-swapchain-usage.py— Request UBWC-compressed swapchain buffers on Adreno17-wn-apply-perf-variant.py— Apply aggressive autotune and variant-specific GPU clock forcing for performance18-wn-a8xx-shared-mem.py— Robust equivalent of whitebelyash/mesa-unified turnip/gen8 commit20-default-env.py— Built-in default environment variables for Turnip with app override support32-tu-z-texfast.py— Turnip-Z port: cheaper texture sampling40-fd710-blob.py— FD710: consolidated hardware property and register tuning from Adreno 710 blob analysis (V@0615)48-a8xx-lrz-color-mask.py— A8xx: Emit GRAS_LRZ_COLOR_COMP_MASK (0x810c) in blend dynamic state50-fd720-blob.py— FD720: register tuning from Adreno 720 blob analysis (V@0676)51-fd810-blob.py— FD810: unified Adreno 810 hardware tuning from Vulkan blob trace analysis (V@0800.74)56-fd722-blob.py— FD722: register tuning and hardware properties for Adreno 722 from Qualcomm blob analysis (chip_id 0x43020100)60-tu-sysmem-wfi-relax.py— Relax subpass slice wait from WFI to WAIT_FOR_ME in sysmem mode61-tu-lrz-fs-sideeffects-no-invalidate.py— Preserve LRZ state across draws when fragment shader has side effects62-tu-draw-state-skip-identical.py— Avoid redundant dynamic draw state packet emission63-ir3-sched-prefer-lower-live.py— Prioritize instructions with lower live register effect during pressure growth7c14092ffb50622f78f9c466d92f2a6c0fce71a7.patch— ir3: Only prefetch UBO descriptorsec5a9a6d86133c45d3e42bd3583ba3ad9572c3a2.patch— ir3: Remove texture descriptor prefetch supporttu-sample-shading-gate.patch— tu: only force per-sample interpolation for shaders that use it
Upstream Freedreno Changes Since 4.5
58 commits under src/freedreno, grouped by commit title.
A7xx (3)
b492b11ecffreedreno/ci: drop the fixed a702 uniform texel buffer barrier tests8c589b897bfreedreno: Fix the A722 CCU count2fae1d0db8tu: Add QCTDD08049535_numnonposvar_alignment for a7xx gen1/gen2
Turnip (tu) (9)
0f5ba03ea0tu: use pBindings order for binding flags and mutable type listsc8c572b018tu: Fix software multiview with indirect drawse1852a339btu/lrz: Align LRZ pitch to 32 instead of 64 on A8XX2ce86eedc5tu/lrz: Fix partial LRZ fast-clear on A8XXce116a018etu: Drop CCU depth invalidation on occlusion query end31f1ceddfftu/kgsl: Force 8-channel macrotile mode on A635bf187f7617tu: use VK_USE_PLATFORM_ANDROID_KHR when applicable34d9ed80fctu/ci: Update trace checksums for non-visible changes.c99d3b50f7tu: Have GL behavior for primitive generated query
Compiler (ir3) (10)
292c86ab26ir3/validate: validate SSA dominance05ff917628ir3: rename is_sat_compatible to sat_is_fsat5a9db0be64ir3: only fold fsat to (sat) on cat2/3 float instructions87afb02bc7ir3: move is_cat[23]_float helper up in their file1e4254967air3: Allow (neg) copy propagation into some more bit ops on 6xx+.8eda1cc036ir3: Add support for copy-propagating BNOT into src mods.1e24fd20a9ir3: Give is_same_type_mov() an option to allow src mods or not.222377b38bir3: Reject BNOT as a src flag on cat4 instructions.1eb4fe36e7ir3: Correct the IR3_REG_BNOT flags support.10839580a9ir3: Add support for (not) as a source modifier name.
Other (36)
c0235eff65freedreno/a5xx: program the 2D source and use BLIT_OP_SCALEa5c42c0810freedreno/a5xx: convert 2D blits through the right intermediate formatba27232935freedreno/registers: make the 2D blit ifmt enums common2648b2059ffreedreno/a5xx: program the guard band and ignore the viewport clip codes455cdd824dfreedreno/a5xx: Program the stream output buffer stride644e6dfa1cvulkan: sort per-binding pNext data in vk_create_sorted_bindingsd520ae902efreedreno/ir3: Lower FP32 to FP16 for subnormals5b2db4b8e3freedreno/fdl: Use NUM_ELEMENTS for A8XX buffer descriptors1f9c4d529ffreedreno : Take only in fence as a hint for explicit sync67d8fb7fa5ci/deqp: Update VK CTS to 1.4.7.03d167c0824freedreno/a3xx: deal with VS which does not write position.9e87a244c0freedreno/ci: drop a530 flakes that no longer reproduce24ba64c445freedreno/ci: drop the a530 builtin_functions.precision flakes2a93c60bbffreedreno/ci: drop the stale a530 atomic_counter flakes9c82a78f18freedreno: Match FD735 regardless of the speed bin fusefda56c9dc2vulkan: Always compute sourface_area/2837ab0e307freedreno/decode : Add new test for crashdec with devcore dump with mempoole00d0427c8freedreno/crashdec: Use CP_MEM_POOL_SIZE as a layout hint5be22f37e4freedreno/crashdec: Detect the mempool layout598f119b8ffreedreno/crashdec: Pass the mempool dump size downf498517c72freedreno/crashdec: Bound the mempool queue walka52a42bfa6freedreno/crashdec: Split out walk_queue()0dea41cf03freedreno/crashdec: Put the mempool layouts in a table8b5e7e425afreedreno/crashdec: Move mempool types to file scopedc085ea932freedreno/crashdec: Add bound checks for cffdec20cfa4817bfreedreno/crashdec: Start a new section per cluster bankd8a7cbcfc2freedreno/crashdec: Add a6xx cluster/shader/debugbus ids10256f70e3freedreno/crashdec: Walk nested IBs for the snapshota226b30da9freedreno/crashdec: Clamp IB size to what was capturedd39c5aa992freedreno/crashdec: Harden parse_ibs()70d079b4c9freedreno/crashdec: Raise the snapshot BO size limit73ed52f0a7freedreno/crashdec: Don't assert on too many IBsc49996a75efreedreno/crashdec: Add reg_buf_push()5529e5011efreedreno/crashdec: Fill in the snapshot comm fieldb78f8149d0freedreno/crashdec: Fix time parsinge7371b0711freedreno: Record the batch's write when a query ends
GPU Support
Supports all GPUs currently supported by Mesa, including Adreno 6xx, 7xx, and 8xx series.
For the complete and up-to-date device list, see:
https://gitlab.freedesktop.org/mesa/mesa/-/blob/main/src/freedreno/common/freedreno_devices.py
Notes
- Graphics issues may still occur depending on the game or emulator.
- Performance and compatibility vary by device, firmware, emulator version, and game.
- Recommended memory mode: sysmem (
TU_DEBUG=sysmem). - Experimental build.
Credits
Special thanks to whitebelyash, Leb-Sun, Max Jividen (MaxsTechReview), Alex Sanz (AlexSanz0902), Dhruv Mark Collins, Hugo223, and StevenMX