Documentation/devicetree/bindings/net/mediatek,star-emac.yaml

   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
   7 title: MediaTek STAR Ethernet MAC Controller
   8
   9 maintainers:
  10   - Bartosz Golaszewski <bgolaszewski@baylibre.com>
  11
  12 description:
  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
  17 allOf:
  18   - $ref: "ethernet-controller.yaml#"
  19
  20 properties:
  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
  55 required:
  56   - compatible
  57   - reg
  58   - interrupts
  59   - clocks
  60   - clock-names
  61   - mediatek,pericfg
  62   - phy-handle
  63
  64 examples:
  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     };