Documentation/devicetree/bindings/pci/ti,j721e-pci-ep.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 # Copyright (C) 2020 Texas Instruments Incorporated - http://www.ti.com/
   3 %YAML 1.2
   4 ---
   5 $id: http://devicetree.org/schemas/pci/ti,j721e-pci-ep.yaml#
   6 $schema: http://devicetree.org/meta-schemas/core.yaml#
   7
   8 title: TI J721E PCI EP (PCIe Wrapper)
   9
  10 maintainers:
  11   - Kishon Vijay Abraham I <kishon@ti.com>
  12
  13 allOf:
  14   - $ref: cdns-pcie-ep.yaml#
  15
  16 properties:
  17   compatible:
  18     oneOf:
  19       - const: ti,j721e-pcie-ep
  20       - description: PCIe EP controller in AM64
  21         items:
  22           - const: ti,am64-pcie-ep
  23           - const: ti,j721e-pcie-ep
  24       - description: PCIe EP controller in J7200
  25         items:
  26           - const: ti,j7200-pcie-ep
  27           - const: ti,j721e-pcie-ep
  28
  29   reg:
  30     maxItems: 4
  31
  32   reg-names:
  33     items:
  34       - const: intd_cfg
  35       - const: user_cfg
  36       - const: reg
  37       - const: mem
  38
  39   ti,syscon-pcie-ctrl:
  40     $ref: /schemas/types.yaml#/definitions/phandle-array
  41     items:
  42       - items:
  43           - description: Phandle to the SYSCON entry
  44           - description: pcie_ctrl register offset within SYSCON
  45     description: Specifier for configuring PCIe mode and link speed.
  46
  47   power-domains:
  48     maxItems: 1
  49
  50   clocks:
  51     maxItems: 1
  52     description: clock-specifier to represent input to the PCIe
  53
  54   clock-names:
  55     items:
  56       - const: fck
  57
  58   dma-coherent:
  59     description: Indicates that the PCIe IP block can ensure the coherency
  60
  61   interrupts:
  62     maxItems: 1
  63
  64   interrupt-names:
  65     items:
  66       - const: link_state
  67
  68 required:
  69   - compatible
  70   - reg
  71   - reg-names
  72   - ti,syscon-pcie-ctrl
  73   - max-link-speed
  74   - num-lanes
  75   - power-domains
  76   - clocks
  77   - clock-names
  78   - max-functions
  79   - phys
  80   - phy-names
  81
  82 unevaluatedProperties: false
  83
  84 examples:
  85   - |
  86     #include <dt-bindings/soc/ti,sci_pm_domain.h>
  87
  88     bus {
  89         #address-cells = <2>;
  90         #size-cells = <2>;
  91
  92         pcie0_ep: pcie-ep@d000000 {
  93            compatible = "ti,j721e-pcie-ep";
  94            reg = <0x00 0x02900000 0x00 0x1000>,
  95                  <0x00 0x02907000 0x00 0x400>,
  96                  <0x00 0x0d000000 0x00 0x00800000>,
  97                  <0x00 0x10000000 0x00 0x08000000>;
  98            reg-names = "intd_cfg", "user_cfg", "reg", "mem";
  99            ti,syscon-pcie-ctrl = <&pcie0_ctrl 0x4070>;
 100            max-link-speed = <3>;
 101            num-lanes = <2>;
 102            power-domains = <&k3_pds 239 TI_SCI_PD_EXCLUSIVE>;
 103            clocks = <&k3_clks 239 1>;
 104            clock-names = "fck";
 105            max-functions = /bits/ 8 <6>;
 106            dma-coherent;
 107            phys = <&serdes0_pcie_link>;
 108            phy-names = "pcie-phy";
 109        };
 110     };