[PATCH v2 1/3] dt-bindings: usb: Add HPE GXP HUB Controller

From: richard . yu
Date: Thu Sep 07 2023 - 17:09:32 EST


From: Richard Yu <richard.yu@xxxxxxx>

Provide access to the two register regions for GXP HUB
controller through the hpe,gxp-hub binding.

Signed-off-by: Richard Yu <richard.yu@xxxxxxx>

---

v2:
*Removed the term "virtual" as it is still a device.
*Removed the downstream port number and generic endpoints
number properties from device tree structure.
---
.../devicetree/bindings/usb/hpe,gxp-hub.yaml | 53 +++++++++++++++++++
1 file changed, 53 insertions(+)
create mode 100644 Documentation/devicetree/bindings/usb/hpe,gxp-hub.yaml

diff --git a/Documentation/devicetree/bindings/usb/hpe,gxp-hub.yaml b/Documentation/devicetree/bindings/usb/hpe,gxp-hub.yaml
new file mode 100644
index 000000000000..b3e7bc42d134
--- /dev/null
+++ b/Documentation/devicetree/bindings/usb/hpe,gxp-hub.yaml
@@ -0,0 +1,53 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/usb/hpe,gxp-hub.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: HPE GXP USB HUB controller
+
+maintainers:
+ - Nick Hawkins <nick.hawkins@xxxxxxx>
+ - Richard Yu <richard.yu@xxxxxxx>
+
+description:
+ The HPE GXP USB HUB Controller implements 1 set of USB
+ register and several sets of device and endpoint registers to support
+ the HUB's downstream USB devices.
+
+properties:
+ compatible:
+ enum:
+ - hpe,gxp-hub
+
+ reg:
+ items:
+ - description: GXP hub (gxphub) controller register set
+ - description: Several sets of Device and Endpoint registers to support
+ the HUB's downstream USB devices.
+
+ reg-names:
+ items:
+ - const: gxphub
+ - const: udc
+
+ interrupts:
+ maxItems: 1
+
+required:
+ - compatible
+ - reg
+ - reg-names
+ - interrupts
+
+additionalProperties: false
+
+examples:
+ - |
+ usb-hub@80400800 {
+ compatible = "hpe,gxp-hub";
+ reg = <0x80400800 0x0200>, <0x80401000 0x8000>;
+ reg-names = "gxphub", "udc";
+ interrupts = <13>;
+ interrupt-parent = <&vic1>;
+ };
--
2.17.1