From patchwork Sat Feb 11 01:27:12 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 726799 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 3vKvrH74Nwz9s7M for ; Sat, 11 Feb 2017 12:49:33 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752384AbdBKBta (ORCPT ); Fri, 10 Feb 2017 20:49:30 -0500 Received: from mail-by2nam03on0043.outbound.protection.outlook.com ([104.47.42.43]:38322 "EHLO NAM03-BY2-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751589AbdBKBt2 (ORCPT ); Fri, 10 Feb 2017 20:49:28 -0500 Received: from BY2PR03CA060.namprd03.prod.outlook.com (10.141.249.33) by BN1PR0301MB0721.namprd03.prod.outlook.com (10.160.78.140) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.874.12; Sat, 11 Feb 2017 01:46:57 +0000 Received: from BN1BFFO11FD006.protection.gbl (2a01:111:f400:7c10::1:103) by BY2PR03CA060.outlook.office365.com (2a01:111:e400:2c5d::33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.888.16 via Frontend Transport; Sat, 11 Feb 2017 01:46:56 +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 BN1BFFO11FD006.mail.protection.outlook.com (10.58.144.69) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.904.16 via Frontend Transport; Sat, 11 Feb 2017 01:46: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 v1B1kZwK001095; Fri, 10 Feb 2017 18:46:46 -0700 From: Peter Chen To: , , , , , , , , CC: , , , , , , , , , , , , , , , , , , , , , , , , Peter Chen Subject: [PATCH v13 01/12] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Sat, 11 Feb 2017 09:27:12 +0800 Message-ID: <1486776443-2280-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1486776443-2280-1-git-send-email-peter.chen@nxp.com> References: <1486776443-2280-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131312512164419199; (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)(39450400003)(39860400002)(39840400002)(39410400002)(39400400002)(39850400002)(39380400002)(2980300002)(1109001)(1110001)(339900001)(199003)(189002)(105606002)(33646002)(77096006)(6666003)(92566002)(106466001)(305945005)(39060400001)(38730400002)(8656002)(8676002)(81156014)(85426001)(5003940100001)(575784001)(36756003)(2201001)(356003)(7416002)(86362001)(7406005)(81166006)(189998001)(2171002)(47776003)(626004)(104016004)(8936002)(53936002)(5660300001)(76176999)(50986999)(4326007)(2906002)(2950100002)(48376002)(68736007)(54906002)(50466002)(97736004)(50226002)(41533002); DIR:OUT; SFP:1101; SCL:1; SRVR:BN1PR0301MB0721; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11FD006; 1:NgLNAP4ChOBssVojxK8iOAyiUjLa5kWB7d223+GDbkXRjsdmPf5jbA1JUS51GqpowWD/S7HACZy+RVMAs5M73Ii34CfncWbxOEdLkNxtxSSV2iZlLiAyDh7zKFrGReKVUpcb2aX+ikfCC43fCfnlmBMpZbkB7O0Hrw1lFk6XLtBHQkw94Z59lYKYFzKGLb7ZsHRRWNTNuKMdWuAkaFuRi8BaTsJe9TnUzbG95oElvU94nkeF5tWFa0DH156pOREfSBwpcxliwhCjpRsXGyL0C05qhae0DYHTVF+V4Ozlc6gHukayFo0I5iNfnTDF+g75zzALZ1qIN0h0vcV0jUcYnnXIToQ5oaRw8/CpHNuJd43hj2xexI/7zCQ0hGaCoLq6wq4XxOlejhR/g7ngHjMy8fo84ikI5FmyiGM7DFE1pjFZpp/2P5K+wXJvirAG7Kznat5aYzUPaWTBvghWqYJ8rNCHtmu5OkJzjjS1BgNHy3TLhF59OBig+3xp/YON0uo4Pd9NaSCYBpgTgWRhOA2CM3qBvirfGkzsX82G+AX+3lOv83Ch5GlFKElAuZofcshWVMUJ0kIeeHEd25nt0QdXNt+al03A2RAV2muUn8bIIx8WaN2SbN700Q65D5Gu64bIrnDak6cisfLGar+ixE/H0JXaeMW9QYWKrdANr0COrAbN3XWTiJRW3YPw6FaY5Gph3M3NNkc7Wpnq0fJO6Lc3f5RPbei66aZk/2xcv9n9T5exUG95SFNYp+5djkBkFHXi MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: b20a384a-f0ae-44d0-7520-08d4521fdc94 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:BN1PR0301MB0721; X-Microsoft-Exchange-Diagnostics: 1; BN1PR0301MB0721; 3:Kmheix8nzUIBQAznJUEdhy4uzpstDPrEonORbwIkxpZIyXax829VIGENWxH0qAEBqUAfWkTGiSeazIQ9JZhgg4mbdcfmPjTnsuHYd/+GuA8kVq0p7f0YqMfCV9uhRQBEOWKkLctVvSB+6UhOZ995ldoBblngTYVuKWrcPERJt7+RAs5lSONCz1jeqbdlhleHMID8X60pgPVFqMmjDEZNCy5dyTf0K+/dnZjRJ6oUgewboO7r+V+r/TWgMO7JcHOnwkyyMojw4Ob8lvmpLpuygzcPWX96wcSi8FyvBx4xykLVU787SRKw+mIzrixGlvHHOm6len33nN50HkhlKG7uzB2t2JJh6oiefWCOeMLn4uDJVKlpxRQL0HH0zDDmNMBB; 25:+hyMmATsj+xmyYTlWZsugCKHELr1zx3BziPTfIw+T5W2mkQv75FUlElVJ0gbwTEr07R4EyLjsKMOoaHovtbuVXiEVcgClzz9VDsw+M2LWfPTRGb9TYymEavDfMgTTpLj+wiNSyy+HwHwZE42OeKs26bZ4VIoDt7ItugJeUqrBegKSVCnUUw1CuUk0p9dNFvvdGWLMdPSuhd2JrF4axr5bHACZiqUK5StGhJL3QK7fz11Yy0j/osl20Yoce9QBlnkKr4zgxPi4hJA5BLhVpnLilPxl1ufuPWGqTDKnFqrDiS/BS1EKJdwddT9bI2mkPjcN6uwQtNFtNaFzeHhoqH1NyvUFjpYUDf14A6xnQsGfP9Bh3QIhaU58/TgdatSERL6RqLAW3xTemERR0Is6sobrhpQqbZeYl2k/JGZaOfJpmtHMgWfOYk3wihYdIyNYmO3 X-Microsoft-Exchange-Diagnostics: 1; BN1PR0301MB0721; 31:1E5r9xPqcmc/JT+4UcqHBXb5gt48dhUCoIbZJHr9/uocBIgvLIp2Tx8Z3pGp2jaW0knZrjJbNUi6xLbQWBPfXIPDwnCRx9IptXYR6n9O0wfux6OCb4/jLRlryazr9m7Td5PjOdNFKjheXrXftD2wfEhoYdr3wMntAKQ246E/O5JfbK3zZBi8Ex3QP11MhYjnAKEKJ+DH4TiwMukFZzsbE+4XV/3oE7qD1Oo2TMU+4C+tVlMk9k2nuFn1weoGUUti 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)(13015025)(13023025)(13017025)(13018025)(13024025)(8121501046)(5005006)(10201501046)(3002001)(6055026)(6096035)(20161123561025)(20161123559025)(20161123563025)(20161123565025)(20161123556025); SRVR:BN1PR0301MB0721; BCL:0; PCL:0; RULEID:(400006); SRVR:BN1PR0301MB0721; X-Microsoft-Exchange-Diagnostics: 1; BN1PR0301MB0721; 4:vYPfNOv62CKIgTxMUoDCPXjcXCsT11H1xLnxFzIP6QiNQC0nTYrHsaenlgGj17IXrBmzEp5NciCjkfaDb4jeDgN89elmcAisS9IUi9UgDf/3LoAfnn1KYPd+2tpTpRToqLOavEGfbYEkJmgPyfWS2jqQlcDnl45a2QShBV9wlJNlk9NY5drDFiYNo3KG1sCVAK6J8S6aSPT6lpyhCyackitU2Bi77qPOKtiqr8PakL4QPig/2NG6APbvwsLMNrVsK695q/cvdH6KDabtSQwlsUFWImC7HumAkGfMedRSoAZdrDCEsmJ90LiaT321wysPORD2kdQ9MZTHqAgK5D++94zzR56XCxhYY7rZEWybzAcbFONKa2EUcKy7flLV98vs8NiNfuHwCchfUymdAYafQtNZOW3xgfLZSAExV+jl7C4hsXEycsNB5zRHKxzpW9qJten0b5wsPgi3tUuFAGS5RSOZY+0cGubLKeAh3KCuzbWFkmBBrm96ltBi+vQrdfl/dF4XBQiZzcmaAtWRr0lU4GIyQWveDs7lnOCqHl4DBM2OzFGzEoN+Se8RqyL1eJaWnbPee2lywYronIwhEv7cPzCZRQT0FtIs5LfC+xkM8U93HTuwPnAQD9znUqsNuRy5XSl6thh6o012OLKP771eZP3plvtwKjTZcvZ6J7CjlBMcyTAvtze9abh8ra90tx8FFOYfXvkjVavf4Jr8sm06E5Bzw+2xfHz/joP79R7MmGc= X-Forefront-PRVS: 0215D7173F X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN1PR0301MB0721; 23:A2ZQgwwgLVsDYoN091AS2S0kyV0CLpRmU9YpZeI?= =?us-ascii?Q?ahSMUWNVd4yzdIZYXDVy2UT0zI8ySMA4zab2goGQqbqGX8bv7+yfH9kH5wX6?= =?us-ascii?Q?msIpAqGC6Ppn+UrOoBbOqLFoWsb8Q0cWKPh/aWs9b+Wm1QUpews/A+3QyKTP?= =?us-ascii?Q?G5fd1+cYigcYkxwpXx9JI3RkdxxjI0Nf3PxgXeleMCCWVFsr3xs2M17ufSur?= =?us-ascii?Q?Kh3Yqz0i7nDJZR63YGmziGNXtGuHz0IrsCTkCvHuXE9+ue9ol4/iJhYiD3G/?= =?us-ascii?Q?HhMkh9VdphTOOPTUX0/eeEAK/vRk4rWMV/NBE7Ak0m+CbIv7DN7WAUWgrvGO?= =?us-ascii?Q?vaDGmv84BjVU7LGZiB2brdV52nVh+9kQllzry5DMrC2X+NUsAHLaxiDMmlOG?= =?us-ascii?Q?Oahoi7WAA5hagxBz1ZuVrp5f1KyPHU2Zwx8ABR9MzCk9R8OM2jOOBlQkt0B6?= =?us-ascii?Q?HVuEvbbvWM0+vBAk20gbIGq74Orxpoor+DGmd0lW6WR5DT1jUcqouz3sLEt8?= =?us-ascii?Q?g94OBtfF41Ugazhwde1ev1daxjJKSusq2Pd+ZchY0O3Bnae2xPj8w9gtZtBC?= =?us-ascii?Q?kJ2rBjLPXI1B2DCfAsYc2ji0QYn4Tg1l6VXKwajTEx46gU8Y9ei/wocMHO11?= =?us-ascii?Q?mPL586ZbCkzxPw8FXa0HL0fjGi256ORvIT4y/o8uEtitT8yvpulXFLxy9LCL?= =?us-ascii?Q?BxGvA5t198zTkIS8SIikGdI37YqwEfRxrukJUQ7Au3AJXYMu4xTesITjkub/?= =?us-ascii?Q?7UXKPFyKNwPkxx+WOXQVF2O6eAACyeIdanDHqpFIxQWPrOwbSjPOYDDU9sTp?= =?us-ascii?Q?hG49bI9YLdqHIljCbddinQIKKKLKbrS9SM4anBBiJEPDqafVVcDvMs0WoMMA?= =?us-ascii?Q?owlw06kjT8lyCq5LtBgLUbKi6PXpm3ecKIRBOrLf7hmKubg4Y+pa5bhyeFlL?= =?us-ascii?Q?1IDbx9qikxlCHdEH233T44EZkytuEmpe8jsChkd7URw7u4OvzfrioqJVrfzX?= =?us-ascii?Q?df6/b2eHv2zrAguWaurZj6rvP3SCwCv8pxl3fTtTroV+G0UW4//MLj5Seeve?= =?us-ascii?Q?a3hu7s9y9Io7TDeJmPvABjUSe8D4VpRAse23hvs0Vp7uglgr2Dz3/sC3833a?= =?us-ascii?Q?b5CSYiw3dZZyo8xEOj+lc7OhQtYwr/WvJmLcc3RbG0Xi2sYfvSuMsTjydfYT?= =?us-ascii?Q?4Xk/QxdyNHhAPGoeppSxJnde10D5DnGBHW2trAcMHhx9GeM54aF33JUCanqk?= =?us-ascii?Q?IE2OX2JbEQDd9GH0dSquG5OvmYMn6N1URXKbE4df+VZieS/T9EFbtezTca4H?= =?us-ascii?Q?gcw8AXbrN309ED2hTP0s35r1LQnKHjnrEXoj9HvIK09LU1X0LYR8LApp2OmA?= =?us-ascii?Q?YzfkAClCT2Jk4JgudaUTdECQ0KJguVdCSsLcxpINMNe6c6w7u?= X-Microsoft-Exchange-Diagnostics: 1; BN1PR0301MB0721; 6:jZJCKWQ0Fl8UdN4wc8Y+gTpJO1QyOEP/eEyWzBdsnFr6QoNbeGR12D+FmMQhG+Lq+aU7daRR+8NqTHQD/KORJPgXkz0P1wOv8ocImu2U2gNG6cmfSKJRUvvdVbpH/I2mXNTdCZ4tH9zE9y3JpT82+/f7OzLTJah47WmcSZmfdOzCzmDmUNl9YGp2dXdAS78GebZOHMCd4gW4LqleTouyXCtlGbk+bTB1KVAs02DfDc+5z7EUQ2M9H2W1ns5rjmvRH+BMAcdhIcAIpTwwWNe5AglYIfjoc15+MwQkZY3QUeDympsG6627Etr+j+OfK5soJoHSYBfKszGw9QVrAyP5EwYUlH8B9bwbJbRHDMR6Dz/3XtU7t8v1ZlOBNxIbW8MegJifBYGAC7JfyrWlXgTfwk70Ef6q3i7k29lgB7uUPVwoaUBMfaD81JGzag8jASgp; 5:gq84ZCMNii7EkOylqb36frA0W+IvTZajm35LMxnQpsUdUYAbvjHmrpydJLpfdvt2RSjWIIkT5iiCTVef+Qtzcsk4PqyVXRjdRmhjvhoQm4BbM/ok9rl+IaCWycNs6EawVcvqctN0qvMzP6ucx0oVjs949/+3IFgpHJJVpTQxhJEhyG7xCtnyva4Ngp2S4Gg9; 24:3yvUgngusWJZf1Lu1X0/dRxCFDW2ET+/WIXHx3u5rzFbjp94cRuUzwKBHCDFEKQStfL/QC3sTj4LtWPbZB7sjORZ7H006pu+700owoeRjRo= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; BN1PR0301MB0721; 7:cdTJ6KAkgGpEAc7Z9gb5ntlSsP98RBbvwhGYgz6SL7r4NfStseDhUMSJ4FHvOpcjhFg6GO3p52V2qxYfZ7jWnhr9tiLECnvXazFj7fR6AVyUpcbXcUkZmnNZO78gOMstKNwRgxQZCAKPuWQdkhArEw1HfZj19Wl6BCWZKxXFdSuWVN6KALpiXm4WZI+Dio2eZPf3ZsbvagdVeQcH4jQEmgFlbwRJgZaFrZDTgsI5K/A5GKR4J/LpBbhmjuJl2XBQhEdsNnSLEyblyHbb2ssOfCzPiXPd+Ly53CjbwL6Or9WjI+QckOmDVMEUcQrJ7ydJsI5XDOmRPNmi2MakO1L9MloeRIkVBT4cXr29x/5xPfPdd5Mx60mzxXiw7d0VFgrq//xe/U/T02YqCg18PLTRqGg49qHrPE8YYjLeCjajFDYXUjie/0VgdH1mcGAC+wfOAPzDxvqsd7T5QXMnYu+X854iZ2cHYb/uuEKmfczX8EOc/Dqj6QgV3FU1pTv2vweZ/s4XGV64tInGT9po9CigpKCU3lhtl+GHlMkZ9xqzIWAm3aK6yGXLDLHA6lvXfKBK X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Feb 2017 01:46:55.9427 (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: BN1PR0301MB0721 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>; + }; + }; +};