Add bindings doc for Sunplus EHCI driver Signed-off-by: Vincent Shih <vincent.sunplus@xxxxxxxxx> --- Changes in v2: - Address the comments from Mr. Krzysztof Kozlowski and Mr. Rob Herring .../bindings/usb/sunplus,sp7021-usb-ehci.yaml | 79 ++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 80 insertions(+) create mode 100644 Documentation/devicetree/bindings/usb/sunplus,sp7021-usb-ehci.yaml diff --git a/Documentation/devicetree/bindings/usb/sunplus,sp7021-usb-ehci.yaml b/Documentation/devicetree/bindings/usb/sunplus,sp7021-usb-ehci.yaml new file mode 100644 index 0000000..307b018 --- /dev/null +++ b/Documentation/devicetree/bindings/usb/sunplus,sp7021-usb-ehci.yaml @@ -0,0 +1,79 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +# Copyright (C) Sunplus Co., Ltd. 2021 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/usb/sunplus,sp7021-usb-ehci.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Sunplus SP7021 EHCI Controller Device Tree Bindings + +allOf: + - $ref: usb-hcd.yaml# + +maintainers: + - Vincent Shih <vincent.sunplus@xxxxxxxxx> + +description: + Sunplus SP7021 USB HOST IP is a USB2.0 Host Controller. It supports both + Enhanced Host Controller Interface (EHCI) and Open Host Controller Interface + (OHCI). + + It supports 32-bits address bus and 64bit data bus interface, compliant + to AMBA AXI interface for data transfer. + + It supports 32-bits address and data bus interface, compliant to AMBA + AHB interface for register configurations. + + It supports 32-bits address and data bus interface, compliant to AMBA + AXI interface for register alternative configurations. + + The UTM Interface block generates PHY control signals, compliant to + USB2.0 Transceiver Macrocell Interface Specification Revision 1.0. + +properties: + compatible: + const: sunplus,sp7021-usb-ehci + + reg: + maxItems: 1 + + clocks: + maxItems: 1 + + resets: + maxItems: 1 + + interrupts: + maxItems: 1 + + phys: + maxItems: 1 + + phy-names: + const: uphy + +required: + - compatible + - reg + - clocks + - resets + - interrupts + - phys + - phy-names + +unevaluatedProperties: false + +examples: + - | + #include <dt-bindings/interrupt-controller/irq.h> + + sp_ehci0: usb@9c102100 { + compatible = "sunplus,sp7021-usb-ehci"; + reg = <0x9c102100 0x68>; + clocks = <&clkc 0x3a>; + resets = <&rstc 0x2a>; + interrupt-parent = <&intc>; + interrupts = <14 IRQ_TYPE_LEVEL_HIGH>; + phys = <&sp_uphy0>; + phy-names = "uphy"; + }; diff --git a/MAINTAINERS b/MAINTAINERS index e103afa..a057288 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -18918,6 +18918,7 @@ SUNPLUS USB EHCI DRIVER M: Vincent Shih <vincent.sunplus@xxxxxxxxx> L: linux-usb@xxxxxxxxxxxxxxx S: Maintained +F: Documentation/devicetree/bindings/usb/sunplus,sp7021-usb-ehci.yaml F: drivers/usb/host/ehci-sunplus.c SUPERH -- 2.7.4
