From patchwork Sun Jul 8 14:56:56 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dong Aisheng X-Patchwork-Id: 941029 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="KWBdzrEa"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 41Ns8L2YZTz9s29 for ; Mon, 9 Jul 2018 01:00:18 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932588AbeGHPAQ (ORCPT ); Sun, 8 Jul 2018 11:00:16 -0400 Received: from mail-eopbgr70080.outbound.protection.outlook.com ([40.107.7.80]:46151 "EHLO EUR04-HE1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S932656AbeGHPAB (ORCPT ); Sun, 8 Jul 2018 11:00:01 -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=nsPuKD4neaiid8FN+Gq5uIPXNZl2/nnGK67Q8a+oCMc=; b=KWBdzrEaBPpw6UGu8WocVyMKgMwokqDyqHeHhfSBXOHepG5bqomViz1AUlwb2kkC0BJFWShI6TzE9caTpasZCnZF+q+puzarax6tnWPGHIALDDD496ohecD5t2nZXZBFXG2oSz0OYavJ97RuRg5MdqCcNW1L+9pNU6GklX2UY88= 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.930.19; Sun, 8 Jul 2018 14:59:55 +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 V4 4/5] dt-bindings: arm: fsl: add scu binding doc Date: Sun, 8 Jul 2018 22:56:56 +0800 Message-Id: <1531061817-1980-5-git-send-email-aisheng.dong@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1531061817-1980-1-git-send-email-aisheng.dong@nxp.com> References: <1531061817-1980-1-git-send-email-aisheng.dong@nxp.com> MIME-Version: 1.0 X-Originating-IP: [119.31.174.66] X-ClientProxiedBy: HK0PR03CA0096.apcprd03.prod.outlook.com (2603:1096:203:72::36) To AM0PR04MB4211.eurprd04.prod.outlook.com (2603:10a6:208:66::21) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 1629c9ab-5af4-4dc1-edd4-08d5e4e3794d X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652040)(8989117)(5600053)(711020)(48565401081)(4534165)(4627221)(201703031133081)(201702281549075)(8990107)(2017052603328)(7153060)(7193020); SRVR:AM0PR04MB4211; X-Microsoft-Exchange-Diagnostics: 1; AM0PR04MB4211; 3:iNQ0y6tA6z9cjM1F1Sff5meiaRtVTvrfm64Tjf1X+AVjjuRYFBb8AUQW7bfZlauCoSX5Q43yWORP+ewMP2d5y7CvhNfiUjgmc7KLMoeJOyWo8LIGJHFigxBjgx+o/VEY6HvuFy1SBFoihG38jyhRQImgox079eT5cQpW5yJ/EWQuBMVFBM2IbXl26B6gY2KOu8Ocd8yp8XjPnllWzdBgUAFCsVVC0ZUwLzbFznr7cV0fbKV4zQJXZrlVX9PrDjOB; 25:3oXY7veXJUQUnaqWYblpXUh1GbuD7iw7HtORM+f4BZwhZFu+a2w2WhQFjZxb3OCGd+7O2wIl5rNhujSHoQBMqFRKQn9TLZDndUlym/pbbglTt5P309wpAITtDTqqGh/ZuABerCK289m8vZIrzOtP2xgNs62YY97/Nna3GWswjvpkv4zBuN6SU5N6ldLOhzpodAffVBwtXjWCioCdgLLSOmQkEjRxEVkU8y/hObH6K0jLGLbqpTpwOcG8kBSHo6b/GsPAP7q1jreGW/BCKzB5X3PcSdIqWUW8uvILLFQzwy7CqqC436/saTbUbZo0iKCPZEbn6I+yG6iWmvQWKHZ2UA==; 31:0+I3Nx9yB+LnmEcaDNrROO+BysSssBdf/+VHnalGKf4HFqiyrWEIkwg70Pxh6uQ7uFyO7XaQRJx2HnSthLP7ZABjAmlGOTDGk6a+Pj3PY4Ix3XVKHLx07LllCYDJvwRzRS9oaofjPB6druCI6PoDEGw/0xAwpDTB1nCx1wVF8ACiZ+ziiPk3849qssRANEXgd7L1waLXsTzx2P8n26FdK7WcXJrPoo04otHkPWTfhs4= X-MS-TrafficTypeDiagnostic: AM0PR04MB4211: X-Microsoft-Exchange-Diagnostics: 1; AM0PR04MB4211; 20:ZplS90/zyqadMxKMeNm9EtaESYvYwF7vuZfJcO4/VCo4LfEL5FEJzxamWx9MRoWZW7SGs4iFMMYKVR9H/QGu6bTLiQ58ZURhMQsEWNLw/kI83Xag4yDWGdAd5BPRtGpLiG2IVSuFCEpZdPS70PIGKMHWqNwhLQaCUlT9C3u1fvAC0J+zzhnohXpgjUuD0h+Z7nA4BZmLkBfhDn6EPP+UhQg7O9q0N8vlA+sAUDV3SkHZpzp6xRTdrMEmA872H9jIV+0d6A3qZ/HfvziRXLeL761QFBdzEAQF7BXr2ue3jbWrI2SVnrn5QSAx1YEIFbh33gW9rOD+IZ25wFJmcUtpclunhpkF6LBkDJ9/+/T4Ln1JRlCSZARXqSo4DdfzCZRNG5Amx2NiotJU3a6GBNN2tW3KcGPvycunfCCkrOhRq+N4REkrOW4VvmSSksKihG1kbPE0lLpY8JldVnRqvlqyicDTnEemgXGaQJOP7rI4dODLusg8DV6mjBCNcUzak/M6; 4:ETlTtF69IXxd8bYzVlEfQn2mnKT4ysypUt698ZNFtsG0nRW86epoQdF0bOq5952Z2VNR6RR0ZrZ99HhyUL18NnVgO5pfLvATWeVkuTx6k7aybVi/jxhzaduDVv02NkxGfxBQen2tAgJ6/Y71WdBfl/P6azuMMNwN+/ksBDnXP0s3OnRvRJGTaszS7NEpD2bkLJ9DNvjqy/Hth9w1iGwe6DJ7DtkG7ZrQLIfp50df1jSdLE8QIWn2HXUxlRF7BKWIYrExSRVce35Swl2PVjd0xzUI/SEsff4kcd6cnEcrtg8Hc7NpmkPz96BrSOF9ZkEYuQ4TlAeURs38KYtrvkxv+NC5zjemjCQmMFMKGbtwAg2lh9euCJxKoW9nbG2OIEve 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)(3231311)(944501410)(52105095)(10201501046)(3002001)(93006095)(93001095)(6055026)(149027)(150027)(6041310)(20161123564045)(20161123558120)(20161123562045)(20161123560045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(6072148)(201708071742011)(7699016); SRVR:AM0PR04MB4211; BCL:0; PCL:0; RULEID:; SRVR:AM0PR04MB4211; X-Forefront-PRVS: 0727122FC6 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(376002)(396003)(366004)(136003)(346002)(39860400002)(189003)(199004)(52116002)(386003)(6512007)(6486002)(7736002)(51416003)(106356001)(14444005)(305945005)(105586002)(6916009)(5660300001)(2361001)(2351001)(186003)(16526019)(76176011)(86362001)(39060400002)(26005)(4326008)(3846002)(81166006)(25786009)(6116002)(486006)(2906002)(66066001)(97736004)(53936002)(36756003)(6506007)(478600001)(8936002)(47776003)(8676002)(316002)(54906003)(956004)(11346002)(16586007)(2616005)(68736007)(81156014)(446003)(48376002)(50466002)(476003)(50226002); DIR:OUT; SFP:1101; SCL:1; SRVR:AM0PR04MB4211; 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; AM0PR04MB4211; 23:pqb2fYSh1Bt28jbqcL4I2dctHV4MNj3BPYJFpW1Sl?= Byqiz17dmvp5bqlO14Y+C5swtACObDOD+eVSqqM40H5AFxaOn7CzqDuZqiN4Q3XGCjuXCeS5MVktWrTpMn/HHbiIkZFNsAcQX0eI7fBsx3YtDhjq4TtZX01RfKiftXm8q9YCAs1/z5+qJnslffqmGcgWU4FT0rsIc7m9wD9YSa25HgfNj8yo61klE2NqvSKAgB2kwY/hIqTmvwwur4zYZsi9EYwZfOLdbJMf5tbAGkYuusawXNTTJy+grnZSxRpDTbztQyHjARX4dF+iZLsBNPs1jZDGLhhiqN4qeO3fKP3FhP/rmF1V28wcvqPqXcE4mpZJ5YMuffqu9v+InWIVfpoxDl7wjWlGArVhCSt5fk2XAIPKBzfrDnfkL4XdsLnuVUWI0LCBOwWdIMb0EYcbz7P6XDVcu2FjP/ZB/HfH03h3GKS0l4mad8Pa1Vl9PxtCNRY4GnsDLNUSuOm4IqR3tEoyZzXxTN69ONlClWrpTsRGXenZbRJPEgYvoNb1eIPbn60YMMKuCGlfT1HQ4hOxlO37/xk2hrtB1C5Y80mj3fS4GHK03zNoz5PeQBNqAP1+7MfQCkQ9oKqHp/tfeViCtcJEF4F+ZLurMJRHozviuOKPX57rEWDVGrQWxiuUtCjzORTpGO/aj7Um1mPwlccn6VSnvPzYme6lPZGpv7ItaLn8Niq3uDoMJVd++aiwymed4xzSP1z6P0TLgWfQXH7JvPOvPlI/Kq0XmxWViiOIs+ksnv2REKc4Y9KyJFo/xIWmbd4bYKtySAZhzUt8wRiyPnSh4pPTUGjU5beBVP+qWs5+zyo5TLCrJlRLjWL4auIwhV8PRqV+8PpuIkeG7pAfDd28Evw4+1fxVNpnXqTORPbm1lUbivCBqtpb0xv+xsZWswt/aZEFAt2Yh+aozTqvGQbNva2KJ2bHemjEVdRwXjdTNcb/7/wybNbdnN1h3C+iV1CEUA0bnoly6SZkJyzvfuMuHl0cMq0ejkYp41n3H1AuWz+CtTvXYlibn2c28tSTdi8bPifP20iZu6CdlZPjggeJrHkoc6+URWYok9adVD/7F5x6BciyylJ9Dr4jBfEruPhP6iqOEU5AifTUzMOlQ0PKDzazAjy5+x2XLt8xhdC77J+cxLC1I1XK1+zdMP6guCohyLW11djfIj2v7XCblVyoxqgneOqRTkCSNqXYdH9Dyk+R0vqrXLNCu3AGLI9TRU= X-Microsoft-Antispam-Message-Info: 5qe3ZIeA7K0mZOkJw2Pz8hGmfkgPShUAoIBkwS397NDwYzWIQA3gHKFq8WNDjwlTE6oF3B+jaoKJCA8lTXEn7Q4pnp/87eoIF76kE2eftPGIc4N4I7yxmWAdrcKEHOT8jA5xQuOnM7dGX0MgiyOX0h3iyPsuz8wVcv9ARM7gpmUDyL9vt5LUcOnEVu1QBs3vh+2CN16aPf3NnD8gMP7KMkJHtDv9A5Zalp8CyAwVICT3YLz6POjoLeAig/biMCV1zyBzEQedVGiysqwElxKCkxJtjJWtwIbTItbUS7zhUp8JhLIM9mXod4MJA76Za2IvI8pM4TBCb5JQuFEoJ4bwLFlcldKofSPUxWL5PQAKs6w= X-Microsoft-Exchange-Diagnostics: 1; AM0PR04MB4211; 6:tb1LfCVtMHDa0pXEW8Z0FTx+BQkT77IobHhBiGrhNbzIkzNOhxNysDrlSSTUc1H8wPeLKo38cbxB+uHzh4QxhGancT5bhpliS4eKzJJ4I8eaASzcjG0lYMwZPfN5gSwFjcqoxwh/DdR9lzVCZUTIM746cLlWk5C+YMy8tUhpoalJMnCkOawU1/JtOwDm7zafjo6yUO8UZiUkML5AKgTCcYZIUiDMtk/567oOWwxweboBM0inxRQEKf8cbFOWdycZu05/pD8jVmeooNX2/bfbBDCZNglmdkqq+dCnIIpSj089J5f1QyuvN/zRsAguHSRcGJJdERvmTsJyT8v6Zn0snJz+aWy2Pdkhp1clT4gMfzQ5ACOZ1LG6hpoul3+Wv6fHbY6qFhnZSjpCBVzBj+91vrhGzSQuToeOjnf+QjMKu44UJHCXTwzzN5DuphJJX1rL+QALXmPRFwYqmtRuw6YgDw==; 5:2WALdiJwlnF7tqENV6Eh/AnhI9O9B21xI7aYR8hId35PdXT4kB9bnuJsjIn0TNzFtkVIY+DACMntQnDMJYQwE6yKgjQivYKGRLC6SXIBs3yPNTn+unIWlILO0G1WDBLIyilwQk2jUZ6ulCkALfJiGkz3dHS4WmwSmqGlFLB8doo=; 24:eJ+osFby+JYBwZSP7LtOJwMK97P661x3rNf61vZ3DCNxAzIfIX30xuFhCf3lYPZ8z5kMEJcd8G8o3h+QhNBVHMWlt3ZfoY8ZrBjQ+8e0CDY= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; AM0PR04MB4211; 7:FMUSlBY9s0quU58VWVugrfYrHToH7suPJdn+OabfvH75tKce7oAlbsnJFIwdGuWC79HNjtevECmIiiyigX6IYZOdyYkMEAH4EouSrTIbNhI9x78vWbHrqb86V1bsdqS6r+jDSMbU/+Cgn1CzdzypHS7wDPXev9I7Iw+LStvWdtuEmK55iUYwo6nUPcIehKul37gspKZLr3wYEZL/vWjrnyLxcVp0fmPAsCEFZgkVcFaOUuidGkbxdPSuM/z7DPRv X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Jul 2018 14:59:55.7442 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 1629c9ab-5af4-4dc1-edd4-08d5e4e3794d 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 System Controller Firmware (SCFW) is a low-level system function which runs on a dedicated Cortex-M core to provide power, clock, and resource management. It exists on some i.MX8 processors. e.g. i.MX8QM (QM, QP), and i.MX8QX (QXP, DX). 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 --- v3->v4: * fully change to mailbox binding * add child node description v2->v3: * update a bit to mailbox binding v1->v2: * remove status * changed to mu1 --- .../devicetree/bindings/arm/freescale/fsl,scu.txt | 65 ++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 Documentation/devicetree/bindings/arm/freescale/fsl,scu.txt diff --git a/Documentation/devicetree/bindings/arm/freescale/fsl,scu.txt b/Documentation/devicetree/bindings/arm/freescale/fsl,scu.txt new file mode 100644 index 0000000..11e732a --- /dev/null +++ b/Documentation/devicetree/bindings/arm/freescale/fsl,scu.txt @@ -0,0 +1,65 @@ +NXP i.MX System Controller Firmware (SCFW) +-------------------------------------------------------------------- + +The System Controller Firmware (SCFW) is a low-level system function +which runs on a dedicated Cortex-M core to provide power, clock, and +resource management. It exists on some i.MX8 processors. e.g. i.MX8QM +(QM, QP), and i.MX8QX (QXP, DX). + +The AP communicates with the SC using a multi-ported MU module found +in the LSIO subsystem. The current definition of this MU module provides +5 remote AP connections to the SC to support up to 5 execution environments +(TZ, HV, standard Linux, etc.). The SC side of this MU module interfaces +with the LSIO DSC IP bus. The SC firmware will communicate with this MU +using the MSI bus. + +System Controller Device Node: +============================= + +Required properties: +------------------- +- compatible: should be "fsl,imx-scu" +- mboxes: List of phandle of MU mailbox. Should be one of LSIO + MU0~M4 for imx8qxp and imx8qm. Users need to make + sure not use the one which is conflict with other + execution environments. e.g. ATF. + +Examples: +-------- +lsio_mu1: mailbox@5d1c0000 { + compatible = "fsl,imx8qxp-mu"; + reg = <0x0 0x5d1c0000 0x0 0x10000>; + interrupts = ; + #mbox-cells = <0>; +}; + +scu { + compatible = "fsl,imx-scu"; + mboxes = <&lsio_mu1>; +}; + + +i.MX SCU Client Device Node: +========================= + +Client nodes are maintained as children of the relevant IMX-SCU device node. + +Example (imx8qxp): +------------- +scu { + compatible = "fsl,imx-scu"; + ... + + clk: clk { + ... + }; + + iomuxc: iomuxc { + ... + }; + + imx8qx-pm { + ... + } + ... +};