From patchwork Tue Nov 8 02:51:05 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 9416379 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 4FEB66048F for ; Tue, 8 Nov 2016 03:07:00 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 35B2428B58 for ; Tue, 8 Nov 2016 03:07:00 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 299AB28BC9; Tue, 8 Nov 2016 03:07:00 +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 A73E128B58 for ; Tue, 8 Nov 2016 03:06:59 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752820AbcKHDGg (ORCPT ); Mon, 7 Nov 2016 22:06:36 -0500 Received: from mail-sn1nam02on0067.outbound.protection.outlook.com ([104.47.36.67]:58224 "EHLO NAM02-SN1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752273AbcKHDGe (ORCPT ); Mon, 7 Nov 2016 22:06:34 -0500 X-Greylist: delayed 871 seconds by postgrey-1.27 at vger.kernel.org; Mon, 07 Nov 2016 22:06:33 EST Received: from BN6PR03CA0061.namprd03.prod.outlook.com (10.173.137.23) by CY4PR03MB2886.namprd03.prod.outlook.com (10.175.116.12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.693.12; Tue, 8 Nov 2016 02:51:27 +0000 Received: from BL2FFO11FD041.protection.gbl (2a01:111:f400:7c09::142) by BN6PR03CA0061.outlook.office365.com (2603:10b6:404:4c::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.679.12 via Frontend Transport; Tue, 8 Nov 2016 02:51:27 +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 BL2FFO11FD041.mail.protection.outlook.com (10.173.161.137) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.707.3 via Frontend Transport; Tue, 8 Nov 2016 02:51:26 +0000 X-IncomingTopHeaderMarker: OriginalChecksum:; UpperCasedChecksum:; SizeAsReceived:1478; Count:10 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 uA82p7JO005180; Mon, 7 Nov 2016 19:51:18 -0700 From: Peter Chen To: , , , , , , , , CC: , , , , , , , , , , , , , , , , , , , , Peter Chen Subject: [PATCH v9 1/8] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Tue, 8 Nov 2016 10:51:05 +0800 Message-ID: <1478573472-29516-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1478573472-29516-1-git-send-email-peter.chen@nxp.com> References: <1478573472-29516-1-git-send-email-peter.chen@nxp.com> X-IncomingHeaderCount: 10 X-EOPAttributedMessage: 0 X-Matching-Connectors: 131230470873743809; (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)(50226002)(68736007)(33646002)(92566002)(5003940100001)(2171001)(81156014)(81166006)(87936001)(50466002)(48376002)(85426001)(77096005)(356003)(8676002)(6666003)(2201001)(2950100002)(586003)(189998001)(104016004)(5001770100001)(97736004)(36756003)(2906002)(8666005)(626004)(7846002)(7416002)(7406005)(47776003)(4326007)(76176999)(5660300001)(86362001)(575784001)(106466001)(105606002)(229853001)(305945005)(8936002)(50986999)(7059030)(41533002); DIR:OUT; SFP:1101; SCL:1; SRVR:CY4PR03MB2886; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD041; 1:LyNfr2wPN9S3xyRoDJTf1OCN9pyCzkOPLY0U87Soz5q/3fbWVP3iDB2/+yJSI/PzhYKZhHoON3g9EWdUu/5d4HvcZKkeJjMUOFl4dTBJXkdykQibT/wpW0cV5WwwYs1Y/APsYhn10HTk6pzLgL3fwO2vwyk8XDpRVCTLHxNoBsoMmy4sR5tGtUcd5D7/Odhy4PZFI2tIYlUOVLffSjDGR6zXbCCU2IvdznLxyvQb3pauXr6vlWF1Y8Nm7xVpcMbFTIgWKSQ2FIzHUHUv14CRxuRBmqVZD8vjBeGryEJCucI4uQX/RfnxmcICtxoKmeyCeRNYAPrHenAY8ARAEssQFKtn5w1gwjUdtmC64ffIV8UAdQbGlrRhSTp6OxkfhWP05ObhEWRycpOPLaZnf/QNO5wG58imBXozs+gd3lOyp5zJky9MHk9lUGevXF8sp3ronzGGZLb4Pgf8VIITaTafqpQtErRPnAJNcFDYzzioIzhx3ABkcqme9GNvF+WdQlB58P7eboRd+Os6nxGHJUFZSbSBkvBI9JjP+dInOsdpleXqKmzjN8RE0KJFND0Lk0gzPjOFEz32JRN9/j9Q918y8gIKq8SNxs7dcJoSgpOU2+Xz2NT2144T0N3F3IkGLODg9ZCoay9KOhUbHQvkiVC40oRrdqb9QU4MmPhJuph+X66MOV4lBokHrIa1Mi3tHi40edm0+trvTYrzIfSb1IKYiidG+eSeMom+s8pGjZiyMtEjU39pAp30FKoMBIKBXVYC MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 3858708a-c09f-4367-01c1-08d40782229a X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2886; 2:KZlwOfEYAZ51A9SPeeecvfmUnFJKaEzNSvEqMpj8G8y6YzhR70uJmEiE2BXi/k8Xv3zXqJicYXE7W4i3UycQeYZAL8LWOz00kfhOjTQ+syfVJL3EfY91XD3W5X+HiYHHnN0t7ZAgQNp0Za4EnWcAB8GfThdPfixgSLsEhuV0SW9bRNNMfIG8uwee3I32QrDgPH9HRjQbrAoQeYf6b/jItw==; 3:NXml8Yuvf6LKuRVCaPyA/yye08osMUJbr9N24hCGCskJpNM6fELm0NpNE45bxThHEBNVs33nIs3qSkyFciWnH25q10fGhrGKP70wAvmmFXjfpSy2f2RpUvpjqSVgNIAKKKKu+t144TNxCfIl6niz+p1xjNQ0lkaZPWLNABifOtEiN8VxBStqPos2gKNpMbHTmRbEcP7BoRW/JCr+JRcwV97DSJOLFGTH/jB5hTCXmUv3fvWXluoc7jH3M64PoWnB X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:CY4PR03MB2886; X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2886; 25:KpgtR2N9q/ECyw85PpJhPBsmRpUF6ZkshmwVuv5rPdtw2Nk5YZzeF3vZ+M3Snbx4JW5hcpCrHxNCiZI+kDlP0yaYtk0U4OjSyUvg17CzZeP/bJE5ldXhJTspHqk4MG5CTWyta5TotBk1a2TLpcckYIKxK9n+1HRXJznw54M5xSyGW+RlioQ674zssYsKnw5NwtI94BFrpoHuluBiehGlTQ1yJPSWR9rSObSIz3qhOCjpp8lg/GgJjfSj8EdzGpunXC9MSuCXvmV2fT4aM7AUrYsWw6q1tgzfdIBBgsHg7dx7lneV8a6zLdZBbhY+yCPCH2S0U23YKRDT+PV4+jJ0WSJ+R19wvW8ZX89w/tfv1Q6rETG+d35zaxrY0LIJdef8qVfIeA8w+CRQ/VxsBtJO6nuInXP908H9fuMHddutd8Vp7gZJ70ZFnGMXQhVagyDmEV79v9JvBFaZDcynePpJ2P7NeFiEIaOl2vhYMd0cdnnQC3swLyhNmNw4QukHQl+H1G7hJThxh+tbEZWtwSH5viXgGoXfmuj00Te4RlESnT2PzFc2sozyNMN8FyQumF9axfUGn9n7cTn9Mq1DEsW6cbnCoo+lpSLCF2KYobQ9LATBNgrRoIIU7ZkptfEwO1MRKcnryY12FX6gWTFD+BrooMt32KQHPHy3s37vL4/dGfMBb9p4gSwN9da9lhX7AFYR5msWZq996ZHdbOsaCDRFH3/XwKy2BBymvLQjiN8eFd/cjhtfM88ukFodBi1DMmsJjAe5ZaGBAtbK6G2e0G1YMyODyVbwVuzEMm5EvG6Bv58= X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2886; 31:rwZi04l80142eNlQ2fpRquz5ROnEbQtHxWyXq4qxYAeoWenGjaiKU0F05qKYLuUsX0XoEg4aMqGbP9g8XlHItp/hOJMoyKld+sbZZoE0p5DdT8xFLyyqYSlMV73aXlIn/4toqS1gMrH2kE0S9dgY3ApnA/3oFXYhTDxj5k5VtXJuPtCOEqVmd75VWuT+L4K50lnzrgB2iQgTAkqDn9s5c8KGRrm/MMOAfbSvDaQUHIEV/x9JQIUsJNMxhgyHiKNPw27aiFM/5hCNp4oLtvRi7OPhrzawkAelV7pn72QxIpg=; 4:V2A+Z0IH/drTl04PRU9yJzALnCdZAuNkycFTX06d4wmHT/aN/yCc7UjfB1BJ69/GMKeyi7sDy3UJDuhECO1G8vXXE9u6GdoFEBfmBnonbsoTNCmCH4UJCZrtiV6t2UfWzXSYNxHV2nWoyZaCY8cPvPIFJWa5GBK04IFRsSQnam82qoE+A/JkxO1TqTjdG9tqGzehMRs71l9X7OQ643H0mz6NbQaET1QTJCu4/8AYxd5LlcsoctPrd2Rorsd+58F5DcN7pa2EWqEnV6L/FA7c9u9RkPcI7Tfv2nwTdTBJ9g59lRWYgWwQ5ihByN/cKQxjaf647yJJuZ0F5/AGXifc4Hbv4qX52cf5rgB9mTjIpuQmh9fSty4aRy7I7m0FOSO61HQGuiicgUlQuMV4GHH5aak/dII0ov9h1OyAD1FZJQ8JvKVS4KhSlqlmdpfl2W4F9KhW5j1QinZ6n0a4mJIm4yGk3cXU+EC8jOHc98hpfTV7MSBg04C1i0bcQjOxdxddGIwxYIdl6DPdXIMoBAz5sFwx7ST4torzi50GKxlrSF0= 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)(13018025)(13017025)(13024025)(13023025)(5005006)(10201501046)(3002001)(6055026); SRVR:CY4PR03MB2886; BCL:0; PCL:0; RULEID:(400006); SRVR:CY4PR03MB2886; X-Forefront-PRVS: 01208B1E18 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY4PR03MB2886; 23:bUSsrfPquE2jz4474mXJj6H56aRheDIOzk6NBKRcD?= =?us-ascii?Q?ONEc+KH+mh9JGlCPVywOfSQcV8AFUXOJrUg3RjqAgkmRf602a/ec0bZiLgIP?= =?us-ascii?Q?bbFR65cjd/ZokXs+xwgcUeNXlf0HdYWvVFYNb1B8u+YI01t4VajN0CCKJAoK?= =?us-ascii?Q?yJ8lBk1iZPrW5+FQH6/lYRKhzfFTDnRlRnQyyVpvK2B7dEcMstbOsYB5fgf3?= =?us-ascii?Q?QdssDgMKrPuB8YSAx4NBPPiwefxoGn88OPDVc55PSp20xKUJkCETW43guwsC?= =?us-ascii?Q?mWQtXAgf6MvmSmyGdAOnBxo+05WLea1Tocsy2P6rEn1bojpvPvUn9YbqL5sU?= =?us-ascii?Q?uC1IzfoFbxE2bB/t/C4e3Ns3VfpNjj2mry98Aqvr+ylFxYM3gXMox/mloe+c?= =?us-ascii?Q?OBCz0e+0EMI/WCYjQFIRwiIp+6lNQk4vnGNK+xDA9qJJcnJC+dj0CkIqt92u?= =?us-ascii?Q?EdV/eD7XgXH+6shyy3VnwARQkltqnSEMd79KRvGZLLqaxe3ppvRzbROtH8ch?= =?us-ascii?Q?MtFHfY0FGJPTEP12ecW/nNcH7YIG2poPt84tnAm/s1dBv3kjkjoOua0Hm/JH?= =?us-ascii?Q?vIaa81Y17PBFINqUK179afh4Wg4iiQY0akcwF9QWcRqUJaaRXhOSFOsUw4M0?= =?us-ascii?Q?fbSFpHnipPwjADBbcpzVF71jp6ZrYD0TxNU30KdAJPeBIGuDH2+hdTOIUwZZ?= =?us-ascii?Q?6pe+cEa4MI4lY/o6iU+9PtaTpdZMjwpR69RDZT2r+dn3sw/ApoKrwW0h143m?= =?us-ascii?Q?4M2xOdwJyIQxv7wwMNwEMr8zW2Lh0kedNhQ5StdNF6Qm2cLMknH4svHMYtzb?= =?us-ascii?Q?2s933U6hPl41jyux2M/eO+ytV3nS6yzuEjd6fb3Lr7cCLh3H1snkgk/7HlgY?= =?us-ascii?Q?G9jQQnAf3ktME9bHOg1bOurVQ7aayQLp5hFIPsw6sNBtrZsR92twu7r9aoNP?= =?us-ascii?Q?jrxzgvlFzDoBvMBVA77Kl48XmklfV1EhyN+pQGpq9PqQiYe692oZp4QWv+h1?= =?us-ascii?Q?fG3JSqeyzABAaOOogMb9WFgI+F4eACmCIZCdeRoHcnFLZ1ZtJLCP/N1x0Zq4?= =?us-ascii?Q?AmdRnI0sC8hTpcUOWlB3q+CCZVF9plYbewyq0+lE+YqOZXJSxTh0It+SeHSO?= =?us-ascii?Q?9DLBgl/YiVp/coxSqttOwoSYl9idOEMLQmqZWxLEcocKTfzX/AWdigyfHRpe?= =?us-ascii?Q?UufX1PSe5Nf0EQ1pk/zLJOuD/12uE9T1W3RJNCE5dpRZ0sANxaRu6kQNw=3D?= =?us-ascii?Q?=3D?= X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2886; 6:JtPpDVLUgAN6rh4UPimXSvjCOP5Sm66rp7+1HsJ94wULfoj0UEXDwSHi8JWk3teWaF4fSzp4DYHM0gjxQ+Z923f48vbXa6EL1KcOZ4V0mxGGYvbU8mRhKu9+x2Yj5ucVclbNcP0N8RxwC9NSJPJ7LZflpZEdAuuuE9Jtl94gFD3NNJqWWZmEAXkyqfqIF2EMzuM48hILJZJ7LWKHLU97nz5uN7B8Edt57kr1HKnARqnInyLG6AqBpsam53c90V74hYs+Rovh+Gcf+vbX0CZCLiL2HxKF9R4vSnsmLSOapaI=; 5:NoYavbSSs0T9v0rfb2ttpRZzZziPbKmw5KezxA+rAMI9u3XFSyJ0Ul26pf+TLOHnNvuwhlTsGkRB7V0C/lavihjyH6bLWINUpu+o6fwtREIV9gi+uPoOKzk5IiK9CQINaBySN1K6bft3EzjqyBvdOmPWt0QS589By1MxwTFO8F+XfDJ905ZW2wcTlmvbos5e; 24:9/zVA7smEQW/8l1H11Tvqd7gEsgOQs+w3InC5uOrhUtp5UwlmZP6j+OBf95hIsrmo8pagS5FdsErSGGL9FHg0wDXyo7vRpVw3tvhgIfxKGU= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2886; 7:jQYwNP6XG0xT8pdG9Z2pX7AuVffLOKY8lo5a3RGHjtpvsFDnzFOmFrCb9KLZnstfRYpi01OBqc+6AOdDfC1HAksS27jgVWU6+rb+fBW3qbC7sMJW0Qw4e51lv5RUf3S508qNuVA3lhCWHlt9aqVvKCYv9HseTUmYbrEOj45B54bUwMU9LV2Uie7le2sejhUh+xAnajbRwXjD4x7fvUAVueBP+RvoAUD+8fqLEOBe9Pj4YOKrNR6rXmazZVwrziVi5OqWnHApww43O/ucMjgqHxodNB8LMELOD1hXekQBscN4c84dcT+YOnvLAh2n+6rKu1slAyyezQRWS+NdLqe7VN8xJ7jKGyvMuN+tVZ6n9Qw= X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Nov 2016 02:51:26.9375 (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: CY4PR03MB2886 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>; + }; + }; +};