xref: /openbmc/u-boot/doc/device-tree-bindings/net/fsl-tsec-phy.txt (revision 82d72a1b9967cff4908f22c57536c3660f794401)
169a00875SBin Meng* TSEC-compatible ethernet nodes
269a00875SBin Meng
369a00875SBin MengProperties:
469a00875SBin Meng
569a00875SBin Meng  - compatible : Should be "fsl,tsec"
669a00875SBin Meng  - reg : Offset and length of the register set for the device
769a00875SBin Meng  - phy-handle : See ethernet.txt file in the same directory.
869a00875SBin Meng  - phy-connection-type : See ethernet.txt file in the same directory. This
969a00875SBin Meng    property is only really needed if the connection is of type "rgmii-id",
1069a00875SBin Meng    "rgmii-rxid" and "rgmii-txid" as all other connection types are detected
1169a00875SBin Meng    by hardware.
1269a00875SBin Meng
1369a00875SBin MengExample:
1469a00875SBin Meng	ethernet@24000 {
1569a00875SBin Meng		compatible = "fsl,tsec";
1669a00875SBin Meng		reg = <0x24000 0x1000>;
1769a00875SBin Meng		phy-handle = <&phy0>;
1869a00875SBin Meng		phy-connection-type = "sgmii";
1969a00875SBin Meng	};
2069a00875SBin Meng
2169a00875SBin MengChild nodes of the TSEC controller are typically the individual PHY devices
2269a00875SBin Mengconnected via the MDIO bus (sometimes the MDIO bus controller is separate).
2369a00875SBin Meng
2469a00875SBin Meng* MDIO IO device
2569a00875SBin Meng
2669a00875SBin MengThe MDIO is a bus to which the PHY devices are connected.  For each
2769a00875SBin Mengdevice that exists on this bus, a PHY node should be created.
2869a00875SBin Meng
2969a00875SBin MengRequired properties:
3069a00875SBin Meng  - compatible : Should define the compatible device type for the
3169a00875SBin Meng    mdio. Currently supported string/device is "fsl,tsec-mdio".
3269a00875SBin Meng  - reg : Offset and length of the register set for the device
3369a00875SBin Meng
3469a00875SBin MengExample:
3569a00875SBin Meng
3669a00875SBin Meng	mdio@24520 {
3769a00875SBin Meng		compatible = "fsl,tsec-mdio";
3869a00875SBin Meng		reg = <0x24520 0x20>;
3969a00875SBin Meng
4069a00875SBin Meng		ethernet-phy@0 {
4169a00875SBin Meng			reg = <0>;
4269a00875SBin Meng		};
4369a00875SBin Meng	};
44*a1c76c15SBin Meng
45*a1c76c15SBin Meng* TBI Internal MDIO bus
46*a1c76c15SBin Meng
47*a1c76c15SBin MengAs of this writing, every tsec is associated with an internal TBI PHY.
48*a1c76c15SBin MengThis PHY is accessed through the local MDIO bus.  These buses are defined
49*a1c76c15SBin Mengsimilarly to the mdio buses.  The TBI PHYs underneath them are similar to
50*a1c76c15SBin Mengnormal PHYs, but the reg property is considered instructive, rather than
51*a1c76c15SBin Mengdescriptive.  The reg property should be chosen so it doesn't interfere
52*a1c76c15SBin Mengwith other PHYs on the bus.  The TBI PHYs are referred to by a "tbi-handle"
53*a1c76c15SBin Mengproperty under the tsec node, which has a similar meaning of "phy-handle".
54*a1c76c15SBin Meng
55*a1c76c15SBin MengExample:
56*a1c76c15SBin Meng	ethernet@24000 {
57*a1c76c15SBin Meng		phy-handle = <&tbi1>;
58*a1c76c15SBin Meng	};
59*a1c76c15SBin Meng
60*a1c76c15SBin Meng	mdio@24520 {
61*a1c76c15SBin Meng		tbi1: tbi-phy@1f {
62*a1c76c15SBin Meng			reg = <0x1f>;
63*a1c76c15SBin Meng		};
64*a1c76c15SBin Meng	};
65