Kumar Gala | d0fc2ea | 2008-07-07 11:28:33 -0500 | [diff] [blame] | 1 | * MDIO IO device |
| 2 | |
| 3 | The MDIO is a bus to which the PHY devices are connected. For each |
| 4 | device that exists on this bus, a child node should be created. See |
Andy Fleming | b31a1d8 | 2008-12-16 15:29:15 -0800 | [diff] [blame] | 5 | the definition of the PHY node in booting-without-of.txt for an example |
| 6 | of how to define a PHY. |
Kumar Gala | d0fc2ea | 2008-07-07 11:28:33 -0500 | [diff] [blame] | 7 | |
| 8 | Required properties: |
Esben Haabendal | 2148118 | 2018-04-06 14:38:34 +0200 | [diff] [blame] | 9 | - 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 Gala | d0fc2ea | 2008-07-07 11:28:33 -0500 | [diff] [blame] | 14 | - compatible : Should define the compatible device type for the |
Shruti Kanetkar | 132d7bc | 2015-02-01 15:58:31 -0600 | [diff] [blame] | 15 | 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 Gala | d0fc2ea | 2008-07-07 11:28:33 -0500 | [diff] [blame] | 25 | |
| 26 | Example: |
| 27 | |
| 28 | mdio@24520 { |
| 29 | reg = <24520 20>; |
| 30 | compatible = "fsl,gianfar-mdio"; |
| 31 | |
| 32 | ethernet-phy@0 { |
| 33 | ...... |
| 34 | }; |
| 35 | }; |
| 36 | |
Andy Fleming | b31a1d8 | 2008-12-16 15:29:15 -0800 | [diff] [blame] | 37 | * TBI Internal MDIO bus |
| 38 | |
| 39 | As of this writing, every tsec is associated with an internal TBI PHY. |
| 40 | This PHY is accessed through the local MDIO bus. These buses are defined |
| 41 | similarly to the mdio buses, except they are compatible with "fsl,gianfar-tbi". |
| 42 | The TBI PHYs underneath them are similar to normal PHYs, but the reg property |
| 43 | is considered instructive, rather than descriptive. The reg property should |
| 44 | be chosen so it doesn't interfere with other PHYs on the bus. |
Kumar Gala | d0fc2ea | 2008-07-07 11:28:33 -0500 | [diff] [blame] | 45 | |
| 46 | * Gianfar-compatible ethernet nodes |
| 47 | |
Scott Wood | 0026298 | 2008-07-11 18:04:43 -0500 | [diff] [blame] | 48 | Properties: |
Kumar Gala | d0fc2ea | 2008-07-07 11:28:33 -0500 | [diff] [blame] | 49 | |
| 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 Wood | 0026298 | 2008-07-11 18:04:43 -0500 | [diff] [blame] | 54 | - 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 Shtylyov | e8f08ee | 2014-02-18 02:41:59 +0300 | [diff] [blame] | 57 | - phy-handle : See ethernet.txt file in the same directory. |
Florian Fainelli | ae21888 | 2014-05-22 09:47:44 -0700 | [diff] [blame] | 58 | - fixed-link : See fixed-link.txt in the same directory. |
Sergei Shtylyov | e8f08ee | 2014-02-18 02:41:59 +0300 | [diff] [blame] | 59 | - 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 Wood | 0026298 | 2008-07-11 18:04:43 -0500 | [diff] [blame] | 62 | - fsl,magic-packet : If present, indicates that the hardware supports |
| 63 | waking up via magic packet. |
Claudiu Manoil | 66cebb8 | 2015-10-05 17:19:57 +0300 | [diff] [blame] | 64 | - 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 Fleming | 4d7902f | 2009-02-04 16:43:44 -0800 | [diff] [blame] | 68 | - 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 Gala | d0fc2ea | 2008-07-07 11:28:33 -0500 | [diff] [blame] | 74 | |
| 75 | Example: |
| 76 | ethernet@24000 { |
Kumar Gala | d0fc2ea | 2008-07-07 11:28:33 -0500 | [diff] [blame] | 77 | device_type = "network"; |
| 78 | model = "TSEC"; |
| 79 | compatible = "gianfar"; |
Scott Wood | 0026298 | 2008-07-11 18:04:43 -0500 | [diff] [blame] | 80 | 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 Gala | d0fc2ea | 2008-07-07 11:28:33 -0500 | [diff] [blame] | 85 | }; |
Richard Cochran | c78275f | 2011-04-22 12:03:54 +0200 | [diff] [blame] | 86 | |
| 87 | * Gianfar PTP clock nodes |
| 88 | |
Yangbo Lu | a98ac8b | 2018-05-25 12:40:37 +0800 | [diff] [blame] | 89 | Refer to Documentation/devicetree/bindings/ptp/ptp-qoriq.txt |