Documentation/devicetree/bindings/net/renesas,ether.yaml

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/net/renesas,ether.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Renesas Electronics SH EtherMAC
   8
   9 allOf:
  10   - $ref: ethernet-controller.yaml#
  11
  12 maintainers:
  13   - Sergei Shtylyov <sergei.shtylyov@gmail.com>
  14
  15 properties:
  16   compatible:
  17     oneOf:
  18       - items:
  19           - enum:
  20               - renesas,gether-r8a7740   # device is a part of R8A7740 SoC
  21               - renesas,gether-r8a77980  # device is a part of R8A77980 SoC
  22               - renesas,ether-r7s72100   # device is a part of R7S72100 SoC
  23               - renesas,ether-r7s9210    # device is a part of R7S9210 SoC
  24       - items:
  25           - enum:
  26               - renesas,ether-r8a7778    # device is a part of R8A7778 SoC
  27               - renesas,ether-r8a7779    # device is a part of R8A7779 SoC
  28           - enum:
  29               - renesas,rcar-gen1-ether  # a generic R-Car Gen1 device
  30       - items:
  31           - enum:
  32               - renesas,ether-r8a7742    # device is a part of R8A7742 SoC
  33               - renesas,ether-r8a7743    # device is a part of R8A7743 SoC
  34               - renesas,ether-r8a7745    # device is a part of R8A7745 SoC
  35               - renesas,ether-r8a7790    # device is a part of R8A7790 SoC
  36               - renesas,ether-r8a7791    # device is a part of R8A7791 SoC
  37               - renesas,ether-r8a7793    # device is a part of R8A7793 SoC
  38               - renesas,ether-r8a7794    # device is a part of R8A7794 SoC
  39           - enum:
  40               - renesas,rcar-gen2-ether  # a generic R-Car Gen2 or RZ/G1 device
  41
  42   reg:
  43     items:
  44       - description: E-DMAC/feLic registers
  45       - description: TSU registers
  46     minItems: 1
  47
  48   interrupts:
  49     maxItems: 1
  50
  51   '#address-cells':
  52     description: number of address cells for the MDIO bus
  53     const: 1
  54
  55   '#size-cells':
  56     description: number of size cells on the MDIO bus
  57     const: 0
  58
  59   clocks:
  60     maxItems: 1
  61
  62   power-domains:
  63     maxItems: 1
  64
  65   resets:
  66     maxItems: 1
  67
  68   phy-mode: true
  69
  70   phy-handle: true
  71
  72   renesas,no-ether-link:
  73     type: boolean
  74     description:
  75       specify when a board does not provide a proper Ether LINK signal
  76
  77   renesas,ether-link-active-low:
  78     type: boolean
  79     description:
  80       specify when the Ether LINK signal is active-low instead of normal
  81       active-high
  82
  83 patternProperties:
  84   "^ethernet-phy@[0-9a-f]$":
  85     type: object
  86     $ref: ethernet-phy.yaml#
  87
  88 required:
  89   - compatible
  90   - reg
  91   - interrupts
  92   - phy-mode
  93   - phy-handle
  94   - '#address-cells'
  95   - '#size-cells'
  96   - clocks
  97
  98 additionalProperties: false
  99
 100 examples:
 101   # Lager board
 102   - |
 103     #include <dt-bindings/clock/r8a7790-cpg-mssr.h>
 104     #include <dt-bindings/interrupt-controller/arm-gic.h>
 105     #include <dt-bindings/power/r8a7790-sysc.h>
 106     #include <dt-bindings/gpio/gpio.h>
 107
 108     ethernet@ee700000 {
 109         compatible = "renesas,ether-r8a7790", "renesas,rcar-gen2-ether";
 110         reg = <0xee700000 0x400>;
 111         interrupts = <GIC_SPI 162 IRQ_TYPE_LEVEL_HIGH>;
 112         clocks = <&cpg CPG_MOD 813>;
 113         power-domains = <&sysc R8A7790_PD_ALWAYS_ON>;
 114         resets = <&cpg 813>;
 115         phy-mode = "rmii";
 116         phy-handle = <&phy1>;
 117         renesas,ether-link-active-low;
 118         #address-cells = <1>;
 119         #size-cells = <0>;
 120
 121         phy1: ethernet-phy@1 {
 122             compatible = "ethernet-phy-id0022.1537",
 123                          "ethernet-phy-ieee802.3-c22";
 124             reg = <1>;
 125             interrupt-parent = <&irqc0>;
 126             interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
 127             micrel,led-mode = <1>;
 128             reset-gpios = <&gpio5 31 GPIO_ACTIVE_LOW>;
 129         };
 130     };