xref: /linux/Documentation/devicetree/bindings/pci/mediatek-pcie-gen3.yaml (revision 7f71507851fc7764b36a3221839607d3a45c2025) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/pci/mediatek-pcie-gen3.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Gen3 PCIe controller on MediaTek SoCs
8
9maintainers:
10  - Jianjun Wang <jianjun.wang@mediatek.com>
11
12description: |+
13  PCIe Gen3 MAC controller for MediaTek SoCs, it supports Gen3 speed
14  and compatible with Gen2, Gen1 speed.
15
16  This PCIe controller supports up to 256 MSI vectors, the MSI hardware
17  block diagram is as follows:
18
19                    +-----+
20                    | GIC |
21                    +-----+
22                       ^
23                       |
24                   port->irq
25                       |
26               +-+-+-+-+-+-+-+-+
27               |0|1|2|3|4|5|6|7| (PCIe intc)
28               +-+-+-+-+-+-+-+-+
29                ^ ^           ^
30                | |    ...    |
31        +-------+ +------+    +-----------+
32        |                |                |
33  +-+-+---+--+--+  +-+-+---+--+--+  +-+-+---+--+--+
34  |0|1|...|30|31|  |0|1|...|30|31|  |0|1|...|30|31| (MSI sets)
35  +-+-+---+--+--+  +-+-+---+--+--+  +-+-+---+--+--+
36   ^ ^      ^  ^    ^ ^      ^  ^    ^ ^      ^  ^
37   | |      |  |    | |      |  |    | |      |  |  (MSI vectors)
38   | |      |  |    | |      |  |    | |      |  |
39
40    (MSI SET0)       (MSI SET1)  ...   (MSI SET7)
41
42  With 256 MSI vectors supported, the MSI vectors are composed of 8 sets,
43  each set has its own address for MSI message, and supports 32 MSI vectors
44  to generate interrupt.
45
46properties:
47  compatible:
48    oneOf:
49      - items:
50          - enum:
51              - mediatek,mt7986-pcie
52              - mediatek,mt8188-pcie
53              - mediatek,mt8195-pcie
54          - const: mediatek,mt8192-pcie
55      - const: mediatek,mt8192-pcie
56      - const: airoha,en7581-pcie
57
58  reg:
59    maxItems: 1
60
61  reg-names:
62    items:
63      - const: pcie-mac
64
65  interrupts:
66    maxItems: 1
67
68  ranges:
69    minItems: 1
70    maxItems: 8
71
72  iommu-map:
73    maxItems: 1
74
75  iommu-map-mask:
76    const: 0
77
78  resets:
79    minItems: 1
80    maxItems: 3
81
82  reset-names:
83    minItems: 1
84    maxItems: 3
85    items:
86      enum: [ phy, mac, phy-lane0, phy-lane1, phy-lane2 ]
87
88  clocks:
89    minItems: 1
90    maxItems: 6
91
92  clock-names:
93    minItems: 1
94    maxItems: 6
95
96  assigned-clocks:
97    maxItems: 1
98
99  assigned-clock-parents:
100    maxItems: 1
101
102  phys:
103    maxItems: 1
104
105  phy-names:
106    items:
107      - const: pcie-phy
108
109  power-domains:
110    maxItems: 1
111
112  '#interrupt-cells':
113    const: 1
114
115  interrupt-controller:
116    description: Interrupt controller node for handling legacy PCI interrupts.
117    type: object
118    properties:
119      '#address-cells':
120        const: 0
121      '#interrupt-cells':
122        const: 1
123      interrupt-controller: true
124
125    required:
126      - '#address-cells'
127      - '#interrupt-cells'
128      - interrupt-controller
129
130    additionalProperties: false
131
132required:
133  - compatible
134  - reg
135  - reg-names
136  - interrupts
137  - ranges
138  - clocks
139  - clock-names
140  - '#interrupt-cells'
141  - interrupt-controller
142
143allOf:
144  - $ref: /schemas/pci/pci-host-bridge.yaml#
145  - if:
146      properties:
147        compatible:
148          const: mediatek,mt8192-pcie
149    then:
150      properties:
151        clocks:
152          minItems: 6
153
154        clock-names:
155          items:
156            - const: pl_250m
157            - const: tl_26m
158            - const: tl_96m
159            - const: tl_32k
160            - const: peri_26m
161            - const: top_133m
162
163        resets:
164          minItems: 1
165          maxItems: 2
166
167        reset-names:
168          minItems: 1
169          maxItems: 2
170
171  - if:
172      properties:
173        compatible:
174          contains:
175            enum:
176              - mediatek,mt8188-pcie
177              - mediatek,mt8195-pcie
178    then:
179      properties:
180        clocks:
181          minItems: 6
182
183        clock-names:
184          items:
185            - const: pl_250m
186            - const: tl_26m
187            - const: tl_96m
188            - const: tl_32k
189            - const: peri_26m
190            - const: peri_mem
191
192        resets:
193          minItems: 1
194          maxItems: 2
195
196        reset-names:
197          minItems: 1
198          maxItems: 2
199
200  - if:
201      properties:
202        compatible:
203          contains:
204            enum:
205              - mediatek,mt7986-pcie
206    then:
207      properties:
208        clocks:
209          minItems: 4
210          maxItems: 4
211
212        clock-names:
213          items:
214            - const: pl_250m
215            - const: tl_26m
216            - const: peri_26m
217            - const: top_133m
218
219        resets:
220          minItems: 1
221          maxItems: 2
222
223        reset-names:
224          minItems: 1
225          maxItems: 2
226
227  - if:
228      properties:
229        compatible:
230          const: airoha,en7581-pcie
231    then:
232      properties:
233        clocks:
234          maxItems: 1
235
236        clock-names:
237          items:
238            - const: sys-ck
239
240        resets:
241          minItems: 3
242
243        reset-names:
244          items:
245            - const: phy-lane0
246            - const: phy-lane1
247            - const: phy-lane2
248
249unevaluatedProperties: false
250
251examples:
252  - |
253    #include <dt-bindings/interrupt-controller/arm-gic.h>
254    #include <dt-bindings/interrupt-controller/irq.h>
255
256    bus {
257        #address-cells = <2>;
258        #size-cells = <2>;
259
260        pcie: pcie@11230000 {
261            compatible = "mediatek,mt8192-pcie";
262            device_type = "pci";
263            #address-cells = <3>;
264            #size-cells = <2>;
265            reg = <0x00 0x11230000 0x00 0x4000>;
266            reg-names = "pcie-mac";
267            interrupts = <GIC_SPI 251 IRQ_TYPE_LEVEL_HIGH 0>;
268            bus-range = <0x00 0xff>;
269            ranges = <0x82000000 0x00 0x12000000 0x00
270                      0x12000000 0x00 0x1000000>;
271            clocks = <&infracfg 44>,
272                     <&infracfg 40>,
273                     <&infracfg 43>,
274                     <&infracfg 97>,
275                     <&infracfg 99>,
276                     <&infracfg 111>;
277            clock-names = "pl_250m", "tl_26m", "tl_96m",
278                          "tl_32k", "peri_26m", "top_133m";
279            assigned-clocks = <&topckgen 50>;
280            assigned-clock-parents = <&topckgen 91>;
281
282            phys = <&pciephy>;
283            phy-names = "pcie-phy";
284
285            resets = <&infracfg_rst 2>,
286                     <&infracfg_rst 3>;
287            reset-names = "phy", "mac";
288
289            #interrupt-cells = <1>;
290            interrupt-map-mask = <0 0 0 0x7>;
291            interrupt-map = <0 0 0 1 &pcie_intc 0>,
292                            <0 0 0 2 &pcie_intc 1>,
293                            <0 0 0 3 &pcie_intc 2>,
294                            <0 0 0 4 &pcie_intc 3>;
295            pcie_intc: interrupt-controller {
296                      #address-cells = <0>;
297                      #interrupt-cells = <1>;
298                      interrupt-controller;
299            };
300        };
301    };
302