xref: /freebsd/sys/contrib/device-tree/Bindings/pci/snps,dw-pcie-ep.yaml (revision c7a063741720ef81d4caa4613242579d12f1d605) 
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
7title: Synopsys DesignWare PCIe endpoint interface
8
9maintainers:
10  - Jingoo Han <jingoohan1@gmail.com>
11  - Gustavo Pimentel <gustavo.pimentel@synopsys.com>
12
13description: |
14  Synopsys DesignWare PCIe host controller endpoint
15
16allOf:
17  - $ref: /schemas/pci/pci-ep.yaml#
18
19properties:
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    $ref: /schemas/types.yaml#/definitions/uint32
59    maximum: 256
60    description: number of inbound address translation windows
61    deprecated: true
62
63  num-ob-windows:
64    $ref: /schemas/types.yaml#/definitions/uint32
65    maximum: 256
66    description: number of outbound address translation windows
67    deprecated: true
68
69required:
70  - reg
71  - reg-names
72  - compatible
73
74additionalProperties: true
75
76examples:
77  - |
78    bus {
79      #address-cells = <1>;
80      #size-cells = <1>;
81      pcie-ep@dfd00000 {
82        compatible = "snps,dw-pcie-ep";
83        reg = <0xdfc00000 0x0001000>, /* IP registers 1 */
84              <0xdfc01000 0x0001000>, /* IP registers 2 */
85              <0xd0000000 0x2000000>; /* Configuration space */
86        reg-names = "dbi", "dbi2", "addr_space";
87      };
88    };
89