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"
40 * I440FX chipset data sheet.
41 * https://wiki.qemu.org/File:29054901.pdf
44 #define I440FX_PCI_HOST_BRIDGE(obj) \
45 OBJECT_CHECK(I440FXState, (obj), TYPE_I440FX_PCI_HOST_BRIDGE)
47 typedef struct I440FXState
{
48 PCIHostState parent_obj
;
50 uint64_t pci_hole64_size
;
52 uint32_t short_root_bus
;
55 #define I440FX_PAM 0x59
56 #define I440FX_PAM_SIZE 7
57 #define I440FX_SMRAM 0x72
59 /* Keep it 2G to comply with older win32 guests */
60 #define I440FX_PCI_HOST_HOLE64_SIZE_DEFAULT (1ULL << 31)
62 /* Older coreboot versions (4.0 and older) read a config register that doesn't
63 * exist in real hardware, to get the RAM size from QEMU.
65 #define I440FX_COREBOOT_RAM_SIZE 0x57
67 static void i440fx_update_memory_mappings(PCII440FXState
*d
)
70 PCIDevice
*pd
= PCI_DEVICE(d
);
72 memory_region_transaction_begin();
73 for (i
= 0; i
< ARRAY_SIZE(d
->pam_regions
); i
++) {
74 pam_update(&d
->pam_regions
[i
], i
,
75 pd
->config
[I440FX_PAM
+ DIV_ROUND_UP(i
, 2)]);
77 memory_region_set_enabled(&d
->smram_region
,
78 !(pd
->config
[I440FX_SMRAM
] & SMRAM_D_OPEN
));
79 memory_region_set_enabled(&d
->smram
,
80 pd
->config
[I440FX_SMRAM
] & SMRAM_G_SMRAME
);
81 memory_region_transaction_commit();
85 static void i440fx_write_config(PCIDevice
*dev
,
86 uint32_t address
, uint32_t val
, int len
)
88 PCII440FXState
*d
= I440FX_PCI_DEVICE(dev
);
90 /* XXX: implement SMRAM.D_LOCK */
91 pci_default_write_config(dev
, address
, val
, len
);
92 if (ranges_overlap(address
, len
, I440FX_PAM
, I440FX_PAM_SIZE
) ||
93 range_covers_byte(address
, len
, I440FX_SMRAM
)) {
94 i440fx_update_memory_mappings(d
);
98 static int i440fx_post_load(void *opaque
, int version_id
)
100 PCII440FXState
*d
= opaque
;
102 i440fx_update_memory_mappings(d
);
106 static const VMStateDescription vmstate_i440fx
= {
109 .minimum_version_id
= 3,
110 .post_load
= i440fx_post_load
,
111 .fields
= (VMStateField
[]) {
112 VMSTATE_PCI_DEVICE(parent_obj
, PCII440FXState
),
113 /* Used to be smm_enabled, which was basically always zero because
114 * SeaBIOS hardly uses SMM. SMRAM is now handled by CPU code.
117 VMSTATE_END_OF_LIST()
121 static void i440fx_pcihost_get_pci_hole_start(Object
*obj
, Visitor
*v
,
122 const char *name
, void *opaque
,
125 I440FXState
*s
= I440FX_PCI_HOST_BRIDGE(obj
);
129 val64
= range_is_empty(&s
->pci_hole
) ? 0 : range_lob(&s
->pci_hole
);
131 assert(value
== val64
);
132 visit_type_uint32(v
, name
, &value
, errp
);
135 static void i440fx_pcihost_get_pci_hole_end(Object
*obj
, Visitor
*v
,
136 const char *name
, void *opaque
,
139 I440FXState
*s
= I440FX_PCI_HOST_BRIDGE(obj
);
143 val64
= range_is_empty(&s
->pci_hole
) ? 0 : range_upb(&s
->pci_hole
) + 1;
145 assert(value
== val64
);
146 visit_type_uint32(v
, name
, &value
, errp
);
150 * The 64bit PCI hole start is set by the Guest firmware
151 * as the address of the first 64bit PCI MEM resource.
152 * If no PCI device has resources on the 64bit area,
153 * the 64bit PCI hole will start after "over 4G RAM" and the
154 * reserved space for memory hotplug if any.
156 static uint64_t i440fx_pcihost_get_pci_hole64_start_value(Object
*obj
)
158 PCIHostState
*h
= PCI_HOST_BRIDGE(obj
);
159 I440FXState
*s
= I440FX_PCI_HOST_BRIDGE(obj
);
163 pci_bus_get_w64_range(h
->bus
, &w64
);
164 value
= range_is_empty(&w64
) ? 0 : range_lob(&w64
);
165 if (!value
&& s
->pci_hole64_fix
) {
166 value
= pc_pci_hole64_start();
171 static void i440fx_pcihost_get_pci_hole64_start(Object
*obj
, Visitor
*v
,
173 void *opaque
, Error
**errp
)
175 uint64_t hole64_start
= i440fx_pcihost_get_pci_hole64_start_value(obj
);
177 visit_type_uint64(v
, name
, &hole64_start
, errp
);
181 * The 64bit PCI hole end is set by the Guest firmware
182 * as the address of the last 64bit PCI MEM resource.
183 * Then it is expanded to the PCI_HOST_PROP_PCI_HOLE64_SIZE
184 * that can be configured by the user.
186 static void i440fx_pcihost_get_pci_hole64_end(Object
*obj
, Visitor
*v
,
187 const char *name
, void *opaque
,
190 PCIHostState
*h
= PCI_HOST_BRIDGE(obj
);
191 I440FXState
*s
= I440FX_PCI_HOST_BRIDGE(obj
);
192 uint64_t hole64_start
= i440fx_pcihost_get_pci_hole64_start_value(obj
);
194 uint64_t value
, hole64_end
;
196 pci_bus_get_w64_range(h
->bus
, &w64
);
197 value
= range_is_empty(&w64
) ? 0 : range_upb(&w64
) + 1;
198 hole64_end
= ROUND_UP(hole64_start
+ s
->pci_hole64_size
, 1ULL << 30);
199 if (s
->pci_hole64_fix
&& value
< hole64_end
) {
202 visit_type_uint64(v
, name
, &value
, errp
);
205 static void i440fx_pcihost_initfn(Object
*obj
)
207 PCIHostState
*s
= PCI_HOST_BRIDGE(obj
);
209 memory_region_init_io(&s
->conf_mem
, obj
, &pci_host_conf_le_ops
, s
,
211 memory_region_init_io(&s
->data_mem
, obj
, &pci_host_data_le_ops
, s
,
214 object_property_add(obj
, PCI_HOST_PROP_PCI_HOLE_START
, "uint32",
215 i440fx_pcihost_get_pci_hole_start
,
218 object_property_add(obj
, PCI_HOST_PROP_PCI_HOLE_END
, "uint32",
219 i440fx_pcihost_get_pci_hole_end
,
222 object_property_add(obj
, PCI_HOST_PROP_PCI_HOLE64_START
, "uint64",
223 i440fx_pcihost_get_pci_hole64_start
,
226 object_property_add(obj
, PCI_HOST_PROP_PCI_HOLE64_END
, "uint64",
227 i440fx_pcihost_get_pci_hole64_end
,
231 static void i440fx_pcihost_realize(DeviceState
*dev
, Error
**errp
)
233 PCIHostState
*s
= PCI_HOST_BRIDGE(dev
);
234 SysBusDevice
*sbd
= SYS_BUS_DEVICE(dev
);
236 sysbus_add_io(sbd
, 0xcf8, &s
->conf_mem
);
237 sysbus_init_ioports(sbd
, 0xcf8, 4);
239 sysbus_add_io(sbd
, 0xcfc, &s
->data_mem
);
240 sysbus_init_ioports(sbd
, 0xcfc, 4);
242 /* register i440fx 0xcf8 port as coalesced pio */
243 memory_region_set_flush_coalesced(&s
->data_mem
);
244 memory_region_add_coalescing(&s
->conf_mem
, 0, 4);
247 static void i440fx_realize(PCIDevice
*dev
, Error
**errp
)
249 dev
->config
[I440FX_SMRAM
] = 0x02;
251 if (object_property_get_bool(qdev_get_machine(), "iommu", NULL
)) {
252 warn_report("i440fx doesn't support emulated iommu");
256 PCIBus
*i440fx_init(const char *host_type
, const char *pci_type
,
257 PCII440FXState
**pi440fx_state
,
258 MemoryRegion
*address_space_mem
,
259 MemoryRegion
*address_space_io
,
261 ram_addr_t below_4g_mem_size
,
262 ram_addr_t above_4g_mem_size
,
263 MemoryRegion
*pci_address_space
,
264 MemoryRegion
*ram_memory
)
274 dev
= qdev_new(host_type
);
275 s
= PCI_HOST_BRIDGE(dev
);
276 b
= pci_root_bus_new(dev
, NULL
, pci_address_space
,
277 address_space_io
, 0, TYPE_PCI_BUS
);
279 object_property_add_child(qdev_get_machine(), "i440fx", OBJECT(dev
));
280 sysbus_realize_and_unref(SYS_BUS_DEVICE(dev
), &error_fatal
);
282 d
= pci_create_simple(b
, 0, pci_type
);
283 *pi440fx_state
= I440FX_PCI_DEVICE(d
);
285 f
->system_memory
= address_space_mem
;
286 f
->pci_address_space
= pci_address_space
;
287 f
->ram_memory
= ram_memory
;
289 i440fx
= I440FX_PCI_HOST_BRIDGE(dev
);
290 range_set_bounds(&i440fx
->pci_hole
, below_4g_mem_size
,
291 IO_APIC_DEFAULT_ADDRESS
- 1);
293 /* setup pci memory mapping */
294 pc_pci_as_mapping_init(OBJECT(f
), f
->system_memory
,
295 f
->pci_address_space
);
297 /* if *disabled* show SMRAM to all CPUs */
298 memory_region_init_alias(&f
->smram_region
, OBJECT(d
), "smram-region",
299 f
->pci_address_space
, 0xa0000, 0x20000);
300 memory_region_add_subregion_overlap(f
->system_memory
, 0xa0000,
301 &f
->smram_region
, 1);
302 memory_region_set_enabled(&f
->smram_region
, true);
304 /* smram, as seen by SMM CPUs */
305 memory_region_init(&f
->smram
, OBJECT(d
), "smram", 4 * GiB
);
306 memory_region_set_enabled(&f
->smram
, true);
307 memory_region_init_alias(&f
->low_smram
, OBJECT(d
), "smram-low",
308 f
->ram_memory
, 0xa0000, 0x20000);
309 memory_region_set_enabled(&f
->low_smram
, true);
310 memory_region_add_subregion(&f
->smram
, 0xa0000, &f
->low_smram
);
311 object_property_add_const_link(qdev_get_machine(), "smram",
314 init_pam(dev
, f
->ram_memory
, f
->system_memory
, f
->pci_address_space
,
315 &f
->pam_regions
[0], PAM_BIOS_BASE
, PAM_BIOS_SIZE
);
316 for (i
= 0; i
< ARRAY_SIZE(f
->pam_regions
) - 1; ++i
) {
317 init_pam(dev
, f
->ram_memory
, f
->system_memory
, f
->pci_address_space
,
318 &f
->pam_regions
[i
+1], PAM_EXPAN_BASE
+ i
* PAM_EXPAN_SIZE
,
322 ram_size
= ram_size
/ 8 / 1024 / 1024;
323 if (ram_size
> 255) {
326 d
->config
[I440FX_COREBOOT_RAM_SIZE
] = ram_size
;
328 i440fx_update_memory_mappings(f
);
333 PCIBus
*find_i440fx(void)
335 PCIHostState
*s
= OBJECT_CHECK(PCIHostState
,
336 object_resolve_path("/machine/i440fx", NULL
),
337 TYPE_PCI_HOST_BRIDGE
);
338 return s
? s
->bus
: NULL
;
341 static void i440fx_class_init(ObjectClass
*klass
, void *data
)
343 DeviceClass
*dc
= DEVICE_CLASS(klass
);
344 PCIDeviceClass
*k
= PCI_DEVICE_CLASS(klass
);
346 k
->realize
= i440fx_realize
;
347 k
->config_write
= i440fx_write_config
;
348 k
->vendor_id
= PCI_VENDOR_ID_INTEL
;
349 k
->device_id
= PCI_DEVICE_ID_INTEL_82441
;
351 k
->class_id
= PCI_CLASS_BRIDGE_HOST
;
352 dc
->desc
= "Host bridge";
353 dc
->vmsd
= &vmstate_i440fx
;
355 * PCI-facing part of the host bridge, not usable without the
356 * host-facing part, which can't be device_add'ed, yet.
358 dc
->user_creatable
= false;
359 dc
->hotpluggable
= false;
362 static const TypeInfo i440fx_info
= {
363 .name
= TYPE_I440FX_PCI_DEVICE
,
364 .parent
= TYPE_PCI_DEVICE
,
365 .instance_size
= sizeof(PCII440FXState
),
366 .class_init
= i440fx_class_init
,
367 .interfaces
= (InterfaceInfo
[]) {
368 { INTERFACE_CONVENTIONAL_PCI_DEVICE
},
373 static const char *i440fx_pcihost_root_bus_path(PCIHostState
*host_bridge
,
376 I440FXState
*s
= I440FX_PCI_HOST_BRIDGE(host_bridge
);
378 /* For backwards compat with old device paths */
379 if (s
->short_root_bus
) {
385 static Property i440fx_props
[] = {
386 DEFINE_PROP_SIZE(PCI_HOST_PROP_PCI_HOLE64_SIZE
, I440FXState
,
387 pci_hole64_size
, I440FX_PCI_HOST_HOLE64_SIZE_DEFAULT
),
388 DEFINE_PROP_UINT32("short_root_bus", I440FXState
, short_root_bus
, 0),
389 DEFINE_PROP_BOOL("x-pci-hole64-fix", I440FXState
, pci_hole64_fix
, true),
390 DEFINE_PROP_END_OF_LIST(),
393 static void i440fx_pcihost_class_init(ObjectClass
*klass
, void *data
)
395 DeviceClass
*dc
= DEVICE_CLASS(klass
);
396 PCIHostBridgeClass
*hc
= PCI_HOST_BRIDGE_CLASS(klass
);
398 hc
->root_bus_path
= i440fx_pcihost_root_bus_path
;
399 dc
->realize
= i440fx_pcihost_realize
;
401 device_class_set_props(dc
, i440fx_props
);
402 /* Reason: needs to be wired up by pc_init1 */
403 dc
->user_creatable
= false;
406 static const TypeInfo i440fx_pcihost_info
= {
407 .name
= TYPE_I440FX_PCI_HOST_BRIDGE
,
408 .parent
= TYPE_PCI_HOST_BRIDGE
,
409 .instance_size
= sizeof(I440FXState
),
410 .instance_init
= i440fx_pcihost_initfn
,
411 .class_init
= i440fx_pcihost_class_init
,
414 static void i440fx_register_types(void)
416 type_register_static(&i440fx_info
);
417 type_register_static(&i440fx_pcihost_info
);
420 type_init(i440fx_register_types
)