blob: 047bdf7bdd2fa3e6dfad8ab957f478fbebb794a1 [file] [log] [blame]
Kumar Galad0fc2ea2008-07-07 11:28:33 -05001* MDIO IO device
2
3The MDIO is a bus to which the PHY devices are connected. For each
4device that exists on this bus, a child node should be created. See
Andy Flemingb31a1d82008-12-16 15:29:15 -08005the definition of the PHY node in booting-without-of.txt for an example
6of how to define a PHY.
Kumar Galad0fc2ea2008-07-07 11:28:33 -05007
8Required properties:
Esben Haabendal21481182018-04-06 14:38:34 +02009 - reg : Offset and length of the register set for the device, and optionally
10 the offset and length of the TBIPA register (TBI PHY address
11 register). If TBIPA register is not specified, the driver will
12 attempt to infer it from the register set specified (your mileage may
13 vary).
Kumar Galad0fc2ea2008-07-07 11:28:33 -050014 - compatible : Should define the compatible device type for the
Shruti Kanetkar132d7bc2015-02-01 15:58:31 -060015 mdio. Currently supported strings/devices are:
16 - "fsl,gianfar-tbi"
17 - "fsl,gianfar-mdio"
18 - "fsl,etsec2-tbi"
19 - "fsl,etsec2-mdio"
20 - "fsl,ucc-mdio"
21 - "fsl,fman-mdio"
22 When device_type is "mdio", the following strings are also considered:
23 - "gianfar"
24 - "ucc_geth_phy"
Kumar Galad0fc2ea2008-07-07 11:28:33 -050025
26Example:
27
28 mdio@24520 {
29 reg = <24520 20>;
30 compatible = "fsl,gianfar-mdio";
31
32 ethernet-phy@0 {
33 ......
34 };
35 };
36
Andy Flemingb31a1d82008-12-16 15:29:15 -080037* TBI Internal MDIO bus
38
39As of this writing, every tsec is associated with an internal TBI PHY.
40This PHY is accessed through the local MDIO bus. These buses are defined
41similarly to the mdio buses, except they are compatible with "fsl,gianfar-tbi".
42The TBI PHYs underneath them are similar to normal PHYs, but the reg property
43is considered instructive, rather than descriptive. The reg property should
44be chosen so it doesn't interfere with other PHYs on the bus.
Kumar Galad0fc2ea2008-07-07 11:28:33 -050045
46* Gianfar-compatible ethernet nodes
47
Scott Wood00262982008-07-11 18:04:43 -050048Properties:
Kumar Galad0fc2ea2008-07-07 11:28:33 -050049
50 - device_type : Should be "network"
51 - model : Model of the device. Can be "TSEC", "eTSEC", or "FEC"
52 - compatible : Should be "gianfar"
53 - reg : Offset and length of the register set for the device
Scott Wood00262982008-07-11 18:04:43 -050054 - interrupts : For FEC devices, the first interrupt is the device's
55 interrupt. For TSEC and eTSEC devices, the first interrupt is
56 transmit, the second is receive, and the third is error.
Sergei Shtylyove8f08ee2014-02-18 02:41:59 +030057 - phy-handle : See ethernet.txt file in the same directory.
Florian Fainelliae218882014-05-22 09:47:44 -070058 - fixed-link : See fixed-link.txt in the same directory.
Sergei Shtylyove8f08ee2014-02-18 02:41:59 +030059 - phy-connection-type : See ethernet.txt file in the same directory.
60 This property is only really needed if the connection is of type
61 "rgmii-id", as all other connection types are detected by hardware.
Scott Wood00262982008-07-11 18:04:43 -050062 - fsl,magic-packet : If present, indicates that the hardware supports
63 waking up via magic packet.
Claudiu Manoil66cebb82015-10-05 17:19:57 +030064 - fsl,wake-on-filer : If present, indicates that the hardware supports
65 waking up by Filer General Purpose Interrupt (FGPI) asserted on the
66 Rx int line. This is an advanced power management capability allowing
67 certain packet types (user) defined by filer rules to wake up the system.
Andy Fleming4d7902f2009-02-04 16:43:44 -080068 - bd-stash : If present, indicates that the hardware supports stashing
69 buffer descriptors in the L2.
70 - rx-stash-len : Denotes the number of bytes of a received buffer to stash
71 in the L2.
72 - rx-stash-idx : Denotes the index of the first byte from the received
73 buffer to stash in the L2.
Kumar Galad0fc2ea2008-07-07 11:28:33 -050074
75Example:
76 ethernet@24000 {
Kumar Galad0fc2ea2008-07-07 11:28:33 -050077 device_type = "network";
78 model = "TSEC";
79 compatible = "gianfar";
Scott Wood00262982008-07-11 18:04:43 -050080 reg = <0x24000 0x1000>;
81 local-mac-address = [ 00 E0 0C 00 73 00 ];
82 interrupts = <29 2 30 2 34 2>;
83 interrupt-parent = <&mpic>;
84 phy-handle = <&phy0>
Kumar Galad0fc2ea2008-07-07 11:28:33 -050085 };
Richard Cochranc78275f2011-04-22 12:03:54 +020086
87* Gianfar PTP clock nodes
88
Yangbo Lua98ac8b2018-05-25 12:40:37 +080089Refer to Documentation/devicetree/bindings/ptp/ptp-qoriq.txt