From patchwork Tue Aug 2 03:30: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: 9255059 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 985956048B for ; Tue, 2 Aug 2016 03:42:08 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 895C3284F5 for ; Tue, 2 Aug 2016 03:42:08 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 7D78B284F7; Tue, 2 Aug 2016 03:42:08 +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 05E04284F5 for ; Tue, 2 Aug 2016 03:42:08 +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 1bUQZH-0007pe-Py; Tue, 02 Aug 2016 03:40:35 +0000 Received: from mail-co1nam03on0049.outbound.protection.outlook.com ([104.47.40.49] helo=NAM03-CO1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.85_2 #1 (Red Hat Linux)) id 1bUQZ0-0006Y5-2t for linux-arm-kernel@lists.infradead.org; Tue, 02 Aug 2016 03:40:19 +0000 Received: from BLUPR0301CA0030.namprd03.prod.outlook.com (10.162.113.168) by CY1PR0301MB0697.namprd03.prod.outlook.com (10.160.159.139) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.549.15; Tue, 2 Aug 2016 03:39:55 +0000 Received: from BN1AFFO11FD026.protection.gbl (2a01:111:f400:7c10::191) by BLUPR0301CA0030.outlook.office365.com (2a01:111:e400:5259::40) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.549.15 via Frontend Transport; Tue, 2 Aug 2016 03:39:55 +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 BN1AFFO11FD026.mail.protection.outlook.com (10.58.52.86) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.549.5 via Frontend Transport; Tue, 2 Aug 2016 03:39:55 +0000 Received: from shlinux2.ap.freescale.net (shlinux2.ap.freescale.net [10.192.224.44]) by tx30smr01.am.freescale.net (8.14.3/8.14.0) with ESMTP id u723dYUI006554; Mon, 1 Aug 2016 20:39:48 -0700 From: Peter Chen To: , , , , , , , , Subject: [PATCH v4 1/6] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Tue, 2 Aug 2016 11:30:47 +0800 Message-ID: <1470108652-16812-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1470108652-16812-1-git-send-email-peter.chen@nxp.com> References: <1470108652-16812-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131145827962197004; (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)(2980300002)(1110001)(1109001)(339900001)(189002)(199003)(68736007)(5001770100001)(77096005)(8676002)(92566002)(97736004)(4326007)(2171001)(106466001)(8666005)(81166006)(8936002)(50226002)(104016004)(33646002)(5003940100001)(189998001)(2950100001)(586003)(7846002)(229853001)(48376002)(19580395003)(575784001)(11100500001)(50986999)(36756003)(356003)(19580405001)(76176999)(2201001)(81156014)(50466002)(47776003)(7416002)(86362001)(2906002)(105606002)(85426001)(305945005)(87936001)(41533002)(7059030)(2101003); DIR:OUT; SFP:1101; SCL:1; SRVR:CY1PR0301MB0697; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BN1AFFO11FD026; 1:Ox9JFL4y01aJacjKAxh4YZHFvDGkEhfW1OZ7WL7Z06XEY7n4bB9iB0wQDwWsCGQhykOR43UVKZ4lG5q4xvsXmicYBuYqav63o7zaThEOH0+HIwc8FLsTsPx5lBu16sYLAoDlUqdBRlC+ynThv31ROeL302zkavOsxb9kCkJBG21YWFrytHMEqFzOlg+R27EhAdkCcSH4cCVozYFvmytvO6V+x7/4/pMKI5AJO6svQho3tuoflYWRqFIuYHRaYB3eG3jJGb0AuCignGzYdA8gQC7TGeW0AKqz7I/jjgA91v9msRdiKSaWhy4POrA89OLOoi1qIL9U0iNoihrGHgExfiePQYdpKVzZuoydURGug8dUTCyNhnd4/Wq0kezHAVn7jNSsknO100xIrsYNVXr2pTP0gv70DpXLvsh2Y+4gjbifVcTW9+eIu1NqL4J/rReUk0mY0O5Ns/9GpaeQmJEgvNMIPovgIKW0ixOe9EgkE/0DM2cUVsNzWJ2tJnsF0NPXhpmETIDwDuvntewn7GLVaZYZn+Qto1uCUVcNsJ/sK4POaqWC/gzT6IjkHKo5QOTCn0QET4uR6zIQmD802ZgWm+csnjNy6qsrV5UC5In8kWDfZew2AICEWED/+ICpKfUZYvrodiNr5QkCq08YnSSqobG05ea1Dk1OTarqqyA4sHKUrd9sH7KTyq+y2K0NA19Dqma6dbWC/6c5l9sBhWoM2Vet3XAOaq6l9vcv636WjFcX4DYZsHcjhk+bPfbaZwk1 MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 649548c7-0376-458d-b2ab-08d3ba86abea X-Microsoft-Exchange-Diagnostics: 1; CY1PR0301MB0697; 2:0rhPZEuzKvDioz6KfBFhE+0WWOMVPzZTjRRzaD9KUY4MbyLd92n2m0vN3bjV+Z8aifBEEqHywJFaq0r4YesZxxSARjIQwkzxuab54yskKsUU4lSYxfe/H5wu2Q8fFjAAxlV7d9pP7IO3bFkPDpR5q3WfQvv0yM1wiepwHN1+ZMpNnzmYvEjiE8KnRk26bZXQ; 3:tkubQGI2eJA9l8df9wyoFB6xIk5tbi3SifYpGQr1K38P8BPsVdPumVMjt4ua3kh+RCVpN0mMzjVQ3F1ZWqZlPXDyFIpHxL12vCAgk2KxQ6x1p7Gue6TaH+evrvrp5eSplLdDUxgiXFdhctaWJlrabkg/s+qn8hVITHKjGvbJJHlOrMskJvvo8XOL4Z/vPDuL3HHf1kVACFdG199wusVL0g2N+DK/Sx5+6S5ZHhnYYCg= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:CY1PR0301MB0697; X-Microsoft-Exchange-Diagnostics: 1; CY1PR0301MB0697; 25:dNs6nTvmsz5PSK5UImcNwXvZu0pNJaMxkzfFszE5FILpcm2q7IgtW6jbsOKxeUjRPWkiAvjZZqauPpupJxJrDeeEJ8JPB8gD3/MytSraR30I7HXnDX0Y9KPHOOube/+OYuOzvqGaJjKNsETNYH7z/JXKHFYEyUaJmhNLhkWJMu2QSjtX/4A13zNCjaxSnLo1VOu0s5Q3aJ/05SPQdemmuC6LcsTa+UBvylRmuD7PF1oamBw91mGcIfqqNCfjsjKliIvW/stZLvAGCJsjUyXerWqUPR0L+Q4tWOMTkD7izKMfBsljCZMv9wkVwfiQZfRf2hsi/gEkluR5cliYuPDGsqtzPdpIbzT0MIyy6wZWWH2F03pP5Vn+kJG3ZHZF+lmMg4MnzWZbVshDdieb76AHnupeVySv1znApygMbAvp/etsAPzXTvUj6yEUo9VrpJsYqkCTc60s1OqMhLyQh+DX0mjRmVJmbQh7pNDm52A4oVGv6AWYvsEe3bkHmvJAsK2LXgdq2m1DXDYclGUWWWsXXiqqRNdwonqcrye+/fOhOydL/1LWfbx3thZaEcQ3TUZ3vn4Fw+pD135l81yqDmRA9RPDpp80eYRLEN+1rQ4DNjchNrdHmzuhH+Kfn2xoFFVEqXzjpJ1apsNZ032O/ezAdjWUZDoB8MxulFnVupkyejRIZhN4VJJx8F9MeRCQpmjRIqY4go2UiR7yLJGoYS4qZVOGduWwyo70m8hZAjkqXuLAcZdSI3hU3Bs2IQL1ls1x X-Microsoft-Exchange-Diagnostics: 1; CY1PR0301MB0697; 31:DjcEW+tnnnsxdztvKuz4y9xaJF8wDn04PFS4EjCf17YJC3rHCNfONOeSy9UlcwHNv9iS/aQoH6kaHjIR0ktfvOn5+FKvTxkIZTiNQn9V0Pg9VOD8VGHGT950G6+wQLZQA7ILjF3fs3XT863rH/z4cUai9dpUuD4Sr2Rkgy9KwsKjD+jqVOhD/GANAiAowHJK7FCMbpiuHru9IHbuQH7NvVFCwFBbNJcbKXvIe1RisiQ=; 4:jwQbQVEpNbzCLwUm5wG7Z6X/PKPha/WRkI/p4zu1/KC72ykt0wHLnALm2ZMBsFtWcvwNfwo7lF3N4cw9YGi3HC2qiiFKyoGUPiLBghQHyPz3lFQ+0A6X9PhpVFsHxK+4oZYCwYclHcG8fKn2Jzpha4klCig+z63R+MFFkSezSSmI08u4adEGYTuC72OXZcuV/zOmr7UrRlc27Ia+qMsaSxNJwHSYWPGPWxi3no4N9Y88AmTqvahO6GbZ/WYUDMmZ0Wi+H00D0hTTUyHqMw/1ZrkAo3zPFNc21gm8SlToc7E6/Y34wOaeiIYIYlA836ZoPYcZXOoSV6BgYbNEH40tI/VRCjE/IpAX+N22dYXF+Tsjwig9lHiIDv7YaXLLiOauUqw0+Kj+rE/p5jR/V76Ukl+tSx1GYfzdeGNExEzoKKOOyzEsu3XOWd2raScbWCiiJJ7U5jU/J0BOBZYUoOMP01ErhxMrD0gjyli3dkufYjUtDohFpcBqNqvewGS52n7doSDofni3N0suWzqLjD5DNA== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(2401047)(8121501046)(13024025)(13015025)(13023025)(13017025)(13018025)(5005006)(10201501046)(3002001)(6055026); SRVR:CY1PR0301MB0697; BCL:0; PCL:0; RULEID:(400006); SRVR:CY1PR0301MB0697; X-Forefront-PRVS: 0022134A87 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY1PR0301MB0697; 23:LKgs1IHctlQlqigWJJXdBnIQ1wuCvUzQeGKpmYO?= =?us-ascii?Q?GN0wDyccv4X6dMjGC/JKefel5DV3bs5mAulTGdT9E1gv/Or1qQApeAHUJFJK?= =?us-ascii?Q?kbo/9tu5XBypMtYp3yWkeRFOHd77WoEGUKZG3gYM7NATYEw26wmfS3KNLlN2?= =?us-ascii?Q?2A1NKLXNG9VrMkJ2yICCK2ETk6uSNcBeSTb8+WwM+9lrRulOy990Z9k7823k?= =?us-ascii?Q?p4XSUtVt4B/qtnTYjaFIM0nRHtHgE874DKCFzlXLKyAq7seEURlYu1ar4CH2?= =?us-ascii?Q?IMiv24iN5BLAiRF3VD3NMfdOVg+nFDp2ZTKDQiT/3sPqRQg+eyHnfch+lMzY?= =?us-ascii?Q?NWQhL8tQE+t8ek//Ij6s/3jhDZ0CvqYPfAbhWpCXBzNuar5RKMzpPOLqAuSZ?= =?us-ascii?Q?g8+yIt40813qGyMLSQBi5YQnvB98g8qJyi2nrpB9jiyfZU6sZ5qcbMN6vC72?= =?us-ascii?Q?Ta7XAyKeZKlcczKqKI1TWisZ+nqgiAScDFd8dh5VlOox56UAb/jkYJwlUY4f?= =?us-ascii?Q?rk9OeI3BzqUJXXu9XHhmVPreRazEnOgbxDVZMVtUbjdOLMT9AmK2u4plug/3?= =?us-ascii?Q?tSaZcrxZ8ROwQuGToVGwy2PWvmWptnlUhQlI8DVvDEwqZk1diPbGCd+TuXpJ?= =?us-ascii?Q?xinW0gf/g0O3HhWq71qOFtR8BEgoL0NbFwl+fDGOtqbVtD5zhTLM1BOfd3bf?= =?us-ascii?Q?9E1t8FE+0inssoz4Q7+2q0RWPjdhjtcWzUqmRhDgWlvJBegrIpcHZQ5KCStW?= =?us-ascii?Q?XaEQ5u1nlVjLtl0bQlA/j+yN61/cAjk4knmnakzmePo/QJnjsfOCFzg+KYW0?= =?us-ascii?Q?OQX5b4SEOqJqgSC2mAqXmuwkcyXLnoVkdOw+4dhXpxISHHnCW6ApO99HGPtc?= =?us-ascii?Q?UaoiG3uZY7irfALrTkTUXqbqRt3wo979HTwZU1bY5P7J+xaKMSYjrGrFW4U8?= =?us-ascii?Q?ZoHunkxTqdggZOV6RYQB7ImAjnHHjy+x/w+TojAR0Oud+TRt98H5DDQdbHdT?= =?us-ascii?Q?al8j7ngNaYlCcFwq8O4epsw6CcG4T79FITx+tJSs3D/jMUnryZPzyqxtH9o4?= =?us-ascii?Q?lR+XEGocVy54Dnrbu8RyVSFXU9PIsHgVbJtb/bXL/W5vKnFR1fau4PVr39W0?= =?us-ascii?Q?peFYVHuOdUBXTdADwsHZGxG+2+xtHS3iwpPdmywlxvzotg+LQQx0M2eNeUE1?= =?us-ascii?Q?UFU3RTWGZHJL5bg3gUsCv/wv8jxZM0Uxmw5CQoTMGk3Tr/2MdsvHli4SEZJm?= =?us-ascii?Q?3WAvjnF91b9yHmCzExrY=3D?= X-Microsoft-Exchange-Diagnostics: 1; CY1PR0301MB0697; 6:eT+QhuxeP4U/xsHJJYoNF6oD6+vkAJ8cJSSXpGX61ROMFGR0GbvolwmsdHZY6UwKXIJmjD5hA4e440T5c66eTt3pviZ3OIVrpzStv1/5zrEowpaerrzf3BUXbUjJqA3hDUTq52HYSlTh+LmoH6J28JirzBpfHdcfj+d+cUwYF+pu1fIvTSXGBCs/VuMs7A/ikh9MfWR1DqZJkoyQiVGGxMv2vZCVrXh7DQytz+9Bs70eruOnN4WXHDlOoeVTNfoMRPyITL4SkplTRCnkR4VhhgJvP1GyDbdEGlAqrftSkLQ=; 5:GtYKDHXlbxo6DCqfZ3ElXgMrQy9b51Ew/Zr1jfJGn9LFA0cFWKFmcHe6e5hIzvp8lCUYXGeIo58QQ2p9TShighLqP+yxTgCF0zPLf28JXAy/C6x1iZTVBKP08Nzv7ZItqoGlm1MqKrJ9b08Rq+Hx5x/JNGzsDKueyl0RbBKsATo=; 24:WXe3ZqGQrmhC8w+0HBe+6+G1k7sYalg8PbL2iRlxKfreln4uBdK7ddb0Uz7mTRUsqaO5e6jysuXFIuGJwRzyqn5ToSV+w1T7JuJO8jozpjU=; 7:O+18d6o1WDeGrTaCJYxML29KOc9EWX/gM06/HDu80QEfbwvwwhE7bHhhj0uJbfE65KFuX8zRofxxor1dylqG/PC3C93wOwNBoUx3G5hqvUeTbWVU2ZDBile0rZIVuA3catQCOmlozpbwChKZEeyAfOha3lqHgwjZpCNLiO3PD7qVuJqzDT63S2RFZJP/TUfg3tAWxRry2UubhDPnmqusa8VxepU5ue5IWFu881ezjV+fTdYnsfrJ9KGhXVG3hpOo SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 02 Aug 2016 03:39:55.9856 (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: CY1PR0301MB0697 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160801_204018_335196_CD614087 X-CRM114-Status: GOOD ( 16.79 ) 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>; + }; + }; +};