1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/net/mdio.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: MDIO Bus Generic Binding
8
9maintainers:
10  - Andrew Lunn <andrew@lunn.ch>
11  - Florian Fainelli <f.fainelli@gmail.com>
12  - Heiner Kallweit <hkallweit1@gmail.com>
13
14description:
15  These are generic properties that can apply to any MDIO bus. Any
16  MDIO bus must have a list of child nodes, one per device on the
17  bus. These should follow the generic ethernet-phy.yaml document, or
18  a device specific binding document.
19
20properties:
21  $nodename:
22    pattern: "^mdio(@.*)?"
23
24  "#address-cells":
25    const: 1
26
27  "#size-cells":
28    const: 0
29
30  reset-gpios:
31    maxItems: 1
32    description:
33      The phandle and specifier for the GPIO that controls the RESET
34      lines of all PHYs on that MDIO bus.
35
36  reset-delay-us:
37    description:
38      RESET pulse width in microseconds. It applies to all PHY devices
39      and must therefore be appropriately determined based on all PHY
40      requirements (maximum value of all per-PHY RESET pulse widths).
41
42patternProperties:
43  "^ethernet-phy@[0-9a-f]+$":
44    type: object
45
46    properties:
47      reg:
48        minimum: 0
49        maximum: 31
50        description:
51          The ID number for the PHY.
52
53    required:
54      - reg
55
56examples:
57  - |
58    davinci_mdio: mdio@5c030000 {
59        reg = <0x5c030000 0x1000>;
60        #address-cells = <1>;
61        #size-cells = <0>;
62
63        reset-gpios = <&gpio2 5 1>;
64        reset-delay-us = <2>;
65
66        ethphy0: ethernet-phy@1 {
67            reg = <1>;
68        };
69
70        ethphy1: ethernet-phy@3 {
71            reg = <3>;
72        };
73    };
74