Merge remote-tracking branch 'remotes/kevin/tags/for-upstream' into staging
[qemu/ar7.git] / docs / config / q35-emulated.cfg
blob99ac918e78a2553c0214dacf23d5de8668e869a0
1 # q35 - Emulated guest (graphical console)
2 # =========================================================
4 # Usage:
6 #   $ qemu-system-x86_64 \
7 #     -nodefaults \
8 #     -readconfig q35-emulated.cfg
10 # You will probably need to tweak the lines marked as
11 # CHANGE ME before being able to use this configuration!
13 # The guest will have a selection of emulated devices that
14 # closely resembles that of a physical machine, and will be
15 # accessed through a graphical console.
17 # ---------------------------------------------------------
19 # Using -nodefaults is required to have full control over
20 # the virtual hardware: when it's specified, QEMU will
21 # populate the board with only the builtin peripherals
22 # plus a small selection of core PCI devices and
23 # controllers; the user will then have to explicitly add
24 # further devices.
26 # The core PCI devices show up in the guest as:
28 #   00:00.0 Host bridge
29 #   00:1f.0 ISA bridge / LPC
30 #   00:1f.2 SATA (AHCI) controller
31 #   00:1f.3 SMBus controller
33 # This configuration file adds a number of devices that
34 # are pretty much guaranteed to be present in every single
35 # physical machine based on q35, more specifically:
37 #   00:01.0 VGA compatible controller
38 #   00:19.0 Ethernet controller
39 #   00:1a.* USB controller (#2)
40 #   00:1b.0 Audio device
41 #   00:1c.* PCI bridge (PCI Express Root Ports)
42 #   00:1d.* USB Controller (#1)
43 #   00:1e.0 PCI bridge (legacy PCI bridge)
45 # More information about these devices is available below.
48 # Machine options
49 # =========================================================
51 # We use the q35 machine type and enable KVM acceleration
52 # for better performance.
54 # Using less than 1 GiB of memory is probably not going to
55 # yield good performance in the guest, and might even lead
56 # to obscure boot issues in some cases.
58 # Unfortunately, there is no way to configure the CPU model
59 # in this file, so it will have to be provided on the
60 # command line.
62 [machine]
63   type = "q35"
64   accel = "kvm"
66 [memory]
67   size = "1024"
70 # PCI bridge (PCI Express Root Ports)
71 # =========================================================
73 # We add four PCI Express Root Ports, all sharing the same
74 # slot on the PCI Express  Root Bus. These ports support
75 # hotplug.
77 [device "ich9-pcie-port-1"]
78   driver = "ioh3420"
79   multifunction = "on"
80   bus = "pcie.0"
81   addr = "1c.0"
82   port = "1"
83   chassis = "1"
85 [device "ich9-pcie-port-2"]
86   driver = "ioh3420"
87   multifunction = "on"
88   bus = "pcie.0"
89   addr = "1c.1"
90   port = "2"
91   chassis = "2"
93 [device "ich9-pcie-port-3"]
94   driver = "ioh3420"
95   multifunction = "on"
96   bus = "pcie.0"
97   addr = "1c.2"
98   port = "3"
99   chassis = "3"
101 [device "ich9-pcie-port-4"]
102   driver = "ioh3420"
103   multifunction = "on"
104   bus = "pcie.0"
105   addr = "1c.3"
106   port = "4"
107   chassis = "4"
110 # PCI bridge (legacy PCI bridge)
111 # =========================================================
113 # This bridge can be used to build an independent topology
114 # for legacy PCI devices. PCI Express devices should be
115 # plugged into PCI Express slots instead, so ideally there
116 # will be no devices connected to this bridge.
118 [device "ich9-pci-bridge"]
119   driver = "i82801b11-bridge"
120   bus = "pcie.0"
121   addr = "1e.0"
124 # SATA storage
125 # =========================================================
127 # An implicit SATA controller is created automatically for
128 # every single q35 guest; here we create a disk, backed by
129 # a qcow2 disk image on the host's filesystem, and attach
130 # it to that controller so that the guest can use it.
132 # We also create an optical disk, mostly for installation
133 # purposes: once the guest OS has been successfully
134 # installed, the guest will no longer boot from optical
135 # media. If you don't want, or no longer want, to have an
136 # optical disk in the guest you can safely comment out
137 # all relevant sections below.
139 [device "sata-disk"]
140   driver = "ide-hd"
141   bus = "ide.0"
142   drive = "disk"
143   bootindex = "1"
145 [drive "disk"]
146   file = "guest.qcow2"                          # CHANGE ME
147   format = "qcow2"
148   if = "none"
150 [device "sata-optical-disk"]
151   driver = "ide-cd"
152   bus = "ide.1"
153   drive = "optical-disk"
154   bootindex = "2"
156 [drive "optical-disk"]
157   file = "install.iso"                          # CHANGE ME
158   format = "raw"
159   if = "none"
162 # USB controller (#1)
163 # =========================================================
165 # EHCI controller + UHCI companion controllers.
167 [device "ich9-ehci-1"]
168   driver = "ich9-usb-ehci1"
169   multifunction = "on"
170   bus = "pcie.0"
171   addr = "1d.7"
173 [device "ich9-uhci-1"]
174   driver = "ich9-usb-uhci1"
175   multifunction = "on"
176   bus = "pcie.0"
177   addr = "1d.0"
178   masterbus = "ich9-ehci-1.0"
179   firstport = "0"
181 [device "ich9-uhci-2"]
182   driver = "ich9-usb-uhci2"
183   multifunction = "on"
184   bus = "pcie.0"
185   addr = "1d.1"
186   masterbus = "ich9-ehci-1.0"
187   firstport = "2"
189 [device "ich9-uhci-3"]
190   driver = "ich9-usb-uhci3"
191   multifunction = "on"
192   bus = "pcie.0"
193   addr = "1d.2"
194   masterbus = "ich9-ehci-1.0"
195   firstport = "4"
198 # USB controller (#2)
199 # =========================================================
201 # EHCI controller + UHCI companion controllers.
203 [device "ich9-ehci-2"]
204   driver = "ich9-usb-ehci2"
205   multifunction = "on"
206   bus = "pcie.0"
207   addr = "1a.7"
209 [device "ich9-uhci-4"]
210   driver = "ich9-usb-uhci4"
211   multifunction = "on"
212   bus = "pcie.0"
213   addr = "1a.0"
214   masterbus = "ich9-ehci-2.0"
215   firstport = "0"
217 [device "ich9-uhci-5"]
218   driver = "ich9-usb-uhci5"
219   multifunction = "on"
220   bus = "pcie.0"
221   addr = "1a.1"
222   masterbus = "ich9-ehci-2.0"
223   firstport = "2"
225 [device "ich9-uhci-6"]
226   driver = "ich9-usb-uhci6"
227   multifunction = "on"
228   bus = "pcie.0"
229   addr = "1a.2"
230   masterbus = "ich9-ehci-2.0"
231   firstport = "4"
234 # Ethernet controller
235 # =========================================================
237 # We add a Gigabit Ethernet interface to the guest; on the
238 # host side, we take advantage of user networking so that
239 # the QEMU process doesn't require any additional
240 # privileges.
242 [netdev "hostnet"]
243   type = "user"
245 [device "net"]
246   driver = "e1000"
247   netdev = "hostnet"
248   bus = "pcie.0"
249   addr = "19.0"
252 # VGA compatible controller
253 # =========================================================
255 # We use stdvga instead of Cirrus as it supports more video
256 # modes and is closer to what actual hardware looks like.
258 # If you're running the guest on a remote, potentially
259 # headless host, you will probably want to append something
260 # like
262 #   -display vnc=127.0.0.1:0
264 # to the command line in order to prevent QEMU from
265 # creating a graphical display window on the host and
266 # enable remote access instead.
268 [device "video"]
269   driver = "VGA"
270   bus = "pcie.0"
271   addr = "01.0"
274 # Audio device
275 # =========================================================
277 # The sound card is a legacy PCI device that is plugged
278 # directly into the PCI Express Root Bus.
280 [device "ich9-hda-audio"]
281   driver = "ich9-intel-hda"
282   bus = "pcie.0"
283   addr = "1b.0"
285 [device "ich9-hda-duplex"]
286   driver = "hda-duplex"
287   bus = "ich9-hda-audio.0"
288   cad = "0"