Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753220AbdLDGgK (ORCPT ); Mon, 4 Dec 2017 01:36:10 -0500 Received: from mail-sn1nam01on0082.outbound.protection.outlook.com ([104.47.32.82]:47648 "EHLO NAM01-SN1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1753142AbdLDGgF (ORCPT ); Mon, 4 Dec 2017 01:36:05 -0500 Authentication-Results: spf=pass (sender IP is 149.199.60.100) 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: [RFC v2 2/2] dt-bindings: mailbox: Add Xilinx IPI Mailbox Date: Sun, 3 Dec 2017 22:25:35 -0800 Message-ID: <1512368735-27147-3-git-send-email-jliang@xilinx.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1512368735-27147-1-git-send-email-jliang@xilinx.com> References: <1512368735-27147-1-git-send-email-jliang@xilinx.com> X-RCIS-Action: ALLOW X-TM-AS-Product-Ver: IMSS-7.1.0.1224-8.1.0.1062-23506.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.100;IPV:NLI;CTRY:US;EFV:NLI;SFV:NSPM;SFS:(10009020)(6009001)(346002)(376002)(39860400002)(2980300002)(438002)(199003)(189002)(76176011)(15650500001)(36756003)(8936002)(77096006)(8676002)(106466001)(305945005)(106002)(2906002)(9786002)(47776003)(50226002)(16586007)(81166006)(54906003)(110136005)(63266004)(316002)(107886003)(51416003)(189998001)(36386004)(7696005)(39060400002)(81156014)(356003)(5660300001)(33646002)(48376002)(50466002)(4326008)(2950100002)(6666003)(478600001)(107986001)(5001870100001);DIR:OUT;SFP:1101;SCL:1;SRVR:DM2PR02MB1339;H:xsj-pvapsmtpgw02;FPR:;SPF:Pass;PTR:xapps1.xilinx.com,unknown-60-100.xilinx.com;A:1;MX:1;LANG:en; X-Microsoft-Exchange-Diagnostics: 1;SN1NAM02FT063;1:FQ2B3BeSWY5uey1AdrSjIi88iHgRSl6D0BDc2JsEEeXs8kDDO/DxzF1N/e7wNbpyAWK0WBuGge3UZv9Zjh2NReb36bcY3WPOfxeKXr8MsBCr0nDqvyvXi34fjXYSkv8a MIME-Version: 1.0 Content-Type: text/plain X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 0101b2dc-e538-40af-52b3-08d53ae14931 X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:(4534020)(4602075)(4627115)(201703031133081)(201702281549075)(5600026)(4604075)(4608076)(2017052603286);SRVR:DM2PR02MB1339; X-Microsoft-Exchange-Diagnostics: 1;DM2PR02MB1339;3:TrEDqH7Ecrv/ClfIAy+NkDCDwW4kuOyoZs86W8LjGyUc5wqjyMvOnCMzihWiIT8kQWAJTZlpMIEtv9rpt3Z7s+dxAgDepa7aadbZ3ScNNjcXPYPj7BzTzEN0S4+cdMCZ4/8FwO6X3zeXZ52rzp3CTdz2NMfQdkTZxpvK8c1sRMyy512kg6LBP5AJm0j7v60hU4Mwz3OftT/Qn/39oyO8OXE7gXQxlNwbCgZEcW3VP7B8W4USCuBde7gqQ9WNBy8uPOh6CRhRAnUm850nkp+lG1eVn9OdGm2iKopDnRE30JboHn+r7F8VtUjYcw3xQ1HJkOFmFDfOL/x1+a8fHR2AxiSCBGKogpy8cDLb3jFml9E=;25:OHa28cqtp4SMTQJeW1cO/Vi0D3OnVyR9qra1RN6iiaG6thC88YiSwGLzJ6eEC6iBPprGqr9Y7qUWROy356LBe6/eJBQLdTkv4v5shz3JsmAZu09ryhTGUXbJ4AZv7s6BCqr0YauAWdc5rhGSGBRkzJWLDxsWPIKUTLGiBo0Dy0D0I+cyerpb3m2o5q7sAvh9BssnSBIAqPMeHMAoPBvTe5S17vL/VcM3b0J4kKqPWA0SlgNYx3tG1IXiHOXxE0plXi8NmcURV7TShfQjsJlkiraTK0VKZVJOXc0n2Dp/9n7aafdl2q6c6FoRXn3IQyO/bmpebjZwEmoiqw9grWZiJQ== X-MS-TrafficTypeDiagnostic: DM2PR02MB1339: X-Microsoft-Exchange-Diagnostics: 1;DM2PR02MB1339;31:4zZxt/40yQRU/XA+zWmOWKR91vuOkCLCwU2GwjHOxnp6M+rY62n+xLJc+rv0McCMkabgfY5kWnUyTb9hAiZ/YRrI4SOSpFeZY8v3y4ZoGQllk4jp9Fd8Nut7NiVP6VWonB13Ar/ZxrNBYvgtl1Vp5RUMUfuWhOzBbNZNo5jsLqZPTImI4p70lITvEwPkMEpK1sTAWadGnfyxA5JgBHhFNjyGxFkOghV5tFwIjF9uJR8=;20:o8YmzlSVlQmjduJ96HWI3biu5jhBqM621ST5u6Q3Y9izqGgCzNEV1onRSRRggHv7kf8KietAcCOWBOgzMf9nt1gn9OMUOU6Hq1ZpZoq2WcDXZePnhWCn9pXCsXexfmEIwIk15rt2HxxZWV8Z+d4mfGDuPDFz7KdtobT2WTv0EMK8Z88DKannbeDKtwMYPayapFdQBhYcHhVtVuF5D34+u6M6p77JYKfogmY5uHSsb+6480ePvZdo7JJSrUPjoQbW1dTNic/ZP3zuKvjhAs6EUBELsqrVWcTeyUpWR0G/eB0HI+9M47P6HWdCCv10CfY3gkdY8MuB/XMiQzLRgucIY/PaLAFCiXXCamquuU4ahySYpdjsbqzxwpFztk4PUNIzLmulPPGeqbedpULOFiP6ylrN4VtyVL+meUL4kZ2qmlgSzfYeIWdHln8Mx7XWo4TTtOoAKZO6XPo92GllyZo/hwlGO4PyPTXgLceyaWkLwiLXJUxndWvMpkZYo3Z38NyA X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(192813158149592); X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(6040450)(2401047)(5005006)(8121501046)(10201501046)(3002001)(93006095)(93004095)(3231022)(6055026)(6041248)(20161123562025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123555025)(20161123564025)(20161123558100)(20161123560025)(6072148)(201708071742011);SRVR:DM2PR02MB1339;BCL:0;PCL:0;RULEID:(100000803101)(100110400095);SRVR:DM2PR02MB1339; X-Microsoft-Exchange-Diagnostics: 1;DM2PR02MB1339;4:B9cLq4YdbXquFzuQeDgq3sgeej0JLyirCey+VA2rRNAF5bf/C3oZ/fSGrJGOpA0PUhEi13Vu9H5quG3zAwDI9Ynt2uzMaNgWPfkSDHBq30cRJ/vNQiOKTtwCn5Si7AFmN8/HVcrWGdrEvQ/KXcSJiwmff8qycWeEdhijx2xAM1T2f9Wz9GrP74tBPyPbPeq3aOIfNC2tbqHi+qpGuJGfTi161sAFNcSMwp1ntHdVPoh8JSvsZHQAiWwYX48qZMDyLZ1Xw4BKz3mUVSuIa1Eyx5qcEAEi2eavnZW9crj+7CoLq9htzxUx5ruM58UjdRpB X-Forefront-PRVS: 051158ECBB X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;DM2PR02MB1339;23:IW2MkKL8gOVFGuaGwP6lviCIxUh7NWCM1N/hJFfmX?= =?us-ascii?Q?0yqT0wWqOK+5XG/tqNdAyiHBBNkNKpDxSIZctC9spPX/3ShjaQN5BG4elxS6?= =?us-ascii?Q?MC2B/edoV5KlU0A/18pJZFVyLyNQoxXZeAIAQa1hzlGuuuIPW7eyRc+NHy09?= =?us-ascii?Q?VuuzSHw4qwMlgv2b2B6TeqeoNzVdKmQ646df80nXdwjfOEkc8FQQyX2crGXO?= =?us-ascii?Q?D7hNn/ZmqeYj20m5zg0u3/KMyTrPe1Ug3ezzMNA9aVwSTFAThatPIJQXKq8X?= =?us-ascii?Q?jX2/mOjTzheFZaJY+AGucOcgEGqJI08letz87zVhxEx8sdxyAbYEO8aAjHjS?= =?us-ascii?Q?Gi+F6mrhXrTXFvClFm0Ovj57XX3pG38/0Hi+LsnUMwg+Wj2LlIKL2Q6XMLyu?= =?us-ascii?Q?eeAwGG/buDU9D6etv8vCz8cSC1o8NBobUwPC1YV6BVCdJimbUcQ2CHfA5BuO?= =?us-ascii?Q?vCfoqlMQVfEqA4uhg/qtIj01TH87ynjUIoDpwxC2BPps8YX3B41XEmz1cvcb?= =?us-ascii?Q?J+N379RQgmgow0WjFd4jTLh9ns5A+jLBDlOwsm5WORcsMzztiqFxLxK8o7II?= =?us-ascii?Q?GxKhARiuXqNXqQIjFSH89xnqO6qsXRY2kbJurHUaLdWmeN9xdoPSQQqxU3Wj?= =?us-ascii?Q?jT+f6n8Xk1dN8Pj0frRNz/aOLeJcraU6/60/+qyO1ng7FmfNKsi+bpS6BZzJ?= =?us-ascii?Q?wywgnCdU4LSpF083OGxjIBD7mshzgaGq+jUax9tIpeUpDUXHmDYYoO/g+yPb?= =?us-ascii?Q?DzzRAUFOhZr59qUuYxPRAbezBvLcaxqnjh0y9icdVo8q0O9mhj8f2oyjL+uS?= =?us-ascii?Q?7bvju8HOLjAjJOZzaDNp74VYKAfvWCYWHs1GkRMloAnjYexdbMLwMNFpmTVH?= =?us-ascii?Q?yIV3HEvbFAxjzN669360G+Hf042HTZHNoz2maDyLAC8+s+V5cGQLX/B6eeRU?= =?us-ascii?Q?2A04d1EvLuqze/gqNElgQPtuKkw84fj0J5tVctx93PI2P7Fa4kEzxmNmzIoI?= =?us-ascii?Q?Xu+B9I74q0A877olwzz05Nz/Mqv8Bmv0Q3c7ICZj2q5cZvClKVj3QwMXpJIN?= =?us-ascii?Q?8ZY2y6r7E6aj+eAFXiuux/w7ETa?= X-Microsoft-Exchange-Diagnostics: 1;DM2PR02MB1339;6:umcZVZSQ/lOORhvKF+iA0p5dwpAuN0mDvjHd21fUFgnzepQlW4AsCSUOJ4pNdhV4XOegqRP0Ag4txhc8LH9LecEjG3BZvtnbHXYRBVTBIim62h/L1IQLTl+0oluL0FD6nRtb0FYUEpZ1/p02mYHAIo/lYIQq1Lg6ab4kPaO3Z7mQcAwgPmRowigAUX0XWI3kjzav0SVLOcoQI7W+ZKVTRdz6TInKDHN/oqTFIUGD/ZhTytmhgq1FnV45BTGFW6ogDy/zbPR341MIPFPXYxCvWafefh2h1cIJ1fAEkuBxBPRVzPmA4KXiQkVRiHGxGECH0ioh1Q7qZcT8zU6jx7JnACgaq6bp3+jIXlws4QroPeM=;5:HGbrXSARd01WFCQV5nkPZ8DNjqRzhJdljeZ8nwOtdWRP/EwPc9M8b29wIsvwlOJSOPZRg6dRXle6KSWPyIYlbs3Xij+o3DASifWhdLSYbOMLSne7UgR9cGGNYkK7unWbWEaIlCBLiNNYJre0/NZT1deMqUQU243oVKvRzLdvfJc=;24:q4/OgU2MObWYXKbPAUgZk2Efo1ltzVvIc/G5KeEehX3hLcrU7ATbwOhJUtYEPpAprDUrmZjjYMo6q28lwrSGCMqX27BYM+0hBeClQNfm4l4=;7:yJDDC12a9ad+hBWG1SDJKP+JEekvVrnCLoFe+K4nzDnhDN0sNfGFkCGZ45X9gNI2vIPtu7hnxkd8az+1NTWW2vkeyTeg6SeGuH0npukLMgy4KJ2INmFRdJvS/7nRSaXcvSzvsNinAmupvmTt5A7O5F0ibcxzLLrJExdTAHgjISlATl5Mlh9/wVCiLf3JHrksNf+9kpg/L5AejJ5HISJaX924pAkYlB59ofzbbe717GBOOQlOutvHbQqKcNkiV9IM SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 04 Dec 2017 06:36:00.9846 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 0101b2dc-e538-40af-52b3-08d53ae14931 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.100];Helo=[xsj-pvapsmtpgw02] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM2PR02MB1339 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 4574 Lines: 122 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