Merge branch 'drm-next-4.12' of git://people.freedesktop.org/~agd5f/linux into drm...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / net / marvell-orion-mdio.txt
1 * Marvell MDIO Ethernet Controller interface
2
3 The Ethernet controllers of the Marvel Kirkwood, Dove, Orion5x,
4 MV78xx0, Armada 370 and Armada XP have an identical unit that provides
5 an interface with the MDIO bus. This driver handles this MDIO
6 interface.
7
8 Required properties:
9 - compatible: "marvell,orion-mdio"
10 - reg: address and length of the MDIO registers.  When an interrupt is
11   not present, the length is the size of the SMI register (4 bytes)
12   otherwise it must be 0x84 bytes to cover the interrupt control
13   registers.
14
15 Optional properties:
16 - interrupts: interrupt line number for the SMI error/done interrupt
17 - clocks: phandle for up to three required clocks for the MDIO instance
18
19 The child nodes of the MDIO driver are the individual PHY devices
20 connected to this MDIO bus. They must have a "reg" property given the
21 PHY address on the MDIO bus.
22
23 Example at the SoC level without an interrupt property:
24
25 mdio {
26         #address-cells = <1>;
27         #size-cells = <0>;
28         compatible = "marvell,orion-mdio";
29         reg = <0xd0072004 0x4>;
30 };
31
32 Example with an interrupt property:
33
34 mdio {
35         #address-cells = <1>;
36         #size-cells = <0>;
37         compatible = "marvell,orion-mdio";
38         reg = <0xd0072004 0x84>;
39         interrupts = <30>;
40 };
41
42 And at the board level:
43
44 mdio {
45         phy0: ethernet-phy@0 {
46                 reg = <0>;
47         };
48
49         phy1: ethernet-phy@1 {
50                 reg = <1>;
51         };
52 }