xref: /linux/Documentation/devicetree/bindings/net/wireless/qcom,ath11k.yaml (revision 6d9b262afe0ec1d6e0ef99321ca9d6b921310471)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2# Copyright (c) 2018-2019 The Linux Foundation. All rights reserved.
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/net/wireless/qcom,ath11k.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Qualcomm Technologies ath11k wireless devices
9
10maintainers:
11  - Kalle Valo <kvalo@kernel.org>
12  - Jeff Johnson <jjohnson@kernel.org>
13
14description: |
15  These are dt entries for Qualcomm Technologies, Inc. IEEE 802.11ax
16  devices, for example like AHB based IPQ8074.
17
18properties:
19  compatible:
20    enum:
21      - qcom,ipq8074-wifi
22      - qcom,ipq6018-wifi
23      - qcom,wcn6750-wifi
24      - qcom,ipq5018-wifi
25
26  reg:
27    maxItems: 1
28
29  interrupts:
30    minItems: 32
31    maxItems: 52
32
33  interrupt-names:
34    maxItems: 52
35
36  qcom,rproc:
37    $ref: /schemas/types.yaml#/definitions/phandle
38    description:
39      DT entry of q6v5-wcss remoteproc driver.
40      Phandle to a node that can contain the following properties
41        * compatible
42        * reg
43        * reg-names
44
45  qcom,ath11k-calibration-variant:
46    $ref: /schemas/types.yaml#/definitions/string
47    description:
48      string to uniquely identify variant of the calibration data in the
49      board-2.bin for designs with colliding bus and device specific ids
50
51  memory-region:
52    minItems: 1
53    maxItems: 2
54    description:
55      phandle to a node describing reserved memory (System RAM memory)
56      used by ath11k firmware (see bindings/reserved-memory/reserved-memory.txt)
57
58  iommus:
59    minItems: 1
60    maxItems: 2
61
62  wifi-firmware:
63    type: object
64    description: |
65      WCN6750 wifi node can contain one optional firmware subnode.
66      Firmware subnode is needed when the platform does not have Trustzone.
67    required:
68      - iommus
69
70  qcom,smem-states:
71    $ref: /schemas/types.yaml#/definitions/phandle-array
72    description: State bits used by the AP to signal the WLAN Q6.
73    items:
74      - description: Signal bits used to enable/disable low power mode
75                     on WCN6750 in the case of WoW (Wake on Wireless).
76
77  qcom,smem-state-names:
78    description: The names of the state bits used for SMP2P output.
79    items:
80      - const: wlan-smp2p-out
81
82required:
83  - compatible
84  - reg
85  - interrupts
86  - qcom,rproc
87
88additionalProperties: false
89
90allOf:
91  - if:
92      properties:
93        compatible:
94          contains:
95            enum:
96              - qcom,ipq8074-wifi
97              - qcom,ipq6018-wifi
98    then:
99      properties:
100        interrupts:
101          items:
102            - description: misc-pulse1 interrupt events
103            - description: misc-latch interrupt events
104            - description: sw exception interrupt events
105            - description: watchdog interrupt events
106            - description: interrupt event for ring CE0
107            - description: interrupt event for ring CE1
108            - description: interrupt event for ring CE2
109            - description: interrupt event for ring CE3
110            - description: interrupt event for ring CE4
111            - description: interrupt event for ring CE5
112            - description: interrupt event for ring CE6
113            - description: interrupt event for ring CE7
114            - description: interrupt event for ring CE8
115            - description: interrupt event for ring CE9
116            - description: interrupt event for ring CE10
117            - description: interrupt event for ring CE11
118            - description: interrupt event for ring host2wbm-desc-feed
119            - description: interrupt event for ring host2reo-re-injection
120            - description: interrupt event for ring host2reo-command
121            - description: interrupt event for ring host2rxdma-monitor-ring3
122            - description: interrupt event for ring host2rxdma-monitor-ring2
123            - description: interrupt event for ring host2rxdma-monitor-ring1
124            - description: interrupt event for ring reo2ost-exception
125            - description: interrupt event for ring wbm2host-rx-release
126            - description: interrupt event for ring reo2host-status
127            - description: interrupt event for ring reo2host-destination-ring4
128            - description: interrupt event for ring reo2host-destination-ring3
129            - description: interrupt event for ring reo2host-destination-ring2
130            - description: interrupt event for ring reo2host-destination-ring1
131            - description: interrupt event for ring rxdma2host-monitor-destination-mac3
132            - description: interrupt event for ring rxdma2host-monitor-destination-mac2
133            - description: interrupt event for ring rxdma2host-monitor-destination-mac1
134            - description: interrupt event for ring ppdu-end-interrupts-mac3
135            - description: interrupt event for ring ppdu-end-interrupts-mac2
136            - description: interrupt event for ring ppdu-end-interrupts-mac1
137            - description: interrupt event for ring rxdma2host-monitor-status-ring-mac3
138            - description: interrupt event for ring rxdma2host-monitor-status-ring-mac2
139            - description: interrupt event for ring rxdma2host-monitor-status-ring-mac1
140            - description: interrupt event for ring host2rxdma-host-buf-ring-mac3
141            - description: interrupt event for ring host2rxdma-host-buf-ring-mac2
142            - description: interrupt event for ring host2rxdma-host-buf-ring-mac1
143            - description: interrupt event for ring rxdma2host-destination-ring-mac3
144            - description: interrupt event for ring rxdma2host-destination-ring-mac2
145            - description: interrupt event for ring rxdma2host-destination-ring-mac1
146            - description: interrupt event for ring host2tcl-input-ring4
147            - description: interrupt event for ring host2tcl-input-ring3
148            - description: interrupt event for ring host2tcl-input-ring2
149            - description: interrupt event for ring host2tcl-input-ring1
150            - description: interrupt event for ring wbm2host-tx-completions-ring3
151            - description: interrupt event for ring wbm2host-tx-completions-ring2
152            - description: interrupt event for ring wbm2host-tx-completions-ring1
153            - description: interrupt event for ring tcl2host-status-ring
154        interrupt-names:
155          items:
156            - const: misc-pulse1
157            - const: misc-latch
158            - const: sw-exception
159            - const: watchdog
160            - const: ce0
161            - const: ce1
162            - const: ce2
163            - const: ce3
164            - const: ce4
165            - const: ce5
166            - const: ce6
167            - const: ce7
168            - const: ce8
169            - const: ce9
170            - const: ce10
171            - const: ce11
172            - const: host2wbm-desc-feed
173            - const: host2reo-re-injection
174            - const: host2reo-command
175            - const: host2rxdma-monitor-ring3
176            - const: host2rxdma-monitor-ring2
177            - const: host2rxdma-monitor-ring1
178            - const: reo2ost-exception
179            - const: wbm2host-rx-release
180            - const: reo2host-status
181            - const: reo2host-destination-ring4
182            - const: reo2host-destination-ring3
183            - const: reo2host-destination-ring2
184            - const: reo2host-destination-ring1
185            - const: rxdma2host-monitor-destination-mac3
186            - const: rxdma2host-monitor-destination-mac2
187            - const: rxdma2host-monitor-destination-mac1
188            - const: ppdu-end-interrupts-mac3
189            - const: ppdu-end-interrupts-mac2
190            - const: ppdu-end-interrupts-mac1
191            - const: rxdma2host-monitor-status-ring-mac3
192            - const: rxdma2host-monitor-status-ring-mac2
193            - const: rxdma2host-monitor-status-ring-mac1
194            - const: host2rxdma-host-buf-ring-mac3
195            - const: host2rxdma-host-buf-ring-mac2
196            - const: host2rxdma-host-buf-ring-mac1
197            - const: rxdma2host-destination-ring-mac3
198            - const: rxdma2host-destination-ring-mac2
199            - const: rxdma2host-destination-ring-mac1
200            - const: host2tcl-input-ring4
201            - const: host2tcl-input-ring3
202            - const: host2tcl-input-ring2
203            - const: host2tcl-input-ring1
204            - const: wbm2host-tx-completions-ring3
205            - const: wbm2host-tx-completions-ring2
206            - const: wbm2host-tx-completions-ring1
207            - const: tcl2host-status-ring
208
209  - if:
210      properties:
211        compatible:
212          contains:
213            enum:
214              - qcom,ipq8074-wifi
215              - qcom,ipq6018-wifi
216    then:
217      required:
218        - interrupt-names
219
220  - if:
221      properties:
222        compatible:
223          contains:
224            enum:
225              - qcom,wcn6750-wifi
226    then:
227      properties:
228        interrupts:
229          items:
230            - description: interrupt event for ring CE1
231            - description: interrupt event for ring CE2
232            - description: interrupt event for ring CE3
233            - description: interrupt event for ring CE4
234            - description: interrupt event for ring CE5
235            - description: interrupt event for ring CE6
236            - description: interrupt event for ring CE7
237            - description: interrupt event for ring CE8
238            - description: interrupt event for ring CE9
239            - description: interrupt event for ring CE10
240            - description: interrupt event for ring DP1
241            - description: interrupt event for ring DP2
242            - description: interrupt event for ring DP3
243            - description: interrupt event for ring DP4
244            - description: interrupt event for ring DP5
245            - description: interrupt event for ring DP6
246            - description: interrupt event for ring DP7
247            - description: interrupt event for ring DP8
248            - description: interrupt event for ring DP9
249            - description: interrupt event for ring DP10
250            - description: interrupt event for ring DP11
251            - description: interrupt event for ring DP12
252            - description: interrupt event for ring DP13
253            - description: interrupt event for ring DP14
254            - description: interrupt event for ring DP15
255            - description: interrupt event for ring DP16
256            - description: interrupt event for ring DP17
257            - description: interrupt event for ring DP18
258            - description: interrupt event for ring DP19
259            - description: interrupt event for ring DP20
260            - description: interrupt event for ring DP21
261            - description: interrupt event for ring DP22
262
263examples:
264  - |
265
266    q6v5_wcss: remoteproc@cd00000 {
267        compatible = "qcom,ipq8074-wcss-pil";
268        reg = <0xcd00000 0x4040>,
269              <0x4ab000 0x20>;
270        reg-names = "qdsp6",
271                    "rmb";
272    };
273
274    wifi0: wifi@c000000 {
275        compatible = "qcom,ipq8074-wifi";
276        reg = <0xc000000 0x2000000>;
277        interrupts = <0 320 1>,
278                     <0 319 1>,
279                     <0 318 1>,
280                     <0 317 1>,
281                     <0 316 1>,
282                     <0 315 1>,
283                     <0 314 1>,
284                     <0 311 1>,
285                     <0 310 1>,
286                     <0 411 1>,
287                     <0 410 1>,
288                     <0 40 1>,
289                     <0 39 1>,
290                     <0 302 1>,
291                     <0 301 1>,
292                     <0 37 1>,
293                     <0 36 1>,
294                     <0 296 1>,
295                     <0 295 1>,
296                     <0 294 1>,
297                     <0 293 1>,
298                     <0 292 1>,
299                     <0 291 1>,
300                     <0 290 1>,
301                     <0 289 1>,
302                     <0 288 1>,
303                     <0 239 1>,
304                     <0 236 1>,
305                     <0 235 1>,
306                     <0 234 1>,
307                     <0 233 1>,
308                     <0 232 1>,
309                     <0 231 1>,
310                     <0 230 1>,
311                     <0 229 1>,
312                     <0 228 1>,
313                     <0 224 1>,
314                     <0 223 1>,
315                     <0 203 1>,
316                     <0 183 1>,
317                     <0 180 1>,
318                     <0 179 1>,
319                     <0 178 1>,
320                     <0 177 1>,
321                     <0 176 1>,
322                     <0 163 1>,
323                     <0 162 1>,
324                     <0 160 1>,
325                     <0 159 1>,
326                     <0 158 1>,
327                     <0 157 1>,
328                     <0 156 1>;
329        interrupt-names = "misc-pulse1",
330                          "misc-latch",
331                          "sw-exception",
332                          "watchdog",
333                          "ce0",
334                          "ce1",
335                          "ce2",
336                          "ce3",
337                          "ce4",
338                          "ce5",
339                          "ce6",
340                          "ce7",
341                          "ce8",
342                          "ce9",
343                          "ce10",
344                          "ce11",
345                          "host2wbm-desc-feed",
346                          "host2reo-re-injection",
347                          "host2reo-command",
348                          "host2rxdma-monitor-ring3",
349                          "host2rxdma-monitor-ring2",
350                          "host2rxdma-monitor-ring1",
351                          "reo2ost-exception",
352                          "wbm2host-rx-release",
353                          "reo2host-status",
354                          "reo2host-destination-ring4",
355                          "reo2host-destination-ring3",
356                          "reo2host-destination-ring2",
357                          "reo2host-destination-ring1",
358                          "rxdma2host-monitor-destination-mac3",
359                          "rxdma2host-monitor-destination-mac2",
360                          "rxdma2host-monitor-destination-mac1",
361                          "ppdu-end-interrupts-mac3",
362                          "ppdu-end-interrupts-mac2",
363                          "ppdu-end-interrupts-mac1",
364                          "rxdma2host-monitor-status-ring-mac3",
365                          "rxdma2host-monitor-status-ring-mac2",
366                          "rxdma2host-monitor-status-ring-mac1",
367                          "host2rxdma-host-buf-ring-mac3",
368                          "host2rxdma-host-buf-ring-mac2",
369                          "host2rxdma-host-buf-ring-mac1",
370                          "rxdma2host-destination-ring-mac3",
371                          "rxdma2host-destination-ring-mac2",
372                          "rxdma2host-destination-ring-mac1",
373                          "host2tcl-input-ring4",
374                          "host2tcl-input-ring3",
375                          "host2tcl-input-ring2",
376                          "host2tcl-input-ring1",
377                          "wbm2host-tx-completions-ring3",
378                          "wbm2host-tx-completions-ring2",
379                          "wbm2host-tx-completions-ring1",
380                          "tcl2host-status-ring";
381        qcom,rproc = <&q6v5_wcss>;
382    };
383
384  - |
385
386    reserved-memory {
387        #address-cells = <2>;
388        #size-cells = <2>;
389
390        qcn9074_0: wifi@51100000 {
391            no-map;
392            reg = <0x0 0x51100000 0x0 0x03500000>;
393        };
394    };
395
396    pci {
397        pcie0 {
398            #size-cells = <2>;
399            #address-cells = <3>;
400
401            wifi_0: wifi@0 {
402                reg = <0 0 0 0 0>;
403                memory-region = <&qcn9074_0>;
404            };
405        };
406    };
407
408  - |
409    #include <dt-bindings/interrupt-controller/arm-gic.h>
410
411    reserved-memory {
412        #address-cells = <2>;
413        #size-cells = <2>;
414
415        wlan_ce_mem: memory@4cd000 {
416            no-map;
417            reg = <0x0 0x004cd000 0x0 0x1000>;
418        };
419
420        wlan_fw_mem: memory@80c00000 {
421            no-map;
422            reg = <0x0 0x80c00000 0x0 0xc00000>;
423        };
424    };
425
426    wifi: wifi@17a10040 {
427        compatible = "qcom,wcn6750-wifi";
428        reg = <0x17a10040 0x0>;
429        iommus = <&apps_smmu 0x1c00 0x1>;
430        interrupts = <GIC_SPI 768 IRQ_TYPE_EDGE_RISING>,
431                     <GIC_SPI 769 IRQ_TYPE_EDGE_RISING>,
432                     <GIC_SPI 770 IRQ_TYPE_EDGE_RISING>,
433                     <GIC_SPI 771 IRQ_TYPE_EDGE_RISING>,
434                     <GIC_SPI 772 IRQ_TYPE_EDGE_RISING>,
435                     <GIC_SPI 773 IRQ_TYPE_EDGE_RISING>,
436                     <GIC_SPI 774 IRQ_TYPE_EDGE_RISING>,
437                     <GIC_SPI 775 IRQ_TYPE_EDGE_RISING>,
438                     <GIC_SPI 776 IRQ_TYPE_EDGE_RISING>,
439                     <GIC_SPI 777 IRQ_TYPE_EDGE_RISING>,
440                     <GIC_SPI 778 IRQ_TYPE_EDGE_RISING>,
441                     <GIC_SPI 779 IRQ_TYPE_EDGE_RISING>,
442                     <GIC_SPI 780 IRQ_TYPE_EDGE_RISING>,
443                     <GIC_SPI 781 IRQ_TYPE_EDGE_RISING>,
444                     <GIC_SPI 782 IRQ_TYPE_EDGE_RISING>,
445                     <GIC_SPI 783 IRQ_TYPE_EDGE_RISING>,
446                     <GIC_SPI 784 IRQ_TYPE_EDGE_RISING>,
447                     <GIC_SPI 785 IRQ_TYPE_EDGE_RISING>,
448                     <GIC_SPI 786 IRQ_TYPE_EDGE_RISING>,
449                     <GIC_SPI 787 IRQ_TYPE_EDGE_RISING>,
450                     <GIC_SPI 788 IRQ_TYPE_EDGE_RISING>,
451                     <GIC_SPI 789 IRQ_TYPE_EDGE_RISING>,
452                     <GIC_SPI 790 IRQ_TYPE_EDGE_RISING>,
453                     <GIC_SPI 791 IRQ_TYPE_EDGE_RISING>,
454                     <GIC_SPI 792 IRQ_TYPE_EDGE_RISING>,
455                     <GIC_SPI 793 IRQ_TYPE_EDGE_RISING>,
456                     <GIC_SPI 794 IRQ_TYPE_EDGE_RISING>,
457                     <GIC_SPI 795 IRQ_TYPE_EDGE_RISING>,
458                     <GIC_SPI 796 IRQ_TYPE_EDGE_RISING>,
459                     <GIC_SPI 797 IRQ_TYPE_EDGE_RISING>,
460                     <GIC_SPI 798 IRQ_TYPE_EDGE_RISING>,
461                     <GIC_SPI 799 IRQ_TYPE_EDGE_RISING>;
462        qcom,rproc = <&remoteproc_wpss>;
463        memory-region = <&wlan_fw_mem>, <&wlan_ce_mem>;
464        qcom,smem-states = <&wlan_smp2p_out 0>;
465        qcom,smem-state-names = "wlan-smp2p-out";
466        wifi-firmware {
467            iommus = <&apps_smmu 0x1c02 0x1>;
468        };
469    };
470