Skip to content

Turnip Adreno 710,720,722 v4.6

Latest

Choose a tag to compare

@Vauzi-17 Vauzi-17 released this 08 Nov 11:19

Experimental build based on Mesa (main branch).
Not officially supported — do not report issues to Mesa upstream.

Support


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
  • 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 path
  • 06-a8xx-cube-coord-sanitize.patch — ir3: Sanitize cube map directions on A8XX
  • 07-a8xx-kgsl-ib-vbo-alias.patch — tu/kgsl: Fetch A8XX command streams through a virtual BO
  • 08-tu-kgsl-cache-retired-a8xx-ib-storage.patch — tu/kgsl: Cache retired A8XX IB storage
  • 09-tu-ir3-subgroup-half-warp.patch — tu,ir3: Support a required subgroup size of half a wave
  • 11-wn-fix-a8xx-dev-info.py — Idempotent fixup for freedreno_dev_info.h and tu_cmd_buffer.cc
  • 12-wn-apply-a8xx-gpus.py — WN-Turnip A8xx GPU support applicator for freedreno_devices.py
  • 14-wn-apply-a7xx-gen2-ubwc-hint.py — WN-Turnip A7xx_gen2 UI-corruption fix for FD740 / Adreno X1-85
  • 15-wn-add-aimapper-gralloc.py — Add the IMapper5 stable-C gralloc backend (SP-HAL loaded) to Mesa
  • 16-wn-add-ubwc-swapchain-usage.py — Request UBWC-compressed swapchain buffers on Adreno
  • 17-wn-apply-perf-variant.py — Apply aggressive autotune and variant-specific GPU clock forcing for performance
  • 18-wn-a8xx-shared-mem.py — Robust equivalent of whitebelyash/mesa-unified turnip/gen8 commit
  • 20-default-env.py — Built-in default environment variables for Turnip with app override support
  • 30-tu-z-mutable.py — Turnip-Z port: keep MUTABLE_FORMAT images tiled (and UBWC) on all GPUs
  • 31-tu-z-lrz-rescue.py — Turnip-Z port: LRZ rescue on in-render-pass depth clears
  • 32-tu-z-texfast.py — Turnip-Z port: cheaper texture sampling
  • 33-tu-z-bgra-swap.py — Turnip-Z port: real color swap for B8G8R8A8 on tiled images
  • 36-tu-z-sysmem-only.py — Turnip-Z port: force sysmem rendering, and keep the bin-restore preamble
  • 37-tu-z-bgra-companion.py — Turnip-Z port: BGRA8 companion changes with multi-mode color swap support
  • 40-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 state
  • 50-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 registers
  • 53-a8xx-lrz-bidir-disable.py — A8XX: Set FORCE_BI_DIR_LRZ_DISABLE in sysmem and disabled LRZ render passes
  • 54-a8xx-sp-hysteresis.py — A8XX: Initialize Shader Processor hysteresis thresholds in context preamble
  • 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 mode
  • 61-tu-lrz-fs-sideeffects-no-invalidate.py — Preserve LRZ state across draws when fragment shader has side effects
  • 62-tu-draw-state-skip-identical.py — Avoid redundant dynamic draw state packet emission
  • 63-ir3-sched-prefer-lower-live.py — Prioritize instructions with lower live register effect during pressure growth
  • 65-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 path
  • 06-a8xx-cube-coord-sanitize.patch — ir3: Sanitize cube map directions on A8XX
  • 07-a8xx-kgsl-ib-vbo-alias.patch — tu/kgsl: Fetch A8XX command streams through a virtual BO
  • 08-tu-kgsl-cache-retired-a8xx-ib-storage.patch — tu/kgsl: Cache retired A8XX IB storage
  • 09-tu-ir3-subgroup-half-warp.patch — tu,ir3: Support a required subgroup size of half a wave
  • 11-wn-fix-a8xx-dev-info.py — Idempotent fixup for freedreno_dev_info.h and tu_cmd_buffer.cc
  • 12-wn-apply-a8xx-gpus.py — WN-Turnip A8xx GPU support applicator for freedreno_devices.py
  • 14-wn-apply-a7xx-gen2-ubwc-hint.py — WN-Turnip A7xx_gen2 UI-corruption fix for FD740 / Adreno X1-85
  • 15-wn-add-aimapper-gralloc.py — Add the IMapper5 stable-C gralloc backend (SP-HAL loaded) to Mesa
  • 16-wn-add-ubwc-swapchain-usage.py — Request UBWC-compressed swapchain buffers on Adreno
  • 17-wn-apply-perf-variant.py — Apply aggressive autotune and variant-specific GPU clock forcing for performance
  • 18-wn-a8xx-shared-mem.py — Robust equivalent of whitebelyash/mesa-unified turnip/gen8 commit
  • 20-default-env.py — Built-in default environment variables for Turnip with app override support
  • 32-tu-z-texfast.py — Turnip-Z port: cheaper texture sampling
  • 40-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 state
  • 50-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 mode
  • 61-tu-lrz-fs-sideeffects-no-invalidate.py — Preserve LRZ state across draws when fragment shader has side effects
  • 62-tu-draw-state-skip-identical.py — Avoid redundant dynamic draw state packet emission
  • 63-ir3-sched-prefer-lower-live.py — Prioritize instructions with lower live register effect during pressure growth
  • 7c14092ffb50622f78f9c466d92f2a6c0fce71a7.patch — ir3: Only prefetch UBO descriptors
  • ec5a9a6d86133c45d3e42bd3583ba3ad9572c3a2.patch — ir3: Remove texture descriptor prefetch support
  • tu-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)
  • b492b11ecf freedreno/ci: drop the fixed a702 uniform texel buffer barrier tests
  • 8c589b897b freedreno: Fix the A722 CCU count
  • 2fae1d0db8 tu: Add QCTDD08049535_numnonposvar_alignment for a7xx gen1/gen2
Turnip (tu) (9)
  • 0f5ba03ea0 tu: use pBindings order for binding flags and mutable type lists
  • c8c572b018 tu: Fix software multiview with indirect draws
  • e1852a339b tu/lrz: Align LRZ pitch to 32 instead of 64 on A8XX
  • 2ce86eedc5 tu/lrz: Fix partial LRZ fast-clear on A8XX
  • ce116a018e tu: Drop CCU depth invalidation on occlusion query end
  • 31f1ceddff tu/kgsl: Force 8-channel macrotile mode on A635
  • bf187f7617 tu: use VK_USE_PLATFORM_ANDROID_KHR when applicable
  • 34d9ed80fc tu/ci: Update trace checksums for non-visible changes.
  • c99d3b50f7 tu: Have GL behavior for primitive generated query
Compiler (ir3) (10)
  • 292c86ab26 ir3/validate: validate SSA dominance
  • 05ff917628 ir3: rename is_sat_compatible to sat_is_fsat
  • 5a9db0be64 ir3: only fold fsat to (sat) on cat2/3 float instructions
  • 87afb02bc7 ir3: move is_cat[23]_float helper up in their file
  • 1e4254967a ir3: Allow (neg) copy propagation into some more bit ops on 6xx+.
  • 8eda1cc036 ir3: Add support for copy-propagating BNOT into src mods.
  • 1e24fd20a9 ir3: Give is_same_type_mov() an option to allow src mods or not.
  • 222377b38b ir3: Reject BNOT as a src flag on cat4 instructions.
  • 1eb4fe36e7 ir3: Correct the IR3_REG_BNOT flags support.
  • 10839580a9 ir3: Add support for (not) as a source modifier name.
Other (36)
  • c0235eff65 freedreno/a5xx: program the 2D source and use BLIT_OP_SCALE
  • a5c42c0810 freedreno/a5xx: convert 2D blits through the right intermediate format
  • ba27232935 freedreno/registers: make the 2D blit ifmt enums common
  • 2648b2059f freedreno/a5xx: program the guard band and ignore the viewport clip codes
  • 455cdd824d freedreno/a5xx: Program the stream output buffer stride
  • 644e6dfa1c vulkan: sort per-binding pNext data in vk_create_sorted_bindings
  • d520ae902e freedreno/ir3: Lower FP32 to FP16 for subnormals
  • 5b2db4b8e3 freedreno/fdl: Use NUM_ELEMENTS for A8XX buffer descriptors
  • 1f9c4d529f freedreno : Take only in fence as a hint for explicit sync
  • 67d8fb7fa5 ci/deqp: Update VK CTS to 1.4.7.0
  • 3d167c0824 freedreno/a3xx: deal with VS which does not write position.
  • 9e87a244c0 freedreno/ci: drop a530 flakes that no longer reproduce
  • 24ba64c445 freedreno/ci: drop the a530 builtin_functions.precision flakes
  • 2a93c60bbf freedreno/ci: drop the stale a530 atomic_counter flakes
  • 9c82a78f18 freedreno: Match FD735 regardless of the speed bin fuse
  • fda56c9dc2 vulkan: Always compute sourface_area/2
  • 837ab0e307 freedreno/decode : Add new test for crashdec with devcore dump with mempool
  • e00d0427c8 freedreno/crashdec: Use CP_MEM_POOL_SIZE as a layout hint
  • 5be22f37e4 freedreno/crashdec: Detect the mempool layout
  • 598f119b8f freedreno/crashdec: Pass the mempool dump size down
  • f498517c72 freedreno/crashdec: Bound the mempool queue walk
  • a52a42bfa6 freedreno/crashdec: Split out walk_queue()
  • 0dea41cf03 freedreno/crashdec: Put the mempool layouts in a table
  • 8b5e7e425a freedreno/crashdec: Move mempool types to file scope
  • dc085ea932 freedreno/crashdec: Add bound checks for cffdec
  • 20cfa4817b freedreno/crashdec: Start a new section per cluster bank
  • d8a7cbcfc2 freedreno/crashdec: Add a6xx cluster/shader/debugbus ids
  • 10256f70e3 freedreno/crashdec: Walk nested IBs for the snapshot
  • a226b30da9 freedreno/crashdec: Clamp IB size to what was captured
  • d39c5aa992 freedreno/crashdec: Harden parse_ibs()
  • 70d079b4c9 freedreno/crashdec: Raise the snapshot BO size limit
  • 73ed52f0a7 freedreno/crashdec: Don't assert on too many IBs
  • c49996a75e freedreno/crashdec: Add reg_buf_push()
  • 5529e5011e freedreno/crashdec: Fill in the snapshot comm field
  • b78f8149d0 freedreno/crashdec: Fix time parsing
  • e7371b0711 freedreno: 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