1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/phy/qcom,usb-snps-femto-v2.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Qualcomm Synopsys Femto High-Speed USB PHY V2
8
9maintainers:
10  - Wesley Cheng <quic_wcheng@quicinc.com>
11
12description: |
13  Qualcomm High-Speed USB PHY
14
15properties:
16  compatible:
17    oneOf:
18      - items:
19          - enum:
20              - qcom,sa8775p-usb-hs-phy
21              - qcom,sc8280xp-usb-hs-phy
22          - const: qcom,usb-snps-hs-5nm-phy
23      - items:
24          - enum:
25              - qcom,sc7280-usb-hs-phy
26              - qcom,sc8180x-usb-hs-phy
27              - qcom,sdx55-usb-hs-phy
28              - qcom,sdx65-usb-hs-phy
29              - qcom,sm6375-usb-hs-phy
30              - qcom,sm8150-usb-hs-phy
31              - qcom,sm8250-usb-hs-phy
32              - qcom,sm8350-usb-hs-phy
33              - qcom,sm8450-usb-hs-phy
34          - const: qcom,usb-snps-hs-7nm-phy
35
36  reg:
37    maxItems: 1
38
39  "#phy-cells":
40    const: 0
41
42  clocks:
43    items:
44      - description: rpmhcc ref clock
45
46  clock-names:
47    items:
48      - const: ref
49
50  resets:
51    items:
52      - description: PHY core reset
53
54  vdda-pll-supply:
55    description: phandle to the regulator VDD supply node.
56
57  vdda18-supply:
58    description: phandle to the regulator 1.8V supply node.
59
60  vdda33-supply:
61    description: phandle to the regulator 3.3V supply node.
62
63  qcom,hs-disconnect-bp:
64    description:
65      This adjusts the voltage level for the threshold used to
66      detect a disconnect event at the host.
67      The hardware accepts only discrete values. The value closest to the
68      provided input will be chosen as the override value for this param.
69    minimum: -272
70    maximum: 2156
71
72  qcom,squelch-detector-bp:
73    description:
74      This adjusts the voltage level for the threshold used to
75      detect valid high-speed data.
76      The hardware accepts only discrete values. The value closest to the
77      provided input will be chosen as the override value for this param.
78    minimum: -2090
79    maximum: 1590
80
81  qcom,hs-amplitude-bp:
82    description:
83      This adjusts the high-speed DC level voltage.
84      The hardware accepts only discrete values. The value closest to the
85      provided input will be chosen as the override value for this param.
86    minimum: -660
87    maximum: 2670
88
89  qcom,pre-emphasis-duration-bp:
90    description:
91      This signal controls the duration for which the
92      HS pre-emphasis current is sourced onto DP<#> or DM<#>.
93      The HS Transmitter pre-emphasis duration is defined in terms of
94      unit amounts. One unit of pre-emphasis duration is approximately
95      650 ps and is defined as 1X pre-emphasis duration.
96      The hardware accepts only discrete values. The value closest to the
97      provided input will be chosen as the override value for this param.
98    minimum: 10000
99    maximum: 20000
100
101  qcom,pre-emphasis-amplitude-bp:
102    description:
103      This signal controls the amount of current sourced to
104      DP<#> and DM<#> after a J-to-K or K-to-J transition.
105      The HS Transmitter pre-emphasis current is defined in terms of unit
106      amounts. One unit amount is approximately 2 mA and is defined as
107      1X pre-emphasis current.
108      The hardware accepts only discrete values. The value closest to the
109      provided input will be chosen as the override value for this param.
110    minimum: 10000
111    maximum: 40000
112
113  qcom,hs-rise-fall-time-bp:
114    description:
115      This adjusts the rise/fall times of the high-speed waveform.
116      The hardware accepts only discrete values. The value closest to the
117      provided input will be chosen as the override value for this param.
118    minimum: -4100
119    maximum: 5430
120
121  qcom,hs-crossover-voltage-microvolt:
122    description:
123      This adjusts the voltage at which the DP<#> and DM<#>
124      signals cross while transmitting in HS mode.
125      The hardware accepts only discrete values. The value closest to the
126      provided input will be chosen as the override value for this param.
127    minimum: -31000
128    maximum: 28000
129
130  qcom,hs-output-impedance-micro-ohms:
131    description:
132      In some applications, there can be significant series resistance
133      on the D+ and D- paths between the transceiver and cable. This adjusts
134      the driver source impedance to compensate for added series
135      resistance on the USB. The hardware accepts only discrete values. The
136      value closest to the provided input will be chosen as the override value
137      for this param.
138    minimum: -2300000
139    maximum: 6100000
140
141  qcom,ls-fs-output-impedance-bp:
142    description:
143      This adjusts the low- and full-speed single-ended source
144      impedance while driving high. The following adjustment values are based
145      on nominal process, voltage, and temperature.
146      The hardware accepts only discrete values. The value closest to the
147      provided input will be chosen as the override value for this param.
148    minimum: -1053
149    maximum: 1310
150
151required:
152  - compatible
153  - reg
154  - "#phy-cells"
155  - clocks
156  - clock-names
157  - resets
158  - vdda-pll-supply
159  - vdda18-supply
160  - vdda33-supply
161
162additionalProperties: false
163
164examples:
165  - |
166    #include <dt-bindings/clock/qcom,rpmh.h>
167    #include <dt-bindings/clock/qcom,gcc-sm8150.h>
168    phy@88e2000 {
169        compatible = "qcom,sm8150-usb-hs-phy", "qcom,usb-snps-hs-7nm-phy";
170        reg = <0x088e2000 0x400>;
171        #phy-cells = <0>;
172
173        clocks = <&rpmhcc RPMH_CXO_CLK>;
174        clock-names = "ref";
175
176        resets = <&gcc GCC_QUSB2PHY_PRIM_BCR>;
177
178        vdda-pll-supply = <&vdd_usb_hs_core>;
179        vdda33-supply = <&vdda_usb_hs_3p1>;
180        vdda18-supply = <&vdda_usb_hs_1p8>;
181    };
182...
183