From 1c8f78a08249035ad3cd91a3faf46ab9690c3955 Mon Sep 17 00:00:00 2001 From: Leask Wong Date: Sun, 11 Oct 2026 22:37:40 -0400 Subject: [PATCH] Target official runtime review and document PR570 prerequisite provenance --- .../american-nightmare-pixel-debug.md | 32 +++++++++++++++---- 1 file changed, 26 insertions(+), 6 deletions(-) diff --git a/docs/development/american-nightmare-pixel-debug.md b/docs/development/american-nightmare-pixel-debug.md index 8547380a20..71bdca6f65 100644 --- a/docs/development/american-nightmare-pixel-debug.md +++ b/docs/development/american-nightmare-pixel-debug.md @@ -135,15 +135,35 @@ Routine Heartbeat must not launch games or automatically resume this engineering ## Submission scope -These runtime tools are submitted against the experimental PowerVR `dev` branch, -following its merged presentation-semaphore PR -. They do not change the managed pack -manifest/checksums or enable the opt-in overrides globally. Shipping the built -runtime still needs maintainer review and a new managed-pack release. +These opt-in runtime tools are submitted directly against official DroidDeck +`main`. The standalone DXVK build recipe, source pin, BC-format prerequisite and +presentation-semaphore patch/check are imported verbatim from the PowerVR proposal + at +`d0f7264ea8e402d30c868779198dc2fd74e7431c`. That proposal's attribution and existing +source/license provenance are retained. The semaphore correction originated in +. No Android app changes, managed pack +or the experimental fork's development history are imported with those recipes. + +The source tools can be reviewed and built independently. Automatic PowerVR +integration and delivery in DroidDeck require the separately reviewed #570 +foundation and a new managed-runtime release. This submission does not change +managed-pack manifests/checksums or globally enable any override. The earlier +fork-only stage is superseded by the +official submission; its review history is preserved. + +For standalone verification, run +`python3 -m unittest discover -s tools/tests -p test_pixel_reset_diagnostics.py` +on the host. On native 64-bit Linux/glibc, +`tools/hybris/low32/build.sh /absolute/output-dir` builds and runs the CPU integrity +regressions. The DXVK component recipe is `tools/dxvk/build.sh /absolute/output-dir`; +it requires the pinned DXVK build prerequisites, including Meson/Ninja, MinGW +cross compilers, glslangValidator and SPIR-V Tools. It retains both architectures, +source/license provenance and downstream patches, without editing an installed +runtime or APK. The compositor ownership safeguards are independently proposed in . Those native changes were present in the integrated Pixel Lab APK used for the game experiments, but are not part of this runtime PR's diff. The original BC emulation is a prerequisite supplied by -the PowerVR branch. This submission supplies source and reproducibility tools, +the separately proposed PowerVR runtime. This submission supplies source and reproducibility tools, not an APK, proprietary driver, game data or private diagnostic archive.