From patchwork Tue Sep 20 03:36:40 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 9340977 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 73A41601C2 for ; Tue, 20 Sep 2016 03:39:44 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 62C2C29B58 for ; Tue, 20 Sep 2016 03:39:44 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 568F729BEA; Tue, 20 Sep 2016 03:39:44 +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 EEE4A29B58 for ; Tue, 20 Sep 2016 03:39:43 +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 1bmBsw-0006yh-8P; Tue, 20 Sep 2016 03:38:18 +0000 Received: from mail-co1nam03on0082.outbound.protection.outlook.com ([104.47.40.82] helo=NAM03-CO1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.85_2 #1 (Red Hat Linux)) id 1bmBs9-0006dw-Mu for linux-arm-kernel@lists.infradead.org; Tue, 20 Sep 2016 03:37:31 +0000 Received: from BN3PR0301CA0068.namprd03.prod.outlook.com (10.160.152.164) by BLUPR0301MB2004.namprd03.prod.outlook.com (10.164.22.18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.629.8; Tue, 20 Sep 2016 03:37:07 +0000 Received: from BN1BFFO11FD038.protection.gbl (2a01:111:f400:7c10::1:138) 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.629.8 via Frontend Transport; Tue, 20 Sep 2016 03:37:07 +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 BN1BFFO11FD038.mail.protection.outlook.com (10.58.144.101) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.629.5 via Frontend Transport; Tue, 20 Sep 2016 03:37:06 +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 u8K3anti006721; Mon, 19 Sep 2016 20:36:59 -0700 From: Peter Chen To: , , , , , , , , Subject: [PATCH v7 1/8] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Tue, 20 Sep 2016 11:36:40 +0800 Message-ID: <1474342607-27512-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1474342607-27512-1-git-send-email-peter.chen@nxp.com> References: <1474342607-27512-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131188162271543363; (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)(1109001)(1110001)(339900001)(199003)(189002)(81166006)(8666005)(81156014)(92566002)(36756003)(104016004)(8936002)(50226002)(8676002)(19580395003)(19580405001)(86362001)(575784001)(97736004)(356003)(2201001)(5003940100001)(7846002)(33646002)(305945005)(77096005)(85426001)(2906002)(105606002)(50466002)(2950100001)(68736007)(5660300001)(106466001)(87936001)(2171001)(47776003)(4326007)(48376002)(50986999)(76176999)(7416002)(229853001)(586003)(626004)(5001770100001)(11100500001)(189998001)(41533002)(7059030)(2101003); DIR:OUT; SFP:1101; SCL:1; SRVR:BLUPR0301MB2004; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11FD038; 1:Lj3Ht6nz/ggJbEmQONnFuuCKaoNN7QH8xSTzYhL96knBZskZXj3z092bL8C+2gT+N3efWveYrlz243COOCaXp4TKuZRxJXdZG3BpFmv/l49O0+3xoeysOVsceNwl2u/oEwcWMGrheETnK9sQ5eQj5EsZ/lKbq4Uu8Fwc5HA88HwOsMgL6akR15tHiS2zsF1q0vZ7Cg7gYkg0GCUhUtMOPHPiMHyZ6osqvd8XxOZfJD6HAAemYBfJf1WrunM3jHA1cE/N4uE2UXQNToanqggyCF/KJLaWGS4FpPw0KQb+nmYyh/bdI5XrOj5VxTacwSabEBDLl9L8oA4W4ImLb0OfBAU7fjsQ1p+gCHiW+23BNSPdSzlAFd21qqqEERAmbtYTtZw5W48Z38BsRHFPtCqMn4F7A1dbarAA7cY6PmuKi9hc8cgaNXVSlOVdtLlHmscPl6LEzDEmzNiz271HxAXZ0Z0KPCi5rEcdoip9xo1gKa1ACKgHsCTRak1HvCGf2EvJClTNmbpbNeC1na8y0jHR2B87LuvicXM8Jio8wi5arSzl0Z3yBfk6iXMOBdY9exCIkw0omXHbG8PgBHeYne0RRf3r43biBSq5G5MfbQeOV9aIHnyz233hx5sYYPK5jIS6nn+6wNlc8+Da92SzknmDY3K+fazgdiIK/Ew59baUQsbOfoZVpDd1ClwJx3Ygkm0/l2RuS42ANg16ED7A8iXikk5aZ+3y3raURjdbVYpmijUAGsx7CfIvPMW3NItCmQoj MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: e1a26417-bf4c-4b5e-1ee2-08d3e1076563 X-Microsoft-Exchange-Diagnostics: 1; BLUPR0301MB2004; 2:5YdPGhtUSDzoXk1ZVWS2iXJQu2vNrCfc7WqS7eC2mnm5+ccKA4ZCg3xSoNzKzHegiw9ssIj3bgvdwntUKieetdMjwF+wDIuJTNhkxDAehXpi/NGe5AqkjDYaOpb8b3ne++EfcS6+DQvFuWg4BaF54xvhXYHE3JohX7xvXzaxp0d8yLPKX5s/PB3PkcRXvm08; 3:g+VP9RgXWylbrVIxVgUYQ4Z3gd3MwHNJ2Vqf4HExZl1b3rQPw49OWDkM6wIhk2cLPFZiTbs3x1EZA5Rw2tZCZmeluZtYlNX/etsrX3d2VPO2nqDODQDY1jNGfw5LXvFJrJLWK8LVOnlLpG8Ul7jTegTQnrhYEdaMEVin1euT6ttfpY8+4jCPlzAiymv33j1aepEYZQCerXrG2td306i30MceuwxU1oQHvfIyL6WRgJE= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BLUPR0301MB2004; X-Microsoft-Exchange-Diagnostics: 1; BLUPR0301MB2004; 25:ovaEcYwOrWwvybPcLGTMHL19vecfkpMu/Yw1aEizlx0wbcaW+17MSjkra0iKETa8ZdzHe79JIOLbNJVqKzEo9lNSxdf5RYsMowLENW1f5vjHUc8sUCZeV4MbCfJeoIuAFAH5wmOMd9f9AXJiPChS7vzVlr4CmOFG6YCeEu4BNgRyOJ9vwYaJLca0ugvA42iT9yKHi2cPCc25EaiiTQLH9Zq+vZr3EDPOAxcbwJ3/xQF6judHOVc7c9BsOdQFE21Bs9OtEE/KJBYntI2osVvzPNHTawkwYIsRTnSjfZU61t+9xzLWG8i84ahhI3elxSRgLGF29bW1+hHJ06AktffnjaCq4PuZqRg8n40exvwprR5Mty8xJ4Sm+u5DmY9WiJVGjFyxBprX49DTrSk4MoZYeVPNt9NW+0vWy0efcUvhlvlOQ+qu/D+Hdb2WROhCMm554She2zNCi5f6sbUVIxRvoSqOOrwHULUWo6DY/a+P+kahcYjuXHWYUKjk36X39c80OnnFCub4opTp40sC7z9sKe4wgpcMeAvb9KM/JkfaP1PeJ2ajD7qUOKtwbyU30WZTfhm2YRlcyoGiY3rSm3fPdbPHcA9yyN3XO8px5inVEMP81JHwnWZ6hR+o0W2HdDnzG7O+mpWvd8Y7ZdQdi4Nqxk/AeTHdh11zVzr4GAFDb/Y5Jy4xhUSjfG5YHfJM7bUeJDGtOregnXasYdA4H4D3jCsK1r3Jb+GkhiPNJ17I+Sa4Uludv70HQmN/GFZRMo5Z X-Microsoft-Exchange-Diagnostics: 1; BLUPR0301MB2004; 31:xQJZW5RSJNdfZsf5BbXMz3GfqgsXk2eNbjPwWkSWgAHxuyp5uUW6N8l9aYJpjEZT6JP2scx2gWcoLnsqQYEetfoLLgF9PGGSyc9vqXM7EUTOt4EGMlGEsL/7lJyf0McRjW5/VT/llLD2bSkhBF6D4DbJ//L7FiBEe5QqAlcJ2VzG8SZ4TXUBwEGTjzWLBiR+wN74cWGppv+q8+PIK/STRCfcDANjs69uvH7f51gjhJ0=; 4:g4ciapVviJeaQh96SNQBr9M1EOXbeKZO1VnnOi+OSg/bvQ4yMnuM+OEXCc50i4vot5Ary5aIBFHv31n8J8h5PpME7Y5xYRyhrQYSznjmUDoKKvewl99DklZEf/E+lFkSDevLvnNwW2PXg06Q7zxACdBxiMRwwJQb8fUg7+K/Q4WKUG4DdbCK/ICD8p0XFUavReL5kO6qW7Jm5bAbZuDANDtZ3WQ56gIkcyY/izvy9jwDohCUEFvnFIYP0ySArvMWL6zIR86BoMCyosWBUHtBOI8bSviw1sbbOifXdukzDu4MSNlTlprVazXu7nn05TOIGAHlEsvVanM35qW20PnKU5XyG5SANIKcZKGzfPP80Ad/oU4xzD+3LcAlbWbp7QOBpMHzheUzIUjA0OmnOkyYb4rw8xzaAkcwgsHrhX8aJaYmc2HtcCRyRenhhRDD2MkBHtJncsxxIvFRxao09BSAJ4D4iE2MF5LMWSJDVAu/9xwpHzRqLNF39jlzKzuuZ73yf3Sx0nVeW8KyLxVQNXdc2Q== 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)(5005006)(13018025)(13015025)(13017025)(13024025)(13023025)(10201501046)(3002001)(6055026); SRVR:BLUPR0301MB2004; BCL:0; PCL:0; RULEID:(400006); SRVR:BLUPR0301MB2004; X-Forefront-PRVS: 0071BFA85B X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BLUPR0301MB2004; 23:1IROt0YJQCKW6gb6rCXe+DkCOpmtdyzZu9uW0NP?= =?us-ascii?Q?FELBuaV5WbgnKuSdo2f9q5KyUzoQZialm63yHdC6C+p7RNAjl8QtlZIDqR/B?= =?us-ascii?Q?OnmM8+z+XG0KA9n/oYX7oB0nvFebU4css1+TTDB7SSaz3whTQUgr/+wWfNUn?= =?us-ascii?Q?hI4nRxN0wIvitmeQDk6tjnvcTM6D0+iVaMz7Lz7+EXgKxbcUwtvzPGQ+BPqs?= =?us-ascii?Q?zk2NyY/NZX9BW1GfHNzTqiBOLMW8Nm3AscNgiI/8gK9wDAGOZI+vgH6wQD15?= =?us-ascii?Q?1BSAwIdb7VS91VtV64JqBJpt9i+j0PDMd7t+rZROM7SkA9ccSLuPTk4XmSfS?= =?us-ascii?Q?iU4ZpsxaXPc2afpHLLIfJ2MJZsd7at6BzGaGvyQqqkKh4sV2OllEY2fqvWb+?= =?us-ascii?Q?HLRvhKATVjMI9O4zFSgxK0DTluZpw/OxtOVwS40fyQIfBk2zfpSp+QOBgCCx?= =?us-ascii?Q?jiH68dsPeZE3TjUTeHtGkvNE+F6y6wE7fP5f9vOG3SA1NhVftld95fLGXMzK?= =?us-ascii?Q?HvR3sS+KLJOrdnpSoFFmyUHneZ9gjAjn4OeDd17MP1BGNzUVoxqLZGJWvArH?= =?us-ascii?Q?UVBMO7Ox2vUK0JgRE8f/R3WTT5v1JCSNAIg2uy179fkV8YltyfltEYb+ijF6?= =?us-ascii?Q?9YObxHvfx06BpRJjgMk/3jn1Qr8jzZ6s7FVQnNc+pi91rOCHYTz0XlvUTypw?= =?us-ascii?Q?bi3pwDEf1w+qqXOgSV2oKiTnhhoGHc6zCkcVCMxqet2ogA/TRgDJ1k6Wstr0?= =?us-ascii?Q?NtdmAaQZ11Th6ddY4Ts96PNgMvSXwQv20iFPeTU842lj1FaluUG2QyvVS1FH?= =?us-ascii?Q?WI02Oqayx+VVIs0Ay8387sJ8QhLwF+putcr7zzBzDkypdmHDL1s6qQ9KXKja?= =?us-ascii?Q?wOmihOhvysEQAEIKkehQhAY6sHv+fr/R0YLAnkjIUlds79a7HCxTE61iZrkN?= =?us-ascii?Q?iKnY3MPthyk5Xt/PTw3QB8zoIWjan5Yhpm6ArOTsh3IPitMjK8zNjRgiYV+G?= =?us-ascii?Q?R6Xhwf66uvTHcDDBdd/cNTLBIDREgyJxHePg4FJpsjq/DnvBr3hitL8I0kjV?= =?us-ascii?Q?KDViViyHjHE7bUx7OYHxH3/5uQLZpR/SMzWDK5ghK+Rslg6xS3RjqQPeqvdf?= =?us-ascii?Q?1TRNkqMWpUdor7jIva+420JE6VU1i8fuK5F52S/6dBmTsY9gXleVnyhYIRQG?= =?us-ascii?Q?nuvltyNMs2EUvjhntb7TjksNVNEqk7xG0DhqfgDEBoR9f/9I2c9wEgMqO5ZS?= =?us-ascii?Q?f0vqhbRxEILWLavvgGbQyL4fF8ZNJ7kaQJQiHX3OZB3BZC+JvgP+d+aXlpFX?= =?us-ascii?Q?G3w=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; BLUPR0301MB2004; 6:m8V1VwQCHEH0Dzby0eA9NyKBEbbzQYoFemet9uFeNBmJOu427MXl+Gr90P43smr68Ja+kR5yZ75fBde4Y+zI/LCDJAxQQqiF5GaEn0uRjRikHklmIpXPAnJaHtP5EMTv0u5Zg7G9bWCv52a0hnVSq1E/eqIQWFxdm7pgFUtdrqWMnmNgkawgKqJlsx0qR38QbWQ1UNOsXxgr6iIT9C7LivoG8lrIsg/YsywswzRXPpNHJipXKSjiLNvwfrhWQyIxZy9RVJrWTAHVeWAYhgB7nZEpnZH+4qXlzZX8c/Iz5Jw=; 5:HwQPev2p+9Yn87GPuAC93S8zI5Zd6sKKr8ER0tRkVp5EqsJ2Y9H3G60qJK9lOHwgZ2MODHhJljR8vEfu8UzltCYiW47VUsnySewwmOHaXPrAYT0Cvy9u5ntH5LeiXLt+SNQEWva3MbvqyKUxd2qApQcysKkXUpw3dzkhZLazHUU=; 24:Dc672cALhJV6Pottz/pnLYq9JL2ltNe3aF5pgxpsR4espzn7Iw6XmcdK3sXQRUFad5dsXEnLQA7Uke1+bkPwaHaT//JJoo8tRaylAj6UaWY=; 7:hWDREIjFVzjV4rEmARGwgKaJLwNRLNIpkHDT5myfl4XweTAkVFch5D9aayz5JD0BDfAY/vgBIu2tKv6C1oPzi+LFWzho5O0Ry5ph5YYSbo/7KWv5p7s5sZyUJ1EMUYfSvodU9ehkd8gWNmQXK6I++KxP3qeZCccsisiEJqrdy8BTuNqD+MQo+9a0zYAB4kJie4sV1KWdk2s+VFcYqeQyGR6YIFEnKEIwL9TZ0OspIX6blbHCf3WXomee98h3bpJdlmN4VjsRVxIbdndthhEyH+1C0R39rDUvLK/pNJi2ZvQ/2cvvm9vZQ14wxRokr6g9 SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Sep 2016 03:37:06.7175 (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: BLUPR0301MB2004 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160919_203730_114806_3A122496 X-CRM114-Status: GOOD ( 16.56 ) 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, linux-kernel@vger.kernel.org, s.hauer@pengutronix.de, linux-usb@vger.kernel.org, mail@maciej.szmigiero.name, troy.kisky@boundarydevices.com, vaibhav.hiremath@linaro.org, stillcompiling@gmail.com, Peter Chen , 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>; + }; + }; +};