From patchwork Thu May 18 00:48:57 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 9732219 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 4DDED600CC for ; Thu, 18 May 2017 00:51:48 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id E820C2873D for ; Thu, 18 May 2017 00:51:47 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id DCE13287B7; Thu, 18 May 2017 00:51:47 +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=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=unavailable 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 617B82873D for ; Thu, 18 May 2017 00:51:47 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754677AbdERAtl (ORCPT ); Wed, 17 May 2017 20:49:41 -0400 Received: from mail-by2nam01on0075.outbound.protection.outlook.com ([104.47.34.75]:28189 "EHLO NAM01-BY2-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1754662AbdERAti (ORCPT ); Wed, 17 May 2017 20:49:38 -0400 Received: from MWHPR03CA0018.namprd03.prod.outlook.com (10.175.133.156) by BY2PR03MB173.namprd03.prod.outlook.com (10.242.36.139) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1084.16; Thu, 18 May 2017 00:49:33 +0000 Received: from BL2FFO11OLC007.protection.gbl (2a01:111:f400:7c09::183) by MWHPR03CA0018.outlook.office365.com (2603:10b6:300:117::28) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1101.14 via Frontend Transport; Thu, 18 May 2017 00:49:35 +0000 Authentication-Results: spf=fail (sender IP is 192.88.158.2) smtp.mailfrom=nxp.com; nxp.com; dkim=none (message not signed) header.d=none;nxp.com; dmarc=fail action=none header.from=nxp.com; Received-SPF: Fail (protection.outlook.com: domain of nxp.com does not designate 192.88.158.2 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.158.2; helo=az84smr01.freescale.net; Received: from az84smr01.freescale.net (192.88.158.2) by BL2FFO11OLC007.mail.protection.outlook.com (10.173.160.142) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.1075.5 via Frontend Transport; Thu, 18 May 2017 00:49:22 +0000 Received: from b29397-desktop.ap.freescale.net (b29397-desktop.ap.freescale.net [10.192.242.114]) by az84smr01.freescale.net (8.14.3/8.14.0) with ESMTP id v4I0n18Q023387; Wed, 17 May 2017 17:49:12 -0700 From: Peter Chen To: , , , , , , , , CC: , , , , , , , , , , , , , , , , , , , , , , , , Peter Chen Subject: [PATCH v14 1/7] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Thu, 18 May 2017 08:48:57 +0800 Message-ID: <1495068543-6938-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1495068543-6938-1-git-send-email-peter.chen@nxp.com> References: <1495068543-6938-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131395421749227485; (91ab9b29-cfa4-454e-5278-08d120cd25b8); () X-Forefront-Antispam-Report: CIP:192.88.158.2; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(336005)(39850400002)(39410400002)(39380400002)(39400400002)(39840400002)(39450400003)(39860400002)(2980300002)(1109001)(1110001)(339900001)(199003)(189002)(9170700003)(47776003)(189998001)(8676002)(5003940100001)(104016004)(8656002)(77096006)(38730400002)(85426001)(53936002)(2171002)(50466002)(48376002)(54906002)(50986999)(76176999)(105606002)(86362001)(575784001)(6666003)(2201001)(33646002)(4326008)(106466001)(39060400002)(2950100002)(7406005)(7416002)(356003)(50226002)(36756003)(8936002)(305945005)(81166006)(2906002)(5660300001)(498600001)(41533002); DIR:OUT; SFP:1101; SCL:1; SRVR:BY2PR03MB173; H:az84smr01.freescale.net; FPR:; SPF:Fail; MLV:ovrnspm; A:1; MX:1; PTR:InfoDomainNonexistent; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11OLC007; 1:lyjTyQhKUYeroMJHbQgY4teTQN28VgnTp0v0qO5GeLcX+/xj6Q7FtF4NvIvaTsQy0FLrxsqPWSn0Ku7KXF6yIS8Akw9xe/BMZ47nsTvVy6X2okfUFDDJJWF8kOsUy/13vm7kzd2m+xnNhEfjJZIiWDtnTA9xag+BWR7ssSYFRlBV79dcj6Xk7u/v/3hiOl/0gKkvthw62K2pK1U484kCnlnuup/KtlXXzZxh5n4YHi+7jX15NVtvveSxdX7yENwwaBhce8GCNI6hfcCguNcXc38KMOq0OFvu2/OCxqRltixj4S/G0uwffrSiYV5ZTlwukJDwg6gvd5Xz6SVsgoDA9fspPA4fXgUdU0DcvxHnAGT6SVzKcQu5iYfkubREBFd9/mlrUQzQwkeOi+8XxhkIrHCV4kWGWPpUPtboe/EwzsM5RQgJ0Tw4Yd9cSqL4ja4ud1qjl2ZPJg6gPu91L0Vk4UkkODMBbSyjHSF40ONOoaAgLlUIMfdJIMYt8NCRNa56xaGy+8861QkRAYlFFvTloCgSIQC0S6Vdn+y4zfxUGrkYrJg4CWHU1h2ge4rq6w9VKjLzXeTCzswD2BpR20O1vCKiaMrIerkDz0iI88Ol6dQlAv8HZGLl1xLsi0JwB4oGi113+rvA7I5e+pg7rF53w1sTM30zwMMTj8rxNDKIDmKy6xIhTZNhqTMj3NR5RuWIS3AXsWWnLHiOUSp5XtKycO8gl9GzPKTaRJyN+cE91B8CANxPA+YuhQuBlgvbfwcFlR6gnxx8QC14f36TWLskxw== MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 51baa3da-db38-45f3-afdd-08d49d87c0f0 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(201703131430075)(201703131517081); SRVR:BY2PR03MB173; X-Microsoft-Exchange-Diagnostics: 1; BY2PR03MB173; 3:kcQnEZspTWkSQeKtSjfm1v/Ljbd57GXSNcFPYhRaE58jSr+6bS3I18NoPYfzQ0woHqMx7Ws2o1x4k40n1d5vFvqm5oqmW7GOEG/rhmcWeyhDZwfG0aeScnBqYba8wh3umLwM8v2XlbZroHIaNhV3Qd2mXRLoxPCUbg3vJJwgKrwY2HtYPYteTJVuHup75WXEDKhw6dQ1NtY4hT+TQ1nEEO6AqejXlAgk37YA0XBokiEC7Ve0+PXrjuIP1TsEby7CHRVaS57XSIMNIp2lz8hZnq3QMkTyxsyLjaC9d5w07mj3xp0fx4B6wyWUjljBf45Lusz6kSVUUvVcyCbbFK/dUbFnmUBZouq8+Urc1b4sqSzFmy28CSMI+G99+Wgm6NzzIuLzYHYcx3uTNP9Sq6mGEzw/sQ9RewaD2pwSxKH/rPOOskpU89IjZ/ZNucdiwEdZ; 25:QhpImXcE4/+wbjB4MK8B76ydJ0KtcvL9nMfpDF3K8FdnSFEi/AhveKBz3gHy9SOEVVy7sUn2y990uM2a48a1N8xRImi2Twv/yECYy50FlAWFO5kdaz3c171k86bTO05KNaim3vNyxeLfOsimyQqs8Fm8KxMfbLrY0DE2O801Ng22whQcdy3tlOCSdSd7HFbSeMN0POoX4U/p8JBOIrzaRO2lg9/TJ9ludBs00Cb3LjNLYvRv/Bqf4xVOQrSzOb1fz/KIMvaF7VZM+9h3ryLJRncs85rFfCWAEWnurAk3zK4gTA2FVVxi55IQlgiPD1itpxWjbvzmG/Rg755GY0kXLJ4/ckd9YHPE68RT/Wcj4s7ciRZVwBHn3ZlJxuBV/m4r+JnxUN8qmD3P2nZkQoUUA4aaNgLUWho5CKJYg3XPpR6bcNeptScXMy+LzXzjPEwKnlegYx0ALlnPt9Gk0C+aPg== X-Microsoft-Exchange-Diagnostics: 1; BY2PR03MB173; 31:cfLPeC1/o2TvnqW19SOd377A51GaPJ+PX3CkaXvJGGs3pBvJXFOIFx5yma9PTZrBnLS9+fJzZKZ+TH587qde1WwKNSvapUviizoP0opwxMZ/FaKww6k/YFM3TRLFlU9ooF5wxUx6oPNyXvvRLPTzg72Xt3WyvWmcvHtZ1xfogikJtndjOXNh1WVQXErXhjNNjgRCLpmJ44R6Gm1ug/LKTAQOzzJqnrqDdGmKlsNFcW8jbKW6WGH0oXAzdvEmO8YBvVCb96/F0kgW9NxhZqCX06smTEIuOjQfj3Zvsjufins= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6095135)(601004)(2401047)(5005006)(13015025)(13017025)(13024025)(13023025)(13018025)(8121501046)(10201501046)(93006095)(93001095)(3002001)(6055026)(6096035)(20161123559100)(20161123563025)(20161123556025)(20161123565025)(201703131430075)(201703131441075)(201703131448075)(201703131433075)(201703161259150)(20161123561025); SRVR:BY2PR03MB173; BCL:0; PCL:0; RULEID:(400006); SRVR:BY2PR03MB173; X-Microsoft-Exchange-Diagnostics: 1; BY2PR03MB173; 4:aTWi2tJaD6AcDvicb/j7eO6GWYSCE+PeWHBZmPgJJ3fDw6M0ubIdm2osGfDO41P90LrwXXUHP8yxYVZamDf5hgnCsCDJn/Cx0jQG4RLe0vbktl8iLeWRhXt6O4XlvV5hddiDBwGlNDHsZtEvxl4BLx6kwpFYmrw1jnPDsLtGJ6SG95CNh3+oWWnTUWWmHwBUIy077ol8T/nTLspcjRvF6Pu8THZmfNtIZNcKXtoEJHOT3xCZLTL+Kpdv65UKV1OqNLGEaDoBBRpgZMa1a2L4t93/ivL37w1b7jmS2FoDVZsafEG8tmMewKE7tIUe1dqMVexy0YQnPphDdpw6rQxRGwweNdEkacqYxQVTM3yezGZO+HweIj8xBO43b44OgwpIAve0BVV0Eez0Fv88iCags0Xy6rNqvot6r+FHE6ccf1VabIrpw1QuSDnsh7HUO0nBfdt5N1sEsz3IWAYslFagl7asp20efrvO+1/fI6bTTJdGEC/KF9Nib+erziJL/szEuBX8mqY8X9bypWThm4MPGD87yRYs4HPQJum4ELTA9qz1Ymaf8/keUsZGUP71I9lHcQ8wsxJ4xE3v0of4jT8WDvLHC9qU+Boey0x4AIbvJJhHc9/P0wmxk01qJpG9LOkKvsI0xRdggo4DiDm5Wq7eoYlPFyWqDgfPvZryLgm4CdJfbqIpeZI7m6933JQypshGfjyQWnuj1gu2iTIrB1lLkT3BsXr+toLhAFfe+/7ksWa7o9+oMNmsA/GMlFteOByNNjnkBXvB6tzrbYF6QWj1hDfR0gj2W4qaxV4HpJAUtLKmAfxkg88XItho17VfWJwMJfhTx6BBY/16UqLlqGpQGBPDH/z3wGiJuSPPdO216WkhXxASoyhL3KN7vvUhFzjbJcGXfH/wFhXFb0AvB7dcVPuXDaUlcS/WycP7lsR2lgg TlxC+Hz7lzIPpubEmEmJx X-Forefront-PRVS: 0311124FA9 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BY2PR03MB173; 23:g4TrWrbnCVuP49Hv7FN3dN2bT4oeAZ6hMsDnlBqncI?= =?us-ascii?Q?djoIx2rYVm2EfzSFcEVYYhT8TixA4MYXnL9M1CowDIm3C8y6aW1JtFMxe3Lw?= =?us-ascii?Q?xtbdoZ8En1ssiw6e7aX/IM5qAYZi787/QoL37Mt8O13zqnqJvXFIS6ANf8hx?= =?us-ascii?Q?GTcGUrYfzg9/E3O4e/4sabLQ/ei/0cAqNdVUDseMPZyQW8NGBQ6KCvtF+Cwt?= =?us-ascii?Q?lnvLki3zVhshIlGqF0hNt+GvgnIM4wb6cm9dTyW/jMhLLxCgU/i4crUJHnTb?= =?us-ascii?Q?gsKl0PVoaCa1CLHFCi+jhcXzeocBnnFYrb5JPGeTXnU/v3aNn6qLwkpgXGor?= =?us-ascii?Q?Gg11o/8Tp5zn+0dBKm2WVDNm4ZdfaJoM7JLroXNHIedGnI31N0aK1xTpnduG?= =?us-ascii?Q?ll3qefx+k7RIPu1hw8WYUreZyjxYRZXt/Z+5Yh1Lk9vNzQxaqvHObW+F5B+g?= =?us-ascii?Q?2drKEUfYOvtOscvSn49W6O45k/Z4FGjdu2Ih/Znfx6pCTpoRvWwmsDOYmDdX?= =?us-ascii?Q?4BQq3He2Et+dqOovS22aJ17YI24KLiS01BCaQw3oxexwJJX09+bChTbZUOvQ?= =?us-ascii?Q?UTJu1gRuwjN9lvWhsSkmowxBhE79fINH3N4X6uDWfLIaJGD3jjX2N79apP7F?= =?us-ascii?Q?TqFgm1j7wVjZMG9kAKztk59DvhW/vsekKSZI3QrPJp4hay9wkzKvJbITISZi?= =?us-ascii?Q?jfMGTui6ODnZXMp34Ucbg2BFWOGw9VWTqz+GIocEXKrNZaV/9zCyzzhzxAxW?= =?us-ascii?Q?0NVLKnrGYCj6rbV/uCuftiyTx3BiJZvc4ZvAmnW0OQ7NqV6BUwfKar5DHUBU?= =?us-ascii?Q?zPVKNyW8ehq8Z6yaHxpFZv8eyaNgTA2vfGaSDtm0xQs/1c+9J01e6tiXVcvA?= =?us-ascii?Q?9iLSfc9qa0BU6vYu5FDxOVeKdv3SBJKaG3UPINQql/fyyufsFWiG2H+3GGge?= =?us-ascii?Q?JjD9JsbYoujLf59kxCkkQkYdsm53kp92sUQAzg0pJ+H7vE4STjuFV7JtiK6N?= =?us-ascii?Q?R9RWyu18prNN1EFL8IhfBr7BtDD98Xy/lRov58eOwsan4CnSv3+uMa5RsKa/?= =?us-ascii?Q?fVZziJfNNGDZax8Ph0Wca4hrk5az6WXScY0jK8LyCQoEUaPwqIntyhKUcw20?= =?us-ascii?Q?shsh3mnAZhXznVu7lfcpsjHMi8JNYY7Wgj4YPNd3exypSC5/eQ4ef27nfPIm?= =?us-ascii?Q?jR9J+vMiP/zYSP41hk43S4XHxChBFIHvwhMo4qh6zMD5alnhUvsHhseQ3u0S?= =?us-ascii?Q?rW1N67I71i8pxyACANAtFbHkK9f7zawH1kh+3+DnDZMm9hSoQ4MmTrdfINPQ?= =?us-ascii?Q?NjgfRvO5uVVm26eHr0CKHyhzHEuIC2vm7pFokJ2Jq/?= X-Microsoft-Exchange-Diagnostics: 1; BY2PR03MB173; 6:hMePdcIJzyZAb0C0STzje5SShvfLwKiZCVswgOPvZlxODK+sPITsTgNDNVNHd/nzcfzmszdJQyuaxZCKNDsjBJgAWiw/O7Zmu/uMeNzHV9d7Z052naWjWcu5LYI0mJNqZ4ZC3EuJIYpuj3ZYTZAVguuYjOMzpEtNly+GpiijZzYUNFiDajQLUCvF8VsYpWxJHGnnC6Hpc95OzU61dg5BQBNgvIQSDbSnhjpkXoXmfjBYCMqnQylLY4ry3C/NmnW8ZO9OZGkPgBR0kRNkfjP376+VFfo/FLkG0MuTulKmdIhCpI9X+k329rZ6vovrC0I/M/udQ88QGZCx1h/20dOxvI824bf8I0GACvYyZ3I+8n7efnaXXdIH9tsbRg93r/o4Yhd6HO6Yv4EyUUJy0jDdY2rNG53q+ByoQcaP1drw9DMerDfTnh5GdAeNJbxoIQEn3fJKrSk8wqK/ExkGGHW/q9ldkcOZ688f5RMIZHPTaNPoz/ApcZJLTbOuPIsAAaPXInSFsYc97nQXf4krVoAqRw==; 5:V6a0GfRTByn7lyqrLro/k7XYMg4/Vx4q5tc/jUMuUoHM107ClKkAFMTbAgwLa1pda/vCUM9Lwwf/WmeCTdGkl7F+aK4NIC0ByqhcbNXaqb1p2VhdYc7uHVDN3UKmAoMMFAEHnM680dgBoNTo88m8FOunZagaTOyIHeXhguDB1L0yXRm4O4NLLUDX+mx0X5IU; 24:B4IPzbuKoh4G/FmA/1PI7GiVk/JpkLeu6jgv9CvNn/XqzamvQN6FkEoJKJu8BsccJJJMRwBjrW8L+Pe2ZI0/LkVP2if7dwuWTmKyXQan9z8= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; BY2PR03MB173; 7:wF6OJUQSk1LxuanE6yLV1qg7uyvwWvwYFPzveFANZvSbf8BXm27AvQRbNxZfNqzNi0y3pPXU7czVxJr8IEMDUKkXaM3KOx99nJ4hsBxAEhcGrpBkAdT09vXmE/9rht0Lwax3LwfCLICMQrbHQebMrOYhDbnFZh7hozux9tS9+0ZnKs1hR6SZObGmDVSSWB5cXJbUoiUTknPjJG98BiQmvMEYV4rzGckCALZoSVo8g07KmlUapeQ0DNpp8X5+G7ZlEvszifsufuusUra0nJDObJCmKOdInHg6vD8T6kbOWCa4mTJL2UyblE6Kb87geRhDECF28INy2Qbo2wsyW+5w5g== X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 May 2017 00:49:22.4740 (UTC) X-MS-Exchange-CrossTenant-Id: 5afe0b00-7697-4969-b663-5eab37d5f47e X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=5afe0b00-7697-4969-b663-5eab37d5f47e; Ip=[192.88.158.2]; Helo=[az84smr01.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY2PR03MB173 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 Add binding doc for generic power sequence library. Signed-off-by: Peter Chen Acked-by: Philipp Zabel Acked-by: Rob Herring --- .../bindings/power/pwrseq/pwrseq-generic.txt | 48 ++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 Documentation/devicetree/bindings/power/pwrseq/pwrseq-generic.txt diff --git a/Documentation/devicetree/bindings/power/pwrseq/pwrseq-generic.txt b/Documentation/devicetree/bindings/power/pwrseq/pwrseq-generic.txt new file mode 100644 index 0000000..ebf0d47 --- /dev/null +++ b/Documentation/devicetree/bindings/power/pwrseq/pwrseq-generic.txt @@ -0,0 +1,48 @@ +The generic power sequence library + +Some hard-wired devices (eg USB/MMC) need to do power sequence before +the device can be enumerated on the bus, the typical power sequence +like: enable USB PHY clock, toggle reset pin, etc. But current +Linux device driver lacks of such code to do it, it may cause some +hard-wired devices works abnormal or can't be recognized by +controller at all. The power sequence will be done before this device +can be found at the bus. + +The power sequence properties is under the device node. + +Optional properties: +- clocks: the input clocks for device. +- reset-gpios: Should specify the GPIO for reset. +- reset-duration-us: the duration in microsecond for assert reset signal. + +Below is the example of USB power sequence properties on USB device +nodes which have two level USB hubs. + +&usbotg1 { + vbus-supply = <®_usb_otg1_vbus>; + pinctrl-names = "default"; + pinctrl-0 = <&pinctrl_usb_otg1_id>; + status = "okay"; + + #address-cells = <1>; + #size-cells = <0>; + genesys: hub@1 { + compatible = "usb5e3,608"; + reg = <1>; + + clocks = <&clks IMX6SX_CLK_CKO>; + reset-gpios = <&gpio4 5 GPIO_ACTIVE_LOW>; /* hub reset pin */ + reset-duration-us = <10>; + + #address-cells = <1>; + #size-cells = <0>; + asix: ethernet@1 { + compatible = "usbb95,1708"; + reg = <1>; + + clocks = <&clks IMX6SX_CLK_IPG>; + reset-gpios = <&gpio4 6 GPIO_ACTIVE_LOW>; /* ethernet_rst */ + reset-duration-us = <15>; + }; + }; +};