From patchwork Mon Nov 14 01:35:52 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 9425267 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 9515160720 for ; Mon, 14 Nov 2016 01:38:44 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 868E8288D7 for ; Mon, 14 Nov 2016 01:38:44 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 7B178288DB; Mon, 14 Nov 2016 01:38:44 +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 2491A288DA for ; Mon, 14 Nov 2016 01:38:44 +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 1c66CY-0005Fw-7p; Mon, 14 Nov 2016 01:36:50 +0000 Received: from mail-sn1nam01on0063.outbound.protection.outlook.com ([104.47.32.63] helo=NAM01-SN1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.85_2 #1 (Red Hat Linux)) id 1c66C9-0004eR-L3 for linux-arm-kernel@lists.infradead.org; Mon, 14 Nov 2016 01:36:26 +0000 Received: from DM5PR03CA0006.namprd03.prod.outlook.com (10.175.104.16) by CY4PR03MB2469.namprd03.prod.outlook.com (10.168.163.147) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.707.6; Mon, 14 Nov 2016 01:36:09 +0000 Received: from BY2FFO11FD045.protection.gbl (2a01:111:f400:7c0c::163) by DM5PR03CA0006.outlook.office365.com (2603:10b6:3:118::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.721.10 via Frontend Transport; Mon, 14 Nov 2016 01:36:09 +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 BY2FFO11FD045.mail.protection.outlook.com (10.1.15.177) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.721.5 via Frontend Transport; Mon, 14 Nov 2016 01:36:08 +0000 X-IncomingTopHeaderMarker: OriginalChecksum:; UpperCasedChecksum:; SizeAsReceived:1477; Count:10 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 uAE1ZnfG007215; Sun, 13 Nov 2016 18:36:00 -0700 From: Peter Chen To: , , , , , , , , Subject: [PATCH v10 1/8] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Mon, 14 Nov 2016 09:35:52 +0800 Message-ID: <1479087359-7547-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1479087359-7547-1-git-send-email-peter.chen@nxp.com> References: <1479087359-7547-1-git-send-email-peter.chen@nxp.com> X-IncomingHeaderCount: 10 X-EOPAttributedMessage: 0 X-Matching-Connectors: 131235609688878799; (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)(336003)(339900001)(189002)(199003)(8666005)(104016004)(189998001)(48376002)(68736007)(50466002)(77096005)(586003)(356003)(47776003)(2906002)(4326007)(305945005)(7846002)(76176999)(50986999)(5660300001)(92566002)(85426001)(7416002)(106466001)(33646002)(626004)(7406005)(8936002)(97736004)(36756003)(5001770100001)(5003940100001)(86362001)(575784001)(105606002)(2201001)(87936001)(6666003)(8676002)(50226002)(2171001)(81156014)(81166006)(2950100002)(41533002)(7059030); DIR:OUT; SFP:1101; SCL:1; SRVR:CY4PR03MB2469; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11FD045; 1:lEIPe0flwgMA5qM7ob5DU95sEtVYgOr2nSqmCHsRNzxNa02abuS6ko8wWNrq6xVGuUzIZdhJhmSEuDRwpYuTHSFLoWjm+VSmiFWjdlC10TWjpe6tupLgTmnfXQ0z5/H/0D1grHooK8u2JimyTZQ+Q7IhmRszN3Uy7lOPnMlYXifxXN5AQVTyAID464jSculkstmyFmmBk8d0xmuJxksw2qjIKPFahSxwu8g47e/tTUVHzO3N/KTcAIvrtlTLSsL1Nu5cfMm+UXgGOT8HCuaxnyX5uPNsx3gZw0SPKw9UTOhsj3K5XIR+ihnnaxXNAvFGHdz/uRj8JixaZakCKWSy3qneQ1Q8SQ+0qLofSNUr1z+yljFdp9Ye550vdUaNbSFgbunfot0lldWxK9n/V/vStcX9W0zzP6RKlj+WXx6fay7ptRHJHlTcSgP0D8kOjo4H+jhSbIOVIES78kWY4tyGvUonk3eujoJsRe4G6K5YqHAyY8Qs2Yh8B/T3DbMJPF6zHokyauX2OWc1woOT8ugznbOXECbec14sRWr1vTK7FPqumjGGQTSuJw5W/p+1nIvM0OfJ24w0CH4sElSSzmB/q0ItAc0NJkSCJ8dm388+C10ebveEcoH4Ilh9Me7BvlkdsT1Ybh2m/Kv+NcthJ5190Eik2axZlaE6jVqE4hujM8zxdbEJe/SNKMrYgRDLtAxfLS7MyVdZpCXp8a1FpdnuYvWZeGzPHC6koN8ArbadtX4EphMUgN+VoBIWJzHrXz4d MIME-Version: 1.0 X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2469; 2:GxjeZz2V1Z8pMAWOuH4VcIFwSoO7w/UUZVEDZvGPw068ZLcU/qt5ELyBRg7ZbVE1EGdBwuPsa0wto6ImKYMCZ9yLo+QhheoMx5dWL1d4/OO1RlU9A8tp3tMqgngPMCtA0nM529Q0GPbs9tFON+4JVAL2PVb8fpMUP4vevpILx3M=; 3:GzCxZHVFyYMuPK1X7PD18zUdAHWrbJ/A+Yi6hnBPWIK5z/bjKIN9VNIz6f7gfRg9nysknNMVIimLP76oFAr3qu5y8pjn7UkcoGg1K97cBsh1WXOKt0c/UJEL8bF16q4ChclMwt+z7MD5b8WoPEDPsoGgiQmP0VCV0OETfXB1TsBBDRTY89TFCvZ1YELk3EKtgmvy4CV3MsugedyJrdU3uExNSMlzLiwryf9YKXgil1AnpzJhmhl50Pyy08zvy+C4muzUk68zNSu+qLJiKy32cA==; 25:on8XH2pg7XKcCSvPS49LbZ/goim06KBC0zVoPgxx2TL1fgxS6rByg+RW87wyHPX/+S5m8x0/dquCTFral2iOSb/X3JDd679+hLiPfN4ESWGC8jV29AJT86D5GprsFlKXily9wH5EJIx3MgvsHCtFzytn11Kork/fqfSXJ0EsOw+S8qIkitfhKShiVH7jHUaqDCEeKzb4qPis+SlPiyvlBEgh/hFwVPFQEeLXzY51JEfHsiQA4zSjYclCBGsCnHzsN+56DiEByFszJW+QYLTjyH8H1QY5tkhkmHFOmm9zpcEbnb3SYgakh2DeG/OPfZS8hjXz+okQzUsw4+78pTAimg4EKAjnVCp2zuRxCW0XI5kP+oPanNZwl9fPB7ZeJmmSHFmXOjYuRu0tlfPjHdk4SEL7MhdKgE2Wxh0utBuMKh7/hksd1OfvlrIpe3mzXfON X-MS-Office365-Filtering-Correlation-Id: 1423b744-fa32-4726-c278-08d40c2e9bc4 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:CY4PR03MB2469; X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2469; 31:lFw/n8SM+JwcuW8WKwhdQDZqt0lRkrguEL2GD62k4Hnra55O7JC5KvwOlF3/q5AV22zXtQevK6PMa2HQ9OYVaczkPl6AUKvgB8zQO70DyYJEdTzPAtuj3UMGxw1U4GhGzsacXFAuthtUdNvD4wI4VRuIuCpEfnsW/ZzXDygrWk8wigIhjBP+0bGc2FBKDjXQjiMApQ6wzZEKXG3XAJqBAQeCGsvHKQLtPnHkQUoz/4IldUl8e4I/gnyyYz1Dm0ViP/DYZO21t0bWvm8xSVml5T6a0mcWUA95KNlJOiuC/gI=; 4:ljSBNDE4JTTyw+lX57lZLWGOu0nm3qPU7HQYcTKSiG3MzJ0EWI+o+4ExWYTr92Ibv6qoBKW3pMlewwqonhvs/UGqslUqe1K3WwvZMYEaHUbxZtnMNrayq3CFuw/p6Cgb0V38wgd/WzKGDxHgBaJZFAFPwT4SEg9ForbwfdExwNo6wOgM5wQDfqZuvAcOrRMYAL+kfOBhihqReGR4R84deaDWP6FxLWPcPy6dsVXP8kYUtr2LJ6BF9XB3DkGvxRvV4pz2SVbd6i1R4zAHDyXnC2XnMa/3h8ofMeOn2uB0TZRg6I9tna49YkMOfL5DOlahAaYYSu1vx2vb37mA46MrZMQ+1+0lRdGKMuCY/ueIYyQRbYLSg6ILuI+PBwSLyGdi4rNsWWuP3WXquzRFdzv9Yf8zCSJUxUjrFDnTjOgD4KpLkSqajblrSJhl5P/lUeVOsK5G9RLp4SIE2ngPhFkbnn9RECV+bCuGAJMkPKBPkswLxtN29PYvGhtgjlq4e3PYZ4Gt1w4kCKiyapUuoPxCkQ== 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)(8121501046)(5005006)(3002001)(10201501046)(6055026); SRVR:CY4PR03MB2469; BCL:0; PCL:0; RULEID:(400006); SRVR:CY4PR03MB2469; X-Forefront-PRVS: 0126A32F74 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY4PR03MB2469; 23:PUHsZgh1F/FQ5h3OQs1lh45ESAXWLvjdqQO2hQvbw?= =?us-ascii?Q?SkMVLQyv2/LJUkZJaD4jqOXAdz7aFiBzdvLNu+GjrBpZhPMr+MYWbUSVGm62?= =?us-ascii?Q?9dpFhT2kpPzBoLdwfCjBGITkCe0yO3tzZiPTh5hg6SgAzLVK8zds/6wWfuaG?= =?us-ascii?Q?dwaaOOVFstyQ2GycNvpNngzv9ARxr/K2ygZKDCm/OArVdJlx84rkCcdxweZu?= =?us-ascii?Q?+gTOU0bUa6mejgqNXKbYXQaSxfEoXqG/T3tEMGAVmmhpthSQ3f3GzLb5sS8b?= =?us-ascii?Q?dAaopYCGJwji6lcDDTRml6NufnB2qqyHzcGmqsgFbs1P4H+iW6NrtMIRA+H9?= =?us-ascii?Q?yX8PKMFIggnEuxxEjX7DlIZIyJz2eTzSfbl/+x/qy7DF5b6oMt4NiN3MCF0F?= =?us-ascii?Q?45WAAFNQa/1Hd/7rAiXqpN/PydlugXtbuPYoe0CWQWMeg/sgbW4fsU8eYEd9?= =?us-ascii?Q?zu8AQIV6+EVYdgFse/TYhsI4aHI6kjNSI4vjfV+mG3y1yufBRd735qse2gFt?= =?us-ascii?Q?UDNwAvQbguWfvEZ0lKhueDISUWeOzDu5BCUyLOvztTa9pRi7pgcMEZIq1lI/?= =?us-ascii?Q?UIJerTqNmnYLaAFATca2Zc11+7Y4wvwV/Bk3Lj593zKq8bdzmpn1XX8pC8P4?= =?us-ascii?Q?eJkp/fs/6aTaem95ukmuFQFVw7a3d68rGaWNUBV5rMKLNhpj8ScfV8xyBrYD?= =?us-ascii?Q?fYVQBi13Bl8PAp/elriHdx/m/GMjp9viU4Flox5R+xpp3HsHnv14Jbpyvofb?= =?us-ascii?Q?4SQSYxWhsKJT1hpqI929WCdqg4BZqTRjWKMuZLKopvchZLGEmPo138bVhOlL?= =?us-ascii?Q?45h6xwKm/vaWHWm3M97/lvKUaea2eJ5QkAF/MN3GocAI4HPixVpBarZu29MS?= =?us-ascii?Q?9T2/jJJjfq/GRllodHgAfoeO+Fpuim1NzAWV82g0ghquMR29nNef8FHGFlZm?= =?us-ascii?Q?xB8Wwqz41SLZpWY8lAVC1Cs2QRIVn4PGAuoU4CKL7mOSePVNMJZAfoyq5Wld?= =?us-ascii?Q?nAu3qOWWuSf4j3HTheohY8t0cULlT3GRa9uIQnqRqlqx8k8itJsBFUAkDzXw?= =?us-ascii?Q?MmciguCxVip/Cm1mLujohhqawL4xoA6cfXFSEGYzL8se7lCtZUMvJOi7U/gw?= =?us-ascii?Q?/41JEwldzrjkVznQzOabozM663WFslSn9z8/cijSQY3rJf+yx8Ki2z40PGJF?= =?us-ascii?Q?eyWVAV1i4XKk180fQZBYUJrGPZpYi6/M8f/Tl/DSmHru8LK8d/wrryQwA=3D?= =?us-ascii?Q?=3D?= X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2469; 6:SRNRrCsgYkXMDn/IueODNo7Ek15H2PFMKGfr5lfWg/bJvHZgoh1o6leViuyYO6Ad8vqBM0ks7Zo98nE6vooLtXOjmgbCkVuj5HXw9LPctrh10JoJgGrqesvvzxwfacgZ7vb2Kht0r5gK/4NrEv/3/Z/2WmyNIKuqxnAuEkDqI94CM6Gwx++zP13rWHmSkNmIKAH9x4FOAOAOS9/j6+sJL91iQqKOQcbIBAbGuOn7bqQfYaLNfy6cOLFMeFOOZFjJM3yS4Yxc2WVFaSAoB4x+/OvDqXNy7oFm3FSGZZEJqQc=; 5:bWAIaAFMAx//Cweff+pruqZrqzbDB/sJ1UKCdlaW/Rj/HBqgOOcrteM0QNJJmCq2KsYJfjNPATGcxBnCoyl9phGO/xnEIyfhEciB34ebkFrQxsnU6pyqj20EXFh5V3r4UJU8xaluFSgkzfDRftkBGH7+d+wirbV5DW7EF/SPmAnHc6Gokgzhc/TkvQM59RBn; 24:WHfXmeltQnn2EZXUE51drkq+d0vKXJPxzpzKqOpvW90OI5k4iUyKaJh+EgAjZJ0/9y2VyWfVSFslYKPANF0BI/E4IGkx+vFbGUtBmVVSEUU= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2469; 7:Y2aN4vh7Mrdz40XYI8YwJOLPdpDMfL0ykmXdPi69DLR9ubjg0sY36ylhdvd5EuTGrqU7kCww3OTH/tXuiJxumwEwG/c0qpcl0L5Az+lYHDjgZadnfqGGZ69jGpS3jtaN5FUqS0ECtsXLw3LpDAFhJTJeX1R+3TV9OPxuXqLU6NXr3n4pExUbo034UeDjep0ReH9A9RMfVVopTw+2t7e+1KLbQlLfAZtNVvHQAhO/3XK+FQzMEsKU5f8mREBlMiKODUgLuTV8jv8koU0o+EnIveZYMVkmC2NVfQsEtWtgqnIF3mZEKzJxVM/j+MiffbZ4+JdtaOxI8jK9Ck5RE19OoI8J3utSvAfpyCFu1HFLNlg= X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Nov 2016 01:36:08.4510 (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: CY4PR03MB2469 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20161113_173625_849886_58FDB930 X-CRM114-Status: GOOD ( 17.43 ) 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, mail@maciej.szmigiero.name, stephen.boyd@linaro.org, oscar@naiandei.net, heiko@sntech.de, pawel.moll@arm.com, linux-pm@vger.kernel.org, Peter Chen , s.hauer@pengutronix.de, linux-usb@vger.kernel.org, linux-kernel@vger.kernel.org, troy.kisky@boundarydevices.com, gary.bisson@boundarydevices.com, vaibhav.hiremath@linaro.org, stillcompiling@gmail.com, arnd@arndb.de, 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>; + }; + }; +};