1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/net/wireless/brcm,bcm4329-fmac.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Broadcom BCM4329 family fullmac wireless SDIO/PCIE devices
8
9 maintainers:
10 - Arend van Spriel <arend@broadcom.com>
11
12 description:
13 The Broadcom Single chip MAC part for the BCM4329 family and
14 later Cypress chips in the same family named CYW4373 and similar.
15 These chips also have a Bluetooth portion described in a separate
16 binding.
17
18 allOf:
19 - $ref: ieee80211.yaml#
20
21 properties:
22 compatible:
23 oneOf:
24 - items:
25 - enum:
26 - brcm,bcm43143-fmac
27 - brcm,bcm4341b0-fmac
28 - brcm,bcm4341b4-fmac
29 - brcm,bcm4341b5-fmac
30 - brcm,bcm4329-fmac
31 - brcm,bcm4330-fmac
32 - brcm,bcm4334-fmac
33 - brcm,bcm43340-fmac
34 - brcm,bcm4335-fmac
35 - brcm,bcm43362-fmac
36 - brcm,bcm4339-fmac
37 - brcm,bcm43430a0-fmac
38 - brcm,bcm43430a1-fmac
39 - brcm,bcm43455-fmac
40 - brcm,bcm43456-fmac
41 - brcm,bcm4354-fmac
42 - brcm,bcm4356-fmac
43 - brcm,bcm4359-fmac
44 - brcm,bcm4366-fmac
45 - cypress,cyw4373-fmac
46 - cypress,cyw43012-fmac
47 - infineon,cyw43439-fmac
48 - const: brcm,bcm4329-fmac
49 - enum:
50 - brcm,bcm4329-fmac
51 - pci14e4,43dc # BCM4355
52 - pci14e4,4464 # BCM4364
53 - pci14e4,4488 # BCM4377
54 - pci14e4,4425 # BCM4378
55 - pci14e4,4433 # BCM4387
56
57 reg:
58 description: SDIO function number for the device (for most cases
59 this will be 1) or PCI device identifier.
60
61 interrupts:
62 maxItems: 1
63 description: Out-of-band (OOB) IRQ line for waking up the host
64 in response to WLAN activity. This corresponds to the HOST_WAKE
65 line into the chip.
66
67 interrupt-names:
68 description: Name for the OOB IRQ, this must be set to "host-wake".
69 const: host-wake
70
71 brcm,drive-strength:
72 $ref: /schemas/types.yaml#/definitions/uint32
73 description: Drive strength used for the SDIO pins on the device in mA.
74 minimum: 0
75 maximum: 32
76
77 reset-gpios:
78 maxItems: 1
79 description: A GPIO line connected to the WL_RST line, if present
80 this shall be flagged as active low.
81
82 brcm,ccode-map:
83 $ref: /schemas/types.yaml#/definitions/string-array
84 description: Multiple strings for translating ISO3166 country code to
85 brcmfmac firmware country code and revision.
86 items:
87 pattern: '^[A-Z][A-Z]-[A-Z][0-9A-Z]-[0-9]+$'
88
89 brcm,ccode-map-trivial:
90 description: |
91 Use a trivial mapping of ISO3166 country codes to brcmfmac firmware
92 country code and revision: cc -> { cc, 0 }. In other words, assume that
93 the CLM blob firmware uses ISO3166 country codes as well, and that all
94 revisions are zero. This property is mutually exclusive with
95 brcm,ccode-map. If both properties are specified, then brcm,ccode-map
96 takes precedence.
97 type: boolean
98
99 brcm,cal-blob:
100 $ref: /schemas/types.yaml#/definitions/uint8-array
101 description: A per-device calibration blob for the Wi-Fi radio. This
102 should be filled in by the bootloader from platform configuration
103 data, if necessary, and will be uploaded to the device if present.
104
105 brcm,board-type:
106 $ref: /schemas/types.yaml#/definitions/string
107 description: Overrides the board type, which is normally the compatible of
108 the root node. This can be used to decouple the overall system board or
109 device name from the board type for WiFi purposes, which is used to
110 construct firmware and NVRAM configuration filenames, allowing for
111 multiple devices that share the same module or characteristics for the
112 WiFi subsystem to share the same firmware/NVRAM files. On Apple platforms,
113 this should be the Apple module-instance codename prefixed by "apple,",
114 e.g. "apple,honshu".
115
116 apple,antenna-sku:
117 $ref: /schemas/types.yaml#/definitions/string
118 description: Antenna SKU used to identify a specific antenna configuration
119 on Apple platforms. This is use to build firmware filenames, to allow
120 platforms with different antenna configs to have different firmware and/or
121 NVRAM. This would normally be filled in by the bootloader from platform
122 configuration data.
123
124 required:
125 - compatible
126 - reg
127
128 unevaluatedProperties: false
129
130 examples:
131 - |
132 #include <dt-bindings/interrupt-controller/irq.h>
133 #include <dt-bindings/gpio/gpio.h>
134 mmc@80118000 {
135 compatible = "arm,pl18x", "arm,primecell";
136 reg = <0x80118000 0x1000>;
137 clocks = <&clk 0>, <&clk 1>;
138 clock-names = "mclk", "apb_pclk";
139 interrupts = <0 60 IRQ_TYPE_LEVEL_HIGH>;
140 bus-width = <4>;
141 non-removable;
142 vmmc-supply = <&wl_bt_reg>;
143 #address-cells = <1>;
144 #size-cells = <0>;
145
146 wifi@1 {
147 compatible = "brcm,bcm4334-fmac", "brcm,bcm4329-fmac";
148 reg = <1>;
149 interrupt-parent = <&gpio>;
150 interrupts = <24 IRQ_TYPE_EDGE_FALLING>;
151 interrupt-names = "host-wake";
152 reset-gpios = <&gpio 23 GPIO_ACTIVE_LOW>;
153 brcm,ccode-map = "JP-JP-78", "US-Q2-86";
154 };
155 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.