From patchwork Mon Aug 15 09:13:11 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 9280643 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 200C0607FD for ; Mon, 15 Aug 2016 09:25:04 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 0C66328BF0 for ; Mon, 15 Aug 2016 09:25:04 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id F106228BF9; Mon, 15 Aug 2016 09:25:03 +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 719AE28BF0 for ; Mon, 15 Aug 2016 09:25:03 +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 1bZE7T-0004x6-J1; Mon, 15 Aug 2016 09:23:43 +0000 Received: from mail-co1nam03on0047.outbound.protection.outlook.com ([104.47.40.47] helo=NAM03-CO1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.85_2 #1 (Red Hat Linux)) id 1bZE78-0004eI-Q9 for linux-arm-kernel@lists.infradead.org; Mon, 15 Aug 2016 09:23:24 +0000 Received: from BN3PR0301CA0035.namprd03.prod.outlook.com (10.160.180.173) by BN6PR03MB2708.namprd03.prod.outlook.com (10.173.144.15) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA_P384) id 15.1.549.15; Mon, 15 Aug 2016 09:22:59 +0000 Received: from BL2FFO11FD012.protection.gbl (2a01:111:f400:7c09::120) by BN3PR0301CA0035.outlook.office365.com (2a01:111:e400:4000::45) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA_P384) id 15.1.557.21 via Frontend Transport; Mon, 15 Aug 2016 09:22:59 +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 BL2FFO11FD012.mail.protection.outlook.com (10.173.161.18) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.567.7 via Frontend Transport; Mon, 15 Aug 2016 09:23:00 +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 u7F9Mh8b020596; Mon, 15 Aug 2016 02:22:52 -0700 From: Peter Chen To: , , , , , , , , Subject: [PATCH v6 1/8] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Mon, 15 Aug 2016 17:13:11 +0800 Message-ID: <1471252398-957-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1471252398-957-1-git-send-email-peter.chen@nxp.com> References: <1471252398-957-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131157265804698656; (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)(1109001)(1110001)(339900001)(189002)(199003)(106466001)(33646002)(189998001)(85426001)(2950100001)(8936002)(47776003)(8676002)(626004)(5003940100001)(2201001)(97736004)(5001770100001)(4326007)(68736007)(356003)(104016004)(19580405001)(50466002)(92566002)(229853001)(48376002)(36756003)(105606002)(575784001)(11100500001)(77096005)(86362001)(2906002)(50986999)(7846002)(305945005)(7416002)(8666005)(2171001)(81166006)(81156014)(50226002)(19580395003)(87936001)(69596002)(76176999)(586003)(41533002)(7059030)(2101003); DIR:OUT; SFP:1101; SCL:1; SRVR:BN6PR03MB2708; H:az84smr01.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD012; 1:QMk39WV/JzL0/1lICAcxVJvGvR+gljnQZOwUFPI8TUzheqW0L4S7a3sqYiVoQdj4Sv5nHKflSERIFkQJExdZxtPZmnXgmkhcE1bQ21LJeUn6nL2K3WSvPsu8ULNBZhdpVUzc4/TSfqCNpw9wBX3YgHq4xv5IdW8+OXWOq5vkAbc4buBtjKlw2UrNVdfxhISf1uLoIAF121DkpVG1Nv5/hCfx7S4IjBPpprUIu8f1/uF4iYKYC1Y0bguga6W8XExn8pE3fckVt4G1HkEJLP9+MUpmrQ1vevc/RHKU3TzRpbdsykFzfD4ZeSJJcJpJJIJAuGHZldVr+0lKLuf70iy/Z7hFKiwGBoiDr++cq8OeUInMi1Yz7f99BLfsL96YybPiAqtLtgrELOZa9BuXkC4ljkeesKOxvkxGHbFuql9gkqQf0lmT5V3C855nZwWRey0o6GXowOHisvUdA7mVIQ3rhvyocQVRW0N0hBg+SGQmmZ6DGwNKY2CoYlG6rhXUmCNUdDfYxdy2q4oZXKHeZq5uokBO+jFnlYaJknZ87Em/o+S5tuEt+gZEFcBmF7wKArO9RzNqMFVL4ZyI3GMcrj3ZN5sYldeo+J4zpyy+A9bQDH6puTT63yNGbvC4Ar14x8/tr1vRV9mBFoLrunjEjHVx7AEByiZoItHNOvehHJwQe08gnfrJxO70NI3COITZNuv/fFqFxH1dBhFTKBg5/YIckgTfOoG8k3wNwI3FqYKn7Q4T8NDuRYWmj7kgAYMyb+VG MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 1aab8fc0-94a8-492c-2420-08d3c4edc077 X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2708; 2:KA6TmFNq7LwhD6Bmnjb+W5gi/Cn98YlGoerWgt83+O4rV/MIAXbwyocVfl95HkhR+hyh6z7gaXklcoEA12UvteCg/GHtXSOTlrQ6P7EINlD3JR6HHPl0SR3HNI718oxLweORhFvYhGGDF456qI9rGkB6kV+50xqSh8TwuXwBil1uy+15ZrAMAc+AsMZfvX3z; 3:V3wkVjeiky7NuRazDxeRHMWDVAt9MlexjlVT78PR+4XbVq2Ogf/HuKy16Fkyn4hx9wYFb7bi9AygrbzCqnPyBsyhfcX/Dc+2Y1g08IbgmqeEc3GcmuVCxgOWM86rXojjMbTuWnAwSnljcMD0CkVUNpf8o7eBh6cumKg+pbNE3mOywxun7FBAqlRAy+zFqaKPNtL6GS4nZAP6k3H6hWAOlUBiCuWC/Tz5YwHFTspeJHs=; 25:Pa5SW96GnVD3+MCfpx7UxiChceVvhoPwghylqOAfI2OQdUawXnPkzXfSz+tb/8fNEI3yLBRCF3CCBAPWfB8wQxOMhpV185NRX1AWz204TK8d18jKoNscIF63W2CYXFUrS5XbbMhAGrlZjbnUmIuchmV/5/eOKTIzZ367TrVUEqWOQcpFp2etaSZDr7VptBYU11V9gNRa9IcbkoQTUTlzHiJcGuFRs/IIfI0g1nXMmExQDiXZRPeCVe9V11wOYQ+umhsTy8VFJdzCEvHCg+8Ql8T7Spr61sL0tlz80TmHksWcU2R92lu16AzRMZEW/4IQW9eBhtFe+dWUKfiBZH3/MfDD387fr70gBX5NnSQYPVmAOTbTc3AxI/3zNIwOBvLHmzq9XY8TMHu7b2Z0SEV4lQ== X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BN6PR03MB2708; X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2708; 31:Y69iZ/3xgh7hxqIpqOEWhDPB025DQbOeM8V0Zp1Xm3KeA39oBmiU4E33JiHfwpTeO0XdlPjJHo21DsDjGeLhEku88XmLEUfsiei1m/l5rB1LSZL4wAaVOMyhFPxry86JG9rryeujKDLpFKJM15oexGaKweSbnA6gXFsE+vWrnlQk+YebvHF1ZJUtY56vc2xWVkM/7qUmKxUn/osYPoriJs75k5dXefc9QdGohXDduS0=; 4:EaehaAIGQfwwKp0l/SGzO4Zw/Y2FiuTbrKRdrNn9GCu4V1i68Ep0Y4h/cZgf/0fjSWi/vHbenTUnXiYSYURPa8IBNn7UDoTFVpsDhZJ0MwxpXo0oyXK6iY+gHttBFRmaNpsiGvMVfIjpCyA4Ct2s3OOnnIC4U5o9fuRDCr76JauuldM6Ykjbji5n1RnRyNG4vhdy6B4UjbWwElyK4FcVf4YhgEuAcDZYeBo/uBhO9zBdbsDXoUhjJNpKFeWIFaGipn+QENnbkGpCM01susK0WY7W3ORz+XS86WynG5ih6/SOH46etDSNYf8y8B+r7IsSh+0wF7Tb2lPY7Mja9QzDqksKrZL5sW7tZ+e8djRM8Awoylsy41K8j0sq96+oDN4Yr4qA2KITeVmL8eXl+UdXtrADTpAYzomne9LAeMy1NNS+kNvyDSX1ypwikBF/7IKzbXxIGteDroTSiC5d1ubLF5CN9bxbp9HoDD4AJ+SfbLKgFNEg/X7GVyb0CE714F3mQ2uY5OJlG7oZUFjznlyZQdsSA87JHP6AaXFXt44tUL4= 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)(5005006)(8121501046)(13024025)(13015025)(13017025)(13018025)(13023025)(3002001)(10201501046)(6055026); SRVR:BN6PR03MB2708; BCL:0; PCL:0; RULEID:(400006); SRVR:BN6PR03MB2708; X-Forefront-PRVS: 0035B15214 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN6PR03MB2708; 23:uC3KfjIcMKsARNYiOC/kW0EejjF5Hf5fBtwiSLzjD?= =?us-ascii?Q?MGqG/GQz7Jglq0zOWZpajdLXNKIMxarzmc/KhLoiGOplFiE4maGMP5eZYX+l?= =?us-ascii?Q?ooR05Lv0+mzNuN7lolrgS7Usw3S7dsULi6XyxA7S8jHJkEqQx4SNBKbkJgfz?= =?us-ascii?Q?qQK6HkaSPw9ACJFggZghkOa2hZuzAB32z8p53HnilD+8haHlyxhAph8ckYPl?= =?us-ascii?Q?GFX3BolPOz/M8aLyIAsE3wEOL0au7tSdXUI8L5RabTbetuXY9AXIYEe0Weo5?= =?us-ascii?Q?NXzAsUSOzkn3qsSRbli+RBIoH5EXIGfuezSDdKW+lbik/L3UhsG8WBH1WW31?= =?us-ascii?Q?uMdAjCYiGZqEd8+jxtJxu5+X72lAG0lmMEm34eDoQ50rRLqo5i+a4B3NgKas?= =?us-ascii?Q?po8zM3lmY6t7S9JZL3xL9twfd/7V35n8IOWi11kCYrc46Y173XzfnllRbgpQ?= =?us-ascii?Q?oZfh+cnUkRQCeP7cXZrTgSOcpxudRlNDxAiAgOEu602OcJZ8XZibmaffdoFm?= =?us-ascii?Q?UIWfCeVUnPrhCG/lVt9eqxl0k+7Kf589kTPmmbX8m4YZ+n9wBN3+UhPB/wxJ?= =?us-ascii?Q?ok8EMBNp4HCdwtRnc5EHfMKp1IFwevwl3WJAj+ux2Yc1gQvVqxFQnIaVQXSX?= =?us-ascii?Q?W7DBifqJkB28CdLsfZLaveYhd9MKiOsm114GhH7jMWMac/SQckOE869K9AHB?= =?us-ascii?Q?RHzQjX6r4djBgn/oWTZs3mOppgEo7duhajGaN7kelFFRCv5G9pkkYGT/AF/d?= =?us-ascii?Q?b+CEkTJ66/9Q7/VTMqIibBIrNLj3RPt/wsd91ImlmhqmjhO12P3olICHj6iQ?= =?us-ascii?Q?BnJExmGIJXBVm4voBt1M4c9IvwkdYo8EDIbbgRBr+DWN87IYY0k/bUcbMNan?= =?us-ascii?Q?woHwAvdT/2XciJVnKQpx3hz4VJefmT1TFT69P1lS09gyAfySUasIi86WQYJh?= =?us-ascii?Q?jty8LCFLjzLVNSKkL2hRJhFoP+gCp05G1MrT4+CcFDb+st3uztGiOnHEvbzG?= =?us-ascii?Q?zLwvZlZwcEZJknnuTDmAGzdPro9oOMZZjhtKxEeM/2Zy0Dagjmk84NPqsZN9?= =?us-ascii?Q?FIdZqIbYjc+Fq369n7aKk2+WlxYl3pHsdyvqh0y9/42CXJtwWAvwJ3p2816M?= =?us-ascii?Q?4bqtCNZXvYubzOcGoRPvUYdPT+wxDtd+DegFHdOyd9O2JMDUAyGCuXzE48GQ?= =?us-ascii?Q?d0xUOAuGxZ4LHxIzavjI5qDQgLUqpKgMaeN3DOMPTQcVKZ4TLqENkwh/ksB8?= =?us-ascii?Q?kSQv0WQdPHTHHkWEzNvuTVFivcGirm+xVpeh5XQLQib9mVCTVDQWJU0NYxwx?= =?us-ascii?B?UT09?= X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2708; 6:ku8M/1wWsNOJy1ZqTGxfsSEeKP9LM+A+nq2yNi0YhbKTeRBjT63AVVpHpvavJeAmidAKrPzMehp5XN6HT/JLQcYkTmb2LEPV99ss4ytMX//aLGTx2jThR5MY3sU1D9Gl+IKNdPAQmTSoahh2xwwp/x2U6ivXkf5fRK8DqVQoKXvLNmZf9jKxwTSg3+2RvR2x+PCR0z+0WOPxKZgbrz4pRLPV6C7KltmwUvU+MbC7NUFhvL29odL380ByrIm+wnb5lMtGxKj02vzYZeqf/VaIyhNO+fA+gZSwZ6HK5Biv0jE=; 5:VemiMwbBEi54RtxeYN+PpENzFjvZ+cFzRcfanQRT5TZpIBOQe4QtJGd+1ME930mm+YQRKeuZBjTrzpFRdIOq5vF2v2c1VGmmX9NxbAvPjmrDEztv20WJlsJlRIjPemiokC9ZsF+IfS0Z/EetRXiDgJo3k3ybgFN2C6B99p6bu/Q=; 24:19UL00FjwtyqYlRShst4j6nyS7pEV/lUtp3q8IRde9NUFVyzV67ZzBtw6qp0rEdDtCT/FaKU8JO5+Uru+rh7GY+NmW6q6vw4lYHomXdml+U=; 7:VDdJvybo3KJw9eAx0S1e5xK75ZVuALLU0F9Y5RM+N3I8q0OM5+d25bvK8ff2ldRs4aHqtenQR6x/sp5nRqigNNUdrj2NR/nq+uO4WkuSRCK1kq7tPeUyeLVoUUScKtD8BJYxyXrEkugFcrY+z/02qgImeykIZxXrOFvKUZ3hpj1fdz94w9tjNrSXj40aEhvPP66La8v+ujQFKz8SJa8nV3GPOcIjxhH7Oby3Af+iPyltNRutcMfhIR59EXNcJIko SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Aug 2016 09:23:00.1422 (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: BN6PR03MB2708 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160815_022323_069803_D23A6A15 X-CRM114-Status: GOOD ( 13.83 ) 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, 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>; + }; + }; +};