[PATCH v4] dt-bindings: usb: generic-xhci: add Axiado AX3005 xHCI variant

Swark Yang <[email protected]> Wed, 05 Aug 2026 22:09:33 -0700
Newsgroups org.kernel.vger.linux-usb,org.kernel.vger.linux-devicetree,org.kernel.vger.linux-kernel
Message-ID <[email protected]>
The Axiado AX3005 xHCI controller is software-compatible with the
generic xHCI programming interface and uses "generic-xhci" as its
fallback, as do the Marvell Armada 37xx/8k controllers.

Add "axiado,ax3005-xhci" to the existing compatible enum instead of
adding a separate schema entry. Since the enum no longer covers only
Armada parts, drop the "Armada 37xx/8k SoCs" description rather than
leave it inaccurate.

Signed-off-by: Swark Yang <[email protected]>
---
This xHCI binding was previously submitted as patch 7/8 of the AX3005
v3 multi-subsystem series.

Following maintainer feedback, the binding updates are now submitted
separately to their respective subsystem maintainers, as there are no
cross-subsystem dependencies requiring them to be submitted together.

This submission contains only the AX3005 xHCI binding update. The
corresponding xHCI controller nodes remain in the separate AX3005 arm64
Devicetree series.

Changes in v4:

- Submit the xHCI binding separately from the previous multi-subsystem
  AX3005 series.
- Add "axiado,ax3005-xhci" to the existing enum for controllers using
  "generic-xhci" as their fallback, instead of adding a separate
  schema entry.
- Drop the "Armada 37xx/8k SoCs" description because the enum now
  also contains the Axiado AX3005 compatible.
- Expand the commit message to explain the relationship between the
  AX3005 controller and the generic xHCI programming interface.

Previously submitted as:

[PATCH v3 7/8] dt-bindings: usb: generic-xhci:
add Axiado AX3005 xHCI controller

https://lore.kernel.org/all/20260716-upstream-axiado-ax3005-upstream-v3-7-c429095143ec@axiado.com/
---
 Documentation/devicetree/bindings/usb/generic-xhci.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/devicetree/bindings/usb/generic-xhci.yaml b/Documentation/devicetree/bindings/usb/generic-xhci.yaml
index 62678abd74b5..9af6d0172e56 100644
--- a/Documentation/devicetree/bindings/usb/generic-xhci.yaml
+++ b/Documentation/devicetree/bindings/usb/generic-xhci.yaml
@@ -19,9 +19,9 @@ properties:
           - enum:
               - marvell,armada-375-xhci
               - marvell,armada-380-xhci
-      - description: Armada 37xx/8k SoCs
-        items:
+      - items:
           - enum:
+              - axiado,ax3005-xhci
               - marvell,armada3700-xhci
               - marvell,armada-8k-xhci
           - const: generic-xhci

---
base-commit: 1590cf0329716306e948a8fc29f1d3ee87d3989f
change-id: 20260805-upstrea-ax3005-usb-v4-04437a2990a3

Best regards,
-- 
Swark Yang <[email protected]>