[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <20160902150628.GA19493@rob-hp-laptop>
Date: Fri, 2 Sep 2016 10:06:28 -0500
From: Rob Herring <robh@...nel.org>
To: Nishanth Menon <nm@...com>
Cc: Russell King <rmk+kernel@...linux.org.uk>,
Sudeep Holla <sudeep.holla@....com>,
Santosh Shilimkar <ssantosh@...nel.org>,
Russ Dill <Russ.Dill@...com>, Dave Gerlach <d-gerlach@...com>,
Lokesh Vutla <lokeshvutla@...com>,
Peter Ujfalusi <peter.ujfalusi@...com>,
"Andrew F . Davis" <afd@...com>, Tero Kristo <t-kristo@...com>,
linux-kernel@...r.kernel.org, devicetree@...r.kernel.org,
linux-arm-kernel@...ts.infradead.org, linux-pm@...r.kernel.org
Subject: Re: [PATCH V2 1/5] Documentation: Add support for TI System Control
Interface (TI-SCI) protocol
On Tue, Aug 30, 2016 at 08:06:43AM -0500, Nishanth Menon wrote:
> Texas Instrument's System Control Interface (TI-SCI) Message Protocol
> is used in Texas Instrument's System on Chip (SoC) such as those in
> newer SoCs in the keystone processor family starting with K2G.
>
> This message protocol is used to communicate between various compute
> or processing entities (such as ARM, DSP etc.) with a central system
> controller entity.
>
> TI-SCI message protocol provides support for management of various
> hardware entities within the SoC.
>
> The message protocol can be found here:
> http://processors.wiki.ti.com/index.php/TISCI
>
> Signed-off-by: Nishanth Menon <nm@...com>
> ---
> Changes since v1:
> - squashed the bindings changes for reset on review comments from
> https://patchwork.kernel.org/patch/9291351/
>
> V1: https://patchwork.kernel.org/patch/9291343/
>
> .../devicetree/bindings/arm/keystone/ti,sci.txt | 66 ++++++++++++++++++++++
> MAINTAINERS | 8 +++
> 2 files changed, 74 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/arm/keystone/ti,sci.txt
>
> diff --git a/Documentation/devicetree/bindings/arm/keystone/ti,sci.txt b/Documentation/devicetree/bindings/arm/keystone/ti,sci.txt
> new file mode 100644
> index 000000000000..ed5b8fc185f1
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/arm/keystone/ti,sci.txt
> @@ -0,0 +1,66 @@
> +Texas Instruments System Control Interface (TI-SCI) Message Protocol
> +-------------------------------------------------------------------
> +
> +Texas Instrument's processors including those belonging to Keystone generation
> +of processors have separate hardware entity which is now responsible for the
> +management of the System on Chip (SoC) system. These include various system
> +level functions as well.
> +
> +An example of such an SoC is K2G, which contains the system control hardware
> +block called Power Management Micro Controller (PMMC). This hardware block is
> +initialized early into boot process and provides services to Operating Systems
> +on multiple processors including ones running Linux.
> +
> +See http://processors.wiki.ti.com/index.php/TISCI for protocol definition.
> +
> +TI-SCI controller Device Node:
> +=============================
> +
> +Required properties:
> +--------------------
> +- compatible: should be "ti,k2g-sci"
> +- mbox-names:
> + "rx" - Mailbox corresponding to receive path
> + "tx" - Mailbox corresponding to transmit path
> +
> +- mboxes: Mailboxes corresponding to the mbox-names. Each value of the mboxes
> + property should contain a phandle to the mailbox controller device
> + node and an args specifier that will be the phandle to the intended
> + sub-mailbox child node to be used for communication.
> +
> +See Documentation/devicetree/bindings/mailbox/mailbox.txt for more details
> +about the generic mailbox controller and client driver bindings. Also see
> +Documentation/devicetree/bindings/mailbox/ti,message-manager.txt for typical
> +controller that is used to communicate with this System controllers.
> +
> +Optional Properties:
> +--------------------
> +- reg-names:
> + debug_messages - Map the Debug message region
> +- reg: register space corresponding to the debug_messages
> +- ti,system-reboot-controller: If system reboot can be triggered by SoC reboot
> +
> +Example (K2G):
> +--------
> + pmmc: pmmc {
> + compatible = "ti,k2g-sci";
> + mbox-names = "rx", "tx";
> + mboxes= <&msgmgr &msgmgr_proxy_pmmc_rx>,
> + <&msgmgr &msgmgr_proxy_pmmc_tx>;
> + reg-names = "debug_messages";
> + reg = <0x02921800 0x800>;
> + };
> +
> +
> +TI-SCI Client Device Node:
> +========================
> +
> +Client nodes refer to the required TI-SCI device using the "ti,sci" property.
As I mentioned for power domains, for clients that are self contained
(i.e. a single function) I think the should be child nodes.
> +
> +Example (K2G):
> +-------------
> + my_dev_node: dev_node {
> + ...
> + ti,sci = <&pmmc>;
> + ...
> + }
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 20bb1d00098c..ce7306897ae0 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -11564,6 +11564,14 @@ S: Maintained
> F: arch/xtensa/
> F: drivers/irqchip/irq-xtensa-*
>
> +Texas Instruments' System Control Interface (TISCI) Protocol Driver
> +M: Nishanth Menon <nm@...com>
> +M: Tero Kristo <t-kristo@...com>
> +M: Santosh Shilimkar <ssantosh@...nel.org>
> +L: linux-arm-kernel@...ts.infradead.org
> +S: Maintained
> +F: Documentation/devicetree/bindings/arm/keystone/ti,sci.txt
> +
> THANKO'S RAREMONO AM/FM/SW RADIO RECEIVER USB DRIVER
> M: Hans Verkuil <hverkuil@...all.nl>
> L: linux-media@...r.kernel.org
> --
> 2.9.1.200.gb1ec08f
>
Powered by blists - more mailing lists