From patchwork Mon Feb 6 09:13:33 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 724400 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3vH1y335hVz9ryr for ; Mon, 6 Feb 2017 20:14:35 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751623AbdBFJO2 (ORCPT ); Mon, 6 Feb 2017 04:14:28 -0500 Received: from mail-sn1nam02on0059.outbound.protection.outlook.com ([104.47.36.59]:40784 "EHLO NAM02-SN1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751593AbdBFJOU (ORCPT ); Mon, 6 Feb 2017 04:14:20 -0500 Received: from BLUPR0301CA0036.namprd03.prod.outlook.com (10.162.113.174) by CY4PR03MB2950.namprd03.prod.outlook.com (10.175.116.140) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.888.16; Mon, 6 Feb 2017 09:14:13 +0000 Received: from BL2FFO11FD005.protection.gbl (2a01:111:f400:7c09::189) by BLUPR0301CA0036.outlook.office365.com (2a01:111:e400:5259::46) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.888.16 via Frontend Transport; Mon, 6 Feb 2017 09:14:13 +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 BL2FFO11FD005.mail.protection.outlook.com (10.173.161.1) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.888.7 via Frontend Transport; Mon, 6 Feb 2017 09:14:12 +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 v169Dq2M005959; Mon, 6 Feb 2017 02:14:04 -0700 From: Peter Chen To: , , , , , , , , CC: , , , , , , , , , , , , , , , , , , , , , , Peter Chen Subject: [PATCH v12 1/9] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Mon, 6 Feb 2017 17:13:33 +0800 Message-ID: <1486372421-29073-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1486372421-29073-1-git-send-email-peter.chen@nxp.com> References: <1486372421-29073-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131308460532430255; (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)(336005)(39380400002)(39860400002)(39840400002)(39850400002)(39400400002)(39450400003)(39410400002)(2980300002)(1110001)(1109001)(339900001)(199003)(189002)(54906002)(68736007)(7406005)(7416002)(47776003)(2201001)(50226002)(575784001)(86362001)(50466002)(76176999)(81156014)(81166006)(50986999)(8656002)(8676002)(33646002)(5001770100001)(97736004)(8936002)(106466001)(189998001)(105606002)(48376002)(305945005)(356003)(36756003)(92566002)(4326007)(6666003)(104016004)(626004)(2906002)(5003940100001)(38730400001)(5660300001)(2171002)(53936002)(39060400001)(2950100002)(77096006)(85426001)(41533002); DIR:OUT; SFP:1101; SCL:1; SRVR:CY4PR03MB2950; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD005; 1:1Zqq4TWkClkgA3kCE6CRt5GGstGJc087055OSfe+mq+JOAqOfgQM4k6MHz7VnswtJWfxkFY7/uzck6XZ/Ra+iD741LQfPu0CDV3f3VfW/cr9hmeWqIwRmSN8m4ceRZ4eg6kDma695m4l56mvD0/C419R9WRsC/wjegLm5ugPWHv2GcG/xmwDi4Cjny+sfp71rgg6cLhzDW8paHk2Ocga3ZFQMJB2U5OcjtcC6lQoRtDr20RWZw9hMIHYBbSArjib3TfN0Dkzdu7IC8SGVmqVwwbxOnD4dPVyVoFYt28afljhvAIbQ2eADC1Cx/2x2sa7o3tw1Tcg/vWAt4ULUQx3lqMNsgMgFjFD62dcepp/HiF69Uub8QEbqPDShLJyG1FlIy/SqaSxcnlipqTL0zIdcl3G5ECDB7Wywb++jOotnp9CGV5u0UgyM9q0n0eec2zgHZ+dus4eyIg9vMpdN166JtblR2gSGAkX1r/068o6g6AQ5//i1S/ri3CRSDW2nYvf5HtwQOq+3SlokIgm9huq2jcDnFy9cvSkynnCGgMEBRRWOdyMZEEg4nzJ7AO5c8wUf7cQ6sSgwmTjQgGo6mMvZ2IigaZZWpUHVn5eldTF3CHqg11K4C8rU+3P5av3r2xuSgrgIVpikqj0KnbAmxDSQI33v0EHuPK9pnf81T6ztxFni6+eqF3YQoE2KMI/A39Hh9YQUVgL4K/ECn7YAHeRnKSujPW9X49dlw0sTqik5ObFNhY5DtTNMmmzZrcEANSprq6D1CbAC5weYbVOl7pimw== MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: c4ad3bf8-fdca-4859-944e-08d44e70847e X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:CY4PR03MB2950; X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2950; 3:1yb/b6G4TlSM/UPIdItjaW5mIAVgzknPqFhOg8mX3L/UpV6WnGsSbVQhowMR7pzBTKsd+ekOVGl3rYed5ZexOilckpCdgzBWF+OJXj68PRrkA0YyhPmXCpXuJZC7Chn3le1gU9IfePWAxdkHas4xRaMMGEX+0rK7r8QapY1xCOKY9kILtG3Si95I8MZPsaQJAfc+kxkDm1qSIHY45zhVXbLNZDvIlmnMQ0o9+ShDgBJFXKso+xaO55yn0lQHd+Yq1At+ASWnTYoaf2aXLKbcRwMUjh/t53CFnvAF8JBzvemQImqq2RpVRIq8bZV5DioWnjg7psnxlYSV+bagE7DDTKqkCAftTcOepZrFL02Fmw8ualbjIxd2ptmiDh3ZEw6c; 25:fRDlwdqEDFWgN0EWSxbIotjIC0qbuynxToG6tu/H+lgKplvNq74l2RY9JGR2TkvrcUGdThOMfHGdYOczxHcNFoIkH80n9L2AL8/wS0HkwT+GqCXTj0wf6ZD3cMIRyw6AMgrKU8J9AwfQxcMfO0hUBZGEfnsIrTP1WYrivSaVsKowpwbSmNG/DyzgaaOxB9sfmtE6dw5uwggrleL8LioMTbdSBczZqjBsuaKBOAjzFfLVaJo5NX9OJ86l2vvqJWlykajtsC6Yot0pRx9Cem5lyIXLnAXk+SUI7e4wR8W5iNnnoVKAoE+jwahQs924IQeeigweVzau0bkIc9jXV9MC5mLS8RIegTHMwVLR/X7wUxlaBACIWISDllR7Tp79CqVc67XvhZlSEB91cbXA9dg8axcwzybJ3sI9KLWZ+TqAWO6CT96i8UOh9NtFZre22l4q X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2950; 31:O61nbUfKGattu3DeHevV1S8h61n0Suoo2I/h14nqhHf8AyPzUUUN6X/1b4o+h4y7/nVMHQeoAFkyiC4PyYwjfC87eDfeLexGAXNOPnYseA86088GJ7//LZ6pCpT1lIq3QqjklEelciy9kKsSJD0GFX5DRoUTmJT8PUnx2Al+CMM3h8UzDazICgiMJMVU1lu21VHt4KC1oEKaBD0/0hs8kEOs26M5x840yYtVlY79MTUyfIfe+LwEXRV2k3QepAogwCMnnx783S0yPqnHx2mfDN35AfJBNgfYgfrhVjwD3NTDvjDC36LXEV+blPEQsDCU X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6095060)(601004)(2401047)(5005006)(13023025)(8121501046)(20170203043)(13018025)(13024025)(13017025)(13015025)(10201501046)(3002001)(6055026)(6096035)(20161123565025)(20161123556025)(20161123561025)(20161123563025)(20161123559025); SRVR:CY4PR03MB2950; BCL:0; PCL:0; RULEID:(400006); SRVR:CY4PR03MB2950; X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2950; 4:6dOZ2MwUkWBX6pGUVsmSOL6XVSPEtK7fQEh/VMdFswGi1MMJVpvFqJRobRT/bCq490ctuV89UkWiZdVuE/i+YRQXWs2Muxb0RgMTz2KRQuX76LaWyIN+CulOtR8pPxHlnxnW7z0/PIiwiTXLe8xffvixrJ9T7If2Hl4ZFTZ5+kVqeqVdnZVGGt5hBXBbvD4bqJRARJGjB63BroRBrQlajBuE4wNS6+/tAsvw8gugkmyyRQwT7u6eDrUom1LmnGZJILY56waDlx4dFQPrSKigt80ozKhlFI2Ukny7HhkQ1ysVZeNyUfcFuGGbMJWdx7lDsYJSgB6N9H0O3G0kLnlfVhUqGGOZ5xx61bUmek2Qcyq9lTrkm4OqeSrt6sakUpThhlmOg1b7aG6BsxdrLcR6k1f8gWVxvx7+wfI/T/5xx50bsHnpNBgJfh0i/ODdhUxPtDu/9BzN78/wdre/jnmw6QJucKwZEzgI8tC80DukstWk30+A4erR3NUeyequEmcs6qlNerp9g2J43dZidtFwRg2Cj3gExm26A19joEK7g2qnjV0UCGjW7rOMSGiAT4MDrin0xYzS4UdUjssmbPbUDt3mvenevN56aEElrQcGS1u4QF4Je4BflLUerPKyeJRwfQJOvBi4CbJr/TQjpXPgy5zDB+tVjnU6LY9IXXasmMjb6MRz4bSo3H2k2JVD/dThiECknUHRPQ+J15+/B5zUooM/IkYB1V+9DhrvWY9iO234jgV7dndgyMteMAYcut1v X-Forefront-PRVS: 0210479ED8 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY4PR03MB2950; 23:hXx/SXBMt97y8OTRbi8RSjTxfvfOAOrsxk/XClKp+?= =?us-ascii?Q?kZGeJYnVt0KhsieJj0JxK5mDygsreSHnR4VRcKNAsL9W15hk2Y7R7JOvhQUH?= =?us-ascii?Q?RZi//mELzt2XOV02FweE9ecHcw3tY/+ir5rWU+ltn2kx2AO9DUiQwOXz3Za2?= =?us-ascii?Q?9mwUqBQazpOCMkJ8ZcoH7hC4E1qhgXXQjMyyvLW8lIM1GxXdNvSIrCb74Mi6?= =?us-ascii?Q?gCHo56PkBO7iqa2lmbmD1KCJBXRgBxPJTAIUkgL2y8w08q0MF7M0W+oaNneh?= =?us-ascii?Q?M3yrtFmyibOjOKpMFzFH1Gs0yI62khzRvPGuMQb2T1u2vUWTGhRh6miNrR8B?= =?us-ascii?Q?L8YhIxoSolCRp6jALfh7anwonxSQRH+8fHc4uYlNyXtcOBLf3rLZAoTXjJVq?= =?us-ascii?Q?S0oUluPmQ8hOOHHTSIY1FPyRA6XtwEMZkn+ww2H35hgIfMdLCvZUu4WoDCQg?= =?us-ascii?Q?Og/XwAVEPBVv9aDXwIgE9XxmhJnsCnOaLFFW3UuclzLP3ibXU9Z7xhmwXczw?= =?us-ascii?Q?rzaHJTmTxyn6XXWE0K+Tx4IF1iBtICjvHp6iUOMq3o/Mx8mpQv5JM5GyKh9P?= =?us-ascii?Q?A16bRDBTkuTj2cYYkCHQUif+IkhGNwolu2n1vAiSfQ1GrclYewvpVVWRZzXq?= =?us-ascii?Q?GjEDcLhueraqcLZtHzmtBKHMMTBG8/NrF2ht6Lt3ZZ94OpTiwk1uwxHz6hnp?= =?us-ascii?Q?Q9m5S+AUNMMHwAGSA/yof+2o2SbfCU5oPiwIihi6t4SjswYGukpHR6T0kNXW?= =?us-ascii?Q?oCMsirzd4SGxcPHYPtVyGZNCY7cVmHjR/00rpblN9dKeQafl2zdBHlDL6BRX?= =?us-ascii?Q?2hBsnACGfrmOVp4UTT6kj0FjzUX7hNHIUHSGbFXhdyCyrTwm+Yry9iOcObN/?= =?us-ascii?Q?aXFmYWSfnxVoazUXB1PwCltMZvR4AY/7tnbQQfPdfZQo4Eg6cq1FHXVqPMpx?= =?us-ascii?Q?C2MflSl0KZkdbIlKBMkt8rAKjbg5kmtbyCOo+zDydDR7p5GN7wbwSmM7RGWR?= =?us-ascii?Q?SO1nUqSwE9DcC6PyvERXseQ0aKx4KxW+eFsw6S+jThKbwPmGdNKEC8DdI/gg?= =?us-ascii?Q?kLFod55BRqdqsnfBlWI+HQl606pYENnVI53DcTHS7Gl6MKACOWmUiqzRmFa6?= =?us-ascii?Q?WPS/ikQhQJfx90hlKD7XE/0QHkHBMDoGQepl2a/yWyKpYD1dvEvlm4WU/JL3?= =?us-ascii?Q?Hw2jXWyBQzboSR4Y7kt5B27AvVoDEgv6zF4VUxSQFSjhpRafe1G8nSENiZ2w?= =?us-ascii?Q?Qc1PPa29viK6xTIbYqO06oeSHMrCw81u4Ww3EZCjFseFqDotuv0PTSJzts+T?= =?us-ascii?Q?nzhcAW4LeOg0D3limFl+b22HUNUINOg9PB38hYmmD0XUhg9IrqLdjJ8k+fxt?= =?us-ascii?Q?lNQMFOIHvrF4hHSzT3cLtCBsdEFVa9+i4N0Tm43DJir/8HWApOdbtZKC5XJD?= =?us-ascii?Q?T+Vag1n9Q=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2950; 6:Q1E99H05zR66brxp3dEgDYyqbcQoPiCrqCVcCfnaPJ60wDi2WJKyOpE4S8rTtIz8Ogp/klrjSIpWiaBy+D0e0WA33/jaGd9RDDGfosX8SRL4b2eLmfxgD7nkutSUWyVCK2DL0kopGXvsBfM9f4AipGv9PR3e5mkjr8Rf7n33ERJYOeoQWDeoYxMWGbcRzmxKZ4gEjBVpkLHOM2sLqIbO+5PG1XFbi8Wc6bxm+MOZ30qFBXosguLS5zjQXcMphyuviqDoy5fHqBLFt2r5++ebeQ7R/Xsf2r1Aa68bzgh2JWSUpZLmtQuTvkgkWo2R2J1EGVzmnURUmne8fD6MW6aY/VcFHf07lQmxcScO9RkQ4UuaCrstTg/KH0mUU8U2WhFNO51oZmwnhR17NgbnMKRLGQ==; 5:EHw3x36TPAky6FYodPdONsvkOQvjFx0JLNZQMg11imWdivUtHocv0Stc8KSs2UefTLW+wYsUTSXT+GRXEAoOOLpiNFRK6pBHBrZVLpLjqRTlex5eVj1DeXR0bdxnOkerxC4aqxJPv8q5LvnQCTaIGpjrMTcA1rcnQwhD7jPj9RhOba5+e5S5tUlB8H1Xx7tA; 24:zN4XnxlQlpQMjb+CfrGoYWv9uHT0a5ZyyQsT3zcYn23y4CfPpGxmKUJa+KdUAhPAXlm7OsN4XE/iLYZa0+PwOOSnDiuKmZvHCtotDE5dH+Q= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2950; 7:T3iJBO/RTNt5TwG3c9ExirjFeZyD+I1Fide6xbSWLRb/F7GL2cRcPKvpukNRZoD+fO05EgpZOfzWxMWWknC1QjX28Z4dnFA7xq8S5PI7bCKpBJJCNvoGgUYiwTydoxGoqJQ3grWRXB4ymsLE1aGyDYPwS09niLzShLbr/L+AnspBRbRzXW8+YjcUtgMDwdSg4jSKXSH65PQ/ae8/Ykgl6vInnVHO33DiC77omiQkW1nzbTCEb8xaYSMROw95rYz3ZMTmkpd+ZmphXdGVurEOrBzJCKCovXNh07+c7/CvWfpr/Cywl4sZIer7HPM12Mw6LSSCRdcgc4eac0HjMf32gff/qpwLoEYI3Bx4cQl8XZQvsoVBNTiaVTR8QkJDeTEL5lQOkbiUdjzwsMztP02eVip/+bqzlU5VnhbZLFvO8QaZJpieJcoIOSFJhX5JgK/n+I3jODJmVPtvceKACH8kLnSHCu/VoCVxNboKOW5G80oIOJb7FrVSiL5uj9EOE09geJ8NLaXBVTR5s2OKwC9INw== X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Feb 2017 09:14:12.9310 (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: CY4PR03MB2950 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org 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>; + }; + }; +};