JustAResearcher/gpu-unlock-ada

选用指南

AI 根据 README 整理 · 2026/10/24 22:26:27

使用方式

通过内核模块在启动时自动生效，需在kernel command line设置目标PCI地址。

查看 README 依据

[firmware/README.md](firmware/README.md) for the input and asset layout. Prebuilt firmware packages are not distributed by this repository. ## Enable at boot The package installs the module and firmware into the initramfs so the unlock runs before NVIDIA binds the card. It remains inactive unless the kernel command line opts in: ```text gpu_unlock.targets=0000:03:00.0 gpu_unlock.targets=0000:03:00.0,0000:04:00.0 gpu_unlock.targets=all gpu_unlock.targets=0000:01:00.0 gpu_unlock.ad103_experimental=1 ``` These PCI addresses are examples. Use the full PCI names printed by `lspci -D`.

部署要求

需要Linux内核模块构建工具链（DKMS），并支持Arch、Debian、RPM系发行版，构建时需联网下载NVIDIA固件。

查看 README 依据

`make install` detects the supported distribution family. Its explicit targets are: ```sh make install-arch # makepkg -sif make install-deb # apt-get build-dep, dpkg-buildpackage, apt-get install make install-rpm # dnf builddep, rpmbuild, dnf install ``` `make arch`, `make deb` and `make rpm` build without installing. Packages are built from the committed `HEAD`; Debian and RPM outputs go to `build/deb` and `build/rpm`. Kernel headers and a working DKMS toolchain are required. Builds fetch the pinned NVIDIA `610.43.03` source and binary inputs over HTTPS

and verify their SHA-256 hashes. `make inputs` prepares the cache; `make firmware` generates assets from cached inputs; `make assets` does both. The default cache is `$HOME/.cache/gpu-unlock` and can be overridden with `CACHE=`, `INPUTS=` and `ASSETS=`. A clean-chroot Debian build needs `GPU_UNLOCK_INPUTS` pointing to the input cache because `dpkg-buildpackage` does not fetch inputs itself. The source archive produced by `make dist`, the Debian source package and the `.nosrc.rpm` contain no NVIDIA archives or generated firmware. See

已知限制

该模块仅支持RTX 4090和实验性的RTX 4070 Ti SUPER，其他显卡不兼容。且需冷启动才能生效，普通重启不能保证成功。

查看 README 依据

needs a card whose firmware state is fresh before NVIDIA loads. A warm reboot is not guaranteed to provide that state: it did on the tested RTX 4070 Ti SUPER, where the pre-firmware WPR2 readback returned to zero and the unlock succeeded again without an AC cut. Other boards may retain WPR2; the module refuses to rerun the firmware sequence in that state. It also skips cards that are already bound, powered down or bus mastering. Loading the module manually after NVIDIA has bound the card cannot unlock it. After validating a cold boot and a one-time warm reboot on the exact card, a