]> asedeno.scripts.mit.edu Git - linux.git/blob - Documentation/devicetree/bindings/net/ti,dp83867.txt
Linux 5.6-rc7
[linux.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
12 Note: If the interface type is PHY_INTERFACE_MODE_RGMII the TX/RX clock delays
13       will be left at their default values, as set by the PHY's pin strapping.
14       The default strapping will use a delay of 2.00 ns.  Thus
15       PHY_INTERFACE_MODE_RGMII, by default, does not behave as RGMII with no
16       internal delay, but as PHY_INTERFACE_MODE_RGMII_ID.  The device tree
17       should use "rgmii-id" if internal delays are desired as this may be
18       changed in future to cause "rgmii" mode to disable delays.
19
20 Optional property:
21         - ti,min-output-impedance - MAC Interface Impedance control to set
22                                     the programmable output impedance to
23                                     minimum value (35 ohms).
24         - ti,max-output-impedance - MAC Interface Impedance control to set
25                                     the programmable output impedance to
26                                     maximum value (70 ohms).
27         - ti,dp83867-rxctrl-strap-quirk - This denotes the fact that the
28                                     board has RX_DV/RX_CTRL pin strapped in
29                                     mode 1 or 2. To ensure PHY operation,
30                                     there are specific actions that
31                                     software needs to take when this pin is
32                                     strapped in these modes. See data manual
33                                     for details.
34         - ti,clk-output-sel - Muxing option for CLK_OUT pin.  See dt-bindings/net/ti-dp83867.h
35                               for applicable values.  The CLK_OUT pin can also
36                               be disabled by this property.  When omitted, the
37                               PHY's default will be left as is.
38         - ti,sgmii-ref-clock-output-enable - This denotes which
39                                     SGMII configuration is used (4 or 6-wire modes).
40                                     Some MACs work with differential SGMII clock.
41                                     See data manual for details.
42
43         - ti,fifo-depth - Transmitt FIFO depth- see dt-bindings/net/ti-dp83867.h
44                 for applicable values (deprecated)
45
46         -tx-fifo-depth - As defined in the ethernet-controller.yaml.  Values for
47                          the depth can be found in dt-bindings/net/ti-dp83867.h
48         -rx-fifo-depth - As defined in the ethernet-controller.yaml.  Values for
49                          the depth can be found in dt-bindings/net/ti-dp83867.h
50
51 Note: ti,min-output-impedance and ti,max-output-impedance are mutually
52       exclusive. When both properties are present ti,max-output-impedance
53       takes precedence.
54
55 Default child nodes are standard Ethernet PHY device
56 nodes as described in Documentation/devicetree/bindings/net/phy.txt
57
58 Example:
59
60         ethernet-phy@0 {
61                 reg = <0>;
62                 ti,rx-internal-delay = <DP83867_RGMIIDCTL_2_25_NS>;
63                 ti,tx-internal-delay = <DP83867_RGMIIDCTL_2_75_NS>;
64                 tx-fifo-depth = <DP83867_PHYCR_FIFO_DEPTH_4_B_NIB>;
65         };
66
67 Datasheet can be found:
68 http://www.ti.com/product/DP83867IR/datasheet