Forked

I did not write the code, I'm not even a maintainer, I'm just some guy that got it to compile in the summer of '24. So I thought I'd share.

That being said I did write some better scripts to build and test-run the .rom, It works, tested on Win10 VM under arch linux, 07/24.

VBIOS for Intel GPU Passthrough

This project attempts to create a UEFI driver for the intel integrated GPUS so that they can be used in VFIO Passthrough. Prior to this driver, there was no easy or reliable solution to both virtualized and direct passthrough(GVT-G/D). This driver adds an opRegion for the iGPU to utilize during the Boot Process, allowing for access to the UEFI menus and any other interfaces that are created before an operating system level driver is initialized. As a bonus, this allows for MacOS to boot in this virtual environment.

Notice

This Software deals directly with the graphics hardware and interfaces. I assume no responsibility should it cause any damage to your GPUs, Cables, Displays, Other hardware, or persons. It has been tested on my personal machine, but you are using this software at your own risk.

Disclaimer: When used in direct passthrough, this VBIOS could produce bad pixel clock that can potentially damage your monitor! Make sure your monitor has protections against that. I'm not responsible for any monitor damage.

Current Feature Support

• Boot a virtual intel GPU(GVT-G)
• Passthrough the entire Intel GPU (GVT-D)
  • Display Port interfaces
  • eDP interfaces, including Laptop Screens
  • HDMI interfaces
• Theoretically compatible with any 14nm chip(Skylake, Kaby lake, Coffee Lake, Amber Lake, Whiskey Lake, Comet Lake).
• Auto detect Outputs and types(NEW)

Possible Features to come

• Allow for generation Specific Quirks
• Allow for other it to work with other intel CPU Generations.
• If you make a PR, I'll look at it, but that's about it. Sorry :-(

Known Issues

• May have issues with thunderbolt eGPUs. If you encounter problems, try with it unplugged
• GVT-G may struggle with external displays(even if through an eGPU or other GPU)
• May cause random kernel panics with MacOS due to a low default DVMT Pre-allocated memory amount. See here for more info

What is this

This is an independent Video BIOS for Intel integrated GPUs. It provides a boot display and sets up an OpRegion so that Windows guests can produce monitor output.

The OpRegion code comes from IgdAssignmentDxe and should work everywhere. The boot display works for GVT-g and can safely replace ramfb. For direct passthrough, the boot display Works on intel 14nm based CPUS and HDMI/DP/eDP displays(Inlcuding laptop Screens!).

Usage

Download/clone the following, side-by-side:

• this repo
• edk2
• edk2-platforms

then run ./build.sh from repo's base dir, if you see ==== success ==== at the end, then congratz. You can then run ./test-gvt-g.sh (as root), again from base dir.

I've also added vm-additions.xml for sample config to add to a pre-configured VM to get it to run. The VM should be pre-configured, i.e. Win10 guest will detect and install intel drivers automatically. I imagine for the linux guest, make sure mesa is installed, the rest should work (have ssh enabled just in case).

NOTE: first boot does take a while - give it time.

Old, pre-fork wiki is available. Please see the Wiki for more information regarding compiling, usage, or further information.

License

I have no idea what this should be licensed in, but the code came from:

• managarm OS: https://github.com/managarm/managarm/
• IgdAssignmentDxe: non-upstreamed Intel patch to OVMF
• EDK II: https://github.com/tianocore/edk2
• The Linux kernel
• Intel-gpu-tools: https://cgit.freedesktop.org/xorg/app/intel-gpu-tools/tree/tools