Windows GPU UNLOCK

English | 한국어

Experimental UEFI GPU unlock and direct Windows handoff, expanded through community contributions. This source tree contains three exact-machine profiles with recorded hardware results: two internal headless configurations and one headless USB configuration. Read compatibility before choosing a build; a GPU model name alone does not establish support.

These results concern the exact builds and systems in their reports. The current cold-precheck hardening has host/build verification, not a new physical boot or recovery test on those machines. Contributor reports are identified separately from the original maintainer's run; they do not establish support for every card of the same model or every BIOS. The Ryzen CPUs in the table have iGPUs, but their reported headless routes used no active AMD GOP.

The latest tagged release, v0.3.1, is a source-only pre-release. This source tree has changes beyond that tag, including the USB route and X870 profile; those are not a newly published release. Build locally with your own partition GUIDs. Firmware assets and private, partition-specific EFI binaries are not bundled.

X870 is not wired into Configure.ps1 or Headless.ps1; use its USB guide. USB packages can also be built for the first two profiles, but their recorded internal boots do not validate those USB routes. The legacy USB EFI retains its AMD display requirement. BIOS priority USB → Windows alone does not implement direct handoff.

This example is for the default B650M / RTX 3090 FE profile. For B660M, select -HardwareProfile b660m-3070ti in both configuration and build as described in compatibility. X870 uses the separate USB route.

Read the full guide and recovery procedure before changing boot settings. Use the exact supported hardware, Secure Boot disabled, a fully decrypted Windows C: with BitLocker protection off, and a connected keyboard. The tools do not disable encryption.

Preserve the existing Windows ESP and recovery partition. Prepare a separate GPT FAT32 EFI System Partition of at least 1 GiB, with a letter such as U:. Tools do not create, shrink, delete or format partitions. An ordinary FAT32 data partition alone is not the required ESP.

You need Python 3.9+, clang/lld-link 20.1.8, the pinned repository dependencies and five locally obtained firmware assets. Host integration tests additionally need MSVC/Windows SDK and private fixtures.

From an administrator PowerShell in the repository root:

# Replace the GUID and tool paths with your own values.
.\internal-boot\Configure.ps1 -UnlockDriveLetter U `
  -WindowsEspGuid 'YOUR-WINDOWS-ESP-GUID'
.\research\headless\build-unlock.ps1 `
  -Clang 'C:\TOOLS\LLVM20\bin\clang.exe' `
  -LldLink 'C:\TOOLS\LLVM20\bin\lld-link.exe'

# Stage and append a separate F8 test entry; retain existing boot priority.
.\internal-boot\Headless.ps1 -Assets '.\assets' -Register

Without an action switch, Headless.ps1 -Assets '.\assets' only stages files. Configuration and build do not register a boot entry.

1. Save work and fully power off. On the tested ASUS firmware, select F8 → GPU Headless UNLOCK - EXPERIMENTAL.

2. Wait without T, U or Enter. Initial Esc within five seconds skips release and unlock and boots Windows directly.

3. The screen becomes black while the RTX GOP is removed. The child attempts once and the wrapper starts Windows directly. Do not reset between unlock and Windows. Confirm display recovery and measure.

4. Only after that F8 test succeeds, enable default automatic boot:

   .\internal-boot\Headless.ps1 -EnableAutomatic -ConfirmedSuccess

That explicit action places headless first and Windows Boot Manager second and disables Windows Fast Startup. Test registration alone does not. Publishing this release does not change the research PC's current default boot selection.

The two Esc windows differ: initial wrapper Esc boots Windows without release; the later three-second child Esc window is after release and cancels into a stop. It does not restore the display or continue to Windows. On failure or if Windows does not return, fully power off and choose F8 → Windows Boot Manager.

.\internal-boot\Headless.ps1 -RestoreWindowsFirst

Windows-first recovery is independent of experimental EFI/build artifacts and still works without saved state. Restoring the prior Fast Startup setting needs that state; retain it and backups. Recovery details.

The original B650M hardware run's successful child reported SS0 0x88888888, SS1 0x8, BME disabled, zero remaining mappings, completed cleanup and one FLR. The wrapper verified the released topology before Windows entry. Windows display recovery was observed by the operator.

There is no contemporary controlled locked baseline for this headless boot, so these values do not establish an unlock percentage. They do not establish game or ComfyUI gains, long-term stability, sleep/hibernate resume or repeated automatic cold-boot reliability. Sanitized measurements and earlier results describe separate experiments.

For the other machines' measurements, see B660M Profile 2 and X870 USB evidence. Those results are tied to their reported builds; a later successful build or host test does not extend the physical test record.

Headless is a separate compile-time profile. Exact GPU/PROM/PCI state, firmware driver code, ownership, cold state, immutable selectors and cleanup checks remain. The child logs to files only and rejects physical GOP reappearance or changed console/input interfaces. Ordinary builds retain their AMD display guards. Do not remove checks or substitute a PROM hash to force another machine through.

No VBIOS flashing or Windows driver replacement is part of the procedure. Driver 617.14 was unchanged in the documented run. Host mock tests do not add hardware support. New systems require compatibility reporting and portability validation.

The port and reused core are GPL-2.0-only; EDK2 and separately attributed components retain their licenses. Based on rough2515-hub/rtx3080-unlock-public and Zagitta/gpu-unlock. Preserve LICENSE, third-party notices and change history. NVIDIA firmware, PROM/BIOS images, drivers and CUDA DLLs are not redistributed in this source release.