2 * QEMU i440FX PCI Bridge Emulation
4 * Copyright (c) 2006 Fabrice Bellard
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
25 #include "qemu/osdep.h"
26 #include "qemu/units.h"
27 #include "qemu/range.h"
28 #include "hw/i386/pc.h"
29 #include "hw/pci/pci.h"
30 #include "hw/pci/pci_host.h"
31 #include "hw/pci-host/i440fx.h"
32 #include "hw/qdev-properties.h"
33 #include "hw/sysbus.h"
34 #include "qapi/error.h"
35 #include "migration/vmstate.h"
36 #include "qapi/visitor.h"
37 #include "qemu/error-report.h"
38 #include "qom/object.h"
41 * I440FX chipset data sheet.
42 * https://wiki.qemu.org/File:29054901.pdf
45 typedef struct I440FXState I440FXState
;
46 DECLARE_INSTANCE_CHECKER(I440FXState
, I440FX_PCI_HOST_BRIDGE
,
47 TYPE_I440FX_PCI_HOST_BRIDGE
)
50 PCIHostState parent_obj
;
52 uint64_t pci_hole64_size
;
54 uint32_t short_root_bus
;
57 #define I440FX_PAM 0x59
58 #define I440FX_PAM_SIZE 7
59 #define I440FX_SMRAM 0x72
61 /* Keep it 2G to comply with older win32 guests */
62 #define I440FX_PCI_HOST_HOLE64_SIZE_DEFAULT (1ULL << 31)
64 /* Older coreboot versions (4.0 and older) read a config register that doesn't
65 * exist in real hardware, to get the RAM size from QEMU.
67 #define I440FX_COREBOOT_RAM_SIZE 0x57
69 static void i440fx_update_memory_mappings(PCII440FXState
*d
)
72 PCIDevice
*pd
= PCI_DEVICE(d
);
74 memory_region_transaction_begin();
75 for (i
= 0; i
< ARRAY_SIZE(d
->pam_regions
); i
++) {
76 pam_update(&d
->pam_regions
[i
], i
,
77 pd
->config
[I440FX_PAM
+ DIV_ROUND_UP(i
, 2)]);
79 memory_region_set_enabled(&d
->smram_region
,
80 !(pd
->config
[I440FX_SMRAM
] & SMRAM_D_OPEN
));
81 memory_region_set_enabled(&d
->smram
,
82 pd
->config
[I440FX_SMRAM
] & SMRAM_G_SMRAME
);
83 memory_region_transaction_commit();
87 static void i440fx_write_config(PCIDevice
*dev
,
88 uint32_t address
, uint32_t val
, int len
)
90 PCII440FXState
*d
= I440FX_PCI_DEVICE(dev
);
92 /* XXX: implement SMRAM.D_LOCK */
93 pci_default_write_config(dev
, address
, val
, len
);
94 if (ranges_overlap(address
, len
, I440FX_PAM
, I440FX_PAM_SIZE
) ||
95 range_covers_byte(address
, len
, I440FX_SMRAM
)) {
96 i440fx_update_memory_mappings(d
);
100 static int i440fx_post_load(void *opaque
, int version_id
)
102 PCII440FXState
*d
= opaque
;
104 i440fx_update_memory_mappings(d
);
108 static const VMStateDescription vmstate_i440fx
= {
111 .minimum_version_id
= 3,
112 .post_load
= i440fx_post_load
,
113 .fields
= (VMStateField
[]) {
114 VMSTATE_PCI_DEVICE(parent_obj
, PCII440FXState
),
115 /* Used to be smm_enabled, which was basically always zero because
116 * SeaBIOS hardly uses SMM. SMRAM is now handled by CPU code.
119 VMSTATE_END_OF_LIST()
123 static void i440fx_pcihost_get_pci_hole_start(Object
*obj
, Visitor
*v
,
124 const char *name
, void *opaque
,
127 I440FXState
*s
= I440FX_PCI_HOST_BRIDGE(obj
);
131 val64
= range_is_empty(&s
->pci_hole
) ? 0 : range_lob(&s
->pci_hole
);
133 assert(value
== val64
);
134 visit_type_uint32(v
, name
, &value
, errp
);
137 static void i440fx_pcihost_get_pci_hole_end(Object
*obj
, Visitor
*v
,
138 const char *name
, void *opaque
,
141 I440FXState
*s
= I440FX_PCI_HOST_BRIDGE(obj
);
145 val64
= range_is_empty(&s
->pci_hole
) ? 0 : range_upb(&s
->pci_hole
) + 1;
147 assert(value
== val64
);
148 visit_type_uint32(v
, name
, &value
, errp
);
152 * The 64bit PCI hole start is set by the Guest firmware
153 * as the address of the first 64bit PCI MEM resource.
154 * If no PCI device has resources on the 64bit area,
155 * the 64bit PCI hole will start after "over 4G RAM" and the
156 * reserved space for memory hotplug if any.
158 static uint64_t i440fx_pcihost_get_pci_hole64_start_value(Object
*obj
)
160 PCIHostState
*h
= PCI_HOST_BRIDGE(obj
);
161 I440FXState
*s
= I440FX_PCI_HOST_BRIDGE(obj
);
165 pci_bus_get_w64_range(h
->bus
, &w64
);
166 value
= range_is_empty(&w64
) ? 0 : range_lob(&w64
);
167 if (!value
&& s
->pci_hole64_fix
) {
168 value
= pc_pci_hole64_start();
173 static void i440fx_pcihost_get_pci_hole64_start(Object
*obj
, Visitor
*v
,
175 void *opaque
, Error
**errp
)
177 uint64_t hole64_start
= i440fx_pcihost_get_pci_hole64_start_value(obj
);
179 visit_type_uint64(v
, name
, &hole64_start
, errp
);
183 * The 64bit PCI hole end is set by the Guest firmware
184 * as the address of the last 64bit PCI MEM resource.
185 * Then it is expanded to the PCI_HOST_PROP_PCI_HOLE64_SIZE
186 * that can be configured by the user.
188 static void i440fx_pcihost_get_pci_hole64_end(Object
*obj
, Visitor
*v
,
189 const char *name
, void *opaque
,
192 PCIHostState
*h
= PCI_HOST_BRIDGE(obj
);
193 I440FXState
*s
= I440FX_PCI_HOST_BRIDGE(obj
);
194 uint64_t hole64_start
= i440fx_pcihost_get_pci_hole64_start_value(obj
);
196 uint64_t value
, hole64_end
;
198 pci_bus_get_w64_range(h
->bus
, &w64
);
199 value
= range_is_empty(&w64
) ? 0 : range_upb(&w64
) + 1;
200 hole64_end
= ROUND_UP(hole64_start
+ s
->pci_hole64_size
, 1ULL << 30);
201 if (s
->pci_hole64_fix
&& value
< hole64_end
) {
204 visit_type_uint64(v
, name
, &value
, errp
);
207 static void i440fx_pcihost_initfn(Object
*obj
)
209 PCIHostState
*s
= PCI_HOST_BRIDGE(obj
);
211 memory_region_init_io(&s
->conf_mem
, obj
, &pci_host_conf_le_ops
, s
,
213 memory_region_init_io(&s
->data_mem
, obj
, &pci_host_data_le_ops
, s
,
216 object_property_add(obj
, PCI_HOST_PROP_PCI_HOLE_START
, "uint32",
217 i440fx_pcihost_get_pci_hole_start
,
220 object_property_add(obj
, PCI_HOST_PROP_PCI_HOLE_END
, "uint32",
221 i440fx_pcihost_get_pci_hole_end
,
224 object_property_add(obj
, PCI_HOST_PROP_PCI_HOLE64_START
, "uint64",
225 i440fx_pcihost_get_pci_hole64_start
,
228 object_property_add(obj
, PCI_HOST_PROP_PCI_HOLE64_END
, "uint64",
229 i440fx_pcihost_get_pci_hole64_end
,
233 static void i440fx_pcihost_realize(DeviceState
*dev
, Error
**errp
)
235 PCIHostState
*s
= PCI_HOST_BRIDGE(dev
);
236 SysBusDevice
*sbd
= SYS_BUS_DEVICE(dev
);
238 sysbus_add_io(sbd
, 0xcf8, &s
->conf_mem
);
239 sysbus_init_ioports(sbd
, 0xcf8, 4);
241 sysbus_add_io(sbd
, 0xcfc, &s
->data_mem
);
242 sysbus_init_ioports(sbd
, 0xcfc, 4);
244 /* register i440fx 0xcf8 port as coalesced pio */
245 memory_region_set_flush_coalesced(&s
->data_mem
);
246 memory_region_add_coalescing(&s
->conf_mem
, 0, 4);
249 static void i440fx_realize(PCIDevice
*dev
, Error
**errp
)
251 dev
->config
[I440FX_SMRAM
] = 0x02;
253 if (object_property_get_bool(qdev_get_machine(), "iommu", NULL
)) {
254 warn_report("i440fx doesn't support emulated iommu");
258 PCIBus
*i440fx_init(const char *host_type
, const char *pci_type
,
259 PCII440FXState
**pi440fx_state
,
260 MemoryRegion
*address_space_mem
,
261 MemoryRegion
*address_space_io
,
263 ram_addr_t below_4g_mem_size
,
264 ram_addr_t above_4g_mem_size
,
265 MemoryRegion
*pci_address_space
,
266 MemoryRegion
*ram_memory
)
276 dev
= qdev_new(host_type
);
277 s
= PCI_HOST_BRIDGE(dev
);
278 b
= pci_root_bus_new(dev
, NULL
, pci_address_space
,
279 address_space_io
, 0, TYPE_PCI_BUS
);
281 object_property_add_child(qdev_get_machine(), "i440fx", OBJECT(dev
));
282 sysbus_realize_and_unref(SYS_BUS_DEVICE(dev
), &error_fatal
);
284 d
= pci_create_simple(b
, 0, pci_type
);
285 *pi440fx_state
= I440FX_PCI_DEVICE(d
);
287 f
->system_memory
= address_space_mem
;
288 f
->pci_address_space
= pci_address_space
;
289 f
->ram_memory
= ram_memory
;
291 i440fx
= I440FX_PCI_HOST_BRIDGE(dev
);
292 range_set_bounds(&i440fx
->pci_hole
, below_4g_mem_size
,
293 IO_APIC_DEFAULT_ADDRESS
- 1);
295 /* setup pci memory mapping */
296 pc_pci_as_mapping_init(OBJECT(f
), f
->system_memory
,
297 f
->pci_address_space
);
299 /* if *disabled* show SMRAM to all CPUs */
300 memory_region_init_alias(&f
->smram_region
, OBJECT(d
), "smram-region",
301 f
->pci_address_space
, 0xa0000, 0x20000);
302 memory_region_add_subregion_overlap(f
->system_memory
, 0xa0000,
303 &f
->smram_region
, 1);
304 memory_region_set_enabled(&f
->smram_region
, true);
306 /* smram, as seen by SMM CPUs */
307 memory_region_init(&f
->smram
, OBJECT(d
), "smram", 4 * GiB
);
308 memory_region_set_enabled(&f
->smram
, true);
309 memory_region_init_alias(&f
->low_smram
, OBJECT(d
), "smram-low",
310 f
->ram_memory
, 0xa0000, 0x20000);
311 memory_region_set_enabled(&f
->low_smram
, true);
312 memory_region_add_subregion(&f
->smram
, 0xa0000, &f
->low_smram
);
313 object_property_add_const_link(qdev_get_machine(), "smram",
316 init_pam(dev
, f
->ram_memory
, f
->system_memory
, f
->pci_address_space
,
317 &f
->pam_regions
[0], PAM_BIOS_BASE
, PAM_BIOS_SIZE
);
318 for (i
= 0; i
< ARRAY_SIZE(f
->pam_regions
) - 1; ++i
) {
319 init_pam(dev
, f
->ram_memory
, f
->system_memory
, f
->pci_address_space
,
320 &f
->pam_regions
[i
+1], PAM_EXPAN_BASE
+ i
* PAM_EXPAN_SIZE
,
324 ram_size
= ram_size
/ 8 / 1024 / 1024;
325 if (ram_size
> 255) {
328 d
->config
[I440FX_COREBOOT_RAM_SIZE
] = ram_size
;
330 i440fx_update_memory_mappings(f
);
335 PCIBus
*find_i440fx(void)
337 PCIHostState
*s
= OBJECT_CHECK(PCIHostState
,
338 object_resolve_path("/machine/i440fx", NULL
),
339 TYPE_PCI_HOST_BRIDGE
);
340 return s
? s
->bus
: NULL
;
343 static void i440fx_class_init(ObjectClass
*klass
, void *data
)
345 DeviceClass
*dc
= DEVICE_CLASS(klass
);
346 PCIDeviceClass
*k
= PCI_DEVICE_CLASS(klass
);
348 k
->realize
= i440fx_realize
;
349 k
->config_write
= i440fx_write_config
;
350 k
->vendor_id
= PCI_VENDOR_ID_INTEL
;
351 k
->device_id
= PCI_DEVICE_ID_INTEL_82441
;
353 k
->class_id
= PCI_CLASS_BRIDGE_HOST
;
354 dc
->desc
= "Host bridge";
355 dc
->vmsd
= &vmstate_i440fx
;
357 * PCI-facing part of the host bridge, not usable without the
358 * host-facing part, which can't be device_add'ed, yet.
360 dc
->user_creatable
= false;
361 dc
->hotpluggable
= false;
364 static const TypeInfo i440fx_info
= {
365 .name
= TYPE_I440FX_PCI_DEVICE
,
366 .parent
= TYPE_PCI_DEVICE
,
367 .instance_size
= sizeof(PCII440FXState
),
368 .class_init
= i440fx_class_init
,
369 .interfaces
= (InterfaceInfo
[]) {
370 { INTERFACE_CONVENTIONAL_PCI_DEVICE
},
375 static const char *i440fx_pcihost_root_bus_path(PCIHostState
*host_bridge
,
378 I440FXState
*s
= I440FX_PCI_HOST_BRIDGE(host_bridge
);
380 /* For backwards compat with old device paths */
381 if (s
->short_root_bus
) {
387 static Property i440fx_props
[] = {
388 DEFINE_PROP_SIZE(PCI_HOST_PROP_PCI_HOLE64_SIZE
, I440FXState
,
389 pci_hole64_size
, I440FX_PCI_HOST_HOLE64_SIZE_DEFAULT
),
390 DEFINE_PROP_UINT32("short_root_bus", I440FXState
, short_root_bus
, 0),
391 DEFINE_PROP_BOOL("x-pci-hole64-fix", I440FXState
, pci_hole64_fix
, true),
392 DEFINE_PROP_END_OF_LIST(),
395 static void i440fx_pcihost_class_init(ObjectClass
*klass
, void *data
)
397 DeviceClass
*dc
= DEVICE_CLASS(klass
);
398 PCIHostBridgeClass
*hc
= PCI_HOST_BRIDGE_CLASS(klass
);
400 hc
->root_bus_path
= i440fx_pcihost_root_bus_path
;
401 dc
->realize
= i440fx_pcihost_realize
;
403 device_class_set_props(dc
, i440fx_props
);
404 /* Reason: needs to be wired up by pc_init1 */
405 dc
->user_creatable
= false;
408 static const TypeInfo i440fx_pcihost_info
= {
409 .name
= TYPE_I440FX_PCI_HOST_BRIDGE
,
410 .parent
= TYPE_PCI_HOST_BRIDGE
,
411 .instance_size
= sizeof(I440FXState
),
412 .instance_init
= i440fx_pcihost_initfn
,
413 .class_init
= i440fx_pcihost_class_init
,
416 static void i440fx_register_types(void)
418 type_register_static(&i440fx_info
);
419 type_register_static(&i440fx_pcihost_info
);
422 type_init(i440fx_register_types
)