From patchwork Fri Oct 14 02:59:48 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 9376043 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 9CB8F60839 for ; Fri, 14 Oct 2016 03:02:42 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 896D72A193 for ; Fri, 14 Oct 2016 03:02:42 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 7AC782A24B; Fri, 14 Oct 2016 03:02:42 +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=ham 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 C952F2A193 for ; Fri, 14 Oct 2016 03:02:41 +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 1busk0-00023J-P0; Fri, 14 Oct 2016 03:01:00 +0000 Received: from mail-bn3nam01on0064.outbound.protection.outlook.com ([104.47.33.64] helo=NAM01-BN3-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.85_2 #1 (Red Hat Linux)) id 1busjo-0001lj-O1 for linux-arm-kernel@lists.infradead.org; Fri, 14 Oct 2016 03:00:50 +0000 Received: from BN3PR0301CA0068.namprd03.prod.outlook.com (10.160.152.164) by BL2PR03MB324.namprd03.prod.outlook.com (10.141.68.27) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.659.11; Fri, 14 Oct 2016 03:00:26 +0000 Received: from BN1BFFO11FD050.protection.gbl (2a01:111:f400:7c10::1:139) by BN3PR0301CA0068.outlook.office365.com (2a01:111:e400:401e::36) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.669.12 via Frontend Transport; Fri, 14 Oct 2016 03:00:26 +0000 Authentication-Results: spf=fail (sender IP is 192.88.168.50) 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.168.50 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.168.50; helo=tx30smr01.am.freescale.net; Received: from tx30smr01.am.freescale.net (192.88.168.50) by BN1BFFO11FD050.mail.protection.outlook.com (10.58.145.5) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.629.5 via Frontend Transport; Fri, 14 Oct 2016 03:00:26 +0000 Received: from b29397-desktop.ap.freescale.net (b29397-desktop.ap.freescale.net [10.192.242.114]) by tx30smr01.am.freescale.net (8.14.3/8.14.0) with ESMTP id u9E3085P011345; Thu, 13 Oct 2016 20:00:18 -0700 From: Peter Chen To: , , , , , , , Subject: [PATCH v8 1/8] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Fri, 14 Oct 2016 10:59:48 +0800 Message-ID: <1476413995-20361-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1476413995-20361-1-git-send-email-peter.chen@nxp.com> References: <1476413995-20361-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131208876265968225; (91ab9b29-cfa4-454e-5278-08d120cd25b8); () X-Forefront-Antispam-Report: CIP:192.88.168.50; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(7916002)(2980300002)(1110001)(1109001)(339900001)(189002)(199003)(81156014)(8676002)(5660300001)(189998001)(229853001)(81166006)(77096005)(106466001)(104016004)(7416002)(33646002)(626004)(105606002)(76176999)(50986999)(586003)(11100500001)(2171001)(4326007)(8666005)(87936001)(47776003)(356003)(5001770100001)(8936002)(50466002)(6666003)(68736007)(97736004)(48376002)(50226002)(19580395003)(85426001)(86362001)(2950100002)(305945005)(2201001)(36756003)(92566002)(7846002)(2906002)(575784001)(19580405001)(5003940100001)(41533002)(7059030); DIR:OUT; SFP:1101; SCL:1; SRVR:BL2PR03MB324; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11FD050; 1:MixR+9Z2E5ylL7VqAfaFLssKwifC/1jti74Yx/hEGsakdfRCbaQqhxk0py2bMvmRlpbfGBPVQnB6xKOrnl0uzltDiSHJFCRHJs5ta2Jb2DJ264iOXUuYFn/z1egbLdNMOOJYO36Zsnhqr3GN1ugUFf3iyWupAu/kkLf3GDCy3U00tM+hlas4aBjdY4B0A+DgQ238hjBSZDXREy7Ne1FXv/GnyHtJLuP/auhGN1ied2rEd23Pi1q9mqvU+W2O5Zj6N+wqt4MeMycyyhl7gBC1G48A3f7JW8W1CsHw6DYVFv41tX2k/XhRK26bhIwTH7ojZUdGuJEJVAOr27xk5I2a2ojGgydxVOHNIkUr+rD0Qc+Ls1//36iTEwAIIENUFFnag6x5iqKwcaCAjZp4W6fPMeH616mNxLOmLjozgq9Cvpw03aKsd7nQjVA9VbmOHgU0HICxymRfRXacBfn3n3EDNGHRZpvOVzNg4dqbog9CMbgb0nZepAJIVs4Rdp/z0IW9GYSHrhov853vevlll4iRbeUHEN9vJmaDJLZbEvooXcmYibj8m2rPr9uSCKuA/xgbra5GiVKs/c9k2akESNwUilxWG3f1Mwi/LhaFGWTU1t91qviKd5FO12RttmxgZCnHw8jfhX9mO+Ml6LdOaEShrcwDb0w8EGl3jIHmTcnn+Dkue7mj1UOTDdHrMGqYXSpsplxSQh82PJrnmS2Hh8wdHpEKwS2d3vhJ0F4CbzN4bSU3jchhGeYdAMzdLTK88ZaS MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: b99706ea-dbd9-45c1-1261-08d3f3de3fad X-Microsoft-Exchange-Diagnostics: 1; BL2PR03MB324; 2:qLrXNU1ibpBoNLQtI6KjxmEgZIY0hIMFitkzrUiLNW0zD2lJ0XljwS/09oMGxuuih21RwIoaJFVRY1YkQr+587hLCG4nexIT0YOW+1wN9/4E3ZCT3YlVrqEHZsWDGjaJ2AD4oyWukX7FYIwsS7h1VzMmJZMu3GzeGBYALFgh8Ui0/UIb8rGGPK9rHL6Z081Rqd9sjIX9RgkkyCs/nTIaEQ==; 3:d6jARzkgsPvYu148NHDu+jYiUyBSxriWSSOcEyJQOmACLVpC0LfUyF3DJ+x9LyT7WS+v8sG7RqlvQO5GEmJDt3EZF8sTDjwFRo4AdWOA7/oa7B867+qA/Y9fB4cI3RxxvMp/0z9ujJFgoXKkGJ22JnBZttkR/i/yOWkCtml9XMXru3qNi7avL5AQTsVNlxAvFT6LjcBVEZ21iV8+B1r6hYFUXGcGlzumVPuOgoumkgmDKD6zpE1l/Ma+2RYVDFUy; 25:LtAD5sArIrGBsH/5eYQY6mF1bPI289TtAXjRTXlgLoJzG9q49FbkPB+NB/2FCR5F7wYm6ygzjp5C+t82tTXvV5gi7vLVtbV3oFcpc5YYLILbFpXUnKFPT/ChSZIHPcQjZJi07CeFU9Vp+PV8k2/fYXZy1LBIjoCB6prYC3JZq+m6cRSVL4nqsOM4nx7GNS+X6SJDdM05ulcF4qm414gH/9uQcYOQWkfzRsN7J7JC/nKBxohDqQR+P9BdMaXF883ZKpz0pe8/vB+xJ4UDbQn2FljpPO97Sz9ImCxN9uodXmaEhzDPlz2uLvMpbZb0tZEY4XhZLSlCBSffGkJLLYVid3S9QPsQpDpDWkAiYAg44xEc5jCa+iKA3ML43lqEFOikPx+bimc3V7DIg7KiXhDwaD8OhuB4zzEPPbfokoHaE73x3GCa3JWX6oBJKK9dOyn/enIDjQt+os5SbPMBGchG5w== X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BL2PR03MB324; X-Microsoft-Exchange-Diagnostics: 1; BL2PR03MB324; 31:8qtNw8KWlE7GD/mf2UsplJ+Kj6RYjX0xoMayxr8ICq/S2PSV4/vL6+f735UqXND+HtKGauoQg1/pWrK7nGEisaVDUZ8mFph0wkZWrf3f17XHfi/8J3Afw2JOywMykWRsQNw5+DydWd8wqOVcP3W4t682j/E12w6LGSwoCzjAtvXoNB4hmWXkOx/iRoZODvQUnJEOWjtddWeLBLTk9sAamhbzkOMnuJRr4h/8a3gDK6lj8hNZTRlc12r54SQU6N0/ulHEQ+Y+rM7J8653Of5I+eWvknwvOaose/XckGiDmFU=; 4:ORDgXvhYIDosR/y0Mtfd7eMKWN4xG4OfjH6amTwsEDMENk0cix6Q01YKNQsaQk3kD6hgfkxdtv9aXhko/0X1h5ERHx+ZNYUbIyVbd9qH5mUOHr68/VB+QoZmKMiHG4e+CN6Up/YAlMZVtB8NKUrYz8uO8niNfgwSfspqFkDML1TBGPC76g4yCDS1O02A1hS88F1GemXRNxAzOnj3tC6mNvdXKiWQWowGPxnma7yvq6un+huJtB7BNX6qiAvtAzchQToGtzhv1koNd7pyTnrXMNfFgGPUZqkLG7d6e4yH8mKKUqcr6v6biooKegIM+SZsDgDNn4tuOdJWjgTjUzFF6kh2gmrUCUzAJOnvuCdOmVG0KyN7+4KI+IA9P1CYTcCb7MGmSe/FUxUk8Ru/P0cQDWN9AnesK44PjVR7BGvLFQq8J7gW8JB6cct2p+hsfUSwrVBBM6ft8RscJu1JRY0Ht5RwYBURXdR0uYhVioQgk7t5M505FRHZcS8MIEAbeGGjONByS0qr1xSGV9XGmY3thEinUtXxnKqz1GahEdiZfEY= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040176)(601004)(2401047)(8121501046)(13015025)(13024025)(13017025)(13023025)(13018025)(5005006)(3002001)(10201501046)(6055026); SRVR:BL2PR03MB324; BCL:0; PCL:0; RULEID:(400006); SRVR:BL2PR03MB324; X-Forefront-PRVS: 0095BCF226 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BL2PR03MB324; 23:M4GyplvTLc+xSQRqb6IP5mGt/OS1SM8JaELfBhtXyf?= =?us-ascii?Q?XrxW+pwDLV0QakXUdZF8BzQqlDeQjxy1evLBUeNf5+Dn+aSVjicr6ZbY9iT+?= =?us-ascii?Q?izTsMOR4NLT0iUZkunfNqrDpPXOKL/79SB6hf8s/WLqO9Z+oF9JkSRbQtPOJ?= =?us-ascii?Q?dte4c+slVDhi32Sfk4Eb2TYbhF2sNEZf1WJz7G7xriuGCw/k6VqbrILVHhgN?= =?us-ascii?Q?OupgiffVjhM3x0SgI+DxRVvwu2PZHDApdwfRbM4rJnSlLayI6gTIwkLX6oeF?= =?us-ascii?Q?ZN2+qWbT8nwVz+jphsoZZMY41VtdMBMQwHm+mCYyCWDEa7HpDpr6hPfFuSR2?= =?us-ascii?Q?jcJjG2MFTnGnTenIgDDLrGKvSYdDnr23Ry2S0GCMyOS7i4Cp4eZZw/7RAM03?= =?us-ascii?Q?1TFCy86XatOB47sz6VO0kn6pRe/99IILvpYnD9rgS/xhBaG/2VkFzxBj4x70?= =?us-ascii?Q?+3VSe5MBDXjpqs6K751QfjGwx0oteDYOUOmgxioaZsPaiOnmpKti0IdK3+6z?= =?us-ascii?Q?gt/YhLUm2UzYjQxX2t/juH6Ehf1JSVegulFPGRgJ6TyNRnBqyvbMSJX4Z5lJ?= =?us-ascii?Q?5pJQFs0Km7OSYo8JjURb0bYr83HzCnwgwLhBNa/Tui6VVpSxcYOZ42VKlxFb?= =?us-ascii?Q?lfhLsHrd+jWUoeuav/sGztKSb3IMNFhMT1S8rUr0nrUc4bzF1uXqghnZik1+?= =?us-ascii?Q?utgtY5fBO1k/tU+ppbvhhlgrEWBlWV27i+GMrHedy/spcOvdQX0UQW4A8Q44?= =?us-ascii?Q?atxdm4ruBcP9uVrI2NeEKoOaX92cXDm0fOXgvOgqZDb+aqzZsllsYtNbMWsg?= =?us-ascii?Q?/VG/YeZNLPNyBAucQZwgazjJiJnReyFmQVfapaGDy0i8bKES2lu5nb0T4N+c?= =?us-ascii?Q?cojrPjxrUmQkPEkp7n59uloQt7UEzzOeNGw5/gbeLlx5qu1Zk2DqsrJpm2Zt?= =?us-ascii?Q?fswGQ00+PkRFpZNZ/8BddrqSNrAfkfqe5GLXr4TEop9AN9gieODEFhbGkqxf?= =?us-ascii?Q?2KDgPNJxx1RHNDXwVeLCGQtUWLv2LRyOyFbOq+5455G3ZpYR/Bhjaazmg+OH?= =?us-ascii?Q?YG8FSMtu1yQa/3qE91ympeQLwD6IhbnuIm847W9VE+jAiFIFY0yi1wzNB7hO?= =?us-ascii?Q?KWjHWy/cgeLE9Yg+AhAWyn0Q9PlTPdCYbz0Y1DTEfE0A4DkM/VHZBqD1Hhgx?= =?us-ascii?Q?eofumONmBig7FbDaTVdFOu5vPi72lQCpnGqNFkafaiecj7TdbV/VM+Q4lG4X?= =?us-ascii?Q?pPmC9+9/MYrXeZRhOgzsqZsUk3xZNYTqCk8uK1xg9OMLoAw5A/h7XtfuBy/w?= =?us-ascii?Q?=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; BL2PR03MB324; 6:cPYa1UKMruvot7avIoJJGMIRUg3tgpPy1YZf11GdxIDZ8rEJIO+5M/Fa4paZgACbPSG8fU5Pm1KVolOdoB2iok0/Bo1FqLRhtlQm8tphH/e6wE90yZozZie/sFwso9kkxX1xCDwzoKuvp15Nljr+FVMNHRXw1K+XJY+nilkS3iZ3yBoUl9xEfrJtZy3YHEhFxFj7aReGqarbjODGCjLvphAZctCP7TRVWKEwlj32osM3PXOr0MHjkwpGRREFS4Q6Fakf8xbcSaznUO8PZKXHtESynqj/75+gD4JXmD5fQI0=; 5:qPMcy1YGpjwCGiAyAIrXxmxmF16NzGzFZ+3bnDXcBavoy7HuCI4h1CG1H/FV3UXxu80w6TWT7DnLSSd01E1IajLYKc+h6NwyNz1CfJDUmCPQYuYzRhHYIHRJhAEuljnFjoSPuqyubpl/AY3nPcwQs70bnLBoKXZ0whMZngSOUL0t4e/7IF7kcYRuQawpfHAc; 24:8H9OD60q8pI2dXVvZbzPws5riHF4u3oSolQyCDa2EvFdWSMrMsvVXOVkY/DnlqQ3YKk2TQnY799zOPfHK2/KbRxy0s6FWKG8tMumrq37HP8=; 7:i2BAGTNX2Hl3txrnZYUfDD4F5bwPW/sFB+CXJLLVec6vEkvilhY+5v2q/XwjqF+/PNEm72S7vo0o0wDIxUUMBKkluPbYbxiudPp0wr+BvTQqIzgS2UbKi8GEl9Ey0w281kkQyuRxsNXke2ZyEuG8Nk1TYgQwVqvyl1UzFygQr7D7RoXU758/HwxPIAkzkfv0FRMmgGnQyHQxzMzgCRuissx0HkvebDs8auu/KD8AsySVczaJAf4FpRYWwH3lcjLYAOJJezGnduXI6+ylhi4VlZS/RYgHcjEeBhVUDainAUiab7Ug15LBRSAF8gU/qgC3xeUniYzjqXUM7Jvv3+hB3n0iGfxnbFO/3OGjZ5J1r2E= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Oct 2016 03:00:26.1912 (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.168.50]; Helo=[tx30smr01.am.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL2PR03MB324 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20161013_200049_047307_E6FF076A X-CRM114-Status: GOOD ( 17.05 ) 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, mail@maciej.szmigiero.name, stephen.boyd@linaro.org, oscar@naiandei.net, heiko@sntech.de, pawel.moll@arm.com, linux-pm@vger.kernel.org, Peter Chen , s.hauer@pengutronix.de, linux-usb@vger.kernel.org, linux-kernel@vger.kernel.org, troy.kisky@boundarydevices.com, vaibhav.hiremath@linaro.org, stillcompiling@gmail.com, arnd@arndb.de, p.zabel@pengutronix.de, festevam@gmail.com, mka@chromium.org, 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 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>; + }; + }; +};