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

From: Joonhoe Kim

Date: Thu Nov 12 2026 - 06:45:40 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.

Signed-off-by: Joonhoe Kim <26rote@xxxxxxxxx>
---
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 b77c02c64d45..fdc2bc8d3045 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.43.0