From: Joel Stanley <joel-U3u1mxZcP9KHXe+LvDLADg@public.gmane.org>
To: Philipp Zabel <p.zabel-bIcnvbaLZ9MEGnE8C9+IrQ@public.gmane.org>,
Rob Herring <robh+dt-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>,
Mark Rutland <mark.rutland-5wv7dgnIgG8@public.gmane.org>
Cc: devicetree-u79uwXL29TY76Z2rM5mHXA@public.gmane.org,
linux-kernel-u79uwXL29TY76Z2rM5mHXA@public.gmane.org,
Benjamin Herrenschmidt
<benh-XVmvHMARGAS8U2dJNN8I7kB+6BGkLq7r@public.gmane.org>,
Andrew Jeffery <andrew-zrmu5oMJ5Fs@public.gmane.org>
Subject: [PATCH 1/2] dt-bindings: reset: Add bindings for basic reset controller
Date: Fri, 26 May 2017 13:32:13 +1000 [thread overview]
Message-ID: <20170526033214.8081-2-joel@jms.id.au> (raw)
In-Reply-To: <20170526033214.8081-1-joel-U3u1mxZcP9KHXe+LvDLADg@public.gmane.org>
This adds the bindings documentation for a basic single-register reset
controller.
The bindings describe a single 32-bit register that contains up to 32
reset lines, each deasserted by clearing the appropriate bit in the
register.
Signed-off-by: Joel Stanley <joel-U3u1mxZcP9KHXe+LvDLADg@public.gmane.org>
---
.../devicetree/bindings/reset/reset-basic.txt | 31 ++++++++++++++++++++++
1 file changed, 31 insertions(+)
create mode 100644 Documentation/devicetree/bindings/reset/reset-basic.txt
diff --git a/Documentation/devicetree/bindings/reset/reset-basic.txt b/Documentation/devicetree/bindings/reset/reset-basic.txt
new file mode 100644
index 000000000000..7341e04e7904
--- /dev/null
+++ b/Documentation/devicetree/bindings/reset/reset-basic.txt
@@ -0,0 +1,31 @@
+Basic single-register reset controller
+======================================
+
+This describes a generic reset controller where the reset lines are controlled
+by single bits within a 32-bit memory location. The memory location is assumed
+to be part of a syscon regmap.
+
+Reset controller required properties:
+ - compatible: should be "reset-basic"
+ - #reset-cells: must be set to 1
+ - reg: reset register location within regmap
+
+Device node required properties:
+ - resets phandle
+ - bit number, counting from zero, for the desired reset line. Max is 31.
+
+Example:
+
+syscon {
+ compatible = "syscon";
+
+ uart_rest: rest@0c {
+ compatible = "reset-basic";
+ #reset-cells = <1>;
+ reg = <0x0c>;
+ };
+}
+
+&uart {
+ resets = <&uart_rest 0x04>;
+}
--
2.11.0
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
next prev parent reply other threads:[~2017-05-26 3:32 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-05-26 3:32 [PATCH 0/2] reset: Basic reset controller Joel Stanley
[not found] ` <20170526033214.8081-1-joel-U3u1mxZcP9KHXe+LvDLADg@public.gmane.org>
2017-05-26 3:32 ` Joel Stanley [this message]
[not found] ` <20170526033214.8081-2-joel-U3u1mxZcP9KHXe+LvDLADg@public.gmane.org>
2017-05-29 9:09 ` [PATCH 1/2] dt-bindings: reset: Add bindings for basic " Philipp Zabel
[not found] ` <1496048959.17695.20.camel-bIcnvbaLZ9MEGnE8C9+IrQ@public.gmane.org>
2017-05-29 10:16 ` Joel Stanley
2017-05-26 3:32 ` [PATCH 2/2] reset: Add basic single-register reset driver Joel Stanley
[not found] ` <20170526033214.8081-3-joel-U3u1mxZcP9KHXe+LvDLADg@public.gmane.org>
2017-05-27 15:11 ` Andy Shevchenko
[not found] ` <CAHp75VdXHnyTDJqZ8D+OxbrAXYQE+-sfTzYvfoo8FCe0SS35PA-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2017-05-29 10:24 ` Joel Stanley
[not found] ` <CACPK8XeZEY6yVpf=Awmzju+W74-+4sRAQL3LK0nX9iN4_MrcKQ-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2017-05-29 15:41 ` Andy Shevchenko
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=20170526033214.8081-2-joel@jms.id.au \
--to=joel-u3u1mxzcp9khxe+lvdladg@public.gmane.org \
--cc=andrew-zrmu5oMJ5Fs@public.gmane.org \
--cc=benh-XVmvHMARGAS8U2dJNN8I7kB+6BGkLq7r@public.gmane.org \
--cc=devicetree-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
--cc=linux-kernel-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
--cc=mark.rutland-5wv7dgnIgG8@public.gmane.org \
--cc=p.zabel-bIcnvbaLZ9MEGnE8C9+IrQ@public.gmane.org \
--cc=robh+dt-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org \
/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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).