From patchwork Thu Jan 5 06:01:52 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Chen X-Patchwork-Id: 711253 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 3tvJM76gT9z9snk for ; Thu, 5 Jan 2017 17:54:27 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S965179AbdAEGRr (ORCPT ); Thu, 5 Jan 2017 01:17:47 -0500 Received: from mail-bn3nam01on0059.outbound.protection.outlook.com ([104.47.33.59]:56737 "EHLO NAM01-BN3-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1757567AbdAEGRe (ORCPT ); Thu, 5 Jan 2017 01:17:34 -0500 Received: from CY4PR03CA0005.namprd03.prod.outlook.com (10.168.162.15) by CY4PR03MB2471.namprd03.prod.outlook.com (10.168.165.7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.817.10; Thu, 5 Jan 2017 06:01:30 +0000 Received: from BL2FFO11FD038.protection.gbl (2a01:111:f400:7c09::105) by CY4PR03CA0005.outlook.office365.com (2603:10b6:903:33::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.829.7 via Frontend Transport; Thu, 5 Jan 2017 06:01:30 +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 BL2FFO11FD038.mail.protection.outlook.com (10.173.161.134) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.803.8 via Frontend Transport; Thu, 5 Jan 2017 06:01:29 +0000 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 v05619tA025211; Wed, 4 Jan 2017 23:01:21 -0700 From: Peter Chen To: , , , , , , , , CC: , , , , , , , , , , , , , , , , , , , , , , Peter Chen Subject: [PATCH v11 1/8] binding-doc: power: pwrseq-generic: add binding doc for generic power sequence library Date: Thu, 5 Jan 2017 14:01:52 +0800 Message-ID: <1483596119-27508-2-git-send-email-peter.chen@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1483596119-27508-1-git-send-email-peter.chen@nxp.com> References: <1483596119-27508-1-git-send-email-peter.chen@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131280696900865335; (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)(336005)(7916002)(39410400002)(39380400002)(39850400002)(39400400002)(39840400002)(39450400003)(39860400002)(2980300002)(1110001)(1109001)(339900001)(199003)(189002)(7416002)(104016004)(5660300001)(2906002)(6666003)(5003940100001)(33646002)(626004)(47776003)(356003)(7406005)(54906002)(2950100002)(2201001)(39060400001)(4326007)(77096006)(8676002)(68736007)(81166006)(50226002)(50986999)(81156014)(8936002)(38730400001)(85426001)(86362001)(575784001)(8656002)(36756003)(48376002)(106466001)(2171001)(76176999)(50466002)(92566002)(5001770100001)(105606002)(305945005)(97736004)(189998001)(41533002); DIR:OUT; SFP:1101; SCL:1; SRVR:CY4PR03MB2471; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD038; 1:yG0DtyQWwSL3jzSmxW0Siuc+BIAxvmuo66FDZeSPknr3VdXJycpo4G55UJavsbaunpdXlj9kCXCYfjQCAYZOqV+YAKDryD8k8X70VRNCRSJHruNrBDIT+nQDRjUWOMGNDVqQ0+3g8mCDi2N2s2nAHaGxdG/vZSi6WDoDCYD2EMt8R3Fr5VkPzq/J9ykzQjwXLFqAsn9V9k8OlBOKiuOY74fVPM0FQpfye35S0c2k+iBEJdfkzy70P7JyjP6vsIgcY82RNciXi3lvTJUeRvlDlF9g1DF9xR05m6MKmQWmBGTvSW4sEjd/wLSEf3MkCWu4Rl4B3If4TpGhv260lxsRV9jeq8vxzuBIuDROFhXyghx8ZBWfVnkG0WEl7CuiZBRZd/sHP/oj2tiZARUi6xeOpHrRVWXU1FRDhS8D3rOdJJ0FXERe4UQIYGm94npn8acmgSoKUr3p9ILh/Zu4LHaZbsoxEOjsm+tleI6gVEIhaCeQ7iv/p0JNAHnmSd/0Jn3ui3r7dasIZgqPXzesCcahcRU9NsvcoqgCqNqvwEit4gCehSbJjpg2msMcyukWc/6FrszL0w0rSav4gaVe+huTx7ejEsiRGvhF00sb3NQlzPHwmcB2Ad/Jn256W6KhO3htIIilhEWDVgUKalmT4n6zXV3z6894dqcirNLdqLb0w5QwQxoOIsI/ourJOFMuuucMQV6QYkwovu59Y+FBZ4nN8uYzs2h2U22ZmfIFnN6fOFhPTkbZ8Q9ehoSUaF+ALA7Q MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: cb95dbb2-4ab8-434c-4d37-08d435304b1b X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001); SRVR:CY4PR03MB2471; X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2471; 3:OwAaTdwOGXVYe7UQbTtwC+MieVGQjjz2R+LescEg3nMhYQ/rvqJy3vK/aIZWb6aLJvcX7eW+nk1hfg6ZQPfT3/ySHifmrze9RWfMAXppRQ3UBlJEmyr/MZHMe/7oDnBNebT/502gWq0NNLIXHjh+udWlSr2OejwZOxeiMmE8mKujJBVskuWUWF/QXW8K7e/5LmGTr/fg1MybpsQzS2solAb/zUOAZZoYuX/GXQ+MS73DKBOukDEUb0TG3DtKjOkeKZcoXcpJDnWoclx6JGpjuih2zECnZeQsf8yKliwTKn7Vou14lqbp1Lqzgl3uqSRylhB3unEWoREyOgH5cncn1h6KEZyRmPlWLQOTFrTEoQ6TEZqG2HF2ezAc54OZy0fc; 25:ru4u94b5s6DGtwbQbsQNEafnBkLyHYQPatEOcx+XVSZ+6oQN2nWIUkKlsRuIpAxzVFIk731NDmvKXbknI6lSS61tSy+PnTJETswX4VTxfMH13q/EB5GIt6TNg78fwkliqvSj45+nGSuEYHvuTKchAPkrIQO8BsRhlp6ypUrFy6zdPkICc+hBi0wAPNdpy3mYvIS1UdGgXkwnNl2ei9uRDxusC3BO0oyJBr+pCczQU6+jseZCSqf9KfYHB6zYlQIlvz1ZuQEujOv+6EL9i/nNwEG55ZJlR8ctfluFljXb+BiLT0Wy0Tc5Q+iOUBl4JnS6hiEP/1EF9A4b+wcR54x1W7TsSkQVO/TIy14VGOzPR3xnyj4wA/h5cLkZDMuB9zw7L+1vhJOE0soaqoGx4/yok9LJLT/RoXRMf1iucVW80MXnaDrl1uJohrLfC1qJScrK X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2471; 31:fR8ebO0MZF8iswPjKaEpdDe9tY/V8ucQFXzqnkdvHZen96IQxgCHWuSQ2CAhVQW7c5oga235t+FelsCAAt/yXrGNGnLOwTghEEQTQI3TMGx/TbLdv2klrf7S/BfNZ1tqS/jdZ80VncNO5PsptBR2sWf7YllddXX46SXYQSU+DSIOdWEggav6d56IefMmVphbaSoEzyx1oOpIBtjtvFzKi52WcT2fTvZ8i1nd+FYGnTz5SCIo/QUc6HrObUKY/xQvRfAq519wJkXc3CXkRk4bug== 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)(5005006)(8121501046)(13024025)(13023025)(13015025)(13017025)(13018025)(10201501046)(3002001)(6055026)(6096035)(20161123563025)(20161123556025)(20161123559025)(20161123561025)(20161123565025); SRVR:CY4PR03MB2471; BCL:0; PCL:0; RULEID:(400006); SRVR:CY4PR03MB2471; X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2471; 4:65MhNaTaZWjJ95VNc8mxaK4fF5q+/y+dn98qeBCsGDDgP0tAj2JKpktNDhVHbipCnlwrIopWt6Y4oWEG4pkCbkB2WjDhEiVU0Nv2OHfnGsXACjpU+qnEZ67a0JdFQI7XxHaFABh0yl0s1n5c9ds/c8cxNlxeTQCJjh2FrZAT17pSvGp8c6FsOssrDbd7zEdFHlgUwPEFqg98Qew7E3uzWWSpAiAi+MV5Yj+rSEiET9OmjpN/Nt3YK8CjUgMHfu8ZoBIm2jRGnF3IMEgdxTogloOcTyqWgFAbh3JqoFg53q2rT8mHeVUGumBklYiFtgtCFNnXZ0+ZZT80Zp81xDmfai6LaeZj5gCIzzqtWo4WHwl4jwxHptf1RhQ0WBsKYrJBQ4gVS5+qGuA5SojoK7rP4s4gqvAhBHSXYGwSyNjQ3J3LxKqZN8UBAdYrtKjD4i0+eZup2SKkxT+5S8NO/BdeLbxpURwxZlwPpMp+9P8tVrL96m5bHF7CnnZdibP+aqg0KOF0xkBchJJRQ2mGpG87w2ZAEd7RW/AIU3mZc2cCM33k/SucKvnBog1LnSdJdXIT0CXbsh3pxqyhwi+vJlh3/uLQSNDzmpGNAFKJZfQSNMzl1RwIZqAGo6eisy0N98dUHrWHeEbjwMEuGZ/288Tmsa9yjB1G3Cdy7b6lWGz3zQj4COoLE+tAd6q2/U/cVcKaA71B5LwbI3AjLlxAZX4yacv/2V7Q/PaC2zmBO4tGzyQ= X-Forefront-PRVS: 0178184651 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY4PR03MB2471; 23:MVK82cyCY9WYVYTnHo+dd18Qwehm11t6v0n+yl+Dq?= =?us-ascii?Q?Iye5LMvDhlxDPnIZrSQ4Xgfu4aka0UaLbqR0m3+nrQNDfnjLW4j7p4r+l7D1?= =?us-ascii?Q?73fwGzzVi33GBydZN03+MXLg01PUDy6tRmq5nalh4Q8lxgI8txlfGAa1Pk4H?= =?us-ascii?Q?3tm6lSNZk3S/NNTtlfPMWyiwa56CDFAa2k7m+qauV5pLUl4UxB2CU4jlZHb9?= =?us-ascii?Q?d8gxJB8DwCB8ogjHjwfaOp2HMatoXtycCIKpBV2aDvBv96VW2dh0C7WYJ0Ej?= =?us-ascii?Q?cwhtpuFJPXUE6Ymy52g9zcrhqEX7nwdzYX2AIJSsU1K1GUi32jiV/bQ3RjIW?= =?us-ascii?Q?OpBVUgAr1BU157hUXH/SP6tRrgsgVG09+YXc10LU3mO1JhfTRYwKv6ULqNwd?= =?us-ascii?Q?SGekI+QO/lgD8t/BCp09/66JBceEojqkeOwp7GtJgDONAb74QchUVv6M3BwV?= =?us-ascii?Q?WaoRRIUAxXyZgH/rXUpMWqpuq4/uGBotu0wC/vNXtr7Jfpf4A01GLBZMYXlV?= =?us-ascii?Q?T8lAQmf733zutmaMeIbEC8qLBtOj3J6dUBzeaiBMd9Os/VMm+BVV+4jurcpi?= =?us-ascii?Q?nB1jgYCRKD+2vkyumESURcOPYABXkjKJG8b/jSIYTL89NAFTbq6rsiX9QUM5?= =?us-ascii?Q?7m7qtT4DplAHeTTNGjFgtKECU6+vjgBADW/Ys+G733ZYs6/jv9mKRhLPyyaX?= =?us-ascii?Q?BTtxEZbF83U2SarLi7BXEny463crhXOJ/99zcoGt6fJS/ZI/3mXVaLW3l34E?= =?us-ascii?Q?npLgtQLjmrS+VTHZoTC7QgGqm25+FOGwLiLZU4y7cQ9yOdclQXv40tB8nL4g?= =?us-ascii?Q?4mLnHj8yUQSVU3or4z73bQC15EqhT7qrZUF0dlNbgTY3h6FpSMplko+4ABva?= =?us-ascii?Q?IaxJWk8BH0AZV9kPMTKTNi1D7bIqoQjeNjJNKQoyywypGpryDfHKbnmZ9J1d?= =?us-ascii?Q?wZXG4iNHCZcJclMeZF+znSQh7h6CG6hjgQhkHXP2+X7HvGwuOZiR/wDT03Xo?= =?us-ascii?Q?AZ5olPUZp57HqaIu6UGfJ2G2Snxzb5Uf9P/nxu6SQRCV5fl9VKSie6Aj2k40?= =?us-ascii?Q?aYjp0uPbKzygL9ni/piAZmL6Hb1Y0M8olTYNm8nv1+qg2BxT+DMWpEiPXJra?= =?us-ascii?Q?gkQ07qGuooKle9+dbAvE4NxoKTOjdsNQO7I05+g7d8wEyv7PJaIpuIj2VHk9?= =?us-ascii?Q?qRV5oSlkfpEvvoG4TSiXJ0jJ6GrNMyoLutwDCAQl7X8Ku/p/r7INIV5bP5WR?= =?us-ascii?Q?btuht6PxeIGS8j2HovOzmtTP88A0r2l0Sp3fOp06BG2cIiEttFtSm+HHVcN0?= =?us-ascii?Q?ZavVJRuXDihsmz1pyP7VJ8eEUjV9gzi/MvtbwnsYMyl4covgt0K8z6sDt5Kj?= =?us-ascii?Q?blN3tl+0aj/yP0SUFlkiFjyncBeQOwdoPcl6TZoZxSfUSE4?= X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2471; 6:G/ehWaG2K3RHHa0hHvzwSH/8OrOChZ1UqEgMZMO1QArqt5LG44SDNrFkgUGeCCMfhwgDH34rhJwpQOlybtVRZ9boDAGVF3InpmrkF8I7MIjF1R0T3Y7mcjxEkzZ4i2yJHHH0q7FccPz8ygJ1BUXVHMx75XLManPkQ3cbWDXmqxYztelZvWcGqjz3beb4g68rNWFi+9Wzr6atfE5kvdkF5mxH8gjU8wCvdPFcwVUvoUYvOFJ9n9R/ahBSQ4G+W7Mq4oXuGiYxTOY9149mGGx1d8HEXKlZnLWNiNA1kHHFLZHjMoKubIl8sJy7XVb5jv3eQyZrqVRH5uFA/uS6ApMWehqED5dm4pSK1VxOshUlEsyKFW8LUdh41CyVLnCbSurlAxQSSPbaKXKMlAzkl1Or2wwUV0bxlpXHhPV8hmshxg8TUDBHBJIwUhdCrbw/7E1E; 5:tv/rQ/jw9dIjRzNpL9bOmbdVp1HBmjwmC9ZRbaGJE+8tE5vS8zLSxqmmF1AVzU030DkkAfCFs7/J2RFgXLvoKFZ5yf+aEcsEHg0CdV8M3GGGPtkM+AhTjIG8bzLdBE3lhsLgG//vYvuKqbXJSlEcsw/ScJiBx887UEGWF6WRimcfBhrS6jMjbjEKWlBdCNE+; 24:t0el4scb1gzOqot5YR8DFbV3Xukdo68atCBpFsJrlVET+81Uv29oNiG99b+qYYJUqtaC8Bcwm/YyHuYaFh/wXH9b1DVfJyTj7keqJW0w5n4= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2471; 7:2sZJV/Kv4S3YZvVpPwKcNGarnjy8hZZSGb+JoGEmyynuPnljC3oI2YioU2fhOZN5juDh0xRZRZj43lsZ6UXwqkCG4q/uayL3mFHLF10nwUJTYjkjX5FMxCLtvZ8kW9Wja92LUaNX7zAZQGIidCBkjMhR0L1QCme/wZefmm6R4Odu8GVpn559PLAaclgH61j5KnZ0EN1zxI+29ETfzWHYYbWzAecJmbNBVdO9XbNQTQ9jSebbYbv4fQ/qoJBtgCC2F6Mc79rStrTIEUMrUpA7e58X+wqdPLTXdA8uwnr/BiQCHbUYnX0swR6w/L9YNrcbZd0RNLQjBL1tyecDPxugFL2TDAMmJz6rKP2Sb7R8fQ9mNp/wzUgqxCTlsFF3J6AbiXIr/Q0mJL0KUMXJy8c+K8g0XOvXPimTBlb5vFGDRmDxUY9/PPJSpryfY3R3tsDEO6JFRzISyAuSdbG+Szzm+Q== X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Jan 2017 06:01:29.7745 (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: CY4PR03MB2471 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 Acked-by: Krzysztof Kozlowski --- .../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>; + }; + }; +};