1d524dac9SGrant Likely* MDIO IO device 2d524dac9SGrant Likely 3d524dac9SGrant LikelyThe MDIO is a bus to which the PHY devices are connected. For each 4d524dac9SGrant Likelydevice that exists on this bus, a child node should be created. See 5d524dac9SGrant Likelythe definition of the PHY node in booting-without-of.txt for an example 6d524dac9SGrant Likelyof how to define a PHY. 7d524dac9SGrant Likely 8d524dac9SGrant LikelyRequired properties: 9d524dac9SGrant Likely - reg : Offset and length of the register set for the device 10d524dac9SGrant Likely - compatible : Should define the compatible device type for the 11*132d7bcaSShruti Kanetkar mdio. Currently supported strings/devices are: 12*132d7bcaSShruti Kanetkar - "fsl,gianfar-tbi" 13*132d7bcaSShruti Kanetkar - "fsl,gianfar-mdio" 14*132d7bcaSShruti Kanetkar - "fsl,etsec2-tbi" 15*132d7bcaSShruti Kanetkar - "fsl,etsec2-mdio" 16*132d7bcaSShruti Kanetkar - "fsl,ucc-mdio" 17*132d7bcaSShruti Kanetkar - "fsl,fman-mdio" 18*132d7bcaSShruti Kanetkar When device_type is "mdio", the following strings are also considered: 19*132d7bcaSShruti Kanetkar - "gianfar" 20*132d7bcaSShruti Kanetkar - "ucc_geth_phy" 21d524dac9SGrant Likely 22d524dac9SGrant LikelyExample: 23d524dac9SGrant Likely 24d524dac9SGrant Likely mdio@24520 { 25d524dac9SGrant Likely reg = <24520 20>; 26d524dac9SGrant Likely compatible = "fsl,gianfar-mdio"; 27d524dac9SGrant Likely 28d524dac9SGrant Likely ethernet-phy@0 { 29d524dac9SGrant Likely ...... 30d524dac9SGrant Likely }; 31d524dac9SGrant Likely }; 32d524dac9SGrant Likely 33d524dac9SGrant Likely* TBI Internal MDIO bus 34d524dac9SGrant Likely 35d524dac9SGrant LikelyAs of this writing, every tsec is associated with an internal TBI PHY. 36d524dac9SGrant LikelyThis PHY is accessed through the local MDIO bus. These buses are defined 37d524dac9SGrant Likelysimilarly to the mdio buses, except they are compatible with "fsl,gianfar-tbi". 38d524dac9SGrant LikelyThe TBI PHYs underneath them are similar to normal PHYs, but the reg property 39d524dac9SGrant Likelyis considered instructive, rather than descriptive. The reg property should 40d524dac9SGrant Likelybe chosen so it doesn't interfere with other PHYs on the bus. 41d524dac9SGrant Likely 42d524dac9SGrant Likely* Gianfar-compatible ethernet nodes 43d524dac9SGrant Likely 44d524dac9SGrant LikelyProperties: 45d524dac9SGrant Likely 46d524dac9SGrant Likely - device_type : Should be "network" 47d524dac9SGrant Likely - model : Model of the device. Can be "TSEC", "eTSEC", or "FEC" 48d524dac9SGrant Likely - compatible : Should be "gianfar" 49d524dac9SGrant Likely - reg : Offset and length of the register set for the device 50d524dac9SGrant Likely - interrupts : For FEC devices, the first interrupt is the device's 51d524dac9SGrant Likely interrupt. For TSEC and eTSEC devices, the first interrupt is 52d524dac9SGrant Likely transmit, the second is receive, and the third is error. 53e8f08ee0SSergei Shtylyov - phy-handle : See ethernet.txt file in the same directory. 54ae21888fSFlorian Fainelli - fixed-link : See fixed-link.txt in the same directory. 55e8f08ee0SSergei Shtylyov - phy-connection-type : See ethernet.txt file in the same directory. 56e8f08ee0SSergei Shtylyov This property is only really needed if the connection is of type 57e8f08ee0SSergei Shtylyov "rgmii-id", as all other connection types are detected by hardware. 58d524dac9SGrant Likely - fsl,magic-packet : If present, indicates that the hardware supports 59d524dac9SGrant Likely waking up via magic packet. 60d524dac9SGrant Likely - bd-stash : If present, indicates that the hardware supports stashing 61d524dac9SGrant Likely buffer descriptors in the L2. 62d524dac9SGrant Likely - rx-stash-len : Denotes the number of bytes of a received buffer to stash 63d524dac9SGrant Likely in the L2. 64d524dac9SGrant Likely - rx-stash-idx : Denotes the index of the first byte from the received 65d524dac9SGrant Likely buffer to stash in the L2. 66d524dac9SGrant Likely 67d524dac9SGrant LikelyExample: 68d524dac9SGrant Likely ethernet@24000 { 69d524dac9SGrant Likely device_type = "network"; 70d524dac9SGrant Likely model = "TSEC"; 71d524dac9SGrant Likely compatible = "gianfar"; 72d524dac9SGrant Likely reg = <0x24000 0x1000>; 73d524dac9SGrant Likely local-mac-address = [ 00 E0 0C 00 73 00 ]; 74d524dac9SGrant Likely interrupts = <29 2 30 2 34 2>; 75d524dac9SGrant Likely interrupt-parent = <&mpic>; 76d524dac9SGrant Likely phy-handle = <&phy0> 77d524dac9SGrant Likely }; 78c78275f3SRichard Cochran 79c78275f3SRichard Cochran* Gianfar PTP clock nodes 80c78275f3SRichard Cochran 81c78275f3SRichard CochranGeneral Properties: 82c78275f3SRichard Cochran 83c78275f3SRichard Cochran - compatible Should be "fsl,etsec-ptp" 84c78275f3SRichard Cochran - reg Offset and length of the register set for the device 85c78275f3SRichard Cochran - interrupts There should be at least two interrupts. Some devices 86c78275f3SRichard Cochran have as many as four PTP related interrupts. 87c78275f3SRichard Cochran 88c78275f3SRichard CochranClock Properties: 89c78275f3SRichard Cochran 90e58f6f4fSAida Mynzhasova - fsl,cksel Timer reference clock source. 91c78275f3SRichard Cochran - fsl,tclk-period Timer reference clock period in nanoseconds. 92c78275f3SRichard Cochran - fsl,tmr-prsc Prescaler, divides the output clock. 93c78275f3SRichard Cochran - fsl,tmr-add Frequency compensation value. 94c78275f3SRichard Cochran - fsl,tmr-fiper1 Fixed interval period pulse generator. 95c78275f3SRichard Cochran - fsl,tmr-fiper2 Fixed interval period pulse generator. 96c78275f3SRichard Cochran - fsl,max-adj Maximum frequency adjustment in parts per billion. 97c78275f3SRichard Cochran 98c78275f3SRichard Cochran These properties set the operational parameters for the PTP 99c78275f3SRichard Cochran clock. You must choose these carefully for the clock to work right. 100c78275f3SRichard Cochran Here is how to figure good values: 101c78275f3SRichard Cochran 102e58f6f4fSAida Mynzhasova TimerOsc = selected reference clock MHz 103c78275f3SRichard Cochran tclk_period = desired clock period nanoseconds 104c78275f3SRichard Cochran NominalFreq = 1000 / tclk_period MHz 105c78275f3SRichard Cochran FreqDivRatio = TimerOsc / NominalFreq (must be greater that 1.0) 106c78275f3SRichard Cochran tmr_add = ceil(2^32 / FreqDivRatio) 107c78275f3SRichard Cochran OutputClock = NominalFreq / tmr_prsc MHz 108c78275f3SRichard Cochran PulseWidth = 1 / OutputClock microseconds 109c78275f3SRichard Cochran FiperFreq1 = desired frequency in Hz 110c78275f3SRichard Cochran FiperDiv1 = 1000000 * OutputClock / FiperFreq1 111c78275f3SRichard Cochran tmr_fiper1 = tmr_prsc * tclk_period * FiperDiv1 - tclk_period 112c78275f3SRichard Cochran max_adj = 1000000000 * (FreqDivRatio - 1.0) - 1 113c78275f3SRichard Cochran 114c78275f3SRichard Cochran The calculation for tmr_fiper2 is the same as for tmr_fiper1. The 115c78275f3SRichard Cochran driver expects that tmr_fiper1 will be correctly set to produce a 1 116c78275f3SRichard Cochran Pulse Per Second (PPS) signal, since this will be offered to the PPS 117c78275f3SRichard Cochran subsystem to synchronize the Linux clock. 118c78275f3SRichard Cochran 119e58f6f4fSAida Mynzhasova Reference clock source is determined by the value, which is holded 120e58f6f4fSAida Mynzhasova in CKSEL bits in TMR_CTRL register. "fsl,cksel" property keeps the 121e58f6f4fSAida Mynzhasova value, which will be directly written in those bits, that is why, 122e58f6f4fSAida Mynzhasova according to reference manual, the next clock sources can be used: 123e58f6f4fSAida Mynzhasova 124e58f6f4fSAida Mynzhasova <0> - external high precision timer reference clock (TSEC_TMR_CLK 125e58f6f4fSAida Mynzhasova input is used for this purpose); 126e58f6f4fSAida Mynzhasova <1> - eTSEC system clock; 127e58f6f4fSAida Mynzhasova <2> - eTSEC1 transmit clock; 128e58f6f4fSAida Mynzhasova <3> - RTC clock input. 129e58f6f4fSAida Mynzhasova 130e58f6f4fSAida Mynzhasova When this attribute is not used, eTSEC system clock will serve as 131e58f6f4fSAida Mynzhasova IEEE 1588 timer reference clock. 132e58f6f4fSAida Mynzhasova 133c78275f3SRichard CochranExample: 134c78275f3SRichard Cochran 135c78275f3SRichard Cochran ptp_clock@24E00 { 136c78275f3SRichard Cochran compatible = "fsl,etsec-ptp"; 137c78275f3SRichard Cochran reg = <0x24E00 0xB0>; 138c78275f3SRichard Cochran interrupts = <12 0x8 13 0x8>; 139c78275f3SRichard Cochran interrupt-parent = < &ipic >; 140e58f6f4fSAida Mynzhasova fsl,cksel = <1>; 141c78275f3SRichard Cochran fsl,tclk-period = <10>; 142c78275f3SRichard Cochran fsl,tmr-prsc = <100>; 143c78275f3SRichard Cochran fsl,tmr-add = <0x999999A4>; 144c78275f3SRichard Cochran fsl,tmr-fiper1 = <0x3B9AC9F6>; 145c78275f3SRichard Cochran fsl,tmr-fiper2 = <0x00018696>; 146c78275f3SRichard Cochran fsl,max-adj = <659999998>; 147c78275f3SRichard Cochran }; 148