From patchwork Fri Jun 22 14:11:58 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dong Aisheng X-Patchwork-Id: 933400 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; dmarc=fail (p=none dis=none) header.from=nxp.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=nxp.com header.i=@nxp.com header.b="xSGWiVAf"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 41C0vR0ClWz9s2t for ; Sat, 23 Jun 2018 00:14:59 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754177AbeFVOO4 (ORCPT ); Fri, 22 Jun 2018 10:14:56 -0400 Received: from mail-eopbgr70042.outbound.protection.outlook.com ([40.107.7.42]:8000 "EHLO EUR04-HE1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1754137AbeFVOOx (ORCPT ); Fri, 22 Jun 2018 10:14:53 -0400 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=uA6WTgnU9Up8d92K91H4x8wzji+HTwLSpPuybV9y6vM=; b=xSGWiVAfj+zvKEM0Y66z1pBLfgh6rmDScFLZMl2rvXM9Hrr8Ioi6QrWpC/V8fTo5Sy4E1YWIN1u0eJhxJGc6CWMQp4dBRmkMSz9sJTdej5eXfD+XQtMKgZmCh/+Yhfy61OcQ9V1K7WXHISH0X2E4Yo/1Zvnc/F1WEMASt+kZ5wE= 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 AM0PR04MB4211.eurprd04.prod.outlook.com (2603:10a6:208:66::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.884.19; Fri, 22 Jun 2018 14:14:47 +0000 From: Dong Aisheng To: linux-arm-kernel@lists.infradead.org Cc: dongas86@gmail.com, kernel@pengutronix.de, shawnguo@kernel.org, fabio.estevam@nxp.com, linux-imx@nxp.com, Dong Aisheng , Rob Herring , Mark Rutland , devicetree@vger.kernel.org Subject: [PATCH V3 3/5] dt-bindings: arm: fsl: add mu binding doc Date: Fri, 22 Jun 2018 22:11:58 +0800 Message-Id: <1529676720-7533-4-git-send-email-aisheng.dong@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1529676720-7533-1-git-send-email-aisheng.dong@nxp.com> References: <1529676720-7533-1-git-send-email-aisheng.dong@nxp.com> MIME-Version: 1.0 X-Originating-IP: [119.31.174.66] X-ClientProxiedBy: HK0PR03CA0020.apcprd03.prod.outlook.com (2603:1096:203:2e::32) To AM0PR04MB4211.eurprd04.prod.outlook.com (2603:10a6:208:66::21) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 13f0fbf8-c77b-4baf-566d-08d5d84a848e 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:AM0PR04MB4211; X-Microsoft-Exchange-Diagnostics: 1; AM0PR04MB4211; 3:ffUQKesbjZ/FtdIA3a/Vb7F6fMgUkdKwu4SSszBEGQb+XR0S6wTWcdswTQJxKvp9j+dO5DYLkq00EwX2ZaPtZDjan2T2tMgYHhfS7JMsR9sX4EwFfT7HmCxlZiMeOlULLosuH8sV90qKEe06sBQs6p0FhQuhixz4g7i2KAPrt3KUO6YU365i5pP/fR/rcMp6C0pzLMPe0OThrb6AHnbgXLr4FzfNv1Q1weYvK5Tec6W+IAmUeELABOGNnQtDTdRb; 25:NnHtEiaCbRgYRY0VwiZZE5MfhpA94Otmsgs2C8jMB0EzDzpeN0B8hwYt4hbpvYd/EKZlZyCzCdEjcCXEFAHgTku9T4OndIV4w7EpcUED9pNfL9GTO0jcoJBEk3O2HAej+4bhXqLOAZdX7I3PJ8eAAF9B1jSbAIv+/kQte+9y5x7awsEqJAEJJRKUV1MU3WKlNA/HABEiz6FsyvpacAW734rTqTl49nesbkuthQUgqXZcjAo24WwsYwwLz4T0OJ+BqN/4ZU6rF1HQxjixqU+3yBT7c5JrcWviglGA+Mb79V8Oso7U3nqtaAm4QIgk8cqTNJFv5pPzGpDoUZCtHrnCbw==; 31:L+MycQPtj4HXBEusQO4jpB6jryNg90SYvJ0zkVufQMuOF71VBSzmyVsDfz7eC08Lw9ifKGFHyydBI7GO2CNTEnencSJwHEZwLbqEa4kPFFj+LlZ0QzSTgZVbtGVGggYP5Kdo7vZFe1PNGyBxEtxd1Urrqotce0Bjeo/KGAauOGpKX/38dTo0yI7H9GH5q4R5sPnln5rnY329bUFJUg4e2KtgZVTBDyzclRfs2FsXgGY= X-MS-TrafficTypeDiagnostic: AM0PR04MB4211: X-Microsoft-Exchange-Diagnostics: 1; AM0PR04MB4211; 20:mKdC3N72WJYZrxZDu/9KSRrW3Vr5pRfEq7T8wwey8RNPNKeMkh/fnSBrGVpp1unKmlvuTe1xLtR8pR97oMK8EcZcs75AjZCu9Rs+VGKVRVwx/xiuJNeYxtiXZ9on3sUNp2cEumZHJuU+HeWuS9/Wp9kE954ZR6TGa959/59opnzgRw2yVOOQw+EaCw8rrP/59klqUOWyzXpmAsy+xp9hBE6UB3D1URW3hOyYyW1d970ibsCsJcDohJ/GQef+uwtLIUmf5K4ye662az7e1O8jTSauGDlV6Su8W8fSKbtXEVR2jrG1sF9gtiFewZ7jqyOy/z9o4jYPplzch3z5aOXnoLaV8SH8MeeRDynrEQdxVL0jrSJa3iA+oz9X3pe3GHRRTnTy1EpWaUVI6YPhrpjC7+Bk+WzHBxQHE+ouxIXrGQBFNmRUk3Z+Vpx8v74zNmhZRswu7Ddtiz30IFV2LKTP98uVsU/yhhKawOktpVSU5UOvWpmsQrdAE6qNK7M+BkEu; 4:IXmPLco0gevOIJl9bJheVpNLXXV64Frxy7kGRXKm29JQpo1rIei5e5TQgTrSc00mWn3Bv4UFwiaFngYG3GKY0Ai8I4DPkbYpH9Mx3sdfIWECC1H+/zvnLSGGMAoBoSSRBQtzn/dJ5o0PmZibxOiG1qZ+r0fRbgsjBaQIRSO5wLhC8IzOpdmdkoKKXyHO3rFUzjtAzFePvmSzuUg+XQ3aBm9LcNZSQxIV7OR8GCR2dil6qWZ4pN4zUtJroqOJJ/HHCsCYF8LgGCZ36cx1ZlhnWw3Bu+VdZ1M35HWzdxjb7tKBUnd4yV1IUeNdc1Lg2VoSUE00f48HKQQke4QLIH9OAWd1uXbr75Jwp9ozpOaCLnrgvaw6LbIkRl5YX7WuNFvp 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)(93006095)(93001095)(10201501046)(3002001)(3231254)(944501410)(52105095)(6055026)(149027)(150027)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123564045)(20161123560045)(20161123558120)(20161123562045)(6072148)(201708071742011)(7699016); SRVR:AM0PR04MB4211; BCL:0; PCL:0; RULEID:; SRVR:AM0PR04MB4211; X-Forefront-PRVS: 071156160B X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(396003)(39860400002)(346002)(39380400002)(366004)(376002)(199004)(189003)(305945005)(7736002)(2906002)(6512007)(54906003)(316002)(97736004)(53936002)(25786009)(50466002)(4326008)(50226002)(48376002)(478600001)(3846002)(5660300001)(39060400002)(6116002)(16586007)(6486002)(2361001)(6666003)(76176011)(68736007)(26005)(6916009)(52116002)(81166006)(2616005)(386003)(446003)(956004)(476003)(11346002)(186003)(16526019)(105586002)(106356001)(47776003)(86362001)(66066001)(8936002)(6506007)(51416003)(8676002)(486006)(81156014)(2351001)(36756003); DIR:OUT; SFP:1101; SCL:1; SRVR:AM0PR04MB4211; H:b29396-OptiPlex-7040.ap.freescale.net; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1; Received-SPF: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; AM0PR04MB4211; 23:METf/WDRsu0a4ustpZwhTf2aZp9PiclnmRIUZ6hHm?= E0rdO6SPe6DCbWNpG962Mwpdjdzu1aO1krJZQeLNQWDWEml5APO7i8URaKv2O4plbdmNI+DfKHlIsWN/1FdJ6npUajER8b+iucF4JNkDhkbWkfsAE4Np7BgoUL9aoMtdl9hn5Qc4Sa+b8BZ1l1nCjFXenAzlHMGVucUrepuIcPsFtydB66S3QD/fjKDlzg6ESwaREXJAzKW66/VGb9JWvvlWZLV3bLMj1t1BDWRNxOe9lddJq8pcHynRy24YAK2JONv4SG5XAomYOhns2Uk6T4UkoM6mQy/pbZpRJcHDuTKFNqSVD2Y73QXWJbztU5Ax2oU3TSVSsGwqYrd6nC4g1sZzVz3yP3lfTeFqLVStLJYBJwIHbVzGzcCqDtBP6xrM3lEGJAeazXfVnnnCCxtJ3rN19BRYpERW0tf9W/mE2Iicbi54kDdSIbFYbiQNlz3RFLvRWwyqEqpksNWZ2m+18QAaIovg2EfTc6AZ6kzMwFuwBTERJpFDSPPgnihY3VF9saIG2vWDeggTfjpY8LxcLbhXjZWTNRBezGSfuDGDZw6l5AXUgVAo34ZQOkNeTDS+XrYNdMclPNeXGb3l5Wu6cPeD69nobQWxr6iscFQj/oAoaIe5yM/fseM775x5jDn+ouZmTFucHg3In/uuHrdkR2cf+doJwhSmOPgE963MtZ0r/3j8A1s1/Ibft1WNyvwH+GXOIEesKRFVNOcUm+EvVCYKHcTSI5RNQn0146okQusehMQmaKlOqKKOqfZMY6pK7Kza4f+XcHwcQI6NID7J+kvEcKj+rzkPwrvUdZXorWmD0UCmw1caovRXze7Mu7NLogbEvZ4SOdzOmVQo+0B84jdVvqaGok4nlg09CQfzx0Vdb7PX6ZgEMO+kfobFTkrP8Jn8ef0m799C/1gOq76X/hiPpVTtFahWd/LByhAf9Hy3jfZOKAgCg1Nc4w2lqZ+TRmFu8VGIBbbBITrrAkWXfdLpErKDpwv4EBjS4Jhpkq+DaDgxZhLMna0cV08WjOa3qb3mH3ybdNiKe4jrFjw7tIvOWnpfFgDJa/4bBy3JgeXd1f/x+PQ1fPLWRyYKkl8oakjgF/LmrCNdxEhlDtsz1sqZlEm4Fx7RBWALbLMA12xlfamVa6y6qDItcLamHrvBCh2FO7LqJMrn655cBfpsy3CfqxlAhtrZ0owVlLNpkQHwascRoo2raIqoySca+EdDudihhWHgJK1qlE765x7pS9j X-Microsoft-Antispam-Message-Info: oaa6FqNc5385yjka/cIuDwU0S/u6zdgQvnkATg+dNd0JIvJ3c2FJ6z53nmb4Z+9HsWQAwVsgd7Oe7+TPHsZTerqjg5AfhigRL8g8uXJd+ZZUJKH/uIBf7+xaq1oxXARvULay7PKcbHZ93bZU2P4ChcjThhgBQHrlTI9cCxTg0BeEWen+JwLkBrANLe38loxErkrTml49mpp3/FnXYgN1HXS7Wu2Vzk19Ym+zTpb9FBerEsJjhZ9jAjAeIh8b2rM2NOiumGIlA3Mdwn8ifgpRcwYa/n96ANX3trk6nKotEMbVEzzWST+nnPxCqfjtZPxQPmZOGvR8W812Kod1k8iNc09uXk2BhIn9DgcPKkOiUFA= X-Microsoft-Exchange-Diagnostics: 1; AM0PR04MB4211; 6:cho7m6QWkP3NjpJvYkgLlcISR8EGaOBlXV5Cmn94+NQY1ALnudyNMBkdodCHFPuLbppJ3A4kuAi6ejCJQrtjGsn/zmLrOJijmvywdfGBfiRSBZF4oyX61tWrGDCB4QLzKxos+Awp5IRLvn2f5RldQF2Zsegn3QsA0rrcNrbiU5Shoo/z4U2ciO30HVsyE+VrLGJix9kzS5hpAVYTP34ht8U84eYRDI64hB8ubZb96LuEArrZHdR+MrwHK08Gel6vc9PdgzjYObfoucoLuskrjEtyvU7HsQOQN8o1swpMvRhJi8qD4yOlEPNCGQPRTQonnHoFjMp0OL9gj4tABEkZi3K/zfuT3jEAYyxIiAsqBRleZwdAmHmQj3TvuxzEf3sQPZB/YQJsBXJ6ULzz+Ubz1xlPpTDvHPKaveg9hHXUuAPifu75Ow2PjPCERFLncTO68FFkXAe1K5oMvLPGxVIzBQ==; 5:PCLtzz1SdTX9nNqKG9Eu0DFfm6nkr1WEC9jTR78vL0wwSQi8SNex/9ViAqxFI/xtX1y45ByRnpe6EeHetdsiP/kqPXk2A3I5N+cNmWT+Y0tRzwjXrNcK4xE9k0MXyBezPzqIYGM3ig/GfdeH0XwrK3eUG8v0srEIl4Q1wiBJ6Ps=; 24:rgI0HYYGiyrcdruNB4UABgyvPn+rPMwIziighGepghCnQRotE4twsgbuS29qWJyG6AefyQWiyDVAGI0hdOmcwiCwL+HnRwcHwmx02ueKNsI= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; AM0PR04MB4211; 7:iohxFjarWXQFMe4rFLHNAZeqNo8AuDCBc5uFqrCiqwuJySrlmyiS15FZOzyg+JcGedbmbhEFgKon6GiUxsdw7S57U8zMgqQbKYhVnj3F+EGb3lgKc1jTz9Rtmc5ZTNf0jUZjPgYWKHNXMQWoJoNDeMNCrH9FMRYC97px8zxbhqm7+mBaBmU8oKP1cqLydMysXlGz1NWGbO+Abp7pMFGSaM/DuDXNBWKMSnapyeK+/Svo88Y35uYdrjW5/aR46AGR X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Jun 2018 14:14:47.5110 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 13f0fbf8-c77b-4baf-566d-08d5d84a848e X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR04MB4211 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org 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 --- v2->v3: * change to mailbox binding Currently mbox-cells has to be 0 for SCU MU. Generic MU Mailbox support binding could be extended later. v1->v2: * typo fixes * remove status property * remove imx6&7 compatible string which may be added later for the generic mailbox binding --- .../devicetree/bindings/arm/freescale/fsl,mu.txt | 34 ++++++++++++++++++++++ 1 file changed, 34 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..90e4905 --- /dev/null +++ b/Documentation/devicetree/bindings/arm/freescale/fsl,mu.txt @@ -0,0 +1,34 @@ +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. +- #mbox-cells: Must be 0. Number of cells in a mailbox + +Examples: +-------- +lsio_mu0: mailbox@5d1b0000 { + compatible = "fsl,imx8qxp-mu"; + reg = <0x0 0x5d1b0000 0x0 0x10000>; + interrupts = ; + #mbox-cells = <0>; +};