From patchwork Fri Jun 17 10:09:21 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 9183277 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 923426075F for ; Fri, 17 Jun 2016 10:20:32 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 7E7151FF60 for ; Fri, 17 Jun 2016 10:20:32 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 729BE28399; Fri, 17 Jun 2016 10:20:32 +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=ham 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 87D561FF60 for ; Fri, 17 Jun 2016 10:20:30 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1bDqri-0000EM-2a; Fri, 17 Jun 2016 10:19:06 +0000 Received: from mail-bl2on0086.outbound.protection.outlook.com ([65.55.169.86] helo=na01-bl2-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1bDqpk-00069s-5M for linux-arm-kernel@lists.infradead.org; Fri, 17 Jun 2016 10:17:05 +0000 Received: from BY2PR03CA063.namprd03.prod.outlook.com (10.141.249.36) by BY2PR0301MB1623.namprd03.prod.outlook.com (10.163.28.29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.517.8; Fri, 17 Jun 2016 10:16:42 +0000 Received: from BY2FFO11FD004.protection.gbl (2a01:111:f400:7c0c::119) by BY2PR03CA063.outlook.office365.com (2a01:111:e400:2c5d::36) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.517.8 via Frontend Transport; Fri, 17 Jun 2016 10:16:42 +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=none 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 BY2FFO11FD004.mail.protection.outlook.com (10.1.14.158) with Microsoft SMTP Server (TLS) id 15.1.511.7 via Frontend Transport; Fri, 17 Jun 2016 10:16:41 +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 u5HAFbSu029984; Fri, 17 Jun 2016 03:16:34 -0700 From: Peter Chen To: , , , , , Subject: [PATCH 08/12] doc: binding: pwrseq-usb-generic: add binding doc for generic usb power sequence driver Date: Fri, 17 Jun 2016 18:09:21 +0800 Message-ID: <1466158165-9380-9-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1466158165-9380-1-git-send-email-peter.chen@nxp.com> References: <1466158165-9380-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131106322019583007; (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)(199003)(189002)(19580395003)(76176999)(8676002)(47776003)(229853001)(586003)(105606002)(87936001)(106466001)(92566002)(11100500001)(2906002)(230783001)(2171001)(85426001)(81156014)(33646002)(4326007)(81166006)(36756003)(5001770100001)(86362001)(19580405001)(5003940100001)(50466002)(97736004)(2201001)(50986999)(50226002)(356003)(5008740100001)(6806005)(104016004)(68736007)(2950100001)(8666005)(48376002)(189998001)(8936002)(77096005)(41533002)(7059030); DIR:OUT; SFP:1101; SCL:1; SRVR:BY2PR0301MB1623; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; A:1; MX:1; CAT:NONE; LANG:en; CAT:NONE; X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11FD004; 1:6Bk/EG2zjXapn6CZ+FBT/QMzgrnluewF37LnqUqjpStoSm3Rq/BX6NFmrNrvcp+iEmwVH9g/sm37NMXC+FrqCvQ+cIInHfxUTF5JNyaQeHB6siCqOjiMZp4qd4pCYYUkdeBS0XKITpKCygSut3vBnOW/md7LsaSaTzWJ+4Ok1fJZgGMYwqxSMxvodmP8GxcluyZu8MhYA0nSNNnqt5CMNbYqe/7txx98IejLhsDKGSszZW7BH/eWzD8c+JdnschvuFk6YrJd9m1BgQlpfNoC2j5v9oGP/PnOMNDoNOqBbCnxfaZk37cukLimjxozgao90yVBkIomKLjiViQSmfTTuD8mazAL62PPQPrgpVoZDh69UhLp1fvK6KjwzcJTjiGNPXzc4hny0/xF38HgSbr+uwLq3e01CW13Tb5DpO/UlOhKZaJiGk8itzDg/cnGMh9hqc0j0vphmKgKJVvXpsBcQPbATRzagyls+VxksHAGMhSg9SMjynOvskwOg9Rxd+GHEVb3fNPAgGTJmq2VkZk6dpO6FHIsN19tTjxLMVr8mZ5EIb/XnpY6Va+7WycF8b1pHdn581ysqsiYovrV/t7BYu7GiULR8IWvlFO6p+oUlUpeljcuUmJIZpCfi2nbmzfrZWbX//3M1qKI3DBfUQMmuBFpYlERNiHhV3m4Aw89ijvP6PuDK5JuaNsG9g6wAdohEa5SxfZ0mBQapnpdChmsfEszbK0Dkb5+hUfHMYoVYOk= MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 72145550-8278-48d8-041f-08d396987a40 X-Microsoft-Exchange-Diagnostics: 1; BY2PR0301MB1623; 2:DB6uARMFZIM2RE8p6GeIWVpdNFVnJkVRwfxXbxCJtNi6rels8xQIxHlddL3T0Fmj1y0sxtDo4dl1rRWcLK8UEABcyQqmThKwdi4+cKo6RTfxmDvLGH7T3o52OHKKSNVD3DHgsDvAoz2QPqyTcSjkbNbp1XY1fUF4zsX3khNLfGEx1QY0o6x83UbeG/uOweL+; 3:kT5V5qrj3ZPQOnKru48DnXhBWgijj5CRHANddWgN8rYNbet05AM5IQAmXJre5jVjkAWnu3OZlqwUYNj2gOvZyNU5FU3b3pLOjjgnS0NknUlqiLt2LIFWpCjdqZ4JjbRkMZfOHvIvGn5HUraKGjeUU3e4qomA2ku2wD75mJO3ik4BCNrZfEWY49N2b1ENV4wTsXWSaNXPZWB7nixTJlgdfa2eop2m/jQVOyGdEcEaLeQ=; 25:kjv8McBsrslNwv3hCo4byGOjGWA5DnE9fckhzM6oyTbt7uW+vXvJ3ntmWKlEkc+jM4mIbf6dFWkpnhYWjk4zNwmvladJ2k6R1ARuiZzBtM5nkcLq7fRjSnxE2yiKX+zVzkgFVzoTgfQaOa+IfWYDx03Yp74xiYn7hMt36v+gPqlvq13Jhb30oYn+hG7X1uOpLRLbtWfrQNLsBd5Bgj7S13TCKyn9KJUk7K0j7b+g3uLRyfFtjVrw1OgISDf/Z1xKD/k3OsREUjq1Kb5Y2wyGUlYgBtOnGSWmg78MOQbxfzD01ZxdjFBt17EHxWbbv4X2rFK2KP2Pu68RJwnckjg12O3RObzzJUS0FXG+/2fyqeVZiwTmpVIbApInR/3VMEejPevNJD8Zzwo02oRCbuR0wauTlpxOxrECbdPFplETmlI= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BY2PR0301MB1623; 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)(5005006)(13015025)(13017025)(13023025)(13018025)(13024025)(10201501046)(3002001)(6055026); SRVR:BY2PR0301MB1623; BCL:0; PCL:0; RULEID:(400006); SRVR:BY2PR0301MB1623; X-Microsoft-Exchange-Diagnostics: 1; BY2PR0301MB1623; 4:Po1QF5uIqVTTyOzKN5eXhFG3mocgUK4f31atQ5Ub7VzjcQXUqlJaTKCCUKT9yEE0Qvw+C3B/GDlDUzjrwSqEag7EegG9aGPtNKNO6vfIrzzYaeM/vm8A9rBlRIW/ZsjpPIOdQ70OM3HJwViUQ0itX7MzqzHdGX8KWuQaKvsJ59MwLpCg6jU8o/ETCF9X46wgviSnoVVxRIQSQe2xaVWfOSveEbN9ROIHki8C4ewc/qhh026oD1zw3fCnSmwE104KA+uQevR6f4iVCJSwxTpDXhAJgBJhraHVlOiZgW8pIt4R6XZqXtxuzUnF3UbABGq9qxR8YVR5nl6Vr9w03QjEo3FQQ+6EYFlxHRrj/0AeVbOWTUaiZyXoD/B1b8O3As+qL4dn/6y2iJvr6FlGA4c4p6YxcLr5bzX2vamz1UVw42cLipSr3pqsWxJpqlD0i2YErpf6PzswRIiv+3ttqc3x04igMRUaZLSD9BuG9mEnNV5svX1rKAcH0Ufjcrn5+D58YLT9htXCyT704ecy60yS4A== X-Forefront-PRVS: 09760A0505 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BY2PR0301MB1623; 23:6k6gfW/ISHgqiW5MKF/rX2cdRdi1efgDDkGpEbF?= =?us-ascii?Q?PprD15UssgB+kC6osAuAYsTN6fLdF8F2abOCai2J6nUZh0qw3x+B818KH0LN?= =?us-ascii?Q?4Vd/mZb2yeHLPDYqFx/NL785UAC1FvXnwJXVzGJOIlAlN6StEBvbHFk4mGDK?= =?us-ascii?Q?fL+vZwfNIpwnEKDEgVNzaVNhy8jeLZcjoVphEZQt1Ex4FDreFfR+MBR0hnxA?= =?us-ascii?Q?1buRbWKzabcov5ylb7omVYmHiDanasqAhJpoIrE2NXr2VAwbOOEmCUINq0zf?= =?us-ascii?Q?h9wZ22GFuFfvmzAutrAoAOp4xAN5rxIiLJhhGDT8eV977gg34LJqxiZam//o?= =?us-ascii?Q?zVLUleAPJXQ6kHVoNlRxXeOScNmwQ8sAAbYrnzWiJHqgwJloVCwJcF5qsmAs?= =?us-ascii?Q?+hpzVTibMFMe8qQA0n+xWAAwnubAqaJHm+dfH2vBzr5cIlUSIwVihcu8wiQJ?= =?us-ascii?Q?CAx44bjHWdRYj/WL8Jkl4yekO4uUXOBhuDlmxdkfcj5EAcgG4daUpH0VjpBb?= =?us-ascii?Q?83DTwh2/6zcVUn7PlnBfSNE1mHkW4Bt2W2WjZJwJtW5jEW1IboJioOuhVMLI?= =?us-ascii?Q?vcqcZFk/GAMkbwXl1XUooudT6K4oJp9RNw4wzSqQJyfbBe9wJesk4w7SupTt?= =?us-ascii?Q?2JPdy6hJWFdN00amzat6+J/RdePs6+T9KK7zTyUFLRbSBe6aZ/apIotrO1Zf?= =?us-ascii?Q?Ado321ws0Q0nulyWVedoMOwHPrI5W7mOm04o2gg/QtNSmUvby63//LN/V0ob?= =?us-ascii?Q?ariWOXYgFzOjXqtDsCS9Mqm2UC1B4lQ0qGKKBUmCPJsZeQWfBABBH0lnGCx3?= =?us-ascii?Q?FKHDP0vSsB5Lw0dzZxmnzbcg51intxE4mdub5vJM5gKLfh5M76TZRw7lfWfK?= =?us-ascii?Q?HNwUx4eQRfDWVUIm6kqrZLXnw/q1C87jFx18HhatUqWyM/nYVqxNRrjtOONN?= =?us-ascii?Q?r2nF/wVFUyIG6AhjpAS7fsRxL20CEhI7HzqxfJMR4du5QiSJjgWHiIWaJj8G?= =?us-ascii?Q?/rH13uIF07HF7Jt9pNacHEan/gIxIFr3uJkAFVl3dl8tbxscBdVbf53n2hqr?= =?us-ascii?Q?Ds0qltPi2p1uksDofSonOXFIJPq25re89IARPfPUAkEYOZdRBe2fqzsV3H+q?= =?us-ascii?Q?iX9uusy6IVw1u23UA1NV+i3tIi+BQ5vk4YDAOEnESyE8dtzkcVbnNK2qdd2N?= =?us-ascii?Q?1fd/FSMdUuk96W5+20EvHlz8G1LH4YLeI3+nM/58tFBIeT2g7lVdX0yVPjEy?= =?us-ascii?Q?9TtjMqa3MkYawD8KsBpI=3D?= X-Microsoft-Exchange-Diagnostics: 1; BY2PR0301MB1623; 6:Nt6WGYRCxScqyhhlcxaefl2PVddMn4EcYqVOp0dDOrpWq/NZEjMI0h8USzcnEW+15Ufs/9RfG4yNa5BXJf+ljwsOzl5V9TcV/tsjz/Vuf+0X6/+9wjffWkNneB2luafQ9mjkdmsxgTIy9n8FJxtizYy4HXG3MrgrADdWMVd2QhiOWqfQlCw3ftwnLe69sa6LBcFgjxLY+ou1aHrmE8hf10f3YhajOJfePM7V1JwMkyNInZgOWxVuMcX2IzQd243dJJK5vEdqGxfq+crijLpxXxtXgEbueC6bfPReNAYp+8M=; 5:F1hSC/RtLnFGJC+wPgR7D8wF5rD/mTrthMNiidrChkCjcLvwW300z6n+LwNL3FA6sRcYOfs/1FkCuwzBRvDRVkQmmaQy0mi6bprPTgSt2c8fS3tFJDkuD2dCjJqaaKZNeKEqokdCvJeBdz2pvd3snaZWTcLr3FwhhotSdKAU6zQ=; 24:OeTdn1HSK74uFqjPAmWZNDWVOhQ+K2xbqdVE7YIdEkXHbR9tjd5pTUe/ehRN+8vvUJFkTAjJJAM0Ef8PbpW7sFVrmhjwn2Wr8cUtF4HxHOc=; 7:2ov0wqomsJhoP+cGjLnExYk9aF0cnQdA6FKV68iAXSzz1+xjpRbnfwRay+zu9eUaTkcToLmgW6gQHCjWH4Xmftkt+qof0llMvsg2ddfp7krYBaMRyhr8F5PFAEcBxkk7ax7RTu6ON2WMtDK+xwbHyna/UhEMkEdx6sOImgHAaFxuMO4roCc3LIDBCD0PV4VHbqfTaRIZQEddpbEzQQyoNg== SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Jun 2016 10:16:41.6931 (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: BY2PR0301MB1623 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160617_031704_621563_7DC98401 X-CRM114-Status: GOOD ( 16.97 ) 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, s.hauer@pengutronix.de, linux-usb@vger.kernel.org, linux-mmc@vger.kernel.org, mail@maciej.szmigiero.name, troy.kisky@boundarydevices.com, javier@osg.samsung.com, Peter Chen , p.zabel@pengutronix.de, festevam@gmail.com, 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 usb power sequence driver, and update generic usb device binding-doc accordingly. Signed-off-by: Peter Chen --- .../bindings/power/pwrseq/pwrseq-usb-generic.txt | 31 ++++++++++++++++++++++ .../devicetree/bindings/usb/usb-device.txt | 2 ++ 2 files changed, 33 insertions(+) create mode 100644 Documentation/devicetree/bindings/power/pwrseq/pwrseq-usb-generic.txt diff --git a/Documentation/devicetree/bindings/power/pwrseq/pwrseq-usb-generic.txt b/Documentation/devicetree/bindings/power/pwrseq/pwrseq-usb-generic.txt new file mode 100644 index 0000000..8ad98382 --- /dev/null +++ b/Documentation/devicetree/bindings/power/pwrseq/pwrseq-usb-generic.txt @@ -0,0 +1,31 @@ +The power sequence for generic USB Devices + +Some hard-wired USB devices need to do power sequence to let the +device work normally, the typical power sequence like: enable USB +PHY clock, toggle reset pin, etc. But current Linux USB driver +lacks of such code to do it, it may cause some hard-wired USB 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 USB +bus. + +Required properties: +- compatible : contains "usb-pwrseq-generic". + +Optional properties: +- clocks: the input clock for USB device. +- clock-frequency: the frequency for device's clock. +- reset-gpios: Should specify the GPIO for reset. +- reset-duration-us: the duration in microsecond for assert reset signal. +- enable-gpios: Should specify the GPIO for enable. +- power-supply: The regulator of the power + +Example: + +usb2415_pwrseq: usb2415_pwrseq { + compatible = "usb-pwrseq-generic"; + clocks = <&clks IMX6QDL_CLK_CKO>; + reset-gpios = <&gpio7 12 GPIO_ACTIVE_LOW>; + reset-duration-us = <3000>; + enable-gpios = <&gpio7 11 GPIO_ACTIVE_LOW>; + power-supply = <®_usb_power>; +}; diff --git a/Documentation/devicetree/bindings/usb/usb-device.txt b/Documentation/devicetree/bindings/usb/usb-device.txt index 1c35e7b..4c8a25e 100644 --- a/Documentation/devicetree/bindings/usb/usb-device.txt +++ b/Documentation/devicetree/bindings/usb/usb-device.txt @@ -12,6 +12,7 @@ Required properties: for usbVID,PID. - reg: the port number which this device is connecting to, the range is 1-31. +- usb-pwrseq: phandle for power sequence. Example: @@ -24,5 +25,6 @@ Example: hub: genesys@1 { compatible = "usb5e3,608"; reg = <1>; + usb-pwrseq = <&usb_genesys_pwrseq>; }; }