1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/net/mediatek,star-emac.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: MediaTek STAR Ethernet MAC Controller
8
9maintainers:
10  - Bartosz Golaszewski <bgolaszewski@baylibre.com>
11
12description:
13  This Ethernet MAC is used on the MT8* family of SoCs from MediaTek.
14  It's compliant with 802.3 standards and supports half- and full-duplex
15  modes with flow-control as well as CRC offloading and VLAN tags.
16
17allOf:
18  - $ref: "ethernet-controller.yaml#"
19
20properties:
21  compatible:
22    enum:
23      - mediatek,mt8516-eth
24      - mediatek,mt8518-eth
25      - mediatek,mt8175-eth
26
27  reg:
28    maxItems: 1
29
30  interrupts:
31    maxItems: 1
32
33  clocks:
34    minItems: 3
35    maxItems: 3
36
37  clock-names:
38    additionalItems: false
39    items:
40      - const: core
41      - const: reg
42      - const: trans
43
44  mediatek,pericfg:
45    $ref: /schemas/types.yaml#definitions/phandle
46    description:
47      Phandle to the device containing the PERICFG register range. This is used
48      to control the MII mode.
49
50  mdio:
51    type: object
52    description:
53      Creates and registers an MDIO bus.
54
55required:
56  - compatible
57  - reg
58  - interrupts
59  - clocks
60  - clock-names
61  - mediatek,pericfg
62  - phy-handle
63
64examples:
65  - |
66    #include <dt-bindings/interrupt-controller/arm-gic.h>
67    #include <dt-bindings/clock/mt8516-clk.h>
68
69    ethernet: ethernet@11180000 {
70        compatible = "mediatek,mt8516-eth";
71        reg = <0x11180000 0x1000>;
72        mediatek,pericfg = <&pericfg>;
73        interrupts = <GIC_SPI 111 IRQ_TYPE_LEVEL_LOW>;
74        clocks = <&topckgen CLK_TOP_RG_ETH>,
75                 <&topckgen CLK_TOP_66M_ETH>,
76                 <&topckgen CLK_TOP_133M_ETH>;
77        clock-names = "core", "reg", "trans";
78        phy-handle = <&eth_phy>;
79        phy-mode = "rmii";
80
81        mdio {
82            #address-cells = <1>;
83            #size-cells = <0>;
84
85            eth_phy: ethernet-phy@0 {
86                reg = <0>;
87            };
88        };
89    };
90