qemu/docs/pcie_pci_bridge.txt

1 Generic PCI Express to PCI Bridge
6 PCIE-to-PCI bridge is a new method for legacy PCI
9 Previously Intel DMI-to-PCI bridge was used for this purpose.
12 PCIE-to-PCI bridge should now be used for any legacy PCI device usage
13 with PCI Express machine.
15 This generic PCIE-PCI bridge is a cross-platform device,
17 see 'PCIE-PCI bridge hot-plug' section),
21 Hot-plug of legacy PCI devices into the bridge
25 PCIE-PCI bridge hot-plug
27 Guest OSes require extra efforts to enable PCIE-PCI bridge hot-plug.
28 Motivation - now on init any PCI Express root port which doesn't have
35 Red Hat vendor-specific PCI capability, added to the root port
36 that is planned to have PCIE-PCI bridge hot-plugged in.
38 Capability layout (defined in include/hw/pci/pci_bridge.h):
40     uint8_t id;     Standard PCI capability header field
41     uint8_t next;   Standard PCI capability header field
42     uint8_t len;    Standard PCI vendor-specific capability header field
76 -device pcie-pci-bridge,id=br1,bus=rp1 \
77 -device pcie-pci-bridge,id=br2,bus=rp2 \
81 device_add pcie-pci-bridge,id=br3,bus=rp3 \
89     - 2 PCIE-PCI bridges plugged into 2 different root ports;
92     - PCIE-PCI bridge, plugged into QEMU generic root port;
93     - 2 e1000 cards, one plugged into the cold-plugged PCIE-PCI bridge,
98 The PCIE-PCI bridge can be hot-plugged only into pcie-root-port that
102 Windows 7 and older versions don't support hot-plug devices into the PCIE-PCI bridge.
104 1) Build shpchp module with this patch http://www.spinics.net/lists/linux-pci/msg63052.html
112 The PCIE-PCI bridge is based on PCI-PCI bridge, but also accumulates PCI Express
113 features as a PCI Express device.