4 * Copyright Red Hat, Inc. 2016
7 * Alex Williamson <alex.williamson@redhat.com>
9 * This work is licensed under the terms of the GNU GPL, version 2. See
10 * the COPYING file in the top-level directory.
13 #include "qemu/osdep.h"
14 #include "qemu/units.h"
15 #include "qapi/error.h"
17 #include "hw/nvram/fw_cfg.h"
24 * Obviously IGD is not a discrete device, this is evidenced not only by it
25 * being integrated into the CPU, but by the various chipset and BIOS
26 * dependencies that it brings along with it. Intel is trying to move away
27 * from this and Broadwell and newer devices can run in what Intel calls
28 * "Universal Pass-Through" mode, or UPT. Theoretically in UPT mode, nothing
29 * more is required beyond assigning the IGD device to a VM. There are
30 * however support limitations to this mode. It only supports IGD as a
31 * secondary graphics device in the VM and it doesn't officially support any
34 * The code here attempts to enable what we'll call legacy mode assignment,
35 * IGD retains most of the capabilities we expect for it to have on bare
36 * metal. To enable this mode, the IGD device must be assigned to the VM
37 * at PCI address 00:02.0, it must have a ROM, it very likely needs VGA
38 * support, we must have VM BIOS support for reserving and populating some
39 * of the required tables, and we need to tweak the chipset with revisions
40 * and IDs and an LPC/ISA bridge device. The intention is to make all of
41 * this happen automatically by installing the device at the correct VM PCI
42 * bus address. If any of the conditions are not met, we cross our fingers
43 * and hope the user knows better.
45 * NB - It is possible to enable physical outputs in UPT mode by supplying
46 * an OpRegion table. We don't do this by default because the guest driver
47 * behaves differently if an OpRegion is provided and no monitor is attached
48 * vs no OpRegion and a monitor being attached or not. Effectively, if a
49 * headless setup is desired, the OpRegion gets in the way of that.
53 * This presumes the device is already known to be an Intel VGA device, so we
54 * take liberties in which device ID bits match which generation. This should
55 * not be taken as an indication that all the devices are supported, or even
56 * supportable, some of them don't even support VT-d.
57 * See linux:include/drm/i915_pciids.h for IDs.
59 static int igd_gen(VFIOPCIDevice
*vdev
)
61 if ((vdev
->device_id
& 0xfff) == 0xa84) {
62 return 8; /* Broxton */
65 switch (vdev
->device_id
& 0xff00) {
66 /* Old, untested, unavailable, unknown */
76 /* SandyBridge, IvyBridge, ValleyView, Haswell */
84 /* BroadWell, CherryView, SkyLake, KabyLake */
92 return 8; /* Assume newer is compatible */
95 typedef struct VFIOIGDQuirk
{
96 struct VFIOPCIDevice
*vdev
;
101 #define IGD_GMCH 0x50 /* Graphics Control Register */
102 #define IGD_BDSM 0x5c /* Base Data of Stolen Memory */
106 * The rather short list of registers that we copy from the host devices.
107 * The LPC/ISA bridge values are definitely needed to support the vBIOS, the
108 * host bridge values may or may not be needed depending on the guest OS.
109 * Since we're only munging revision and subsystem values on the host bridge,
110 * we don't require our own device. The LPC/ISA bridge needs to be our very
118 static const IGDHostInfo igd_host_bridge_infos
[] = {
119 {PCI_REVISION_ID
, 2},
120 {PCI_SUBSYSTEM_VENDOR_ID
, 2},
121 {PCI_SUBSYSTEM_ID
, 2},
124 static const IGDHostInfo igd_lpc_bridge_infos
[] = {
127 {PCI_REVISION_ID
, 2},
128 {PCI_SUBSYSTEM_VENDOR_ID
, 2},
129 {PCI_SUBSYSTEM_ID
, 2},
132 static int vfio_pci_igd_copy(VFIOPCIDevice
*vdev
, PCIDevice
*pdev
,
133 struct vfio_region_info
*info
,
134 const IGDHostInfo
*list
, int len
)
138 for (i
= 0; i
< len
; i
++) {
139 ret
= pread(vdev
->vbasedev
.fd
, pdev
->config
+ list
[i
].offset
,
140 list
[i
].len
, info
->offset
+ list
[i
].offset
);
141 if (ret
!= list
[i
].len
) {
142 error_report("IGD copy failed: %m");
151 * Stuff a few values into the host bridge.
153 static int vfio_pci_igd_host_init(VFIOPCIDevice
*vdev
,
154 struct vfio_region_info
*info
)
157 PCIDevice
*host_bridge
;
160 bus
= pci_device_root_bus(&vdev
->pdev
);
161 host_bridge
= pci_find_device(bus
, 0, PCI_DEVFN(0, 0));
164 error_report("Can't find host bridge");
168 ret
= vfio_pci_igd_copy(vdev
, host_bridge
, info
, igd_host_bridge_infos
,
169 ARRAY_SIZE(igd_host_bridge_infos
));
171 trace_vfio_pci_igd_host_bridge_enabled(vdev
->vbasedev
.name
);
178 * IGD LPC/ISA bridge support code. The vBIOS needs this, but we can't write
179 * arbitrary values into just any bridge, so we must create our own. We try
180 * to handle if the user has created it for us, which they might want to do
181 * to enable multifunction so we don't occupy the whole PCI slot.
183 static void vfio_pci_igd_lpc_bridge_realize(PCIDevice
*pdev
, Error
**errp
)
185 if (pdev
->devfn
!= PCI_DEVFN(0x1f, 0)) {
186 error_setg(errp
, "VFIO dummy ISA/LPC bridge must have address 1f.0");
190 static void vfio_pci_igd_lpc_bridge_class_init(ObjectClass
*klass
, void *data
)
192 DeviceClass
*dc
= DEVICE_CLASS(klass
);
193 PCIDeviceClass
*k
= PCI_DEVICE_CLASS(klass
);
195 set_bit(DEVICE_CATEGORY_BRIDGE
, dc
->categories
);
196 dc
->desc
= "VFIO dummy ISA/LPC bridge for IGD assignment";
197 dc
->hotpluggable
= false;
198 k
->realize
= vfio_pci_igd_lpc_bridge_realize
;
199 k
->class_id
= PCI_CLASS_BRIDGE_ISA
;
202 static TypeInfo vfio_pci_igd_lpc_bridge_info
= {
203 .name
= "vfio-pci-igd-lpc-bridge",
204 .parent
= TYPE_PCI_DEVICE
,
205 .class_init
= vfio_pci_igd_lpc_bridge_class_init
,
206 .interfaces
= (InterfaceInfo
[]) {
207 { INTERFACE_CONVENTIONAL_PCI_DEVICE
},
212 static void vfio_pci_igd_register_types(void)
214 type_register_static(&vfio_pci_igd_lpc_bridge_info
);
217 type_init(vfio_pci_igd_register_types
)
219 static int vfio_pci_igd_lpc_init(VFIOPCIDevice
*vdev
,
220 struct vfio_region_info
*info
)
222 PCIDevice
*lpc_bridge
;
225 lpc_bridge
= pci_find_device(pci_device_root_bus(&vdev
->pdev
),
226 0, PCI_DEVFN(0x1f, 0));
228 lpc_bridge
= pci_create_simple(pci_device_root_bus(&vdev
->pdev
),
229 PCI_DEVFN(0x1f, 0), "vfio-pci-igd-lpc-bridge");
232 ret
= vfio_pci_igd_copy(vdev
, lpc_bridge
, info
, igd_lpc_bridge_infos
,
233 ARRAY_SIZE(igd_lpc_bridge_infos
));
235 trace_vfio_pci_igd_lpc_bridge_enabled(vdev
->vbasedev
.name
);
242 * IGD Gen8 and newer support up to 8MB for the GTT and use a 64bit PTE
243 * entry, older IGDs use 2MB and 32bit. Each PTE maps a 4k page. Therefore
244 * we either have 2M/4k * 4 = 2k or 8M/4k * 8 = 16k as the maximum iobar index
245 * for programming the GTT.
247 * See linux:include/drm/i915_drm.h for shift and mask values.
249 static int vfio_igd_gtt_max(VFIOPCIDevice
*vdev
)
251 uint32_t gmch
= vfio_pci_read_config(&vdev
->pdev
, IGD_GMCH
, sizeof(gmch
));
252 int ggms
, gen
= igd_gen(vdev
);
254 gmch
= vfio_pci_read_config(&vdev
->pdev
, IGD_GMCH
, sizeof(gmch
));
255 ggms
= (gmch
>> (gen
< 8 ? 8 : 6)) & 0x3;
262 return (ggms
/ (4 * KiB
)) * (gen
< 8 ? 4 : 8);
266 * The IGD ROM will make use of stolen memory (GGMS) for support of VESA modes.
267 * Somehow the host stolen memory range is used for this, but how the ROM gets
268 * it is a mystery, perhaps it's hardcoded into the ROM. Thankfully though, it
269 * reprograms the GTT through the IOBAR where we can trap it and transpose the
270 * programming to the VM allocated buffer. That buffer gets reserved by the VM
271 * firmware via the fw_cfg entry added below. Here we're just monitoring the
272 * IOBAR address and data registers to detect a write sequence targeting the
273 * GTTADR. This code is developed by observed behavior and doesn't have a
274 * direct spec reference, unfortunately.
276 static uint64_t vfio_igd_quirk_data_read(void *opaque
,
277 hwaddr addr
, unsigned size
)
279 VFIOIGDQuirk
*igd
= opaque
;
280 VFIOPCIDevice
*vdev
= igd
->vdev
;
284 return vfio_region_read(&vdev
->bars
[4].region
, addr
+ 4, size
);
287 static void vfio_igd_quirk_data_write(void *opaque
, hwaddr addr
,
288 uint64_t data
, unsigned size
)
290 VFIOIGDQuirk
*igd
= opaque
;
291 VFIOPCIDevice
*vdev
= igd
->vdev
;
293 int gen
= igd_gen(vdev
);
296 * Programming the GGMS starts at index 0x1 and uses every 4th index (ie.
297 * 0x1, 0x5, 0x9, 0xd,...). For pre-Gen8 each 4-byte write is a whole PTE
298 * entry, with 0th bit enable set. For Gen8 and up, PTEs are 64bit, so
299 * entries 0x5 & 0xd are the high dword, in our case zero. Each PTE points
300 * to a 4k page, which we translate to a page from the VM allocated region,
301 * pointed to by the BDSM register. If this is not set, we fail.
303 * We trap writes to the full configured GTT size, but we typically only
304 * see the vBIOS writing up to (nearly) the 1MB barrier. In fact it often
305 * seems to miss the last entry for an even 1MB GTT. Doing a gratuitous
306 * write of that last entry does work, but is hopefully unnecessary since
307 * we clear the previous GTT on initialization.
309 if ((igd
->index
% 4 == 1) && igd
->index
< vfio_igd_gtt_max(vdev
)) {
310 if (gen
< 8 || (igd
->index
% 8 == 1)) {
313 base
= pci_get_long(vdev
->pdev
.config
+ IGD_BDSM
);
315 hw_error("vfio-igd: Guest attempted to program IGD GTT before "
316 "BIOS reserved stolen memory. Unsupported BIOS?");
319 val
= data
- igd
->bdsm
+ base
;
321 val
= 0; /* upper 32bits of pte, we only enable below 4G PTEs */
324 trace_vfio_pci_igd_bar4_write(vdev
->vbasedev
.name
,
325 igd
->index
, data
, val
);
328 vfio_region_write(&vdev
->bars
[4].region
, addr
+ 4, val
, size
);
333 static const MemoryRegionOps vfio_igd_data_quirk
= {
334 .read
= vfio_igd_quirk_data_read
,
335 .write
= vfio_igd_quirk_data_write
,
336 .endianness
= DEVICE_LITTLE_ENDIAN
,
339 static uint64_t vfio_igd_quirk_index_read(void *opaque
,
340 hwaddr addr
, unsigned size
)
342 VFIOIGDQuirk
*igd
= opaque
;
343 VFIOPCIDevice
*vdev
= igd
->vdev
;
347 return vfio_region_read(&vdev
->bars
[4].region
, addr
, size
);
350 static void vfio_igd_quirk_index_write(void *opaque
, hwaddr addr
,
351 uint64_t data
, unsigned size
)
353 VFIOIGDQuirk
*igd
= opaque
;
354 VFIOPCIDevice
*vdev
= igd
->vdev
;
358 vfio_region_write(&vdev
->bars
[4].region
, addr
, data
, size
);
361 static const MemoryRegionOps vfio_igd_index_quirk
= {
362 .read
= vfio_igd_quirk_index_read
,
363 .write
= vfio_igd_quirk_index_write
,
364 .endianness
= DEVICE_LITTLE_ENDIAN
,
367 void vfio_probe_igd_bar4_quirk(VFIOPCIDevice
*vdev
, int nr
)
369 struct vfio_region_info
*rom
= NULL
, *opregion
= NULL
,
370 *host
= NULL
, *lpc
= NULL
;
373 PCIDevice
*lpc_bridge
;
374 int i
, ret
, ggms_mb
, gms_mb
= 0, gen
;
377 uint16_t cmd_orig
, cmd
;
381 * This must be an Intel VGA device at address 00:02.0 for us to even
382 * consider enabling legacy mode. The vBIOS has dependencies on the
385 if (!vfio_pci_is(vdev
, PCI_VENDOR_ID_INTEL
, PCI_ANY_ID
) ||
386 !vfio_is_vga(vdev
) || nr
!= 4 ||
387 &vdev
->pdev
!= pci_find_device(pci_device_root_bus(&vdev
->pdev
),
388 0, PCI_DEVFN(0x2, 0))) {
393 * We need to create an LPC/ISA bridge at PCI bus address 00:1f.0 that we
394 * can stuff host values into, so if there's already one there and it's not
395 * one we can hack on, legacy mode is no-go. Sorry Q35.
397 lpc_bridge
= pci_find_device(pci_device_root_bus(&vdev
->pdev
),
398 0, PCI_DEVFN(0x1f, 0));
399 if (lpc_bridge
&& !object_dynamic_cast(OBJECT(lpc_bridge
),
400 "vfio-pci-igd-lpc-bridge")) {
401 error_report("IGD device %s cannot support legacy mode due to existing "
402 "devices at address 1f.0", vdev
->vbasedev
.name
);
407 * IGD is not a standard, they like to change their specs often. We
408 * only attempt to support back to SandBridge and we hope that newer
409 * devices maintain compatibility with generation 8.
412 if (gen
!= 6 && gen
!= 8) {
413 error_report("IGD device %s is unsupported in legacy mode, "
414 "try SandyBridge or newer", vdev
->vbasedev
.name
);
419 * Most of what we're doing here is to enable the ROM to run, so if
420 * there's no ROM, there's no point in setting up this quirk.
421 * NB. We only seem to get BIOS ROMs, so a UEFI VM would need CSM support.
423 ret
= vfio_get_region_info(&vdev
->vbasedev
,
424 VFIO_PCI_ROM_REGION_INDEX
, &rom
);
425 if ((ret
|| !rom
->size
) && !vdev
->pdev
.romfile
) {
426 error_report("IGD device %s has no ROM, legacy mode disabled",
427 vdev
->vbasedev
.name
);
432 * Ignore the hotplug corner case, mark the ROM failed, we can't
433 * create the devices we need for legacy mode in the hotplug scenario.
435 if (vdev
->pdev
.qdev
.hotplugged
) {
436 error_report("IGD device %s hotplugged, ROM disabled, "
437 "legacy mode disabled", vdev
->vbasedev
.name
);
438 vdev
->rom_read_failed
= true;
443 * Check whether we have all the vfio device specific regions to
444 * support legacy mode (added in Linux v4.6). If not, bail.
446 ret
= vfio_get_dev_region_info(&vdev
->vbasedev
,
447 VFIO_REGION_TYPE_PCI_VENDOR_TYPE
| PCI_VENDOR_ID_INTEL
,
448 VFIO_REGION_SUBTYPE_INTEL_IGD_OPREGION
, &opregion
);
450 error_report("IGD device %s does not support OpRegion access,"
451 "legacy mode disabled", vdev
->vbasedev
.name
);
455 ret
= vfio_get_dev_region_info(&vdev
->vbasedev
,
456 VFIO_REGION_TYPE_PCI_VENDOR_TYPE
| PCI_VENDOR_ID_INTEL
,
457 VFIO_REGION_SUBTYPE_INTEL_IGD_HOST_CFG
, &host
);
459 error_report("IGD device %s does not support host bridge access,"
460 "legacy mode disabled", vdev
->vbasedev
.name
);
464 ret
= vfio_get_dev_region_info(&vdev
->vbasedev
,
465 VFIO_REGION_TYPE_PCI_VENDOR_TYPE
| PCI_VENDOR_ID_INTEL
,
466 VFIO_REGION_SUBTYPE_INTEL_IGD_LPC_CFG
, &lpc
);
468 error_report("IGD device %s does not support LPC bridge access,"
469 "legacy mode disabled", vdev
->vbasedev
.name
);
473 gmch
= vfio_pci_read_config(&vdev
->pdev
, IGD_GMCH
, 4);
476 * If IGD VGA Disable is clear (expected) and VGA is not already enabled,
477 * try to enable it. Probably shouldn't be using legacy mode without VGA,
478 * but also no point in us enabling VGA if disabled in hardware.
480 if (!(gmch
& 0x2) && !vdev
->vga
&& vfio_populate_vga(vdev
, &err
)) {
481 error_reportf_err(err
, VFIO_MSG_PREFIX
, vdev
->vbasedev
.name
);
482 error_report("IGD device %s failed to enable VGA access, "
483 "legacy mode disabled", vdev
->vbasedev
.name
);
487 /* Create our LPC/ISA bridge */
488 ret
= vfio_pci_igd_lpc_init(vdev
, lpc
);
490 error_report("IGD device %s failed to create LPC bridge, "
491 "legacy mode disabled", vdev
->vbasedev
.name
);
495 /* Stuff some host values into the VM PCI host bridge */
496 ret
= vfio_pci_igd_host_init(vdev
, host
);
498 error_report("IGD device %s failed to modify host bridge, "
499 "legacy mode disabled", vdev
->vbasedev
.name
);
503 /* Setup OpRegion access */
504 ret
= vfio_pci_igd_opregion_init(vdev
, opregion
, &err
);
506 error_append_hint(&err
, "IGD legacy mode disabled\n");
507 error_reportf_err(err
, VFIO_MSG_PREFIX
, vdev
->vbasedev
.name
);
511 /* Setup our quirk to munge GTT addresses to the VM allocated buffer */
512 quirk
= vfio_quirk_alloc(2);
513 igd
= quirk
->data
= g_malloc0(sizeof(*igd
));
516 igd
->bdsm
= vfio_pci_read_config(&vdev
->pdev
, IGD_BDSM
, 4);
517 igd
->bdsm
&= ~((1 * MiB
) - 1); /* 1MB aligned */
519 memory_region_init_io(&quirk
->mem
[0], OBJECT(vdev
), &vfio_igd_index_quirk
,
520 igd
, "vfio-igd-index-quirk", 4);
521 memory_region_add_subregion_overlap(vdev
->bars
[nr
].region
.mem
,
522 0, &quirk
->mem
[0], 1);
524 memory_region_init_io(&quirk
->mem
[1], OBJECT(vdev
), &vfio_igd_data_quirk
,
525 igd
, "vfio-igd-data-quirk", 4);
526 memory_region_add_subregion_overlap(vdev
->bars
[nr
].region
.mem
,
527 4, &quirk
->mem
[1], 1);
529 QLIST_INSERT_HEAD(&vdev
->bars
[nr
].quirks
, quirk
, next
);
531 /* Determine the size of stolen memory needed for GTT */
532 ggms_mb
= (gmch
>> (gen
< 8 ? 8 : 6)) & 0x3;
534 ggms_mb
= 1 << ggms_mb
;
538 * Assume we have no GMS memory, but allow it to be overridden by device
539 * option (experimental). The spec doesn't actually allow zero GMS when
540 * when IVD (IGD VGA Disable) is clear, but the claim is that it's unused,
541 * so let's not waste VM memory for it.
543 gmch
&= ~((gen
< 8 ? 0x1f : 0xff) << (gen
< 8 ? 3 : 8));
546 if (vdev
->igd_gms
<= 0x10) {
547 gms_mb
= vdev
->igd_gms
* 32;
548 gmch
|= vdev
->igd_gms
<< (gen
< 8 ? 3 : 8);
550 error_report("Unsupported IGD GMS value 0x%x", vdev
->igd_gms
);
556 * Request reserved memory for stolen memory via fw_cfg. VM firmware
557 * must allocate a 1MB aligned reserved memory region below 4GB with
558 * the requested size (in bytes) for use by the Intel PCI class VGA
559 * device at VM address 00:02.0. The base address of this reserved
560 * memory region must be written to the device BDSM register at PCI
561 * config offset 0x5C.
563 bdsm_size
= g_malloc(sizeof(*bdsm_size
));
564 *bdsm_size
= cpu_to_le64((ggms_mb
+ gms_mb
) * MiB
);
565 fw_cfg_add_file(fw_cfg_find(), "etc/igd-bdsm-size",
566 bdsm_size
, sizeof(*bdsm_size
));
568 /* GMCH is read-only, emulated */
569 pci_set_long(vdev
->pdev
.config
+ IGD_GMCH
, gmch
);
570 pci_set_long(vdev
->pdev
.wmask
+ IGD_GMCH
, 0);
571 pci_set_long(vdev
->emulated_config_bits
+ IGD_GMCH
, ~0);
573 /* BDSM is read-write, emulated. The BIOS needs to be able to write it */
574 pci_set_long(vdev
->pdev
.config
+ IGD_BDSM
, 0);
575 pci_set_long(vdev
->pdev
.wmask
+ IGD_BDSM
, ~0);
576 pci_set_long(vdev
->emulated_config_bits
+ IGD_BDSM
, ~0);
579 * This IOBAR gives us access to GTTADR, which allows us to write to
580 * the GTT itself. So let's go ahead and write zero to all the GTT
581 * entries to avoid spurious DMA faults. Be sure I/O access is enabled
582 * before talking to the device.
584 if (pread(vdev
->vbasedev
.fd
, &cmd_orig
, sizeof(cmd_orig
),
585 vdev
->config_offset
+ PCI_COMMAND
) != sizeof(cmd_orig
)) {
586 error_report("IGD device %s - failed to read PCI command register",
587 vdev
->vbasedev
.name
);
590 cmd
= cmd_orig
| PCI_COMMAND_IO
;
592 if (pwrite(vdev
->vbasedev
.fd
, &cmd
, sizeof(cmd
),
593 vdev
->config_offset
+ PCI_COMMAND
) != sizeof(cmd
)) {
594 error_report("IGD device %s - failed to write PCI command register",
595 vdev
->vbasedev
.name
);
598 for (i
= 1; i
< vfio_igd_gtt_max(vdev
); i
+= 4) {
599 vfio_region_write(&vdev
->bars
[4].region
, 0, i
, 4);
600 vfio_region_write(&vdev
->bars
[4].region
, 4, 0, 4);
603 if (pwrite(vdev
->vbasedev
.fd
, &cmd_orig
, sizeof(cmd_orig
),
604 vdev
->config_offset
+ PCI_COMMAND
) != sizeof(cmd_orig
)) {
605 error_report("IGD device %s - failed to restore PCI command register",
606 vdev
->vbasedev
.name
);
609 trace_vfio_pci_igd_bdsm_enabled(vdev
->vbasedev
.name
, ggms_mb
+ gms_mb
);