Documentation/devicetree/bindings/pci/snps,dw-pcie-ep.yaml

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/pci/snps,dw-pcie-ep.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Synopsys DesignWare PCIe endpoint interface
   8
   9 maintainers:
  10   - Jingoo Han <jingoohan1@gmail.com>
  11   - Gustavo Pimentel <gustavo.pimentel@synopsys.com>
  12
  13 description: |
  14   Synopsys DesignWare PCIe host controller endpoint
  15
  16 allOf:
  17   - $ref: /schemas/pci/pci-ep.yaml#
  18
  19 properties:
  20   compatible:
  21     anyOf:
  22       - {}
  23       - const: snps,dw-pcie-ep
  24
  25   reg:
  26     description: |
  27       It should contain Data Bus Interface (dbi) and config registers for all
  28       versions.
  29       For designware core version >= 4.80, it may contain ATU address space.
  30     minItems: 2
  31     maxItems: 4
  32
  33   reg-names:
  34     minItems: 2
  35     maxItems: 4
  36     items:
  37       enum: [dbi, dbi2, config, atu, addr_space, link, atu_dma, appl]
  38
  39   reset-gpio:
  40     description: GPIO pin number of PERST# signal
  41     maxItems: 1
  42     deprecated: true
  43
  44   reset-gpios:
  45     description: GPIO controlled connection to PERST# signal
  46     maxItems: 1
  47
  48   snps,enable-cdm-check:
  49     type: boolean
  50     description: |
  51       This is a boolean property and if present enables
  52       automatic checking of CDM (Configuration Dependent Module) registers
  53       for data corruption. CDM registers include standard PCIe configuration
  54       space registers, Port Logic registers, DMA and iATU (internal Address
  55       Translation Unit) registers.
  56
  57   num-ib-windows:
  58     description: number of inbound address translation windows
  59     maxItems: 1
  60     deprecated: true
  61
  62   num-ob-windows:
  63     description: number of outbound address translation windows
  64     maxItems: 1
  65     deprecated: true
  66
  67   max-functions:
  68     $ref: /schemas/types.yaml#/definitions/uint32
  69     description: maximum number of functions that can be configured
  70
  71 required:
  72   - reg
  73   - reg-names
  74   - compatible
  75
  76 unevaluatedProperties: false
  77
  78 examples:
  79   - |
  80     bus {
  81       #address-cells = <1>;
  82       #size-cells = <1>;
  83       pcie-ep@dfd00000 {
  84         compatible = "snps,dw-pcie-ep";
  85         reg = <0xdfc00000 0x0001000>, /* IP registers 1 */
  86               <0xdfc01000 0x0001000>, /* IP registers 2 */
  87               <0xd0000000 0x2000000>; /* Configuration space */
  88         reg-names = "dbi", "dbi2", "addr_space";
  89       };
  90     };