qemu/docs/igd-assign.txt

1 Intel Graphics Device (IGD) assignment with vfio-pci
4 Using vfio-pci, we can passthrough Intel Graphics Device (IGD) to guest, either
16 (*-Required by)
19 |---------------------------------------------|-------|---------|-------|---------|
30 For #1, the "x-igd-opregion=on" option exposes a copy of host IGD OpRegion to
33 For #2, "x-igd-lpc=on" option copies the IDs of host LPC bridge and host bridge
42 For #5, "x-vga=on" enables guest access to standard VGA IO/MMIO ranges.
48 QEMU also provides a "Legacy" mode that implicitly enables full functionality
56 In "Legacy" mode, QEMU will automatically setup OpRegion, LPC bridge IDs and
58   x-igd-opregion=on,x-igd-lpc=on,x-vga=on
60 By default, "Legacy" mode won't fail, it continues on error. User can set
61 "x-igd-legacy-mode=on" to force enabling legacy mode, this also checks if the
62 conditions above for legacy mode is met, and if any error occurs, QEMU will
63 fail immediately. Users can also set "x-igd-legacy-mode=off" to disable legacy
66 In legacy mode, as the guest VGA ranges are assigned to IGD device, all other
67 graphics devices should be removed, this can be done using "-nographic" or
68 "-vga none" or "-nodefaults", along with adding the device using vfio-pci.
71 may generate faults and errors upon re-binding to an IGD device after it
75 the driver_override option can be used to ensure that only vfio-pci can bind
76 to the device on the host[2], virsh nodedev-detach can be used to bind the
78 re-binding to i915, etc.  Also note that IGD is also typically the primary
80 blacklisting i915 or using pci-stub/vfio-pci to take ownership of IGD as a
84 a catch-all, video=vesafb:off,efifb:off.  Error messages such as:
106 * x-igd-opregion=[*on*|off]
109 * x-igd-lpc=[on|*off*]
112 * x-igd-legacy-mode=[on|off|*auto*]
113   Enable/Disable legacy mode
115 * x-igd-gms=[hex, default 0]
118   'DVMT Pre-Allocated' option in host BIOS.
123 * Adding IGD with automatically legacy mode support
124   -device vfio-pci,host=00:02.0,id=hostdev0,addr=2.0
128 …-device vfio-pci,host=00:02.0,id=hostdev0,addr=2.0,x-igd-legacy-mode=off,x-igd-lpc=on,romfile=efi_…
137 1) "etc/igd-opregion"
148 2) "etc/igd-bdsm-size"
150    This fw_cfg file contains an 8-byte, little endian integer indicating
156    64-bit BDSM).  As this support is related to running the IGD ROM, which
167 Upstream Seabios has OpRegion and BDSM (pre-Gen11 device only) support.
172 * IntelGopDriver: Closed-source Intel GOP driver
180 You need to build them with EDK2.
189   EfiRom -f 0x8086 -i <Device ID of your IGD> -o output.rom \
190   -e IgdAssignmentDxe.efi PlatformGOPPolicy.efi IntelGopDriver.efi
196 warning: vfio_container_dma_map(0x55fab36ce610, 0x380010000000, 0x108000, 0x7fd336000000) = -22 (In…
200   -cpu host,host-phys-bits-limit=<IOMMU address width>
206   echo $(( ((0x$(cat /sys/devices/virtual/iommu/dmar0/intel-iommu/cap) & 0x3F0000) >> 16) + 1 ))
212 IGD has it own address space. To use system RAM as VRAM, a single-level page
215 the translation flow on IGD with 64-bit GTT PTEs.
217 (PTE_SIZE == 8)                +-------------+---+
219                                +-------------+---+
222 -----------------------> 0xd748| 0x42ba3e000 | 1 +------------------>
225                                +-------------+---+
233 The Data Stolen Memory is reserved by firmware, and acts as the VRAM in pre-OS
240        +-------------+                +-------------+         +-------------+
243        |             |                +-------------+         +-------------+
246        |             |  +------------>+-------------+<------->+-------------+<--Guest BDSM
248 DSMSIZE+-------------+  | with IOMMU  |             | Mapping |             |   Programmed by guest…
251       0+-------------+--+             |             |         |             |
252                         |             +-------------+         |             |
253                         |             | Data Stolen |         +-------------+
255                         +------------>+-------------+<--Host BDSM
256                           Non-        |             |   "real" one in HW
258                                       +-------------+
262 …https://www.intel.com/content/www/us/en/docs/graphics-for-linux/developer-reference/1-0/dump-video…
263 [2] # echo "vfio-pci" > /sys/bus/pci/devices/0000:00:02.0/driver_override
266 [4] https://eci.intel.com/docs/3.3/components/kvm-hypervisor.html, Patch 0001-0004
268 [6] https://winraid.level1techs.com/t/tool-guide-news-uefi-bios-updater-ubu/30357