From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756506AbbJAIZ3 (ORCPT ); Thu, 1 Oct 2015 04:25:29 -0400 Received: from mailout1.samsung.com ([203.254.224.24]:53025 "EHLO mailout1.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755931AbbJAIZR (ORCPT ); Thu, 1 Oct 2015 04:25:17 -0400 X-AuditID: cbfee68f-f796f6d0000014a4-4a-560cedeb8115 From: Alim Akhtar To: linux-scsi@vger.kernel.org, linux-kernel@vger.kernel.org Cc: JBottomley@odin.com, vinholikatti@gmail.com, amit.daniel@samsung.com, essuuj@gmail.com, devicetree@vger.kernel.org Subject: [PATCH v3 11/13] Documentation: devicetree: ufs: Add DT bindings for exynos UFS host controller Date: Thu, 01 Oct 2015 13:39:28 +0530 Message-id: <1443686970-28104-12-git-send-email-alim.akhtar@samsung.com> X-Mailer: git-send-email 1.7.10.4 In-reply-to: <1443686970-28104-1-git-send-email-alim.akhtar@samsung.com> References: <1443686970-28104-1-git-send-email-alim.akhtar@samsung.com> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFrrMLMWRmVeSWpSXmKPExsWyRsSkTvf1W54wg3X3uSwaroZYzD9yjtVi +YUlTBb/199msbi8aw6bRff1HWwWOxZWObB77Jx1l93j8I8fzB59W1YxenzeJBfAEsVlk5Ka k1mWWqRvl8CV8eDQE/aC+RoV16Z0MTUwvpfvYuTkkBAwkVjWtYANwhaTuHBvPZDNxSEksIJR 4uDuN4wwRf3LLoAVCQnMYpT4MsUVougno8TXk9fAitgEtCXuTt/CBGKLCNhInL/5AMxmFqiQ uHVmAguILSyQJXF32zowm0VAVeLmjFlgNbwCHhKNk5eyQyxTlOh+NgFoGQcHJ1D826JQiL3u Eh/uLmcE2Ssh0M8uMffRLHaIOQIS3yYfYgGplxCQldh0gBlijKTEwRU3WCYwCi9gZFjFKJpa kFxQnJReZKxXnJhbXJqXrpecn7uJERjWp/8969/BePeA9SFGAQ5GJR5eiXSeMCHWxLLiytxD jKZAGyYyS4km5wOjJ68k3tDYzMjC1MTU2Mjc0kxJnHeh1M9gIYH0xJLU7NTUgtSi+KLSnNTi Q4xMHJxSDYx51burrMWS1nT2bPt6SODMHLPPKs2tPXXpcas9mVknnWmfz3G9aGHt1p1rf/De cFv7IvtpqPSsT08TLliYPrtRYnnN23GxoWHDr/M8aqefHPOrbFPWWm/FwV98YsIKUYGuv1c4 zee9VvzWXb2+58YeMQ+fvoD23PpT128ZibvUnFmkcKRFx0eJpTgj0VCLuag4EQA5CZsIZgIA AA== X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFlrAIsWRmVeSWpSXmKPExsVy+t9jQd1Xb3nCDNY/tLZouBpiMf/IOVaL 5ReWMFn8X3+bxeLyrjlsFt3Xd7BZ7FhY5cDusXPWXXaPwz9+MHv0bVnF6PF5k1wAS1QDo01G amJKapFCal5yfkpmXrqtkndwvHO8qZmBoa6hpYW5kkJeYm6qrZKLT4CuW2YO0AFKCmWJOaVA oYDE4mIlfTtME0JD3HQtYBojdH1DguB6jAzQQMIaxowHh56wF8zXqLg2pYupgfG9fBcjJ4eE gIlE/7ILbBC2mMSFe+vBbCGBWYwSX6a4djFyAdk/GSW+nrzGCJJgE9CWuDt9CxOILSJgI3H+ 5gMwm1mgQuLWmQksILawQJbE3W3rwGwWAVWJmzNmgdXwCnhINE5eyg6xTFGi+9kEoGUcHJxA 8W+LQiH2ukt8uLuccQIj7wJGhlWMEqkFyQXFSem5hnmp5XrFibnFpXnpesn5uZsYwbHzTGoH 48Fd7ocYBTgYlXh4D6TwhAmxJpYVV+YeYpTgYFYS4ZUBRp4Qb0piZVVqUX58UWlOavEhRlOg uyYyS4km5wPjOq8k3tDYxNzU2NTSxMLEzFJJnPfGIYYwIYH0xJLU7NTUgtQimD4mDk6pBsYk vTeamqGehR8W7ZfL/ClbtfrpUa0lc1/a/jj6R9/sVLEon/2WGTURpSxR1s+qjE7oVmiembmc g2G7vPRG/ntXRLh/mWy71TXzQfnEuUzNPndWv7mvPS9L5LbBNbaPIU8U5K/YlC27+bjAXj5o c2D89ksb/i6wfyf8/t/dM32TPQId2Pf0nTNQYinOSDTUYi4qTgQA7oAVrbMCAAA= DLP-Filter: Pass X-MTR: 20000000000000000@CPGS X-CFilter-Loop: Reflected Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Seungwon Jeon This adds Exynos Universal Flash Storage (UFS) Host Controller DT bindings. Signed-off-by: Seungwon Jeon Signed-off-by: Alim Akhtar --- .../devicetree/bindings/ufs/ufs-exynos.txt | 93 ++++++++++++++++++++ 1 file changed, 93 insertions(+) create mode 100644 Documentation/devicetree/bindings/ufs/ufs-exynos.txt diff --git a/Documentation/devicetree/bindings/ufs/ufs-exynos.txt b/Documentation/devicetree/bindings/ufs/ufs-exynos.txt new file mode 100644 index 0000000..00df72e --- /dev/null +++ b/Documentation/devicetree/bindings/ufs/ufs-exynos.txt @@ -0,0 +1,93 @@ +* Exynos Universal Flash Storage (UFS) Host Controller + +UFSHC nodes are defined to describe on-chip UFS host controllers. +Each UFS controller instance should have its own node. + +Required properties: +- compatible : compatible name, contains "samsung,exynos7-ufs" +- interrupts : +- reg : + +Optional properties: +- vdd-hba-supply : phandle to UFS host controller supply regulator node +- vcc-supply : phandle to VCC supply regulator node +- vccq-supply : phandle to VCCQ supply regulator node +- vccq2-supply : phandle to VCCQ2 supply regulator node +- vcc-supply-1p8 : For embedded UFS devices, valid VCC range is 1.7-1.95V + or 2.7-3.6V. This boolean property when set, specifies + to use low voltage range of 1.7-1.95V. Note for external + UFS cards this property is invalid and valid VCC range is + always 2.7-3.6V. +- vcc-max-microamp : specifies max. load that can be drawn from vcc supply +- vccq-max-microamp : specifies max. load that can be drawn from vccq supply +- vccq2-max-microamp : specifies max. load that can be drawn from vccq2 supply +- -fixed-regulator : boolean property specifying that -supply is a fixed regulator + +- clocks : List of phandle and clock specifier pairs +- clock-names : List of clock input name strings sorted in the same + order as the clocks property. +- freq-table-hz : Array of operating frequencies stored in the same + order as the clocks property. If this property is not + defined or a value in the array is "0" then it is assumed + that the frequency is set by the parent clock or a + fixed rate clock source. +- pclk-freq-avail-range : specifies available frequency range(min/max) for APB clock +- ufs,pwr-attr-mode : specifies mode value for power mode change +- ufs,pwr-attr-lane : specifies lane count value for power mode change +- ufs,pwr-attr-gear : specifies gear count value for power mode change +- ufs,pwr-attr-hs-series : specifies HS rate series for power mode change +- ufs,pwr-local-l2-timer : specifies array of local UNIPRO L2 timer values + +- ufs,pwr-remote-l2-timer : specifies array of remote UNIPRO L2 timer values + +- ufs-rx-adv-fine-gran-sup_en : specifies support of fine granularity of MPHY, + this is a boolean property. +- ufs-rx-adv-fine-gran-step : specifies granularity steps of MPHY +- ufs-rx-adv-min-activate-time-cap : specifies rx advanced minimum activate time of MPHY +- ufs-pa-granularity : specifies Granularity for PA_TActivate and PA_Hibern8Time +- ufs-pa-tacctivate : specifies time wake-up remote M-RX +- ufs-pa-hibern8time : specifies minimum time to wait in HIBERN8 state + +Note: If above properties are not defined it can be assumed that the supply +regulators or clocks are always on. + +Example: + ufshc@0x15570000 { + compatible = "samsung,exynos7-ufs"; + reg = <0xfc598000 0x800>; + reg = <0x15570000 0x100>, + <0x15570100 0x100>, + <0x15571000 0x200>, + <0x15572000 0x300>; + reg-names = "hci", "vs_hci", "unipro", "ufsp"; + interrupts = <0 200 0>; + + vdd-hba-supply = <&xxx_reg0>; + vdd-hba-fixed-regulator; + vcc-supply = <&xxx_reg1>; + vcc-supply-1p8; + vccq-supply = <&xxx_reg2>; + vccq2-supply = <&xxx_reg3>; + vcc-max-microamp = 500000; + vccq-max-microamp = 200000; + vccq2-max-microamp = 200000; + + clocks = <&core 0>, <&ref 0>, <&iface 0>; + clock-names = "core_clk", "ref_clk", "iface_clk"; + freq-table-hz = <100000000 200000000>, <0 0>, <0 0>; + + pclk-freq-avail-range = <70000000 133000000>; + + ufs,pwr-attr-mode = "FAST"; + ufs,pwr-attr-lane = /bits/ 8 <2>; + ufs,pwr-attr-gear = /bits/ 8 <2>; + ufs,pwr-attr-hs-series = "HS_rate_b"; + ufs,pwr-local-l2-timer = <8000 28000 20000>; + ufs,pwr-remote-l2-timer = <12000 32000 16000>; + ufs-rx-adv-fine-gran-sup_en = <1>; + ufs-rx-adv-fine-gran-step = <3>; + ufs-rx-adv-min-activate-time-cap = <10>; + ufs-pa-granularity = <6>; + ufs-pa-tacctivate = <6>; + ufs-pa-hibern8time = <20>; + }; -- 1.7.10.4