From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752901AbcHOJXN (ORCPT ); Mon, 15 Aug 2016 05:23:13 -0400 Received: from mail-co1nam03on0076.outbound.protection.outlook.com ([104.47.40.76]:5440 "EHLO NAM03-CO1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752746AbcHOJXI (ORCPT ); Mon, 15 Aug 2016 05:23:08 -0400 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; From: Peter Chen To: , , , , , , , , CC: , , , , , , , , , , , , , , , , , , Peter Chen 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 Content-Type: text/plain 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 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@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>; + }; + }; +}; -- 1.9.1