1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2%YAML 1.2 3--- 4$id: http://devicetree.org/schemas/net/ti,k3-am654-cpsw-nuss.yaml# 5$schema: http://devicetree.org/meta-schemas/core.yaml# 6 7title: The TI AM654x/J721E/AM642x SoC Gigabit Ethernet MAC (Media Access Controller) 8 9maintainers: 10 - Grygorii Strashko <grygorii.strashko@ti.com> 11 - Sekhar Nori <nsekhar@ti.com> 12 13description: 14 The TI AM654x/J721E SoC Gigabit Ethernet MAC (CPSW2G NUSS) has two ports 15 (one external) and provides Ethernet packet communication for the device. 16 The TI AM642x SoC Gigabit Ethernet MAC (CPSW3G NUSS) has three ports 17 (two external) and provides Ethernet packet communication and switching. 18 19 The internal Communications Port Programming Interface (CPPI5) (Host port 0). 20 Host Port 0 CPPI Packet Streaming Interface interface supports 8 TX channels 21 and one RX channels and operating by NAVSS Unified DMA Peripheral Root 22 Complex (UDMA-P) controller. 23 24 CPSWxG features 25 updated Address Lookup Engine (ALE). 26 priority level Quality Of Service (QOS) support (802.1p) 27 Support for Audio/Video Bridging (P802.1Qav/D6.0) 28 Support for IEEE 1588 Clock Synchronization (2008 Annex D, Annex E and Annex F) 29 Flow Control (802.3x) Support 30 Time Sensitive Network Support 31 IEEE P902.3br/D2.0 Interspersing Express Traffic 32 IEEE 802.1Qbv/D2.2 Enhancements for Scheduled Traffic 33 Configurable number of addresses plus VLANs 34 Configurable number of classifier/policers 35 VLAN support, 802.1Q compliant, Auto add port VLAN for untagged frames on 36 ingress, Auto VLAN removal on egress and auto pad to minimum frame size. 37 RX/TX csum offload 38 Management Data Input/Output (MDIO) interface for PHYs management 39 RMII/RGMII Interfaces support 40 new version of Common Platform Time Sync (CPTS) 41 42 The CPSWxG NUSS is integrated into 43 device MCU domain named MCU_CPSW0 on AM654x/J721E SoC. 44 device MAIN domain named CPSW0 on AM642x SoC. 45 46 Specifications can be found at 47 https://www.ti.com/lit/pdf/spruid7 48 https://www.ti.com/lit/zip/spruil1 49 https://www.ti.com/lit/pdf/spruim2 50 51properties: 52 "#address-cells": true 53 "#size-cells": true 54 55 compatible: 56 enum: 57 - ti,am642-cpsw-nuss 58 - ti,am654-cpsw-nuss 59 - ti,j7200-cpswxg-nuss 60 - ti,j721e-cpsw-nuss 61 - ti,j721e-cpswxg-nuss 62 - ti,j784s4-cpswxg-nuss 63 64 reg: 65 maxItems: 1 66 description: 67 The physical base address and size of full the CPSWxG NUSS IO range 68 69 reg-names: 70 items: 71 - const: cpsw_nuss 72 73 ranges: true 74 75 dma-coherent: true 76 77 clocks: 78 maxItems: 1 79 description: CPSWxG NUSS functional clock 80 81 clock-names: 82 items: 83 - const: fck 84 85 assigned-clock-parents: true 86 87 assigned-clocks: true 88 89 power-domains: 90 maxItems: 1 91 92 dmas: 93 maxItems: 9 94 95 dma-names: 96 items: 97 - const: tx0 98 - const: tx1 99 - const: tx2 100 - const: tx3 101 - const: tx4 102 - const: tx5 103 - const: tx6 104 - const: tx7 105 - const: rx 106 107 ethernet-ports: 108 type: object 109 properties: 110 '#address-cells': 111 const: 1 112 '#size-cells': 113 const: 0 114 115 patternProperties: 116 "^port@[1-8]$": 117 type: object 118 description: CPSWxG NUSS external ports 119 120 $ref: ethernet-controller.yaml# 121 unevaluatedProperties: false 122 123 properties: 124 reg: 125 minimum: 1 126 maximum: 8 127 description: CPSW port number 128 129 phys: 130 minItems: 1 131 items: 132 - description: CPSW MAC's PHY. 133 - description: Serdes PHY. Serdes PHY is required only if 134 the Serdes has to be configured in the 135 Single-Link configuration. 136 137 phy-names: 138 minItems: 1 139 items: 140 - const: mac 141 - const: serdes 142 143 label: 144 description: label associated with this port 145 146 ti,mac-only: 147 $ref: /schemas/types.yaml#/definitions/flag 148 description: 149 Specifies the port works in mac-only mode. 150 151 ti,syscon-efuse: 152 $ref: /schemas/types.yaml#/definitions/phandle-array 153 items: 154 - items: 155 - description: Phandle to the system control device node which 156 provides access to efuse 157 - description: offset to efuse registers??? 158 description: 159 Phandle to the system control device node which provides access 160 to efuse IO range with MAC addresses 161 162 required: 163 - reg 164 - phys 165 166 additionalProperties: false 167 168patternProperties: 169 "^mdio@[0-9a-f]+$": 170 type: object 171 $ref: "ti,davinci-mdio.yaml#" 172 173 description: 174 CPSW MDIO bus. 175 176 "^cpts@[0-9a-f]+": 177 type: object 178 $ref: "ti,k3-am654-cpts.yaml#" 179 description: 180 CPSW Common Platform Time Sync (CPTS) module. 181 182required: 183 - compatible 184 - reg 185 - reg-names 186 - ranges 187 - clocks 188 - clock-names 189 - power-domains 190 - dmas 191 - dma-names 192 - '#address-cells' 193 - '#size-cells' 194 195allOf: 196 - if: 197 not: 198 properties: 199 compatible: 200 contains: 201 enum: 202 - ti,j721e-cpswxg-nuss 203 - ti,j784s4-cpswxg-nuss 204 then: 205 properties: 206 ethernet-ports: 207 patternProperties: 208 "^port@[5-8]$": false 209 "^port@[1-4]$": 210 properties: 211 reg: 212 minimum: 1 213 maximum: 4 214 215 - if: 216 not: 217 properties: 218 compatible: 219 contains: 220 enum: 221 - ti,j7200-cpswxg-nuss 222 - ti,j721e-cpswxg-nuss 223 - ti,j784s4-cpswxg-nuss 224 then: 225 properties: 226 ethernet-ports: 227 patternProperties: 228 "^port@[3-8]$": false 229 "^port@[1-2]$": 230 properties: 231 reg: 232 minimum: 1 233 maximum: 2 234 235additionalProperties: false 236 237examples: 238 - | 239 #include <dt-bindings/pinctrl/k3.h> 240 #include <dt-bindings/soc/ti,sci_pm_domain.h> 241 #include <dt-bindings/net/ti-dp83867.h> 242 #include <dt-bindings/interrupt-controller/irq.h> 243 #include <dt-bindings/interrupt-controller/arm-gic.h> 244 245 bus { 246 #address-cells = <2>; 247 #size-cells = <2>; 248 249 mcu_cpsw: ethernet@46000000 { 250 compatible = "ti,am654-cpsw-nuss"; 251 #address-cells = <2>; 252 #size-cells = <2>; 253 reg = <0x0 0x46000000 0x0 0x200000>; 254 reg-names = "cpsw_nuss"; 255 ranges = <0x0 0x0 0x0 0x46000000 0x0 0x200000>; 256 dma-coherent; 257 clocks = <&k3_clks 5 10>; 258 clock-names = "fck"; 259 power-domains = <&k3_pds 5 TI_SCI_PD_EXCLUSIVE>; 260 pinctrl-names = "default"; 261 pinctrl-0 = <&mcu_cpsw_pins_default &mcu_mdio_pins_default>; 262 263 dmas = <&mcu_udmap 0xf000>, 264 <&mcu_udmap 0xf001>, 265 <&mcu_udmap 0xf002>, 266 <&mcu_udmap 0xf003>, 267 <&mcu_udmap 0xf004>, 268 <&mcu_udmap 0xf005>, 269 <&mcu_udmap 0xf006>, 270 <&mcu_udmap 0xf007>, 271 <&mcu_udmap 0x7000>; 272 dma-names = "tx0", "tx1", "tx2", "tx3", "tx4", "tx5", "tx6", "tx7", 273 "rx"; 274 275 ethernet-ports { 276 #address-cells = <1>; 277 #size-cells = <0>; 278 279 cpsw_port1: port@1 { 280 reg = <1>; 281 ti,mac-only; 282 label = "port1"; 283 ti,syscon-efuse = <&mcu_conf 0x200>; 284 phys = <&phy_gmii_sel 1>; 285 286 phy-mode = "rgmii-rxid"; 287 phy-handle = <&phy0>; 288 }; 289 }; 290 291 davinci_mdio: mdio@f00 { 292 compatible = "ti,cpsw-mdio","ti,davinci_mdio"; 293 reg = <0x0 0xf00 0x0 0x100>; 294 #address-cells = <1>; 295 #size-cells = <0>; 296 clocks = <&k3_clks 5 10>; 297 clock-names = "fck"; 298 bus_freq = <1000000>; 299 300 phy0: ethernet-phy@0 { 301 reg = <0>; 302 ti,rx-internal-delay = <DP83867_RGMIIDCTL_2_00_NS>; 303 ti,fifo-depth = <DP83867_PHYCR_FIFO_DEPTH_4_B_NIB>; 304 }; 305 }; 306 }; 307 308 cpts@3d000 { 309 compatible = "ti,am65-cpts"; 310 reg = <0x0 0x3d000 0x0 0x400>; 311 clocks = <&k3_clks 18 2>; 312 clock-names = "cpts"; 313 interrupts-extended = <&gic500 GIC_SPI 858 IRQ_TYPE_LEVEL_HIGH>; 314 interrupt-names = "cpts"; 315 ti,cpts-ext-ts-inputs = <4>; 316 ti,cpts-periodic-outputs = <2>; 317 }; 318 }; 319