From patchwork Tue Oct 17 18:33:04 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jiaying Liang X-Patchwork-Id: 827230 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=xilinx.onmicrosoft.com header.i=@xilinx.onmicrosoft.com header.b="ersR/Ids"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3yGkg50CN2z9t30 for ; Wed, 18 Oct 2017 05:46:25 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1760235AbdJQSqX (ORCPT ); Tue, 17 Oct 2017 14:46:23 -0400 Received: from mail-co1nam03on0086.outbound.protection.outlook.com ([104.47.40.86]:9184 "EHLO NAM03-CO1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1756185AbdJQSqV (ORCPT ); Tue, 17 Oct 2017 14:46:21 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xilinx.onmicrosoft.com; s=selector1-xilinx-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=dAQyDQcfzLxxzPZOmhqblzJIFLDO03aimzm7yGEungw=; b=ersR/IdsebFzLhYkhRPnC8OekEZJkrktc/dkeeQNKGgfWZf3IhOUMe4/I6Wvqvv5CrUeQo4FXUYiCkwSD8A/Vj7XfNTNWk1dHRqHzwvlsBORSXNR/ZBn81PxhcLoAj+H6iqbVyODtTGXm+CweJhYT9radeUrXVHP11IF5bkHMrI= Received: from CY4PR02CA0015.namprd02.prod.outlook.com (10.169.188.25) by CY1PR02MB1335.namprd02.prod.outlook.com (10.161.170.26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.77.7; Tue, 17 Oct 2017 18:46:18 +0000 Received: from SN1NAM02FT032.eop-nam02.prod.protection.outlook.com (2a01:111:f400:7e44::204) by CY4PR02CA0015.outlook.office365.com (2603:10b6:903:18::25) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.77.21 via Frontend Transport; Tue, 17 Oct 2017 18:46:18 +0000 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; Received-SPF: Pass (protection.outlook.com: domain of xilinx.com designates 149.199.60.83 as permitted sender) receiver=protection.outlook.com; client-ip=149.199.60.83; helo=xsj-pvapsmtpgw01; Received: from xsj-pvapsmtpgw01 (149.199.60.83) by SN1NAM02FT032.mail.protection.outlook.com (10.152.72.126) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.20.77.10 via Frontend Transport; Tue, 17 Oct 2017 18:46:18 +0000 Received: from unknown-38-66.xilinx.com ([149.199.38.66] helo=xsj-pvapsmtp01) by xsj-pvapsmtpgw01 with esmtp (Exim 4.63) (envelope-from ) id 1e4Wsb-00038r-LQ; Tue, 17 Oct 2017 11:46:17 -0700 Received: from [127.0.0.1] (helo=localhost) by xsj-pvapsmtp01 with smtp (Exim 4.63) (envelope-from ) id 1e4Wsb-0001Xz-HE; Tue, 17 Oct 2017 11:46:17 -0700 Received: from xsj-pvapsmtp01 (maildrop.xilinx.com [149.199.38.66]) by xsj-smtp-dlp1.xlnx.xilinx.com (8.13.8/8.13.1) with ESMTP id v9HIkEMO004104; Tue, 17 Oct 2017 11:46:14 -0700 Received: from [172.19.2.167] (helo=xsjjliang50.xilinx.com) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1e4WsX-0001XQ-WE; Tue, 17 Oct 2017 11:46:14 -0700 From: Wendy Liang To: CC: , , , , , , , , Wendy Liang Subject: [RFC PATCH v2] Dcoumentation: dt: mailbox: Add Xilinx IPI Mailbox Date: Tue, 17 Oct 2017 11:33:04 -0700 Message-ID: <1508265184-17799-1-git-send-email-jliang@xilinx.com> X-Mailer: git-send-email 2.7.4 X-RCIS-Action: ALLOW X-TM-AS-Product-Ver: IMSS-7.1.0.1224-8.1.0.1062-23400.005 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)(6009001)(39860400002)(376002)(346002)(2980300002)(438002)(199003)(189002)(106002)(2906002)(8936002)(6916009)(47776003)(36386004)(77096006)(50986999)(4326008)(5660300001)(63266004)(6666003)(50466002)(107886003)(54906003)(8676002)(2351001)(81156014)(33646002)(81166006)(106466001)(316002)(478600001)(15650500001)(5003940100001)(356003)(50226002)(48376002)(189998001)(36756003)(305945005)(9786002)(16586007)(107986001)(217873001); DIR:OUT; SFP:1101; SCL:1; SRVR:CY1PR02MB1335; H:xsj-pvapsmtpgw01; FPR:; SPF:Pass; PTR:unknown-60-83.xilinx.com; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; SN1NAM02FT032; 1:nME++lz3i47hbixMkMnO42IibxqDhpXyUXe/CL9BvyU3Wu7phim5g3hhTqhUPkZ8oCLPJsmTJdDkvDwcCPDu4oX1RKUPn7GbMay56fbrR2/L+A0pATMC7OgUN2M9fgIj MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: a637841d-b6a1-4686-72cd-08d5158f5a76 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(2017030254152)(8251501002)(2017052603199)(201703131423075)(201703031133081)(201702281549075); SRVR:CY1PR02MB1335; X-Microsoft-Exchange-Diagnostics: 1; CY1PR02MB1335; 3:QlrocpS/Pm+aycicsvzzxBZwW1kzs9mK0ukVNat21PMrwY+a5JKpAuEUSZbebQlHy5NKAa/PrVy7AtMCZC4BjzDS6jkoWfdUYGIgGm9gtd2vkOm7KonDGlsjSyzGUlnc39u7frCbRONboaXDDydcsoetkmwu5/Dh6oBCAJnWnLzPQEjrwuFRCtnXafEtZR3ELaNQVsttTHZDi7kw+JwFtWgh/Fl4PonH7st3yRHLoEDzFyhbeLCSUW5vsnJnqKxYhEW+pMdeH9IVYOsMXOMEP41GfsoFg/airy+PTWN3lRZ5RuNFf+SYkb3jZflZM0c4DqWaEIFZUvoYuqZVcOKK4XKwz9Ny/W3JF/N1xERCywk=; 25:nsFc9CVf4ezVleJ+xTNAGLUDE84+cqQA96QSHKybI5E7lVpr2qokJLhPdS5nBfh0JdDdFNBIBcmnUPAjnJomadmrFxnihnNp3PveOHjoyjsbtsAFaVhnp7w+t+ycfGAOQm+BiMBXTCYe6Hb0yhQZ3UpoJY8AQ7ac80RRwNk2Vs9uXb0z1oH2X8VcxtHhpDlldiLpmHIaEHyHTST3kdjt07KHBYwbZ693E5C0llMFwmdomsbMc9XiLFU9guP/v7c81oY1opoqM1bBbMyvcbtd4qybq+cK9BhEBE2gntmIeUN2UzVCmlMD4FqKMAHA4kBtZOMqPxestCWJOxGCstK33Q== X-MS-TrafficTypeDiagnostic: CY1PR02MB1335: X-Microsoft-Exchange-Diagnostics: 1; CY1PR02MB1335; 31:op42W3eFEl5N1+ILQNFXzRBiKe1rvtFzEukC5agesYpX7MDK2PHXt7Dd6HmbxSM59m/6J8BOWe6cgOv/IVVi3OkzYwniVYKftDWPzdYDexZqAlXPDhVGYRGP8MTlyCJvV8CDvN4KJ8yTn09jJ3agYWGdliW7ttzwRHFx+SO4iJVK17qA2vWdB60XvI7gLz85eUQAT+kPEGW/yycwJ4CyyTPKIu24sDgd5Qo2NFxi1KI=; 20:3s3oD9jdDuUAcFa4m2k86oKqrlJelErHpmNxYF8OZ/iZ7vC09xYS8Nm5hwBkYM4OILbYoNHc8wX+m+kbk2WeS/wBaFKHQmyQdCg+O3G7Oaa9cc7l6idZ8vZm2iIK2dXhoimMXvgjOH8b7C7GKbCR6DGeP/zMzfoydzkumv4JEGWC+qL+6IqLefTIJ25eIarJkTV9z03lHBSAw9Amya8p2V+yDRdqL+sfLI2TMrROdXOtiklvyylud93qUXD8RJHp/DvFTM+XBer6OmAyLJ+N7byGtqaTu7JMSocWitCy+48Q1f3Yi+kN+BIvyL2IK+qwvh/MyPT0ShxmnqpvJ9bn/C0Tg76YkEE5iFsnlmbhRBE3VrDabq5/yzR6uz+78CJUy29Cm+tDryTc4/k81dDofwIBdmpp83Lrs0iwap3L5m6wY3VRorue66dzoXrzvMTwXSLZrai8Ew8JyDqxhF/wwPpgDUFHyETwAdziwLkg2uGuyJiKWbjMVxu7t4os06df X-Exchange-Antispam-Report-Test: UriScan:(192813158149592); X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6040450)(2401047)(8121501046)(5005006)(93006095)(93004095)(10201501046)(3002001)(100000703101)(100105400095)(6055026)(6041248)(20161123560025)(20161123558100)(20161123564025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123562025)(20161123555025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:CY1PR02MB1335; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:CY1PR02MB1335; X-Microsoft-Exchange-Diagnostics: 1; CY1PR02MB1335; 4:dwA7zanatHJTbFYcOoUk/2NwGmvm5HcZOEUEVsjeQ+zvuFrgJURSCK43B83oAZZy2pPeWOp6YKOtE8GDhllOC+sG0t8CRuQvQKpib55V64DK5NodCYhxYTyk6cc1U6avN+RJKVKHUeuUi+ukqIn/r1uC3nySAQd1sV3GEhAUDuyc/N/H3I8Q80u3+D5JH956h3OcIepBE1ux3bXQBRmauHhWUnY/qX0ABcO02G7h5APtxtGiFP/5PXV5/z3ZyfPQ5z9+5YyOnw9iM/ku0KLL2C8NlZ+AOiJWUDyyjcgjMi8= X-Forefront-PRVS: 04631F8F77 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY1PR02MB1335; 23:HxqALfBFne1rSXQiCYmbN4ldenSp7nxe+z+9Fn/RC?= 1gwW75DmsFWASKVp5NvU/8Q0FytsiGvF9B4bfmEN6GFprlSWZLRAR0KBHOzB9cumcqV2jR+YBA7i9Z7yF8WKWsN0a5pjer+jpjgRSpYJhCWWoyjKG/Ux87pMl6by8JxDG+YIQG6EOnbaJ13uFtoSSQPUyQ76NN5s44VAV6eZnMnDsEhlu7mgjcTacRJeIa2W3jhlP7yi0plRPEwgqY60LcFBVfRXP85by5pPL4WJ8vJboHlT5fmCxgQ6541ZDoU2IaOahQ+IjQ54TM8sNgcRHvRKITUHkE8xFBPBB7Lb/jMYtue2/dTsdlb0UL1CcdCnchXpzPX6sInLn11bgWNjhDOuhv3uWTtgmFmNW/BRKskmrRpJuGjrLE1uO6nWjlx6elSXtLnFJpct60XwxfeSpq7FzdJECUlNaTdaykrif3Rcowab7O5CGglttPPUcv2saAvmcZ9xwEs9yMvMGpj7N3ZnCChNKK93v24qxysv39exr/KCxSs85vmVccAQ/PdVuLWXZ975sX64nmdKKwXBpaZVcStB/rUrMZsv5AixmBJhCWmv9gzp+W5iBuJ3OAqJu/jhEMJnGZlNq9QhJAi7UR5u6gB4CuEtoD1f7hmyI0O6+Dq2UxlZl6FueaFiksbIuxSpruGu0xkG46VQ7TvA3z0cfwM3HdGJyDCe8SG3WLeEh0WUiMOVo0JJ8ejdekBczY8CbTJVfrAmswP6X0e+BA3m/PnyhPDcDulWYnfo6hXhJ/ASUwPHwovBAW+69PqwsA4l/ePp8rLlbT4BJdxJjKYEFtM6sqmOErIKX2gX35m3HyErgk2lZUYe+gf0qrpfNgDF4EJilEhGJFXdrtqJU0Wl+xLNbP2e19QYPH/PYmuOj51fulExLqGlRrttngCNHCMiv/r6oyxa0ox81ru6+HKQAIvwjJPoSP6ZUQudXxylh1lvs3Seu/DlqKPuI3kthhiZfCLoUkNrF6Ya7GakxgCWyxcZOrhN81h0ScHmQvjxw== X-Microsoft-Exchange-Diagnostics: 1; CY1PR02MB1335; 6:7AqlsVPo0j9ZM4EscaAuBRVCbjdSIY1O34lzwQ+3MSTvDxlh9BhGSFSLqWA2ycjhySUo5eI2PGEHdIirNhnRvHhs760wJYsw2xbjdB3s21LCMKySZIbfc+JZy1kPEE7od32TOhi+4FOccE21Gh5qS/W9kH8Yq/8wVvownURumF6aM+qFZbPJlbUda6+HjhFepgLR9UYhmhSIKipzmwoIcYkOKpjaboyTJS2RJB7hyoZhgTZxaTS7+LfJqX+4Etg9HrNoFnwFkiqD3vxaYsmRoV4Niz5xKWjMuc2SySXeS+WG2HhnavaUR22BftYQgWvsdom9pnBbCgkvAPGppQE7HA==; 5:laRPC+6gz6sCiDKm/xlmSKZD+q+IPaoA28GI/mzf+Ay4qo9QwpNH2EOwDo1YEPSVrGs/Su/YQtX5pthUNHDeovG8SHA9r7r7+kCX/hMODPB3yG+V/lAIuj0A0/bUyLWStZy/O6eZKVFCK3XUYN44jg==; 24:4v3AMJKlqiyXGE8GRG2NkY12P9HMo/QyUirDir5AJlyWbxzh1d+/Jo7YAg8FxPjlIMCkggRMj/ep/WzzPPBkAW8ERN3LA9dV/58c6/YXPMc=; 7:zBD9mxZWIz670jLSl+HE+E8ADSDBYRiYPV3SfyicxUsoLMBAcgJRKAOMjsP8u5VhP9bTYUU0rDTfYGpLYtbP1rcJtLewYxHP2CH84bUvR2g9LSKG3pCC4RueRoucsEB5YesFw0GZ8OdxNiT+JIYHBPS9rEvqS1NFdlMBM7dmigAAi5SsETU4hk9YXRnfq7IwWa0JZ0sgtjW6VGZAanm7REUXW7Y3OCo5c3vTiMKKz30= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Oct 2017 18:46:18.2043 (UTC) 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: CY1PR02MB1335 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org 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 --- V2: Each ZynqMP IPI mailbox controller instance for one physical connection between two ZynqMP IPI agents. --- .../bindings/mailbox/xlnx,zynqmp-ipi-mailbox.txt | 103 +++++++++++++++++++++ 1 file changed, 103 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..ba02b93 --- /dev/null +++ b/Documentation/devicetree/bindings/mailbox/xlnx,zynqmp-ipi-mailbox.txt @@ -0,0 +1,103 @@ +Xilinx IPI Mailbox Driver +======================================== + +The Xilinx IPI(Inter Processor Interrupt) mailbox driver is a mailbox +controller that manages the 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 range +- reg-names: Names of the reg resources +- #mbox-cells: Shall be 1. It contains: + * tx(0) or rx(1) channel +- ipi-ids: IPI agent IDs of the two ends of the + communication. +- 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". + +Client Device Node: +=========================== +Required properties: +-------------------- +- mboxes: Standard property to specify a mailbox + (See ./mailbox.txt) +- mbox-names: List of identifier strings for each mailbox + channel. + +Example: +=========================== + /* APU IPI mailbox driver */ + ipi_mailbox_rpu0: ipi_mailbox@0xff90400 { + 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>; + ipi-ids = <0 1>; + interrupt-parent = <&gic>; + interrupts = <0 29 4>; + }; + ipi_mailbox_rpu1: ipi_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>; + ipi-ids = <0 2>; + interrupt-parent = <&gic>; + interrupts = <0 29 4>; + }; + rpu_subsystem0: rpu_subsystem@0 { + rpu0 { + ... + mbox-clients = <&ipi_mailbox_rpu0 0>, + <&ipi_mailbox_rpu0 1>; + mbox-clients-names = "tx", "rx"; + }; + rpu1 { + ... + mbox-clients = <&ipi_mailbox_rpu1 0>, + <&ipi_mailbox_rpu1 1>; + mbox-clients-names = "tx", "rx"; + }; + };