Documentation/devicetree/bindings/net/nxp,dwmac-imx.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/nxp,dwmac-imx.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: NXP i.MX8/9 DWMAC glue layer
   8
   9 maintainers:
  10   - Clark Wang <xiaoning.wang@nxp.com>
  11   - Shawn Guo <shawnguo@kernel.org>
  12   - NXP Linux Team <linux-imx@nxp.com>
  13
  14 # We need a select here so we don't match all nodes with 'snps,dwmac'
  15 select:
  16   properties:
  17     compatible:
  18       contains:
  19         enum:
  20           - nxp,imx8mp-dwmac-eqos
  21           - nxp,imx8dxl-dwmac-eqos
  22           - nxp,imx93-dwmac-eqos
  23   required:
  24     - compatible
  25
  26 allOf:
  27   - $ref: snps,dwmac.yaml#
  28
  29 properties:
  30   compatible:
  31     oneOf:
  32       - items:
  33           - enum:
  34               - nxp,imx8mp-dwmac-eqos
  35               - nxp,imx8dxl-dwmac-eqos
  36               - nxp,imx93-dwmac-eqos
  37           - const: snps,dwmac-5.10a
  38
  39   clocks:
  40     minItems: 3
  41     items:
  42       - description: MAC host clock
  43       - description: MAC apb clock
  44       - description: MAC timer clock
  45       - description: MAC RGMII TX clock
  46       - description: EQOS MEM clock
  47
  48   clock-names:
  49     minItems: 3
  50     maxItems: 5
  51     contains:
  52       enum:
  53         - stmmaceth
  54         - pclk
  55         - ptp_ref
  56         - tx
  57         - mem
  58
  59   intf_mode:
  60     $ref: /schemas/types.yaml#/definitions/phandle-array
  61     items:
  62       - items:
  63           - description: phandle to the GPR syscon
  64           - description: the offset of the GPR register
  65     description:
  66       Should be phandle/offset pair. The phandle to the syscon node which
  67       encompases the GPR register, and the offset of the GPR register.
  68
  69   snps,rmii_refclk_ext:
  70     $ref: /schemas/types.yaml#/definitions/flag
  71     description:
  72       To select RMII reference clock from external.
  73
  74 required:
  75   - compatible
  76   - clocks
  77   - clock-names
  78
  79 unevaluatedProperties: false
  80
  81 examples:
  82   - |
  83     #include <dt-bindings/interrupt-controller/arm-gic.h>
  84     #include <dt-bindings/interrupt-controller/irq.h>
  85     #include <dt-bindings/clock/imx8mp-clock.h>
  86
  87     eqos: ethernet@30bf0000 {
  88             compatible = "nxp,imx8mp-dwmac-eqos","snps,dwmac-5.10a";
  89             reg = <0x30bf0000 0x10000>;
  90             interrupts = <GIC_SPI 135 IRQ_TYPE_LEVEL_HIGH>,
  91                          <GIC_SPI 134 IRQ_TYPE_LEVEL_HIGH>;
  92             interrupt-names = "macirq", "eth_wake_irq";
  93             clocks = <&clk IMX8MP_CLK_ENET_QOS_ROOT>,
  94                      <&clk IMX8MP_CLK_QOS_ENET_ROOT>,
  95                      <&clk IMX8MP_CLK_ENET_QOS_TIMER>,
  96                      <&clk IMX8MP_CLK_ENET_QOS>;
  97             clock-names = "stmmaceth", "pclk", "ptp_ref", "tx";
  98             phy-mode = "rgmii";
  99     };