From patchwork Wed Jul 13 02:06:45 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 9226715 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 0633160868 for ; Wed, 13 Jul 2016 02:16:38 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id E99B526A4D for ; Wed, 13 Jul 2016 02:16:37 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id DBDD827BFC; Wed, 13 Jul 2016 02:16:37 +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=-4.2 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, RCVD_IN_DNSWL_MED autolearn=unavailable version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 51C7826A4D for ; Wed, 13 Jul 2016 02:16:37 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.85_2 #1 (Red Hat Linux)) id 1bN9hj-0000a3-GM; Wed, 13 Jul 2016 02:15:15 +0000 Received: from mail-by2nam01on0058.outbound.protection.outlook.com ([104.47.34.58] helo=NAM01-BY2-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.85_2 #1 (Red Hat Linux)) id 1bN9hX-0007ul-NT for linux-arm-kernel@lists.infradead.org; Wed, 13 Jul 2016 02:15:05 +0000 Received: from BN3PR0301CA0029.namprd03.prod.outlook.com (10.160.180.167) by MWHPR03MB2510.namprd03.prod.outlook.com (10.169.201.12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.523.12; Wed, 13 Jul 2016 02:14:42 +0000 Received: from BY2FFO11FD018.protection.gbl (2a01:111:f400:7c0c::178) by BN3PR0301CA0029.outlook.office365.com (2a01:111:e400:4000::39) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.528.16 via Frontend Transport; Wed, 13 Jul 2016 02:14:42 +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; nxp.com; dkim=none (message not signed) header.d=none; 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 BY2FFO11FD018.mail.protection.outlook.com (10.1.14.106) with Microsoft SMTP Server (TLS) id 15.1.523.9 via Frontend Transport; Wed, 13 Jul 2016 02:14:41 +0000 Received: from shlinux2.ap.freescale.net (shlinux2.ap.freescale.net [10.192.224.44]) by az84smr01.freescale.net (8.14.3/8.14.0) with ESMTP id u6D2EQeu028042; Tue, 12 Jul 2016 19:14:35 -0700 From: Peter Chen To: , , , , , , Subject: [PATCH v2 1/6] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Wed, 13 Jul 2016 10:06:45 +0800 Message-ID: <1468375610-18625-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1468375610-18625-1-git-send-email-peter.chen@nxp.com> References: <1468375610-18625-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131128496816391993; (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)(7916002)(2980300002)(1110001)(1109001)(339900001)(189002)(199003)(36756003)(8666005)(6806005)(8936002)(104016004)(33646002)(189998001)(68736007)(586003)(97736004)(92566002)(50986999)(11100500001)(86362001)(356003)(7846002)(5001770100001)(77096005)(50226002)(19580395003)(81166006)(81156014)(47776003)(2906002)(5003940100001)(105606002)(4326007)(50466002)(8676002)(305945005)(69596002)(106466001)(19580405001)(85426001)(48376002)(2950100001)(2171001)(87936001)(2201001)(229853001)(76176999)(7059030)(41533002); DIR:OUT; SFP:1101; SCL:1; SRVR:MWHPR03MB2510; H:az84smr01.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11FD018; 1:mFPlXFPbWJdWBQScdNdiUJ8jXEqlDAvuDB+2FHxEzbkktndpJgvg6gu7PkWz6iEu33UYNIql52V7lSq5N5duDQttmxbJTeSdESljnwSykKY4EqhswZuRn/3tlpHjynhSVycBikiY0jbVrmz5QzN4jOx2HZMwzW61bbRcFzMgzrMnXbCfZEw1lwGtxpWtw2i5U1bPXkCoaWC/hWRaQV/YrjkOTeZuS4M6spOD1JKQXjJJpx36+DSr9Nf6pUSd1XmY5zHI6bxalNUHTfTMLGyL1DqlyD3Ip/a8GFkKzZ1fvts7sQTQTZ4N1bK1dFCTBad2870hotjr+yoNTBRps4y95twmEL+dhPNBBRLLkZn+amjgN30wPJ83lg6bo9iDlSiilpOEGfbyTZObnAf0sDPS0srwH8rmm8/aek7j69oUdH1j8w9CQrMgpOFuY4aXnAdUgE0wnfZmzinIoyUnaxOdHaNgrkd3tzJE4f2UDWQmnRCi7KBc/I3P8/BDq3IeRic3u4lDu1rmIQOaGAsmOWxI031Gq2aD3zEww6/k/vdtGAHbyC6wEHRPjV6hBRMHeMKRo+FZO571+3K19N8eLSWolixNmtJPD068SBWvP/Cd4MZY4fi3iBgzOpP3VYocFm5PB1VYTx9s7gEdDKQc6nLlcH2jibHlPYo/70FxoMapXt+96HA/LWnMGre0SocA1kjcDfnD8UreSVErnUWm9JvsQ/kmTLEc7tgYz85p8Cw6sjpfLw5+7q82tSJNudkYDmAw MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 10509574-f532-4c98-9ad0-08d3aac3730d X-Microsoft-Exchange-Diagnostics: 1; MWHPR03MB2510; 2:apAKZwMQV24KFqo4XVf7KHM8EzcaJQ2YV+Wr/m+Xffk7+ApRWDOFt+creAia+oLPw1WTynsxG6xtWkgDcBkTEpyj1d9uXcrcCcZ5AbuHwiLqblQC0fDikaZzkkEbRqN0N5dXwk1BVhQTpOZNwAMCkybU9reMfLNThsLEgiSUs6zSla4Z8QqWfEi5Askzv1jS; 3:Z7a6XyF5VzDf0Fe2gZIURRV1/9ODzubRK9+xhhnaDAxzaBeRdA1R2rCM6s/rdpbUTKZraCbNy3BsJBkbdUaMZGkCxzF8xjSz4sOyQYZMMn3FqdZ9Cfl0lH3nzDWlI2Zq8wchJ2X0Ezp6P9Q5BAlgwylxamHCLjEPXlt/b4qQFW2lPX2ldn9cavTp3mRJO77l2jlnEOVgqxbiXdi8ddsOaPd9XA2fYzx0X5ZQ688KZNM=; 25:cJHjG4COWhnVJVJFXVuoa9wW5ewh4lkc3z518v2RL2c1Le/4xFfEadnRT17iPduSG19MGQQLaM6tPFGSf8v6jK/08BgpCzZ/BgUDWiI4LNzvajB0ENRlyLFKEM2Ra2ElOjeDPQKdWtr7hjjiYGsNHqLKMzTX/JwlEU4jYHjSYfYznr7YIkrpnfYM67YiYgiaLlfff6SclhP2/Mro53xjfZFBGz3PiIe4A7/mxZdLjoHtLbtHxTx1ejlOUumV+ExPAsWSIBqxIN3vvwgcj//Qrb8uveF5P3Wtz2KcMNNFc/R2IW6jSoAqzBu5NGSG0NjjTPmJex1IY6m8gnDzaE6nrlTB+JqIEqbAV5/P0l5mmgb2qK1h4jX3Gcf4YZDnVJ2D5FKKeY0pFuaponi2J5137Q== X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:MWHPR03MB2510; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(2401047)(13017025)(5005006)(8121501046)(13023025)(13018025)(13015025)(13024025)(10201501046)(3002001)(6055026); SRVR:MWHPR03MB2510; BCL:0; PCL:0; RULEID:(400006); SRVR:MWHPR03MB2510; X-Microsoft-Exchange-Diagnostics: 1; MWHPR03MB2510; 4:qnRtTwKPefWXe8NLbEvAAnDJpTokuN96K7CgWwcq/p6hGXdVCjMy2A9o6Rj3krS4Cr4t7Ih9zRnZsU5tBk6hUlqvb21oJPTV3ZlRBvqJbrJAsyM0TsJcH7fJyDF1YZ7Wc1C3jcPJURiUGRYV/bjesgu/0fXqhSxAghiYcs/PksXAzqHnQjVvOp9zCqlqb/QaJp2LW0gPq9sCoE4raURNXRgYC9lT/5nNpsyp+Ez2koSSgK8w2HGWC9D0pYlvhwK3ug7HqW2lNHhhhenHKrOEx1UhqJepC2y1ZU8MUT1xFc1XqNMyrw1VMAsnuB1IAd3GiZ9SrwIinda/4UsbKO13XlY255gN/CLYqihv1uAr6DMoWbshICtN7L+5NvFDtjVs4TOnlOPSlq+Tm6u7niX0AMBwpli6pREfz0UbqhTqbeJeiqYA8mXRxUlm2x2x4mi06dBIPicy9GgcTGLL/ClONGTT+foNJ3xZd9tbyR6mJC5BQFY6Xs30HgOKdU9v/iaLSYdPEqSIoHZZr/Dp8jdmSw== X-Forefront-PRVS: 000227DA0C X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; MWHPR03MB2510; 23:pp1HSPbc6DgdurJ+cTiKZ4PeTMpxnc4o1El+ODKid?= =?us-ascii?Q?bQKWpLEaOXpHICuKrvl3sRRtHUJVuNl3UCZOPR+TWbzW4nljo0yDB/WiXNm6?= =?us-ascii?Q?3txyeQSwRXIDX55D64UdqsT6OVJWgGj0u+vOcjHsvzRO7oDQ8xcuGwKo5foS?= =?us-ascii?Q?2c8fbxyGS23JcMweaaYD8oREyRRLqEcXztZtJoHzOIa5WphSjBchghHP511t?= =?us-ascii?Q?1LC0ddxINowhTAPMpXtnMZh0Pxc6hbKxR32zSXXcFRi3j708toFOwZy2d+PW?= =?us-ascii?Q?IBaO/bLbacar5QWC0GhS6PM2ReMiH+8x4kMKBbPatf9DhywXimYNRBTaKD6+?= =?us-ascii?Q?vT5NEfjieHmFZcdA08x150hFuNJ14MeZ7QeOTRsJYvNLINa0XXobKmXk19p4?= =?us-ascii?Q?zSqOiCyrQXW7KmVej1dIh+88O7BZbtK68ZmYxBm+f/HHE/OOHqTIQ7ge2JD1?= =?us-ascii?Q?CUmDBaTIjle1g8SL0C+uTJx4fJb4Nyh8/+dSYRcLsBxCQM8eybyc/lekOgaK?= =?us-ascii?Q?pZxj7/kS0QiI3COqryWvG9Th1mXXwEIQ0mU2EIRY8pMkb5VlzRC7J/VPWcZD?= =?us-ascii?Q?7mVxBNkeb9Cp8tDpIXzH5gpq+T7o9nSSq/G8yuyeG7T+okGWhtbjKIO1PH22?= =?us-ascii?Q?cR+/I56NZt8PBc+7B8db52/D0fyBJLZGQQyvmNq+GpTkAwOO572NwIr9ZSRW?= =?us-ascii?Q?KDMSprVjqmthqWs4kmfYXqfmpZ9JgOmHTZ2NSVKgLplBGac8Gu/F/shtyQHQ?= =?us-ascii?Q?TaI/OG/j/Vxyma6gxrZpLBsQenpSWnB/8hk8vOZvlDxnhMf55nimbrTLzGhU?= =?us-ascii?Q?7l9ONZcc4xiOdNj8xa7bdqOgo7je5rDOYelRYnWjoGovp8UH0GXxIzg5BxhX?= =?us-ascii?Q?u/cLUZJMx/3AhgM/2GB6HrBLnForuoQ2+V5iQPIkUT4bSujYicuCWigMuzIh?= =?us-ascii?Q?avD3cRwJZauxu8AOuI9XP9+LhbbjLvkpc0xgU2W7gKRF0500Xqr/fYYhGiEq?= =?us-ascii?Q?lqMZZM4WDjyHRWndQIf9z+ucYncjJ/Nn/sekoc8psqh5f7n13XKhYKfJHhDD?= =?us-ascii?Q?2ex4oR9DnMny5r9DXvUrbC8WrnatjirKlXZ6axjFCT93bZv6mGamXp0vTj7q?= =?us-ascii?Q?gp6xOpOAGImMPudIr5uqTUP58/WRjJnBlSGZS6OEn5UU6iwQ5HVNDwyHJx5j?= =?us-ascii?Q?7cRkNQC3EMJNBZzXlmYhz6i4oi43Ja2PjY5mT7zWznYVojEqrcqgiUuNA=3D?= =?us-ascii?Q?=3D?= X-Microsoft-Exchange-Diagnostics: 1; MWHPR03MB2510; 6:/BI0xHmTXOZNbzjnNhKWNDRijxJZCZA+gbo8nUY6CDRyeuBeeb5590skhA8pfHvvB9c0qiCP66MFZBUgipPRwjEV3TCancGbKyWt+G5PE+vg5Jv8oRjcqVz6GdezL2LlO/5H1+u9hRb0J/rVLG8HhUI0C1ATEPei+RKFhJr48tEfmqKEnPGIXhmD2zfozETDjQEHEZ7lL3Ax2F85bZl9SAlcBWrf1Ga93bwl92vcXr29jdiiymSeTsx6kmKuW/QA+LkKplzP+gL7ULGuLiZ4fxOfw3tLuU8YKW6xMe4h+lg=; 5:Ey1x7Y8DtQsTnN4w/L567fSXCq7Ijesl2EiDYqFBtXD04iBirarfkeThDTKD0AwhW6gFnAIW3e9kcrKan2LmkPhBQoEcoSQ99bpgXeuZVE7wy1+yJiw6ENPZbX5Sw4TXh+2vjGH3+W3JPYFmCnkv9gE3ql+ynL8ZwWbTBrVXG6E=; 24:HRq5izTT9smQCmm9i3QcY+Rl/OVzHOUNN4Xo2c0GmjCUuYh2WNNy+kr9x+rFmrqDVEPjyATp+7wyDxTfZLGHrYb48/DSdvGgGsLvTJZyzyo=; 7:QkuoTpPgjXfkG73b9i/3othHGrGKhk7PwNXzk7yLEDvpgHzwHGZ5lKxfBlgcptMJHPoKPAbn7h1mMN7Y3MPWlt6XCWQwM9jYFKOrcCMMkUB+cszCvYSEDx+xoi8CMYBRZb0FN0omekUmDBD/4vw/t0d1pN1KTVO0C8jUxzCwc6wIZs4D9gZvOmo3ssDw7QGy9i8+/VRQ8b7ZYLTAprXLrGODqv0TuMwEVLN5XBdR5quZGnPBz4oHwpxXcYJl06P0 SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Jul 2016 02:14:41.3427 (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: MWHPR03MB2510 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160712_191503_977737_8A8C27A1 X-CRM114-Status: GOOD ( 13.68 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: mark.rutland@arm.com, devicetree@vger.kernel.org, k.kozlowski@samsung.com, stephen.boyd@linaro.org, oscar@naiandei.net, arnd@arndb.de, pawel.moll@arm.com, linux-pm@vger.kernel.org, s.hauer@pengutronix.de, linux-usb@vger.kernel.org, mail@maciej.szmigiero.name, troy.kisky@boundarydevices.com, stillcompiling@gmail.com, Peter Chen , p.zabel@pengutronix.de, festevam@gmail.com, linux-arm-kernel@lists.infradead.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 Add binding doc for generic power sequence library. Signed-off-by: Peter Chen Acked-by: Philipp Zabel --- .../bindings/power/pwrseq/pwrseq-generic.txt | 53 ++++++++++++++++++++++ 1 file changed, 53 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..186c58c --- /dev/null +++ b/Documentation/devicetree/bindings/power/pwrseq/pwrseq-generic.txt @@ -0,0 +1,53 @@ +The generic power sequence library + +Some hard-wired USB/MMC devices need to do power sequence to let the +device work normally, the typical power sequence like: enable USB +PHY clock, toggle reset pin, etc. But current Linux USB driver +lacks of such code to do it, it may cause some hard-wired USB 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 USB +bus. + +The power sequence properties is under the device node. + +Required properties: +- power-sequence: this device needs to do power sequence before enumeration + +Optional properties: +- clocks: the input clock 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>; + hub: genesys@1 { + compatible = "usb5e3,608"; + reg = <1>; + + power-sequence; + 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>; + ethernet: asix@1 { + compatible = "usbb95,1708"; + reg = <1>; + + power-sequence; + clocks = <&clks IMX6SX_CLK_IPG>; + reset-gpios = <&gpio4 6 GPIO_ACTIVE_LOW>; /* ethernet_rst */ + reset-duration-us = <15>; + }; + }; +};