[PATCH 1/2] dt-bindings: usb: generic-ehci: Document clock-names in top-level

From: Krzysztof Kozlowski

Date: Thu Jun 25 2026 - 05:21:33 EST


Convention is to always have properties defined in top-level part of the
binding and then customized (narrowed per variant) in "if:then:" blocks.
The clock-names were mentioned only in such "if:then:" block for
atmel,at91sam9g45-ehci, thus add the top-level part and disallow usage
of clock-names for other devices. This has no practical impact as
clock-names are not used by other variants, except in
hisilicon/hi3798cv200.dtsi, but that SoC has it undocumented.

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@xxxxxxxxxxxxxxxx>
---
Documentation/devicetree/bindings/usb/generic-ehci.yaml | 7 +++++++
1 file changed, 7 insertions(+)

diff --git a/Documentation/devicetree/bindings/usb/generic-ehci.yaml b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
index 55a5aa7d7a54..ae9fb70d0212 100644
--- a/Documentation/devicetree/bindings/usb/generic-ehci.yaml
+++ b/Documentation/devicetree/bindings/usb/generic-ehci.yaml
@@ -98,6 +98,10 @@ properties:
- if a USB DRD channel: first clock should be host and second
one should be peripheral

+ clock-names:
+ minItems: 1
+ maxItems: 4
+
power-domains:
maxItems: 1

@@ -186,6 +190,9 @@ allOf:
required:
- clocks
- clock-names
+ else:
+ properties:
+ clock-names: false

unevaluatedProperties: false

--
2.53.0