From patchwork Thu Jul 7 09:14:47 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 645815 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 3rlXbK2XfKz9sdn for ; Thu, 7 Jul 2016 19:37:33 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756353AbcGGJha (ORCPT ); Thu, 7 Jul 2016 05:37:30 -0400 Received: from mail-dm3nam03on0056.outbound.protection.outlook.com ([104.47.41.56]:24662 "EHLO NAM03-DM3-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1756126AbcGGJhM (ORCPT ); Thu, 7 Jul 2016 05:37:12 -0400 X-Greylist: delayed 855 seconds by postgrey-1.27 at vger.kernel.org; Thu, 07 Jul 2016 05:37:12 EDT Received: from BLUPR0301CA0003.namprd03.prod.outlook.com (10.162.113.141) by BLUPR0301MB2017.namprd03.prod.outlook.com (10.164.22.19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.528.16; Thu, 7 Jul 2016 09:22:29 +0000 Received: from BL2FFO11FD064.protection.gbl (2a01:111:f400:7c09::197) by BLUPR0301CA0003.outlook.office365.com (2a01:111:e400:5259::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.534.14 via Frontend Transport; Thu, 7 Jul 2016 09:22:29 +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 BL2FFO11FD064.mail.protection.outlook.com (10.173.161.160) with Microsoft SMTP Server (TLS) id 15.1.523.9 via Frontend Transport; Thu, 7 Jul 2016 09:22:25 +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 u679M9nT024626; Thu, 7 Jul 2016 02:22:19 -0700 From: Peter Chen To: , , , , , , CC: , , , , , , , , , , , , , , , Peter Chen Subject: [PATCH 1/6] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Thu, 7 Jul 2016 17:14:47 +0800 Message-ID: <1467882892-27589-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1467882892-27589-1-git-send-email-peter.chen@nxp.com> References: <1467882892-27589-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131123569492724850; (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)(1110001)(1109001)(339900001)(189002)(199003)(19580395003)(69596002)(229853001)(19580405001)(189998001)(11100500001)(48376002)(5001770100001)(97736004)(68736007)(7846002)(92566002)(81156014)(81166006)(8676002)(4326007)(305945005)(8666005)(2906002)(356003)(2171001)(87936001)(33646002)(8936002)(2201001)(586003)(5003940100001)(86362001)(104016004)(50226002)(6806005)(106466001)(76176999)(105606002)(50986999)(50466002)(2950100001)(77096005)(47776003)(85426001)(36756003)(7059030)(41533002); DIR:OUT; SFP:1101; SCL:1; SRVR:BLUPR0301MB2017; H:az84smr01.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD064; 1:bQNm13VM7UcO/16Sw25WzG23zjjXmvK32WbzFC4567ic5oTU+Bwi6wIP+7HEc2jFobBcGRMnTL3mtSfI4trSyo6WCNH91SWQgZBmI/a2MBXuaWJ+5HVvbxbWIdpoW/SQRb2OVEhLLy0VjrFsDwCS8C4nxPkhXF+/QpTykexhM747dOxG//oPztPX7wGkYKIaIBnSSDj7fhUnxUWrLOGsHNjfZ0bU3ynxWQ9e8w8dsNs7CEjU5fxOA4mheyHDqtGGuQfmTFdxV3a4UCxmvd/5fSHf85ARBhjloVcucTqjWEK17HEixEKLX1feihNBAgZYAO0nDQFPGr0qRIMWUBsh1QcOgXy6uL4Z1gkBeCJbwsdN2mbMfNT7GIVJKXL1iDeRnMYiNWfLRsy/OyFd99aDXSPc7/IEdUk6oiukrnoMloV+5ssAj3HfJXGSDBB41nXLKQc9izMh9sb1w9Wjzd5I28K9xHiVVthGoOL71C9nwcDjydpIWt9eUux3G/7najBqUrI55beNJ1Vc9qjj0dgVPKq+Dmn7exkTzXvaI+ozibEMe9AseeYSQIr6VRKUO+QonBhTMGIIYBXnZZiJ1qdAda7TNMQFYYiuNsxdzikV7zG6lTgK23LEvWn4hq5xo/reXP6lIveEUVGxTcNPd2TdAMZiK07I96K1Y0CRQ39aFWSPQPwI/ACpxzKjspuWj/zrjuUPYCN26N6AtFaK3nyNjVCA1fT/YUWE8fbHpTDVfd2JWw1wpCBVVR2gSdbsuBUs MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 678ac5f2-5edb-4370-2b11-08d3a64837c0 X-Microsoft-Exchange-Diagnostics: 1; BLUPR0301MB2017; 2:UoZLxTeXBlAZ0Gbzc2vZ2B6o2uvX+RM/Os3m7tJz/dKXZsSnNpln4G8S+ZV/B2Aj0O35dU4BRVjiuYcvmyYBBBQtigZGobLXj+vTVZu2aiW+lPujG81RqRfbtLKNj+WpMxiM33qFyAfcjlGMDdAoonebp473QI+vokGDcdYqju0+vFvWCj3643eZwNZjWmh5; 3:hRhxJmO3nrw50DQ7I8TEDSEfKLyiE5Jwo82fpFYD76u2R0RghFkrkCPdXmuVqdmK7ITRK8IDrU6F9YuygbKzPxcrfobXcvGxA1n2b5ACEZPAw6+YH9QLzK120ld37cyuy4Sx1FIaEE6LikAG4HZSEZxh7lnaKhRifPfoLk/cYNPzOp4s8CzbUGeLE3BPSbIMw8fLAG5vqd+WPexlMpJ3XbYKSRLOi7Ffq5XQdfdis7A= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BLUPR0301MB2017; X-Microsoft-Exchange-Diagnostics: 1; BLUPR0301MB2017; 25:4jOI9/XH2kLzvQ+JxMhIJbnGyM1/G1m9f4HQAmQgsg0zFWuqv/H8LK6EkJS09chlOYrRXPm5xnuDVC8ebhGz9Fp0n4ckDWJyuxmm9ipCganHCSpf7g+nJ1kKHCMMnouSNHxf+ksRrIQ3/+41jqI53HENaIZjLmnY0cf6urNERIYJSLsKvaqNNkkDMGSyFAXZX1tRjSsb2s+XDtQLdOepd4VC+4FFzAAz+kFfseUldcOTYJabJJH+NnyPkyxJduxXfhf76k7LOEjQ+ffF2rb/SNRbz+IBDWHLPh8RiNPg+Vzfzo2e83JsZ5xd2lbXXncxNG7pUpwitAgj0HOc0pVAF4vzKFn6grKJFFVfE2Y27kZrddCD7b3N6jF89Uz9BDrFPIb7Ox6lD6OeyxfBHa/IQzR1uUreLuNNmWwKlXijt6GcQ0/4LuKuu+POmuKyQXF3ry5mUKw7ZaPleF8IFkowkVt4mUgNLVV3fNmrqniYiGMuOK/B+3kmdRCoxstHYSorF8Zju85BzHQw7FKirewXmSzb4acnbZAkI3vE9jvCzGB6hgWRyEBh10O6U+41eFHp0P7SeXcQlaWWrFMXk3UC85t6CRxTHwrDuWn8EpC6TWMg0LoMjXv6LJHfRHYSd9uMzSLOQ/hd933pLCV+S7INLPAZ5ZM1f+Q6MgVnBh6N9Ssfo6Z/yTdhzCN3lJ7yxZwPb9Gap8Rw/m2r1BE8Id5J2rwFpVPOWvk6s7yBdupts15R32LKFMGWHPLXw2aR/eZe X-Microsoft-Exchange-Diagnostics: 1; BLUPR0301MB2017; 31:Q9YPIOCQ2Y9PJjV7pjjjQDfLOx8iFKik7nG8sd7uzcpxVNpc5GVm6NZzogr6kNRQbTL0pf3Bm9v3qDiORayO3DChQZxYloLJsXKQP94vt53CkX+f9fKlDrlTMfvV/jGF/18yF7YDVjyxvB4CCC4GFglXpJEqQzTbiXA9grCVLQ6j27EaqpefLO7ZXzi+koHAVkzeI/JTqTb7e3OVUuYWSA==; 4:4uvVwxv0n4JCcmfBDQZ/rMv7xcWAlZkFT1Fi0Bw9aAjq97L/+C1e6R9NIrC21gR3O8vWcM6DZCY9JGC9qiMvauE5i3Kwlf0r46KGxToidmdjCQj0TIUZx9Yj2JopN2gj7f7/2Rb7gNoJDOzuHLNyO2I2xHUeYRXXdhsD7SU5lxgsSIsPpCz7LSj5l9InGEDt8FAdL7EVgKhv0AX7djXdLpSI9BZZc6x05qiJyjUtO0ORsmYRCJY0vFZj6oKpt5F7p0LqIhERPn50XoBTm4ID3CMH97BXPC9rNGWgXZyb+jcvdxxJcQXph0LLOB4nSR3vEaHc1a/uXxRIhUOhOoK4cFcRGrnSRj5oCasFoKQ/hdPMD/2d+GTTkmD84KxG4Q/9I7/L6exM3BsmPCYZSC6uLpojMpROL0EslsLTHPBW8uRBhU0hgHwO3R+iD/6xIlImiokiGyqBfnRKJ4hHDbcg/VlLqX6adMXSDdldiBl2JSXFR/y6CktUtLFgyUmGQLLo3v4JbG6rf45uC8/IejFteQ== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(2401047)(13024025)(13023025)(13017025)(13015025)(13018025)(5005006)(8121501046)(10201501046)(3002001)(6055026); SRVR:BLUPR0301MB2017; BCL:0; PCL:0; RULEID:(400006); SRVR:BLUPR0301MB2017; X-Forefront-PRVS: 0996D1900D X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BLUPR0301MB2017; 23:IxrLONCZ4F3V5FncURXTlBjqDxBPM69eTJNarrW?= =?us-ascii?Q?E9NvxtsGfRa+cQ5srikpjhmAJCGKiHCdeQNNqagUZW4NQ4L2L+7k5osYKaHN?= =?us-ascii?Q?/kWjtbqdSwu45DKdGFe3HojFxng+diUMjf4oQthBduZL8/ula8VHbCYOb0sT?= =?us-ascii?Q?k975eTzuiOBazSs3DEEyde0z9DpQKacpCqJSGeADdLAF8a5oQR9T8Y5TybzB?= =?us-ascii?Q?TE+9TA+kGgl4s3zmBpaY1214+Q8k7w+9ojtv9dy1WMZTBQrrZ53iXkQGlqYs?= =?us-ascii?Q?LWhaNPnhjD67NrZOa7rhiFvrxR2QnOf88itjtVC/oBzLFYq6d8uHG1DAmSsn?= =?us-ascii?Q?AYPWrR/L/J4L+WKHjPxW+5oA1Tew1WdaXma2r2q9cgPlB/Xzz1mnC/PW8x8g?= =?us-ascii?Q?yvCPjLxj2dCKi+gm/1NilxpG1arTLB7RE7mkjG7z9ym1QVkRUyh2zTfCt4jF?= =?us-ascii?Q?EAHv1yX7szhmR93Q2SYnaVRj0oKa1S0Q6CKRIzvSwt7kspteaEGaV6DPKfwl?= =?us-ascii?Q?4n3tMNF0oVzUxPYvMKUy9KBnxfw+vTyTvHp+GEeF/VuUDO1eQvvdVvaaT3ru?= =?us-ascii?Q?Xmw8p5zYAnYoqtb0D7km6noCuyWZ/PqJ8bH20SeD1SX3AyF8GIXMSchb/nQ7?= =?us-ascii?Q?nfARaNu9vPSpvl7UuMW3zIm72euheuV2e/Lx1dLchcm0R+x6UA/axHhTcO9F?= =?us-ascii?Q?nxu1mMNqMTf55jtIJlSfdk0vHgX0FQfc6AagqMcHEV5S8L4Wtq9+ofdU3mzY?= =?us-ascii?Q?2Esg30zE2NTnIINXprIcmsE9k54XOsKD5sx7z7P6cdUKoI6VUYW+53I7+TLH?= =?us-ascii?Q?Civsu0uQkg89+FE79dLSD47yOBiN5cr/AB7nsueELS4QfimolX5rX9s6dTkg?= =?us-ascii?Q?hYk+X6pazG+sKYvHK7Kudr2CgbRG8ujGMn24HlOtnbGC+ukljiQqApEtCZoT?= =?us-ascii?Q?h0MskJT+px1ekHlRCuFl3vErGdAh7MiDkzZ8kpvQ02jQ5lk/HNXDREQWv97o?= =?us-ascii?Q?bzRssIQ6ZaqqQUDVC/E2s/Hi+/nXPJ7J9t3BLJGmD99QU8xOI8O1+/HtQ7Ji?= =?us-ascii?Q?XB0OmkkUtN+IdmIIzw5qZJxogjBTmPL2xZM9BzRRZIIejZoGfXV4FAcZEIfq?= =?us-ascii?Q?+wBHxGy6wbTJzfW4wfC6/1sJmDSqmKmGfvJc7BTyrzulLN51Vc7/wmJ27VMB?= =?us-ascii?Q?4P7waAiJ5fn4o9RhJTUdUnDsTtzTvgcLkOIzH/y1QOIpCG087aWZsAlXP7Q?= =?us-ascii?Q?=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; BLUPR0301MB2017; 6:LqmTdbC8K/bl7qN9SgCMvgxa4lCpBIFBSVt9jII6yBIhC0Z0oBNvZ956KF3h5aJ+gs6VvDD5UJ7AwG3au2U+bhtM7ZhLbIW/OS82wCItZkFMTkOTi8OlWOiYHvnqUEZia0Kz7mBVoUrhmtqMDEJHK7QRqB208NoceGyC3o8/NhSrvy4m/tjKgcEA5oC2L1T78fXNdnNfXpOarabkKIxGeueaGYj4eaURPWZ54SGxXja/4bpUIXB3DMo2zFKWmLF+nQTKqWoiEj3iAkIdnn7DuT5Cyimhl0TBNQ/25NpP/Rw=; 5:w0mbU3e+5NjHtwb3GHMdUA0fshFJENj4gBMuWbbyLMFPgZwNMtYkQRbiOtQzA0k4g9D/z5wPfNUBpADcE1YkfChYXZXvyYOP2rYtf6FwXuUf/wjQnEpea4ig6qxP0l+yyssALpGl5LJs8hGuvM122TEGUk0uKSnVlsbjoQKkEgU=; 24:E5bV22AcRZAzwa++4Hmf2wgye/6lvXQaOL5eQyxwnXX6UP2qL0Y0oD9ITENtWBAcpXh49ccxfVXerQzOQvA3xSuxgbBLwxfkinTGqSgzizQ=; 7:h7seJldlKwMqD7S2VxosZFtNNmlllxds2bZD6QCO+7BGmuq6xST5Y+IffprRClmJgvBvWaT8/SYTaTJGUrSDYQtW1Ul6uIJG461d7R2PvP0cDeqPuj1koL9S9o83tOaHPypiCV87p9WDzpn9oRmnqL4xb4sC7yrSjoHNAubYwQXVadPDMqlsig/E21S2+pyH0VqkP+9GMMP+f4jJ36brcy8sdia35HSJs70Q6nGRulJYjsbn27giyNrh2HcFF0nf SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Jul 2016 09:22:25.9496 (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: BLUPR0301MB2017 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 --- .../bindings/power/pwrseq/pwrseq-generic.txt | 56 ++++++++++++++++++++++ 1 file changed, 56 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..4b23834 --- /dev/null +++ b/Documentation/devicetree/bindings/power/pwrseq/pwrseq-generic.txt @@ -0,0 +1,56 @@ +The generic power sequence library + +Some hard-wired USB/MMC devices need to do power sequence to let the +device work normally, the typical power sequence like: enable USB +PHY clock, toggle reset pin, etc. But current Linux USB driver +lacks of such code to do it, it may cause some hard-wired USB 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 USB +bus. + +The power sequence properties is under the device node. + +Required properties: +- power-sequence: this device needs to do power sequence before enumeration + +Optional properties: +- clocks: the input clock for device. +- clock-name: must be "pwrseq-clk" +- pwrseq-reset-gpios: Should specify the GPIO for reset. +- pwrseq-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>; + hub: genesys@1 { + compatible = "usb5e3,608"; + reg = <1>; + + power-sequence; + clocks = <&clks IMX6SX_CLK_CKO>; + clock-names = "pwrseq-clk"; + pwrseq-reset-gpios = <&gpio4 5 GPIO_ACTIVE_LOW>; /* hub reset pin */ + pwrseq-reset-duration-us = <10>; + + #address-cells = <1>; + #size-cells = <0>; + ethernet: asix@1 { + compatible = "usbb95,1708"; + reg = <1>; + + power-sequence; + clocks = <&clks IMX6SX_CLK_IPG>; + clock-names = "pwrseq-clk"; + pwrseq-reset-gpios = <&gpio4 6 GPIO_ACTIVE_LOW>; /* ethernet_rst */ + pwrseq-reset-duration-us = <15>; + }; + }; +};