Files
DroidDeck/tools/tests/test_qualcomm_present.py
T
K11MCH1 9c987fa92e Fall back automatically on Qualcomm drivers with fewer capabilities
Older Adreno drivers such as the 8 Gen 2's 0.676.1 lack
VK_EXT_external_memory_dma_buf, DRM modifiers and calibrated timestamps.
They failed device creation in the WSI layer, failed Proton games on the
zero-copy path, and corrupted the Steam UI under GPU compositing.

- WSI patch 0005 makes the Wayland platform optional per device, so a
  device without its extensions stays usable for X11 swapchains instead
  of failing vkCreateDevice.
- droiddeck-qualcomm-caps checks DMA-BUF export and import, the swapchain
  extensions and Gamescope's linux-dmabuf once per session; Proton games
  use the zero-copy WSI path only when it passes and stay on X11 SHM
  otherwise. The session log records the verdict.
- The Steam browser uses software compositing when Zink offers less than
  OpenGL 4.0, with BL_STEAM_CEF_SOFTWARE as the manual override.

Verified on the Adreno 740 (falls back to SHM and software compositing,
UI correct) and the Adreno 840 (zero-copy and GPU compositing unchanged).

(cherry picked from commit d8d0b10cced1f21a1e9bc7dca00efd89b389adb3)
(cherry picked from commit 00775f0511)
2026-10-25 23:09:14 +00:00

60 lines
3.1 KiB
Python

import os
from pathlib import Path
import runpy
import subprocess
import unittest
BIN = Path(__file__).resolve().parents[1] / "linuxfs/overlay/usr/local/bin"
COMPAT = runpy.run_path(str(BIN / "steam-compatibility"))
SHOW = 'echo "DISABLE_GAMESCOPE_WSI=${DISABLE_GAMESCOPE_WSI-unset} WSI_X11_FORCE_SHM=${WSI_X11_FORCE_SHM-unset}"\n'
SESSION_DEFAULT = "DISABLE_GAMESCOPE_WSI=1 WSI_X11_FORCE_SHM=1"
ZERO_COPY = "DISABLE_GAMESCOPE_WSI=unset WSI_X11_FORCE_SHM=unset"
class QualcommPresentTest(unittest.TestCase):
def present(self, **extra):
env = dict(os.environ, DISABLE_GAMESCOPE_WSI="1", WSI_X11_FORCE_SHM="1")
for name in ("DROIDDECK_SYSTEM_QUALCOMM", "DROIDDECK_QUALCOMM_ZERO_COPY", "BL_QUALCOMM_SHM"):
env.pop(name, None)
env.update(extra)
script = COMPAT["BL_PRESENT_SETUP"] + "\nbl_present\n" + SHOW
return subprocess.run(["bash", "-c", script], env=env, capture_output=True, text=True, check=True).stdout.strip()
def test_qualcomm_games_present_zero_copy_when_the_probe_passed(self):
self.assertEqual(self.present(DROIDDECK_SYSTEM_QUALCOMM="1", DROIDDECK_QUALCOMM_ZERO_COPY="1"), ZERO_COPY)
def test_drivers_without_a_passing_probe_keep_the_session_default(self):
for extra in ({"DROIDDECK_SYSTEM_QUALCOMM": "1"},
{"DROIDDECK_SYSTEM_QUALCOMM": "1", "DROIDDECK_QUALCOMM_ZERO_COPY": "0"},
{"DROIDDECK_SYSTEM_QUALCOMM": "1", "DROIDDECK_QUALCOMM_ZERO_COPY": ""}):
with self.subTest(extra=extra):
self.assertEqual(self.present(**extra), SESSION_DEFAULT)
def test_turnip_sessions_and_the_shm_override_keep_the_session_default(self):
for extra in ({}, {"DROIDDECK_SYSTEM_QUALCOMM": "0", "DROIDDECK_QUALCOMM_ZERO_COPY": "1"},
{"DROIDDECK_SYSTEM_QUALCOMM": "1", "DROIDDECK_QUALCOMM_ZERO_COPY": "1", "BL_QUALCOMM_SHM": "1"}):
with self.subTest(extra=extra):
self.assertEqual(self.present(**extra), SESSION_DEFAULT)
def test_every_proton_launch_selects_the_present_path(self):
self.assertIn("bl_present()", COMPAT["LAUNCHER_SH"])
self.assertEqual((BIN / "steam-compatibility").read_text().count("BL_LIBPATH_SETUP + BL_PRESENT_SETUP"), 2)
for script in (COMPAT["LAUNCHER_SH"], COMPAT["EXTRA_WRAPPER_SH"] % "proton"):
lines = [line.strip() for line in script.splitlines()]
launches = [i for i, line in enumerate(lines) if line.startswith("bl_run") and "droiddeck-game-env" in line]
self.assertTrue(launches)
for index in launches:
self.assertIn("bl_present", lines[max(0, index - 6):index])
def test_the_qualcomm_session_exports_the_probe_result(self):
session = (BIN / "droiddeck-session").read_text()
block = session[session.index('if [ "${DROIDDECK_SYSTEM_QUALCOMM:-0}" = 1 ]; then\n export VK_LAYER_PATH'):]
block = block[:block.index("\nfi\n")]
self.assertIn("DROIDDECK_QUALCOMM_ZERO_COPY=0", block)
self.assertIn("droiddeck-qualcomm-caps", block)
self.assertIn("export DROIDDECK_QUALCOMM_ZERO_COPY", block)
if __name__ == "__main__":
unittest.main()