From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752381AbcHHJBo (ORCPT ); Mon, 8 Aug 2016 05:01:44 -0400 Received: from mail-sn1nam01on0076.outbound.protection.outlook.com ([104.47.32.76]:32064 "EHLO NAM01-SN1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752332AbcHHJBj (ORCPT ); Mon, 8 Aug 2016 05:01:39 -0400 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; From: Peter Chen To: , , , , , , , , CC: , , , , , , , , , , , , , , , , , , Peter Chen 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 Content-Type: text/plain 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 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@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>; + }; + }; +}; -- 1.9.1