Documentation/devicetree/bindings/phy/hisilicon,hi3670-usb3.yaml

   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
   7 title: Hisilicon Kirin970 USB PHY
   8
   9 maintainers:
  10   - Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
  11
  12 description: |+
  13   Bindings for USB3 PHY on HiSilicon Kirin 970.
  14
  15 properties:
  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
  42 required:
  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
  51 additionalProperties: false
  52
  53 examples:
  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     };