Merge tag 'drm-next-2019-07-19' of git://anongit.freedesktop.org/drm/drm
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / net / ti,dp83867.txt
1 * Texas Instruments - dp83867 Giga bit ethernet phy
2
3 Required properties:
4         - reg - The ID number for the phy, usually a small integer
5         - ti,rx-internal-delay - RGMII Receive Clock Delay - see dt-bindings/net/ti-dp83867.h
6                 for applicable values. Required only if interface type is
7                 PHY_INTERFACE_MODE_RGMII_ID or PHY_INTERFACE_MODE_RGMII_RXID
8         - ti,tx-internal-delay - RGMII Transmit Clock Delay - see dt-bindings/net/ti-dp83867.h
9                 for applicable values. Required only if interface type is
10                 PHY_INTERFACE_MODE_RGMII_ID or PHY_INTERFACE_MODE_RGMII_TXID
11         - ti,fifo-depth - Transmitt FIFO depth- see dt-bindings/net/ti-dp83867.h
12                 for applicable values
13
14 Note: If the interface type is PHY_INTERFACE_MODE_RGMII the TX/RX clock delays
15       will be left at their default values, as set by the PHY's pin strapping.
16       The default strapping will use a delay of 2.00 ns.  Thus
17       PHY_INTERFACE_MODE_RGMII, by default, does not behave as RGMII with no
18       internal delay, but as PHY_INTERFACE_MODE_RGMII_ID.  The device tree
19       should use "rgmii-id" if internal delays are desired as this may be
20       changed in future to cause "rgmii" mode to disable delays.
21
22 Optional property:
23         - ti,min-output-impedance - MAC Interface Impedance control to set
24                                     the programmable output impedance to
25                                     minimum value (35 ohms).
26         - ti,max-output-impedance - MAC Interface Impedance control to set
27                                     the programmable output impedance to
28                                     maximum value (70 ohms).
29         - ti,dp83867-rxctrl-strap-quirk - This denotes the fact that the
30                                     board has RX_DV/RX_CTRL pin strapped in
31                                     mode 1 or 2. To ensure PHY operation,
32                                     there are specific actions that
33                                     software needs to take when this pin is
34                                     strapped in these modes. See data manual
35                                     for details.
36         - ti,clk-output-sel - Muxing option for CLK_OUT pin.  See dt-bindings/net/ti-dp83867.h
37                               for applicable values.  The CLK_OUT pin can also
38                               be disabled by this property.  When omitted, the
39                               PHY's default will be left as is.
40
41 Note: ti,min-output-impedance and ti,max-output-impedance are mutually
42       exclusive. When both properties are present ti,max-output-impedance
43       takes precedence.
44
45 Default child nodes are standard Ethernet PHY device
46 nodes as described in Documentation/devicetree/bindings/net/phy.txt
47
48 Example:
49
50         ethernet-phy@0 {
51                 reg = <0>;
52                 ti,rx-internal-delay = <DP83867_RGMIIDCTL_2_25_NS>;
53                 ti,tx-internal-delay = <DP83867_RGMIIDCTL_2_75_NS>;
54                 ti,fifo-depth = <DP83867_PHYCR_FIFO_DEPTH_4_B_NIB>;
55         };
56
57 Datasheet can be found:
58 http://www.ti.com/product/DP83867IR/datasheet