Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751329AbeADXwA (ORCPT + 1 other); Thu, 4 Jan 2018 18:52:00 -0500 Received: from mail-sn1nam02on0084.outbound.protection.outlook.com ([104.47.36.84]:52032 "EHLO NAM02-SN1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751193AbeADXv5 (ORCPT ); Thu, 4 Jan 2018 18:51:57 -0500 Authentication-Results: spf=pass (sender IP is 149.199.60.83) smtp.mailfrom=xilinx.com; vger.kernel.org; dkim=none (message not signed) header.d=none;vger.kernel.org; dmarc=bestguesspass action=none header.from=xilinx.com; From: Wendy Liang To: , , , CC: , , , Wendy Liang Subject: [PATCH v3 2/2] dt-bindings: mailbox: Add Xilinx IPI Mailbox Date: Thu, 4 Jan 2018 15:51:31 -0800 Message-ID: <1515109891-17133-3-git-send-email-jliang@xilinx.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1515109891-17133-1-git-send-email-jliang@xilinx.com> References: <1515109891-17133-1-git-send-email-jliang@xilinx.com> X-RCIS-Action: ALLOW X-TM-AS-Product-Ver: IMSS-7.1.0.1224-8.2.0.1013-23572.006 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:149.199.60.83;IPV:NLI;CTRY:US;EFV:NLI;SFV:NSPM;SFS:(10009020)(979002)(376002)(396003)(39860400002)(346002)(39380400002)(2980300002)(438002)(189003)(199004)(6666003)(2950100002)(50466002)(107886003)(51416003)(15650500001)(7696005)(36386004)(2906002)(39060400002)(5660300001)(77096006)(48376002)(4326008)(81166006)(16586007)(106466001)(305945005)(8936002)(47776003)(8676002)(81156014)(478600001)(106002)(50226002)(316002)(110136005)(356003)(63266004)(59450400001)(9786002)(76176011)(54906003)(36756003)(107986001)(969003)(989001)(999001)(1009001)(1019001);DIR:OUT;SFP:1101;SCL:1;SRVR:SN1PR02MB1344;H:xsj-pvapsmtpgw01;FPR:;SPF:Pass;PTR:unknown-60-83.xilinx.com;MX:1;A:1;LANG:en; X-Microsoft-Exchange-Diagnostics: 1;SN1NAM02FT062;1:+39YJBHgMGqK/lalaI4AcJ7vhVEvIK3nxoA+15UqR06wIbM2ekR0/hQ57OCo++ywfvZiX+/ov8TNkUGUgJCpDlxn92pr/M9Fic58pdMpVyLU9WVzhVWnn5QFysSf0Skj MIME-Version: 1.0 Content-Type: text/plain X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 4014d2d7-90cb-4314-63cf-08d553ce21a3 X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:(5600026)(4604075)(4608076)(4534020)(4602075)(4627115)(201703031133081)(201702281549075)(2017052603307)(7153060);SRVR:SN1PR02MB1344; X-Microsoft-Exchange-Diagnostics: 1;SN1PR02MB1344;3:CcqPZ/M7n/wHBNX2HUIXu3j+vHLIPTqEkkG13C/T8FWgUQerp/wG6SCfI+2OUx+2dm4RQeczKQ17EMV+JqOizWIDGxSr+UmTB+zy6LaMMlvhaUA4DB/dNUXELj86yrm+94+cmOMH7j5D7+NYG1It8doKlbsK6a9xilgXUYnKutE09/4QhsD05tqBQ2m2x00uem36c3InX88Ilqi0ham0Cn2Aga8Wz4MR0kQq+QkdDQCpruQQp+33Vgwv1HEdZ4Ybouk97ZjAvr4LVgghVxvHSdOW5JGnJiEvM2WGe8iZFv7ZqZDK6nyGau5zDpHVXGwk5/9x08BgySHjo26w+qGVyLg9C60yrvH48LMbyP3NPQg=;25:+iaziCcKbgEbbaz4aNeA0gmjSlbVx0y4H7+eYMrKGczgIFgbszRmfM1PFsNhDtW/HcFnuEXYHyyDHWlggt4UKqoNuPmXHj4rZRDpMFCnJh77WCalQOfB+/kVEsewg+nsyJryjPXh/Bb2jCzeXCHZIRLnnV4Os9gifgX64tP11h6pi8yEhu3Uz64mPhm3/sA4H7xQf4oXCLBCBEc/ykNMkcJuqla6oE1XTIkZzcoaaXCwOVZt8B3AhQLszmaVE1qcIRLbBJBIa1CLUEHMdAZMipxIOQ/53LIL49f0kNJGZN97kNw+afQ2x8JOzIK/peS7WLuRaDgUnUVwfFepygVN4g== X-MS-TrafficTypeDiagnostic: SN1PR02MB1344: X-Microsoft-Exchange-Diagnostics: 1;SN1PR02MB1344;31:kSBJApStXuyJGvE4hglquXlcjmnBc0Zpql+80hckry++Vvbl+1nCCuIaKTvHd0T4d4SaT/s0WkgqDJY9VFUH2/M7sGnkl0Ve/8WyJizK8x+G3JkBkhnTXCnsglQ+kFmA4cWPB+ZcKbXjQA9T5ZXzVvS4xE+Lou4inCm/wRDgXt/B8BgBDD29X1sumyiaZ/Xbe9Ezb81mx+ygNUIv0dohsn1ZUK/30wdTh0G94IinJEY=;20:IKsDLNpxGQXxyTmy4ypU8UhVCcPinkIA/GDoYuM14yKhQ4pHW78OqraVBejWPQOTTuZk/i7Oj7k5sUv00j5ofXxEJHDZ7V28aTS6Z/1FIgPZk0QeiLhzx+txxn20S2zf/WzzKIzG+yC+SYTTq1V94MvJUkN9jTO8s3BolQdZaCCFZYIW2AxvarIt41B/d8rVBOlkUCe331LVbuHh39SedXZ7pDAEZThTEyg3CC5fh9naGMzZxS0kK+CkBzwtzd9+gltv/EB24CEqGk/2g6znPn9aLL9AVd2Ty+qce7gyHR3x9ACGX+T+6/GKZUp4UQiscMCxWP2SjdnGCUAW0AC0bnMq0Q9sIJVRVs8RWwy28Wz6Xp6pEiJLsdXDvdGMoJK7bbGxrCmz4RmUqmwbaQxaQxg5fV7M3GIpz5BPMvwc118T/kiRZvJreGUlaZysnzYfS0ZTujc4w71yEWWBOs86bQiDbc5oP/QNM3dETuLq/qnb7ymO+P8T6fgA6aKeBBaT X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(192813158149592); X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(6040470)(2401047)(5005006)(8121501046)(3231023)(944501075)(3002001)(10201501046)(93006095)(93004095)(6055026)(6041268)(20161123558120)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123564045)(20161123562045)(6072148)(201708071742011);SRVR:SN1PR02MB1344;BCL:0;PCL:0;RULEID:(100000803101)(100110400095);SRVR:SN1PR02MB1344; X-Microsoft-Exchange-Diagnostics: 1;SN1PR02MB1344;4:xStrYkpYKJDQEHBqUFtMfEssW4DyZ+N1SszJd0DGP+ikzMygUpBKCvV8VtzB2F8UW2TKy1SIikf1RvzuDeb5WEIB7wbBhgzshj68+NRjiuBKHKQC3TXr3gynm1v6Lf+Scpk6voQEoDoFjbi6o+aaGEEJr0xAQs7TQnLDk+iUdb+X+Wy2B3K+aAY7g5k5RYIjTYun5f2bUdC/W31dLsctnQ+KpsCMJL5iVLvgN4wQlWEMiEyoSZIvwVTGX4mkfzUR1O8F9nBjnDzScpLgk8NmsvfaFJoAJAbfDVXotWWn1siBbm2DjikHVM4Wq+sLeC/a X-Forefront-PRVS: 054231DC40 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;SN1PR02MB1344;23:n9bdJanKb21epmIggpnLhO1ENbDfjaHGvDPq01fAF?= =?us-ascii?Q?2v/XiKkwmrKkoyF3atjKuaNYV1EV4XuNdWyldViW1dyW+SHt3zPJqzHQQlsT?= =?us-ascii?Q?kTfxtwZu93YvpybPIHNihHm9oAT6wz50ROjBPn4RdOlaPC/2lOO+4N/Xp5jN?= =?us-ascii?Q?B1su51pD3lO6NNgI37IQUO0tbr+0wjyaiUPyBTSY1vsB/1yXAAacT6/Uwgqc?= =?us-ascii?Q?zpkDPJfeku5VSPS2DVa3Lt8uK++6No+56cEtdCT+/+9PmFdgqGVpd4rVmmh3?= =?us-ascii?Q?JLotODXIfzQ0yl8jX8C2rqeSTkNh1f3flvGifu1ebZ2WnkiYrx9IsL8VJ+Ng?= =?us-ascii?Q?7xSjlRT/aRb+4Ct4QA289wevMxn/3ReTueRiVO+WwCrGsIBoJ+daTbBiw7OT?= =?us-ascii?Q?QPpAFAc7ZLECq/edKtG26Sj5ABxvZ/TkqbACnFGQKrwdDQufhZM8FKCjgdMx?= =?us-ascii?Q?PLM+jFPQG/FH1gIv2ayxCsmCJLgePbC8Gq1dWj2PUzonKZrdFBeO981Rp6cx?= =?us-ascii?Q?w6/1fXtFWvbvf7kIiCJiPUJlWQgj9q3jqMvggAQXNC/6rbzZ0ub6pkeHVVWt?= =?us-ascii?Q?gXYiYIVBe741b3W09IJd/tbs+j1qMOwVh9UmMT5xMo+m0jMaybUMywglD/3/?= =?us-ascii?Q?XU6FRH1u+3lJwKWfWLGbbHnOC9F/LcCKODOPJDb42S/ef10eBRGsQPMi89Kt?= =?us-ascii?Q?NTR1WXmqpsxB3/bIJlt4baLKvglpTvrQyhWu372XRjNcMBvnDh+Kc0sqLp+5?= =?us-ascii?Q?xd044xeg91Kwyii+sUBZNRl6aqXjmnHrnf5gXseut4jP8zWYm3FmUEGAVeRF?= =?us-ascii?Q?vXIv/3/i5eLMYJe2qglNgf85NePIJIoM3IDuRBZ5PATkzCDC9hIVm6lTnn9R?= =?us-ascii?Q?JqeLRcfTdVLkPuSmADfNiQAssgKBabGFadMI+TLItR+iYTsoMOgiEOWyOp8q?= =?us-ascii?Q?aSEzOR1COG3WxcO2mMK208TOABjl8bgimmPv8uRNkde4ocKf7Baa8OhadNaj?= =?us-ascii?Q?JvWXF7CW/OEEwZDmLRt55uVCA+SA5fSKWYosREz9nSG8msG678n/c+5c2vgc?= =?us-ascii?Q?V8Aj7tW7UyMeimoyDf+us+oSQqOSTU8u3VztgQGbQHpDu9Hs2vvt3PTOKiKG?= =?us-ascii?Q?mtKw0ktfHNQJrA6+NEZfV6SMDdxhvwU/ObAZN49QYiPFJgdT6fajA=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1;SN1PR02MB1344;6:whIviNRwqdOWXRR26PB26mrScXpmJvQPxCx9QfGpyGSdL8As8NejBe1GreKDAD/QE0eU57mAPjM7S9V+pKu2DGIP+apP6S60ASgtkrqnK2G7HkIYwZT/guIkRyua7LDNDQF4fQLV9a6Y+3yFQ9gx8x8f/iGW0COO2oX8wyEq6ViTD+b1nn3LgWqgppX9l5TvNMjpod+PtMasxTdvmpu0Shbs3W5CWf4s4/ajkkocqwjbbaA15eu81iiIYD13jp/7t74OVVPA+J6zofNDZNzeE0tzW9kseHQOZooCSunk6SmnopLwRZ/0Il2ZbSq9jIEN3v51nmSXTCdStitdepdTZpGmhLd8K4HY18C9035y7r8=;5:EsApInZcBXDebtO0zayjOPyyz2wrjbGetObHwsWDxpHYZ+Oph3hFpX1Jde1g/838KzmiL6gJHBvFgRJ0gQ16FzWU7LPjxjn/Vj1EeoDXIh5hgJQ2xqy0w6NHNfUcXD1T+ys0/8hwyllShEmQ4n9ADfMTjzM6FWwlCZx1gl8wteU=;24:aEhuQPK9K0gPUwELPsHP3SBHflHKmesS8F8nK223dkq80DYuUi9KsIYuM3X8HTs81PwRM0XnvByte/FB2NgQZ+twwBJ6zb69DPv1qtPChpc=;7:HfIzLy5H46yJ/1c1TscO2HnCw0ucBgPHdCAO1O+zoxS4AuzkRitREiaJdz3DLKcbqbQReT3w77aEevWsDYP6V10KD6yAE4PRAMbf+e8vWNDV4uzont8CP4jn3c2W71dfcGJsIMARpgSKWhpfP/JiACGJtDRqBjIt8e4cYqvH6Jwe+YNjOKQTTGwO2blZ2HoFfU2AHXWHuL/0zzDqvmIDs0/Rw73mm/N0REkkEPG4aRuNrMgr5lISq/KYJdXmf1vr SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 04 Jan 2018 23:51:53.3017 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 4014d2d7-90cb-4314-63cf-08d553ce21a3 X-MS-Exchange-CrossTenant-Id: 657af505-d5df-48d0-8300-c31994686c5c X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=657af505-d5df-48d0-8300-c31994686c5c;Ip=[149.199.60.83];Helo=[xsj-pvapsmtpgw01] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN1PR02MB1344 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Return-Path: 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 --- .../bindings/mailbox/xlnx,zynqmp-ipi-mailbox.txt | 104 +++++++++++++++++++++ 1 file changed, 104 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..5e270a3 --- /dev/null +++ b/Documentation/devicetree/bindings/mailbox/xlnx,zynqmp-ipi-mailbox.txt @@ -0,0 +1,104 @@ +Xilinx IPI Mailbox Controller +======================================== + +The Xilinx IPI(Inter Processor Interrupt) mailbox controller is to manage +messaging between two Xilinx Zynq UltraScale+ MPSoC IPI agents. Each IPI +agent owns registers used for notification and buffers for message. + + +-------------------------------------+ + | Xilinx ZynqMP IPI Controller | + +-------------------------------------+ + +--------------------------------------------------+ +ATF | | + | | + | | + +--------------------------+ | + | | + | | + +--------------------------------------------------+ + +------------------------------------------+ + | +----------------+ +----------------+ | +Hardware | | IPI Agent | | IPI Buffers | | + | | Registers | | | | + | | | | | | + | +----------------+ +----------------+ | + | | + | Xilinx IPI Agent Block | + +------------------------------------------+ + + +Controller Device Node: +=========================== +Required properties: +-------------------- +- compatible: Shall be: "xlnx,zynqmp-ipi-mailbox" +- reg: IPI buffers address ranges +- reg-names: Names of the reg resources. It should have: + * local_request_region + - IPI request msg buffer written by local and read + by remote + * local_response_region + - IPI response msg buffer written by local and read + by remote + * remote_request_region + - IPI request msg buffer written by remote and read + by local + * remote_response_region + - IPI response msg buffer written by remote and read + by local +- #mbox-cells: Shall be 1. It contains: + * tx(0) or rx(1) channel +- xlnx,ipi-ids: Xilinx IPI agent IDs of the two peers of the + Xilinx IPI communication channel. +- interrupt-parent: Phandle for the interrupt controller +- interrupts: Interrupt information corresponding to the + interrupt-names property. + +Optional properties: +-------------------- +- method: The method of accessing the IPI agent registers. + Permitted values are: "smc" and "hvc". Default is + "smc". + +Example: +=========================== + /* APU<->RPU0 IPI mailbox controller */ + ipi_mailbox_rpu0: mailbox@ff90400 { + compatible = "xlnx,zynqmp-ipi-mailbox"; + reg = <0x0 0xff990400 0x0 0x20>, + <0x0 0xff990420 0x0 0x20>, + <0x0 0xff990080 0x0 0x20>, + <0x0 0xff9900a0 0x0 0x20>; + reg-names = "local_request_region", "local_response_region", + "remote_request_region", "remote_response_region"; + #mbox-cells = <1>; + xlnx-ipi-ids = <0 1>; + interrupt-parent = <&gic>; + interrupts = <0 29 4>; + }; + /* APU<->RPU1 IPI mailbox controller */ + ipi_mailbox_rpu1: mailbox@ff990440 { + compatible = "xlnx,zynqmp-ipi-mailbox"; + reg = <0x0 0xff990440 0x0 0x20>, + <0x0 0xff990460 0x0 0x20>, + <0x0 0xff990280 0x0 0x20>, + <0x0 0xff9902a0 0x0 0x20>; + reg-names = "local_request_region", "local_response_region", + "remote_request_region", "remote_response_region"; + #mbox-cells = <1>; + xlnx-ipi-ids = <0 2>; + interrupt-parent = <&gic>; + interrupts = <0 29 4>; + }; + rpu0 { + ... + mboxes = <&ipi_mailbox_rpu0 0>, + <&ipi_mailbox_rpu0 1>; + mbox-names = "tx", "rx"; + }; + rpu1 { + ... + mboxes = <&ipi_mailbox_rpu1 0>, + <&ipi_mailbox_rpu1 1>; + mbox-names = "tx", "rx"; + }; -- 2.7.4