From patchwork Sun Jun 17 12:49:47 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Aisheng Dong X-Patchwork-Id: 10468885 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 576396028E for ; Sun, 17 Jun 2018 13:02:28 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 358DA287AC for ; Sun, 17 Jun 2018 13:02:28 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 2538B287A1; Sun, 17 Jun 2018 13:02:28 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, DKIM_SIGNED, DKIM_VALID, MAILING_LIST_MULTI autolearn=ham version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 71CE3287A1 for ; Sun, 17 Jun 2018 13:02:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=QbyRq4Sq5es57PflOqV+fajEFHNCS7wyRggaCuPQz7M=; b=nyKod4ePy96ueR 5SUwLQpJSC/Ukk+6AISmX9n7mHt+OuKa+xPO0hyhRtNMBCfiqxxUGi+wYdCv8xXhbAX3fzkWVwQte WLzcgXyKEj07+HTMeaS17WiBWYwE7EBcZs4zz8hCtYcRnALa4fjIpeR0QAm9eocK22WZC4toC1Btb SBbziac6ruVtdf1MbVP9memisbq9+4CSfcWHhMDebL0WYAC6LdvDZd0tvPDSU3OFxqfytg5kXx4Ty bB9PIuE/MGo95nNrFhv1z8j7pnOD1/L6eNMQzh5q13956StV/L80jjD9+M13kHmc2bPuoEbcHPe4Y 4iu9In3tBLKWUMethNvQ==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.90_1 #2 (Red Hat Linux)) id 1fUXK1-0003jU-Lq; Sun, 17 Jun 2018 13:02:21 +0000 Received: from mail-he1eur01on0073.outbound.protection.outlook.com ([104.47.0.73] helo=EUR01-HE1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1fUXAL-0008R2-A9 for linux-arm-kernel@lists.infradead.org; Sun, 17 Jun 2018 12:52:29 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Gg0zB42DfRzEa/c9GYOK2TT0dVDVR4HToFk6mFk2+QM=; b=fgHck6bM1+sgfTyVfY6n1Pbfi3/RqW/rs966ZDTgIVhVfm0IPfM9iRSGRUIlvOmi7U6w0MM0Viqszw2zKnDHWUXYlrIGCymAd7/mLa1Y90V0M97TwIQnGJlKYnNv+7ZoijQYQNqngpfxsfAm4s544SBeTUX7d0QUnuWj072E3W0= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=aisheng.dong@nxp.com; Received: from b29396-OptiPlex-7040.ap.freescale.net (119.31.174.66) by AM6PR04MB4215.eurprd04.prod.outlook.com (2603:10a6:209:4f::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.863.19; Sun, 17 Jun 2018 12:52:03 +0000 From: Dong Aisheng To: linux-arm-kernel@lists.infradead.org Subject: [PATCH V2 2/4] dt-bindings: arm: fsl: add mu binding doc Date: Sun, 17 Jun 2018 20:49:47 +0800 Message-Id: <1529239789-26849-3-git-send-email-aisheng.dong@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1529239789-26849-1-git-send-email-aisheng.dong@nxp.com> References: <1529239789-26849-1-git-send-email-aisheng.dong@nxp.com> MIME-Version: 1.0 X-Originating-IP: [119.31.174.66] X-ClientProxiedBy: HK0PR04CA0006.apcprd04.prod.outlook.com (2603:1096:203:36::18) To AM6PR04MB4215.eurprd04.prod.outlook.com (2603:10a6:209:4f::13) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 13433f46-0784-469d-a89b-08d5d45121ca X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(4534165)(4627221)(201703031133081)(201702281549075)(5600026)(711020)(48565401081)(2017052603328)(7153060)(7193020); SRVR:AM6PR04MB4215; X-Microsoft-Exchange-Diagnostics: 1; AM6PR04MB4215; 3:0sJoFNDnHl+pk6EvwiRsvFZW2xwyk72q0Bq2m2UxicnfSkZf/A8ELPMoT9bU5mPbNlOgyBxdLEJm+/3osa7gGA8infEh9FFD/ZhkhDfLCGgFsfvIWdyfp2qMn+9IXmYqIw0IWZXPFqdAeSvUH7WSG1JAnFhKGzBd65G0hCviN7E/3/z3XI+5JBkgybZxUqiYH1EQaFVG1wI6C91mbENzK02y8K+djK4TLmdBctUY/WWVlcRKDvJdUYc9RVuf1H57; 25:1qN666MKD1ydYDHLsf998Y0S5cs5CxsbgGbTUARP8ARWQtdErcOkTnM7CRA2ugNi2o91oLbwWgLjo7on2mi7e/VzQRlySDwMN1sk7vRw8Yit/FgFAO27TYAt6rn6wapsVjeIqrQ26oWKxTh43R8vekC+6e3rVAttKfIQhI8K+bMWRZN4uAXpEaqUEUJYyNB3E4qpK86wMf3DFi66rn33umlPJ9pZh/0Czkz7ecemJo8OM+vCieJeoFCBBWHnuaI3u2Q0k3xMSxTsO8q/2sHjb/ZBJsjKopgQmU5ZotulaNopZZg8eJyuIAIIjMD/bbUuUjiSTmIOso0svxGCaHj86g==; 31:+PXObyPIUKhEfuorlkDqA9qbnoBKbOTw15LHPH9hRAFm0ombNEQyV2OoT0DKfknGfMhGB+WFKAIRdxXQ5mVwjlT90G2uYIQ000/rjgkdDd1oB38/y7oZ5tXEo0GZWgiswDchapHCuucu4KotaTfuBz2VT8xfCJ3wPGEoV3AUzSYUtMA8dS1ovy44Ks5WvBBdL9VuJWeyYuP7w/OJ8yPdUsq7QNEFXVZoUgPA/GKkOAg= X-MS-TrafficTypeDiagnostic: AM6PR04MB4215: X-Microsoft-Exchange-Diagnostics: 1; AM6PR04MB4215; 20:CXZHcUmXfJHJd1mDIG6UiKU4AoN2BJNa06zOEd5TlBeJLo10IFI3ooslSDYWA6IQZCiyw5js5D0ZanfbeWpEhkaEEgo9b/9JASSAvJUhkYPmMGPfHL2LlKzO6OOzPB8juXU0Ry5eWlycGrz3OUN+0IaFsbVABb+roY+UxJs4AXf/slD6wROvqALSeWebevgqtlDcRi9raI4jJPOxnoRanFI5CuGh1E79PdI2KHDWxIirMddnEjlna4tSsj5OB9498rkyHOAENoy3m7ZY46ai+fIX6+5Ly9PfxQP7jo5erRS26xLDIetpLyimtulM5kFMd+q20PtAsxizu1r4XuirIAaxAMcYsyzKTRSEAnfIYI6ahl9lPRojM0/rMc8sTpNnq3BQGmQioMyF1R6tA7Yz6BfN4tZkL3RRNHArDzLSm6uwHBXX9iWdHev2pMvROuaqOwhbwPnY6jJ3Ao3I77k6BpdPrCJ+kH7lPwtJsFAJOJh+iYHTwjp+83qBmeXKWRly; 4:nLQk4Q09sJFyDIw2SQYqRNnK9MgOUVXi15r7JxRX7VhTR6WLS7dbZtCKmuzE/dkXj6HFOmCvVk4lDDxqQOHDyr9aTw46wtSIujwdckzN8OW1Cr9uMLQVfLtiJTbaEBh8k6gc6CJ02xqYHRq5NFDJZY7GrILf5uYrmR6hK0bhuWvfU6TWkO4UJyiN/VvZCtH+O8pcRx9SuN+ZI+JDnQRL6igQtn5v1i4RDA8arOAOB2d6UFLHb8boDyhPIDNhTDpIYqGRf7aB4uD7tmA2HXV/7Krv3gpdEEVFvPMBq6SoxatnjXfuFL6cQ5q7jTklJklL6O0TUOmTYRBhsZ22OoiVB48+1M/q71lWdT/1tCwzR2m34B5Frt15YWR1KGBmEOH3 X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(180628864354917)(9452136761055)(185117386973197); X-MS-Exchange-SenderADCheck: 1 X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(10201501046)(3002001)(93006095)(93001095)(3231254)(944501410)(52105095)(6055026)(149027)(150027)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123562045)(20161123558120)(20161123564045)(6072148)(201708071742011)(7699016); SRVR:AM6PR04MB4215; BCL:0; PCL:0; RULEID:; SRVR:AM6PR04MB4215; X-Forefront-PRVS: 07063A0A30 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(396003)(366004)(346002)(376002)(39380400002)(39860400002)(189003)(199004)(2361001)(305945005)(97736004)(47776003)(5660300001)(7736002)(66066001)(2351001)(86362001)(8676002)(81166006)(48376002)(8936002)(81156014)(68736007)(50226002)(105586002)(50466002)(106356001)(478600001)(3846002)(6116002)(2906002)(39060400002)(6666003)(76176011)(486006)(4326008)(25786009)(53936002)(6512007)(36756003)(52116002)(6506007)(386003)(956004)(2616005)(476003)(11346002)(446003)(16526019)(6486002)(16586007)(6916009)(26005)(51416003)(316002)(54906003)(186003); DIR:OUT; SFP:1101; SCL:1; SRVR:AM6PR04MB4215; H:b29396-OptiPlex-7040.ap.freescale.net; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; Received-SPF: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; AM6PR04MB4215; 23:/gK9MkSuUSgp4SCKx/TDpnPxddOCPcuCBiXvTeoqA?= =?us-ascii?Q?nGPueE2Ua2MlsNa7nhKYYxIs5q5jSo0ZcN2ZdG8rRZ7G/bj1Lahkj7w72tfo?= =?us-ascii?Q?EP2s7M7DFluprFHbbo0334CUVRFLzAQhkihLrcDEFkWvca5KSr6kAjn6wWfw?= =?us-ascii?Q?k5QbOK3CWWoX8MI4VJZ7tfoIFppMDyhJcR1TQA+mVSbWh4q147X2QBxe4t9s?= =?us-ascii?Q?WmFZZWRpHctacKvD5IutRexA9Xn+O9vjkFyISXtzLCRq8956QuNeuw0VnA0N?= =?us-ascii?Q?pvtMAaeNBwVHF7/JDOvm7cJSGQV1cL2gj56JI/crLHfuioxuMyULI1NrGYBF?= =?us-ascii?Q?2WSzGZG0LNDlNcKdnG2mFaRyfcj2tSwF0hFSq+QcfclYGwpOVfu70MVIflSM?= =?us-ascii?Q?se/y9JgNLh4AtC0Ndh0j2AAPouyVzt1lkFREStiYCoYEAEqG6l0Vw0pvtqNj?= =?us-ascii?Q?lKp+avR6bxHCulY1TpIhsf6W/2CuPgaZ3HcXujL+vl/S4xxcAuVuSp3h2wd3?= =?us-ascii?Q?atB04Dg06Esnoqnc6ZWisJhCGPaKQZdihCz8eqzjhiYONoA2U08dHbXo4v3F?= =?us-ascii?Q?rsECzqCGDPuEzm8A2Ocj4wHgQvj/tjaGaxKHt+LFrRpv7vHvm61hLwKOvyhS?= =?us-ascii?Q?qaNxfQcP9cJ6qUKtAJ8Y1NVHwpq3Jm0u4xmkJQ0KXORVWCPKbigB4gkW4jn2?= =?us-ascii?Q?o7Dea/FYd3ZFDJfwbLPFMaOBRPgeYp7aK12eHQBQYZRMxxrgck+IJOLZzYMY?= =?us-ascii?Q?y+uUopJlCa8brpe9j5d4OE+q0+WEieKwtrfzBL1wdyE44Gg5YOisfJ2/z6ym?= =?us-ascii?Q?cM/qQKmpkm/SeNdQ93g6XQH7Wuhmx4aDHTid8SGSwdETvMsV41LBonzg2qDa?= =?us-ascii?Q?D8PISic1IlFeKJa/H58LW3Ep+joxK34xyXBYljH+z3X/jr3gb0MCCYyzfLJF?= =?us-ascii?Q?ODIbXYslFiqzDA6Y+yjBrb9NTKviRQXfzUO4POtV1DykYwJYnQf83BCVGvJ+?= =?us-ascii?Q?ts0aZnoh4F6sBGR+yfbBrRf+Ye4Z+hoxde2fyQD1LyyX1tV1ec1+JjDE8v93?= =?us-ascii?Q?dfVH7jOrUywFZOC0ip9LnkU6UYkgnEe0mChonguEj0BwJajJbAfb1XiLc7Nj?= =?us-ascii?Q?nMj2wSzYPDkLl/nvsD2WtC7n1J4eDnDsHYQIuXgoQP+wzmNej5cUWxnYbXTF?= =?us-ascii?Q?nmILrtkNqudsxzwUboyyyxCF5oCYpPY+l/ce8wFsSc/NSu5cxfqQaYO2Q1Jy?= =?us-ascii?Q?sfHOMXzNy3XzewroA2+nwBGSxw94zQg5vNj4zv4?= X-Microsoft-Antispam-Message-Info: B5l5x6vxNmh1CSKypNnSGpVoeCV9e1akvs+A0JnMCIrgmGvwOvgHIgP5mZoejYrWXpxm+pr3cO+JfK6bRyK5y3VV7l9OEkOXiNl7eB4OrjKIQB/7HT+YOMC6yrdvcn7nDtMFFTXRxOrGYUMO22YYBLc9g1AgDDy+YVTu95ePvW8ewxzvTZXwPyvGcDLXTnPm X-Microsoft-Exchange-Diagnostics: 1; AM6PR04MB4215; 6:jgs7svvsihkhKWK3VTqRrX2Qgkyh06hMOdO2nKG7giByUrlmfUSD/3HrRnT2l0nIY6xmxlJr0gS7ECmYLeZnt9PnrGCLfUy52VMI98cWmlRzLowZK7i/9qYEapnmWg12s+2DZLrfuMFzpbXi7gQy+8vWVjALCSimMK+MTAqEqt9z+8/otCMTvN5NInvMfVPvThLWsTB/lZG0jnTl0MGcSdF3lkPCz0IW7VFt+mug7RHrTd8DUIo6m6oLn9LS5usc3hAmpSKrAws1qbH7z80eWWyAAsP+9JegWiGalHE/k3u9hp4KuHU8TO3hYR60mGZL2VUcX8iNUa7c10xWzqBlqTs/4C07H4uFIuoOpNegccS/akptRseXTfZ+hOIlwmY4FpYL64WER/r275B49EdUpIEj6109UxgkHO2vr1uzdKdbpluVKBsek5EturyAI26903RwwT+7HIRGwzvcsnl1rA==; 5:NBstIPKG2NWjtsDviTLUP5vHqyarI6eBr03NSn9O/+8XqXWOzTYQLlajT0SlKTP2IohRH6fld6R2mbgsD2M3G7wZSuLt4gp0cqDn6yt9gWJQjmdDdHV5QTzk4qOcsbMPnU0lF+cyGGax9jy9UIee+w0hgAJdQNDIKkQTFrlYHaQ=; 24:Pa6gEFHtivpjSmQmlWTO9RsixowNtdunh9XIEc63WvmqBWZWQFmD3MFwa7YQbZ70nlvoMrA+luNFj/1h/PLRzBXXyf4psFaO0h4cd0qshA8= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; AM6PR04MB4215; 7:SYx84FOc0eyD/ujZcjo32S2av9G1yH1A/9rUR7NyxV8A0qb0YSnctU6lO2urL81SDNIK83IfrBKqMC0R9UHngKc5u3DulYxkKoAUv0xjjp2vtDAu7fjQdWW3UC3UO7Hz4N7rUwrgMxAOPf4d3YCY1AvNCJgB6R8pJE0r4OWePVxTnisSofbXLYSu8pRhiqLdgkmF3mEDy4QNrZ6HJ28fPOCLyJe28XhkilOFpe2k0i6dPVAdjENo6rYSWWDfqFnZ X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Jun 2018 12:52:03.7011 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 13433f46-0784-469d-a89b-08d5d45121ca X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM6PR04MB4215 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20180617_055221_382716_F4873E17 X-CRM114-Status: GOOD ( 14.06 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Dong Aisheng , Mark Rutland , dongas86@gmail.com, devicetree@vger.kernel.org, Rob Herring , linux-imx@nxp.com, kernel@pengutronix.de, fabio.estevam@nxp.com, shawnguo@kernel.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP The Messaging Unit module enables two processors within the SoC to communicate and coordinate by passing messages (e.g. data, status and control) through the MU interface. Cc: Shawn Guo Cc: Sascha Hauer Cc: Fabio Estevam Cc: Rob Herring Cc: Mark Rutland Cc: devicetree@vger.kernel.org Signed-off-by: Dong Aisheng --- v1->v2: * typo fixes * remove status property * remove imx6&7 compatible string which may be added later for the generic mailbox binding Note: Because MU used by SCU is not implemented as a mailbox driver, Instead, they're provided in library calls to gain higher performance. Futhermore, SCU MU has only one channel. But the binding doc claims (Change to allow 0?) So we did not follow the mailbox binding. For the generic mailbox driver binding way, it may be added later. --- .../devicetree/bindings/arm/freescale/fsl,mu.txt | 32 ++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 Documentation/devicetree/bindings/arm/freescale/fsl,mu.txt diff --git a/Documentation/devicetree/bindings/arm/freescale/fsl,mu.txt b/Documentation/devicetree/bindings/arm/freescale/fsl,mu.txt new file mode 100644 index 0000000..c37aa1d --- /dev/null +++ b/Documentation/devicetree/bindings/arm/freescale/fsl,mu.txt @@ -0,0 +1,32 @@ +NXP i.MX Messaging Unit (MU) +-------------------------------------------------------------------- + +The Messaging Unit module enables two processors within the SoC to +communicate and coordinate by passing messages (e.g. data, status +and control) through the MU interface. The MU also provides the ability +for one processor to signal the other processor using interrupts. + +Because the MU manages the messaging between processors, the MU uses +different clocks (from each side of the different peripheral buses). +Therefore, the MU must synchronize the accesses from one side to the +other. The MU accomplishes synchronization using two sets of matching +registers (Processor A-facing, Processor B-facing). + +Messaging Unit Device Node: +============================= + +Required properties: +------------------- +- compatible : should be "fsl,-mu", the supported chips include + imx8qxp, imx8qm. +- reg : Should contain the registers location and length +- interrupts : Interrupt number. The interrupt specifier format depends + on the interrupt controller parent. + +Examples: +-------- +lsio_mu0: mu@5d1b0000 { + compatible = "fsl,imx8qxp-mu"; + reg = <0x0 0x5d1b0000 0x0 0x10000>; + interrupts = ; +};