[[PageOutline]]

See also:
 * [wiki:PCI]

= Venice IMX8M PCIe Support
The IMX8M has a single PCIe Gen 2 host controller. Many Venice models have an on-board PCIe Gen 2 switch which allows the board to support more than 1 PCIe endpoint device.

A PCIe switch operates like a PCI bridge such that it will create additional subordinate busses.

Some Mini-PCIe slots only have USB signalling and not PCIe signalling, with cellular modems in mind. 


[=#pinout]
== PCIe Pinout ==
Please see the user manual for the specific board model following the links [https://www.gateworks.com/support/documentation/ here]


[=#throughput]
= PCIe Throughput

There are several factors that can affect PCIe performance. The most obvious factor is how many lanes (pairs of TX/RX SERDES channels) you have: 1x, 2x, 3x, 4x etc which are pure multipliers to the rates that can be achieved over a single lane. The next most obvious factor is what generation of PCIe your host controller (root complex or RC) and device (endpoint or EP) supports: Gen1, Gen2, Gen3 etc which factors into the transfer rate and data transfer overhead [1]. Digging deeper into the Transaction Layer Packet (TLP) overhead is not as obvious as RC's and EP's have varying max payload packet sizes. Digging even deeper than this you will get to specific limitations within the i.MX8M PCIe host controller.

The i.MX8M PCIe host controller has a limit where if the data transfer size exceeds 400 Bytes, the number of inbound MWr TLP transactions that the controller can support is up to the combination of 12 headers and 400 bytes of data payload as long as neither is exceeded. Higher performance can be obtained by having hte i.MX8M host controller issue outbound MRd transactions instead of using inbound MWr. See [https://comm.eefocus.com/media/download/index/id-1021154 AN13164 iMX8MP PCIe Bandwidth Analysis].


[=#perst]
= PCIe Reset
Reset signals are routed to the Mini-PCIe sockets. On boards without a switch this is an i.MX8M GPIO and on boards with a PCIe switch an i.MX8M GPIO drives the PERST# of the switch and the switch automatically controls the PERST# signal going to each down-stream socket and they can not be independently controlled.

= PCIe / USB3 Mux

Mini-PCIe cannot support USB 3.0 and PCIe at the same time, thus the mux is used to choose which to use. 

Note USB 3.0 is only available on Venice with a SOM module that supports USB 3.0.

 * GW7300-F and newer have a PCIe and USB 3.0 mux for Mini-PCIe slot J10. 
 * GW7200-F and newer have a PCIe and USB 3.0 mux for Mini-PCIe slot J10.


This mux is controlled through GPIO1_6 (default 0, which is PCIe), with a bootloader example shown below: (adjust per board, focus on gpio named pci_usb_sel)
{{{
u-boot=> gpio status
Bank GPIO1_:
GPIO1_0: output: 0 [x] rs485_term.gpio-hog
GPIO1_1: input: 0 [x] mipi_gpio4.gpio-hog
GPIO1_6: output: 0 [x] pci_usb_sel.gpio-hog
}}}

To set this GPIO high (USB 3.0) in uboot:
{{{
gpio set GPIO1_6
}}}

To clear this GPIO high (PCIe) in uboot:
{{{
gpio clear GPIO1_6
}}}

Then boot the board via the boot command:
{{{
boot
}}}

It is recommended to adjust this GPIO in the bootloader and not when the board boots into Linux. If the GPIO state does not persist across reboots, then add the command to the extra variable.