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>
11description: |+
12  Bindings for USB3 PHY on HiSilicon Kirin 970.
13
14properties:
15  compatible:
16    const: hisilicon,hi3670-usb-phy
17
18  "#phy-cells":
19    const: 0
20
21  hisilicon,pericrg-syscon:
22    $ref: '/schemas/types.yaml#/definitions/phandle'
23    description: phandle of syscon used to control iso refclk.
24
25  hisilicon,pctrl-syscon:
26    $ref: '/schemas/types.yaml#/definitions/phandle'
27    description: phandle of syscon used to control usb tcxo.
28
29  hisilicon,sctrl-syscon:
30    $ref: '/schemas/types.yaml#/definitions/phandle'
31    description: phandle of syscon used to control phy deep sleep.
32
33  hisilicon,eye-diagram-param:
34    $ref: /schemas/types.yaml#/definitions/uint32
35    description: Eye diagram for phy.
36
37  hisilicon,tx-vboost-lvl:
38    $ref: /schemas/types.yaml#/definitions/uint32
39    description: TX level vboost for phy.
40
41required:
42  - compatible
43  - hisilicon,pericrg-syscon
44  - hisilicon,pctrl-syscon
45  - hisilicon,sctrl-syscon
46  - hisilicon,eye-diagram-param
47  - hisilicon,tx-vboost-lvl
48  - "#phy-cells"
49
50additionalProperties: false
51
52examples:
53  - |
54    bus {
55      #address-cells = <2>;
56      #size-cells = <2>;
57
58      usb3_otg_bc: usb3_otg_bc@ff200000 {
59        compatible = "syscon", "simple-mfd";
60        reg = <0x0 0xff200000 0x0 0x1000>;
61
62        usb_phy {
63          compatible = "hisilicon,hi3670-usb-phy";
64          #phy-cells = <0>;
65          hisilicon,pericrg-syscon = <&crg_ctrl>;
66          hisilicon,pctrl-syscon = <&pctrl>;
67          hisilicon,sctrl-syscon = <&sctrl>;
68          hisilicon,eye-diagram-param = <0xfdfee4>;
69          hisilicon,tx-vboost-lvl = <0x5>;
70        };
71      };
72    };
73