From patchwork Tue Jan 3 06:33:24 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 710385 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 3tt3zl6WgPz9t0q for ; Tue, 3 Jan 2017 17:33:23 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S934378AbdACGdS (ORCPT ); Tue, 3 Jan 2017 01:33:18 -0500 Received: from mail-dm3nam03on0077.outbound.protection.outlook.com ([104.47.41.77]:48544 "EHLO NAM03-DM3-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S934334AbdACGdH (ORCPT ); Tue, 3 Jan 2017 01:33:07 -0500 Received: from BN3PR0301CA0019.namprd03.prod.outlook.com (10.160.180.157) by BN6PR03MB2467.namprd03.prod.outlook.com (10.168.223.21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.817.10; Tue, 3 Jan 2017 06:33:05 +0000 Received: from BL2FFO11FD016.protection.gbl (2a01:111:f400:7c09::139) by BN3PR0301CA0019.outlook.office365.com (2a01:111:e400:4000::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.817.10 via Frontend Transport; Tue, 3 Jan 2017 06:33:05 +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 BL2FFO11FD016.mail.protection.outlook.com (10.173.160.224) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.803.8 via Frontend Transport; Tue, 3 Jan 2017 06:33:04 +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 v036WhRB011369; Mon, 2 Jan 2017 23:32:56 -0700 From: Peter Chen To: , , , , , , , , CC: , , , , , , , , , , , , , , , , , , , , , , Peter Chen Subject: [PATCH 1/8] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Tue, 3 Jan 2017 14:33:24 +0800 Message-ID: <1483425211-14473-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1483425211-14473-1-git-send-email-peter.chen@nxp.com> References: <1483425211-14473-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131278987851739426; (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)(39850400002)(39400400002)(39380400002)(39410400002)(39450400003)(39860400002)(39840400002)(2980300002)(1110001)(1109001)(339900001)(189002)(199003)(77096006)(76176999)(39060400001)(85426001)(8936002)(104016004)(47776003)(7406005)(305945005)(86362001)(33646002)(48376002)(50466002)(54906002)(356003)(4326007)(626004)(92566002)(8656002)(97736004)(5660300001)(2171001)(189998001)(2906002)(5001770100001)(38730400001)(105606002)(5003940100001)(50986999)(7416002)(106466001)(2201001)(2950100002)(8676002)(6666003)(68736007)(81156014)(81166006)(575784001)(36756003)(50226002)(41533002); DIR:OUT; SFP:1101; SCL:1; SRVR:BN6PR03MB2467; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD016; 1:BaM+3iQNLI/2oqO9MGD7LGIxT4v+0Bi1McPLfkypuLltdW111Tg3ATKCh8erteDaO2IEOlFUx64++ZXc31vDZgrVnbSaobYbaBx6ZC0Pon6YfyOAdzUb1kI1xce1GRojyxf0minEFf7txzLm22HXxBdoDKoTSiqYhdIR/6WuazyGcbA9i6bQ/cnV5iCaJLR/VBPLJ7rjXuRzPNI63ZcvJILdkskxGReoKZtmdkHdjqVlUU8miLjnDKD+v7FclZtkosCv7c9kyBOhpnZ+EVPeElGv5HTF8OVwmMm50DnxXPI31WlGsswWhDMxTOyVKMDjm1bYDFKqRXrTij4Og7GHBAAhdfevdAzzcRSBUqGEn18B4svG5tuy/2U9VLipi2PPq/75VM0P7EQHuLhubO+oPKQA2jzEzi35qdd+6JWwOTcmgup8fl9ABkIm7iq/V85y0YduPapiLKuVNYVFS7r9AUx8v7mro2OoNDSF5/Bx19jYStgqg1ypfCFCyyS5rcjenqbR1a3n2WL/i9LMc1qf4b0RKf+NwoYmnk8zMXVA3uNuDULjTo49nL1dtyOgC3u84ekGpIsE39xkoelkSg4oz15KiOyfIW9lf2kkSUcunzvzGKu7b9r90VwOyYnmLOforIWsriaAdAXg4mQOGTn4oYu8RvDlK217PPArKG7/5wk4Y++sH20Ki7yyo+nHO8ImqJ/f6QSBZnZ2NfQjJCY+IRjPwZhlOYh5dpGC249HcZTtcItbLPaVTM+xsgdpBYhdmQnl1+9Jk6sRuyS9lDRsbg== MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 6b454a53-08e5-4819-cfc1-08d433a25fd4 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:BN6PR03MB2467; X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2467; 3:ej2npBqQaCizYaRHfj8i/WheQsoB3pdcuqhyCL60sLGM6/a3DaIZC5ZCWqBhxZ2bbOGW9EjYQIvlj+RYGIzf8akw73cLjSwt2ZnAczhwkvFLp9xw0XS+l78vGEHGZjt0LSMT+Z1rp2yuanGtwaQ7eZsrhXyTLBgZDhjh20yh5N3HnBLHBW+ucOhNMQzoSaq69pvOH14nyh4mtS/Izs7ChihbXAtcLjNu0qMsxeXptN8anKrF+JWLHKEsz9Ht1xf2RxUHDQXpe29T8MN5xwuoH288XeVOK+HHQ6pKB8K7XcuGRUHclg0iEehIE7u6dQC9FJ+g6Atb+xMrUMnMm6axzXGGqPNijKgFI5t+BYxvAG2Bfk/tQzqgmwOxcM7RFRt7 X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2467; 25:YENcQbqmqvKD4NKGR7sIM8fNGuslFaUaSGcRXY5pTJ6Er/LQBL6tS9yInkOFUULbCtqpBTZqQQeAHwJ+EChx2bOCJgXXgDMxRzOngOz7Xvg+94QHII8Wc+3BAyFWuRr24Z0uF1yIZLdLlBYgSBykQ45H6Ix9kOrQiiYShEEY22O+N/mRUR3PJBKT2HyizB97uI9+wMXlTS1Z6eITSUYKzstnGFbUHjbQNjCjswRTtkNS/ShWs0HRXFQEmrkKaUl1PyN3x8DT7ts/G0D//aufsTunfEz4N6TNrZAuZr3r0uAG4PHTkxLAB1FVmu8PaQQm3326uvYvFixpAes1qrX9rRWgf+GntfdJFvB23DY/1MQ7WgYcik2Z4quEl997w28a5IGM56OOuPZjdOrPYN1o8tTvxDUCJH+JkaOxA5WAMIRvv0UMrYw/bLYL1fkHL7TuUV7jGsl+y/8xFDyONgCK4bwYE/shr46M7Kw8heBbpiP/ht8UsC4PMe8FMWqaUy5IYJLDMl7+TdYr6b0pw+UW/WePW2tb+PdKfXOXhEkm3/n1YBl1NtkfcYXnrLf611kTyk/CEd9gVQeE7Pja5gqwDTr5Q5aKgRXzXJAf2hvzu53j+DNBo3LPBE7hg+hM1P1boq+mKX03OsX0SHuOILfjOm7Bd6JLZ5xY1p2bKdgqsuNal1zb0SkPgU7oz1w7AexBTsFikAKrtqangphToKPiFN64ZQr4cU2kAR3LsItKCeR46HUMa/QyBUaAYbtaup7BIevxrsknNZm6+pWNIYxiY6DfAZNHuLso3zGOCmMn+sY= X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2467; 31:ZOuyc/aKYOD0I2NTwZOWGmHUHRuEfdJMw6OYZVI+wuLktZGx672kSBRVYs9EEQVaCMwQSkXhmwBwX061GpSg/J7JWwathrr0kNIyfhDVoQcH5SWRB6w9ZwHPUtboieu+9LOh8plhO6j89sbsBUY0pMg1QjYsbhfpxAfuNXdrc03MDzcR5GbBzRST6GgzvgBBpql6r+gLysZM3IDUfVh+LXAfkgoDx17cG0w9rY7TjOhuS0B1OpIYKcLQ17V+Phs7P3Klrj7dxKIq4w3AWW2reg== 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)(13023025)(13024025)(13015025)(13017025)(13018025)(8121501046)(5005006)(10201501046)(3002001)(6055026)(6096035)(20161123563025)(20161123561025)(20161123559025)(20161123556025)(20161123565025); SRVR:BN6PR03MB2467; BCL:0; PCL:0; RULEID:(400006); SRVR:BN6PR03MB2467; X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2467; 4:CK4cU21O/f9FEvhgR72uqbTLxZn9k/zJPBwL/wxpLa9z9HPX6kCIczTUWIAzCLMTIADzAdEZZ/janVCtSzQGGUebYXp01a4Q1fccs+e6W6sdpOYTr4DW3MZy0UBR00oV8uD8THI/XU7qBV+TmHQQiorQg3kGNDbumDNZU9ytRLmmvs3OoCPWm7QHprEPyFExDcHgS7Ee2kLk2443s8zhBiKs8SvHyDdUDYUYknF5sZoMkSQ7a8XqNry/9KXISyTsGW9gSfUea9PtpYzMQrQ6PmId1uj6uwa2wub7mgNUPBdC+u01D04cCoOA5HqNFVRtuQlawMyRQwpXoPN3AwD1nX0s7Pbnbci3IYA6O6jkjQ/VSVPYgRQOnxcefAoNxql5x6/8ayhLlocHJPH1NLFIhqbSEZwpkHVBo4nS832uJEu/0qjTJl9ZNyJuWjfxCxLaACeUNw/TuhpfVE31ULMg4oIBzVGeaWkyeWErPbbeLbNUwOwnzNoev989IT4TKZRZ+7bdheX8THeiMIFDSIQzdCCt2zk5zntWTK+rW6Htr6+Dzhk3Q1L3Tg5TfFMsPQpxj28tcY2FPLIZk5LXYyLEAGTbXJrVWH9wmLzgUjrMQ/gkCJkHO3Ny+1sp/5OtjcTbo/jJxQmUd9jasUWTD/lpjDVNf+PbLuPr+UMiqbZ7RSfgqI4RNArBaVIvrU8o5Ct7UqhUGb9EBoTuCFIrdpGuqxpEYRqCumQjfhOWAZQlSE8= X-Forefront-PRVS: 01762B0D64 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN6PR03MB2467; 23:u/pxEXmUlcTB6YZXwN6lC/c73CVWGIWRL48iKDrN/?= =?us-ascii?Q?kKL7l5kzenylWembZ2dnLapT3CQ+q5O6BaUscLra+qxHBLKeo2xXtTJLbsJX?= =?us-ascii?Q?huSNwYCwoSjaL7DUkDIOqlvXoUV/lhQTH2H6hN6FM2JLp9UwOWbHUU/8Fz84?= =?us-ascii?Q?LxI7sh3OyXFtVHDtWazFPhTont35V3wK4gbJEVUK/maJkfnSM4jXUwD3qST4?= =?us-ascii?Q?pYLixkNebPLRT0PBNaPnQ7AR/SeACUIXgjXSBcASoaNneo48ZUpq5JRqjLxa?= =?us-ascii?Q?0VqJ9EPJDLbxoJ33AHZIhocuTdN1rhq0XtAF2+GtZExXBOh7gOF+pOTJ6stl?= =?us-ascii?Q?rJmBcL6Z8c0Fg53Rd9SFf7Ppy10uAnC1NOB/+V2RnBb9F/YVfC6tBlVmXQJm?= =?us-ascii?Q?piQ4nwqZ7eMsY4DB58ytr2WobSWhXAADJ40WHCizjvDofCOUMfec3z6qhbqz?= =?us-ascii?Q?JM9/VeZbwQ7lCcXDM5MsKjScbghXgesueWhXQGfSwXxhQSP8gMYTz1epmdUz?= =?us-ascii?Q?+oZbBHGO7XwTYaxo17uxdWiwvhSHmK4rcEYYExMDg58MnA9L1NwV3L8/+H16?= =?us-ascii?Q?Whc4wCj14+VQ/oVgN/sb1ylVh/0TWm6GgyP6NyVp1XEOay1fMpdlT95D4NdQ?= =?us-ascii?Q?J5phrMN/t0V2TAKVf6JJmvicNsVSOfFxoNsM1TMEdN/6SI+Ja0KWxeOebtdW?= =?us-ascii?Q?mRk0mffJUeorWmwoL6TK3Tk5swayPBTesMuoE0mhkuNX155iHzD1FgvJ4S1M?= =?us-ascii?Q?sKhickyNt8ovL4FTWjVnnSHhDMU7wmmK8YeEFmrci3WyDWEEMIrkoXON3gRM?= =?us-ascii?Q?7v7tPI8q17U3hKC0iylGNAV2Tc0zyYQ6PipqlH7vDp6p2eGW2EOTwOilcPLw?= =?us-ascii?Q?4tKX7blYzKu7bUB9iNRH/zULERT4vOt9pFWj8VIfJOA77IDmdrMZvC6OgLTi?= =?us-ascii?Q?iaqTKTiOi8eULB++6PG5ASb4uc1Ys0w6forFoSfwA0AVMoLWedpsB4IXDKXE?= =?us-ascii?Q?XjYeT93b0A25kNbKL2cN2vLg0TXvakP9KcMN3hyLrg80sUisXpWzdBz6wfHK?= =?us-ascii?Q?ud56IIFVPgYU2YCDu5Z8OqRGSGmMjcgHgTC2MhDYN/EmBAokF9CmuNLy0dUs?= =?us-ascii?Q?csciMXfp+ng72OtbbRXVX8Dv7LnQ0rW+69+5M+9U6uUnijMwcLXx3RS6Eto1?= =?us-ascii?Q?Vh0KAb6CBfDCyHJMDoEuoo367TVBuBbmxKxeXujP4uE9XebOQUUUxKGu1WvV?= =?us-ascii?Q?edB5psmE3VLx/sHS9pfOhKVY7DZaqp/jiwx5F/e9AZ5kFKgqlUkFE1JGIxbR?= =?us-ascii?Q?T1gkIxXCaCaJKGpiBJ+rdfX5hMrmvp9GFf2n9JoBL0j1lXkaovkNyBl4onp7?= =?us-ascii?Q?5q9wgHYmi1HIcnH4r8LJZtM06BgRqq0ttXF4hqwFhsx7o9n?= X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2467; 6:Uiy4CylV0uAPtKoKCaj3Rb0gAbLwFHHQ2oA5qw9aAYCZ8WQ4zXMBlEa9CBGVX6msUlcmhxO+ZwQW6SSUgMsuiQKCf7PpS4bYGwlwwF/GIR4Ytzu6CoIdS+xO/tKwPqHhM6gjWBTasaBtvxIhRUaYCSIjs0lnKgwr8RtyEhpdwq1OjbpcoirByNo5AQYa82Tvs98i+LYYwvRauTF8nHlKWpLOR7oHyJvuwyVu9B2w1Ohke3Qm6Pfn40JEehRjFNENkH9TOjJF5xcAxqCuCadJAJSeqFtvlIKg9n2ZoIwnWI91wJ31xKxGE4BBuzsWGMEX64lk50Scl33SsfM21K7d8SGGhDH9TQa18T2DKJN/AK6pEyXaOVMtHhdbXFeE6y1qYIh4uY034mZ2VUqyYX8/k3/pPIDMmDrE80yVJvRIw1XoqnFpucQC25L+jql3V0MT; 5:Jzx+jdKxGHsgOz0QG8fsvgR8D6UgGC7ElIuzkeHH+uWteSsjHXDNulILqPvcGVnkiMwHvwh3IVcQ0MhMOs5dMM/jtcyknEwAAtnK2tp6UqmEa99GdxOF116aArJFai2Oc8wR80t70balQ5bhl+FWyUuhNf5oNkHo1cpc3/w7jxYITyjgUkpwQrSKpUf4oYUl; 24:Mg8hGWUP55TNT2Ya9UiJawomSJaN2kHQsTz4AUt3g72U0tJ/Rb1xTDv/A6iEZYmR9CrO9Q6U2nS4DMyBjENhkZGx90Wv/fl7RscB5f2ZfCs= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2467; 7:PkyGrdPdshZJluanWFYqr8FAfHC2HcmU+cTl953TgGKdFflrqSbohvJrJdRAnSxdyAdLhyM+LIeIDp7NW5YWYF+C2JBsrmrl2diJ7es+r/mN1c/dayfuoj8MexMHLzxvqufp7xEPvFm8MM2TMjarl5SbMkx8NurDB2nL0tlts0nPGsHOJn+ALU4fSIMF6JZ6loIFXOydNNLK3AtizEAnioNMkXzc5TqiDcI71lHrMunHt0cd3b0ZTcTCxXH7aRqFoQRLAJST6VYhZkJ9V0GLgrDbOYTwMMjHUcTAM7aKdxxhpgU47X6R8gKK+FX+TXIHTLfXyaVDbVSPXrJSeOd/JSj/U1AzJK3vK3akRj8ef8ZNa9kfEAwg1w7BcEm6/34mKMvQaNsoplQTUaM2HFe9Rz20YPsrbTfvw8x1p9prXYdcA6IYULxWJ18xxsWawnzedWYPInaQR04lTAUPFleClg== X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 Jan 2017 06:33:04.8619 (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: BN6PR03MB2467 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>; + }; + }; +};