xref: /openbmc/qemu/docs/system/target-i386.rst (revision 705f48cc221fea128abdcc334606931e971229e4)
1.. _QEMU-PC-System-emulator:
2
3x86 (PC) System emulator
4------------------------
5
6.. _pcsys_005fdevices:
7
8Peripherals
9~~~~~~~~~~~
10
11The QEMU PC System emulator simulates the following peripherals:
12
13-  i440FX host PCI bridge and PIIX3 PCI to ISA bridge
14
15-  Cirrus CLGD 5446 PCI VGA card or dummy VGA card with Bochs VESA
16   extensions (hardware level, including all non standard modes).
17
18-  PS/2 mouse and keyboard
19
20-  2 PCI IDE interfaces with hard disk and CD-ROM support
21
22-  Floppy disk
23
24-  PCI and ISA network adapters
25
26-  Serial ports
27
28-  IPMI BMC, either and internal or external one
29
30-  Creative SoundBlaster 16 sound card
31
32-  ENSONIQ AudioPCI ES1370 sound card
33
34-  Intel 82801AA AC97 Audio compatible sound card
35
36-  Intel HD Audio Controller and HDA codec
37
38-  Adlib (OPL2) - Yamaha YM3812 compatible chip
39
40-  Gravis Ultrasound GF1 sound card
41
42-  CS4231A compatible sound card
43
44-  PCI UHCI, OHCI, EHCI or XHCI USB controller and a virtual USB-1.1
45   hub.
46
47SMP is supported with up to 255 CPUs.
48
49QEMU uses the PC BIOS from the Seabios project and the Plex86/Bochs LGPL
50VGA BIOS.
51
52QEMU uses YM3812 emulation by Tatsuyuki Satoh.
53
54QEMU uses GUS emulation (GUSEMU32 http://www.deinmeister.de/gusemu/) by
55Tibor \"TS\" Schütz.
56
57Note that, by default, GUS shares IRQ(7) with parallel ports and so QEMU
58must be told to not have parallel ports to have working GUS.
59
60.. parsed-literal::
61
62   |qemu_system_x86| dos.img -soundhw gus -parallel none
63
64Alternatively:
65
66.. parsed-literal::
67
68   |qemu_system_x86| dos.img -device gus,irq=5
69
70Or some other unclaimed IRQ.
71
72CS4231A is the chip used in Windows Sound System and GUSMAX products
73
74.. include:: cpu-models-x86.rst.inc
75
76.. _pcsys_005freq:
77
78OS requirements
79~~~~~~~~~~~~~~~
80
81On x86_64 hosts, the default set of CPU features enabled by the KVM
82accelerator require the host to be running Linux v4.5 or newer. Red Hat
83Enterprise Linux 7 is also supported, since the required
84functionality was backported.
85