Documentation/devicetree/bindings/usb/nvidia,tegra-xudc.yaml

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: "http://devicetree.org/schemas/usb/nvidia,tegra-xudc.yaml#"
   5 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
   6
   7 title: Device tree binding for NVIDIA Tegra XUSB device mode controller (XUDC)
   8
   9 description:
  10   The Tegra XUDC controller supports both USB 2.0 HighSpeed/FullSpeed and
  11   USB 3.0 SuperSpeed protocols.
  12
  13 maintainers:
  14   - Nagarjuna Kristam <nkristam@nvidia.com>
  15   - JC Kuo <jckuo@nvidia.com>
  16   - Thierry Reding <treding@nvidia.com>
  17
  18 properties:
  19   compatible:
  20     items:
  21       - enum:
  22           - nvidia,tegra210-xudc # For Tegra210
  23           - nvidia,tegra186-xudc # For Tegra186
  24           - nvidia,tegra194-xudc # For Tegra194
  25
  26   reg:
  27     minItems: 2
  28     maxItems: 3
  29     items:
  30       - description: XUSB device controller registers
  31       - description: XUSB device PCI Config registers
  32       - description: XUSB device registers.
  33
  34   reg-names:
  35     minItems: 2
  36     maxItems: 3
  37     items:
  38       - const: base
  39       - const: fpci
  40       - const: ipfs
  41
  42   interrupts:
  43     maxItems: 1
  44     description: Must contain the XUSB device interrupt.
  45
  46   clocks:
  47     minItems: 4
  48     maxItems: 5
  49     items:
  50       - description: Clock to enable core XUSB dev clock.
  51       - description: Clock to enable XUSB super speed clock.
  52       - description: Clock to enable XUSB super speed dev clock.
  53       - description: Clock to enable XUSB high speed dev clock.
  54       - description: Clock to enable XUSB full speed dev clock.
  55
  56   clock-names:
  57     minItems: 4
  58     maxItems: 5
  59     items:
  60       - const: dev
  61       - const: ss
  62       - const: ss_src
  63       - const: fs_src
  64       - const: hs_src
  65
  66   power-domains:
  67     items:
  68       - description: XUSBB(device) power-domain
  69       - description: XUSBA(superspeed) power-domain
  70
  71   power-domain-names:
  72     items:
  73       - const: dev
  74       - const: ss
  75
  76   nvidia,xusb-padctl:
  77     $ref: /schemas/types.yaml#/definitions/phandle-array
  78     description:
  79       phandle to the XUSB pad controller that is used to configure the USB pads
  80       used by the XUDC controller.
  81
  82   phys:
  83     minItems: 1
  84     description:
  85       Must contain an entry for each entry in phy-names.
  86       See ../phy/phy-bindings.txt for details.
  87
  88   phy-names:
  89     minItems: 1
  90     items:
  91       - const: usb2-0
  92       - const: usb2-1
  93       - const: usb2-2
  94       - const: usb2-3
  95       - const: usb3-0
  96       - const: usb3-1
  97       - const: usb3-2
  98       - const: usb3-3
  99
 100   avddio-usb-supply:
 101     description: PCIe/USB3 analog logic power supply. Must supply 1.05 V.
 102
 103   hvdd-usb-supply:
 104     description: USB controller power supply. Must supply 3.3 V.
 105
 106 required:
 107   - compatible
 108   - reg
 109   - reg-names
 110   - interrupts
 111   - clocks
 112   - clock-names
 113   - power-domains
 114   - power-domain-names
 115   - nvidia,xusb-padctl
 116   - phys
 117   - phy-names
 118
 119 allOf:
 120   - if:
 121       properties:
 122         compatible:
 123           contains:
 124             enum:
 125               - nvidia,tegra210-xudc
 126     then:
 127       properties:
 128         reg:
 129           minItems: 3
 130         reg-names:
 131           minItems: 3
 132         clocks:
 133           minItems: 5
 134         clock-names:
 135           minItems: 5
 136       required:
 137         - avddio-usb-supply
 138         - hvdd-usb-supply
 139
 140   - if:
 141       properties:
 142         compatible:
 143           contains:
 144             enum:
 145               - nvidia,tegra186-xudc
 146               - nvidia,tegra194-xudc
 147     then:
 148       properties:
 149         reg:
 150           maxItems: 2
 151         reg-names:
 152           maxItems: 2
 153         clocks:
 154           maxItems: 4
 155         clock-names:
 156           maxItems: 4
 157
 158 additionalProperties: false
 159
 160 examples:
 161   - |
 162     #include <dt-bindings/clock/tegra210-car.h>
 163     #include <dt-bindings/gpio/tegra-gpio.h>
 164     #include <dt-bindings/interrupt-controller/arm-gic.h>
 165
 166     usb@700d0000 {
 167         compatible = "nvidia,tegra210-xudc";
 168         reg = <0x700d0000 0x8000>,
 169               <0x700d8000 0x1000>,
 170               <0x700d9000 0x1000>;
 171         reg-names = "base", "fpci", "ipfs";
 172
 173         interrupts = <GIC_SPI 44 IRQ_TYPE_LEVEL_HIGH>;
 174
 175         clocks = <&tegra_car TEGRA210_CLK_XUSB_DEV>,
 176                  <&tegra_car TEGRA210_CLK_XUSB_SS>,
 177                  <&tegra_car TEGRA210_CLK_XUSB_SSP_SRC>,
 178                  <&tegra_car TEGRA210_CLK_XUSB_FS_SRC>,
 179                  <&tegra_car TEGRA210_CLK_XUSB_HS_SRC>;
 180         clock-names = "dev", "ss", "ss_src", "fs_src", "hs_src";
 181
 182         power-domains = <&pd_xusbdev>, <&pd_xusbss>;
 183         power-domain-names = "dev", "ss";
 184
 185         nvidia,xusb-padctl = <&padctl>;
 186
 187         phys = <&micro_b>;
 188         phy-names = "usb2-0";
 189
 190         avddio-usb-supply = <&vdd_pex_1v05>;
 191         hvdd-usb-supply = <&vdd_3v3_sys>;
 192     };