doc: bindings: add bindings document for PHY nodes
authorAlex Marginean <alexandru.marginean@nxp.com>
Thu, 14 Nov 2019 16:28:36 +0000 (18:28 +0200)
committerJoe Hershberger <joe.hershberger@ni.com>
Mon, 9 Dec 2019 15:47:43 +0000 (09:47 -0600)
It defines that PHY nodes must be children on MDIO bus nodes and defines
the only required property in U-Boot, reg.  This property along with the
example provided are copied over from Linux.

Signed-off-by: Alex Marginean <alexandru.marginean@nxp.com>
Acked-by: Joe Hershberger <joe.hershberger@ni.com>
doc/device-tree-bindings/net/phy.txt [new file with mode: 0644]

diff --git a/doc/device-tree-bindings/net/phy.txt b/doc/device-tree-bindings/net/phy.txt
new file mode 100644 (file)
index 0000000..6599c66
--- /dev/null
@@ -0,0 +1,24 @@
+PHY nodes
+
+If the device tree is used to describe networking interfaces, U-Boot expects a
+node for each PHY.  Parent node for such a PHY node is expected to correspond to
+a MDIO bus and the bus is used to access the PHY.
+
+Required properties:
+
+ - reg : The ID number for the phy, usually a small integer
+
+Example:
+
+ethernet-phy@0 {
+       compatible = "ethernet-phy-id0141.0e90", "ethernet-phy-ieee802.3-c22";
+       interrupt-parent = <&PIC>;
+       interrupts = <35 IRQ_TYPE_EDGE_RISING>;
+       reg = <0>;
+
+       resets = <&rst 8>;
+       reset-names = "phy";
+       reset-gpios = <&gpio1 4 GPIO_ACTIVE_LOW>;
+       reset-assert-us = <1000>;
+       reset-deassert-us = <2000>;
+};