From: Jiaying Liang <jliang@xilinx.com>
To: Sudeep Holla <sudeep.holla@arm.com>
CC: "linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>,
        "linux-arm-kernel@lists.infradead.org" 
        <linux-arm-kernel@lists.infradead.org>,
        "devicetree@vger.kernel.org" <devicetree@vger.kernel.org>,
        "jassisinghbrar@gmail.com" <jassisinghbrar@gmail.com>,
        Cyril Chemparathy <cyrilc@xilinx.com>,
        "Michal Simek" <michals@xilinx.com>,
        "robh+dt@kernel.org" <robh+dt@kernel.org>,
        "mark.rutland@arm.com" <mark.rutland@arm.com>,
        Soren Brinkmann <sorenb@xilinx.com>
Subject: RE: [RFC LINUX PATCH] Dcoumentation: dt: mailbox: Add Xilinx IPI
 Mailbox
Thread-Topic: [RFC LINUX PATCH] Dcoumentation: dt: mailbox: Add Xilinx IPI
 Mailbox
Thread-Index: AQHTMy74PWGgZB9l/UWdWBL7zW7KlKLAaPZggABXW4CAAFnhcA==
Date: Fri, 22 Sep 2017 17:37:07 +0000
Message-ID: <BY1PR0201MB088507AE303DC61E172DDF5BB0670@BY1PR0201MB0885.namprd02.prod.outlook.com>
References: <1506034724-14639-1-git-send-email-jliang@xilinx.com>
 <BY1PR0201MB0885E6563EBAFE83DF8822A4B0670@BY1PR0201MB0885.namprd02.prod.outlook.com>
 <20170922111005.GA11613@e107155-lin>
In-Reply-To: <20170922111005.GA11613@e107155-lin>
Accept-Language: en-US
Content-Language: en-US
spamdiagnosticoutput: 1:99
spamdiagnosticmetadata: NSPM
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Sep 2017 17:37:07.0319
 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 657af505-d5df-48d0-8300-c31994686c5c
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY4PR02MB2534
Sender: linux-kernel-owner@vger.kernel.org
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
Content-Transfer-Encoding: 8bit
X-MIME-Autoconverted: from quoted-printable to 8bit by nfs id v8MHbJF5025701
Content-Length: 6227
Lines: 163

HI Sudeep,

> -----Original Message-----
> From: Sudeep Holla [mailto:sudeep.holla@arm.com]
> Sent: Friday, September 22, 2017 4:10 AM
> To: Jiaying Liang <jliang@xilinx.com>
> Cc: linux-kernel@vger.kernel.org; linux-arm-kernel@lists.infradead.org;
> devicetree@vger.kernel.org; jassisinghbrar@gmail.com; Cyril Chemparathy
> <cyrilc@xilinx.com>; Michal Simek <michals@xilinx.com>;
> robh+dt@kernel.org; mark.rutland@arm.com; Soren Brinkmann
> <sorenb@xilinx.com>; Sudeep Holla <sudeep.holla@arm.com>
> Subject: Re: [RFC LINUX PATCH] Dcoumentation: dt: mailbox: Add Xilinx IPI
> Mailbox
> 
> On Fri, Sep 22, 2017 at 06:05:18AM +0000, Jiaying Liang wrote:
> >
> > Xilinx ZynqMP IPI(Inter Processor Interrupt) is a hardware block in
> > ZynqMP SoC used for the communication between various processor
> systems.
> >
> > Signed-off-by: Wendy Liang <jliang@xilinx.com>
> > ---
> >  .../bindings/mailbox/xlnx,zynqmp-ipi-mailbox.txt   | 88
> ++++++++++++++++++++++
> >  1 file changed, 88 insertions(+)
> >  create mode 100644
> > Documentation/devicetree/bindings/mailbox/xlnx,zynqmp-ipi-mailbox.txt
> >
> > diff --git
> > a/Documentation/devicetree/bindings/mailbox/xlnx,zynqmp-ipi-
> > mailbox.txt
> > b/Documentation/devicetree/bindings/mailbox/xlnx,zynqmp-ipi-
> > mailbox.txt
> > new file mode 100644
> > index 0000000..5d915d1
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/mailbox/xlnx,zynqmp-ipi-
> mailbox.
> > +++ txt
> > @@ -0,0 +1,88 @@
> > +Xilinx IPI Mailbox Driver
> > +========================================
> > +
> > +The Xilinx IPI(Inter Processor Interrupt) mailbox driver is a mailbox
> > +controller that manages the messaging between two IPI agents. Each
> > +IPI mailbox has request and response buffers between the two IPI agents.
> > +
> > ++-------------------------------------+
> > +|                                     | Xilinx ZynqMP IPI Mailbox
> > +| Controller|
> > +|                                     |
> > +|                       +-------------+
> > +|                       |     SMC     |
> > +|                       |             |
> > ++--------+--------------+------+------+
> > +         |                     |
> > +         |          +-----------------+
> > +         |                     |   ATF (ARM trusted firmware)
> 
> I suppose it should work with any EL3 firmware, ATF reference can be
> removed IMO.
> 
> > +         |                     |
> > ++-------------------------------------+
> > +         |                     |   Hardware
> > +         |                     |
> > + +--------------------------------------+
> > +                               |        |
> > + +----------------------+ +-----------+ |
> > + | | Buffers between    | | IPI Agent | |
> > + | | two IPI agents     | | Registers | |
> > + | +--------------------+ +-----------+ |
> > + |                                      |
> > + |   Xilinx ZynqMP IPI                  |
> > + +--------------------------------------+
> > +
> > +
> > +Message Manager Device Node:
> > +===========================
> > +Required properties:
> > +--------------------
> > +- compatible:		Shall be: "xlnx,zynqmp-ipi-mailbox"
> > +- ipi-smc-fid-base	Base offset of SMC function IDs for IPI mailbox SMC.
> > +			It contains the IPI IDs of the two IPI agents.
> 
> Why is "SMC" associated with this hardware block ? Is it secure device ?
> Can Linux access it ? If so, why do you need SMC ?
[Wendy] one IPI agent uses its own IPI agent registers to notify (write to register to raise interrupt)
Other IPI agents. The IPI agent registers are shared between secure and non-secure.
And thus, I think about to access the IPI agent registers in ATF. And thus
Use SMC for registers access.

> 
> > +- reg:			IPI request and response buffers address
> range. It
> > +			can be the IPI buffers from the hardware or it can
> > +			be carved out shared memory.
> 
> It sounds like buffer used for communication and not part of this IP.
> Shouldn't this be part of mailbox client binding rather than controller
> binding.
[Wendy] the IPI hardware has IPI buffers (32bytes request buffer and 32bytes response buffer per)
But we also want user to be able to use other shared memory.
The reason I am considering to make it part of the mailbox is, we can have logical
Channels on top of the physical channels.
Each mailbox controller controls the physical connection(IPI agent registers and buffers), each
Mailbox client requests for a logical channel.

> 
> > +- reg-names:		Reg resource name of the IPI request and response
> > +			buffers.
> > +- #mbox-cells:		Shall be 1. Contains the logical channel IDs of
> the
> > +			channels on the IPI mailbox.
> > +- interrupt-parent:	Phandle for the interrupt controller.
> > +- interrupts:		Interrupt mapping.
> > +
> > +Required properties:
> > +--------------------
> > +- method:		The method of accessing the IPI agent registers.
> > +			Permitted values are: "smc" and "hvc". Default is
> > +			"smc".
> > +Example:
> > +------------
> > +	/* APU IPI mailbox driver */
> > +	ipis {
> > +		#address-cells = <1>;
> > +		#size-cells = <0>;
> > +		ipi_mailbox_apu_rpu0: ipi_mailbox@0 {
> > +			compatible = "xlnx,zynqmp-ipi-mailbox";
> > +			reg = <0 0xff990400 40>;
> > +			reg-names = "apu-rpu0";
> > +			ipi-smc-fid-base = <0x1010>;
> > +			method = "smc";
> > +			#mbox-cells = <1>;
> > +			interrupt-parent = <&gic>;
> > +			interrupts = <0 35 4>;
> > +		};
> > +		ipi_mailbox_apu_rpu1: ipi_mailbox@1 {
> > +			compatible = "xlnx,zynqmp-ipi-mailbox";
> > +			reg = <0 0xff990440 40>;
> > +			reg-names = "apu-rpu1";
> > +			ipi-smc-fid-base = <0x1020>;
> > +			method = "smc";
> > +			#mbox-cells = <1>;
> > +			interrupt-parent = <&gic>;
> > +			interrupts = <0 35 4>;
> > +		};
> 
> Why do you need the above 2 ? They don't look like 2 controller blocks.
> You just need to represent single mailbox controller.
[Wendy] I just wanted to have single mailbox controller to control one
Physical connection and allows logical channels on top of it. Is there any framework
to support logical channels on top of mailbox? Or we need to write the mailbox client
driver to support logical channels on top of one mailbox client?

Thanks,
Wendy

> 
> --
> Regards,
> Sudeep