From patchwork Fri Apr 27 18:51:02 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Aisheng Dong X-Patchwork-Id: 10369623 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 08D3F602DC for ; Fri, 27 Apr 2018 18:51:49 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id EE1B2294CD for ; Fri, 27 Apr 2018 18:51:48 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id E292D29433; Fri, 27 Apr 2018 18:51:48 +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=-8.0 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, MAILING_LIST_MULTI, RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 4881A294D7 for ; Fri, 27 Apr 2018 18:51:48 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1758020AbeD0Svq (ORCPT ); Fri, 27 Apr 2018 14:51:46 -0400 Received: from mail-he1eur01on0065.outbound.protection.outlook.com ([104.47.0.65]:8288 "EHLO EUR01-HE1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1757996AbeD0Svn (ORCPT ); Fri, 27 Apr 2018 14:51:43 -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; bh=a5R6XJSgxdV9B8AW77eHaqgYQLXncBeELkOpsjTMljg=; b=VrZEQyKsRRPrdVcWetLwTsEVu+SRdfJipaIYiVhsQquemdqNZSP98G4OWfXY+XkMtftyIOjc5quKE8owjd26euHsV2FfHUZuPO/tCKEnxwV+ZTZtbsWRiJlsaYEzKTaGTu7hv05e3NITsnJp8FFoVj3Hl0VDpfb42KvNNCBDZEE= 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 DB7PR04MB4217.eurprd04.prod.outlook.com (2603:10a6:5:27::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.696.13; Fri, 27 Apr 2018 18:51:34 +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, rjw@rjwysocki.net, ulf.hansson@linaro.org, khilman@kernel.org, linux-pm@vger.kernel.org, Dong Aisheng , Rob Herring , Mark Rutland , devicetree@vger.kernel.org Subject: [PATCH 1/2] dt-bindings: power: add i.MX SCU power domains binding doc Date: Sat, 28 Apr 2018 02:51:02 +0800 Message-Id: <1524855063-14996-2-git-send-email-aisheng.dong@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1524855063-14996-1-git-send-email-aisheng.dong@nxp.com> References: <1524855063-14996-1-git-send-email-aisheng.dong@nxp.com> MIME-Version: 1.0 X-Originating-IP: [119.31.174.66] X-ClientProxiedBy: KAXPR01CA0010.jpnprd01.prod.outlook.com (2603:1096:402:19::20) To DB7PR04MB4217.eurprd04.prod.outlook.com (2603:10a6:5:27::14) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(4534165)(4627221)(201703031133081)(201702281549075)(5600026)(48565401081)(2017052603328)(7153060)(7193020); SRVR:DB7PR04MB4217; X-Microsoft-Exchange-Diagnostics: 1; DB7PR04MB4217; 3:iPlELYhaicWbyHKaAzg6USg2+vqEIiY3TPjUugCYSpVzO2vqO2z5583ApBJ/Ir+A5x2gl6cCgEN1KZZlqmqurXU10IYaFocueN68fYMWc0vrhYyGf/fUGgP7Yrqdi9/Eaddi6qVDnp73ZrQj3ljlWZjqBNCdwbxMUklflsQR+vkLuCwBP2Ze2bghTajs+IqqNZ0Q2v5J+gn0jPs/x1MgIn8WoupcHUq8hQM8p+HpoUEAHcjSVgl3Q7uHuKzI2vDV; 25:9nEalkTD8LvkvIBwVSDsTol4O5fH1idtQxXrJ57FxWI7QX3U0JMV6aFcTfwItptHqz7Mp1oesgbzw3dTlSzI5kBLkwZnF6ZyKQzNsSJgrk8Ydm9ggU9Js9Ng8H3dT9nMiKmVw1jDarMyChX2zjtSSj0bpD3/SosvK4BH3KfCSUKeuFTc8UetHyq0usGM0NLYs6RdjIahHY6i3g/6GZE7puhINRPXftTaPwy43obW3uP7lCpK+Uc6GSUVQkRFmpg8w3Gb1UfxEt0jlrv2KC6Bbz25NQM/YT3thzzb11h/gFG2rfb1TKa1YaVRQmJ9zaNKiAvHjoVUbTZ9pwOPmcyt4g==; 31:oJ+Rlqf0EfyaPJWDiGwYHKn1RJHPNWSshqS4wOtd2FeLO4eyNoDhWCD+xJm4gACRYWhqMLv4Sh+X//NF2zBVATxTFfXAuplbKp/BqaomKc9nchKbTazf68lLW94TWtqnuNfCBD/5aaDW70x/O0nKr2bHcv4Yd5RHBOfvmg5y3QslFlfEVx/BUFMUBSYO7EZgv7Uwwb0Rmp3a5b7a7w9qpoMw5a6wpX4gI/V0+CxLg54= X-MS-TrafficTypeDiagnostic: DB7PR04MB4217: X-Microsoft-Exchange-Diagnostics: 1; DB7PR04MB4217; 20:h1JmohXUslKR3MiAIJbVDHdh5Lv4w9Slng4rneqEcpGEhIGEJjceSzgi7d/Vi2pFLfeGb2viu872F8983uAHGcrQkO+8civoDFvC/1lc/Q8ZNRDLmgm9hE5vSO6qjCe03Th3xCtL9XNnWqr+P+5SNnsOFIdZXN5jfRgKaSp+ihgsW9bxxQ6Vb8URxL+1Ovr1Wr2KleLhG5gowemDk564InyCTsSIjGCtr+jlkRsscLZp6XSEFRqi4Zlf6WUzlcgCM24MA59E6F6sAFGrhOoJNAwipcM/gVr/1BfLPpw5Y0tgT545fyOIEj+mfmsnmSvf4LldS94nqFDCunnHNUs9zt8sKxkaSBiK7UHCfFyFjxBxDQXBDCkzYLdVDgJcLl0PFH5ZIxIFjTF0wEDtmIOb1nPWg1+nv4sx7R9pdlKAlyGp8ZZfU8seT5b0W70WsU8DX1l40/ZTkofuJYR+YPzyh5DdnnZDxzo4R1RAOO8E06wpxnOnJWB9E5qmw1X1KQC5; 4:Rmi020dHTEa20NcoQwCBG7O7k0dosDmcEu4z+DS9sBg6kW5pAmI0uvJDH0eckzpN0Nq/oqEj1RIZvvedJaumLJ0jGNrbTEC0y4fLQKaZ3OnfyZcjKZg0ZiDGBBVjb34Xn/9dQiTjzGJZAqRq/kQwkInOGv/OcWPIevnin0iSrUn7OLT2Y4+TvtDyzY6n+h8zdf/1uH80WuBP82avuvF1XidI8Ax8PNHETquuSlfc0lNFtQVYoO/OK/QwlmvYm1Fs02bZA0M1i/R/mACVykmDmlVYxgMaknfsJ2G6z5Dlz2Sd7Cg0nRDTzc/y8t12W712o62aKpii6WGQ6FSosdEw2ZxTsHvSKwTVSTNdtLHky3N3R4QUy0ybiZlFSG8NUHa9 X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(180628864354917)(9452136761055)(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(5005006)(8121501046)(3231232)(944501410)(52105095)(10201501046)(3002001)(93006095)(93001095)(6055026)(6041310)(20161123558120)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123562045)(20161123564045)(6072148)(201708071742011); SRVR:DB7PR04MB4217; BCL:0; PCL:0; RULEID:; SRVR:DB7PR04MB4217; X-Forefront-PRVS: 0655F9F006 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(39380400002)(39860400002)(346002)(366004)(376002)(396003)(189003)(199004)(5660300001)(16586007)(68736007)(956004)(53936002)(76176011)(86362001)(4326008)(39060400002)(36756003)(11346002)(2361001)(2616005)(8936002)(186003)(8676002)(16526019)(305945005)(2351001)(26005)(25786009)(2906002)(52116002)(97736004)(48376002)(50466002)(6916009)(7416002)(486006)(7736002)(446003)(50226002)(81156014)(6512007)(6666003)(105586002)(47776003)(316002)(478600001)(66066001)(476003)(386003)(3846002)(81166006)(6486002)(6116002)(51416003)(6506007)(54906003)(106356001); DIR:OUT; SFP:1101; SCL:1; SRVR:DB7PR04MB4217; 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; DB7PR04MB4217; 23:c70F45Fc57KDHx9iJTjWej9t5dEsOjZ59R9JALOgS?= =?us-ascii?Q?NCH/rL97CSPqAxO2zHUVPGPGxidJyEIxWEwXi7A8mv9ES+g2yL1P+5iRQeNq?= =?us-ascii?Q?6Hgc925IrbA4FAGCxnhOUXzLMiCrEMbdUeQXy84quEBnQWcFNglmENgYB14M?= =?us-ascii?Q?bWjbJlYRriUsfcqG8UVcauwpJhxdExa57gE1qzEqJAWdatdR9RUkyEA8cBB+?= =?us-ascii?Q?ZHnm5DjiMVmw/guyNDO/QH+oJcPeKphJgCMx54yKw3ghrvjAGwhfENR8CWvu?= =?us-ascii?Q?egwy5xo77FGX2VGlEDnudlXQbdUAvfygFDCs5F9VoKTknwLKtj7ZQZRpHypp?= =?us-ascii?Q?ysf9823NlbRzmOOb4wY6gRIHC37LSroExgemopQjINSfrMVPrM7lshupHaZz?= =?us-ascii?Q?uX/DpYoAc+e0gz8oPqzmM5/3PJ0sCvNZgfsSYIUq2Gd8avwZOzqPTyrvcMtN?= =?us-ascii?Q?Bi4QDyPuMgPdNyev64sObshXT5oUySm1mUbSs9F8/afaib/Bc1TH/yHC2Q8U?= =?us-ascii?Q?PQ3rgr/Z2vU2Kr1sOuIxpt4vUsotpIPOHppJ3evMeqpI+9sWkcUflZ+c6pE7?= =?us-ascii?Q?jrJMCXbYQy4UWZnmBw7AkdhLr6DgNFXhuT+WIXXSmvYKh/qO3ntec2fNoZBj?= =?us-ascii?Q?34PXCJKRJEUgkHURdp1ywtkvrbry5gbdYlGRmxwj9zpFH0ExRSIpFZp7gd3t?= =?us-ascii?Q?S4Tr5pQms0DGyupn4Lfg5us2deIKensrPhGMyM3AcCyFYNjFsOt1N3De50je?= =?us-ascii?Q?xi+eppsr2FWi8BIQzAwWvuUa2oOYPuDqcTkGlhEjKsoV6H2SY4VAmNHRJEIi?= =?us-ascii?Q?Qzm13+eGiksWdVhohlecylcVviYBG1ptCaVqQ+lE1yyvghbIAzljCn70xLjK?= =?us-ascii?Q?PTBsA+zzDqnks8HidfxS9Q6vpxTNoTROhotojnZMeFkz7BqZEz8bbVf7z3hn?= =?us-ascii?Q?Evt3IMDKeH94rAs6k4PBZjd/nnVO4UCgI9tHFpP0zhR7yCbU13EGlrWMzrUg?= =?us-ascii?Q?KP/87YB+ZoY3C1O7R1dALmD/AhjS6URMVM8xpQws4tqjxaZGOKXuoXQli1zj?= =?us-ascii?Q?49nsa6jLMov0yShfYpP/v91+GIUi4tbvgvTvv03RtbxT52tOmySgmNrCdjyA?= =?us-ascii?Q?kz5+gJgr7VYRVH6GtR9pLNxN7NOAquUQmz6RGUyUdjWEBU+hTi+Bp6xlRCaG?= =?us-ascii?Q?1md1ABrl4hskPP3Sxk7m4GSX6LmdT3VhOJGrY1uBE7mzBw3YtdHb9K+M1Jt7?= =?us-ascii?Q?q0C/q801f4Nb/XAG9Zyt5AVto9rEEpVZRe9Tlxxylxy+exbPVNrHtMdQM7av?= =?us-ascii?B?dz09?= X-Microsoft-Antispam-Message-Info: jMzayd+wmEZ5iOxNtoFkkdOKbAmzSYaH+1tEZhKzgELeS2J+jgOkZtAG6st+atIXp3D6AK57ByJfhelynWN6leH1OsVULJMZAwFPWC8Ufj9aCUHEWIZiZuns4C8rPg1HDIzVsbUH2MxNNJw0h6cDOT9LS9L25+1hQlsgQplFYR4F/4bbPa/C1nEDvUNWBLcn X-Microsoft-Exchange-Diagnostics: 1; DB7PR04MB4217; 6:IhtakJb2kzsjmmLxvMvlqytui6bjrlfgu8Z9vwpG+IweO4UnkkoR9krRae5SQCUXAij05IIqqlRWoX/sMHCbrjaS+0ewnM3zPbsRl+qjJrogfy3N1PWYBieMcNyZ7aBPfaq69/V/0wwDD/lcoRk+p9DjhrkWqxH9ZqfnenQcN7fGaa08eQnBcVVKDJQk9BzYUMHf0t5GJ4vv5Xx+U5I8ypu4nyu124wXbtcSIQBYNTkE3zU6olkBo+5FaMQfxUaV02yD+SFq1W7vK5ae5a+1Q/Nny8RUIuELz6nu+M4q6Y5R15YLY/Pr65v5Z1HzfpcIswPCeJqkeCgaH8tS6JiQzcsdxddL5VBwK+lMdPWU+LkvRBoIAc8Eg+471YsY1heu2yKz4RNagT19TpwVd4T6NdCh18Lx6s4q8nwfR23nT/nM1Jz52YvdOttdXefOxSMD811YdyPZMWMG0ienvai3Ew==; 5:tyFGFk8HchemNNCH1uMmndCSU/ouVrvX85DhSCJnqCnLy0P9Ayzs5Kk1xA30+xAfLiK3cPHXu6gsDAQlma/qUzvYU3bWx1uKZg1z+1DFcc0v9Z91lSs83p0VgJ1c3PVFz1CrVSEOPt/jEHd5ekNIOn3TadwRJqOQVG71O2hl9kM=; 24:qmwliblXKQ2/PjttjaObLGy7wAR3rRMODLarYDPmPWq9OfrNTeon01OKdmJyvTjGSJReUc9HDEtI1HhX28/RdeLnY8rNojYVC1lGCS2QCtM= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DB7PR04MB4217; 7:BM10chd8imtXGowlGaJ8x0D2x6uvka+PZz1cIOJ0TSXCchSAKagupPgyFIyUfVHHnMLjsyjhPmsOKP/RsrHBOPe9xfp5xNt1SJ7JE4xlifSP/BnG/4WgobtyWBX7yp0/9Oas+rAYlTAcBUr1hq3hKIjSOdvD80d0TSaLWo79s3a8pgi3vZxbLZ7aZ+OiTP93CKJJeeNNOq9hNqajh2ZlZsj5qN8gOcYViDqKu2h9uQDdoEiRrx4FMawgnwLVGTx/ X-MS-Office365-Filtering-Correlation-Id: 9ab93c6f-c18d-48a7-c5b4-08d5ac6fe92d X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Apr 2018 18:51:34.4668 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 9ab93c6f-c18d-48a7-c5b4-08d5ac6fe92d X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR04MB4217 Sender: linux-pm-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-pm@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Some i.MX SoCs contain a system controller that is responsible for controlling the state of the IPs that are present. Communication between the host processor running an OS and the system controller happens through a SCU protocol. 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 --- .../devicetree/bindings/power/nxp,imx-pd-scu.txt | 84 ++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 Documentation/devicetree/bindings/power/nxp,imx-pd-scu.txt diff --git a/Documentation/devicetree/bindings/power/nxp,imx-pd-scu.txt b/Documentation/devicetree/bindings/power/nxp,imx-pd-scu.txt new file mode 100644 index 0000000..d21cc22 --- /dev/null +++ b/Documentation/devicetree/bindings/power/nxp,imx-pd-scu.txt @@ -0,0 +1,84 @@ +NXP i.MX Power Domain Based on SCFW +-------------------------------------------------------------------- + +Some i.MX SoCs contain a system controller that is responsible for +controlling the state of the IPs that are present. +Communication between the host processor running an OS and the system +controller happens through a SCU protocol [1]. + +[1] Documentation/devicetree/bindings/arm/freescale/fsl,scu.txt + +Required Properties: +-------------------- +- compatible: should be "nxp,-pd". + Supported SoCs: imx8qxp and imx8qm. +- #power-domain-cells: Must be 0 +- #address-cells: Should be 1. +- #size-cells: Should be 0. + +Optional Properties: +- reg: Resource ID of this power domain. + No exist means uncontrollable by user. + See detailed Resource ID list from: + include/dt-bindings/power/imx-rsrc.h + +Required properties for power domain sub nodes: +- reg: Resource ID of this power domain. +- #power-domain-cells: Must be 0 +- power-domains: phandle pointing to the parent power domain, + for more details see: + Documentation/devicetree/bindings/power/power_domain.txt + +Example: +------------- + scu { + compatible = "nxp,imx8qxp-scu"; + fsl,mu = <&lsio_mu0>; + status = "okay"; + + pd_lsio: lsio_power_domain { + compatible = "nxp,imx8qxp-pd"; + #power-domain-cells = <0>; + #address-cells = <1>; + #size-cells = <0>; + + pd_lsio_pwm0: lsio_pwm0@SC_R_PWM_0 { + reg = ; + #power-domain-cells = <0>; + power-domains = <&pd_lsio>; + }; + ... + } + + pd_dma: dma_power_domain { + compatible = "nxp,imx8-pd"; + #power-domain-cells = <0>; + #address-cells = <1>; + #size-cells = <0>; + + pd_dma_lpuart0: dma_lpuart0@SC_R_UART_0 { + reg = ; + #power-domain-cells = <0>; + power-domains = <&pd_dma>; + }; + ... + } + ... + }; + +PM Domain Consumers +=================== +Hardware blocks belonging to a PM domain should contain a "power-domains" +property that is a phandle pointing to the corresponding PM domain node. + +Required Properties: +-------------------- +- power-domains: phandle pointing to the corresponding PM domain node. + +Example: +-------------------- + lpuart0: serial@5a060000 { + compatible = "fsl,imx8qxp-lpuart"; + .... + power-domains = <&pd_dma_lpuart0>; + };