xref: /linux/Documentation/devicetree/bindings/net/wireless/mediatek,mt76.yaml (revision 981368e1440b76f68b1ac8f5fb14e739f80ecc4e)
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/mediatek,mt76.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: MediaTek mt76 wireless devices
9
10maintainers:
11  - Felix Fietkau <nbd@nbd.name>
12  - Lorenzo Bianconi <lorenzo@kernel.org>
13  - Ryder Lee <ryder.lee@mediatek.com>
14
15description: |
16  This node provides properties for configuring the MediaTek mt76xx
17  wireless device. The node is expected to be specified as a child
18  node of the PCI controller to which the wireless chip is connected.
19  Alternatively, it can specify the wireless part of the MT7628/MT7688
20  or MT7622/MT7986 SoC.
21
22allOf:
23  - $ref: ieee80211.yaml#
24
25properties:
26  compatible:
27    enum:
28      - mediatek,mt76
29      - mediatek,mt7628-wmac
30      - mediatek,mt7622-wmac
31      - mediatek,mt7981-wmac
32      - mediatek,mt7986-wmac
33
34  reg:
35    minItems: 1
36    maxItems: 3
37    description:
38      MT7986 should contain 3 regions consys, dcm, and sku, in this order.
39
40  interrupts:
41    maxItems: 1
42
43  power-domains:
44    maxItems: 1
45
46  memory-region:
47    maxItems: 1
48
49  resets:
50    maxItems: 1
51    description:
52      Specify the consys reset for mt7986.
53
54  reset-names:
55    const: consys
56
57  clocks:
58    maxItems: 2
59    description:
60      Specify the consys clocks for mt7986.
61
62  clock-names:
63    items:
64      - const: mcu
65      - const: ap2conn
66
67  mediatek,infracfg:
68    $ref: /schemas/types.yaml#/definitions/phandle
69    description:
70      Phandle to the infrastructure bus fabric syscon node.
71      This property is MT7622 specific
72
73  ieee80211-freq-limit: true
74
75  nvmem-cells:
76    items:
77      - description: NVMEM cell with EEPROM
78
79  nvmem-cell-names:
80    items:
81      - const: eeprom
82
83  mediatek,eeprom-data:
84    $ref: /schemas/types.yaml#/definitions/uint32-array
85    description:
86      EEPROM data embedded as array.
87
88  mediatek,mtd-eeprom:
89    $ref: /schemas/types.yaml#/definitions/phandle-array
90    items:
91      - items:
92          - description: phandle to MTD partition
93          - description: offset containing EEPROM data
94    description:
95      Phandle to a MTD partition + offset containing EEPROM data
96    deprecated: true
97
98  big-endian:
99    $ref: /schemas/types.yaml#/definitions/flag
100    description:
101      Specify if the radio eeprom partition is written in big-endian
102
103  mediatek,eeprom-merge-otp:
104    type: boolean
105    description:
106      Merge EEPROM data with OTP data. Can be used on boards where the flash
107      calibration data is generic and specific calibration data should be
108      pulled from the OTP ROM
109
110  mediatek,disable-radar-background:
111    type: boolean
112    description:
113      Disable/enable radar/CAC detection running on a dedicated offchannel
114      chain available on some hw.
115      Background radar/CAC detection allows to avoid the CAC downtime
116      switching on a different channel during CAC detection on the selected
117      radar channel.
118
119  led:
120    type: object
121    $ref: /schemas/leds/common.yaml#
122    additionalProperties: false
123    properties:
124      led-active-low:
125        description:
126          LED is enabled with ground signal.
127        type: boolean
128
129      led-sources:
130        maxItems: 1
131
132  power-limits:
133    type: object
134    additionalProperties: false
135    patternProperties:
136      "^r[0-9]+":
137        type: object
138        additionalProperties: false
139        properties:
140          regdomain:
141            $ref: /schemas/types.yaml#/definitions/string
142            description:
143              Regdomain refers to a legal regulatory region. Different
144              countries define different levels of allowable transmitter
145              power, time that a channel can be occupied, and different
146              available channels
147            enum:
148              - FCC
149              - ETSI
150              - JP
151
152        patternProperties:
153          "^txpower-[256]g$":
154            type: object
155            additionalProperties: false
156            patternProperties:
157              "^b[0-9]+$":
158                type: object
159                additionalProperties: false
160                properties:
161                  channels:
162                    $ref: /schemas/types.yaml#/definitions/uint32-array
163                    minItems: 2
164                    maxItems: 2
165                    description:
166                      Pairs of first and last channel number of the selected
167                      band
168
169                  rates-cck:
170                    $ref: /schemas/types.yaml#/definitions/uint8-array
171                    minItems: 4
172                    maxItems: 4
173                    description:
174                      4 half-dBm per-rate power limit values
175
176                  rates-ofdm:
177                    $ref: /schemas/types.yaml#/definitions/uint8-array
178                    minItems: 8
179                    maxItems: 8
180                    description:
181                      8 half-dBm per-rate power limit values
182
183                  rates-mcs:
184                    $ref: /schemas/types.yaml#/definitions/uint8-matrix
185                    description:
186                      Sets of per-rate power limit values for 802.11n/802.11ac
187                      rates for multiple channel bandwidth settings.
188                      Each set starts with the number of channel bandwidth
189                      settings for which the rate set applies, followed by
190                      either 8 or 10 power limit values. The order of the
191                      channel bandwidth settings is 20, 40, 80 and 160 MHz.
192                    maxItems: 4
193                    items:
194                      minItems: 9
195                      maxItems: 11
196
197                  rates-ru:
198                    $ref: /schemas/types.yaml#/definitions/uint8-matrix
199                    description:
200                      Sets of per-rate power limit values for 802.11ax rates
201                      for multiple channel bandwidth or resource unit settings.
202                      Each set starts with the number of channel bandwidth or
203                      resource unit settings for which the rate set applies,
204                      followed by 12 power limit values. The order of the
205                      channel resource unit settings is RU26, RU52, RU106,
206                      RU242/SU20, RU484/SU40, RU996/SU80 and RU2x996/SU160.
207                    items:
208                      minItems: 13
209                      maxItems: 13
210
211                  txs-delta:
212                    $ref: /schemas/types.yaml#/definitions/uint32-array
213                    description:
214                      Half-dBm power delta for different numbers of antennas
215
216required:
217  - compatible
218  - reg
219
220unevaluatedProperties: false
221
222examples:
223  - |
224    pcie0 {
225      #address-cells = <3>;
226      #size-cells = <2>;
227      wifi@0,0 {
228        compatible = "mediatek,mt76";
229        reg = <0x0000 0 0 0 0>;
230        ieee80211-freq-limit = <5000000 6000000>;
231        mediatek,mtd-eeprom = <&factory 0x8000>;
232        big-endian;
233
234        led {
235          led-sources = <2>;
236        };
237
238        power-limits {
239          r0 {
240            regdomain = "FCC";
241            txpower-5g {
242               b0 {
243                   channels = <36 48>;
244                   rates-ofdm = /bits/ 8 <23 23 23 23 23 23 23 23>;
245                   rates-mcs = /bits/ 8 <1 23 23 23 23 23 23 23 23 23 23>,
246                               /bits/ 8 <3 22 22 22 22 22 22 22 22 22 22>;
247                   rates-ru = /bits/ 8 <3 22 22 22 22 22 22 22 22 22 22 22 22>,
248                              /bits/ 8 <4 20 20 20 20 20 20 20 20 20 20 20 20>;
249               };
250               b1 {
251                   channels = <100 181>;
252                   rates-ofdm = /bits/ 8 <14 14 14 14 14 14 14 14>;
253                   rates-mcs = /bits/ 8  <4 14 14 14 14 14 14 14 14 14 14>;
254                   txs-delta = <12 9 6>;
255                   rates-ru = /bits/ 8  <7 14 14 14 14 14 14 14 14 14 14 14 14>;
256               };
257             };
258          };
259        };
260      };
261    };
262
263  - |
264    wifi@10300000 {
265      compatible = "mediatek,mt7628-wmac";
266      reg = <0x10300000 0x100000>;
267
268      interrupt-parent = <&cpuintc>;
269      interrupts = <6>;
270
271      nvmem-cells = <&eeprom>;
272      nvmem-cell-names = "eeprom";
273    };
274
275  - |
276    #include <dt-bindings/interrupt-controller/arm-gic.h>
277    #include <dt-bindings/interrupt-controller/irq.h>
278    wifi@18000000 {
279      compatible = "mediatek,mt7622-wmac";
280      reg = <0x10300000 0x100000>;
281      interrupts = <GIC_SPI 211 IRQ_TYPE_LEVEL_LOW>;
282
283      mediatek,infracfg = <&infracfg>;
284
285      power-domains = <&scpsys 3>;
286    };
287
288  - |
289    wifi@18000000 {
290        compatible = "mediatek,mt7986-wmac";
291        resets = <&watchdog 23>;
292        reset-names = "consys";
293        reg = <0x18000000 0x1000000>,
294              <0x10003000 0x1000>,
295              <0x11d10000 0x1000>;
296        interrupts = <GIC_SPI 213 IRQ_TYPE_LEVEL_HIGH>;
297        clocks = <&topckgen 50>,
298                 <&topckgen 62>;
299        clock-names = "mcu", "ap2conn";
300        memory-region = <&wmcpu_emi>;
301    };
302