From patchwork Mon Aug 8 08:52:06 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 9267147 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 8E70460871 for ; Mon, 8 Aug 2016 09:04:32 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 7CA1127FA4 for ; Mon, 8 Aug 2016 09:04:32 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 7123C27FAC; Mon, 8 Aug 2016 09:04: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=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 EB83627FA9 for ; Mon, 8 Aug 2016 09:04:31 +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 1bWgSd-0006kQ-Hu; Mon, 08 Aug 2016 09:03:03 +0000 Received: from mail-co1nam03on0066.outbound.protection.outlook.com ([104.47.40.66] helo=NAM03-CO1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.85_2 #1 (Red Hat Linux)) id 1bWgRo-00067X-7f for linux-arm-kernel@lists.infradead.org; Mon, 08 Aug 2016 09:02:15 +0000 Received: from BN3PR0301CA0031.namprd03.prod.outlook.com (10.160.180.169) by SN1PR0301MB2062.namprd03.prod.outlook.com (10.163.227.149) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.549.15; Mon, 8 Aug 2016 09:01:31 +0000 Received: from BN1AFFO11FD022.protection.gbl (2a01:111:f400:7c10::195) by BN3PR0301CA0031.outlook.office365.com (2a01:111:e400:4000::41) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA_P384) id 15.1.549.15 via Frontend Transport; Mon, 8 Aug 2016 09:01:31 +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 BN1AFFO11FD022.mail.protection.outlook.com (10.58.52.82) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.557.8 via Frontend Transport; Mon, 8 Aug 2016 09:01:32 +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 u7891D1q013331; Mon, 8 Aug 2016 02:01:24 -0700 From: Peter Chen To: , , , , , , , , Subject: [PATCH v5 1/6] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Mon, 8 Aug 2016 16:52:06 +0800 Message-ID: <1470646331-23227-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1470646331-23227-1-git-send-email-peter.chen@nxp.com> References: <1470646331-23227-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131151204924288565; (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)(1109001)(1110001)(339900001)(199003)(189002)(229853001)(2906002)(50466002)(4326007)(106466001)(68736007)(2171001)(575784001)(77096005)(86362001)(33646002)(2950100001)(2201001)(5001770100001)(105606002)(189998001)(92566002)(97736004)(8666005)(48376002)(87936001)(47776003)(50226002)(586003)(19580405001)(19580395003)(104016004)(50986999)(356003)(8676002)(5003940100001)(8936002)(305945005)(81156014)(85426001)(7416002)(7846002)(76176999)(11100500001)(36756003)(81166006)(7059030)(41533002)(2101003); DIR:OUT; SFP:1101; SCL:1; SRVR:SN1PR0301MB2062; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BN1AFFO11FD022; 1:0Gef9AsTaSDs26T/BNYEn5XXY/mnFVOtWnVakkPvU3dk1XW2U8krFodHi6VNwdxwgus/Jv3GcY+17LBQZpGv+bb4O+P+jil0l6JIb84u6n7+W1Bh972X1+QmeyElNSH0DNu0gh+/pHy/HYG9Nn1EUBSNzFD9orS0ROSVDaZwJRhMhbLW+4Cjs7TeyGsY+cGv0Cw7tcHgauqxKDW8U4a2RdztMCwHuZS/IlW3RsZEaQzeFvmywAt1jbPngzkQ0scjgXw8mlSn7clpNvcTl0I5RRfPd7BbesnVLWRwmgyqGNws968CfaSTuE+iylJglB9R/6wQUdrfbvTv5SsG01UndbFJx4V+/8DpVYS3L8gG5+QAAxKLDtSARFQcNGf3UliNRiDy2QJ/zjvQF57er73F1f8cFz8WjhCmoyA0UpGTpSbsyfYrIlmMHplpWVKulS1prqNlnA1TvjrRZpTYaYJivWwfLvK5OtbV0YzAiwJuLWN1x7z8VjnPpw+wRHx5tIweOAZsZgIEVTFgT3DYmh3n+CzpGT5tpEabK/pXTtSDwwGpo0EhBF3G9VLutuHRrnLDYgB1NR2UaBSPu7nvlb2v0S7yBWt4Jgr06B4iWC39b06y02+Gb2ivNtC+LLG3uLSb6BhrOn+m6SBt+VFMHr4vIYhiOaWknoNjE9f6A02R1AJJdEfCO8L2va5aY3VcaFo3aRT4uHhUj2vk3WHcsRWP7ONHXmhWz/eBBDKLAbhs1H5WKjW5v6pMYhyc3LVhu02M MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 61df5208-61e7-4409-6e35-08d3bf6a97d7 X-Microsoft-Exchange-Diagnostics: 1; SN1PR0301MB2062; 2:zRuurdQd7oCrkOAfhMk+Yh+adFdnb6jhCzCpMbrwv2GM8GAOQboE8UmRwTskAUO+TCSf2MJcvkBdoxeZqflhvN1YWk/nie8XE5focG1TvQSkmSFMD8Aa9y+okiIRUwxvGZaEBOaCPmhymHHxp6zcWUvK0/q0i2F2WRPcagM1BA16SFeInndlsf4UALzid3tD; 3:WP1LC2Aun+U+4heq2cFX64S4vSlRFCI3N2nSVjkN2QZlRaAZcj6XM4+dVJQbOxpiMNPsNClaut120hWuTBKDE4bXvwMZKZEcI3C5LXvImJgumuvduApTzSr+mQ8EU8/+0xpi+6E9njFVGCtj30l58BlbTeQj8W6FchE/+SXztLu5ViTmxwjkn2ckGs5ePdGzyl/Neiw1YaDM7m1BwmQOZfXsHFpZmJNqyZJZL1qxqh0= X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:SN1PR0301MB2062; X-Microsoft-Exchange-Diagnostics: 1; SN1PR0301MB2062; 25:bQsUrUglCDPZGprVWoeVJKsW0wa5qVDCFtMlf7FxSGWiw6y7yperp+zwRFLydEjAAgn442MKpkCK68WEbHLa39mCD68fm3WEtf3c7niYP2THF9fJ6B9OS23dTc4SCDrLF7sTFal3gTXJ0u53dvApMSO1q0tTlGKnkPn9MBuD7Iz2x2Ss0cLUUGscL3wNZXIOvoh+SMe16RTufSlacwgPBBlRS1FjeoNkBUrWhvW0PaioVKsZ3x6A96m9jH57UZncLHmK1/EnDdF0LFbYMK3pdqH2Wwr/RkfhB1qXLFvymBg4BlE8JGixx2M+tBdDJ4D9PMyMJY73SNVf+8970ukIS8e0h15RK5fGg9ajkAldroqiaBKs62WyKnA6VIKCfnaw4psXt3e4m8eK4uwsTxKbmXEe2EJKOlLIA3ViydcOUABZw7ZlOUobp53D2JFyIZdP2EOCfev3HGqozjbFl+Z0mxgYlcZsGxYBu/oMa66afZKewZl1kNM+o2BvZPVMZRdV7UymAuxDPgaEUvghTrpv51EphcGT+oYcCFO7PkJ0kzeTyRrtrbQEES3VKBVlT6B0ziuP/sYm+3qwiONzGOOY1Gw+DkwGQDXokIPWkB1dUSJaedM60dvQizGegPesqr1NgZrejZ9Y8xiD4LUOJeiK1ut9KXa0DtSpAUdNLiBtgmHCg5zKuqVI3Xj67t4BjAFasA0q9STWHufmVrPdLy4ia7Q6XZFDSQXtZR90TF5synymn1HqwkNwcCC7P3q34J3x X-Microsoft-Exchange-Diagnostics: 1; SN1PR0301MB2062; 31:/x6UkEy2ExQ1kudSLSuc9bl8PnmRHfcDDybRkcvmox+atJ1pgwCvV4cnJXGDVMG9c2qTbnkQFi5AC32zYHx8Rp6zwqDvXaIyn02hIt3kmXliLU3VAlZ6NegT6BvS/r0e8MMVppTeaEHX/Pm1gFlhm6eftZdDQxPGbXzkpmTyWG9Y5Y6xcuUstSec9Ta+XgJVHCIuvEpyuSI2luBLKQ+2XNDN59zGS65xVyXULUZV5gQ=; 4:o0WYjmc5QT/ZqeuYA+tl49FfFC/dsp27C5GOPCDO5b8PYFGRTL3k5rkuCfYwczMK7MMcJ02zzkRzjc3JujoACcV9TNZksVdv1wwJIDR59MLnHfbue/bj0z4Var60gHnip71mVa3h0Tb26X7y6dvsfyjPY10i7tq7+oiuR7bkI4nZi44zi5IpzjtQ9apCekmLlDCyxWSuATuFNXc2q3AIwypmWHlpCDkD/Vzxv0gJb+e38rHQXOL8L/McDKmT6Fle8CA02NT2tPo2OyAV7kk5a7SzyuiRaEUHtFYOsECs7JJN6bQCdKch9piON2imsC2sDeSwWKQB6gfloDdlpjR1zjWnIsctHW96tlH1upv3OAoluQ/ywCoeG3NnKVOIobPkjZdIZ3TL7a8ZN7G0ls1g905BZX/tf36kYMvHHTX+VQzsEoVzHgxIwRyjcoUwy7M9xqK2FCm4v96ezee7OGsQv9LP1g2bwb7mdoG1wbS6fZ0jRX4POCacxfx/g1hgM8cKUTSbBIC10dMvRUhCZgh0Vg== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(2401047)(13023025)(13024025)(13015025)(13018025)(13017025)(5005006)(8121501046)(3002001)(10201501046)(6055026); SRVR:SN1PR0301MB2062; BCL:0; PCL:0; RULEID:(400006); SRVR:SN1PR0301MB2062; X-Forefront-PRVS: 00286C0CA6 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; SN1PR0301MB2062; 23:qt7j9Mzlg+IIMewFR3OvddK+aCu+JoRmCgsd7Wd?= =?us-ascii?Q?kThyepJzMyLTYFa3ikl1t89CV3jZ3l0ZpF6ohG/9QzT+wKVaCKevb6Upi5jd?= =?us-ascii?Q?a0ku7rJCuR5v6WUCC11ZuwytoBQ/Uy60jwh7iV3CmVaos03WR6Y4omkloEc6?= =?us-ascii?Q?6wEBbXJyAHt+oaKV1aldQu1wl4NXWG5krSY9qla+klqOoPbzbjZV6YtpOdpZ?= =?us-ascii?Q?0fmoxmkvjpUOu02d25m2+il8FLLKZbmoabBnBYafkyRh9Z0Tf9uFfo0Xnq9a?= =?us-ascii?Q?7bnEUFZDx7vygWyHGd1mDPwB4MDx/H0QQ6yiaYm8DHRBQty10xVlZv97yp1z?= =?us-ascii?Q?mA/K0+7As8bouLvxfqaV5WykiETEEOuGxA5L0mdpaX8WczKx5+gW10BSI0lG?= =?us-ascii?Q?cDzmMveVG9R0luuY7b6CworttfyP+5p0lK1VEHGN11JVhs0lXA/aWO0g8Z4a?= =?us-ascii?Q?80MHloTOdWFi8ccqpmKRGCG6qcmJqIi14AuXRXUMKRuY39xIwH8M5VzfkwOx?= =?us-ascii?Q?0cXWzdbV6uuI8pdGuTMWlapzoP0rH7Q8xwW4k5e3Ka06yZbuchpVN0N8wfD+?= =?us-ascii?Q?1IBY8JvscSbahFEgEHq6fnJ2P8/YhewKxpDV2NzrRTd2SddsbK6gUZVVESxu?= =?us-ascii?Q?DDEGctD15RJQWhafTjo8CxN7DXG3YXO8kEzD3CVaGKyUUkrmgudi7g/62YU2?= =?us-ascii?Q?gUetkPOnBlzTTo6fVG6L8fmTl4dJmRBHHnsSnh5rWtqw/+Le9Dh240XSyr/s?= =?us-ascii?Q?xg1nI4YE8G7dm3tmixK9KRWZf8CxUZQGSqrpZP/myObrJL62etfC7P979tzO?= =?us-ascii?Q?XQhNk1J92rDvbouL2mbjTfFZeXHTU+ckDP4utTLkeStIcUnD180KViTAsbyk?= =?us-ascii?Q?lxKdIlXlw86HzGZEq4xO7pF80UH2K2tvdn8Brszsx5hwHLU4Zv9MvUk0Q5FX?= =?us-ascii?Q?0OrPFa6x9m/+IHDnw/6oDK/qlZBQ51r0Rr3ovO6hbWuzAqYKN0fYUsQjm9Fv?= =?us-ascii?Q?lwbIMcB919VzhPbirKtK30DaYFw3ApQ7se9O0c6OjT3xkhtHMQuKgPuLFqFb?= =?us-ascii?Q?QOOLOOjMIZCDClXVVk9mZCx2n6FXc7FXzd1HV1SrObYLKpdzD3cL2OOjXRs5?= =?us-ascii?Q?XdTbVxSGUzyEvpq3gMzcCo0okZNIj/19E/1AbtRiE4QRMoW73Ld5p/mtCz5i?= =?us-ascii?Q?gJlV2cTpZF2d2QRts1p+0A3yC1ajTJPGjJXXieTH/UodwdUeubekK/OoC1UT?= =?us-ascii?Q?dLWpqaWe2jNgws0RqtZk=3D?= X-Microsoft-Exchange-Diagnostics: 1; SN1PR0301MB2062; 6:iLf/wSXrboOJAvE6FtcQzKNxFqjodXiXPHvCfoEMxr9eNNlvLIDUumF4Jpj2O23eVHcXZfe1wV9gUYfg2lPz54pKXBqSGG5i7C6SF/Qy69aXBDpRs3vhMoBkinbj5dG8IAFB4u82SFEj+x4GlahzZG6LnAbdu316Wvo4EMu2/DtvG8LFsggiwe9e1Xfl92wmGaHIcuVBHilQ3xcC3H9wGGwAEUqWpSTDHdQR4Wny6W9JkOYfmvMNYrcCD3Hj8/6EZB9Ws2q/aEVtA+OYoDnQbditcq/noCFvs9L5y1cDg9w=; 5:drhedawKdE/Wy6a6l1kojyqq6d/pGcR18aepNXDPUgj6djJu7+RgvqmTTCFK3AKeR25Ln09NlFzLsP33AQyp2r8U25b+vA9BWurLyRNCA5Tny2TB0h5VKYSrhNf8tVqDeKlL1NUXvps5tr8L+t3ERRaANCbAHMcGxynpAxxNU7g=; 24:inLdCaEGiTdI90yuSSJ9Vot1XifGKAo3g3MpPYUr+X0mbj0xQwUPeW+24q4LqB8lXGQpz+dxx6c/p28gxY2IDyNiQ6KPC97WKsCDOjVoWZM=; 7:14it6MU84FLvZzdBDuvsceHj7og+N5AHcFFzCq7QHB9gXYtUz6192w2gR+zVqOcSakx7HrB8SK/D5JOkg+zeNH6LT/qJT7076HodQiB4hy/LYiEWbavTORsU9jBj8FU1K1fhHsVNLVJWMD6a10imavKAnXPdNPNICrmPedXGnqiHmOawinLCOl+WNWuJXly3wOHgYCuDiFZnk2PEkLB6/zyY2Np0bABfrt91NbJ1IGkDRGZpOlaQIhfH2jB1icjI SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Aug 2016 09:01:32.1948 (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: SN1PR0301MB2062 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160808_020212_549932_7F5C64C7 X-CRM114-Status: GOOD ( 17.42 ) 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>; + }; + }; +};