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: 694312 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 3tHCmW2JrHz9sQw for ; Mon, 14 Nov 2016 12:36:43 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751636AbcKNBgS (ORCPT ); Sun, 13 Nov 2016 20:36:18 -0500 Received: from mail-sn1nam01on0063.outbound.protection.outlook.com ([104.47.32.63]:42761 "EHLO NAM01-SN1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751396AbcKNBgM (ORCPT ); Sun, 13 Nov 2016 20:36:12 -0500 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: , , , , , , , , CC: , , , , , , , , , , , , , , , , , , , , Peter Chen 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 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>; + }; + }; +};