1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/phy/hisilicon,hi3670-usb3.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Hisilicon Kirin970 USB PHY
8
9maintainers:
10  - Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
11
12description: |+
13  Bindings for USB3 PHY on HiSilicon Kirin 970.
14
15properties:
16  compatible:
17    const: hisilicon,hi3670-usb-phy
18
19  "#phy-cells":
20    const: 0
21
22  hisilicon,pericrg-syscon:
23    $ref: '/schemas/types.yaml#/definitions/phandle'
24    description: phandle of syscon used to control iso refclk.
25
26  hisilicon,pctrl-syscon:
27    $ref: '/schemas/types.yaml#/definitions/phandle'
28    description: phandle of syscon used to control usb tcxo.
29
30  hisilicon,sctrl-syscon:
31    $ref: '/schemas/types.yaml#/definitions/phandle'
32    description: phandle of syscon used to control phy deep sleep.
33
34  hisilicon,eye-diagram-param:
35    $ref: /schemas/types.yaml#/definitions/uint32
36    description: Eye diagram for phy.
37
38  hisilicon,tx-vboost-lvl:
39    $ref: /schemas/types.yaml#/definitions/uint32
40    description: TX level vboost for phy.
41
42required:
43  - compatible
44  - hisilicon,pericrg-syscon
45  - hisilicon,pctrl-syscon
46  - hisilicon,sctrl-syscon
47  - hisilicon,eye-diagram-param
48  - hisilicon,tx-vboost-lvl
49  - "#phy-cells"
50
51additionalProperties: false
52
53examples:
54  - |
55    bus {
56      #address-cells = <2>;
57      #size-cells = <2>;
58
59      usb3_otg_bc: usb3_otg_bc@ff200000 {
60        compatible = "syscon", "simple-mfd";
61        reg = <0x0 0xff200000 0x0 0x1000>;
62
63        usb_phy {
64          compatible = "hisilicon,hi3670-usb-phy";
65          #phy-cells = <0>;
66          hisilicon,pericrg-syscon = <&crg_ctrl>;
67          hisilicon,pctrl-syscon = <&pctrl>;
68          hisilicon,sctrl-syscon = <&sctrl>;
69          hisilicon,eye-diagram-param = <0xfdfee4>;
70          hisilicon,tx-vboost-lvl = <0x5>;
71        };
72      };
73    };
74