power/fsl: add MDIO dt binding for FMan

This binding is for FMan MDIO, it covers FMan v2 & FMan v3.

Signed-off-by: Shaohui Xie <Shaohui.Xie@freescale.com>
[scottwood@freescale.com: mark interrupts required only for external]
Signed-off-by: Scott Wood <scottwood@freescale.com>

diff --git a/Documentation/devicetree/bindings/powerpc/fsl/fman.txt b/Documentation/devicetree/bindings/powerpc/fsl/fman.txt
index edeea160ca396b62dc15ff9c739190c82b1aa713..edda55f7400415a41d70efc9ecc9245d0cc60996 100644 (file)
--- a/Documentation/devicetree/bindings/powerpc/fsl/fman.txt
+++ b/Documentation/devicetree/bindings/powerpc/fsl/fman.txt
@@ -7,6 +7,7 @@ CONTENTS
   - FMan MURAM Node
   - FMan dTSEC/XGEC/mEMAC Node
   - FMan IEEE 1588 Node
+  - FMan MDIO Node
   - Example
 
 =============================================================================
@@ -356,6 +357,69 @@ ptp-timer@fe000 {
        reg = <0xfe000 0x1000>;
 };
 
+=============================================================================
+FMan MDIO Node
+
+DESCRIPTION
+
+The MDIO is a bus to which the PHY devices are connected.
+
+PROPERTIES
+
+- compatible
+               Usage: required
+               Value type: <stringlist>
+               Definition: A standard property.
+               Must include "fsl,fman-mdio" for 1 Gb/s MDIO from FMan v2.
+               Must include "fsl,fman-xmdio" for 10 Gb/s MDIO from FMan v2.
+               Must include "fsl,fman-memac-mdio" for 1/10 Gb/s MDIO from
+               FMan v3.
+
+- reg
+               Usage: required
+               Value type: <prop-encoded-array>
+               Definition: A standard property.
+
+- bus-frequency
+               Usage: optional
+               Value type: <u32>
+               Definition: Specifies the external MDIO bus clock speed to
+               be used, if different from the standard 2.5 MHz.
+               This may be due to the standard speed being unsupported (e.g.
+               due to a hardware problem), or to advertise that all relevant
+               components in the system support a faster speed.
+
+- interrupts
+               Usage: required for external MDIO
+               Value type: <prop-encoded-array>
+               Definition: Event interrupt of external MDIO controller.
+
+- fsl,fman-internal-mdio
+               Usage: required for internal MDIO
+               Value type: boolean
+               Definition: Fman has internal MDIO for internal PCS(Physical
+               Coding Sublayer) PHYs and external MDIO for external PHYs.
+               The settings and programming routines for internal/external
+               MDIO are different. Must be included for internal MDIO.
+
+EXAMPLE
+
+Example for FMan v2 external MDIO:
+
+mdio@f1000 {
+       compatible = "fsl,fman-xmdio";
+       reg = <0xf1000 0x1000>;
+       interrupts = <101 2 0 0>;
+};
+
+Example for FMan v3 internal MDIO:
+
+mdio@f1000 {
+       compatible = "fsl,fman-memac-mdio";
+       reg = <0xf1000 0x1000>;
+       fsl,fman-internal-mdio;
+};
+
 =============================================================================
 Example
 
@@ -531,4 +595,10 @@ fman@400000 {
                compatible = "fsl,fman-ptp-timer";
                reg = <0xfe000 0x1000>;
        };
+
+       mdio@f1000 {
+               compatible = "fsl,fman-xmdio";
+               reg = <0xf1000 0x1000>;
+               interrupts = <101 2 0 0>;
+       };
 };