[PATCH] dt-bindings: usb: dwc3-xilinx: Describe the reset constraint for the versal platform

From: Radhey Shyam Pandey

Date: Wed Nov 12 2025 - 10:54:39 EST


AMD Versal platform USB 2.0 IP controller receives one reset input from
the SoC controlled by the CRL.RST_USB [RESET] register so accordingly
describe reset constraints.

Signed-off-by: Radhey Shyam Pandey <radhey.shyam.pandey@xxxxxxx>
---
.../devicetree/bindings/usb/dwc3-xilinx.yaml | 43 +++++++++++++++----
1 file changed, 34 insertions(+), 9 deletions(-)

diff --git a/Documentation/devicetree/bindings/usb/dwc3-xilinx.yaml b/Documentation/devicetree/bindings/usb/dwc3-xilinx.yaml
index 36f5c644d959..cd0cc9da242f 100644
--- a/Documentation/devicetree/bindings/usb/dwc3-xilinx.yaml
+++ b/Documentation/devicetree/bindings/usb/dwc3-xilinx.yaml
@@ -50,17 +50,22 @@ properties:
description:
A list of phandles for resets listed in reset-names.

- items:
- - description: USB core reset
- - description: USB hibernation reset
- - description: USB APB reset
+ oneOf:
+ - items:
+ - description: USB controller reset
+ - items:
+ - description: USB core reset
+ - description: USB hibernation reset
+ - description: USB APB reset

reset-names:
- items:
- - const: usb_crst
- - const: usb_hibrst
- - const: usb_apbrst
-
+ oneOf:
+ - items:
+ - const: usb_crst
+ - items:
+ - const: usb_crst
+ - const: usb_hibrst
+ - const: usb_apbrst
phys:
minItems: 1
maxItems: 2
@@ -95,6 +100,26 @@ required:
- resets
- reset-names

+allOf:
+ - if:
+ properties:
+ compatible:
+ contains:
+ enum:
+ - xlnx,versal-dwc3
+ then:
+ properties:
+ resets:
+ maxItems: 1
+ reset-names:
+ maxItems: 1
+ else:
+ properties:
+ resets:
+ minItems: 3
+ reset-names:
+ minItems: 3
+
additionalProperties: false

examples:

base-commit: b179ce312bafcb8c68dc718e015aee79b7939ff0
--
2.34.1