transmit-amplitude.yaml

  1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/phy/transmit-amplitude.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Common PHY and network PCS transmit amplitude property
  8
  9description:
 10  Binding describing the peak-to-peak transmit amplitude for common PHYs
 11  and network PCSes.
 12
 13maintainers:
 14  - Marek Behún <kabel@kernel.org>
 15
 16properties:
 17  tx-p2p-microvolt:
 18    description:
 19      Transmit amplitude voltages in microvolts, peak-to-peak. If this property
 20      contains multiple values for various PHY modes, the
 21      'tx-p2p-microvolt-names' property must be provided and contain
 22      corresponding mode names.
 23
 24  tx-p2p-microvolt-names:
 25    description: |
 26      Names of the modes corresponding to voltages in the 'tx-p2p-microvolt'
 27      property. Required only if multiple voltages are provided.
 28
 29      If a value of 'default' is provided, the system should use it for any PHY
 30      mode that is otherwise not defined here. If 'default' is not provided, the
 31      system should use manufacturer default value.
 32    minItems: 1
 33    maxItems: 16
 34    items:
 35      enum:
 36        - default
 37
 38        # ethernet modes
 39        - sgmii
 40        - qsgmii
 41        - xgmii
 42        - 1000base-x
 43        - 2500base-x
 44        - 5gbase-r
 45        - rxaui
 46        - xaui
 47        - 10gbase-kr
 48        - usxgmii
 49        - 10gbase-r
 50        - 25gbase-r
 51
 52        # PCIe modes
 53        - pcie
 54        - pcie1
 55        - pcie2
 56        - pcie3
 57        - pcie4
 58        - pcie5
 59        - pcie6
 60
 61        # USB modes
 62        - usb
 63        - usb-ls
 64        - usb-fs
 65        - usb-hs
 66        - usb-ss
 67        - usb-ss+
 68        - usb-4
 69
 70        # storage modes
 71        - sata
 72        - ufs-hs
 73        - ufs-hs-a
 74        - ufs-hs-b
 75
 76        # display modes
 77        - lvds
 78        - dp
 79        - dp-rbr
 80        - dp-hbr
 81        - dp-hbr2
 82        - dp-hbr3
 83        - dp-uhbr-10
 84        - dp-uhbr-13.5
 85        - dp-uhbr-20
 86
 87        # camera modes
 88        - mipi-dphy
 89        - mipi-dphy-univ
 90        - mipi-dphy-v2.5-univ
 91
 92dependencies:
 93  tx-p2p-microvolt-names: [ tx-p2p-microvolt ]
 94
 95additionalProperties: true
 96
 97examples:
 98  - |
 99    phy: phy {
100      #phy-cells = <1>;
101      tx-p2p-microvolt = <915000>, <1100000>, <1200000>;
102      tx-p2p-microvolt-names = "2500base-x", "usb-hs", "usb-ss";
103    };