xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/net/ti,dp83822.yaml (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun# SPDX-License-Identifier: (GPL-2.0+ OR BSD-2-Clause)
2*4882a593Smuzhiyun# Copyright (C) 2020 Texas Instruments Incorporated
3*4882a593Smuzhiyun%YAML 1.2
4*4882a593Smuzhiyun---
5*4882a593Smuzhiyun$id: "http://devicetree.org/schemas/net/ti,dp83822.yaml#"
6*4882a593Smuzhiyun$schema: "http://devicetree.org/meta-schemas/core.yaml#"
7*4882a593Smuzhiyun
8*4882a593Smuzhiyuntitle: TI DP83822 ethernet PHY
9*4882a593Smuzhiyun
10*4882a593Smuzhiyunmaintainers:
11*4882a593Smuzhiyun  - Dan Murphy <dmurphy@ti.com>
12*4882a593Smuzhiyun
13*4882a593Smuzhiyundescription: |
14*4882a593Smuzhiyun  The DP83822 is a low-power, single-port, 10/100 Mbps Ethernet PHY. It
15*4882a593Smuzhiyun  provides all of the physical layer functions needed to transmit and receive
16*4882a593Smuzhiyun  data over standard, twisted-pair cables or to connect to an external,
17*4882a593Smuzhiyun  fiber-optic transceiver. Additionally, the DP83822 provides flexibility to
18*4882a593Smuzhiyun  connect to a MAC through a standard MII, RMII, or RGMII interface
19*4882a593Smuzhiyun
20*4882a593Smuzhiyun  Specifications about the Ethernet PHY can be found at:
21*4882a593Smuzhiyun    http://www.ti.com/lit/ds/symlink/dp83822i.pdf
22*4882a593Smuzhiyun
23*4882a593SmuzhiyunallOf:
24*4882a593Smuzhiyun  - $ref: "ethernet-phy.yaml#"
25*4882a593Smuzhiyun
26*4882a593Smuzhiyunproperties:
27*4882a593Smuzhiyun  reg:
28*4882a593Smuzhiyun    maxItems: 1
29*4882a593Smuzhiyun
30*4882a593Smuzhiyun  ti,link-loss-low:
31*4882a593Smuzhiyun    type: boolean
32*4882a593Smuzhiyun    description: |
33*4882a593Smuzhiyun       DP83822 PHY in Fiber mode only.
34*4882a593Smuzhiyun       Sets the DP83822 to detect a link drop condition when the signal goes
35*4882a593Smuzhiyun       high.  If not set then link drop will occur when the signal goes low.
36*4882a593Smuzhiyun       This property is only applicable if the fiber mode support is strapped
37*4882a593Smuzhiyun       to on.
38*4882a593Smuzhiyun
39*4882a593Smuzhiyun  ti,fiber-mode:
40*4882a593Smuzhiyun    type: boolean
41*4882a593Smuzhiyun    description: |
42*4882a593Smuzhiyun       DP83822 PHY only.
43*4882a593Smuzhiyun       If present the DP83822 PHY is configured to operate in fiber mode
44*4882a593Smuzhiyun       Fiber mode support can also be strapped. If the strap pin is not set
45*4882a593Smuzhiyun       correctly or not set at all then this boolean can be used to enable it.
46*4882a593Smuzhiyun       If the fiber mode is not strapped then signal detection for the PHY
47*4882a593Smuzhiyun       is disabled.
48*4882a593Smuzhiyun       In fiber mode, auto-negotiation is disabled and the PHY can only work in
49*4882a593Smuzhiyun       100base-fx (full and half duplex) modes.
50*4882a593Smuzhiyun
51*4882a593Smuzhiyun  rx-internal-delay-ps:
52*4882a593Smuzhiyun    description: |
53*4882a593Smuzhiyun       DP83822 PHY only.
54*4882a593Smuzhiyun       Setting this property to a non-zero number sets the RX internal delay
55*4882a593Smuzhiyun       for the PHY.  The internal delay for the PHY is fixed to 3.5ns relative
56*4882a593Smuzhiyun       to receive data.
57*4882a593Smuzhiyun
58*4882a593Smuzhiyun  tx-internal-delay-ps:
59*4882a593Smuzhiyun    description: |
60*4882a593Smuzhiyun       DP83822 PHY only.
61*4882a593Smuzhiyun       Setting this property to a non-zero number sets the TX internal delay
62*4882a593Smuzhiyun       for the PHY.  The internal delay for the PHY is fixed to 3.5ns relative
63*4882a593Smuzhiyun       to transmit data.
64*4882a593Smuzhiyun
65*4882a593Smuzhiyunrequired:
66*4882a593Smuzhiyun  - reg
67*4882a593Smuzhiyun
68*4882a593SmuzhiyununevaluatedProperties: false
69*4882a593Smuzhiyun
70*4882a593Smuzhiyunexamples:
71*4882a593Smuzhiyun  - |
72*4882a593Smuzhiyun    mdio0 {
73*4882a593Smuzhiyun      #address-cells = <1>;
74*4882a593Smuzhiyun      #size-cells = <0>;
75*4882a593Smuzhiyun      ethphy0: ethernet-phy@0 {
76*4882a593Smuzhiyun        reg = <0>;
77*4882a593Smuzhiyun        rx-internal-delay-ps = <1>;
78*4882a593Smuzhiyun        tx-internal-delay-ps = <1>;
79*4882a593Smuzhiyun      };
80*4882a593Smuzhiyun    };
81*4882a593Smuzhiyun
82*4882a593Smuzhiyun...
83