xref: /freebsd/sys/contrib/device-tree/Bindings/phy/transmit-amplitude.yaml (revision d0b2dbfa0ecf2bbc9709efc5e20baf8e4b44bbbf) 
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    };
104