18c2ecf20Sopenharmony_ci# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
28c2ecf20Sopenharmony_ci%YAML 1.2
38c2ecf20Sopenharmony_ci---
48c2ecf20Sopenharmony_ci$id: http://devicetree.org/schemas/net/ti,k3-am654-cpsw-nuss.yaml#
58c2ecf20Sopenharmony_ci$schema: http://devicetree.org/meta-schemas/core.yaml#
68c2ecf20Sopenharmony_ci
78c2ecf20Sopenharmony_cititle: The TI AM654x/J721E SoC Gigabit Ethernet MAC (Media Access Controller) Device Tree Bindings
88c2ecf20Sopenharmony_ci
98c2ecf20Sopenharmony_cimaintainers:
108c2ecf20Sopenharmony_ci  - Grygorii Strashko <grygorii.strashko@ti.com>
118c2ecf20Sopenharmony_ci  - Sekhar Nori <nsekhar@ti.com>
128c2ecf20Sopenharmony_ci
138c2ecf20Sopenharmony_cidescription:
148c2ecf20Sopenharmony_ci  The TI AM654x/J721E SoC Gigabit Ethernet MAC (CPSW2G NUSS) has two ports
158c2ecf20Sopenharmony_ci  (one external) and provides Ethernet packet communication for the device.
168c2ecf20Sopenharmony_ci  CPSW2G NUSS features - the Reduced Gigabit Media Independent Interface (RGMII),
178c2ecf20Sopenharmony_ci  Reduced Media Independent Interface (RMII), the Management Data
188c2ecf20Sopenharmony_ci  Input/Output (MDIO) interface for physical layer device (PHY) management,
198c2ecf20Sopenharmony_ci  new version of Common Platform Time Sync (CPTS), updated Address Lookup
208c2ecf20Sopenharmony_ci  Engine (ALE).
218c2ecf20Sopenharmony_ci  One external Ethernet port (port 1) with selectable RGMII/RMII interfaces and
228c2ecf20Sopenharmony_ci  an internal Communications Port Programming Interface (CPPI5) (Host port 0).
238c2ecf20Sopenharmony_ci  Host Port 0 CPPI Packet Streaming Interface interface supports 8 TX channels
248c2ecf20Sopenharmony_ci  and one RX channels and operating by TI AM654x/J721E NAVSS Unified DMA
258c2ecf20Sopenharmony_ci  Peripheral Root Complex (UDMA-P) controller.
268c2ecf20Sopenharmony_ci  The CPSW2G NUSS is integrated into device MCU domain named MCU_CPSW0.
278c2ecf20Sopenharmony_ci
288c2ecf20Sopenharmony_ci  Additional features
298c2ecf20Sopenharmony_ci  priority level Quality Of Service (QOS) support (802.1p)
308c2ecf20Sopenharmony_ci  Support for Audio/Video Bridging (P802.1Qav/D6.0)
318c2ecf20Sopenharmony_ci  Support for IEEE 1588 Clock Synchronization (2008 Annex D, Annex E and Annex F)
328c2ecf20Sopenharmony_ci  Flow Control (802.3x) Support
338c2ecf20Sopenharmony_ci  Time Sensitive Network Support
348c2ecf20Sopenharmony_ci  IEEE P902.3br/D2.0 Interspersing Express Traffic
358c2ecf20Sopenharmony_ci  IEEE 802.1Qbv/D2.2 Enhancements for Scheduled Traffic
368c2ecf20Sopenharmony_ci  Configurable number of addresses plus VLANs
378c2ecf20Sopenharmony_ci  Configurable number of classifier/policers
388c2ecf20Sopenharmony_ci  VLAN support, 802.1Q compliant, Auto add port VLAN for untagged frames on
398c2ecf20Sopenharmony_ci  ingress, Auto VLAN removal on egress and auto pad to minimum frame size.
408c2ecf20Sopenharmony_ci  RX/TX csum offload
418c2ecf20Sopenharmony_ci
428c2ecf20Sopenharmony_ci  Specifications can be found at
438c2ecf20Sopenharmony_ci    http://www.ti.com/lit/ug/spruid7e/spruid7e.pdf
448c2ecf20Sopenharmony_ci    http://www.ti.com/lit/ug/spruil1a/spruil1a.pdf
458c2ecf20Sopenharmony_ci
468c2ecf20Sopenharmony_ciproperties:
478c2ecf20Sopenharmony_ci  "#address-cells": true
488c2ecf20Sopenharmony_ci  "#size-cells": true
498c2ecf20Sopenharmony_ci
508c2ecf20Sopenharmony_ci  compatible:
518c2ecf20Sopenharmony_ci    oneOf:
528c2ecf20Sopenharmony_ci      - const: ti,am654-cpsw-nuss
538c2ecf20Sopenharmony_ci      - const: ti,j721e-cpsw-nuss
548c2ecf20Sopenharmony_ci
558c2ecf20Sopenharmony_ci  reg:
568c2ecf20Sopenharmony_ci    maxItems: 1
578c2ecf20Sopenharmony_ci    description:
588c2ecf20Sopenharmony_ci      The physical base address and size of full the CPSW2G NUSS IO range
598c2ecf20Sopenharmony_ci
608c2ecf20Sopenharmony_ci  reg-names:
618c2ecf20Sopenharmony_ci    items:
628c2ecf20Sopenharmony_ci      - const: cpsw_nuss
638c2ecf20Sopenharmony_ci
648c2ecf20Sopenharmony_ci  ranges: true
658c2ecf20Sopenharmony_ci
668c2ecf20Sopenharmony_ci  dma-coherent: true
678c2ecf20Sopenharmony_ci
688c2ecf20Sopenharmony_ci  clocks:
698c2ecf20Sopenharmony_ci    description: CPSW2G NUSS functional clock
708c2ecf20Sopenharmony_ci
718c2ecf20Sopenharmony_ci  clock-names:
728c2ecf20Sopenharmony_ci    items:
738c2ecf20Sopenharmony_ci      - const: fck
748c2ecf20Sopenharmony_ci
758c2ecf20Sopenharmony_ci  power-domains:
768c2ecf20Sopenharmony_ci    maxItems: 1
778c2ecf20Sopenharmony_ci
788c2ecf20Sopenharmony_ci  dmas:
798c2ecf20Sopenharmony_ci    maxItems: 9
808c2ecf20Sopenharmony_ci
818c2ecf20Sopenharmony_ci  dma-names:
828c2ecf20Sopenharmony_ci    items:
838c2ecf20Sopenharmony_ci      - const: tx0
848c2ecf20Sopenharmony_ci      - const: tx1
858c2ecf20Sopenharmony_ci      - const: tx2
868c2ecf20Sopenharmony_ci      - const: tx3
878c2ecf20Sopenharmony_ci      - const: tx4
888c2ecf20Sopenharmony_ci      - const: tx5
898c2ecf20Sopenharmony_ci      - const: tx6
908c2ecf20Sopenharmony_ci      - const: tx7
918c2ecf20Sopenharmony_ci      - const: rx
928c2ecf20Sopenharmony_ci
938c2ecf20Sopenharmony_ci  ethernet-ports:
948c2ecf20Sopenharmony_ci    type: object
958c2ecf20Sopenharmony_ci    properties:
968c2ecf20Sopenharmony_ci      '#address-cells':
978c2ecf20Sopenharmony_ci        const: 1
988c2ecf20Sopenharmony_ci      '#size-cells':
998c2ecf20Sopenharmony_ci        const: 0
1008c2ecf20Sopenharmony_ci
1018c2ecf20Sopenharmony_ci    patternProperties:
1028c2ecf20Sopenharmony_ci      port@1:
1038c2ecf20Sopenharmony_ci        type: object
1048c2ecf20Sopenharmony_ci        description: CPSW2G NUSS external ports
1058c2ecf20Sopenharmony_ci
1068c2ecf20Sopenharmony_ci        $ref: ethernet-controller.yaml#
1078c2ecf20Sopenharmony_ci
1088c2ecf20Sopenharmony_ci        properties:
1098c2ecf20Sopenharmony_ci          reg:
1108c2ecf20Sopenharmony_ci            items:
1118c2ecf20Sopenharmony_ci              - const: 1
1128c2ecf20Sopenharmony_ci            description: CPSW port number
1138c2ecf20Sopenharmony_ci
1148c2ecf20Sopenharmony_ci          phys:
1158c2ecf20Sopenharmony_ci            maxItems: 1
1168c2ecf20Sopenharmony_ci            description: phandle on phy-gmii-sel PHY
1178c2ecf20Sopenharmony_ci
1188c2ecf20Sopenharmony_ci          label:
1198c2ecf20Sopenharmony_ci            description: label associated with this port
1208c2ecf20Sopenharmony_ci
1218c2ecf20Sopenharmony_ci          ti,mac-only:
1228c2ecf20Sopenharmony_ci            $ref: /schemas/types.yaml#definitions/flag
1238c2ecf20Sopenharmony_ci            description:
1248c2ecf20Sopenharmony_ci              Specifies the port works in mac-only mode.
1258c2ecf20Sopenharmony_ci
1268c2ecf20Sopenharmony_ci          ti,syscon-efuse:
1278c2ecf20Sopenharmony_ci            $ref: /schemas/types.yaml#definitions/phandle-array
1288c2ecf20Sopenharmony_ci            description:
1298c2ecf20Sopenharmony_ci              Phandle to the system control device node which provides access
1308c2ecf20Sopenharmony_ci              to efuse IO range with MAC addresses
1318c2ecf20Sopenharmony_ci
1328c2ecf20Sopenharmony_ci        required:
1338c2ecf20Sopenharmony_ci          - reg
1348c2ecf20Sopenharmony_ci          - phys
1358c2ecf20Sopenharmony_ci
1368c2ecf20Sopenharmony_ci    additionalProperties: false
1378c2ecf20Sopenharmony_ci
1388c2ecf20Sopenharmony_cipatternProperties:
1398c2ecf20Sopenharmony_ci  "^mdio@[0-9a-f]+$":
1408c2ecf20Sopenharmony_ci    type: object
1418c2ecf20Sopenharmony_ci    $ref: "ti,davinci-mdio.yaml#"
1428c2ecf20Sopenharmony_ci
1438c2ecf20Sopenharmony_ci    description:
1448c2ecf20Sopenharmony_ci      CPSW MDIO bus.
1458c2ecf20Sopenharmony_ci
1468c2ecf20Sopenharmony_ci  "^cpts@[0-9a-f]+":
1478c2ecf20Sopenharmony_ci    type: object
1488c2ecf20Sopenharmony_ci    $ref: "ti,k3-am654-cpts.yaml#"
1498c2ecf20Sopenharmony_ci    description:
1508c2ecf20Sopenharmony_ci      CPSW Common Platform Time Sync (CPTS) module.
1518c2ecf20Sopenharmony_ci
1528c2ecf20Sopenharmony_cirequired:
1538c2ecf20Sopenharmony_ci  - compatible
1548c2ecf20Sopenharmony_ci  - reg
1558c2ecf20Sopenharmony_ci  - reg-names
1568c2ecf20Sopenharmony_ci  - ranges
1578c2ecf20Sopenharmony_ci  - clocks
1588c2ecf20Sopenharmony_ci  - clock-names
1598c2ecf20Sopenharmony_ci  - power-domains
1608c2ecf20Sopenharmony_ci  - dmas
1618c2ecf20Sopenharmony_ci  - dma-names
1628c2ecf20Sopenharmony_ci  - '#address-cells'
1638c2ecf20Sopenharmony_ci  - '#size-cells'
1648c2ecf20Sopenharmony_ci
1658c2ecf20Sopenharmony_ciadditionalProperties: false
1668c2ecf20Sopenharmony_ci
1678c2ecf20Sopenharmony_ciexamples:
1688c2ecf20Sopenharmony_ci  - |
1698c2ecf20Sopenharmony_ci    #include <dt-bindings/pinctrl/k3.h>
1708c2ecf20Sopenharmony_ci    #include <dt-bindings/soc/ti,sci_pm_domain.h>
1718c2ecf20Sopenharmony_ci    #include <dt-bindings/net/ti-dp83867.h>
1728c2ecf20Sopenharmony_ci    #include <dt-bindings/interrupt-controller/irq.h>
1738c2ecf20Sopenharmony_ci    #include <dt-bindings/interrupt-controller/arm-gic.h>
1748c2ecf20Sopenharmony_ci
1758c2ecf20Sopenharmony_ci    bus {
1768c2ecf20Sopenharmony_ci        #address-cells = <2>;
1778c2ecf20Sopenharmony_ci        #size-cells = <2>;
1788c2ecf20Sopenharmony_ci
1798c2ecf20Sopenharmony_ci        mcu_cpsw: ethernet@46000000 {
1808c2ecf20Sopenharmony_ci            compatible = "ti,am654-cpsw-nuss";
1818c2ecf20Sopenharmony_ci            #address-cells = <2>;
1828c2ecf20Sopenharmony_ci            #size-cells = <2>;
1838c2ecf20Sopenharmony_ci            reg = <0x0 0x46000000 0x0 0x200000>;
1848c2ecf20Sopenharmony_ci            reg-names = "cpsw_nuss";
1858c2ecf20Sopenharmony_ci            ranges = <0x0 0x0 0x0 0x46000000 0x0 0x200000>;
1868c2ecf20Sopenharmony_ci            dma-coherent;
1878c2ecf20Sopenharmony_ci            clocks = <&k3_clks 5 10>;
1888c2ecf20Sopenharmony_ci            clock-names = "fck";
1898c2ecf20Sopenharmony_ci            power-domains = <&k3_pds 5 TI_SCI_PD_EXCLUSIVE>;
1908c2ecf20Sopenharmony_ci            pinctrl-names = "default";
1918c2ecf20Sopenharmony_ci            pinctrl-0 = <&mcu_cpsw_pins_default &mcu_mdio_pins_default>;
1928c2ecf20Sopenharmony_ci
1938c2ecf20Sopenharmony_ci            dmas = <&mcu_udmap 0xf000>,
1948c2ecf20Sopenharmony_ci                   <&mcu_udmap 0xf001>,
1958c2ecf20Sopenharmony_ci                   <&mcu_udmap 0xf002>,
1968c2ecf20Sopenharmony_ci                   <&mcu_udmap 0xf003>,
1978c2ecf20Sopenharmony_ci                   <&mcu_udmap 0xf004>,
1988c2ecf20Sopenharmony_ci                   <&mcu_udmap 0xf005>,
1998c2ecf20Sopenharmony_ci                   <&mcu_udmap 0xf006>,
2008c2ecf20Sopenharmony_ci                   <&mcu_udmap 0xf007>,
2018c2ecf20Sopenharmony_ci                   <&mcu_udmap 0x7000>;
2028c2ecf20Sopenharmony_ci            dma-names = "tx0", "tx1", "tx2", "tx3", "tx4", "tx5", "tx6", "tx7",
2038c2ecf20Sopenharmony_ci                        "rx";
2048c2ecf20Sopenharmony_ci
2058c2ecf20Sopenharmony_ci            ethernet-ports {
2068c2ecf20Sopenharmony_ci                #address-cells = <1>;
2078c2ecf20Sopenharmony_ci                #size-cells = <0>;
2088c2ecf20Sopenharmony_ci
2098c2ecf20Sopenharmony_ci                cpsw_port1: port@1 {
2108c2ecf20Sopenharmony_ci                    reg = <1>;
2118c2ecf20Sopenharmony_ci                    ti,mac-only;
2128c2ecf20Sopenharmony_ci                    label = "port1";
2138c2ecf20Sopenharmony_ci                    ti,syscon-efuse = <&mcu_conf 0x200>;
2148c2ecf20Sopenharmony_ci                    phys = <&phy_gmii_sel 1>;
2158c2ecf20Sopenharmony_ci
2168c2ecf20Sopenharmony_ci                    phy-mode = "rgmii-rxid";
2178c2ecf20Sopenharmony_ci                    phy-handle = <&phy0>;
2188c2ecf20Sopenharmony_ci                };
2198c2ecf20Sopenharmony_ci            };
2208c2ecf20Sopenharmony_ci
2218c2ecf20Sopenharmony_ci            davinci_mdio: mdio@f00 {
2228c2ecf20Sopenharmony_ci                compatible = "ti,cpsw-mdio","ti,davinci_mdio";
2238c2ecf20Sopenharmony_ci                reg = <0x0 0xf00 0x0 0x100>;
2248c2ecf20Sopenharmony_ci                #address-cells = <1>;
2258c2ecf20Sopenharmony_ci                #size-cells = <0>;
2268c2ecf20Sopenharmony_ci                clocks = <&k3_clks 5 10>;
2278c2ecf20Sopenharmony_ci                clock-names = "fck";
2288c2ecf20Sopenharmony_ci                bus_freq = <1000000>;
2298c2ecf20Sopenharmony_ci
2308c2ecf20Sopenharmony_ci                phy0: ethernet-phy@0 {
2318c2ecf20Sopenharmony_ci                    reg = <0>;
2328c2ecf20Sopenharmony_ci                    ti,rx-internal-delay = <DP83867_RGMIIDCTL_2_00_NS>;
2338c2ecf20Sopenharmony_ci                    ti,fifo-depth = <DP83867_PHYCR_FIFO_DEPTH_4_B_NIB>;
2348c2ecf20Sopenharmony_ci                };
2358c2ecf20Sopenharmony_ci            };
2368c2ecf20Sopenharmony_ci        };
2378c2ecf20Sopenharmony_ci
2388c2ecf20Sopenharmony_ci        cpts@3d000 {
2398c2ecf20Sopenharmony_ci             compatible = "ti,am65-cpts";
2408c2ecf20Sopenharmony_ci             reg = <0x0 0x3d000 0x0 0x400>;
2418c2ecf20Sopenharmony_ci             clocks = <&k3_clks 18 2>;
2428c2ecf20Sopenharmony_ci             clock-names = "cpts";
2438c2ecf20Sopenharmony_ci             interrupts-extended = <&gic500 GIC_SPI 858 IRQ_TYPE_LEVEL_HIGH>;
2448c2ecf20Sopenharmony_ci             interrupt-names = "cpts";
2458c2ecf20Sopenharmony_ci             ti,cpts-ext-ts-inputs = <4>;
2468c2ecf20Sopenharmony_ci             ti,cpts-periodic-outputs = <2>;
2478c2ecf20Sopenharmony_ci        };
2488c2ecf20Sopenharmony_ci    };
249