From: Vincent Shih <vincent.sunplus@gmail.com>
To: gregkh@linuxfoundation.org, stern@rowland.harvard.edu,
p.zabel@pengutronix.de, linux-kernel@vger.kernel.org,
linux-usb@vger.kernel.org, robh+dt@kernel.org,
devicetree@vger.kernel.org, wells.lu@sunplus.com
Cc: Vincent Shih <vincent.sunplus@gmail.com>
Subject: [PATCH v2 2/2] dt-bindings: usb: Add bindings doc for Sunplus EHCI driver
Date: Sun, 27 Feb 2022 17:50:41 +0800 [thread overview]
Message-ID: <1645955441-6496-3-git-send-email-vincent.sunplus@gmail.com> (raw)
In-Reply-To: <1645955441-6496-1-git-send-email-vincent.sunplus@gmail.com>
Add bindings doc for Sunplus EHCI driver
Signed-off-by: Vincent Shih <vincent.sunplus@gmail.com>
---
.../bindings/usb/sunplus,sp7021-usb-ehci.yaml | 97 ++++++++++++++++++++++
MAINTAINERS | 1 +
2 files changed, 98 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..e492f7a
--- /dev/null
+++ b/Documentation/devicetree/bindings/usb/sunplus,sp7021-usb-ehci.yaml
@@ -0,0 +1,97 @@
+# 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 Device Tree bindings for ehci0/ehci1
+
+maintainers:
+ - Vincent Shih <vincent.sunplus@gmail.com>
+
+allOf:
+ - $ref: usb-hcd.yaml#
+
+properties:
+ compatible:
+ enum:
+ - sunplus,sp7021-usb-ehci0
+ - sunplus,sp7021-usb-ehci1
+
+ clocks:
+ maxItems: 2
+
+ clock-names:
+ items:
+ - const: usbc_clk
+ - const: uphy_clk
+
+ resets:
+ maxItems: 2
+
+ reset-names:
+ items:
+ - const: usbc_rst
+ - const: uphy_rst
+
+ reg:
+ items:
+ - description: USBC register region
+ - description: UPHY register region
+ - description: MOON4 register region
+
+ reg-names:
+ items:
+ - const: usbc
+ - const: uphy
+ - const: moon4
+
+ interrupts:
+ maxItems: 1
+
+ nvmem-cell-names:
+ description: names corresponding to the nvmem cells of disconnect voltage
+ const: disc_vol
+
+ nvmem-cells:
+ description: nvmem cell address of disconnect voltage
+ maxItems: 1
+
+ port-num:
+ description: identify ehci0 (port0) and ehci1 (port1)
+
+required:
+ - compatible
+ - clocks
+ - clock-names
+ - resets
+ - reset-names
+ - reg
+ - reg-names
+ - interrupts
+ - nvmem-cell-names
+ - nvmem-cells
+ - port-num
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/irq.h>
+
+ sp_ehci0: usb@9c102100 {
+ compatible = "sunplus,sp7021-usb-ehci";
+ clocks = <&clkc 0x3a>, <&clkc 0x3d>;
+ clock-names = "usbc_clk", "uphy_clk";
+ resets = <&rstc 0x2a>, <&rstc 0x2d>;
+ reset-names = "usbc_rst", "uphy_rst";
+ reg = <0x9c102100 0x68>, <0x9c004a80 0x80>, <0x9c000200 0x80>;
+ reg-names = "usbc", "uphy", "moon4";
+ interrupt-parent = <&intc>;
+ interrupts = <14 IRQ_TYPE_LEVEL_HIGH>;
+ nvmem-cell-names = "disc_vol";
+ nvmem-cells = <&disc_vol>;
+ port-num = <0>;
+ };
+...
diff --git a/MAINTAINERS b/MAINTAINERS
index 6c2faf3..49702c4 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -17951,6 +17951,7 @@ SUNPLUS USB EHCI DRIVER
M: Vincent Shih <vincent.sunplus@gmail.com>
L: linux-usb@vger.kernel.org
S: Maintained
+F: Documentation/devicetree/bindings/nvmem/sunplus,sp7021-ocotp.yaml
F: drivers/usb/host/ehci-sunplus.c
SUPERH
--
2.7.4
next prev parent reply other threads:[~2022-02-27 9:50 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-02-27 9:50 [PATCH v2 0/2] Add driver for ehci in Sunplus SP7021 Vincent Shih
2022-02-27 9:50 ` [PATCH v2 1/2] usb: host: ehci-sunplus: " Vincent Shih
2022-02-27 16:07 ` Alan Stern
2022-02-27 9:50 ` Vincent Shih [this message]
2022-02-27 10:53 ` [PATCH v2 2/2] dt-bindings: usb: Add bindings doc for Sunplus EHCI driver Krzysztof Kozlowski
2022-02-28 2:44 ` Rob Herring
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1645955441-6496-3-git-send-email-vincent.sunplus@gmail.com \
--to=vincent.sunplus@gmail.com \
--cc=devicetree@vger.kernel.org \
--cc=gregkh@linuxfoundation.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-usb@vger.kernel.org \
--cc=p.zabel@pengutronix.de \
--cc=robh+dt@kernel.org \
--cc=stern@rowland.harvard.edu \
--cc=wells.lu@sunplus.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.