From: Rob Herring <robh@kernel.org>
To: Samuel Holland <samuel@sholland.org>
Cc: Maxime Ripard <maxime.ripard@bootlin.com>,
Chen-Yu Tsai <wens@csie.org>,
Jassi Brar <jassisinghbrar@gmail.com>,
Michael Turquette <mturquette@baylibre.com>,
Stephen Boyd <sboyd@kernel.org>,
Mark Rutland <mark.rutland@arm.com>,
devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org,
linux-clk@vger.kernel.org, linux-kernel@vger.kernel.org,
linux-sunxi@googlegroups.com
Subject: Re: [PATCH v3 11/15] [NOT FOR MERGE] dt-bindings: Add a binding for a mailbox-backed interrupt controller
Date: Tue, 12 Mar 2019 08:42:08 -0500 [thread overview]
Message-ID: <20190312134208.GA2017@bogus> (raw)
In-Reply-To: <20190302042951.53671-12-samuel@sholland.org>
On Fri, Mar 01, 2019 at 10:29:47PM -0600, Samuel Holland wrote:
> This is a somewhat generic binding for an interrupt controller/forwarder
> implemented in firmware and communicated with using a mailbox.
>
> Signed-off-by: Samuel Holland <samuel@sholland.org>
> ---
> .../interrupt-controller/mbox-intc.txt | 33 +++++++++++++++++++
> 1 file changed, 33 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/interrupt-controller/mbox-intc.txt
>
> diff --git a/Documentation/devicetree/bindings/interrupt-controller/mbox-intc.txt b/Documentation/devicetree/bindings/interrupt-controller/mbox-intc.txt
> new file mode 100644
> index 000000000000..a0eb7904ca83
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/interrupt-controller/mbox-intc.txt
> @@ -0,0 +1,33 @@
> +Mailbox-backed Interrupt Controller
> +===================================
Probably never really going to be generic as every mailbox protocol is
different.
> +
> +This binding represents an interrupt controller implemented in firmware,
> +that uses a mailbox channel to signal and acknowledge interrupts.
> +
> +Device Node:
> +============
> +
> +Required properties:
> +--------------------
> +- compatible: Must be one of the following strings:
> + - allwinner,sunxi-msgbox-intc
> +- interrupt-controller: Signifies that this node is an interrupt controller.
> +- #interrupt-cells: Must be 1.
No edge/level control?
> +- mboxes: phandle for the mailbox controller and channel
> + specifier. If the mailbox controller has unidirectional
> + channels, two entries are required (see below).
> +- mbox-names: Only required for unidirectional mailbox channels. In
> + that case, it must contain the strings "tx" and "rx"
> + (where "tx" and "rx" are from Linux's perspective, not
/Linux/the OS/
> + the direction the interrupts are traveling).
> +
> +Example:
> +--------
> +
> + msgbox_intc: interrupt-controller {
> + compatible = "allwinner,sunxi-msgbox-intc";
> + interrupt-controller;
> + #interrupt-cells = <1>;
> + mboxes = <&msgbox 6>, <&msgbox 7>;
> + mbox-names = "tx", "rx";
> + };
> --
> 2.19.2
>
WARNING: multiple messages have this Message-ID (diff)
From: Rob Herring <robh@kernel.org>
To: Samuel Holland <samuel@sholland.org>
Cc: Mark Rutland <mark.rutland@arm.com>,
devicetree@vger.kernel.org, linux-sunxi@googlegroups.com,
Maxime Ripard <maxime.ripard@bootlin.com>,
Michael Turquette <mturquette@baylibre.com>,
Jassi Brar <jassisinghbrar@gmail.com>,
linux-kernel@vger.kernel.org, Stephen Boyd <sboyd@kernel.org>,
Chen-Yu Tsai <wens@csie.org>,
linux-clk@vger.kernel.org, linux-arm-kernel@lists.infradead.org
Subject: Re: [PATCH v3 11/15] [NOT FOR MERGE] dt-bindings: Add a binding for a mailbox-backed interrupt controller
Date: Tue, 12 Mar 2019 08:42:08 -0500 [thread overview]
Message-ID: <20190312134208.GA2017@bogus> (raw)
In-Reply-To: <20190302042951.53671-12-samuel@sholland.org>
On Fri, Mar 01, 2019 at 10:29:47PM -0600, Samuel Holland wrote:
> This is a somewhat generic binding for an interrupt controller/forwarder
> implemented in firmware and communicated with using a mailbox.
>
> Signed-off-by: Samuel Holland <samuel@sholland.org>
> ---
> .../interrupt-controller/mbox-intc.txt | 33 +++++++++++++++++++
> 1 file changed, 33 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/interrupt-controller/mbox-intc.txt
>
> diff --git a/Documentation/devicetree/bindings/interrupt-controller/mbox-intc.txt b/Documentation/devicetree/bindings/interrupt-controller/mbox-intc.txt
> new file mode 100644
> index 000000000000..a0eb7904ca83
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/interrupt-controller/mbox-intc.txt
> @@ -0,0 +1,33 @@
> +Mailbox-backed Interrupt Controller
> +===================================
Probably never really going to be generic as every mailbox protocol is
different.
> +
> +This binding represents an interrupt controller implemented in firmware,
> +that uses a mailbox channel to signal and acknowledge interrupts.
> +
> +Device Node:
> +============
> +
> +Required properties:
> +--------------------
> +- compatible: Must be one of the following strings:
> + - allwinner,sunxi-msgbox-intc
> +- interrupt-controller: Signifies that this node is an interrupt controller.
> +- #interrupt-cells: Must be 1.
No edge/level control?
> +- mboxes: phandle for the mailbox controller and channel
> + specifier. If the mailbox controller has unidirectional
> + channels, two entries are required (see below).
> +- mbox-names: Only required for unidirectional mailbox channels. In
> + that case, it must contain the strings "tx" and "rx"
> + (where "tx" and "rx" are from Linux's perspective, not
/Linux/the OS/
> + the direction the interrupts are traveling).
> +
> +Example:
> +--------
> +
> + msgbox_intc: interrupt-controller {
> + compatible = "allwinner,sunxi-msgbox-intc";
> + interrupt-controller;
> + #interrupt-cells = <1>;
> + mboxes = <&msgbox 6>, <&msgbox 7>;
> + mbox-names = "tx", "rx";
> + };
> --
> 2.19.2
>
_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
next prev parent reply other threads:[~2019-03-12 13:42 UTC|newest]
Thread overview: 55+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-03-02 4:29 [PATCH v3 00/15] Allwinner sunxi message box support Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 01/15] clk: sunxi-ng: Mark msgbox clocks as critical Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 02/15] clk: sunxi-ng: Mark AR100 " Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 03/15] dt-bindings: mailbox: Add a sunxi message box binding Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-12 13:36 ` Rob Herring
2019-03-12 13:36 ` Rob Herring
2019-03-12 13:36 ` Rob Herring
2019-03-02 4:29 ` [PATCH v3 04/15] mailbox: sunxi-msgbox: Add a new mailbox driver Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 05/15] ARM: dts: sunxi: a80: Add msgbox node Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 06/15] ARM: dts: sunxi: a83t: " Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 07/15] ARM: dts: sunxi: h3/h5: " Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-06 3:39 ` Samuel Holland
2019-03-06 3:39 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 08/15] arm64: dts: allwinner: a64: " Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 09/15] arm64: dts: allwinner: h6: " Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 10/15] [NOT FOR MERGE] clk: sunxi-ng: sun8i: Avoid turning off unused PRCM gates Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 11/15] [NOT FOR MERGE] dt-bindings: Add a binding for a mailbox-backed interrupt controller Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-12 13:42 ` Rob Herring [this message]
2019-03-12 13:42 ` Rob Herring
2019-03-02 4:29 ` [PATCH v3 12/15] [NOT FOR MERGE] irqchip/mbox: Introduce a mailbox-backed irqchip driver Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 13/15] [NOT FOR MERGE] arm64: dts: allwinner: a64: Add interrupt controller node Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 14/15] [NOT FOR MERGE] arm64: dts: allwinner: a64: Convert DTS to use msgbox_intc Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` [PATCH v3 15/15] [NOT FOR MERGE] arm64: dts: allwinner: a64: Remove unused r_intc Samuel Holland
2019-03-02 4:29 ` Samuel Holland
2019-03-02 4:29 ` Samuel Holland
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=20190312134208.GA2017@bogus \
--to=robh@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=jassisinghbrar@gmail.com \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-clk@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-sunxi@googlegroups.com \
--cc=mark.rutland@arm.com \
--cc=maxime.ripard@bootlin.com \
--cc=mturquette@baylibre.com \
--cc=samuel@sholland.org \
--cc=sboyd@kernel.org \
--cc=wens@csie.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 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.