| # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause |
| %YAML 1.2 |
| --- |
| $id: http://devicetree.org/schemas/phy/nvidia,tegra124-xusb-padctl.yaml# |
| $schema: http://devicetree.org/meta-schemas/core.yaml# |
| |
| title: NVIDIA Tegra124 XUSB pad controller |
| |
| maintainers: |
| - Thierry Reding <thierry.reding@gmail.com> |
| - Jon Hunter <jonathanh@nvidia.com> |
| |
| description: | |
| The Tegra XUSB pad controller manages a set of I/O lanes (with differential |
| signals) which connect directly to pins/pads on the SoC package. Each lane |
| is controlled by a HW block referred to as a "pad" in the Tegra hardware |
| documentation. Each such "pad" may control either one or multiple lanes, |
| and thus contains any logic common to all its lanes. Each lane can be |
| separately configured and powered up. |
| |
| Some of the lanes are high-speed lanes, which can be used for PCIe, SATA or |
| super-speed USB. Other lanes are for various types of low-speed, full-speed |
| or high-speed USB (such as UTMI, ULPI and HSIC). The XUSB pad controller |
| contains a software-configurable mux that sits between the I/O controller |
| ports (e.g. PCIe) and the lanes. |
| |
| In addition to per-lane configuration, USB 3.0 ports may require additional |
| settings on a per-board basis. |
| |
| Pads will be represented as children of the top-level XUSB pad controller |
| device tree node. Each lane exposed by the pad will be represented by its |
| own subnode and can be referenced by users of the lane using the standard |
| PHY bindings, as described by the phy-bindings.txt file in this directory. |
| |
| The Tegra hardware documentation refers to the connection between the XUSB |
| pad controller and the XUSB controller as "ports". This is confusing since |
| "port" is typically used to denote the physical USB receptacle. The device |
| tree binding in this document uses the term "port" to refer to the logical |
| abstraction of the signals that are routed to a USB receptacle (i.e. a PHY |
| for the USB signal, the VBUS power supply, the USB 2.0 companion port for |
| USB 3.0 receptacles, ...). |
| |
| properties: |
| compatible: |
| oneOf: |
| - enum: |
| - nvidia,tegra124-xusb-padctl |
| |
| - items: |
| - const: nvidia,tegra132-xusb-padctl |
| - const: nvidia,tegra124-xusb-padctl |
| |
| reg: |
| maxItems: 1 |
| |
| interrupts: |
| items: |
| - description: XUSB pad controller interrupt |
| |
| resets: |
| items: |
| - description: pad controller reset |
| |
| reset-names: |
| items: |
| - const: padctl |
| |
| avdd-pll-utmip-supply: |
| description: UTMI PLL power supply. Must supply 1.8 V. |
| |
| avdd-pll-erefe-supply: |
| description: PLLE reference PLL power supply. Must supply 1.05 V. |
| |
| avdd-pex-pll-supply: |
| description: PCIe/USB3 PLL power supply. Must supply 1.05 V. |
| |
| hvdd-pex-pll-e-supply: |
| description: High-voltage PLLE power supply. Must supply 3.3 V. |
| |
| pads: |
| description: A required child node named "pads" contains a list of |
| subnodes, one for each of the pads exposed by the XUSB pad controller. |
| Each pad may need additional resources that can be referenced in its |
| pad node. |
| |
| The "status" property is used to enable or disable the use of a pad. |
| If set to "disabled", the pad will not be used on the given board. In |
| order to use the pad and any of its lanes, this property must be set |
| to "okay" or be absent. |
| type: object |
| additionalProperties: false |
| properties: |
| usb2: |
| type: object |
| additionalProperties: false |
| properties: |
| clocks: |
| items: |
| - description: USB2 tracking clock |
| |
| clock-names: |
| items: |
| - const: trk |
| |
| lanes: |
| type: object |
| additionalProperties: false |
| properties: |
| usb2-0: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ snps, xusb, uart ] |
| |
| usb2-1: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ snps, xusb, uart ] |
| |
| usb2-2: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ snps, xusb, uart ] |
| |
| ulpi: |
| type: object |
| additionalProperties: false |
| properties: |
| lanes: |
| type: object |
| additionalProperties: false |
| properties: |
| ulpi-0: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ snps, xusb ] |
| |
| hsic: |
| type: object |
| additionalProperties: false |
| properties: |
| clocks: |
| items: |
| - description: HSIC tracking clock |
| |
| clock-names: |
| items: |
| - const: trk |
| |
| lanes: |
| type: object |
| additionalProperties: false |
| properties: |
| hsic-0: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ snps, xusb ] |
| |
| hsic-1: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ snps, xusb ] |
| |
| pcie: |
| type: object |
| additionalProperties: false |
| properties: |
| clocks: |
| items: |
| - description: PLLE clock |
| |
| clock-names: |
| items: |
| - const: pll |
| |
| resets: |
| items: |
| - description: reset for the PCIe UPHY block |
| |
| reset-names: |
| items: |
| - const: phy |
| |
| lanes: |
| type: object |
| additionalProperties: false |
| properties: |
| pcie-0: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ pcie, usb3-ss ] |
| |
| pcie-1: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ pcie, usb3-ss ] |
| |
| pcie-2: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ pcie, usb3-ss ] |
| |
| pcie-3: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ pcie, usb3-ss ] |
| |
| pcie-4: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ pcie, usb3-ss ] |
| |
| sata: |
| type: object |
| additionalProperties: false |
| properties: |
| resets: |
| items: |
| - description: reset for the SATA UPHY block |
| |
| reset-names: |
| items: |
| - const: phy |
| |
| lanes: |
| type: object |
| additionalProperties: false |
| properties: |
| sata-0: |
| type: object |
| additionalProperties: false |
| properties: |
| "#phy-cells": |
| const: 0 |
| |
| nvidia,function: |
| description: Function selection for this lane. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ sata, usb3-ss ] |
| |
| ports: |
| description: A required child node named "ports" contains a list of |
| subnodes, one for each of the ports exposed by the XUSB pad controller. |
| Each port may need additional resources that can be referenced in its |
| port node. |
| |
| The "status" property is used to enable or disable the use of a port. |
| If set to "disabled", the port will not be used on the given board. In |
| order to use the port, this property must be set to "okay". |
| type: object |
| additionalProperties: false |
| properties: |
| usb2-0: |
| type: object |
| additionalProperties: false |
| properties: |
| # no need to further describe this because the connector will |
| # match on gpio-usb-b-connector or usb-b-connector and cause |
| # that binding to be selected for the subnode |
| connector: |
| type: object |
| |
| mode: |
| description: A string that determines the mode in which to |
| run the port. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ host, peripheral, otg ] |
| |
| nvidia,internal: |
| description: A boolean property whose presence determines |
| that a port is internal. In the absence of this property |
| the port is considered to be external. |
| $ref: /schemas/types.yaml#/definitions/flag |
| |
| usb-role-switch: |
| description: | |
| A boolean property whole presence indicates that the port |
| supports OTG or peripheral mode. If present, the port |
| supports switching between USB host and peripheral roles. |
| A connector must be added as a subnode in that case. |
| |
| See ../connector/usb-connector.yaml. |
| |
| vbus-supply: |
| description: A phandle to the regulator supplying the VBUS |
| voltage. |
| |
| usb2-1: |
| type: object |
| additionalProperties: false |
| properties: |
| # no need to further describe this because the connector will |
| # match on gpio-usb-b-connector or usb-b-connector and cause |
| # that binding to be selected for the subnode |
| connector: |
| type: object |
| |
| mode: |
| description: A string that determines the mode in which to |
| run the port. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ host, peripheral, otg ] |
| |
| nvidia,internal: |
| description: A boolean property whose presence determines |
| that a port is internal. In the absence of this property |
| the port is considered to be external. |
| $ref: /schemas/types.yaml#/definitions/flag |
| |
| usb-role-switch: |
| description: | |
| A boolean property whole presence indicates that the port |
| supports OTG or peripheral mode. If present, the port |
| supports switching between USB host and peripheral roles. |
| A connector must be added as a subnode in that case. |
| |
| See ../connector/usb-connector.yaml. |
| |
| vbus-supply: |
| description: A phandle to the regulator supplying the VBUS |
| voltage. |
| |
| usb2-2: |
| type: object |
| additionalProperties: false |
| properties: |
| # no need to further describe this because the connector will |
| # match on gpio-usb-b-connector or usb-b-connector and cause |
| # that binding to be selected for the subnode |
| connector: |
| type: object |
| |
| mode: |
| description: A string that determines the mode in which to |
| run the port. |
| $ref: /schemas/types.yaml#/definitions/string |
| enum: [ host, peripheral, otg ] |
| |
| nvidia,internal: |
| description: A boolean property whose presence determines |
| that a port is internal. In the absence of this property |
| the port is considered to be external. |
| $ref: /schemas/types.yaml#/definitions/flag |
| |
| usb-role-switch: |
| description: | |
| A boolean property whole presence indicates that the port |
| supports OTG or peripheral mode. If present, the port |
| supports switching between USB host and peripheral roles. |
| A connector must be added as a subnode in that case. |
| |
| See ../connector/usb-connector.yaml. |
| |
| vbus-supply: |
| description: A phandle to the regulator supplying the VBUS |
| voltage. |
| |
| ulpi-0: |
| type: object |
| additionalProperties: false |
| properties: |
| nvidia,internal: |
| description: A boolean property whose presence determines |
| that a port is internal. In the absence of this property |
| the port is considered to be external. |
| $ref: /schemas/types.yaml#/definitions/flag |
| |
| vbus-supply: |
| description: A phandle to the regulator supplying the VBUS |
| voltage. |
| |
| hsic-0: |
| type: object |
| additionalProperties: false |
| properties: |
| vbus-supply: |
| description: A phandle to the regulator supplying the VBUS |
| voltage. |
| |
| hsic-1: |
| type: object |
| additionalProperties: false |
| properties: |
| vbus-supply: |
| description: A phandle to the regulator supplying the VBUS |
| voltage. |
| |
| usb3-0: |
| type: object |
| additionalProperties: false |
| properties: |
| nvidia,internal: |
| description: A boolean property whose presence determines |
| that a port is internal. In the absence of this property |
| the port is considered to be external. |
| $ref: /schemas/types.yaml#/definitions/flag |
| |
| nvidia,usb2-companion: |
| description: A single cell that specifies the physical port |
| number to map this super-speed USB port to. The range of |
| valid port numbers varies with the SoC generation. |
| $ref: /schemas/types.yaml#/definitions/uint32 |
| enum: [ 0, 1, 2 ] |
| |
| vbus-supply: |
| description: A phandle to the regulator supplying the VBUS |
| voltage. |
| |
| usb3-1: |
| type: object |
| additionalProperties: false |
| properties: |
| nvidia,internal: |
| description: A boolean property whose presence determines |
| that a port is internal. In the absence of this property |
| the port is considered to be external. |
| $ref: /schemas/types.yaml#/definitions/flag |
| |
| nvidia,usb2-companion: |
| description: A single cell that specifies the physical port |
| number to map this super-speed USB port to. The range of |
| valid port numbers varies with the SoC generation. |
| $ref: /schemas/types.yaml#/definitions/uint32 |
| enum: [ 0, 1, 2 ] |
| |
| vbus-supply: |
| description: A phandle to the regulator supplying the VBUS |
| voltage. |
| |
| additionalProperties: false |
| |
| required: |
| - compatible |
| - reg |
| - resets |
| - reset-names |
| - avdd-pll-utmip-supply |
| - avdd-pll-erefe-supply |
| - avdd-pex-pll-supply |
| - hvdd-pex-pll-e-supply |
| |
| examples: |
| # Tegra124 and Tegra132 |
| - | |
| #include <dt-bindings/interrupt-controller/arm-gic.h> |
| |
| padctl@7009f000 { |
| compatible = "nvidia,tegra124-xusb-padctl"; |
| reg = <0x7009f000 0x1000>; |
| interrupts = <GIC_SPI 20 IRQ_TYPE_LEVEL_HIGH>; |
| resets = <&tegra_car 142>; |
| reset-names = "padctl"; |
| |
| avdd-pll-utmip-supply = <&vddio_1v8>; |
| avdd-pll-erefe-supply = <&avdd_1v05_run>; |
| avdd-pex-pll-supply = <&vdd_1v05_run>; |
| hvdd-pex-pll-e-supply = <&vdd_3v3_lp0>; |
| |
| pads { |
| usb2 { |
| lanes { |
| usb2-0 { |
| nvidia,function = "xusb"; |
| #phy-cells = <0>; |
| }; |
| |
| usb2-1 { |
| nvidia,function = "xusb"; |
| #phy-cells = <0>; |
| }; |
| |
| usb2-2 { |
| nvidia,function = "xusb"; |
| #phy-cells = <0>; |
| }; |
| }; |
| }; |
| |
| ulpi { |
| lanes { |
| ulpi-0 { |
| status = "disabled"; |
| #phy-cells = <0>; |
| }; |
| }; |
| }; |
| |
| hsic { |
| lanes { |
| hsic-0 { |
| status = "disabled"; |
| #phy-cells = <0>; |
| }; |
| |
| hsic-1 { |
| status = "disabled"; |
| #phy-cells = <0>; |
| }; |
| }; |
| }; |
| |
| pcie { |
| lanes { |
| pcie-0 { |
| nvidia,function = "usb3-ss"; |
| #phy-cells = <0>; |
| }; |
| |
| pcie-1 { |
| status = "disabled"; |
| #phy-cells = <0>; |
| }; |
| |
| pcie-2 { |
| nvidia,function = "pcie"; |
| #phy-cells = <0>; |
| }; |
| |
| pcie-3 { |
| status = "disabled"; |
| #phy-cells = <0>; |
| }; |
| |
| pcie-4 { |
| nvidia,function = "pcie"; |
| #phy-cells = <0>; |
| }; |
| }; |
| }; |
| |
| sata { |
| lanes { |
| sata-0 { |
| nvidia,function = "sata"; |
| #phy-cells = <0>; |
| }; |
| }; |
| }; |
| }; |
| |
| ports { |
| /* Micro A/B */ |
| usb2-0 { |
| mode = "otg"; |
| }; |
| |
| /* Mini PCIe */ |
| usb2-1 { |
| mode = "host"; |
| }; |
| |
| /* USB3 */ |
| usb2-2 { |
| vbus-supply = <&vdd_usb3_vbus>; |
| mode = "host"; |
| }; |
| |
| ulpi-0 { |
| status = "disabled"; |
| }; |
| |
| hsic-0 { |
| status = "disabled"; |
| }; |
| |
| hsic-1 { |
| status = "disabled"; |
| }; |
| |
| usb3-0 { |
| nvidia,usb2-companion = <2>; |
| }; |
| |
| usb3-1 { |
| status = "disabled"; |
| }; |
| }; |
| }; |
