1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2%YAML 1.2 3--- 4$id: http://devicetree.org/schemas/net/dsa/qca8k.yaml# 5$schema: http://devicetree.org/meta-schemas/core.yaml# 6 7title: Qualcomm Atheros QCA83xx switch family 8 9maintainers: 10 - John Crispin <john@phrozen.org> 11 12description: 13 If the QCA8K switch is connect to an SoC's external mdio-bus, each subnode 14 describing a port needs to have a valid phandle referencing the internal PHY 15 it is connected to. This is because there is no N:N mapping of port and PHY 16 ID. To declare the internal mdio-bus configuration, declare an MDIO node in 17 the switch node and declare the phandle for the port, referencing the internal 18 PHY it is connected to. In this config, an internal mdio-bus is registered and 19 the MDIO master is used for communication. Mixed external and internal 20 mdio-bus configurations are not supported by the hardware. 21 Each phy has at most 3 LEDs connected and can be declared 22 using the standard LEDs structure. 23 24properties: 25 compatible: 26 oneOf: 27 - enum: 28 - qca,qca8327 29 - qca,qca8328 30 - qca,qca8334 31 - qca,qca8337 32 description: | 33 qca,qca8328: referenced as AR8328(N)-AK1(A/B) QFN 176 pin package 34 qca,qca8327: referenced as AR8327(N)-AL1A DR-QFN 148 pin package 35 qca,qca8334: referenced as QCA8334-AL3C QFN 88 pin package 36 qca,qca8337: referenced as QCA8337N-AL3(B/C) DR-QFN 148 pin package 37 38 reg: 39 maxItems: 1 40 41 reset-gpios: 42 description: 43 GPIO to be used to reset the whole device 44 maxItems: 1 45 46 qca,ignore-power-on-sel: 47 $ref: /schemas/types.yaml#/definitions/flag 48 description: 49 Ignore power-on pin strapping to configure LED open-drain or EEPROM 50 presence. This is needed for devices with incorrect configuration or when 51 the OEM has decided not to use pin strapping and falls back to SW regs. 52 53 qca,led-open-drain: 54 $ref: /schemas/types.yaml#/definitions/flag 55 description: 56 Set LEDs to open-drain mode. This requires the qca,ignore-power-on-sel to 57 be set, otherwise the driver will fail at probe. This is required if the 58 OEM does not use pin strapping to set this mode and prefers to set it 59 using SW regs. The pin strappings related to LED open-drain mode are 60 B68 on the QCA832x and B49 on the QCA833x. 61 62 mdio: 63 $ref: /schemas/net/mdio.yaml# 64 unevaluatedProperties: false 65 description: Qca8k switch have an internal mdio to access switch port. 66 If this is not present, the legacy mapping is used and the 67 internal mdio access is used. 68 With the legacy mapping the reg corresponding to the internal 69 mdio is the switch reg with an offset of -1. 70 71$ref: dsa.yaml# 72 73patternProperties: 74 "^(ethernet-)?ports$": 75 type: object 76 additionalProperties: true 77 patternProperties: 78 "^(ethernet-)?port@[0-6]$": 79 type: object 80 description: Ethernet switch ports 81 82 $ref: dsa-port.yaml# 83 84 properties: 85 qca,sgmii-rxclk-falling-edge: 86 $ref: /schemas/types.yaml#/definitions/flag 87 description: 88 Set the receive clock phase to falling edge. Mostly commonly used on 89 the QCA8327 with CPU port 0 set to SGMII. 90 91 qca,sgmii-txclk-falling-edge: 92 $ref: /schemas/types.yaml#/definitions/flag 93 description: 94 Set the transmit clock phase to falling edge. 95 96 qca,sgmii-enable-pll: 97 $ref: /schemas/types.yaml#/definitions/flag 98 description: 99 For SGMII CPU port, explicitly enable PLL, TX and RX chain along with 100 Signal Detection. On the QCA8327 this should not be enabled, otherwise 101 the SGMII port will not initialize. When used on the QCA8337, revision 3 102 or greater, a warning will be displayed. When the CPU port is set to 103 SGMII on the QCA8337, it is advised to set this unless a communication 104 issue is observed. 105 106 unevaluatedProperties: false 107 108oneOf: 109 - required: 110 - ports 111 - required: 112 - ethernet-ports 113 114required: 115 - compatible 116 - reg 117 118unevaluatedProperties: false 119 120examples: 121 - | 122 #include <dt-bindings/gpio/gpio.h> 123 #include <dt-bindings/leds/common.h> 124 125 mdio { 126 #address-cells = <1>; 127 #size-cells = <0>; 128 129 external_phy_port1: ethernet-phy@0 { 130 reg = <0>; 131 }; 132 133 external_phy_port2: ethernet-phy@1 { 134 reg = <1>; 135 }; 136 137 external_phy_port3: ethernet-phy@2 { 138 reg = <2>; 139 }; 140 141 external_phy_port4: ethernet-phy@3 { 142 reg = <3>; 143 }; 144 145 external_phy_port5: ethernet-phy@4 { 146 reg = <4>; 147 }; 148 149 switch@10 { 150 compatible = "qca,qca8337"; 151 reset-gpios = <&gpio 42 GPIO_ACTIVE_LOW>; 152 reg = <0x10>; 153 154 ports { 155 #address-cells = <1>; 156 #size-cells = <0>; 157 158 port@0 { 159 reg = <0>; 160 ethernet = <&gmac1>; 161 phy-mode = "rgmii"; 162 163 fixed-link { 164 speed = <1000>; 165 full-duplex; 166 }; 167 }; 168 169 port@1 { 170 reg = <1>; 171 label = "lan1"; 172 phy-handle = <&external_phy_port1>; 173 }; 174 175 port@2 { 176 reg = <2>; 177 label = "lan2"; 178 phy-handle = <&external_phy_port2>; 179 }; 180 181 port@3 { 182 reg = <3>; 183 label = "lan3"; 184 phy-handle = <&external_phy_port3>; 185 }; 186 187 port@4 { 188 reg = <4>; 189 label = "lan4"; 190 phy-handle = <&external_phy_port4>; 191 }; 192 193 port@5 { 194 reg = <5>; 195 label = "wan"; 196 phy-handle = <&external_phy_port5>; 197 }; 198 }; 199 }; 200 }; 201 - | 202 #include <dt-bindings/gpio/gpio.h> 203 204 mdio { 205 #address-cells = <1>; 206 #size-cells = <0>; 207 208 switch@10 { 209 compatible = "qca,qca8337"; 210 reset-gpios = <&gpio 42 GPIO_ACTIVE_LOW>; 211 reg = <0x10>; 212 213 ports { 214 #address-cells = <1>; 215 #size-cells = <0>; 216 217 port@0 { 218 reg = <0>; 219 ethernet = <&gmac1>; 220 phy-mode = "rgmii"; 221 222 fixed-link { 223 speed = <1000>; 224 full-duplex; 225 }; 226 }; 227 228 port@1 { 229 reg = <1>; 230 label = "lan1"; 231 phy-mode = "internal"; 232 phy-handle = <&internal_phy_port1>; 233 234 leds { 235 #address-cells = <1>; 236 #size-cells = <0>; 237 238 led@0 { 239 reg = <0>; 240 color = <LED_COLOR_ID_WHITE>; 241 function = LED_FUNCTION_LAN; 242 default-state = "keep"; 243 }; 244 245 led@1 { 246 reg = <1>; 247 color = <LED_COLOR_ID_AMBER>; 248 function = LED_FUNCTION_LAN; 249 default-state = "keep"; 250 }; 251 }; 252 }; 253 254 port@2 { 255 reg = <2>; 256 label = "lan2"; 257 phy-mode = "internal"; 258 phy-handle = <&internal_phy_port2>; 259 }; 260 261 port@3 { 262 reg = <3>; 263 label = "lan3"; 264 phy-mode = "internal"; 265 phy-handle = <&internal_phy_port3>; 266 }; 267 268 port@4 { 269 reg = <4>; 270 label = "lan4"; 271 phy-mode = "internal"; 272 phy-handle = <&internal_phy_port4>; 273 }; 274 275 port@5 { 276 reg = <5>; 277 label = "wan"; 278 phy-mode = "internal"; 279 phy-handle = <&internal_phy_port5>; 280 }; 281 282 port@6 { 283 reg = <0>; 284 ethernet = <&gmac1>; 285 phy-mode = "sgmii"; 286 287 qca,sgmii-rxclk-falling-edge; 288 289 fixed-link { 290 speed = <1000>; 291 full-duplex; 292 }; 293 }; 294 }; 295 296 mdio { 297 #address-cells = <1>; 298 #size-cells = <0>; 299 300 internal_phy_port1: ethernet-phy@0 { 301 reg = <0>; 302 }; 303 304 internal_phy_port2: ethernet-phy@1 { 305 reg = <1>; 306 }; 307 308 internal_phy_port3: ethernet-phy@2 { 309 reg = <2>; 310 }; 311 312 internal_phy_port4: ethernet-phy@3 { 313 reg = <3>; 314 }; 315 316 internal_phy_port5: ethernet-phy@4 { 317 reg = <4>; 318 }; 319 }; 320 }; 321 }; 322