bindings/phy/transmit-amplitude.yaml

0001 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
0002 %YAML 1.2
0003 ---
0004 $id: http://devicetree.org/schemas/phy/transmit-amplitude.yaml#
0005 $schema: http://devicetree.org/meta-schemas/core.yaml#
0006
0007 title: Common PHY and network PCS transmit amplitude property binding
0008
0009 description:
0010   Binding describing the peak-to-peak transmit amplitude for common PHYs
0011   and network PCSes.
0012
0013 maintainers:
0014   - Marek Behún <kabel@kernel.org>
0015
0016 properties:
0017   tx-p2p-microvolt:
0018     description:
0019       Transmit amplitude voltages in microvolts, peak-to-peak. If this property
0020       contains multiple values for various PHY modes, the
0021       'tx-p2p-microvolt-names' property must be provided and contain
0022       corresponding mode names.
0023
0024   tx-p2p-microvolt-names:
0025     description: |
0026       Names of the modes corresponding to voltages in the 'tx-p2p-microvolt'
0027       property. Required only if multiple voltages are provided.
0028
0029       If a value of 'default' is provided, the system should use it for any PHY
0030       mode that is otherwise not defined here. If 'default' is not provided, the
0031       system should use manufacturer default value.
0032     minItems: 1
0033     maxItems: 16
0034     items:
0035       enum:
0036         - default
0037
0038         # ethernet modes
0039         - sgmii
0040         - qsgmii
0041         - xgmii
0042         - 1000base-x
0043         - 2500base-x
0044         - 5gbase-r
0045         - rxaui
0046         - xaui
0047         - 10gbase-kr
0048         - usxgmii
0049         - 10gbase-r
0050         - 25gbase-r
0051
0052         # PCIe modes
0053         - pcie
0054         - pcie1
0055         - pcie2
0056         - pcie3
0057         - pcie4
0058         - pcie5
0059         - pcie6
0060
0061         # USB modes
0062         - usb
0063         - usb-ls
0064         - usb-fs
0065         - usb-hs
0066         - usb-ss
0067         - usb-ss+
0068         - usb-4
0069
0070         # storage modes
0071         - sata
0072         - ufs-hs
0073         - ufs-hs-a
0074         - ufs-hs-b
0075
0076         # display modes
0077         - lvds
0078         - dp
0079         - dp-rbr
0080         - dp-hbr
0081         - dp-hbr2
0082         - dp-hbr3
0083         - dp-uhbr-10
0084         - dp-uhbr-13.5
0085         - dp-uhbr-20
0086
0087         # camera modes
0088         - mipi-dphy
0089         - mipi-dphy-univ
0090         - mipi-dphy-v2.5-univ
0091
0092 dependencies:
0093   tx-p2p-microvolt-names: [ tx-p2p-microvolt ]
0094
0095 additionalProperties: true
0096
0097 examples:
0098   - |
0099     phy: phy {
0100       #phy-cells = <1>;
0101       tx-p2p-microvolt = <915000>, <1100000>, <1200000>;
0102       tx-p2p-microvolt-names = "2500base-x", "usb-hs", "usb-ss";
0103     };