Documentation/devicetree/bindings/phy/fsl,imx8mq-usb-phy.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/phy/fsl,imx8mq-usb-phy.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Freescale i.MX8MQ USB3 PHY
   8
   9 maintainers:
  10   - Li Jun <jun.li@nxp.com>
  11
  12 properties:
  13   compatible:
  14     oneOf:
  15       - enum:
  16           - fsl,imx8mq-usb-phy
  17           - fsl,imx8mp-usb-phy
  18       - items:
  19           - const: fsl,imx95-usb-phy
  20           - const: fsl,imx8mp-usb-phy
  21
  22   reg:
  23     minItems: 1
  24     maxItems: 2
  25
  26   "#phy-cells":
  27     const: 0
  28
  29   clocks:
  30     maxItems: 1
  31
  32   clock-names:
  33     items:
  34       - const: phy
  35
  36   power-domains:
  37     maxItems: 1
  38
  39   vbus-supply:
  40     description:
  41       A phandle to the regulator for USB VBUS.
  42
  43   fsl,phy-tx-vref-tune-percent:
  44     description:
  45       Tunes the HS DC level relative to the nominal level
  46     minimum: 94
  47     maximum: 124
  48
  49   fsl,phy-tx-rise-tune-percent:
  50     description:
  51       Adjusts the rise/fall time duration of the HS waveform relative to
  52       its nominal value
  53     minimum: 97
  54     maximum: 103
  55
  56   fsl,phy-tx-preemp-amp-tune-microamp:
  57     description:
  58       Adjust amount of current sourced to DPn and DMn after a J-to-K
  59       or K-to-J transition. Default is 0 (disabled).
  60     minimum: 0
  61     maximum: 1800
  62
  63   fsl,phy-tx-vboost-level-microvolt:
  64     description:
  65       Adjust the boosted transmit launch pk-pk differential amplitude
  66     minimum: 880
  67     maximum: 1120
  68
  69   fsl,phy-comp-dis-tune-percent:
  70     description:
  71       Adjust the voltage level used to detect a disconnect event at the host
  72       relative to the nominal value
  73     minimum: 91
  74     maximum: 115
  75
  76   fsl,phy-pcs-tx-deemph-3p5db-attenuation-db:
  77     description:
  78       Adjust TX de-emphasis attenuation in dB at nominal
  79       3.5dB point as per USB specification
  80     $ref: /schemas/types.yaml#/definitions/uint32
  81     minimum: 0
  82     maximum: 36
  83
  84   fsl,phy-pcs-tx-swing-full-percent:
  85     description:
  86       Scaling of the voltage defined by fsl,phy-tx-vboost-level-microvolt
  87     minimum: 0
  88     maximum: 100
  89
  90 required:
  91   - compatible
  92   - reg
  93   - "#phy-cells"
  94   - clocks
  95   - clock-names
  96
  97 allOf:
  98   - if:
  99       properties:
 100         compatible:
 101           contains:
 102             enum:
 103               - fsl,imx95-usb-phy
 104     then:
 105       properties:
 106         reg:
 107           items:
 108             - description: USB PHY Control range
 109             - description: USB PHY TCA Block range
 110     else:
 111       properties:
 112         reg:
 113           maxItems: 1
 114
 115   - if:
 116       required:
 117         - orientation-switch
 118     then:
 119       $ref: /schemas/usb/usb-switch.yaml#
 120
 121 unevaluatedProperties: false
 122
 123 examples:
 124   - |
 125     #include <dt-bindings/clock/imx8mq-clock.h>
 126     usb3_phy0: phy@381f0040 {
 127         compatible = "fsl,imx8mq-usb-phy";
 128         reg = <0x381f0040 0x40>;
 129         clocks = <&clk IMX8MQ_CLK_USB1_PHY_ROOT>;
 130         clock-names = "phy";
 131         #phy-cells = <0>;
 132     };