qemu/docs/pcie.txt

6 The doc proposes best practices on how to use PCI Express (PCIe) / PCI
10 Note that the PCIe features are available only when using the 'q35'
12 Other machine types do not use PCIe at this time.
37 2.1 Root Bus (pcie.0)
51     (2) PCI Express Root Ports (pcie-root-port), for starting exclusively
54     (3) PCI Express to PCI Bridge (pcie-pci-bridge), for starting legacy PCI
57     (4) Extra Root Complexes (pxb-pcie), if multiple PCI Express Root Buses
60    pcie.0 bus
64    | PCI Dev |   | PCIe Root Port |   | PCIe-PCI Bridge |   |  pxb-pcie  |
67 2.1.1 To plug a device into pcie.0 as a Root Complex Integrated Endpoint use:
68           -device <dev>[,bus=pcie.0]
70           -device pxb-pcie,id=pcie.1,bus_nr=x[,numa_node=y][,addr=z]
72       connected to the pcie.1 bus:
73           -device pcie-root-port,id=root_port1[,bus=pcie.1][,chassis=x][,slot=y][,addr=z] \
74           -device pcie-pci-bridge,id=pcie_pci_bridge1,bus=pcie.1
95    pcie.0 bus
103     | PCIe Dev |                      |    PCI Express  | Upstream Port |              |
111                                              | PCIe Dev |
115           -device pcie-root-port,id=root_port1,chassis=x,slot=y[,bus=pcie.0][,addr=z]  \
118 …   -device pcie-root-port,id=root_port1,multifunction=on,chassis=x,addr=z.0[,slot=y][,bus=pcie.0] \
119       -device pcie-root-port,id=root_port2,chassis=x1,addr=z.1[,slot=y1][,bus=pcie.0] \
120       -device pcie-root-port,id=root_port3,chassis=x2,addr=z.2[,slot=y2][,bus=pcie.0] \
122       -device pcie-root-port,id=root_port1,chassis=x,slot=y[,bus=pcie.0][,addr=z]  \
135 Legacy PCI devices can be plugged into pcie.0 as Integrated Endpoints,
138 Besides that use PCI Express to PCI Bridges (pcie-pci-bridge) in
147    pcie.0 bus
151    | PCI Dev |               | PCIe-PCI Bridge |
162 2.3.1 To plug a PCI device into pcie.0 as an Integrated Endpoint use:
163       -device <dev>[,bus=pcie.0]
165       -device pcie-pci-bridge,id=pcie_pci_bridge1[,bus=pcie.0] \
200 Complexes (pxb-pcie) are used.
213 The bus_nr properties of the pxb-pcie devices partition the 0..255 bus
215 given pxb-pcie device's root bus must fit between the bus_nr property of
216 that pxb-pcie device, and the lowest of the higher bus_nr properties
217 that the command line sets for other pxb-pcie devices.
222 The PCI Express root buses (pcie.0 and the buses exposed by pxb-pcie devices)
228     (4) pxb-pcie
256         PCI Express Root Ports (up to 8 ports per pcie.0 slot)