[PATCH v4 1/2] dt-bindings: usb: qcom,snps-dwc3: Add mode-switch

From: Joonhoe Kim

Date: Thu Nov 19 2026 - 07:46:23 EST


The QMP USB3-DP combo PHY stops the USB3 PIPE clock when a Type-C
DisplayPort pin assignment gives it all four lanes for DisplayPort,
while the controller can keep running its USB 2.0 port. The controller
has to move to the UTMI clock before that happens, so it needs to know
the Type-C mode. It does not route any signals itself.

The Type-C class passes the mode only to graph nodes that have the
"mode-switch" property, so allow it on the controller node through
usb-switch.yaml. Orientation and retimer switching do not apply to the
controller.

Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@xxxxxxxxxxxxxxxx>
Signed-off-by: Joonhoe Kim <26rote@xxxxxxxxx>
---
v4:
- Add Reviewed-by from Krzysztof
v3:
- Drop the mode-switch line, the usb-switch.yaml reference allows it.
Disallow orientation-switch and retimer-switch (Krzysztof)
- Say in the message that the controller does not route any signals
v2:
- Use the common usb-switch schema instead of a local definition

Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml | 5 +++++
1 file changed, 5 insertions(+)

diff --git a/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml b/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml
index b77c02c64..fdc2bc8d3 100644
--- a/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml
+++ b/Documentation/devicetree/bindings/usb/qcom,snps-dwc3.yaml
@@ -158,6 +158,10 @@ properties:
HS/FS/LS modes are supported.
type: boolean

+ orientation-switch: false
+
+ retimer-switch: false
+
wakeup-source: true

required:
@@ -170,6 +174,7 @@ required:

allOf:
- $ref: snps,dwc3-common.yaml#
+ - $ref: /schemas/usb/usb-switch.yaml#
- if:
properties:
compatible:
--
2.53.0