xref: /openbmc/linux/Documentation/devicetree/bindings/net/ti,dp83822.yaml (revision 1ac731c529cd4d6adbce134754b51ff7d822b145)
17a63d769SDan Murphy# SPDX-License-Identifier: (GPL-2.0+ OR BSD-2-Clause)
27a63d769SDan Murphy# Copyright (C) 2020 Texas Instruments Incorporated
37a63d769SDan Murphy%YAML 1.2
47a63d769SDan Murphy---
5*3079bfdbSRob Herring$id: http://devicetree.org/schemas/net/ti,dp83822.yaml#
6*3079bfdbSRob Herring$schema: http://devicetree.org/meta-schemas/core.yaml#
77a63d769SDan Murphy
87a63d769SDan Murphytitle: TI DP83822 ethernet PHY
97a63d769SDan Murphy
107a63d769SDan Murphymaintainers:
1107d1caa4SKrzysztof Kozlowski  - Andrew Davis <afd@ti.com>
127a63d769SDan Murphy
137a63d769SDan Murphydescription: |
147a63d769SDan Murphy  The DP83822 is a low-power, single-port, 10/100 Mbps Ethernet PHY. It
157a63d769SDan Murphy  provides all of the physical layer functions needed to transmit and receive
167a63d769SDan Murphy  data over standard, twisted-pair cables or to connect to an external,
177a63d769SDan Murphy  fiber-optic transceiver. Additionally, the DP83822 provides flexibility to
187a63d769SDan Murphy  connect to a MAC through a standard MII, RMII, or RGMII interface
197a63d769SDan Murphy
207a63d769SDan Murphy  Specifications about the Ethernet PHY can be found at:
217a63d769SDan Murphy    http://www.ti.com/lit/ds/symlink/dp83822i.pdf
227a63d769SDan Murphy
237a63d769SDan MurphyallOf:
24*3079bfdbSRob Herring  - $ref: ethernet-phy.yaml#
257a63d769SDan Murphy
267a63d769SDan Murphyproperties:
277a63d769SDan Murphy  reg:
287a63d769SDan Murphy    maxItems: 1
297a63d769SDan Murphy
307a63d769SDan Murphy  ti,link-loss-low:
317a63d769SDan Murphy    type: boolean
327a63d769SDan Murphy    description: |
337a63d769SDan Murphy       DP83822 PHY in Fiber mode only.
347a63d769SDan Murphy       Sets the DP83822 to detect a link drop condition when the signal goes
357a63d769SDan Murphy       high.  If not set then link drop will occur when the signal goes low.
367a63d769SDan Murphy       This property is only applicable if the fiber mode support is strapped
377a63d769SDan Murphy       to on.
387a63d769SDan Murphy
397a63d769SDan Murphy  ti,fiber-mode:
407a63d769SDan Murphy    type: boolean
417a63d769SDan Murphy    description: |
427a63d769SDan Murphy       DP83822 PHY only.
437a63d769SDan Murphy       If present the DP83822 PHY is configured to operate in fiber mode
447a63d769SDan Murphy       Fiber mode support can also be strapped. If the strap pin is not set
457a63d769SDan Murphy       correctly or not set at all then this boolean can be used to enable it.
467a63d769SDan Murphy       If the fiber mode is not strapped then signal detection for the PHY
477a63d769SDan Murphy       is disabled.
487a63d769SDan Murphy       In fiber mode, auto-negotiation is disabled and the PHY can only work in
497a63d769SDan Murphy       100base-fx (full and half duplex) modes.
507a63d769SDan Murphy
517a63d769SDan Murphy  rx-internal-delay-ps:
527a63d769SDan Murphy    description: |
537a63d769SDan Murphy       DP83822 PHY only.
547a63d769SDan Murphy       Setting this property to a non-zero number sets the RX internal delay
557a63d769SDan Murphy       for the PHY.  The internal delay for the PHY is fixed to 3.5ns relative
567a63d769SDan Murphy       to receive data.
577a63d769SDan Murphy
587a63d769SDan Murphy  tx-internal-delay-ps:
597a63d769SDan Murphy    description: |
607a63d769SDan Murphy       DP83822 PHY only.
617a63d769SDan Murphy       Setting this property to a non-zero number sets the TX internal delay
627a63d769SDan Murphy       for the PHY.  The internal delay for the PHY is fixed to 3.5ns relative
637a63d769SDan Murphy       to transmit data.
647a63d769SDan Murphy
657a63d769SDan Murphyrequired:
667a63d769SDan Murphy  - reg
677a63d769SDan Murphy
68f84e2c5cSRob HerringunevaluatedProperties: false
69f84e2c5cSRob Herring
707a63d769SDan Murphyexamples:
717a63d769SDan Murphy  - |
727a63d769SDan Murphy    mdio0 {
737a63d769SDan Murphy      #address-cells = <1>;
747a63d769SDan Murphy      #size-cells = <0>;
757a63d769SDan Murphy      ethphy0: ethernet-phy@0 {
767a63d769SDan Murphy        reg = <0>;
777a63d769SDan Murphy        rx-internal-delay-ps = <1>;
787a63d769SDan Murphy        tx-internal-delay-ps = <1>;
797a63d769SDan Murphy      };
807a63d769SDan Murphy    };
817a63d769SDan Murphy
827a63d769SDan Murphy...
83