Merge tag 'dma-mapping-4.20-1' of git://git.infradead.org/users/hch/dma-mapping
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / pci / pci-keystone.txt
1 TI Keystone PCIe interface
2
3 Keystone PCI host Controller is based on the Synopsys DesignWare PCI
4 hardware version 3.65.  It shares common functions with the PCIe DesignWare
5 core driver and inherits common properties defined in
6 Documentation/devicetree/bindings/pci/designware-pcie.txt
7
8 Please refer to Documentation/devicetree/bindings/pci/designware-pcie.txt
9 for the details of DesignWare DT bindings.  Additional properties are
10 described here as well as properties that are not applicable.
11
12 Required Properties:-
13
14 compatibility: "ti,keystone-pcie"
15 reg:    index 1 is the base address and length of DW application registers.
16         index 2 is the base address and length of PCI device ID register.
17
18 pcie_msi_intc : Interrupt controller device node for MSI IRQ chip
19         interrupt-cells: should be set to 1
20         interrupts: GIC interrupt lines connected to PCI MSI interrupt lines
21
22 ti,syscon-pcie-id : phandle to the device control module required to set device
23                     id and vendor id.
24
25  Example:
26         pcie_msi_intc: msi-interrupt-controller {
27                         interrupt-controller;
28                         #interrupt-cells = <1>;
29                         interrupt-parent = <&gic>;
30                         interrupts = <GIC_SPI 30 IRQ_TYPE_EDGE_RISING>,
31                                         <GIC_SPI 31 IRQ_TYPE_EDGE_RISING>,
32                                         <GIC_SPI 32 IRQ_TYPE_EDGE_RISING>,
33                                         <GIC_SPI 33 IRQ_TYPE_EDGE_RISING>,
34                                         <GIC_SPI 34 IRQ_TYPE_EDGE_RISING>,
35                                         <GIC_SPI 35 IRQ_TYPE_EDGE_RISING>,
36                                         <GIC_SPI 36 IRQ_TYPE_EDGE_RISING>,
37                                         <GIC_SPI 37 IRQ_TYPE_EDGE_RISING>;
38         };
39
40 pcie_intc: Interrupt controller device node for Legacy IRQ chip
41         interrupt-cells: should be set to 1
42
43  Example:
44         pcie_intc: legacy-interrupt-controller {
45                 interrupt-controller;
46                 #interrupt-cells = <1>;
47                 interrupt-parent = <&gic>;
48                 interrupts = <GIC_SPI 26 IRQ_TYPE_EDGE_RISING>,
49                         <GIC_SPI 27 IRQ_TYPE_EDGE_RISING>,
50                         <GIC_SPI 28 IRQ_TYPE_EDGE_RISING>,
51                         <GIC_SPI 29 IRQ_TYPE_EDGE_RISING>;
52         };
53
54 Optional properties:-
55         phys: phandle to generic Keystone SerDes PHY for PCI
56         phy-names: name of the generic Keystone SerDes PHY for PCI
57           - If boot loader already does PCI link establishment, then phys and
58             phy-names shouldn't be present.
59         interrupts: platform interrupt for error interrupts.
60
61 DesignWare DT Properties not applicable for Keystone PCI
62
63 1. pcie_bus clock-names not used.  Instead, a phandle to phys is used.