From: Florian Fainelli <f.fainelli-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
To: devicetree-spec-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
Cc: robh+dt-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org,
grant.likely-QSEj5FYQhm4dnm+yROfE0A@public.gmane.org,
Florian Fainelli
<f.fainelli-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
Subject: [PATCH] Describe interrupts-extended property
Date: Tue, 3 Jan 2017 11:24:23 -0800 [thread overview]
Message-ID: <20170103192423.5838-1-f.fainelli@gmail.com> (raw)
The interrupts-extended property is a common property used when
interrupt generating devices having interrupt lines in several interrupt
controllers with possibly distinct interrupt specifiers.
Signed-off-by: Florian Fainelli <f.fainelli-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
---
source/devicetree-basics.rst | 34 ++++++++++++++++++++++++++++++++++
1 file changed, 34 insertions(+)
diff --git a/source/devicetree-basics.rst b/source/devicetree-basics.rst
index be80af3d825b..1bda0fa54e7a 100644
--- a/source/devicetree-basics.rst
+++ b/source/devicetree-basics.rst
@@ -955,6 +955,40 @@ Description:
to the interrupt parent. If this property is missing from a device, its
interrupt parent is assumed to be its devicetree parent.
+interrupts-extended
+^^^^^^^^^^^^^^^^^^^
+
+Property: ``interrupts-extended``
+
+Value type: ``<phandle> <prop-encoded-array>``
+
+Description:
+
+ The *interrupts-extended* property of a device node defines the interrupt or
+ the interrupts that are generated by the device. In case where an interrupt
+ generating devices has several interrupt lines, some of them having distinct
+ interrupt parents, the *interrupts-extended* property should be used to
+ fully describe the interrupts of this device, relative to the interrupt
+ controller(s), which is encoded by the phandle part of the property. The non
+ phandle part of the property encodes the interrupt specifiers and obeys to
+ the *interrupts* property description.
+
+ If both *interrupts-extended* and *interrupts* properties are present, the
+ *interrupts-extended* properties takes precedence, and the *interrupts*
+ property may be provided to a client program for compatibility purposes.
+
+Example:
+
+ A device with several interrupt lines in distinct interrupt controllers,
+ having different interrupt specifiers is illustrated below. In this example
+ ``pic`` is an interrupt controller with an *#interrupt-cells* specifier
+ of 2, while ``gic`` is an interrupt controller with an *#interrupts-cells*
+ specifier of 1.
+
+
+ ``interrupts-extended = <&pic 0xA 8>, <&gic 0xda>;``
+
+
Properties for Interrupt Controllers
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
--
2.9.3
next reply other threads:[~2017-01-03 19:24 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-01-03 19:24 Florian Fainelli [this message]
[not found] ` <20170103192423.5838-1-f.fainelli-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2017-01-03 22:24 ` [PATCH] Describe interrupts-extended property Rob Herring
[not found] ` <CAL_Jsq+2TVHGS2onm50rG_AxesJEBUhEGLZNEJN8XAGo4CbMgA-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2017-01-03 22:29 ` Florian Fainelli
2017-01-13 8:51 ` Grant Likely
2017-01-03 23:04 ` David Gibson
[not found] ` <20170103230436.GS12761-K0bRW+63XPQe6aEkudXLsA@public.gmane.org>
2017-01-03 23:44 ` Florian Fainelli
[not found] ` <f04c76d4-996b-6ffd-d59e-eb992d0a912d-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2017-01-04 0:31 ` David Gibson
[not found] ` <20170104003147.GW12761-K0bRW+63XPQe6aEkudXLsA@public.gmane.org>
2017-01-04 0:47 ` Florian Fainelli
[not found] ` <0d9b43f1-147c-5761-9fdd-8ba28c690df9-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2017-01-04 1:03 ` Laurent Pinchart
2017-01-04 1:19 ` Florian Fainelli
[not found] ` <663f501c-4646-8f15-cb90-0477ceff3daf-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2017-01-04 1:28 ` Laurent Pinchart
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=20170103192423.5838-1-f.fainelli@gmail.com \
--to=f.fainelli-re5jqeeqqe8avxtiumwx3w@public.gmane.org \
--cc=devicetree-spec-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
--cc=grant.likely-QSEj5FYQhm4dnm+yROfE0A@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 read-only IMAP folder(s) and NNTP newsgroup(s).