4 #include "exec/memory.h"
5 #include "sysemu/dma.h"
7 /* PCI includes legacy ISA access. */
8 #include "hw/isa/isa.h"
10 extern bool pci_available
;
14 #define PCI_DEVFN(slot, func) ((((slot) & 0x1f) << 3) | ((func) & 0x07))
15 #define PCI_BUS_NUM(x) (((x) >> 8) & 0xff)
16 #define PCI_SLOT(devfn) (((devfn) >> 3) & 0x1f)
17 #define PCI_FUNC(devfn) ((devfn) & 0x07)
18 #define PCI_BUILD_BDF(bus, devfn) ((bus << 8) | (devfn))
19 #define PCI_BDF_TO_DEVFN(x) ((x) & 0xff)
20 #define PCI_BUS_MAX 256
21 #define PCI_DEVFN_MAX 256
22 #define PCI_SLOT_MAX 32
23 #define PCI_FUNC_MAX 8
25 /* Class, Vendor and Device IDs from Linux's pci_ids.h */
26 #include "hw/pci/pci_ids.h"
28 /* QEMU-specific Vendor and Device ID definitions */
31 #define PCI_DEVICE_ID_IBM_440GX 0x027f
32 #define PCI_DEVICE_ID_IBM_OPENPIC2 0xffff
34 /* Hitachi (0x1054) */
35 #define PCI_VENDOR_ID_HITACHI 0x1054
36 #define PCI_DEVICE_ID_HITACHI_SH7751R 0x350e
39 #define PCI_DEVICE_ID_APPLE_343S1201 0x0010
40 #define PCI_DEVICE_ID_APPLE_UNI_N_I_PCI 0x001e
41 #define PCI_DEVICE_ID_APPLE_UNI_N_PCI 0x001f
42 #define PCI_DEVICE_ID_APPLE_UNI_N_KEYL 0x0022
43 #define PCI_DEVICE_ID_APPLE_IPID_USB 0x003f
45 /* Realtek (0x10ec) */
46 #define PCI_DEVICE_ID_REALTEK_8029 0x8029
49 #define PCI_DEVICE_ID_XILINX_XC2VP30 0x0300
51 /* Marvell (0x11ab) */
52 #define PCI_DEVICE_ID_MARVELL_GT6412X 0x4620
54 /* QEMU/Bochs VGA (0x1234) */
55 #define PCI_VENDOR_ID_QEMU 0x1234
56 #define PCI_DEVICE_ID_QEMU_VGA 0x1111
57 #define PCI_DEVICE_ID_QEMU_IPMI 0x1112
60 #define PCI_VENDOR_ID_VMWARE 0x15ad
61 #define PCI_DEVICE_ID_VMWARE_SVGA2 0x0405
62 #define PCI_DEVICE_ID_VMWARE_SVGA 0x0710
63 #define PCI_DEVICE_ID_VMWARE_NET 0x0720
64 #define PCI_DEVICE_ID_VMWARE_SCSI 0x0730
65 #define PCI_DEVICE_ID_VMWARE_PVSCSI 0x07C0
66 #define PCI_DEVICE_ID_VMWARE_IDE 0x1729
67 #define PCI_DEVICE_ID_VMWARE_VMXNET3 0x07B0
70 #define PCI_DEVICE_ID_INTEL_82551IT 0x1209
71 #define PCI_DEVICE_ID_INTEL_82557 0x1229
72 #define PCI_DEVICE_ID_INTEL_82801IR 0x2922
74 /* Red Hat / Qumranet (for QEMU) -- see pci-ids.txt */
75 #define PCI_VENDOR_ID_REDHAT_QUMRANET 0x1af4
76 #define PCI_SUBVENDOR_ID_REDHAT_QUMRANET 0x1af4
77 #define PCI_SUBDEVICE_ID_QEMU 0x1100
79 #define PCI_DEVICE_ID_VIRTIO_NET 0x1000
80 #define PCI_DEVICE_ID_VIRTIO_BLOCK 0x1001
81 #define PCI_DEVICE_ID_VIRTIO_BALLOON 0x1002
82 #define PCI_DEVICE_ID_VIRTIO_CONSOLE 0x1003
83 #define PCI_DEVICE_ID_VIRTIO_SCSI 0x1004
84 #define PCI_DEVICE_ID_VIRTIO_RNG 0x1005
85 #define PCI_DEVICE_ID_VIRTIO_9P 0x1009
86 #define PCI_DEVICE_ID_VIRTIO_VSOCK 0x1012
88 #define PCI_VENDOR_ID_REDHAT 0x1b36
89 #define PCI_DEVICE_ID_REDHAT_BRIDGE 0x0001
90 #define PCI_DEVICE_ID_REDHAT_SERIAL 0x0002
91 #define PCI_DEVICE_ID_REDHAT_SERIAL2 0x0003
92 #define PCI_DEVICE_ID_REDHAT_SERIAL4 0x0004
93 #define PCI_DEVICE_ID_REDHAT_TEST 0x0005
94 #define PCI_DEVICE_ID_REDHAT_ROCKER 0x0006
95 #define PCI_DEVICE_ID_REDHAT_SDHCI 0x0007
96 #define PCI_DEVICE_ID_REDHAT_PCIE_HOST 0x0008
97 #define PCI_DEVICE_ID_REDHAT_PXB 0x0009
98 #define PCI_DEVICE_ID_REDHAT_BRIDGE_SEAT 0x000a
99 #define PCI_DEVICE_ID_REDHAT_PXB_PCIE 0x000b
100 #define PCI_DEVICE_ID_REDHAT_PCIE_RP 0x000c
101 #define PCI_DEVICE_ID_REDHAT_XHCI 0x000d
102 #define PCI_DEVICE_ID_REDHAT_PCIE_BRIDGE 0x000e
103 #define PCI_DEVICE_ID_REDHAT_MDPY 0x000f
104 #define PCI_DEVICE_ID_REDHAT_NVME 0x0010
105 #define PCI_DEVICE_ID_REDHAT_PVPANIC 0x0011
106 #define PCI_DEVICE_ID_REDHAT_ACPI_ERST 0x0012
107 #define PCI_DEVICE_ID_REDHAT_QXL 0x0100
109 #define FMT_PCIBUS PRIx64
111 typedef uint64_t pcibus_t
;
113 struct PCIHostDeviceAddress
{
117 unsigned int function
;
120 typedef void PCIConfigWriteFunc(PCIDevice
*pci_dev
,
121 uint32_t address
, uint32_t data
, int len
);
122 typedef uint32_t PCIConfigReadFunc(PCIDevice
*pci_dev
,
123 uint32_t address
, int len
);
124 typedef void PCIMapIORegionFunc(PCIDevice
*pci_dev
, int region_num
,
125 pcibus_t addr
, pcibus_t size
, int type
);
126 typedef void PCIUnregisterFunc(PCIDevice
*pci_dev
);
128 typedef void MSITriggerFunc(PCIDevice
*dev
, MSIMessage msg
);
129 typedef MSIMessage
MSIPrepareMessageFunc(PCIDevice
*dev
, unsigned vector
);
130 typedef MSIMessage
MSIxPrepareMessageFunc(PCIDevice
*dev
, unsigned vector
);
132 typedef struct PCIIORegion
{
133 pcibus_t addr
; /* current PCI mapping address. -1 means not mapped */
134 #define PCI_BAR_UNMAPPED (~(pcibus_t)0)
137 MemoryRegion
*memory
;
138 MemoryRegion
*address_space
;
141 #define PCI_ROM_SLOT 6
142 #define PCI_NUM_REGIONS 7
148 QEMU_PCI_VGA_NUM_REGIONS
,
151 #define QEMU_PCI_VGA_MEM_BASE 0xa0000
152 #define QEMU_PCI_VGA_MEM_SIZE 0x20000
153 #define QEMU_PCI_VGA_IO_LO_BASE 0x3b0
154 #define QEMU_PCI_VGA_IO_LO_SIZE 0xc
155 #define QEMU_PCI_VGA_IO_HI_BASE 0x3c0
156 #define QEMU_PCI_VGA_IO_HI_SIZE 0x20
158 #include "hw/pci/pci_regs.h"
159 #include "hw/pci/pcie.h"
161 /* PCI HEADER_TYPE */
162 #define PCI_HEADER_TYPE_MULTI_FUNCTION 0x80
164 /* Size of the standard PCI config header */
165 #define PCI_CONFIG_HEADER_SIZE 0x40
166 /* Size of the standard PCI config space */
167 #define PCI_CONFIG_SPACE_SIZE 0x100
168 /* Size of the standard PCIe config space: 4KB */
169 #define PCIE_CONFIG_SPACE_SIZE 0x1000
171 #define PCI_NUM_PINS 4 /* A-D */
173 /* Bits in cap_present field. */
175 QEMU_PCI_CAP_MSI
= 0x1,
176 QEMU_PCI_CAP_MSIX
= 0x2,
177 QEMU_PCI_CAP_EXPRESS
= 0x4,
179 /* multifunction capable device */
180 #define QEMU_PCI_CAP_MULTIFUNCTION_BITNR 3
181 QEMU_PCI_CAP_MULTIFUNCTION
= (1 << QEMU_PCI_CAP_MULTIFUNCTION_BITNR
),
183 /* command register SERR bit enabled - unused since QEMU v5.0 */
184 #define QEMU_PCI_CAP_SERR_BITNR 4
185 QEMU_PCI_CAP_SERR
= (1 << QEMU_PCI_CAP_SERR_BITNR
),
186 /* Standard hot plug controller. */
187 #define QEMU_PCI_SHPC_BITNR 5
188 QEMU_PCI_CAP_SHPC
= (1 << QEMU_PCI_SHPC_BITNR
),
189 #define QEMU_PCI_SLOTID_BITNR 6
190 QEMU_PCI_CAP_SLOTID
= (1 << QEMU_PCI_SLOTID_BITNR
),
191 /* PCI Express capability - Power Controller Present */
192 #define QEMU_PCIE_SLTCAP_PCP_BITNR 7
193 QEMU_PCIE_SLTCAP_PCP
= (1 << QEMU_PCIE_SLTCAP_PCP_BITNR
),
194 /* Link active status in endpoint capability is always set */
195 #define QEMU_PCIE_LNKSTA_DLLLA_BITNR 8
196 QEMU_PCIE_LNKSTA_DLLLA
= (1 << QEMU_PCIE_LNKSTA_DLLLA_BITNR
),
197 #define QEMU_PCIE_EXTCAP_INIT_BITNR 9
198 QEMU_PCIE_EXTCAP_INIT
= (1 << QEMU_PCIE_EXTCAP_INIT_BITNR
),
199 #define QEMU_PCIE_CXL_BITNR 10
200 QEMU_PCIE_CAP_CXL
= (1 << QEMU_PCIE_CXL_BITNR
),
203 #define TYPE_PCI_DEVICE "pci-device"
204 typedef struct PCIDeviceClass PCIDeviceClass
;
205 DECLARE_OBJ_CHECKERS(PCIDevice
, PCIDeviceClass
,
206 PCI_DEVICE
, TYPE_PCI_DEVICE
)
209 * Implemented by devices that can be plugged on CXL buses. In the spec, this is
210 * actually a "CXL Component, but we name it device to match the PCI naming.
212 #define INTERFACE_CXL_DEVICE "cxl-device"
214 /* Implemented by devices that can be plugged on PCI Express buses */
215 #define INTERFACE_PCIE_DEVICE "pci-express-device"
217 /* Implemented by devices that can be plugged on Conventional PCI buses */
218 #define INTERFACE_CONVENTIONAL_PCI_DEVICE "conventional-pci-device"
220 typedef struct PCIINTxRoute
{
229 struct PCIDeviceClass
{
230 DeviceClass parent_class
;
232 void (*realize
)(PCIDevice
*dev
, Error
**errp
);
233 PCIUnregisterFunc
*exit
;
234 PCIConfigReadFunc
*config_read
;
235 PCIConfigWriteFunc
*config_write
;
241 uint16_t subsystem_vendor_id
; /* only for header type = 0 */
242 uint16_t subsystem_id
; /* only for header type = 0 */
245 * pci-to-pci bridge or normal device.
246 * This doesn't mean pci host switch.
247 * When card bus bridge is supported, this would be enhanced.
255 typedef void (*PCIINTxRoutingNotifier
)(PCIDevice
*dev
);
256 typedef int (*MSIVectorUseNotifier
)(PCIDevice
*dev
, unsigned int vector
,
258 typedef void (*MSIVectorReleaseNotifier
)(PCIDevice
*dev
, unsigned int vector
);
259 typedef void (*MSIVectorPollNotifier
)(PCIDevice
*dev
,
260 unsigned int vector_start
,
261 unsigned int vector_end
);
264 PCI_REQ_ID_INVALID
= 0,
266 PCI_REQ_ID_SECONDARY_BUS
,
269 typedef enum PCIReqIDType PCIReqIDType
;
271 struct PCIReqIDCache
{
275 typedef struct PCIReqIDCache PCIReqIDCache
;
279 bool partially_hotplugged
;
282 /* PCI config space */
285 /* Used to enable config checks on load. Note that writable bits are
286 * never checked even if set in cmask. */
289 /* Used to implement R/W bytes */
292 /* Used to implement RW1C(Write 1 to Clear) bytes */
295 /* Used to allocate config space for capabilities. */
298 /* the following fields are read only */
300 /* Cached device to fetch requester ID from, to avoid the PCI
301 * tree walking every time we invoke PCI request (e.g.,
302 * MSI). For conventional PCI root complex, this field is
304 PCIReqIDCache requester_id_cache
;
306 PCIIORegion io_regions
[PCI_NUM_REGIONS
];
307 AddressSpace bus_master_as
;
308 MemoryRegion bus_master_container_region
;
309 MemoryRegion bus_master_enable_region
;
311 /* do not access the following fields */
312 PCIConfigReadFunc
*config_read
;
313 PCIConfigWriteFunc
*config_write
;
315 /* Legacy PCI VGA regions */
316 MemoryRegion
*vga_regions
[QEMU_PCI_VGA_NUM_REGIONS
];
319 /* Current IRQ levels. Used internally by the generic PCI code. */
322 /* Capability bits */
323 uint32_t cap_present
;
325 /* Offset of MSI-X capability in config space */
331 /* Space to store MSIX table & pending bit array */
335 /* May be used by INTx or MSI during interrupt notification */
338 MSITriggerFunc
*msi_trigger
;
339 MSIPrepareMessageFunc
*msi_prepare_message
;
340 MSIxPrepareMessageFunc
*msix_prepare_message
;
342 /* MemoryRegion container for msix exclusive BAR setup */
343 MemoryRegion msix_exclusive_bar
;
344 /* Memory Regions for MSIX table and pending bit entries. */
345 MemoryRegion msix_table_mmio
;
346 MemoryRegion msix_pba_mmio
;
347 /* Reference-count for entries actually in use by driver. */
348 unsigned *msix_entry_used
;
349 /* MSIX function mask set or MSIX disabled */
350 bool msix_function_masked
;
351 /* Version id needed for VMState */
354 /* Offset of MSI capability in config space */
358 PCIExpressDevice exp
;
363 /* Location of option rom */
370 /* INTx routing notifier */
371 PCIINTxRoutingNotifier intx_routing_notifier
;
373 /* MSI-X notifiers */
374 MSIVectorUseNotifier msix_vector_use_notifier
;
375 MSIVectorReleaseNotifier msix_vector_release_notifier
;
376 MSIVectorPollNotifier msix_vector_poll_notifier
;
378 /* ID of standby device in net_failover pair */
379 char *failover_pair_id
;
383 void pci_register_bar(PCIDevice
*pci_dev
, int region_num
,
384 uint8_t attr
, MemoryRegion
*memory
);
385 void pci_register_vga(PCIDevice
*pci_dev
, MemoryRegion
*mem
,
386 MemoryRegion
*io_lo
, MemoryRegion
*io_hi
);
387 void pci_unregister_vga(PCIDevice
*pci_dev
);
388 pcibus_t
pci_get_bar_addr(PCIDevice
*pci_dev
, int region_num
);
390 int pci_add_capability(PCIDevice
*pdev
, uint8_t cap_id
,
391 uint8_t offset
, uint8_t size
,
394 void pci_del_capability(PCIDevice
*pci_dev
, uint8_t cap_id
, uint8_t cap_size
);
396 uint8_t pci_find_capability(PCIDevice
*pci_dev
, uint8_t cap_id
);
399 uint32_t pci_default_read_config(PCIDevice
*d
,
400 uint32_t address
, int len
);
401 void pci_default_write_config(PCIDevice
*d
,
402 uint32_t address
, uint32_t val
, int len
);
403 void pci_device_save(PCIDevice
*s
, QEMUFile
*f
);
404 int pci_device_load(PCIDevice
*s
, QEMUFile
*f
);
405 MemoryRegion
*pci_address_space(PCIDevice
*dev
);
406 MemoryRegion
*pci_address_space_io(PCIDevice
*dev
);
409 * Should not normally be used by devices. For use by sPAPR target
410 * where QEMU emulates firmware.
412 int pci_bar(PCIDevice
*d
, int reg
);
414 typedef void (*pci_set_irq_fn
)(void *opaque
, int irq_num
, int level
);
415 typedef int (*pci_map_irq_fn
)(PCIDevice
*pci_dev
, int irq_num
);
416 typedef PCIINTxRoute (*pci_route_irq_fn
)(void *opaque
, int pin
);
418 #define TYPE_PCI_BUS "PCI"
419 OBJECT_DECLARE_TYPE(PCIBus
, PCIBusClass
, PCI_BUS
)
420 #define TYPE_PCIE_BUS "PCIE"
421 #define TYPE_CXL_BUS "CXL"
423 typedef void (*pci_bus_dev_fn
)(PCIBus
*b
, PCIDevice
*d
, void *opaque
);
424 typedef void (*pci_bus_fn
)(PCIBus
*b
, void *opaque
);
425 typedef void *(*pci_bus_ret_fn
)(PCIBus
*b
, void *opaque
);
427 bool pci_bus_is_express(PCIBus
*bus
);
429 void pci_root_bus_init(PCIBus
*bus
, size_t bus_size
, DeviceState
*parent
,
431 MemoryRegion
*address_space_mem
,
432 MemoryRegion
*address_space_io
,
433 uint8_t devfn_min
, const char *typename
);
434 PCIBus
*pci_root_bus_new(DeviceState
*parent
, const char *name
,
435 MemoryRegion
*address_space_mem
,
436 MemoryRegion
*address_space_io
,
437 uint8_t devfn_min
, const char *typename
);
438 void pci_root_bus_cleanup(PCIBus
*bus
);
439 void pci_bus_irqs(PCIBus
*bus
, pci_set_irq_fn set_irq
, pci_map_irq_fn map_irq
,
440 void *irq_opaque
, int nirq
);
441 void pci_bus_irqs_cleanup(PCIBus
*bus
);
442 int pci_bus_get_irq_level(PCIBus
*bus
, int irq_num
);
443 /* 0 <= pin <= 3 0 = INTA, 1 = INTB, 2 = INTC, 3 = INTD */
444 static inline int pci_swizzle(int slot
, int pin
)
446 return (slot
+ pin
) % PCI_NUM_PINS
;
448 int pci_swizzle_map_irq_fn(PCIDevice
*pci_dev
, int pin
);
449 PCIBus
*pci_register_root_bus(DeviceState
*parent
, const char *name
,
450 pci_set_irq_fn set_irq
, pci_map_irq_fn map_irq
,
452 MemoryRegion
*address_space_mem
,
453 MemoryRegion
*address_space_io
,
454 uint8_t devfn_min
, int nirq
,
455 const char *typename
);
456 void pci_unregister_root_bus(PCIBus
*bus
);
457 void pci_bus_set_route_irq_fn(PCIBus
*, pci_route_irq_fn
);
458 PCIINTxRoute
pci_device_route_intx_to_irq(PCIDevice
*dev
, int pin
);
459 bool pci_intx_route_changed(PCIINTxRoute
*old
, PCIINTxRoute
*new);
460 void pci_bus_fire_intx_routing_notifier(PCIBus
*bus
);
461 void pci_device_set_intx_routing_notifier(PCIDevice
*dev
,
462 PCIINTxRoutingNotifier notifier
);
463 void pci_device_reset(PCIDevice
*dev
);
465 PCIDevice
*pci_nic_init_nofail(NICInfo
*nd
, PCIBus
*rootbus
,
466 const char *default_model
,
467 const char *default_devaddr
);
469 PCIDevice
*pci_vga_init(PCIBus
*bus
);
471 static inline PCIBus
*pci_get_bus(const PCIDevice
*dev
)
473 return PCI_BUS(qdev_get_parent_bus(DEVICE(dev
)));
475 int pci_bus_num(PCIBus
*s
);
476 void pci_bus_range(PCIBus
*bus
, int *min_bus
, int *max_bus
);
477 static inline int pci_dev_bus_num(const PCIDevice
*dev
)
479 return pci_bus_num(pci_get_bus(dev
));
482 int pci_bus_numa_node(PCIBus
*bus
);
483 void pci_for_each_device(PCIBus
*bus
, int bus_num
,
486 void pci_for_each_device_reverse(PCIBus
*bus
, int bus_num
,
489 void pci_for_each_device_under_bus(PCIBus
*bus
,
490 pci_bus_dev_fn fn
, void *opaque
);
491 void pci_for_each_device_under_bus_reverse(PCIBus
*bus
,
494 void pci_for_each_bus_depth_first(PCIBus
*bus
, pci_bus_ret_fn begin
,
495 pci_bus_fn end
, void *parent_state
);
496 PCIDevice
*pci_get_function_0(PCIDevice
*pci_dev
);
498 /* Use this wrapper when specific scan order is not required. */
500 void pci_for_each_bus(PCIBus
*bus
, pci_bus_fn fn
, void *opaque
)
502 pci_for_each_bus_depth_first(bus
, NULL
, fn
, opaque
);
505 PCIBus
*pci_device_root_bus(const PCIDevice
*d
);
506 const char *pci_root_bus_path(PCIDevice
*dev
);
507 bool pci_bus_bypass_iommu(PCIBus
*bus
);
508 PCIDevice
*pci_find_device(PCIBus
*bus
, int bus_num
, uint8_t devfn
);
509 int pci_qdev_find_device(const char *id
, PCIDevice
**pdev
);
510 void pci_bus_get_w64_range(PCIBus
*bus
, Range
*range
);
512 void pci_device_deassert_intx(PCIDevice
*dev
);
514 typedef AddressSpace
*(*PCIIOMMUFunc
)(PCIBus
*, void *, int);
516 AddressSpace
*pci_device_iommu_address_space(PCIDevice
*dev
);
517 void pci_setup_iommu(PCIBus
*bus
, PCIIOMMUFunc fn
, void *opaque
);
519 pcibus_t
pci_bar_address(PCIDevice
*d
,
520 int reg
, uint8_t type
, pcibus_t size
);
523 pci_set_byte(uint8_t *config
, uint8_t val
)
528 static inline uint8_t
529 pci_get_byte(const uint8_t *config
)
535 pci_set_word(uint8_t *config
, uint16_t val
)
537 stw_le_p(config
, val
);
540 static inline uint16_t
541 pci_get_word(const uint8_t *config
)
543 return lduw_le_p(config
);
547 pci_set_long(uint8_t *config
, uint32_t val
)
549 stl_le_p(config
, val
);
552 static inline uint32_t
553 pci_get_long(const uint8_t *config
)
555 return ldl_le_p(config
);
559 * PCI capabilities and/or their fields
560 * are generally DWORD aligned only so
561 * mechanism used by pci_set/get_quad()
562 * must be tolerant to unaligned pointers
566 pci_set_quad(uint8_t *config
, uint64_t val
)
568 stq_le_p(config
, val
);
571 static inline uint64_t
572 pci_get_quad(const uint8_t *config
)
574 return ldq_le_p(config
);
578 pci_config_set_vendor_id(uint8_t *pci_config
, uint16_t val
)
580 pci_set_word(&pci_config
[PCI_VENDOR_ID
], val
);
584 pci_config_set_device_id(uint8_t *pci_config
, uint16_t val
)
586 pci_set_word(&pci_config
[PCI_DEVICE_ID
], val
);
590 pci_config_set_revision(uint8_t *pci_config
, uint8_t val
)
592 pci_set_byte(&pci_config
[PCI_REVISION_ID
], val
);
596 pci_config_set_class(uint8_t *pci_config
, uint16_t val
)
598 pci_set_word(&pci_config
[PCI_CLASS_DEVICE
], val
);
602 pci_config_set_prog_interface(uint8_t *pci_config
, uint8_t val
)
604 pci_set_byte(&pci_config
[PCI_CLASS_PROG
], val
);
608 pci_config_set_interrupt_pin(uint8_t *pci_config
, uint8_t val
)
610 pci_set_byte(&pci_config
[PCI_INTERRUPT_PIN
], val
);
614 * helper functions to do bit mask operation on configuration space.
615 * Just to set bit, use test-and-set and discard returned value.
616 * Just to clear bit, use test-and-clear and discard returned value.
617 * NOTE: They aren't atomic.
619 static inline uint8_t
620 pci_byte_test_and_clear_mask(uint8_t *config
, uint8_t mask
)
622 uint8_t val
= pci_get_byte(config
);
623 pci_set_byte(config
, val
& ~mask
);
627 static inline uint8_t
628 pci_byte_test_and_set_mask(uint8_t *config
, uint8_t mask
)
630 uint8_t val
= pci_get_byte(config
);
631 pci_set_byte(config
, val
| mask
);
635 static inline uint16_t
636 pci_word_test_and_clear_mask(uint8_t *config
, uint16_t mask
)
638 uint16_t val
= pci_get_word(config
);
639 pci_set_word(config
, val
& ~mask
);
643 static inline uint16_t
644 pci_word_test_and_set_mask(uint8_t *config
, uint16_t mask
)
646 uint16_t val
= pci_get_word(config
);
647 pci_set_word(config
, val
| mask
);
651 static inline uint32_t
652 pci_long_test_and_clear_mask(uint8_t *config
, uint32_t mask
)
654 uint32_t val
= pci_get_long(config
);
655 pci_set_long(config
, val
& ~mask
);
659 static inline uint32_t
660 pci_long_test_and_set_mask(uint8_t *config
, uint32_t mask
)
662 uint32_t val
= pci_get_long(config
);
663 pci_set_long(config
, val
| mask
);
667 static inline uint64_t
668 pci_quad_test_and_clear_mask(uint8_t *config
, uint64_t mask
)
670 uint64_t val
= pci_get_quad(config
);
671 pci_set_quad(config
, val
& ~mask
);
675 static inline uint64_t
676 pci_quad_test_and_set_mask(uint8_t *config
, uint64_t mask
)
678 uint64_t val
= pci_get_quad(config
);
679 pci_set_quad(config
, val
| mask
);
683 /* Access a register specified by a mask */
685 pci_set_byte_by_mask(uint8_t *config
, uint8_t mask
, uint8_t reg
)
687 uint8_t val
= pci_get_byte(config
);
688 uint8_t rval
= reg
<< ctz32(mask
);
689 pci_set_byte(config
, (~mask
& val
) | (mask
& rval
));
692 static inline uint8_t
693 pci_get_byte_by_mask(uint8_t *config
, uint8_t mask
)
695 uint8_t val
= pci_get_byte(config
);
696 return (val
& mask
) >> ctz32(mask
);
700 pci_set_word_by_mask(uint8_t *config
, uint16_t mask
, uint16_t reg
)
702 uint16_t val
= pci_get_word(config
);
703 uint16_t rval
= reg
<< ctz32(mask
);
704 pci_set_word(config
, (~mask
& val
) | (mask
& rval
));
707 static inline uint16_t
708 pci_get_word_by_mask(uint8_t *config
, uint16_t mask
)
710 uint16_t val
= pci_get_word(config
);
711 return (val
& mask
) >> ctz32(mask
);
715 pci_set_long_by_mask(uint8_t *config
, uint32_t mask
, uint32_t reg
)
717 uint32_t val
= pci_get_long(config
);
718 uint32_t rval
= reg
<< ctz32(mask
);
719 pci_set_long(config
, (~mask
& val
) | (mask
& rval
));
722 static inline uint32_t
723 pci_get_long_by_mask(uint8_t *config
, uint32_t mask
)
725 uint32_t val
= pci_get_long(config
);
726 return (val
& mask
) >> ctz32(mask
);
730 pci_set_quad_by_mask(uint8_t *config
, uint64_t mask
, uint64_t reg
)
732 uint64_t val
= pci_get_quad(config
);
733 uint64_t rval
= reg
<< ctz32(mask
);
734 pci_set_quad(config
, (~mask
& val
) | (mask
& rval
));
737 static inline uint64_t
738 pci_get_quad_by_mask(uint8_t *config
, uint64_t mask
)
740 uint64_t val
= pci_get_quad(config
);
741 return (val
& mask
) >> ctz32(mask
);
744 PCIDevice
*pci_new_multifunction(int devfn
, bool multifunction
,
746 PCIDevice
*pci_new(int devfn
, const char *name
);
747 bool pci_realize_and_unref(PCIDevice
*dev
, PCIBus
*bus
, Error
**errp
);
749 PCIDevice
*pci_create_simple_multifunction(PCIBus
*bus
, int devfn
,
752 PCIDevice
*pci_create_simple(PCIBus
*bus
, int devfn
, const char *name
);
754 void lsi53c8xx_handle_legacy_cmdline(DeviceState
*lsi_dev
);
756 qemu_irq
pci_allocate_irq(PCIDevice
*pci_dev
);
757 void pci_set_irq(PCIDevice
*pci_dev
, int level
);
759 static inline int pci_intx(PCIDevice
*pci_dev
)
761 return pci_get_byte(pci_dev
->config
+ PCI_INTERRUPT_PIN
) - 1;
764 static inline void pci_irq_assert(PCIDevice
*pci_dev
)
766 pci_set_irq(pci_dev
, 1);
769 static inline void pci_irq_deassert(PCIDevice
*pci_dev
)
771 pci_set_irq(pci_dev
, 0);
775 * FIXME: PCI does not work this way.
776 * All the callers to this method should be fixed.
778 static inline void pci_irq_pulse(PCIDevice
*pci_dev
)
780 pci_irq_assert(pci_dev
);
781 pci_irq_deassert(pci_dev
);
784 static inline int pci_is_cxl(const PCIDevice
*d
)
786 return d
->cap_present
& QEMU_PCIE_CAP_CXL
;
789 static inline int pci_is_express(const PCIDevice
*d
)
791 return d
->cap_present
& QEMU_PCI_CAP_EXPRESS
;
794 static inline int pci_is_express_downstream_port(const PCIDevice
*d
)
798 if (!pci_is_express(d
) || !d
->exp
.exp_cap
) {
802 type
= pcie_cap_get_type(d
);
804 return type
== PCI_EXP_TYPE_DOWNSTREAM
|| type
== PCI_EXP_TYPE_ROOT_PORT
;
807 static inline int pci_is_vf(const PCIDevice
*d
)
809 return d
->exp
.sriov_vf
.pf
!= NULL
;
812 static inline uint32_t pci_config_size(const PCIDevice
*d
)
814 return pci_is_express(d
) ? PCIE_CONFIG_SPACE_SIZE
: PCI_CONFIG_SPACE_SIZE
;
817 static inline uint16_t pci_get_bdf(PCIDevice
*dev
)
819 return PCI_BUILD_BDF(pci_bus_num(pci_get_bus(dev
)), dev
->devfn
);
822 uint16_t pci_requester_id(PCIDevice
*dev
);
824 /* DMA access functions */
825 static inline AddressSpace
*pci_get_address_space(PCIDevice
*dev
)
827 return &dev
->bus_master_as
;
831 * pci_dma_rw: Read from or write to an address space from PCI device.
833 * Return a MemTxResult indicating whether the operation succeeded
834 * or failed (eg unassigned memory, device rejected the transaction,
837 * @dev: #PCIDevice doing the memory access
838 * @addr: address within the #PCIDevice address space
839 * @buf: buffer with the data transferred
840 * @len: the number of bytes to read or write
841 * @dir: indicates the transfer direction
843 static inline MemTxResult
pci_dma_rw(PCIDevice
*dev
, dma_addr_t addr
,
844 void *buf
, dma_addr_t len
,
845 DMADirection dir
, MemTxAttrs attrs
)
847 return dma_memory_rw(pci_get_address_space(dev
), addr
, buf
, len
,
852 * pci_dma_read: Read from an address space from PCI device.
854 * Return a MemTxResult indicating whether the operation succeeded
855 * or failed (eg unassigned memory, device rejected the transaction,
856 * IOMMU fault). Called within RCU critical section.
858 * @dev: #PCIDevice doing the memory access
859 * @addr: address within the #PCIDevice address space
860 * @buf: buffer with the data transferred
861 * @len: length of the data transferred
863 static inline MemTxResult
pci_dma_read(PCIDevice
*dev
, dma_addr_t addr
,
864 void *buf
, dma_addr_t len
)
866 return pci_dma_rw(dev
, addr
, buf
, len
,
867 DMA_DIRECTION_TO_DEVICE
, MEMTXATTRS_UNSPECIFIED
);
871 * pci_dma_write: Write to address space from PCI device.
873 * Return a MemTxResult indicating whether the operation succeeded
874 * or failed (eg unassigned memory, device rejected the transaction,
877 * @dev: #PCIDevice doing the memory access
878 * @addr: address within the #PCIDevice address space
879 * @buf: buffer with the data transferred
880 * @len: the number of bytes to write
882 static inline MemTxResult
pci_dma_write(PCIDevice
*dev
, dma_addr_t addr
,
883 const void *buf
, dma_addr_t len
)
885 return pci_dma_rw(dev
, addr
, (void *) buf
, len
,
886 DMA_DIRECTION_FROM_DEVICE
, MEMTXATTRS_UNSPECIFIED
);
889 #define PCI_DMA_DEFINE_LDST(_l, _s, _bits) \
890 static inline MemTxResult ld##_l##_pci_dma(PCIDevice *dev, \
892 uint##_bits##_t *val, \
895 return ld##_l##_dma(pci_get_address_space(dev), addr, val, attrs); \
897 static inline MemTxResult st##_s##_pci_dma(PCIDevice *dev, \
899 uint##_bits##_t val, \
902 return st##_s##_dma(pci_get_address_space(dev), addr, val, attrs); \
905 PCI_DMA_DEFINE_LDST(ub
, b
, 8);
906 PCI_DMA_DEFINE_LDST(uw_le
, w_le
, 16)
907 PCI_DMA_DEFINE_LDST(l_le
, l_le
, 32);
908 PCI_DMA_DEFINE_LDST(q_le
, q_le
, 64);
909 PCI_DMA_DEFINE_LDST(uw_be
, w_be
, 16)
910 PCI_DMA_DEFINE_LDST(l_be
, l_be
, 32);
911 PCI_DMA_DEFINE_LDST(q_be
, q_be
, 64);
913 #undef PCI_DMA_DEFINE_LDST
916 * pci_dma_map: Map device PCI address space range into host virtual address
917 * @dev: #PCIDevice to be accessed
918 * @addr: address within that device's address space
919 * @plen: pointer to length of buffer; updated on return to indicate
920 * if only a subset of the requested range has been mapped
921 * @dir: indicates the transfer direction
923 * Return: A host pointer, or %NULL if the resources needed to
924 * perform the mapping are exhausted (in that case *@plen
927 static inline void *pci_dma_map(PCIDevice
*dev
, dma_addr_t addr
,
928 dma_addr_t
*plen
, DMADirection dir
)
932 buf
= dma_memory_map(pci_get_address_space(dev
), addr
, plen
, dir
,
933 MEMTXATTRS_UNSPECIFIED
);
937 static inline void pci_dma_unmap(PCIDevice
*dev
, void *buffer
, dma_addr_t len
,
938 DMADirection dir
, dma_addr_t access_len
)
940 dma_memory_unmap(pci_get_address_space(dev
), buffer
, len
, dir
, access_len
);
943 static inline void pci_dma_sglist_init(QEMUSGList
*qsg
, PCIDevice
*dev
,
946 qemu_sglist_init(qsg
, DEVICE(dev
), alloc_hint
, pci_get_address_space(dev
));
949 extern const VMStateDescription vmstate_pci_device
;
951 #define VMSTATE_PCI_DEVICE(_field, _state) { \
952 .name = (stringify(_field)), \
953 .size = sizeof(PCIDevice), \
954 .vmsd = &vmstate_pci_device, \
955 .flags = VMS_STRUCT, \
956 .offset = vmstate_offset_value(_state, _field, PCIDevice), \
959 #define VMSTATE_PCI_DEVICE_POINTER(_field, _state) { \
960 .name = (stringify(_field)), \
961 .size = sizeof(PCIDevice), \
962 .vmsd = &vmstate_pci_device, \
963 .flags = VMS_STRUCT|VMS_POINTER, \
964 .offset = vmstate_offset_pointer(_state, _field, PCIDevice), \
967 MSIMessage
pci_get_msi_message(PCIDevice
*dev
, int vector
);
968 void pci_set_power(PCIDevice
*pci_dev
, bool state
);