Skip to content
A Python script to patch NVIDIA vBIOS dumps into a format compatible with VFIO passthrough
Branch: master
Clone or download
Matoking Merge pull request #9 from RavenX8/maxwel
Support for GPUs older than pascal
Latest commit d269523 Feb 5, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Add note about acquiring a vBIOS ROM Aug 1, 2017
LICENSE Initial commit Aug 1, 2017
README.md Add a header note about GPU compatibility Jun 8, 2018
nvidia_vbios_vfio_patcher.py Update nvidia_vbios_vfio_patcher.py Sep 26, 2018

README.md

NVIDIA vBIOS VFIO Patcher

This tool is known to be compatible only with the Pascal series (1xxx) of NVIDIA GPUs.

nvidia_vbios_vfio_patcher.py is a script that creates a patched/spliced copy of a NVIDIA vBIOS that allows PCI passthrough when using libvirt. This copy of the vBIOS can then be passed to libvirt, allowing the NVIDIA GPU to be used in the guest VM. This can be done by adding the following line to the VM domain XML file.

   <hostdev>
     ...
     <rom file='/path/to/your/patched/gpu/bios.bin'/>
     ...
   </hostdev>

This script may be useful if you are using one of the Pascal (1xxx series) series of NVIDIA GPUs and you are having passing the GPU to the guest VM. In this case, the vBIOS of the system's primary GPU is tainted when booting the host OS, making GPU passthrough impossible unless a clean copy of the vBIOS is used.

The patching process requires a full copy of the clean vBIOS. You can either extract it from the graphics card using nvflash or GPU-Z under Windows (recommended), or download one for your specific GPU model from TechPowerUp.

DISCLAIMER

Use this script at your own discretion. This script has NOT been tested extensively, and has only been tested with a few GPUs belonging to he Pascal series of NVIDIA GPUs.

The script performs only a few rudimentary sanity checks, but no guarantees are made of the validity of the patched ROM!

Usage

The script should work with both Python 2 and 3.

To create a patched version of the BIOS, run the script with the following parameters.

python nvidia_vbios_vfio_patcher.py -i <ORIGINAL_ROM> -o <PATCHED_ROM>

A patched version of <ORIGINAL_ROM> will be written to <PATCHED_ROM>.

You can’t perform that action at this time.