Documentation/devicetree/bindings/net/ti,dp83822.yaml

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