From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1763675AbdJQSqX (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 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: [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 Content-Type: text/plain 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?= =?us-ascii?Q?1gwW75DmsFWASKVp5NvU/8Q0FytsiGvF9B4bfmEN6GFprlSWZLRAR0KBHOzB?= =?us-ascii?Q?9cumcqV2jR+YBA7i9Z7yF8WKWsN0a5pjer+jpjgRSpYJhCWWoyjKG/Ux87pM?= =?us-ascii?Q?l6by8JxDG+YIQG6EOnbaJ13uFtoSSQPUyQ76NN5s44VAV6eZnMnDsEhlu7mg?= =?us-ascii?Q?jcTacRJeIa2W3jhlP7yi0plRPEwgqY60LcFBVfRXP85by5pPL4WJ8vJboHlT?= =?us-ascii?Q?5fmCxgQ6541ZDoU2IaOahQ+IjQ54TM8sNgcRHvRKITUHkE8xFBPBB7Lb/jMY?= =?us-ascii?Q?tue2/dTsdlb0UL1CcdCnchXpzPX6sInLn11bgWNjhDOuhv3uWTtgmFmNW/BR?= =?us-ascii?Q?KskmrRpJuGjrLE1uO6nWjlx6elSXtLnFJpct60XwxfeSpq7FzdJECUlNaTda?= =?us-ascii?Q?ykrif3Rcowab7O5CGglttPPUcv2saAvmcZ9xwEs9yMvMGpj7N3ZnCChNKK93?= =?us-ascii?Q?v24qxysv39exr/KCxSs85vmVccAQ/PdVuLWXZ975sX64nmdKKwXBpaZVcStB?= =?us-ascii?Q?/rUrMZsv5AixmBJhCWmv9gzp+W5iBuJ3OAqJu/jhEMJnGZlNq9QhJAi7UR5u?= =?us-ascii?Q?6gB4CuEtoD1f7hmyI0O6+Dq2UxlZl6FueaFiksbIuxSpruGu0xkG46VQ7TvA?= =?us-ascii?Q?3z0cfwM3HdGJyDCe8SG3WLeEh0WUiMOVo0JJ8ejdekBczY8CbTJVfrAmswP6?= =?us-ascii?Q?X0e+BA3m/PnyhPDcDulWYnfo6hXhJ/ASUwPHwovBAW+69PqwsA4l/ePp8rLl?= =?us-ascii?Q?bT4BJdxJjKYEFtM6sqmOErIKX2gX35m3HyErgk2lZUYe+gf0qrpfNgDF4EJi?= =?us-ascii?Q?lEhGJFXdrtqJU0Wl+xLNbP2e19QYPH/PYmuOj51fulExLqGlRrttngCNHCMi?= =?us-ascii?Q?v/r6oyxa0ox81ru6+HKQAIvwjJPoSP6ZUQudXxylh1lvs3Seu/DlqKPuI3kt?= =?us-ascii?Q?hhiZfCLoUkNrF6Ya7GakxgCWyxcZOrhN81h0ScHmQvjxw=3D=3D?= 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: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@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"; + }; + }; -- 2.7.4