| # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) |
| %YAML 1.2 |
| --- |
| $id: http://devicetree.org/schemas/usb/qcom,dwc3.yaml# |
| $schema: http://devicetree.org/meta-schemas/core.yaml# |
| |
| title: Qualcomm SuperSpeed DWC3 USB SoC controller |
| |
| maintainers: |
| - Wesley Cheng <quic_wcheng@quicinc.com> |
| |
| properties: |
| compatible: |
| items: |
| - enum: |
| - qcom,ipq4019-dwc3 |
| - qcom,ipq6018-dwc3 |
| - qcom,ipq8064-dwc3 |
| - qcom,ipq8074-dwc3 |
| - qcom,msm8953-dwc3 |
| - qcom,msm8994-dwc3 |
| - qcom,msm8996-dwc3 |
| - qcom,msm8998-dwc3 |
| - qcom,qcs404-dwc3 |
| - qcom,sc7180-dwc3 |
| - qcom,sc7280-dwc3 |
| - qcom,sc8280xp-dwc3 |
| - qcom,sdm660-dwc3 |
| - qcom,sdm670-dwc3 |
| - qcom,sdm845-dwc3 |
| - qcom,sdx55-dwc3 |
| - qcom,sdx65-dwc3 |
| - qcom,sm4250-dwc3 |
| - qcom,sm6115-dwc3 |
| - qcom,sm6125-dwc3 |
| - qcom,sm6350-dwc3 |
| - qcom,sm6375-dwc3 |
| - qcom,sm8150-dwc3 |
| - qcom,sm8250-dwc3 |
| - qcom,sm8350-dwc3 |
| - qcom,sm8450-dwc3 |
| - qcom,sm8550-dwc3 |
| - const: qcom,dwc3 |
| |
| reg: |
| description: Offset and length of register set for QSCRATCH wrapper |
| maxItems: 1 |
| |
| "#address-cells": |
| enum: [ 1, 2 ] |
| |
| "#size-cells": |
| enum: [ 1, 2 ] |
| |
| ranges: true |
| |
| power-domains: |
| description: specifies a phandle to PM domain provider node |
| maxItems: 1 |
| |
| clocks: |
| description: | |
| Several clocks are used, depending on the variant. Typical ones are:: |
| - cfg_noc:: System Config NOC clock. |
| - core:: Master/Core clock, has to be >= 125 MHz for SS operation and >= |
| 60MHz for HS operation. |
| - iface:: System bus AXI clock. |
| - sleep:: Sleep clock, used for wakeup when USB3 core goes into low |
| power mode (U3). |
| - mock_utmi:: Mock utmi clock needed for ITP/SOF generation in host |
| mode. Its frequency should be 19.2MHz. |
| minItems: 1 |
| maxItems: 9 |
| |
| clock-names: |
| minItems: 1 |
| maxItems: 9 |
| |
| assigned-clocks: |
| items: |
| - description: Phandle and clock specifier of MOCK_UTMI_CLK. |
| - description: Phandle and clock specifoer of MASTER_CLK. |
| |
| assigned-clock-rates: |
| items: |
| - description: Must be 19.2MHz (19200000). |
| - description: Must be >= 60 MHz in HS mode, >= 125 MHz in SS mode. |
| resets: |
| maxItems: 1 |
| |
| interconnects: |
| maxItems: 2 |
| |
| interconnect-names: |
| items: |
| - const: usb-ddr |
| - const: apps-usb |
| |
| interrupts: |
| minItems: 1 |
| maxItems: 4 |
| |
| interrupt-names: |
| minItems: 1 |
| maxItems: 4 |
| |
| qcom,select-utmi-as-pipe-clk: |
| description: |
| If present, disable USB3 pipe_clk requirement. |
| Used when dwc3 operates without SSPHY and only |
| HS/FS/LS modes are supported. |
| type: boolean |
| |
| wakeup-source: true |
| |
| # Required child node: |
| |
| patternProperties: |
| "^usb@[0-9a-f]+$": |
| $ref: snps,dwc3.yaml# |
| |
| properties: |
| wakeup-source: false |
| |
| required: |
| - compatible |
| - reg |
| - "#address-cells" |
| - "#size-cells" |
| - ranges |
| - power-domains |
| - clocks |
| - clock-names |
| - interrupts |
| - interrupt-names |
| |
| allOf: |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,ipq4019-dwc3 |
| then: |
| properties: |
| clocks: |
| maxItems: 3 |
| clock-names: |
| items: |
| - const: core |
| - const: sleep |
| - const: mock_utmi |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,ipq8064-dwc3 |
| then: |
| properties: |
| clocks: |
| items: |
| - description: Master/Core clock, has to be >= 125 MHz |
| for SS operation and >= 60MHz for HS operation. |
| clock-names: |
| items: |
| - const: core |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,msm8953-dwc3 |
| - qcom,msm8996-dwc3 |
| - qcom,msm8998-dwc3 |
| - qcom,sc7180-dwc3 |
| - qcom,sc7280-dwc3 |
| - qcom,sdm670-dwc3 |
| - qcom,sdm845-dwc3 |
| - qcom,sdx55-dwc3 |
| - qcom,sm6350-dwc3 |
| then: |
| properties: |
| clocks: |
| maxItems: 5 |
| clock-names: |
| items: |
| - const: cfg_noc |
| - const: core |
| - const: iface |
| - const: sleep |
| - const: mock_utmi |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,ipq6018-dwc3 |
| then: |
| properties: |
| clocks: |
| minItems: 3 |
| maxItems: 4 |
| clock-names: |
| oneOf: |
| - items: |
| - const: core |
| - const: sleep |
| - const: mock_utmi |
| - items: |
| - const: cfg_noc |
| - const: core |
| - const: sleep |
| - const: mock_utmi |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,ipq8074-dwc3 |
| then: |
| properties: |
| clocks: |
| maxItems: 4 |
| clock-names: |
| items: |
| - const: cfg_noc |
| - const: core |
| - const: sleep |
| - const: mock_utmi |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,msm8994-dwc3 |
| - qcom,qcs404-dwc3 |
| then: |
| properties: |
| clocks: |
| maxItems: 4 |
| clock-names: |
| items: |
| - const: core |
| - const: iface |
| - const: sleep |
| - const: mock_utmi |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,sc8280xp-dwc3 |
| then: |
| properties: |
| clocks: |
| maxItems: 9 |
| clock-names: |
| items: |
| - const: cfg_noc |
| - const: core |
| - const: iface |
| - const: sleep |
| - const: mock_utmi |
| - const: noc_aggr |
| - const: noc_aggr_north |
| - const: noc_aggr_south |
| - const: noc_sys |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,sdm660-dwc3 |
| then: |
| properties: |
| clocks: |
| minItems: 6 |
| clock-names: |
| items: |
| - const: cfg_noc |
| - const: core |
| - const: iface |
| - const: sleep |
| - const: mock_utmi |
| - const: bus |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,sm6115-dwc3 |
| - qcom,sm6125-dwc3 |
| - qcom,sm8150-dwc3 |
| - qcom,sm8250-dwc3 |
| - qcom,sm8450-dwc3 |
| - qcom,sm8550-dwc3 |
| then: |
| properties: |
| clocks: |
| minItems: 6 |
| clock-names: |
| items: |
| - const: cfg_noc |
| - const: core |
| - const: iface |
| - const: sleep |
| - const: mock_utmi |
| - const: xo |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,sm8350-dwc3 |
| then: |
| properties: |
| clocks: |
| minItems: 5 |
| maxItems: 6 |
| clock-names: |
| minItems: 5 |
| items: |
| - const: cfg_noc |
| - const: core |
| - const: iface |
| - const: sleep |
| - const: mock_utmi |
| - const: xo |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,ipq4019-dwc3 |
| - qcom,ipq6018-dwc3 |
| - qcom,ipq8064-dwc3 |
| - qcom,ipq8074-dwc3 |
| - qcom,msm8994-dwc3 |
| - qcom,qcs404-dwc3 |
| - qcom,sc7180-dwc3 |
| - qcom,sdm670-dwc3 |
| - qcom,sdm845-dwc3 |
| - qcom,sdx55-dwc3 |
| - qcom,sdx65-dwc3 |
| - qcom,sm4250-dwc3 |
| - qcom,sm6125-dwc3 |
| - qcom,sm6350-dwc3 |
| - qcom,sm8150-dwc3 |
| - qcom,sm8250-dwc3 |
| - qcom,sm8350-dwc3 |
| - qcom,sm8450-dwc3 |
| - qcom,sm8550-dwc3 |
| then: |
| properties: |
| interrupts: |
| items: |
| - description: The interrupt that is asserted |
| when a wakeup event is received on USB2 bus. |
| - description: The interrupt that is asserted |
| when a wakeup event is received on USB3 bus. |
| - description: Wakeup event on DM line. |
| - description: Wakeup event on DP line. |
| interrupt-names: |
| items: |
| - const: hs_phy_irq |
| - const: ss_phy_irq |
| - const: dm_hs_phy_irq |
| - const: dp_hs_phy_irq |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,msm8953-dwc3 |
| - qcom,msm8996-dwc3 |
| - qcom,msm8998-dwc3 |
| - qcom,sm6115-dwc3 |
| then: |
| properties: |
| interrupts: |
| maxItems: 2 |
| interrupt-names: |
| items: |
| - const: hs_phy_irq |
| - const: ss_phy_irq |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,sdm660-dwc3 |
| then: |
| properties: |
| interrupts: |
| minItems: 1 |
| maxItems: 2 |
| interrupt-names: |
| minItems: 1 |
| items: |
| - const: hs_phy_irq |
| - const: ss_phy_irq |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,sc7280-dwc3 |
| then: |
| properties: |
| interrupts: |
| minItems: 3 |
| maxItems: 4 |
| interrupt-names: |
| minItems: 3 |
| items: |
| - const: hs_phy_irq |
| - const: dp_hs_phy_irq |
| - const: dm_hs_phy_irq |
| - const: ss_phy_irq |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - qcom,sc8280xp-dwc3 |
| then: |
| properties: |
| interrupts: |
| maxItems: 4 |
| interrupt-names: |
| items: |
| - const: pwr_event |
| - const: dp_hs_phy_irq |
| - const: dm_hs_phy_irq |
| - const: ss_phy_irq |
| |
| additionalProperties: false |
| |
| examples: |
| - | |
| #include <dt-bindings/clock/qcom,gcc-sdm845.h> |
| #include <dt-bindings/interrupt-controller/arm-gic.h> |
| #include <dt-bindings/interrupt-controller/irq.h> |
| soc { |
| #address-cells = <2>; |
| #size-cells = <2>; |
| |
| usb@a6f8800 { |
| compatible = "qcom,sdm845-dwc3", "qcom,dwc3"; |
| reg = <0 0x0a6f8800 0 0x400>; |
| |
| #address-cells = <2>; |
| #size-cells = <2>; |
| ranges; |
| clocks = <&gcc GCC_CFG_NOC_USB3_PRIM_AXI_CLK>, |
| <&gcc GCC_USB30_PRIM_MASTER_CLK>, |
| <&gcc GCC_AGGRE_USB3_PRIM_AXI_CLK>, |
| <&gcc GCC_USB30_PRIM_SLEEP_CLK>, |
| <&gcc GCC_USB30_PRIM_MOCK_UTMI_CLK>; |
| clock-names = "cfg_noc", |
| "core", |
| "iface", |
| "sleep", |
| "mock_utmi"; |
| |
| assigned-clocks = <&gcc GCC_USB30_PRIM_MOCK_UTMI_CLK>, |
| <&gcc GCC_USB30_PRIM_MASTER_CLK>; |
| assigned-clock-rates = <19200000>, <150000000>; |
| |
| interrupts = <GIC_SPI 131 IRQ_TYPE_LEVEL_HIGH>, |
| <GIC_SPI 486 IRQ_TYPE_LEVEL_HIGH>, |
| <GIC_SPI 488 IRQ_TYPE_LEVEL_HIGH>, |
| <GIC_SPI 489 IRQ_TYPE_LEVEL_HIGH>; |
| interrupt-names = "hs_phy_irq", "ss_phy_irq", |
| "dm_hs_phy_irq", "dp_hs_phy_irq"; |
| |
| power-domains = <&gcc USB30_PRIM_GDSC>; |
| |
| resets = <&gcc GCC_USB30_PRIM_BCR>; |
| |
| usb@a600000 { |
| compatible = "snps,dwc3"; |
| reg = <0 0x0a600000 0 0xcd00>; |
| interrupts = <GIC_SPI 133 IRQ_TYPE_LEVEL_HIGH>; |
| iommus = <&apps_smmu 0x740 0>; |
| snps,dis_u2_susphy_quirk; |
| snps,dis_enblslpm_quirk; |
| phys = <&usb_1_hsphy>, <&usb_1_ssphy>; |
| phy-names = "usb2-phy", "usb3-phy"; |
| }; |
| }; |
| }; |
